API de sesiones de agentes

Gestiona el estado de la conversación. Crear un registro de sesión no inicia por sí solo una ejecución de IA. Usa la aplicación de Adios o la integración MCP para iniciar el trabajo del agente.

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_session	Listar sesiones del agente
POST	/v1/agent_session	Crear sesión de agente
GET	/v1/agent_session/{id}	Obtener sesión del agente
PUT	/v1/agent_session/{id}	Actualizar sesión del agente
DELETE	/v1/agent_session/{id}	Eliminar sesión del agente
GET	/v1/agent_session/{id}/state	Obtener estado de la sesión del agente
GET	/v1/agent_session/{id}/plan	Obtener plan de la sesión del agente
POST	/v1/agent_session/{id}/runs/{run_id}/cancel	Cancelar ejecución del agente

Listar sesiones del agente

GET /v1/agent_session

Devuelve una lista paginada de AgentSession

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_session" \
  -H "Authorization: Bearer $ADIOS_ACCESS_TOKEN" \
  -H "X-Tenant-ID: $ADIOS_TEAM_ID"

Respuesta: HTTP 200

Lista de AgentSession

Campos de respuesta

Campo	Tipo	Descripción
data	array
data[].agent_session_id	string
data[].channel_id	string
data[].company_project_id	string
data[].context_snapshot	object
data[].created_at	integer	(marca de tiempo Unix)
data[].deleted_at	integer	(marca de tiempo Unix)
data[].last_message_at	integer	(marca de tiempo Unix)
data[].memory_summary	object
data[].metadata	object
data[].mode	string	Valores permitidos: build, debug, ops, review, chat.
data[].model	string
data[].owner_id	string
data[].provider	string
data[].sharing_scope	string	Valores permitidos: private, team.
data[].source	string	Valores permitidos: app, slack, cli.
data[].status	string	Valores permitidos: active, paused, blocked, complete, failed.
data[].team_id	string
data[].thread_id	string
data[].updated_at	integer	(marca de tiempo Unix)
data[].workspace_id	string
data[].writable_repository_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_session_id": "000000000000000000000000001",
      "channel_id": "",
      "company_project_id": "",
      "context_snapshot": {},
      "created_at": 1791072000,
      "deleted_at": 0,
      "last_message_at": 0,
      "memory_summary": {},
      "metadata": {},
      "mode": "chat",
      "model": "",
      "owner_id": "",
      "provider": "",
      "sharing_scope": "private",
      "source": "app",
      "status": "active",
      "team_id": "000000000000000000000000001",
      "thread_id": "",
      "updated_at": 1791072000,
      "workspace_id": "",
      "writable_repository_id": ""
    }
  ],
  "pagination": {
    "page": 1,
    "per_page": 1,
    "total": 1
  }
}

Crear sesión de agente

POST /v1/agent_session

Crea un nuevo AgentSession

Esta solicitud modifica datos o inicia una acción. Revisa el destino y el cuerpo antes de enviarla.

Campos de la solicitud (el cuerpo contiene un ejemplo editable):

Campo	Tipo	Obligatorio	Descripción
channel_id	string	no	Valor predeterminado: "".
company_project_id	string	no	Valor predeterminado: "".
context_snapshot	object	no
last_message_at	integer	no	(marca de tiempo Unix) Valor predeterminado: 0.
memory_summary	object	no
metadata	object	no
mode	string	sí	Valores permitidos: build, debug, ops, review, chat. Valor predeterminado: "chat".
model	string	no	Valor predeterminado: "".
owner_id	string	no	Valor predeterminado: "".
provider	string	no	Valor predeterminado: "".
sharing_scope	string	sí	Valores permitidos: private, team. Valor predeterminado: "private".
source	string	sí	Valores permitidos: app, slack, cli.
status	string	sí	Valores permitidos: active, paused, blocked, complete, failed. Valor predeterminado: "active".
team_id	string	sí
thread_id	string	no	Valor predeterminado: "".
workspace_id	string	no	Valor predeterminado: "".
writable_repository_id	string	no	Valor predeterminado: "".

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.

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 POST "$ADIOS_API_URL/v1/agent_session" \
  -H "Authorization: Bearer $ADIOS_ACCESS_TOKEN" \
  -H "X-Tenant-ID: $ADIOS_TEAM_ID" \
  -H "Content-Type: application/json" \
  --data-binary @- <<'JSON'
{
  "team_id": "YOUR_TEAM_ID",
  "owner_id": "YOUR_USER_ID",
  "workspace_id": "YOUR_WORKSPACE_ID",
  "sharing_scope": "private",
  "source": "app",
  "mode": "chat",
  "status": "active"
}
JSON

Reemplaza los marcadores YOUR_* del cuerpo antes de enviar la solicitud. El heredoc entrecomillado conserva el JSON literal.

Respuesta: HTTP 201

AgentSession creado

Campos de respuesta

