TestrDocs
TestrDocs

Read tools

Read tools are available to every token. Inputs are flat objects and IDs are UUIDs. Results use camelCase and ISO 8601 timestamps. Farm returns tool data in structuredContent.result, alongside a JSON text copy.

Apps

list_apps

ArgumentTypeNotes
pageintegerDefaults to 1
pageSize10 | 25 | 50 | 100Defaults to 25

Returns your apps with website and install URLs.

get_app

ArgumentType
appIdUUID

Returns app details and its campaign count.

Campaigns

list_campaigns

ArgumentTypeNotes
page, pageSizeSee pagination
appIdUUIDOptional filter
statusdraft | awaiting_funding | active | paused | closing | closedOptional filter

Returns campaign summaries with currency, rewards, budget, and funding balances.

get_campaign

ArgumentType
campaignIdUUID

Returns scope, private instructions, dates, and app context.

Reports

list_reports

ArgumentTypeNotes
page, pageSizeSee pagination
appId, campaignIdUUIDOptional filters
statussubmitted | needs_information | approved | rejected | duplicate | appealedOptional filter
qstringSearch text, up to 200 characters

Returns report summaries with app and campaign names, reward, currency, review deadlines, and comment counts.

get_report

ArgumentType
reportIdUUID

Returns the full report:

  • reported steps, expected and actual behavior, environment
  • decision version and timestamps (needed to reverse a decision)
  • reward amount and currency
  • appeal context and investigation assessment and status
  • app and campaign context, including instructions
  • comment count and evidence attachment IDs

list_report_comments

ArgumentType
reportIdUUID
page, pageSize

Returns the conversation in chronological order, with each author's name and role.

Evidence

get_evidence_url

ArgumentType
attachmentIdUUID

Returns a private download URL with MIME type, filename, size, and expiry.

Links expire after 60 seconds

Fetch the file right away, or request a fresh URL. Whether your agent can actually view images or video depends on your client.

Pagination

  • Defaults: page 1, 25 rows. Allowed page sizes: 10, 25, 50, 100.
  • List results contain items and pagination: { page, pageSize, total, totalPages }.
  • Ordering is stable. A page past the end returns an empty items array.