Threads

List Threads

Path Parameters

org_id*Org Id

workspace_id*Workspace Id

namespace_id*Namespace Id

Query Parameters

search?|

Search by title or description

limit?Limit

Maximum number of items to return (1-200)

Default50

Range1 <= value <= 200

cursor?|

Cursor for pagination (from previous response's next_cursor)

Header Parameters

authorization?string|null

Response Body

`application/json`

curl -X GET "https://loading/v1/orgs/string/workspaces/string/namespaces/string/threads"

{
  "total": 0,
  "has_more": false,
  "next_cursor": "string",
  "threads": [
    {
      "thread_id": "string",
      "workspace_id": "string",
      "app_id": "string",
      "namespace_id": "string",
      "name": "string",
      "source_ids": [
        "string"
      ],
      "memory_ids": [
        "string"
      ],
      "augmentation_ids": [
        "string"
      ],
      "summary": "string",
      "tags": [
        "string"
      ],
      "status": "active",
      "created_at": "string",
      "updated_at": "string"
    }
  ]
}

{
  "error": "AUTHENTICATION_FAILED",
  "message": "Authentication required",
  "details": {},
  "timestamp": "2025-01-01T00:00:00.000000",
  "status_code": 401
}

{
  "error": "FORBIDDEN",
  "message": "You don't have permission to perform this action",
  "details": {
    "required_permission": "resource:action"
  },
  "timestamp": "2025-01-01T00:00:00.000000",
  "status_code": 403
}

{
  "error": "RESOURCE_NOT_FOUND",
  "message": "The requested resource was not found",
  "details": {
    "resource_type": "example",
    "resource_id": "xxx"
  },
  "timestamp": "2025-01-01T00:00:00.000000",
  "status_code": 404
}

{
  "detail": [
    {
      "loc": [
        "string"
      ],
      "msg": "string",
      "type": "string",
      "input": null,
      "ctx": {}
    }
  ]
}

{
  "error": "INTERNAL_SERVER_ERROR",
  "message": "An unexpected error occurred",
  "details": {},
  "timestamp": "2025-01-01T00:00:00.000000",
  "status_code": 500
}

Create Thread

Path Parameters

org_id*Org Id

workspace_id*Workspace Id

namespace_id*Namespace Id

Header Parameters

authorization?string|null

Request Body

application/json

TypeScript Definitions

Use the request body type in TypeScript.

created_at?Created At

updated_at?Updated At

created_by?string|null

updated_by?string|null

pk?Pk

Default""

sk?Sk

Default""

gsi1pk?string|null

gsi1sk?string|null

gsi2pk?string|null

gsi2sk?string|null

thread_id?Thread Id

Unique identifier for the thread

workspace_id*Workspace Id

The workspace this thread belongs to

org_id?|

Organization ID

app_id*App Id

The app this thread belongs to

namespace_id*Namespace Id

The namespace this thread belongs to (partition key)

name*Name

The name of the thread

source_ids?array<string>

List of source IDs associated with the thread

memory_ids?array<string>

List of memory IDs associated with the thread

augmentation_ids?array<string>

List of augmentation IDs run in the thread context

summary?|

A brief summary of the thread

tags?array<string>

Tags associated with the thread

status?ThreadStatus

The status of the thread (e.g., active, archived, ephemeral)

Default"active"

Value in"active" | "archived" | "ephemeral"

Response Body

`application/json`

curl -X POST "https://loading/v1/orgs/string/workspaces/string/namespaces/string/threads" \  -H "Content-Type: application/json" \  -d '{    "workspace_id": "string",    "app_id": "string",    "namespace_id": "string",    "name": "string"  }'

{
  "message": "string",
  "thread": {
    "thread_id": "string",
    "workspace_id": "string",
    "app_id": "string",
    "namespace_id": "string",
    "name": "string",
    "source_ids": [
      "string"
    ],
    "memory_ids": [
      "string"
    ],
    "augmentation_ids": [
      "string"
    ],
    "summary": "string",
    "tags": [
      "string"
    ],
    "status": "active",
    "created_at": "string",
    "updated_at": "string"
  }
}

{
  "error": "AUTHENTICATION_FAILED",
  "message": "Authentication required",
  "details": {},
  "timestamp": "2025-01-01T00:00:00.000000",
  "status_code": 401
}

{
  "error": "FORBIDDEN",
  "message": "You don't have permission to perform this action",
  "details": {
    "required_permission": "resource:action"
  },
  "timestamp": "2025-01-01T00:00:00.000000",
  "status_code": 403
}

{
  "error": "RESOURCE_NOT_FOUND",
  "message": "The requested resource was not found",
  "details": {
    "resource_type": "example",
    "resource_id": "xxx"
  },
  "timestamp": "2025-01-01T00:00:00.000000",
  "status_code": 404
}

{
  "detail": [
    {
      "loc": [
        "string"
      ],
      "msg": "string",
      "type": "string",
      "input": null,
      "ctx": {}
    }
  ]
}

{
  "error": "INTERNAL_SERVER_ERROR",
  "message": "An unexpected error occurred",
  "details": {},
  "timestamp": "2025-01-01T00:00:00.000000",
  "status_code": 500
}

Get Thread

Path Parameters

org_id*Org Id

workspace_id*Workspace Id

namespace_id*Namespace Id

thread_id*Thread Id

Header Parameters

authorization?string|null

Response Body

`application/json`

curl -X GET "https://loading/v1/orgs/string/workspaces/string/namespaces/string/threads/string"

{
  "thread_id": "string",
  "workspace_id": "string",
  "app_id": "string",
  "namespace_id": "string",
  "name": "string",
  "source_ids": [
    "string"
  ],
  "memory_ids": [
    "string"
  ],
  "augmentation_ids": [
    "string"
  ],
  "summary": "string",
  "tags": [
    "string"
  ],
  "status": "active",
  "created_at": "string",
  "updated_at": "string"
}

{
  "error": "AUTHENTICATION_FAILED",
  "message": "Authentication required",
  "details": {},
  "timestamp": "2025-01-01T00:00:00.000000",
  "status_code": 401
}

{
  "error": "FORBIDDEN",
  "message": "You don't have permission to perform this action",
  "details": {
    "required_permission": "resource:action"
  },
  "timestamp": "2025-01-01T00:00:00.000000",
  "status_code": 403
}

{
  "error": "RESOURCE_NOT_FOUND",
  "message": "The requested resource was not found",
  "details": {
    "resource_type": "example",
    "resource_id": "xxx"
  },
  "timestamp": "2025-01-01T00:00:00.000000",
  "status_code": 404
}

{
  "detail": [
    {
      "loc": [
        "string"
      ],
      "msg": "string",
      "type": "string",
      "input": null,
      "ctx": {}
    }
  ]
}

{
  "error": "INTERNAL_SERVER_ERROR",
  "message": "An unexpected error occurred",
  "details": {},
  "timestamp": "2025-01-01T00:00:00.000000",
  "status_code": 500
}

Delete Thread

Path Parameters

org_id*Org Id

workspace_id*Workspace Id

namespace_id*Namespace Id

thread_id*Thread Id

Header Parameters

authorization?string|null

Response Body

`application/json`

curl -X DELETE "https://loading/v1/orgs/string/workspaces/string/namespaces/string/threads/string"

{
  "message": "string"
}

{
  "error": "AUTHENTICATION_FAILED",
  "message": "Authentication required",
  "details": {},
  "timestamp": "2025-01-01T00:00:00.000000",
  "status_code": 401
}

{
  "error": "FORBIDDEN",
  "message": "You don't have permission to perform this action",
  "details": {
    "required_permission": "resource:action"
  },
  "timestamp": "2025-01-01T00:00:00.000000",
  "status_code": 403
}

{
  "error": "RESOURCE_NOT_FOUND",
  "message": "The requested resource was not found",
  "details": {
    "resource_type": "example",
    "resource_id": "xxx"
  },
  "timestamp": "2025-01-01T00:00:00.000000",
  "status_code": 404
}

{
  "detail": [
    {
      "loc": [
        "string"
      ],
      "msg": "string",
      "type": "string",
      "input": null,
      "ctx": {}
    }
  ]
}

{
  "error": "INTERNAL_SERVER_ERROR",
  "message": "An unexpected error occurred",
  "details": {},
  "timestamp": "2025-01-01T00:00:00.000000",
  "status_code": 500
}

Update Thread

Path Parameters

org_id*Org Id

workspace_id*Workspace Id

namespace_id*Namespace Id

thread_id*Thread Id

Header Parameters

authorization?string|null

Request Body

application/json

TypeScript Definitions

Use the request body type in TypeScript.

[key: string]?any

Response Body

`application/json`

curl -X PUT "https://loading/v1/orgs/string/workspaces/string/namespaces/string/threads/string" \  -H "Content-Type: application/json" \  -d '{}'

{
  "message": "string",
  "thread": {
    "thread_id": "string",
    "workspace_id": "string",
    "app_id": "string",
    "namespace_id": "string",
    "name": "string",
    "source_ids": [
      "string"
    ],
    "memory_ids": [
      "string"
    ],
    "augmentation_ids": [
      "string"
    ],
    "summary": "string",
    "tags": [
      "string"
    ],
    "status": "active",
    "created_at": "string",
    "updated_at": "string"
  }
}

{
  "error": "AUTHENTICATION_FAILED",
  "message": "Authentication required",
  "details": {},
  "timestamp": "2025-01-01T00:00:00.000000",
  "status_code": 401
}

{
  "error": "FORBIDDEN",
  "message": "You don't have permission to perform this action",
  "details": {
    "required_permission": "resource:action"
  },
  "timestamp": "2025-01-01T00:00:00.000000",
  "status_code": 403
}

{
  "error": "RESOURCE_NOT_FOUND",
  "message": "The requested resource was not found",
  "details": {
    "resource_type": "example",
    "resource_id": "xxx"
  },
  "timestamp": "2025-01-01T00:00:00.000000",
  "status_code": 404
}

{
  "detail": [
    {
      "loc": [
        "string"
      ],
      "msg": "string",
      "type": "string",
      "input": null,
      "ctx": {}
    }
  ]
}

{
  "error": "INTERNAL_SERVER_ERROR",
  "message": "An unexpected error occurred",
  "details": {},
  "timestamp": "2025-01-01T00:00:00.000000",
  "status_code": 500
}

Stream Thread

Path Parameters

org_id*Org Id

workspace_id*Workspace Id

namespace_id*Namespace Id

thread_id*Thread Id

Header Parameters

authorization?string|null

Response Body

`application/json`

curl -X GET "https://loading/v1/orgs/string/workspaces/string/namespaces/string/threads/string/stream"

null

{
  "error": "AUTHENTICATION_FAILED",
  "message": "Authentication required",
  "details": {},
  "timestamp": "2025-01-01T00:00:00.000000",
  "status_code": 401
}

{
  "error": "FORBIDDEN",
  "message": "You don't have permission to perform this action",
  "details": {
    "required_permission": "resource:action"
  },
  "timestamp": "2025-01-01T00:00:00.000000",
  "status_code": 403
}

{
  "error": "RESOURCE_NOT_FOUND",
  "message": "The requested resource was not found",
  "details": {
    "resource_type": "example",
    "resource_id": "xxx"
  },
  "timestamp": "2025-01-01T00:00:00.000000",
  "status_code": 404
}

{
  "detail": [
    {
      "loc": [
        "string"
      ],
      "msg": "string",
      "type": "string",
      "input": null,
      "ctx": {}
    }
  ]
}

{
  "error": "INTERNAL_SERVER_ERROR",
  "message": "An unexpected error occurred",
  "details": {},
  "timestamp": "2025-01-01T00:00:00.000000",
  "status_code": 500
}

Get Active Executions For Thread

Path Parameters

org_id*Org Id

workspace_id*Workspace Id

namespace_id*Namespace Id

thread_id*Thread Id

Header Parameters

authorization?string|null

Response Body

`application/json`

curl -X GET "https://loading/v1/orgs/string/workspaces/string/namespaces/string/threads/string/active-executions"

null

{
  "error": "AUTHENTICATION_FAILED",
  "message": "Authentication required",
  "details": {},
  "timestamp": "2025-01-01T00:00:00.000000",
  "status_code": 401
}

{
  "error": "FORBIDDEN",
  "message": "You don't have permission to perform this action",
  "details": {
    "required_permission": "resource:action"
  },
  "timestamp": "2025-01-01T00:00:00.000000",
  "status_code": 403
}

{
  "error": "RESOURCE_NOT_FOUND",
  "message": "The requested resource was not found",
  "details": {
    "resource_type": "example",
    "resource_id": "xxx"
  },
  "timestamp": "2025-01-01T00:00:00.000000",
  "status_code": 404
}

{
  "detail": [
    {
      "loc": [
        "string"
      ],
      "msg": "string",
      "type": "string",
      "input": null,
      "ctx": {}
    }
  ]
}

{
  "error": "INTERNAL_SERVER_ERROR",
  "message": "An unexpected error occurred",
  "details": {},
  "timestamp": "2025-01-01T00:00:00.000000",
  "status_code": 500
}

200application/json

401application/json

403application/json

404application/json

422application/json

500application/json

200application/json

401application/json

403application/json

404application/json

422application/json

500application/json

200application/json

401application/json

403application/json

404application/json

422application/json

500application/json

200application/json

401application/json

403application/json

404application/json

422application/json

500application/json

200application/json

401application/json

403application/json

404application/json

422application/json

500application/json

200application/json

401application/json

403application/json

404application/json

422application/json

500application/json

200application/json

401application/json

403application/json

404application/json

422application/json

500application/json

`application/json`

`application/json`

`application/json`

`application/json`

`application/json`

`application/json`

`application/json`

`application/json`

`application/json`

`application/json`

`application/json`

`application/json`

`application/json`

`application/json`

`application/json`

`application/json`

`application/json`

`application/json`

`application/json`

`application/json`

`application/json`

`application/json`

`application/json`

`application/json`

`application/json`

`application/json`

`application/json`

`application/json`

`application/json`

`application/json`

`application/json`

`application/json`

`application/json`

`application/json`

`application/json`

`application/json`

`application/json`

`application/json`

`application/json`

`application/json`

`application/json`

`application/json`