Campo	Tipo	Descripción
agent_session_id	string
channel_id	string
company_project_id	string
context_snapshot	object
created_at	integer	(marca de tiempo Unix)
deleted_at	integer	(marca de tiempo Unix)
last_message_at	integer	(marca de tiempo Unix)
memory_summary	object
metadata	object
mode	string	Valores permitidos: build, debug, ops, review, chat.
model	string
owner_id	string
provider	string
sharing_scope	string	Valores permitidos: private, team.
source	string	Valores permitidos: app, slack, cli.
status	string	Valores permitidos: active, paused, blocked, complete, failed.
team_id	string
thread_id	string
updated_at	integer	(marca de tiempo Unix)
workspace_id	string
writable_repository_id	string

Ejemplo ilustrativo; no es una respuesta real:

{
  "agent_session_id": "000000000000000000000000001",
  "channel_id": "",
  "company_project_id": "",
  "context_snapshot": {},
  "created_at": 1791072000,
  "deleted_at": 0,
  "last_message_at": 0,
  "memory_summary": {},
  "metadata": {},
  "mode": "chat",
  "model": "",
  "owner_id": "",
  "provider": "",
  "sharing_scope": "private",
  "source": "app",
  "status": "active",
  "team_id": "000000000000000000000000001",
  "thread_id": "",
  "updated_at": 1791072000,
  "workspace_id": "",
  "writable_repository_id": ""
}

Obtener sesión del agente

GET /v1/agent_session/{id}

Devuelve un único AgentSession

Configura agent_session_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

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_session/${ADIOS_AGENT_SESSION_ID}" \
  -H "Authorization: Bearer $ADIOS_ACCESS_TOKEN" \
  -H "X-Tenant-ID: $ADIOS_TEAM_ID"

Respuesta: HTTP 200

AgentSession

Campos de respuesta

Campo	Tipo	Descripción
agent_session_id	string
channel_id	string
company_project_id	string
context_snapshot	object
created_at	integer	(marca de tiempo Unix)
deleted_at	integer	(marca de tiempo Unix)
last_message_at	integer	(marca de tiempo Unix)
memory_summary	object
metadata	object
mode	string	Valores permitidos: build, debug, ops, review, chat.
model	string
owner_id	string
provider	string
sharing_scope	string	Valores permitidos: private, team.
source	string	Valores permitidos: app, slack, cli.
status	string	Valores permitidos: active, paused, blocked, complete, failed.
team_id	string
thread_id	string
updated_at	integer	(marca de tiempo Unix)
workspace_id	string
writable_repository_id	string

Ejemplo ilustrativo; no es una respuesta real:

{
  "agent_session_id": "000000000000000000000000001",
  "channel_id": "",
  "company_project_id": "",
  "context_snapshot": {},
  "created_at": 1791072000,
  "deleted_at": 0,
  "last_message_at": 0,
  "memory_summary": {},
  "metadata": {},
  "mode": "chat",
  "model": "",
  "owner_id": "",
  "provider": "",
  "sharing_scope": "private",
  "source": "app",
  "status": "active",
  "team_id": "000000000000000000000000001",
  "thread_id": "",
  "updated_at": 1791072000,
  "workspace_id": "",
  "writable_repository_id": ""
}

Actualizar sesión del agente

PUT /v1/agent_session/{id}

Actualiza un AgentSession existente

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

Esta solicitud modifica datos o inicia una acción. Revisa el destino y el cuerpo antes de enviarla.

Campos de la solicitud (el cuerpo contiene un ejemplo editable):

Campo	Tipo	Obligatorio	Descripción
channel_id	string	no	Valor predeterminado: "".
company_project_id	string	no	Valor predeterminado: "".
context_snapshot	object	no
last_message_at	integer	no	(marca de tiempo Unix) Valor predeterminado: 0.
memory_summary	object	no
metadata	object	no
mode	string	sí	Valores permitidos: build, debug, ops, review, chat. Valor predeterminado: "chat".
model	string	no	Valor predeterminado: "".
owner_id	string	no	Valor predeterminado: "".
provider	string	no	Valor predeterminado: "".
sharing_scope	string	sí	Valores permitidos: private, team. Valor predeterminado: "private".
source	string	sí	Valores permitidos: app, slack, cli.
status	string	sí	Valores permitidos: active, paused, blocked, complete, failed. Valor predeterminado: "active".
team_id	string	sí
thread_id	string	no	Valor predeterminado: "".
workspace_id	string	no	Valor predeterminado: "".
writable_repository_id	string	no	Valor predeterminado: "".

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

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 PUT "$ADIOS_API_URL/v1/agent_session/${ADIOS_AGENT_SESSION_ID}" \
  -H "Authorization: Bearer $ADIOS_ACCESS_TOKEN" \
  -H "X-Tenant-ID: $ADIOS_TEAM_ID" \
  -H "Content-Type: application/json" \
  --data-binary @- <<'JSON'
{
  "team_id": "YOUR_TEAM_ID",
  "owner_id": "YOUR_USER_ID",
  "workspace_id": "YOUR_WORKSPACE_ID",
  "sharing_scope": "private",
  "source": "app",
  "mode": "chat",
  "status": "active"
}
JSON

