List Stores | SpeechifyAI API

List the stores in the caller’s workspace, most recently updated first. A store is the durable document + asset store a durable run writes to (through its store tools) and a hosted-API route serves. Cursor-paginated; walk pages while has_more is true. Dark launch: requires the hosted_apis_access entitlement (402 hosted_apis_not_in_plan otherwise).

Authentication

AuthorizationBearer

Enter your API key with the Bearer prefix, e.g. ‘Bearer sk_…’.

Query parameters

cursorstringOptional

Opaque pagination cursor from a previous response.

limitintegerOptional1-200Defaults to 50

Max items per page (default 50, max 200).

project_idstringOptional

Filter by workspace project: omit for every project you can reach, pass the literal default for resources in the implicit Default project only, or a proj_... id for that project’s resources. Returns 404 project_not_found for a malformed id and for any filter outside your reach: a project-pinned API key or service-account key reaches only its pinned project, and a member holding project grants reaches only the granted projects, so neither can name default. That 404 is the same in every case and does not reveal whether such a project exists - outside your reach a project is answered as nonexistent, never as forbidden. Inside it, a well-formed id that matches no project yields an empty page.

Filter by workspace project: omit for every project you can reach, pass the literal `default` for resources in the implicit Default project only, or a `proj_...` id for that project's resources. Returns 404 project_not_found for a malformed id and for any filter outside your reach: a project-pinned API key or service-account key reaches only its pinned project, and a member holding project grants reaches only the granted projects, so neither can name `default`. That 404 is the same in every case and does not reveal whether such a project exists - outside your reach a project is answered as nonexistent, never as forbidden. Inside it, a well-formed id that matches no project yields an empty page.

Response headers

Speechify-Request-IdstringOptional

Unique identifier for this request, present on every response (2xx and non-2xx alike). If the caller sends a Speechify-Request-Id request header the server echoes it back (sanitized and length-capped) so one logical request can be traced end-to-end; otherwise the server generates a fresh value. Log it on every response and quote it in support requests

it is the stable handle that ties your observation to Speechify’s server-side logs, and it matches the request_id field in the error envelope.

The legacy alias X-Request-ID carries the same value and is still accepted on requests, until 2027-07-24. Prefer the un-prefixed name (RFC 6648).

Unique identifier for this request, present on every response (2xx and non-2xx alike). If the caller sends a `Speechify-Request-Id` request header the server echoes it back (sanitized and length-capped) so one logical request can be traced end-to-end; otherwise the server generates a fresh value. Log it on every response and quote it in support requests - it is the stable handle that ties your observation to Speechify's server-side logs, and it matches the `request_id` field in the error envelope. The legacy alias `X-Request-ID` carries the same value and is still accepted on requests, until 2027-07-24. Prefer the un-prefixed name (RFC 6648).

Response

next_cursorstring or null

Opaque keyset cursor for the next page. Pass back as the cursor request parameter. null when the caller has reached the end of the list (has_more is also false in that case).

has_moreboolean

True when more rows exist beyond this page.

storeslist of objects

Errors

400

Bad Request Error

401

Unauthorized Error

402

Payment Required Error

404

Not Found Error

1	{
2	"next_cursor": "string",
3	"has_more": true,
4	"stores": [
5	{
6	"id": "store_01jqr8x9zg5k2m3n4p5q6r7s8t",
7	"name": "news",
8	"description": "string",
9	"project_id": "string",
10	"created_at": "2024-01-15T09:30:00Z",
11	"used_bytes": 1,
12	"updated_at": "2024-01-15T09:30:00Z"
13	}
14	]
15	}