API des sessions d’agent

Gérez l’état des conversations. Créer un enregistrement de session ne lance pas à lui seul une exécution IA. Utilisez l’application Adios ou l’intégration MCP pour démarrer le travail de l’agent.

Utiliser Authentification API pour les requêtes protégées. Les exemples utilisent vos propres ID de ressources et un jeton temporaire ; les exemples de réponses enregistrés sont synthétiques.

Méthode	Chemin	Opération
GET	/v1/agent_session	Lister les sessions d’agent
POST	/v1/agent_session	Créer une session d'agent
GET	/v1/agent_session/{id}	Obtenir une session d'agent
PUT	/v1/agent_session/{id}	Mettre à jour la session d'agent
DELETE	/v1/agent_session/{id}	Supprimer la session d’agent
GET	/v1/agent_session/{id}/state	Obtenir l’état de la session d’agent
GET	/v1/agent_session/{id}/plan	Obtenir le plan de la session d’agent
POST	/v1/agent_session/{id}/runs/{run_id}/cancel	Annuler l’exécution d’agent

Lister les sessions d’agent

GET /v1/agent_session

Renvoie une liste paginée d’AgentSession

Authentification : jeton bearer et en-tête d’équipe présentés ci-dessous.

Paramètres

Nom	Emplacement	Requis	Description
X-Tenant-ID	en-tête	oui	ID de l’équipe active. Doit correspondre au tenant lié au jeton de diagnostic.
page	requête	non	Numéro de page
per_page	requête	non	Éléments par page

Exemple de requête

Définissez ADIOS_API_URL=https://api.adios.dev. Pour les requêtes protégées, définissez ADIOS_ACCESS_TOKEN et ADIOS_TEAM_ID comme dans le démarrage rapide. Définissez les autres variables ADIOS_* à partir des résultats de vos propres ressources.

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"

Réponse : HTTP 200

Liste d’AgentSession

Champs de réponse

Champ	Type	Description
data	tableau
data[].agent_session_id	chaîne
data[].channel_id	chaîne
data[].company_project_id	chaîne
data[].context_snapshot	objet
data[].created_at	entier	(horodatage Unix)
data[].deleted_at	entier	(horodatage Unix)
data[].last_message_at	entier	(horodatage Unix)
data[].memory_summary	objet
data[].metadata	objet
data[].mode	chaîne	Valeurs autorisées : build, debug, ops, review, chat.
data[].model	chaîne
data[].owner_id	chaîne
data[].provider	chaîne
data[].sharing_scope	chaîne	Valeurs autorisées : private, team.
data[].source	chaîne	Valeurs autorisées : app, slack, cli.
data[].status	chaîne	Valeurs autorisées : active, paused, blocked, complete, failed.
data[].team_id	chaîne
data[].thread_id	chaîne
data[].updated_at	entier	(horodatage Unix)
data[].workspace_id	chaîne
data[].writable_repository_id	chaîne
pagination	objet
pagination.page	entier	Numéro de page actuel
pagination.per_page	entier	Nombre d’éléments par page
pagination.total	entier	Nombre total d’éléments

Exemple illustratif ; il ne s’agit pas d’une réponse réelle :

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

Créer une session d'agent

POST /v1/agent_session

Crée un nouvel objet AgentSession

Cette requête modifie des données ou lance une action. Vérifiez la cible et le corps avant de l’envoyer.

Champs de la requête (le corps contient un exemple modifiable) :

Champ	Type	Requis	Description
channel_id	chaîne	non	Valeur par défaut : "".
company_project_id	chaîne	non	Valeur par défaut : "".
context_snapshot	objet	non
last_message_at	entier	non	(horodatage Unix) Valeur par défaut : 0.
memory_summary	objet	non
metadata	objet	non
mode	chaîne	oui	Valeurs autorisées : build, debug, ops, review, chat. Valeur par défaut : "chat".
model	chaîne	non	Valeur par défaut : "".
owner_id	chaîne	non	Valeur par défaut : "".
provider	chaîne	non	Valeur par défaut : "".
sharing_scope	chaîne	oui	Valeurs autorisées : private, team. Valeur par défaut : "private".
source	chaîne	oui	Valeurs autorisées : app, slack, cli.
status	chaîne	oui	Valeurs autorisées : active, paused, blocked, complete, failed. Valeur par défaut : "active".
team_id	chaîne	oui
thread_id	chaîne	non	Valeur par défaut : "".
workspace_id	chaîne	non	Valeur par défaut : "".
writable_repository_id	chaîne	non	Valeur par défaut : "".

