ParagraphDocs
Open the app
GuidesDevelopers

List content groups

GET
/v1/buckets

Retrieve the content groups in your publication, most recently active first. The publication is identified by the API key.

A group ("bucket") is one identity for a post and everything made out of it — the post, the X thread drawn from it, the LinkedIn version, the newsletter. It's what the writer sees as a single stacked row under Content.

Each group lists its members in display order, with the post it was seeded from first. Bodies aren't included; fetch the member with GET /v1/content/{id} or GET /v1/posts/{id} to read one.

Authorization

apiKey
headerAuthorizationBearer <token>

API key for authenticating protected endpoints. Pass as Bearer token in Authorization header.

Query Parameters

cursor?string

Cursor for pagination

limit?integer

Maximum number of items to return (1-50, default: 20)

Range1 <= value <= 50
Default20

Response Body

Content groups retrieved successfully

application/json
  1. response
items*array<>

Array of items in this page

pagination*
curl -X GET "https://example.com/v1/buckets"
{  "items": [    {      "id": "string",      "title": "string",      "createdAt": "string",      "updatedAt": "string",      "members": [        {          "kind": "post",          "id": "string",          "channel": "string",          "title": "string",          "status": "draft",          "scheduled": true,          "url": "string",          "publishedAt": "string",          "archivedAt": "string",          "position": 0,          "updatedAt": "string"        }      ]    }  ],  "pagination": {    "cursor": "string",    "hasMore": true,    "total": 0  }}

Restore an archived piece POST

Bring an archived piece back into your library. Suggestions dismissed when it was archived stay dismissed — you get the draft back, not the to-do items telling you to ship it.

Get a content group GET

Retrieve one content group with its members. Read it before adding to it, so you don't draft a version that already exists.