TestrDocs
TestrDocs

Write actions

Write tools are listed only for tokens created with Read and write access (owner:workspace:write). They call the same services as the owner website, so every rule you see in the UI applies here too.

Writes are not idempotent

Write tools don't take an idempotency key. If a response is uncertain, read the affected resource before retrying. Repeating a create or a comment can create a second record.

Amounts are integer minor units: santim for ETB and cents for USD. Read the campaign's currency first.

Reports

comment_report

Posts a reply that the tester can see.

ArgumentTypeNotes
reportIdUUID
bodystring10 to 10,000 characters
attachmentIdsUUID[]Optional. Up to 5 of your uploads that are ready. Upload through the website first.

decide_report

Makes or reverses a review decision.

ArgumentTypeNotes
reportIdUUID
actionapprove | reject | duplicate | request_information | reverse
reasonstring10 to 4,000 characters. Required for every action.
duplicateOfUUIDRequired for duplicate. Must be in the same campaign.
bountyTypestandard | critical | specialOptional reward tier for approval
decisionVersionintegerRequired for reverse. Take it from get_report.

Approval pays the tester

Approving a paid report releases its reserved reward. Settlement happens exactly once, even if you retry.

  • Always call get_report before deciding.
  • reverse works only within one hour of the decision and needs the current decisionVersion.
  • Review deadlines, appeal rules, and Premium conversation restrictions still apply.

Apps

create_app

ArgumentTypeNotes
namestring2 to 100 characters
platformweb | android | ios
urlstringHTTP or HTTPS
descriptionstring10 to 2,000 characters
brandingIdUUIDOptional

delete_app

ArgumentType
appIdUUID

Deletes an app only if it has no remaining campaigns and no Play Store history.

Campaign management

create_campaign

Creates an unfunded draft. Fund it from the website before activating it.

ArgumentTypeNotes
appIdUUID
titlestring5 to 140 characters
summarystringPublic. 20 to 500 characters.
scopestringWhat to test. 20 to 10,000 characters.
instructionsstringPrivate. 20 to 10,000 characters.
bountyMinorintegerBase (standard) reward
budgetMinorintegerMust cover every enabled reward
endsAtISO datetimeInclude an explicit timezone
currencyETB | USDDefaults to ETB
visibilitypublic | privateDefaults to public. Private requires Premium.
bountyRewards{ standard, critical?, special? }Optional. standard must equal bountyMinor.

update_campaign

Pass campaignId and at least one of title, summary, scope, or instructions.

update_campaign_rewards

ArgumentType
campaignIdUUID
bountyRewards{ standard, critical?, special? }

Changes rewards for future reports only. Existing reports keep the amounts they were submitted with.

extend_campaign

ArgumentTypeNotes
campaignIdUUID
endsAtISO datetimeMust be later than the current deadline and in the future

change_campaign_status

ArgumentType
campaignIdUUID
statusdraft | active | paused | closing

Only allowed lifecycle transitions succeed. Activating a campaign still requires funding, and this tool cannot fund one.

delete_campaign

ArgumentType
campaignIdUUID

Deletes an unfunded draft that has no pending payments.

Not available over MCP

  • Payments: checkout, funding, and withdrawals
  • File uploads (use the website, then pass attachmentIds)
  • Play Store management
  • Tester and administrator actions