Skip to content
DashboardGet API key

Get a single agent execution

View .md
GET

Fetch full details for one execution — including errorMessage, errorCode, and responseText. Use this to debug failures surfaced by the list endpoint.

Authorization

  • Authorizationheaderrequired

    Bearer YOUR_API_KEY. Create a key in the dashboard.

Path parameters

  • senderIdstringrequired
  • executionIdstringrequired

Responses

200Execution details.
  • executionobjectrequired
    14 properties
    • idstringrequired
    • agentIdstringrequired
    • inboundMessageIdstring
    • responseMessageIdstringnullable
    • responseTextstringnullable
    • statusstringrequired

      Status of an agent execution.

      One ofsuccesserrorfilteredrate_limitedbalance_insufficient
    • errorMessagestringnullable
    • inputTokensintegerrequired
    • outputTokensintegerrequired
    • latencyMsintegerrequired
    • costnumberrequired

      Cost in USD.

    • createdAtstring<date-time>required
    • knowledgeChunksUsedintegernullable

      Knowledge-base chunks retrieved for this answer. Zero on an agent that has documents attached means the reply was not grounded in them, which is otherwise indistinguishable from a correct answer in this record. Absent on executions recorded before this field existed, which is not the same as zero.

    • toolCallsintegernullable

      Tools the agent called while producing this reply. Zero on an agent that has tools configured means it answered without calling any — the case where a reply says it will look something up and nothing ever reaches your endpoint. Absent on executions recorded before this field existed, which is not the same as zero.

401Unauthorized.
  • codestringrequired
  • messagestringrequired
  • detailsobject
404Agent or execution not found.
  • codestringrequired
  • messagestringrequired
  • detailsobject