Get a piece of content
Retrieve one piece of drafted content with its body. Read it before editing so you rewrite what's actually saved — the draft may have changed in the app.
apiKeyAuthorizationBearer <token>API key for authenticating protected endpoints. Pass as Bearer token in Authorization header.
contentId*stringUnique identifier of the content
Content retrieved successfully
application/json- response
id*stringUnique identifier for this piece of content
kind*stringWhat this piece is: tweet, linkedin, newsletter, or x_article
title*stringWhat this piece is called in your library
excerpt*stringFirst readable line of the body, for listing views
status*stringWhether this piece has been delivered, is still a draft, or was archived
"draft""published""archived"scheduled*booleanWhether a scheduled send is queued against this piece
lockedReason*|Why this piece can't be edited right now, or null when it can. A queued or in-flight send locks the words, because they go out exactly as written.
publishedAt*|ISO 8601 timestamp of the first delivery, or null
url*|Where this piece went live, from the same delivery publishedAt came from. Null when it hasn't been delivered, and null by design for a channel that publishes no page: a custom email renders into the message itself, so there is no address to link to. Never guessed — a delivery whose id isn't shaped like its channel reports null rather than a link that would 404.
archivedAt*|ISO 8601 timestamp of when this piece was archived, or null
bucketId*|The bucket grouping this piece with the post it was made from, or null when it stands alone. Read it back with GET /v1/buckets/{bucketId}.
createdAt*stringISO 8601 timestamp of creation
updatedAt*stringISO 8601 timestamp of the last change
body*The artifact itself, in the shape its kind uses
curl -X GET "https://example.com/v1/content/string"{ "id": "string", "kind": "string", "title": "string", "excerpt": "string", "status": "draft", "scheduled": true, "lockedReason": "string", "publishedAt": "string", "url": "string", "archivedAt": "string", "bucketId": "string", "createdAt": "string", "updatedAt": "string", "body": { "property1": null, "property2": null }}Create a draft POST
Save a finished piece of short-form content — an X post or thread, a LinkedIn post, a one-off email, or an X Article — to your publication's library. **What this does:** - The piece is saved as a draft and shows up in the Paragraph app under Content, where you can edit it and send it. - Nothing is posted, emailed, or scheduled. Sending happens in the app, so a draft you upload can't go out without you. - Long-form Paragraph posts are a different resource — use `POST /v1/posts` for those. **The body:** - `body` carries the artifact itself, in the shape its kind uses (see the field descriptions below). - It's validated the same way the Paragraph app validates it, so an X thread over 280 characters an entry, or an Article missing its headline, comes back with the same explanation you'd see in the app. - Drafts created here are text-only. Media has to be uploaded to X or LinkedIn first, which the API can't do yet. **Grouping:** - Pass `bucketId` to group this piece with the post it was made from, so the writer sees them together as one row under Content. Get the id with `POST /v1/posts/{postId}/bucket`. - Unknown fields are rejected rather than ignored, so a misspelled key comes back as a 400 instead of a draft that quietly isn't grouped.
Edit a piece of content PATCH
Rename a piece of content, replace its body, or both. **Replacement, not a merge:** `body` replaces the artifact entirely, in the same shape the kind takes on create. Send the whole thing, not just the part that changed. Media already attached to the draft is the one exception — you can't send it back, so it's carried over rather than dropped. **Scheduled pieces are locked:** if a send is queued or already running for this piece, its words go out exactly as written, so an edit to `body` is refused with an explanation. Cancel the schedule in the app first. Renaming is always allowed — a title isn't published anywhere. **Grouping:** `bucketId` files this piece with the post it was made from. A piece already grouped somewhere else is refused with a 409 rather than moved — ungroup it in the app first.