Get execution detail | Runtype Documentation

curl https://api.runtype.com/v1/agents/id/executions/executionId \
     -H "Authorization: Bearer <token>" \
     -H "Content-Type: application/json"

{
  "id": "exec_9f8b7c6d5a4e3f21",
  "agentId": "agent_1234abcd5678efgh",
  "agentSource": "https://github.com/runtype/agents/sample-agent",
  "executionId": "exec_9f8b7c6d5a4e3f21",
  "parentExecutionId": "exec_1a2b3c4d5e6f7g8h",
  "surfaceType": "web",
  "status": "completed",
  "iterations": 5,
  "totalCost": "0.0234",
  "stopReason": "max_iterations_reached",
  "startedAt": "2024-06-10T09:15:30Z",
  "completedAt": "2024-06-10T09:17:45Z",
  "createdAt": "2024-06-10T09:15:00Z",
  "agentSpec": null,
  "totalTokens": 1450,
  "inputMessages": [
    {
      "role": "user",
      "content": "Generate a summary of the latest quarterly earnings report."
    }
  ],
  "finalOutput": {
    "summary": "The company reported a 12% increase in revenue driven by strong sales in the technology sector, with net profit margins improving by 3% compared to the previous quarter."
  },
  "iterationDetails": [
    {
      "iteration": 1,
      "output": "Initial data extraction completed.",
      "tokensUsed": 250
    },
    {
      "iteration": 2,
      "output": "Draft summary generated.",
      "tokensUsed": 300
    },
    {
      "iteration": 3,
      "output": "Summary refined with financial highlights.",
      "tokensUsed": 300
    },
    {
      "iteration": 4,
      "output": "Grammar and style improvements applied.",
      "tokensUsed": 300
    },
    {
      "iteration": 5,
      "output": "Final summary approved.",
      "tokensUsed": 300
    }
  ],
  "loopConfig": {
    "maxIterations": 5,
    "stopOnCondition": "summary_approved",
    "retryOnFailure": false
  }
}

curl https://api.runtype.com/v1/agents/id/executions/executionId \
     -H "Authorization: Bearer <token>" \
     -H "Content-Type: application/json"

{
  "id": "exec_9f8b7c6d5a4e3f21",
  "agentId": "agent_1234abcd5678efgh",
  "agentSource": "https://github.com/runtype/agents/sample-agent",
  "executionId": "exec_9f8b7c6d5a4e3f21",
  "parentExecutionId": "exec_1a2b3c4d5e6f7g8h",
  "surfaceType": "web",
  "status": "completed",
  "iterations": 5,
  "totalCost": "0.0234",
  "stopReason": "max_iterations_reached",
  "startedAt": "2024-06-10T09:15:30Z",
  "completedAt": "2024-06-10T09:17:45Z",
  "createdAt": "2024-06-10T09:15:00Z",
  "agentSpec": null,
  "totalTokens": 1450,
  "inputMessages": [
    {
      "role": "user",
      "content": "Generate a summary of the latest quarterly earnings report."
    }
  ],
  "finalOutput": {
    "summary": "The company reported a 12% increase in revenue driven by strong sales in the technology sector, with net profit margins improving by 3% compared to the previous quarter."
  },
  "iterationDetails": [
    {
      "iteration": 1,
      "output": "Initial data extraction completed.",
      "tokensUsed": 250
    },
    {
      "iteration": 2,
      "output": "Draft summary generated.",
      "tokensUsed": 300
    },
    {
      "iteration": 3,
      "output": "Summary refined with financial highlights.",
      "tokensUsed": 300
    },
    {
      "iteration": 4,
      "output": "Grammar and style improvements applied.",
      "tokensUsed": 300
    },
    {
      "iteration": 5,
      "output": "Final summary approved.",
      "tokensUsed": 300
    }
  ],
  "loopConfig": {
    "maxIterations": 5,
    "stopOnCondition": "summary_approved",
    "retryOnFailure": false
  }
}

Get full details for a single agent execution including final output, iteration details, and loop configuration.

Authentication

AuthorizationBearer

API key or Clerk session token

Path parameters

idstringRequired

executionIdstringRequired

Response

Execution detail

idstring

agentIdstring or null

agentSourcestring or null

executionIdstring

parentExecutionIdstring or null

surfaceTypestring or null

statusstring

iterationsinteger or null

totalCoststring or null

stopReasonstring or null

startedAtstring or null

completedAtstring or null

createdAtstring

agentSpecany or null

totalTokensany or null

inputMessagesany or null

finalOutputany or null

iterationDetailsany or null

loopConfigany or null

Errors

400

Bad Request Error

401

Unauthorized Error

403

Forbidden Error

404

Not Found Error

500

Internal Server Error

$	curl https://api.runtype.com/v1/agents/id/executions/executionId \
>	-H "Authorization: Bearer <token>" \
>	-H "Content-Type: application/json"

1	{
2	"id": "exec_9f8b7c6d5a4e3f21",
3	"agentId": "agent_1234abcd5678efgh",
4	"agentSource": "https://github.com/runtype/agents/sample-agent",
5	"executionId": "exec_9f8b7c6d5a4e3f21",
6	"parentExecutionId": "exec_1a2b3c4d5e6f7g8h",
7	"surfaceType": "web",
8	"status": "completed",
9	"iterations": 5,
10	"totalCost": "0.0234",
11	"stopReason": "max_iterations_reached",
12	"startedAt": "2024-06-10T09:15:30Z",
13	"completedAt": "2024-06-10T09:17:45Z",
14	"createdAt": "2024-06-10T09:15:00Z",
15	"agentSpec": null,
16	"totalTokens": 1450,
17	"inputMessages": [
18	{
19	"role": "user",
20	"content": "Generate a summary of the latest quarterly earnings report."
21	}
22	],
23	"finalOutput": {
24	"summary": "The company reported a 12% increase in revenue driven by strong sales in the technology sector, with net profit margins improving by 3% compared to the previous quarter."
25	},
26	"iterationDetails": [
27	{
28	"iteration": 1,
29	"output": "Initial data extraction completed.",
30	"tokensUsed": 250
31	},
32	{
33	"iteration": 2,
34	"output": "Draft summary generated.",
35	"tokensUsed": 300
36	},
37	{
38	"iteration": 3,
39	"output": "Summary refined with financial highlights.",
40	"tokensUsed": 300
41	},
42	{
43	"iteration": 4,
44	"output": "Grammar and style improvements applied.",
45	"tokensUsed": 300
46	},
47	{
48	"iteration": 5,
49	"output": "Final summary approved.",
50	"tokensUsed": 300
51	}
52	],
53	"loopConfig": {
54	"maxIterations": 5,
55	"stopOnCondition": "summary_approved",
56	"retryOnFailure": false
57	}
58	}