List conversations for the calling user against this agent.

{ "success": true, "data": { "conversations": [ { "conversation_id": "<string>", "agent_id": "<string>", "title": "<string>", "metadata": {}, "created_at": "2023-11-07T05:31:56Z", "closed_at": "2023-11-07T05:31:56Z" } ], "next_since": "<string>" } }

Authorizations

Authorization

string

header

required

Pass a user JWT or a oag_ User API Key on the Authorization: Bearer <token> header. Both are validated by openapi-gateway against the Auth service.

Both credential types are user-scoped: every key (and every JWT) is bound to exactly one owner, and every route grants the caller full access to that owner's own resources. Cross-tenant access is denied by owner-ACL inside the handlers — there is no per-route scope vocabulary on this API.

Removed in v1.1.0: the legacy agents:* / tasks:* / files:* / instances:* scope set has been dropped together with the 403 insufficient_scope error. Existing oag_ keys automatically gain full owner-level access and do not need to be re-issued. SDK calls that previously passed scopes to createAPIKey should drop the argument. See the changelog at the bottom of this spec for the full migration note.

Path Parameters

agentId

string

required

Maximum string length: 128

Query Parameters

state

enum<string>

default:active

Filter by conversation state. active is a backward-compat wire alias for v2's open — both return non-closed conversations. all returns both open and closed. Default: active.

Available options:

active,

open,

closed,

all

since

string

Pagination cursor returned by the previous call (next_since).

limit

integer<int32>

Required range: 1 <= x <= 100

Response

Paged list of conversations.

success

boolean

required

data

object

required

Show child attributes