Skip to main content
POST
cURL

Authorizations

Authorization
string
header
default:dav_ak_live_your_token
required

Personal access token. The scopes granted at issuance determine both which operations the key may call and the ceiling on the resource permissions it can exercise. Each scope family is a ladder: projects:manage implies projects:write and projects:read; cards:manage implies cards:write and cards:read; and teams:manage implies teams:write and teams:read. These are named API capability bundles, not blanket domain roles: manage exposes only the permissions enumerated for that scope and never bypasses the acting user's current role-based access.

Path Parameters

projectId
string
required

Project id. May be compound in the form {projectId}--{branchName}.

Minimum string length: 1
sessionId
string<uuid>
required

Session id from createSession.

Body

application/json
toolbox
string
required

Toolbox holding the tool, for example Core.

Maximum string length: 200
tool
string
required
Maximum string length: 200
params
object

Arguments for the tool. Validated by the tool, not here.

Response

The tool ran and returned a result.

sessionId
string<uuid>
required
toolbox
string
required
tool
string
required
isError
boolean
required

Always false here — a tool that reported an error is answered as 422, so a 200 means the tool succeeded.

content
object
required
structuredContent
object

Present when the tool returns structured output as well as text.