Skills
GET /api/v1/skills
Every skill of the user, in their order (a new user starts with Postory's six): id, slug, name, kind, auto_apply, description and instructions in full — to apply one to a text, follow its instructions. Free.
- Scope
postory:read - Limit class
READ - Success
200
Example
curl https://postory.io/api/v1/skills \
-H "Authorization: Bearer $POSTORY_API_KEY"{
"skills": [
{
"id": "<skill_id>",
"slug": "launch-voice",
"name": "Launch voice",
"kind": "general",
"auto_apply": true,
"description": "Use when the request is a product launch post.",
"instructions": "Lead with the date and what ships. One short sentence per line. No hashtags."
}
],
"count": 1,
"limit": 50,
"skills_url": "https://postory.io/settings/skills",
"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
POST /api/v1/skills
Create a skill (50 at most: 409 conflict with limit; a slug the user already has: 409 conflict with slug). Idempotency-Key replays the first answer for 24 hours, so a retry makes no second skill.
- Scope
postory:drafts - Limit class
WRITE - Success
201
Parameters
| Name | In | Type | Description |
|---|---|---|---|
Idempotency-Key | header | string | Any unique string (1-255 characters). The first answer for this key is replayed for 24 hours ( |
Request body
| Field | Type | Description |
|---|---|---|
auto_apply | boolean | Postory's own chat applies it on its own when the description fits (default |
descriptionrequired | string | When it applies: Postory's own chat applies an |
instructionsrequired | string | The instructions themselves. Up to 8000 characters |
kind | "general" | "image" |
|
namerequired | string | What the user calls it. Up to 80 characters |
slug | string | Kebab-case ( |
Example
curl https://postory.io/api/v1/skills \
-H "Authorization: Bearer $POSTORY_API_KEY" \
-H "Idempotency-Key: <unique-key>" \
-H "Content-Type: application/json" \
-d '{
"description": "<description>",
"instructions": "<instructions>",
"name": "<name>"
}'{
"skill": {
"id": "<skill_id>",
"slug": "launch-voice",
"name": "Launch voice",
"kind": "general",
"auto_apply": true,
"description": "Use when the request is a product launch post.",
"instructions": "Lead with the date and what ships. One short sentence per line. No hashtags."
},
"created": true,
"skills_url": "https://postory.io/settings/skills",
"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
409The state does not allow it now (already scheduled, changed, needs a choice…); branch on
code422A request parameter is not valid
429Rate limit spent; see Retry-After
GET /api/v1/skills/{skill}
One skill by its id or slug, with the same fields. 404 not_found lists the user's skills (id, slug, name). Free.
- Scope
postory:read - Limit class
READ - Success
200
Parameters
| Name | In | Type | Description |
|---|---|---|---|
skillrequired | path | string | A skill's |
Example
curl "https://postory.io/api/v1/skills/<skill>" \
-H "Authorization: Bearer $POSTORY_API_KEY"{
"skill": {
"id": "<skill_id>",
"slug": "launch-voice",
"name": "Launch voice",
"kind": "general",
"auto_apply": true,
"description": "Use when the request is a product launch post.",
"instructions": "Lead with the date and what ships. One short sentence per line. No hashtags."
},
"skills_url": "https://postory.io/settings/skills",
"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
PATCH /api/v1/skills/{skill}
Change a skill's name, slug, description, instructions, kind or auto_apply; only what is sent changes.
- Scope
postory:drafts - Limit class
WRITE - Success
200
Parameters
| Name | In | Type | Description |
|---|---|---|---|
skillrequired | path | string | A skill's |
Request body
| Field | Type | Description |
|---|---|---|
auto_apply | boolean | Postory's own chat applies it on its own when the description fits (default |
description | string | When it applies: Postory's own chat applies an |
instructions | string | The instructions themselves. Up to 8000 characters |
kind | "general" | "image" |
|
name | string | What the user calls it. Up to 80 characters |
slug | string | Kebab-case ( |
Example
curl -X PATCH "https://postory.io/api/v1/skills/<skill>" \
-H "Authorization: Bearer $POSTORY_API_KEY" \
-H "Content-Type: application/json" \
-d '{"auto_apply": false}'{
"skill": {
"id": "<skill_id>",
"slug": "launch-voice",
"name": "Launch voice",
"kind": "general",
"auto_apply": false,
"description": "Use when the request is a product launch post.",
"instructions": "Lead with the date and what ships. One short sentence per line. No hashtags."
},
"created": false,
"skills_url": "https://postory.io/settings/skills",
"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
409The state does not allow it now (already scheduled, changed, needs a choice…); branch on
code422A request parameter is not valid
429Rate limit spent; see Retry-After
DELETE /api/v1/skills/{skill}
Delete a skill, permanently.
- Scope
postory:drafts - Limit class
DELETE - Success
200
Parameters
| Name | In | Type | Description |
|---|---|---|---|
skillrequired | path | string | A skill's |
Example
curl -X DELETE "https://postory.io/api/v1/skills/<skill>" \
-H "Authorization: Bearer $POSTORY_API_KEY"{
"id": "<skill_id>",
"slug": "launch-voice",
"name": "Launch voice",
"deleted": true,
"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