Signal that a session has ended. Triggers a final memory extraction cycle for any unprocessed messages in the session.
URI: /api/v1/agentic/conversations/{conversationId}/sessions/{sessionId}/close
HTTP Method: POST
Authentication: Bearer JWT
Path Parameters
| Parameter | Required | Description |
|---|---|---|
| conversationId | Yes | Conversation identifier. |
| sessionId | Yes | Session identifier. |
Request Headers
| Header | Required | Description |
|---|---|---|
| Authorization | Yes | Bearer JWT token. |
| agent_id | Yes | Registered agent API name. |
Request Body
No request body required.
Response Body Schema
| Field | Type | Description |
|---|---|---|
| statusCode | String | Operation status. Value: closed. |
| conversationId | String | Parent conversation identifier. |
| sessionId | String | The closed session identifier. |
Example Response
Status: 202 Accepted
{
"statusCode": "closed",
"conversationId": "<conversationId>",
"sessionId": "<sessionId>"
}
Error Codes
| Status Code | Description |
|---|---|
| 401 | Unauthorized. Invalid or missing JWT token. |
| 404 | Not Found. Conversation or session does not exist. |
| 500 | Internal Server Error. |