Docs menuPresets

Presets

GET /api/v1/presets

Every preset of the user (up to 20, in their order): a posting setup saved in Postory Settings → Presets. Each has its accounts (with connection_id and label, as GET /accounts; [] when none is still connected) and connection_ids, format (post_type, max_chars, thread), languages, model, and instructions — the user's own writing instructions for posts with it, in full. A field the preset leaves unset is null or empty. No presets: presets: [] and presets_url. Free.

  • Scopepostory:read
  • Limit classREAD
  • Success200

Example

Request
curl https://postory.io/api/v1/presets \
  -H "Authorization: Bearer $POSTORY_API_KEY"
Response 200
{
  "presets": [
    {
      "id": "<preset_id>",
      "name": "Launch thread",
      "accounts": [
        {
          "connection_id": "<connection_id>",
          "platform": "x",
          "handle": "yourhandle",
          "label": "@yourhandle · X",
          "can_publish": true,
          "suspended": false,
          "needs_reconnect": false
        },
        {
          "connection_id": "<connection_id>",
          "platform": "bluesky",
          "handle": "yourhandle.bsky.social",
          "label": "@yourhandle.bsky.social · Bluesky",
          "can_publish": true,
          "suspended": false,
          "needs_reconnect": false
        }
      ],
      "connection_ids": ["<connection_id>", "<connection_id>"],
      "format": {
        "post_type": "Thread",
        "max_chars": 280,
        "thread": true
      },
      "languages": ["English"],
      "model": "Claude Sonnet 5.5",
      "instructions": "Write in a calm, practical tone. No hashtags. End every post with: — The team"
    }
  ],
  "count": 1,
  "presets_url": "https://postory.io/settings/presets",
  "acting_as": {"postory": "[email protected]", "plan": "free"}
}

Other responses

401

No API key, or an invalid or revoked one

403

The key lacks the scope, or access is paused

422

A request parameter is not valid

429

Rate limit spent; see Retry-After

GET /api/v1/presets/{preset}

One preset, by its id from GET /presets (its exact name, in any case, works too): the same fields as there. 404 not_found lists the user's presets (id, name); a name two presets share is 422 preset_ambiguous with theirs. Free.

  • Scopepostory:read
  • Limit classREAD
  • Success200

Parameters

NameInTypeDescription
presetrequiredpathstring

A preset's id from GET /presets, or its exact name (any case).

Up to 100 characters

Example

Request
curl "https://postory.io/api/v1/presets/<preset>" \
  -H "Authorization: Bearer $POSTORY_API_KEY"
Response 200
{
  "preset": {
    "id": "<preset_id>",
    "name": "Launch thread",
    "accounts": [
      {
        "connection_id": "<connection_id>",
        "platform": "x",
        "handle": "yourhandle",
        "label": "@yourhandle · X",
        "can_publish": true,
        "suspended": false,
        "needs_reconnect": false
      },
      {
        "connection_id": "<connection_id>",
        "platform": "bluesky",
        "handle": "yourhandle.bsky.social",
        "label": "@yourhandle.bsky.social · Bluesky",
        "can_publish": true,
        "suspended": false,
        "needs_reconnect": false
      }
    ],
    "connection_ids": ["<connection_id>", "<connection_id>"],
    "format": {"post_type": "Thread", "max_chars": 280, "thread": true},
    "languages": ["English"],
    "model": "Claude Sonnet 5.5",
    "instructions": "Write in a calm, practical tone. No hashtags. End every post with: — The team"
  },
  "presets_url": "https://postory.io/settings/presets",
  "acting_as": {"postory": "[email protected]", "plan": "free"}
}

Other responses

401

No API key, or an invalid or revoked one

403

The key lacks the scope, or access is paused

404

Not found, or not this user's

422

A request parameter is not valid

429

Rate limit spent; see Retry-After