API de planes de agentes

Inspecciona los planes guardados y sus pasos.

Usa Autenticación de la API para las solicitudes protegidas. Los ejemplos usan tus propios IDs de recursos y un token temporal; las respuestas de ejemplo guardadas son sintéticas.

Método	Ruta	Operación
`GET`	`/v1/agent_plan`	Listar planes del agente
`GET`	`/v1/agent_plan/{id}`	Obtener plan del agente
`GET`	`/v1/agent_plan_step`	Listar pasos del plan del agente
`GET`	`/v1/agent_plan_step/{id}`	Obtener paso del plan del agente

Listar planes del agente

GET /v1/agent_plan

Devuelve una lista paginada de AgentPlan

Autenticación: token bearer y la cabecera de equipo que se muestra a continuación.

Parámetros

Nombre	Ubicación	Obligatorio	Descripción
`X-Tenant-ID`	cabecera	sí	ID del equipo activo. Debe coincidir con el tenant vinculado al token de diagnóstico.
`page`	consulta	no	Número de página
`per_page`	consulta	no	Elementos por página

Ejemplo de solicitud

Configura ADIOS_API_URL=https://api.adios.dev. Para las solicitudes protegidas, configura ADIOS_ACCESS_TOKEN y ADIOS_TEAM_ID como en el inicio rápido. Configura las variables adicionales ADIOS_* a partir de los resultados de tus propios recursos.

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"

Respuesta: HTTP 200

Lista de AgentPlan

Campos de respuesta

Campo	Tipo	Descripción
`data`	array
`data[].agent_plan_id`	string
`data[].agent_run_id`	string
`data[].agent_session_id`	string
`data[].created_at`	integer	(marca de tiempo Unix)
`data[].deleted_at`	integer	(marca de tiempo Unix)
`data[].metadata`	object
`data[].status`	string	Valores permitidos: pending, running, blocked, complete, failed, cancelled.
`data[].summary`	object
`data[].team_id`	string
`data[].title`	string
`data[].updated_at`	integer	(marca de tiempo Unix)
`data[].workspace_id`	string
`pagination`	object
`pagination.page`	integer	Número de página actual
`pagination.per_page`	integer	Número de elementos por página
`pagination.total`	integer	Número total de elementos

Ejemplo ilustrativo; no es una respuesta real:

{
  "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
  }
}

Obtener plan del agente

GET /v1/agent_plan/{id}

Devuelve un único AgentPlan

Configura agent_plan_id usando IDs de tus propias respuestas de la API.

Autenticación: token bearer y la cabecera de equipo que se muestra a continuación.

Parámetros

Nombre	Ubicación	Obligatorio	Descripción
`id`	ruta	sí	Identificador del recurso obtenido de los resultados de la API de tu equipo.
`X-Tenant-ID`	cabecera	sí	ID del equipo activo. Debe coincidir con el tenant vinculado al token de diagnóstico.

Ejemplo de solicitud

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"

Respuesta: HTTP 200

AgentPlan

Campos de respuesta

Campo	Tipo	Descripción
`agent_plan_id`	string
`agent_run_id`	string
`agent_session_id`	string
`created_at`	integer	(marca de tiempo Unix)
`deleted_at`	integer	(marca de tiempo Unix)
`metadata`	object
`status`	string	Valores permitidos: pending, running, blocked, complete, failed, cancelled.
`summary`	object
`team_id`	string
`title`	string
`updated_at`	integer	(marca de tiempo Unix)
`workspace_id`	string

Ejemplo ilustrativo; no es una respuesta real:

{
  "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": ""
}

Listar pasos del plan del agente

GET /v1/agent_plan_step

Devuelve una lista paginada de AgentPlanStep

Autenticación: token bearer y la cabecera de equipo que se muestra a continuación.

Parámetros

Nombre	Ubicación	Obligatorio	Descripción
`X-Tenant-ID`	cabecera	sí	ID del equipo activo. Debe coincidir con el tenant vinculado al token de diagnóstico.
`page`	consulta	no	Número de página
`per_page`	consulta	no	Elementos por página

Ejemplo de solicitud

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"

Respuesta: HTTP 200

Lista de AgentPlanStep

Campos de respuesta

Campo	Tipo	Descripción
`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	(marca de tiempo Unix)
`data[].created_at`	integer	(marca de tiempo Unix)
`data[].deleted_at`	integer	(marca de tiempo Unix)
`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	Valores permitidos: lead, security, code_quality, test_verification.
`data[].started_at`	integer	(marca de tiempo Unix)
`data[].status`	string	Valores permitidos: pending, running, passed, failed, blocked, skipped.
`data[].team_id`	string
`data[].title`	string
`data[].tool_name`	string
`data[].updated_at`	integer	(marca de tiempo Unix)
`pagination`	object
`pagination.page`	integer	Número de página actual
`pagination.per_page`	integer	Número de elementos por página
`pagination.total`	integer	Número total de elementos

Aquí se omite el ejemplo de colección derivado del esquema porque no cumple el esquema de respuesta publicado. Usa el contrato de campos anterior.

Obtener paso del plan del agente

GET /v1/agent_plan_step/{id}

Devuelve un único AgentPlanStep

Configura agent_plan_step_id usando IDs de tus propias respuestas de la API.

Autenticación: token bearer y la cabecera de equipo que se muestra a continuación.

Parámetros

Nombre	Ubicación	Obligatorio	Descripción
`id`	ruta	sí	Identificador del recurso obtenido de los resultados de la API de tu equipo.
`X-Tenant-ID`	cabecera	sí	ID del equipo activo. Debe coincidir con el tenant vinculado al token de diagnóstico.

Ejemplo de solicitud

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"

Respuesta: HTTP 200

AgentPlanStep

Campos de respuesta

Campo	Tipo	Descripción
`agent_plan_id`	string
`agent_plan_step_id`	string
`agent_version_id`	string
`child_agent_run_id`	string
`completed_at`	integer	(marca de tiempo Unix)
`created_at`	integer	(marca de tiempo Unix)
`deleted_at`	integer	(marca de tiempo Unix)
`dependencies`	object
`description`	object
`error`	object
`execution_task_id`	string
`metadata`	object
`position`	integer
`role_key`	string
`specialist_role`	string	Valores permitidos: lead, security, code_quality, test_verification.
`started_at`	integer	(marca de tiempo Unix)
`status`	string	Valores permitidos: pending, running, passed, failed, blocked, skipped.
`team_id`	string
`title`	string
`tool_name`	string
`updated_at`	integer	(marca de tiempo Unix)

Aquí se omite el ejemplo de colección derivado del esquema porque no cumple el esquema de respuesta publicado. Usa el contrato de campos anterior.