Authentification : jeton bearer et en-tête d’équipe présentés ci-dessous.

Paramètres

Nom	Emplacement	Requis	Description
X-Tenant-ID	en-tête	oui	ID de l’équipe active. Doit correspondre au tenant lié au jeton de diagnostic.

Exemple de requête

Définissez ADIOS_API_URL=https://api.adios.dev. Pour les requêtes protégées, définissez ADIOS_ACCESS_TOKEN et ADIOS_TEAM_ID comme dans le démarrage rapide. Définissez les autres variables ADIOS_* à partir des résultats de vos propres ressources.

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

Remplacez YOUR_* du corps avant l’envoi. Le heredoc entre guillemets préserve le JSON littéral.

Réponse : HTTP 201

AgentSession créée

Champs de réponse

Champ	Type	Description
agent_session_id	chaîne
channel_id	chaîne
company_project_id	chaîne
context_snapshot	objet
created_at	entier	(horodatage Unix)
deleted_at	entier	(horodatage Unix)
last_message_at	entier	(horodatage Unix)
memory_summary	objet
metadata	objet
mode	chaîne	Valeurs autorisées : build, debug, ops, review, chat.
model	chaîne
owner_id	chaîne
provider	chaîne
sharing_scope	chaîne	Valeurs autorisées : private, team.
source	chaîne	Valeurs autorisées : app, slack, cli.
status	chaîne	Valeurs autorisées : active, paused, blocked, complete, failed.
team_id	chaîne
thread_id	chaîne
updated_at	entier	(horodatage Unix)
workspace_id	chaîne
writable_repository_id	chaîne

Exemple illustratif ; il ne s’agit pas d’une réponse réelle :

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

Obtenir une session d'agent

GET /v1/agent_session/{id}

Renvoie un seul AgentSession

Définissez agent_session_id en utilisant les ID de vos propres réponses API.

Authentification : jeton bearer et en-tête d’équipe présentés ci-dessous.

Paramètres

Nom	Emplacement	Requis	Description
id	chemin	oui	Identifiant de ressource issu des résultats API de votre équipe.
X-Tenant-ID	en-tête	oui	ID de l’équipe active. Doit correspondre au tenant lié au jeton de diagnostic.

Exemple de requête

Définissez ADIOS_API_URL=https://api.adios.dev. Pour les requêtes protégées, définissez ADIOS_ACCESS_TOKEN et ADIOS_TEAM_ID comme dans le démarrage rapide. Définissez les autres variables ADIOS_* à partir des résultats de vos propres ressources.

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"

Réponse : HTTP 200

AgentSession

Champs de réponse

Champ	Type	Description
agent_session_id	chaîne
channel_id	chaîne
company_project_id	chaîne
context_snapshot	objet
created_at	entier	(horodatage Unix)
deleted_at	entier	(horodatage Unix)
last_message_at	entier	(horodatage Unix)
memory_summary	objet
metadata	objet
mode	chaîne	Valeurs autorisées : build, debug, ops, review, chat.
model	chaîne
owner_id	chaîne
provider	chaîne
sharing_scope	chaîne	Valeurs autorisées : private, team.
source	chaîne	Valeurs autorisées : app, slack, cli.
status	chaîne	Valeurs autorisées : active, paused, blocked, complete, failed.
team_id	chaîne
thread_id	chaîne
updated_at	entier	(horodatage Unix)
workspace_id	chaîne
writable_repository_id	chaîne

Exemple illustratif ; il ne s’agit pas d’une réponse réelle :

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

Mettre à jour la session d'agent

PUT /v1/agent_session/{id}

