Close Session

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 

ParameterRequiredDescription
conversationIdYesConversation identifier.
sessionIdYesSession identifier.

Request Headers 

HeaderRequiredDescription
AuthorizationYesBearer JWT token.
agent_idYesRegistered agent API name.

Request Body 

No request body required.

Response Body Schema 

FieldTypeDescription
statusCodeStringOperation status. Value: closed.
conversationIdStringParent conversation identifier.
sessionIdStringThe closed session identifier.

Example Response 

Status: 202 Accepted

1{
2  "statusCode": "closed",
3  "conversationId": "<conversationId>",
4  "sessionId": "<sessionId>"
5}

Error Codes 

Status CodeDescription
401Unauthorized. Invalid or missing JWT token.
404Not Found. Conversation or session does not exist.
500Internal Server Error.