Manage conversation threads for agent session state and user data.
https://catalyst-usw.agentuity.cloudAuthentication
All requests require a Bearer token. Pass your SDK key in the Authorization header.
| Header | Value |
|---|---|
Authorization | Bearer YOUR_SDK_KEY |
You can find your SDK key in the Agentuity Console under your project settings.
List Threads
List conversation threads with optional filtering and pagination.
GET
/threadhttps://catalyst-usw.agentuity.cloud/threadParameters
query
| Name | Type | Required | Description |
|---|---|---|---|
limit | number | No | Max results, default 10 |
offset | number | No | Pagination offset |
sort | string | No | 'created' or 'updated' |
direction | string | No | 'asc' or 'desc' |
orgId | string | No | Filter by org |
projectId | string | No | Filter by project |
metadata | string | No | JSON-serialized metadata filter |
Response
Array of thread objects.
| Status | Description |
|---|---|
| 200 | Threads returned |
| 401 | Unauthorized — invalid or missing Bearer token |
Response Fields
| Field | Type | Description |
|---|---|---|
id | string | the thread id |
created_at | string | the creation timestamp |
updated_at | string | the last update timestamp |
deleted | boolean | whether the thread is deleted |
deleted_at | string | null | the deletion timestamp |
deleted_by | string | null | who deleted the thread |
org_id | string | the organization id |
project_id | string | the project id |
user_data | string | null | the user data as JSON (optional) |
metadata | object | null | unencrypted key-value metadata (optional) |
Example
curl -X GET 'https://catalyst-usw.agentuity.cloud/thread?limit=10&sort=updated&direction=desc' \
-H 'Authorization: Bearer $AGENTUITY_SDK_KEY'Get Thread
Get a specific thread by ID.
GET
/thread/{id}https://catalyst-usw.agentuity.cloud/thread/{id}Parameters
path
| Name | Type | Required | Description |
|---|---|---|---|
id | string | Yes | Thread ID |
Response
Thread object.
| Status | Description |
|---|---|
| 200 | Thread returned |
| 401 | Unauthorized — invalid or missing Bearer token |
| 404 | Thread not found |
Example
curl -X GET 'https://catalyst-usw.agentuity.cloud/thread/thr_abc123' \
-H 'Authorization: Bearer $AGENTUITY_SDK_KEY'Delete Thread
Delete a specific thread by ID.
DELETE
/thread/{id}https://catalyst-usw.agentuity.cloud/thread/{id}Parameters
path
| Name | Type | Required | Description |
|---|---|---|---|
id | string | Yes | Thread ID |
Response
Empty response on success.
| Status | Description |
|---|---|
| 204 | Thread deleted |
| 401 | Unauthorized — invalid or missing Bearer token |
| 404 | Thread not found |
Example
curl -X DELETE 'https://catalyst-usw.agentuity.cloud/thread/thr_abc123' \
-H 'Authorization: Bearer $AGENTUITY_SDK_KEY'