Met à jour un objet AgentSession existant

Définissez agent_session_id en utilisant les ID de vos propres réponses API.

Cette requête modifie des données ou lance une action. Vérifiez la cible et le corps avant de l’envoyer.

Champs de la requête (le corps contient un exemple modifiable) :

Champ	Type	Requis	Description
channel_id	chaîne	non	Valeur par défaut : "".
company_project_id	chaîne	non	Valeur par défaut : "".
context_snapshot	objet	non
last_message_at	entier	non	(horodatage Unix) Valeur par défaut : 0.
memory_summary	objet	non
metadata	objet	non
mode	chaîne	oui	Valeurs autorisées : build, debug, ops, review, chat. Valeur par défaut : "chat".
model	chaîne	non	Valeur par défaut : "".
owner_id	chaîne	non	Valeur par défaut : "".
provider	chaîne	non	Valeur par défaut : "".
sharing_scope	chaîne	oui	Valeurs autorisées : private, team. Valeur par défaut : "private".
source	chaîne	oui	Valeurs autorisées : app, slack, cli.
status	chaîne	oui	Valeurs autorisées : active, paused, blocked, complete, failed. Valeur par défaut : "active".
team_id	chaîne	oui
thread_id	chaîne	non	Valeur par défaut : "".
workspace_id	chaîne	non	Valeur par défaut : "".
writable_repository_id	chaîne	non	Valeur par défaut : "".

Authentification : jeton bearer et en-tête d’équipe présentés ci-dessous.

Paramètres

Nom	Emplacement	Requis	Description
id	chemin	oui	Identifiant de ressource issu des résultats API de votre équipe.
X-Tenant-ID	en-tête	oui	ID de l’équipe active. Doit correspondre au tenant lié au jeton de diagnostic.

Exemple de requête

Définissez ADIOS_API_URL=https://api.adios.dev. Pour les requêtes protégées, définissez ADIOS_ACCESS_TOKEN et ADIOS_TEAM_ID comme dans le démarrage rapide. Définissez les autres variables ADIOS_* à partir des résultats de vos propres ressources.

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

Remplacez YOUR_* du corps avant l’envoi. Le heredoc entre guillemets préserve le JSON littéral.

Réponse : HTTP 200

AgentSession mise à jour

Champs de réponse

Champ	Type	Description
agent_session_id	chaîne
channel_id	chaîne
company_project_id	chaîne
context_snapshot	objet
created_at	entier	(horodatage Unix)
deleted_at	entier	(horodatage Unix)
last_message_at	entier	(horodatage Unix)
memory_summary	objet
metadata	objet
mode	chaîne	Valeurs autorisées : build, debug, ops, review, chat.
model	chaîne
owner_id	chaîne
provider	chaîne
sharing_scope	chaîne	Valeurs autorisées : private, team.
source	chaîne	Valeurs autorisées : app, slack, cli.
status	chaîne	Valeurs autorisées : active, paused, blocked, complete, failed.
team_id	chaîne
thread_id	chaîne
updated_at	entier	(horodatage Unix)
workspace_id	chaîne
writable_repository_id	chaîne

Exemple illustratif ; il ne s’agit pas d’une réponse réelle :

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

Supprimer la session d’agent

DELETE /v1/agent_session/{id}

Supprime un objet AgentSession

Définissez agent_session_id en utilisant les ID de vos propres réponses API.

Cette requête modifie des données ou lance une action. Vérifiez la cible et le corps avant de l’envoyer.

Authentification : jeton bearer et en-tête d’équipe présentés ci-dessous.

Paramètres

Nom	Emplacement	Requis	Description
id	chemin	oui	Identifiant de ressource issu des résultats API de votre équipe.
X-Tenant-ID	en-tête	oui	ID de l’équipe active. Doit correspondre au tenant lié au jeton de diagnostic.

Exemple de requête

Définissez ADIOS_API_URL=https://api.adios.dev. Pour les requêtes protégées, définissez ADIOS_ACCESS_TOKEN et ADIOS_TEAM_ID comme dans le démarrage rapide. Définissez les autres variables ADIOS_* à partir des résultats de vos propres ressources.

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"