Reemplaza los marcadores YOUR_* del cuerpo antes de enviar la solicitud. El heredoc entrecomillado conserva el JSON literal.

Respuesta: HTTP 200

AgentSession actualizado

Campos de respuesta

Campo	Tipo	Descripción
agent_session_id	string
channel_id	string
company_project_id	string
context_snapshot	object
created_at	integer	(marca de tiempo Unix)
deleted_at	integer	(marca de tiempo Unix)
last_message_at	integer	(marca de tiempo Unix)
memory_summary	object
metadata	object
mode	string	Valores permitidos: build, debug, ops, review, chat.
model	string
owner_id	string
provider	string
sharing_scope	string	Valores permitidos: private, team.
source	string	Valores permitidos: app, slack, cli.
status	string	Valores permitidos: active, paused, blocked, complete, failed.
team_id	string
thread_id	string
updated_at	integer	(marca de tiempo Unix)
workspace_id	string
writable_repository_id	string

Ejemplo ilustrativo; no es una respuesta real:

{
  "agent_session_id": "000000000000000000000000001",
  "channel_id": "",
  "company_project_id": "",
  "context_snapshot": {},
  "created_at": 1791072000,
  "deleted_at": 0,
  "last_message_at": 0,
  "memory_summary": {},
  "metadata": {},
  "mode": "chat",
  "model": "",
  "owner_id": "",
  "provider": "",
  "sharing_scope": "private",
  "source": "app",
  "status": "active",
  "team_id": "000000000000000000000000001",
  "thread_id": "",
  "updated_at": 1791072000,
  "workspace_id": "",
  "writable_repository_id": ""
}

Eliminar sesión del agente

DELETE /v1/agent_session/{id}

Elimina un AgentSession

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

Esta solicitud modifica datos o inicia una acción. Revisa el destino y el cuerpo antes de enviarla.

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

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 DELETE "$ADIOS_API_URL/v1/agent_session/${ADIOS_AGENT_SESSION_ID}" \
  -H "Authorization: Bearer $ADIOS_ACCESS_TOKEN" \
  -H "X-Tenant-ID: $ADIOS_TEAM_ID"

Respuesta: HTTP 200

Recurso eliminado.

Campos de respuesta

Campo	Tipo	Descripción
message	string

Ejemplo ilustrativo; no es una respuesta real:

{
  "message": "Deleted successfully"
}

Obtener estado de la sesión del agente

GET /v1/agent_session/{id}/state

Lee el estado de la sesión.

Configura agent_session_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

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_session/${ADIOS_AGENT_SESSION_ID}/state" \
  -H "Authorization: Bearer $ADIOS_ACCESS_TOKEN" \
  -H "X-Tenant-ID: $ADIOS_TEAM_ID"

Respuesta: HTTP 200

Respuesta correcta. Inspecciona el estado devuelto por las operaciones que inician trabajo asíncrono.

No se publica un esquema completo del cuerpo de respuesta para esta operación personalizada. Inspecciona el contenido y el estado devueltos; aquí no se presupone ningún payload.

Obtener plan de la sesión del agente

GET /v1/agent_session/{id}/plan

Lee el plan actual de la sesión.

Configura agent_session_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

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_session/${ADIOS_AGENT_SESSION_ID}/plan" \
  -H "Authorization: Bearer $ADIOS_ACCESS_TOKEN" \
  -H "X-Tenant-ID: $ADIOS_TEAM_ID"

Respuesta: HTTP 200

Respuesta correcta. Inspecciona el estado devuelto por las operaciones que inician trabajo asíncrono.

No se publica un esquema completo del cuerpo de respuesta para esta operación personalizada. Inspecciona el contenido y el estado devueltos; aquí no se presupone ningún payload.

Cancelar ejecución del agente

POST /v1/agent_session/{id}/runs/{run_id}/cancel

Solicita la cancelación de una ejecución activa de la sesión.

Configura agent_session_id, agent_run_id usando IDs de tus propias respuestas de la API.

Esta solicitud modifica datos o inicia una acción. Revisa el destino y el cuerpo antes de enviarla.

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.
run_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

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 POST "$ADIOS_API_URL/v1/agent_session/${ADIOS_AGENT_SESSION_ID}/runs/${ADIOS_AGENT_RUN_ID}/cancel" \
  -H "Authorization: Bearer $ADIOS_ACCESS_TOKEN" \
  -H "X-Tenant-ID: $ADIOS_TEAM_ID"

Respuesta: HTTP 200

Respuesta correcta. Inspecciona el estado devuelto por las operaciones que inician trabajo asíncrono.

No se publica un esquema completo del cuerpo de respuesta para esta operación personalizada. Inspecciona el contenido y el estado devueltos; aquí no se presupone ningún payload.