putty
API ReferenceArtifacts

List your posts and scheduled queue

Returns the caller's posts, newest first: drafts awaiting approval, the scheduled queue, and posts already published or failed. Each entry carries the per-platform text the Publish page previews, the putty asset ids, and an `approveUrl` for a draft.

GET
/social/posts

Returns the caller's posts, newest first: drafts awaiting approval, the scheduled queue, and posts already published or failed. Each entry carries the per-platform text the Publish page previews, the putty asset ids, and an approveUrl for a draft.

Authorization

bearerAuth
AuthorizationBearer <token>

A bearer token. The Account routes accept a Privy access token; the MCP transport accepts an sk- API key issued by POST /account/api-keys.

In: header

Query Parameters

status?string

Narrow the list to one status. Omit it for every status, which is what the Publish page's queue and calendar render.

Value in

  • "draft"
  • "approved"
  • "scheduled"
  • "published"
  • "partial"
  • "failed"
  • "cancelled"

Response Body

application/json

application/json

application/json

application/json

curl -X GET "https://example.com/social/posts"
{  "posts": [    {      "id": "string",      "projectId": "string",      "platforms": [        {          "accountId": "string",          "platform": "string",          "text": "string"        }      ],      "assetIds": [        "string"      ],      "scheduledFor": "string",      "status": "draft",      "zernioPostId": "string",      "lastError": "string",      "approveUrl": "string",      "createdAt": "string",      "updatedAt": "string"    }  ]}

Disconnect a social account DELETE

Disconnects one account in the caller's own Zernio account and drops it from the stored list. An account that is not on the caller's profile answers the same 404 as one that does not exist. Zernio keeps its own record of the disconnect and bills the freed slot accordingly.

Create a post draft POST

Creates a `PublishRequest` in the `draft` state. **This route never calls Zernio.** The dashboard renders a preview per platform from `platforms` and shows the `approveUrl`; only a click on that link — `POST /social/posts/{id}/approve` — reaches Zernio's create-post. Pass `scheduledFor` to schedule, or omit it to publish as soon as the user approves. Media go to Zernio as short-lived signed Garage URLs minted at approval time, so the asset ids here are putty-internal and never leave putty as a path.