Sessions
Sessions
Short-lived tokens used to authenticate client-side operations.
Sessions contain short-lived tokens used to authenticate client-side operations such as streaming, chat completions, and agent tasks. Create a session on your server using your secret key, then pass the returned clientToken to your client.
POST /v1/sessions is one endpoint. Each creatable session type has its own operation page:
- Create stream session
- Create streaming chat completion session
- Create structured chat completion session
- Create memory chat session
- Create memory search session
- Create explore memories session
- Create explore product session
- Create agent task file download session
- Create get agent task response session
- Create submit manual action result session
The session object
| Attribute | Type | Description |
|---|---|---|
id | string | The unique identifier for the session. |
createdAt | string | When the session was created. |
type | string | CREATE_STREAM, CREATE_AGENT_TASK, CREATE_AGENT_TASK_FILE_DOWNLOAD, GET_AGENT_TASK_RESPONSE, or SUBMIT_MANUAL_ACTION_RESULT. |
clientToken | string | A short-lived token used to authenticate client-side operations. Pass this to your client; it should never be stored or logged. |