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.
- Scope
postory:read - Limit class
READ - Success
200
Example
curl https://postory.io/api/v1/presets \
-H "Authorization: Bearer $POSTORY_API_KEY"{
"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
401No API key, or an invalid or revoked one
403The key lacks the scope, or access is paused
422A request parameter is not valid
429Rate 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.
- Scope
postory:read - Limit class
READ - Success
200
Parameters
| Name | In | Type | Description |
|---|---|---|---|
presetrequired | path | string | A preset's |
Example
curl "https://postory.io/api/v1/presets/<preset>" \
-H "Authorization: Bearer $POSTORY_API_KEY"{
"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
401No API key, or an invalid or revoked one
403The key lacks the scope, or access is paused
404Not found, or not this user's
422A request parameter is not valid
429Rate limit spent; see Retry-After