Skip to main content
GET
ListThreadsAPI mirrors the erdo_list_threads MCP tool as a REST endpoint.

Authorizations

Authorization
string
header
required

An Erdo API key (erdo_api_...) or scoped token (erdo_token_...).

Query Parameters

limit
integer<int32>
Required range: -2147483648 <= x <= 2147483647
offset
integer<int32>
Required range: -2147483648 <= x <= 2147483647
scope
string

Scope selects which threads to list: "own" (default) returns threads you created; "org" returns every thread in your organization (requires org membership — unavailable to B2B2C scoped tokens); "shared" returns threads shared with you, excluding your own (also requires org membership).

order_by
string

OrderBy only applies to scope=org/shared.

include_automation
boolean

IncludeAutomation only applies to scope=org/shared.

Response

Success response

threads
MCPThread is a clean representation of a thread for MCP/REST consumers. · object[]
total
integer<int64>