Skip to main content
POST
Start an Agent Picks test

Authorizations

Authorization
string
header
required

API key with dtk_live_ prefix. Obtain it from API Keys in the account sidebar. New keys start with all supported scopes selected for the chosen project, and you can narrow them to specific read/write scopes as needed.

Path Parameters

projectId
string<uuid>
required

The project the credential is bound to. Read it from GET /connection.

Body

application/json
quote_token
string
required

The token from the quote. It works once and expires after 15 minutes.

Maximum string length: 4096
max_credits
integer
required

The most credits a person approved one test, or one scheduled run, to reserve. A higher fresh estimate is refused with over_max_credits.

Required range: x >= 1
setup
string

The Agent Picks setup to use: its id or its category slug. Optional while the project has one setup. With several, omitting it is refused with 400 and reason agent_picks_setup_required, and a setup the project does not have with 404 and reason agent_picks_setup_not_found; both list the project’s setups in details.setups (id, category_slug, category_name). The response echoes the setup used as setup.

Required string length: 1 - 200

Response

Started test

data
object
required
meta
object
required

Sent beside data on every successful response that returns data.