Publications

List publications

GET
/publications
AuthorizationBearer <token>

Organization API key from the console (ak_...), or an OAuth access token with user:org:read, the organization selected during consent, and the capability required by the operation.

In: header

Query Parameters

limit?integer

Maximum number of resources to return. Omit for 20; otherwise supply base-10 digits representing an integer from 1 to 100. Empty, malformed, or out-of-range values return 400 invalid_request. List query parameters must appear only once; unrecognized parameters also return 400.

Range1 <= value <= 100
Default20
cursor?string

Opaque cursor from the preceding page's next_cursor. Valid only for the same organization, operation, filters, and ordering that issued it. Omit to start at the first page. Empty, malformed, or repeated cursors return 400 invalid_request. The page limit may change between requests.

Match^[A-Za-z0-9_-]+$
Length1 <= length <= 2048
release_id?string

Only publications of this release.

Match^rel_[a-z0-9]{16}$

Response Body

application/json

application/json

application/json

application/json

application/json

application/json

application/json

curl -X GET "https://example.com/publications"
{  "object": "list",  "data": [    {      "id": "pub_2m8q4v7k1p9d5h6c",      "object": "publication",      "release_id": "rel_7m2q8v4k1p9d5h6c",      "destination": "npm",      "status": "pending",      "attempt": 0,      "run_url": null,      "registry_url": null,      "artifact_digest": null,      "errors": [],      "started_at": null,      "finished_at": null,      "runtime_ms": null,      "created_at": "2026-09-23T08:00:00Z",      "updated_at": "2026-09-23T08:00:00Z"    }  ],  "has_more": false,  "next_cursor": null,  "request_id": "req_3k8m1v6q9p2d7h4c"}