Agent plans API

Inspect saved plans and their steps.

Use API authentication for protected requests. Examples use your own resource IDs and a temporary token; saved response examples are synthetic.

Method	Path	Operation
GET	/v1/agent_plan	List agent plans
GET	/v1/agent_plan/{id}	Get agent plan
GET	/v1/agent_plan_step	List agent plan steps
GET	/v1/agent_plan_step/{id}	Get agent plan step

List agent plans

GET /v1/agent_plan

Returns a paginated list of AgentPlan

Authentication: bearer token and the team header shown below.

Parameters

Name	Location	Required	Description
X-Tenant-ID	header	yes	Active team ID. Must match the tenant bound to a diagnostic token.
page	query	no	Page number
per_page	query	no	Items per page

Request example

Set ADIOS_API_URL=https://api.adios.dev. For protected requests, set ADIOS_ACCESS_TOKEN and ADIOS_TEAM_ID as in the quickstart. Set any additional ADIOS_* variables from your own resource results.

curl --fail-with-body --request GET "$ADIOS_API_URL/v1/agent_plan" \
  -H "Authorization: Bearer $ADIOS_ACCESS_TOKEN" \
  -H "X-Tenant-ID: $ADIOS_TEAM_ID"

Response: HTTP 200

List of AgentPlan

Response fields

Field	Type	Description
data	array
data[].agent_plan_id	string
data[].agent_run_id	string
data[].agent_session_id	string
data[].created_at	integer	(Unix timestamp)
data[].deleted_at	integer	(Unix timestamp)
data[].metadata	object
data[].status	string	Allowed: pending, running, blocked, complete, failed, cancelled.
data[].summary	object
data[].team_id	string
data[].title	string
data[].updated_at	integer	(Unix timestamp)
data[].workspace_id	string
pagination	object
pagination.page	integer	Current page number
pagination.per_page	integer	Number of items per page
pagination.total	integer	Total number of items

Illustrative example; not a live response:

{
  "data": [
    {
      "agent_plan_id": "000000000000000000000000001",
      "agent_run_id": "",
      "agent_session_id": "000000000000000000000000001",
      "created_at": 1791072000,
      "deleted_at": 0,
      "metadata": {},
      "status": "pending",
      "summary": "",
      "team_id": "000000000000000000000000001",
      "title": "Agent plan",
      "updated_at": 1791072000,
      "workspace_id": ""
    }
  ],
  "pagination": {
    "page": 1,
    "per_page": 1,
    "total": 1
  }
}

Get agent plan

GET /v1/agent_plan/{id}

Returns a single AgentPlan

Set agent_plan_id using IDs from your own API responses.

Authentication: bearer token and the team header shown below.

Parameters

Name	Location	Required	Description
id	path	yes	Resource identifier from your team's API results.
X-Tenant-ID	header	yes	Active team ID. Must match the tenant bound to a diagnostic token.

Request example

Set ADIOS_API_URL=https://api.adios.dev. For protected requests, set ADIOS_ACCESS_TOKEN and ADIOS_TEAM_ID as in the quickstart. Set any additional ADIOS_* variables from your own resource results.

curl --fail-with-body --request GET "$ADIOS_API_URL/v1/agent_plan/${ADIOS_AGENT_PLAN_ID}" \
  -H "Authorization: Bearer $ADIOS_ACCESS_TOKEN" \
  -H "X-Tenant-ID: $ADIOS_TEAM_ID"

Response: HTTP 200

AgentPlan

Response fields

Field	Type	Description
agent_plan_id	string
agent_run_id	string
agent_session_id	string
created_at	integer	(Unix timestamp)
deleted_at	integer	(Unix timestamp)
metadata	object
status	string	Allowed: pending, running, blocked, complete, failed, cancelled.
summary	object
team_id	string
title	string
updated_at	integer	(Unix timestamp)
workspace_id	string

Illustrative example; not a live response:

{
  "agent_plan_id": "000000000000000000000000001",
  "agent_run_id": "",
  "agent_session_id": "000000000000000000000000001",
  "created_at": 1791072000,
  "deleted_at": 0,
  "metadata": {},
  "status": "pending",
  "summary": "",
  "team_id": "000000000000000000000000001",
  "title": "Agent plan",
  "updated_at": 1791072000,
  "workspace_id": ""
}

List agent plan steps

GET /v1/agent_plan_step

Returns a paginated list of AgentPlanStep

Authentication: bearer token and the team header shown below.

Parameters

Name	Location	Required	Description
X-Tenant-ID	header	yes	Active team ID. Must match the tenant bound to a diagnostic token.
page	query	no	Page number
per_page	query	no	Items per page

Request example

Set ADIOS_API_URL=https://api.adios.dev. For protected requests, set ADIOS_ACCESS_TOKEN and ADIOS_TEAM_ID as in the quickstart. Set any additional ADIOS_* variables from your own resource results.

curl --fail-with-body --request GET "$ADIOS_API_URL/v1/agent_plan_step" \
  -H "Authorization: Bearer $ADIOS_ACCESS_TOKEN" \
  -H "X-Tenant-ID: $ADIOS_TEAM_ID"

Response: HTTP 200

List of AgentPlanStep

Response fields

Field	Type	Description
data	array
data[].agent_plan_id	string
data[].agent_plan_step_id	string
data[].agent_version_id	string
data[].child_agent_run_id	string
data[].completed_at	integer	(Unix timestamp)
data[].created_at	integer	(Unix timestamp)
data[].deleted_at	integer	(Unix timestamp)
data[].dependencies	object
data[].description	object
data[].error	object
data[].execution_task_id	string
data[].metadata	object
data[].position	integer
data[].role_key	string
data[].specialist_role	string	Allowed: lead, security, code_quality, test_verification.
data[].started_at	integer	(Unix timestamp)
data[].status	string	Allowed: pending, running, passed, failed, blocked, skipped.
data[].team_id	string
data[].title	string
data[].tool_name	string
data[].updated_at	integer	(Unix timestamp)
pagination	object
pagination.page	integer	Current page number
pagination.per_page	integer	Number of items per page
pagination.total	integer	Total number of items

The schema-derived collection illustration is omitted here because it does not satisfy the published response schema. Use the field contract above.

Get agent plan step

GET /v1/agent_plan_step/{id}

Returns a single AgentPlanStep

Set agent_plan_step_id using IDs from your own API responses.

Authentication: bearer token and the team header shown below.

Parameters

Name	Location	Required	Description
id	path	yes	Resource identifier from your team's API results.
X-Tenant-ID	header	yes	Active team ID. Must match the tenant bound to a diagnostic token.

Request example

Set ADIOS_API_URL=https://api.adios.dev. For protected requests, set ADIOS_ACCESS_TOKEN and ADIOS_TEAM_ID as in the quickstart. Set any additional ADIOS_* variables from your own resource results.

curl --fail-with-body --request GET "$ADIOS_API_URL/v1/agent_plan_step/${ADIOS_AGENT_PLAN_STEP_ID}" \
  -H "Authorization: Bearer $ADIOS_ACCESS_TOKEN" \
  -H "X-Tenant-ID: $ADIOS_TEAM_ID"

Response: HTTP 200

AgentPlanStep

Response fields

Field	Type	Description
agent_plan_id	string
agent_plan_step_id	string
agent_version_id	string
child_agent_run_id	string
completed_at	integer	(Unix timestamp)
created_at	integer	(Unix timestamp)
deleted_at	integer	(Unix timestamp)
dependencies	object
description	object
error	object
execution_task_id	string
metadata	object
position	integer
role_key	string
specialist_role	string	Allowed: lead, security, code_quality, test_verification.
started_at	integer	(Unix timestamp)
status	string	Allowed: pending, running, passed, failed, blocked, skipped.
team_id	string
title	string
tool_name	string
updated_at	integer	(Unix timestamp)

The schema-derived collection illustration is omitted here because it does not satisfy the published response schema. Use the field contract above.