APIWorkspace

List or search chats

GET /chats

GET
/chats
AuthorizationBearer <token>

ChatPRD API key from Settings → API Keys, sent as Authorization: Bearer <key>. Read-only keys carry the connector:read scope; read/write keys also carry connector:write. Requires a Pro, Team or Enterprise plan.

In: header

Scope: connector:read

Query Parameters

q?string

Search chat titles (1–200 characters).

Length1 <= length <= 200
organizationId?string

Clerk organization ID (org_…). Scopes the request to that team workspace instead of the personal workspace.

projectId?string

Project ID, as returned by GET /projects.

limit?integer

Maximum number of items to return (1–100). Defaults to 20.

Default20
Range1 <= value <= 100

Response Body

curl -X GET "https://app.chatprd.ai/api/connectors/v1/chats?q=string&organizationId=string&projectId=string&limit=20"
{
  "chats": [
    {
      "id": "497f6eca-6276-4993-bfeb-53cbbbba6f08",
      "title": "string",
      "createdAt": "2019-08-24T14:15:22Z",
      "updatedAt": "2019-08-24T14:15:22Z",
      "messageCount": 0,
      "project": {
        "id": "string",
        "name": "string"
      },
      "url": "http://example.com"
    }
  ],
  "count": 0
}
{
  "error": {
    "code": "unauthorized",
    "message": "Invalid or missing API key."
  }
}
{
  "error": {
    "code": "unauthorized",
    "message": "Invalid or missing API key."
  }
}
{
  "error": {
    "code": "unauthorized",
    "message": "Invalid or missing API key."
  }
}
{
  "error": {
    "code": "unauthorized",
    "message": "Invalid or missing API key."
  }
}
{
  "error": {
    "code": "unauthorized",
    "message": "Invalid or missing API key."
  }
}