---
title: "Write actions"
description: "Comment, decide on reports, and manage apps and campaigns from your agent."
canonical_url: "https://docs.trytestr.com/docs/mcp/write-actions"
markdown_url: "https://docs.trytestr.com/docs/mcp/write-actions.md"
last_updated: "2026-11-16"
x_farming_labs_generated_preamble: true
---

# Write actions
URL: /docs/mcp/write-actions
LLM index: /llms.txt
Description: Comment, decide on reports, and manage apps and campaigns from your agent.

# 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.

<Callout type="warn" title="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.
</Callout>

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.

| Argument        | Type   | Notes                                                                               |
| --------------- | ------ | ----------------------------------------------------------------------------------- |
| `reportId`      | UUID   |                                                                                     |
| `body`          | string | 10 to 10,000 characters                                                             |
| `attachmentIds` | UUID[] | Optional. Up to 5 of your uploads that are ready. Upload through the website first. |

### `decide_report`

Makes or reverses a review decision.

| Argument          | Type                                                                       | Notes                                                   |
| ----------------- | -------------------------------------------------------------------------- | ------------------------------------------------------- |
| `reportId`        | UUID                                                                       |                                                         |
| `action`          | `approve` \| `reject` \| `duplicate` \| `request_information` \| `reverse` |                                                         |
| `reason`          | string                                                                     | 10 to 4,000 characters. Required for every action.      |
| `duplicateOf`     | UUID                                                                       | Required for `duplicate`. Must be in the same campaign. |
| `bountyType`      | `standard` \| `critical` \| `special`                                      | Optional reward tier for approval                       |
| `decisionVersion` | integer                                                                    | Required for `reverse`. Take it from `get_report`.      |

<Callout type="info" title="Approval pays the tester">
  Approving a paid report releases its reserved reward. Settlement happens exactly once, even if you
  retry.
</Callout>

- 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`

| Argument      | Type                        | Notes                  |
| ------------- | --------------------------- | ---------------------- |
| `name`        | string                      | 2 to 100 characters    |
| `platform`    | `web` \| `android` \| `ios` |                        |
| `url`         | string                      | HTTP or HTTPS          |
| `description` | string                      | 10 to 2,000 characters |
| `brandingId`  | UUID                        | Optional               |

### `delete_app`

| Argument | Type |
| -------- | ---- |
| `appId`  | UUID |

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.

| Argument        | Type                                | Notes                                           |
| --------------- | ----------------------------------- | ----------------------------------------------- |
| `appId`         | UUID                                |                                                 |
| `title`         | string                              | 5 to 140 characters                             |
| `summary`       | string                              | Public. 20 to 500 characters.                   |
| `scope`         | string                              | What to test. 20 to 10,000 characters.          |
| `instructions`  | string                              | Private. 20 to 10,000 characters.               |
| `bountyMinor`   | integer                             | Base (standard) reward                          |
| `budgetMinor`   | integer                             | Must cover every enabled reward                 |
| `endsAt`        | ISO datetime                        | Include an explicit timezone                    |
| `currency`      | `ETB` \| `USD`                      | Defaults to `ETB`                               |
| `visibility`    | `public` \| `private`               | Defaults 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`

| Argument        | Type                                |
| --------------- | ----------------------------------- |
| `campaignId`    | UUID                                |
| `bountyRewards` | `{ standard, critical?, special? }` |

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

### `extend_campaign`

| Argument     | Type         | Notes                                                     |
| ------------ | ------------ | --------------------------------------------------------- |
| `campaignId` | UUID         |                                                           |
| `endsAt`     | ISO datetime | Must be later than the current deadline and in the future |

### `change_campaign_status`

| Argument     | Type                                         |
| ------------ | -------------------------------------------- |
| `campaignId` | UUID                                         |
| `status`     | `draft` \| `active` \| `paused` \| `closing` |

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

### `delete_campaign`

| Argument     | Type |
| ------------ | ---- |
| `campaignId` | UUID |

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

## Sitemap

See the full [sitemap](/sitemap.md) for all pages.
Docs-scoped sitemap: [/docs/sitemap.md](/docs/sitemap.md).
Well-known sitemap: [/.well-known/sitemap.md](/.well-known/sitemap.md).