Réponse : HTTP 200

Ressource supprimée.

Champs de réponse

Champ	Type	Description
message	chaîne

Exemple illustratif ; il ne s’agit pas d’une réponse réelle :

{
  "message": "Deleted successfully"
}

Obtenir l’état de la session d’agent

GET /v1/agent_session/{id}/state

Lisez l'état de la session.

Définissez agent_session_id en utilisant les ID de vos propres réponses API.

Authentification : jeton bearer et en-tête d’équipe présentés ci-dessous.

Paramètres

Nom	Emplacement	Requis	Description
id	chemin	oui	Identifiant de ressource issu des résultats API de votre équipe.
X-Tenant-ID	en-tête	oui	ID de l’équipe active. Doit correspondre au tenant lié au jeton de diagnostic.

Exemple de requête

Définissez ADIOS_API_URL=https://api.adios.dev. Pour les requêtes protégées, définissez ADIOS_ACCESS_TOKEN et ADIOS_TEAM_ID comme dans le démarrage rapide. Définissez les autres variables ADIOS_* à partir des résultats de vos propres ressources.

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"

Réponse : HTTP 200

Réponse réussie. Inspectez l’état renvoyé pour les opérations qui démarrent un travail asynchrone.

Aucun schéma complet du corps de réponse n’est publié pour cette opération personnalisée. Inspectez le contenu renvoyé et le statut ; aucun format de données n’est présumé ici.

Obtenir le plan de la session d’agent

GET /v1/agent_session/{id}/plan

Lisez le plan actuel de la session.

Définissez agent_session_id en utilisant les ID de vos propres réponses API.

Authentification : jeton bearer et en-tête d’équipe présentés ci-dessous.

Paramètres

Nom	Emplacement	Requis	Description
id	chemin	oui	Identifiant de ressource issu des résultats API de votre équipe.
X-Tenant-ID	en-tête	oui	ID de l’équipe active. Doit correspondre au tenant lié au jeton de diagnostic.

Exemple de requête

Définissez ADIOS_API_URL=https://api.adios.dev. Pour les requêtes protégées, définissez ADIOS_ACCESS_TOKEN et ADIOS_TEAM_ID comme dans le démarrage rapide. Définissez les autres variables ADIOS_* à partir des résultats de vos propres ressources.

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"

Réponse : HTTP 200

Réponse réussie. Inspectez l’état renvoyé pour les opérations qui démarrent un travail asynchrone.

Aucun schéma complet du corps de réponse n’est publié pour cette opération personnalisée. Inspectez le contenu renvoyé et le statut ; aucun format de données n’est présumé ici.

Annuler l’exécution d’agent

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

Demander l’annulation d’une exécution active dans la session.

Définissez agent_session_id, agent_run_id en utilisant les ID de vos propres réponses API.

Cette requête modifie des données ou lance une action. Vérifiez la cible et le corps avant de l’envoyer.

Authentification : jeton bearer et en-tête d’équipe présentés ci-dessous.

Paramètres

Nom	Emplacement	Requis	Description
id	chemin	oui	Identifiant de ressource issu des résultats API de votre équipe.
run_id	chemin	oui	Identifiant de ressource issu des résultats API de votre équipe.
X-Tenant-ID	en-tête	oui	ID de l’équipe active. Doit correspondre au tenant lié au jeton de diagnostic.

Exemple de requête

Définissez ADIOS_API_URL=https://api.adios.dev. Pour les requêtes protégées, définissez ADIOS_ACCESS_TOKEN et ADIOS_TEAM_ID comme dans le démarrage rapide. Définissez les autres variables ADIOS_* à partir des résultats de vos propres ressources.

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"

Réponse : HTTP 200

Réponse réussie. Inspectez l’état renvoyé pour les opérations qui démarrent un travail asynchrone.

Aucun schéma complet du corps de réponse n’est publié pour cette opération personnalisée. Inspectez le contenu renvoyé et le statut ; aucun format de données n’est présumé ici.