# Zilfu — Posts
6 operations. Schemas referenced below are documented at https://zilfu.app/docs/api/schemas.md.
## Servers
- `https://zilfu.app/api`
## Operations
### List posts
- **Method:** `GET`
- **Path:** `/spaces/{space}/posts`
- **Tags:** Post
Filterable by status, account, and date range. Pass `statuses[]` or `account_ids[]` to filter by several statuses or accounts at once.
#### Parameters
##### `space` required
- **In:** `path`
The space ID
`integer`
##### `status`
- **In:** `query`
`integer`, possible values: `0, 1, 2, 3, 4, 5`
##### `statuses[]`
- **In:** `query`
**Array of:**
`integer`, possible values: `0, 1, 2, 3, 4, 5`
##### `account_id`
- **In:** `query`
`integer`
##### `account_ids[]`
- **In:** `query`
**Array of:**
`integer`
##### `from`
- **In:** `query`
`string`, format: `date-time`
##### `to`
- **In:** `query`
`string`, format: `date-time`
##### `per_page`
- **In:** `query`
`integer`
#### Responses
##### Status: 200 Paginated set of \`PostResource\`
###### Content-Type: application/json
- **`data` (required)**
`array`
**Items:**
- **`account_id` (required)**
`integer`
- **`analytics` (required)**
`array | null`
- **`cluster_id` (required)**
`string`
- **`content` (required)**
`string`
- **`created_at` (required)**
`string | null`, format: `date-time`
- **`id` (required)**
`integer`
- **`metadata` (required)**
`array | null`
- **`order` (required)**
`integer`
- **`parent_id` (required)**
`integer | null`
- **`published_at` (required)**
`string | null`, format: `date-time`
- **`scheduled_at` (required)**
`string | null`, format: `date-time`
- **`status` (required)**
`integer`, possible values: `0, 1, 2, 3, 4, 5`
- **`updated_at` (required)**
`string | null`, format: `date-time`
- **`user_id` (required)**
`integer`
- **`account`**
`object`
- **`avatar` (required)**
`string | null`
- **`disconnected_at` (required)**
`string`
- **`display_name` (required)**
`string`
- **`handler` (required)**
`string`
- **`id` (required)**
`integer`
- **`is_active` (required)**
`boolean`
- **`profile_url` (required)**
`string`
- **`social` (required)**
`string`
- **`analytics_metrics`**
`array`
**Items:**
- **`children`**
`array`
**Items:**
- **`account_id` (required)**
`integer`
- **`analytics` (required)**
`array | null`
- **`cluster_id` (required)**
`string`
- **`content` (required)**
`string`
- **`created_at` (required)**
`string | null`, format: `date-time`
- **`id` (required)**
`integer`
- **`metadata` (required)**
`array | null`
- **`order` (required)**
`integer`
- **`parent_id` (required)**
`integer | null`
- **`published_at` (required)**
`string | null`, format: `date-time`
- **`scheduled_at` (required)**
`string | null`, format: `date-time`
- **`status` (required)**
`integer`, possible values: `0, 1, 2, 3, 4, 5`
- **`updated_at` (required)**
`string | null`, format: `date-time`
- **`user_id` (required)**
`integer`
- **`account`**
`object`
- **`avatar` (required)**
`string | null`
- **`disconnected_at` (required)**
`string`
- **`display_name` (required)**
`string`
- **`handler` (required)**
`string`
- **`id` (required)**
`integer`
- **`is_active` (required)**
`boolean`
- **`profile_url` (required)**
`string`
- **`social` (required)**
`string`
- **`analytics_metrics`**
`array`
**Items:**
- **`children`**
`array`
**Items:**
- **`account_id` (required)**
`integer`
- **`analytics` (required)**
`array | null`
- **`cluster_id` (required)**
`string`
- **`content` (required)**
`string`
- **`created_at` (required)**
`string | null`, format: `date-time`
- **`id` (required)**
`integer`
- **`metadata` (required)**
`array | null`
- **`order` (required)**
`integer`
- **`parent_id` (required)**
`integer | null`
- **`published_at` (required)**
`string | null`, format: `date-time`
- **`scheduled_at` (required)**
`string | null`, format: `date-time`
- **`status` (required)**
`integer`, possible values: `0, 1, 2, 3, 4, 5`
- **`updated_at` (required)**
`string | null`, format: `date-time`
- **`user_id` (required)**
`integer`
- **`account`**
`object`
- **`avatar` (required)**
`string | null`
- **`disconnected_at` (required)**
`string`
- **`display_name` (required)**
`string`
- **`handler` (required)**
`string`
- **`id` (required)**
`integer`
- **`is_active` (required)**
`boolean`
- **`profile_url` (required)**
`string`
- **`social` (required)**
`string`
- **`analytics_metrics`**
`array`
**Items:**
- **`children`**
`array`
**Items:**
- **`account_id` (required)**
`integer`
- **`analytics` (required)**
`array | null`
- **`cluster_id` (required)**
`string`
- **`content` (required)**
`string`
- **`created_at` (required)**
`string | null`, format: `date-time`
- **`id` (required)**
`integer`
- **`metadata` (required)**
`array | null`
- **`order` (required)**
`integer`
- **`parent_id` (required)**
`integer | null`
- **`published_at` (required)**
`string | null`, format: `date-time`
- **`scheduled_at` (required)**
`string | null`, format: `date-time`
- **`status` (required)**
`integer`, possible values: `0, 1, 2, 3, 4, 5`
- **`updated_at` (required)**
`string | null`, format: `date-time`
- **`user_id` (required)**
`integer`
- **`account`**
`object`
- **`avatar` (required)**
`string | null`
- **`disconnected_at` (required)**
`string`
- **`display_name` (required)**
`string`
- **`handler` (required)**
`string`
- **`id` (required)**
`integer`
- **`is_active` (required)**
`boolean`
- **`profile_url` (required)**
`string`
- **`social` (required)**
`string`
- **`analytics_metrics`**
`array`
**Items:**
- **`children`**
`array`
**Items:**
- **`account_id` (required)**
`integer`
- **`analytics` (required)**
`array | null`
- **`cluster_id` (required)**
`string`
- **`content` (required)**
`string`
- **`created_at` (required)**
`string | null`, format: `date-time`
- **`id` (required)**
`integer`
- **`metadata` (required)**
`array | null`
- **`order` (required)**
`integer`
- **`parent_id` (required)**
`integer | null`
- **`published_at` (required)**
`string | null`, format: `date-time`
- **`scheduled_at` (required)**
`string | null`, format: `date-time`
- **`status` (required)**
`integer`, possible values: `0, 1, 2, 3, 4, 5`
- **`updated_at` (required)**
`string | null`, format: `date-time`
- **`user_id` (required)**
`integer`
- **`account`**
`object`
- **`avatar` (required)**
`string | null`
- **`disconnected_at` (required)**
`string`
- **`display_name` (required)**
`string`
- **`handler` (required)**
`string`
- **`id` (required)**
`integer`
- **`is_active` (required)**
`boolean`
- **`profile_url` (required)**
`string`
- **`social` (required)**
`string`
- **`analytics_metrics`**
`array`
**Items:**
- **`children`**
`array`
**Items:**
- **`account_id` (required)**
`integer`
- **`analytics` (required)**
`array | null`
- **`cluster_id` (required)**
`string`
- **`content` (required)**
`string`
- **`created_at` (required)**
`string | null`, format: `date-time`
- **`id` (required)**
`integer`
- **`metadata` (required)**
`array | null`
- **`order` (required)**
`integer`
- **`parent_id` (required)**
`integer | null`
- **`published_at` (required)**
`string | null`, format: `date-time`
- **`scheduled_at` (required)**
`string | null`, format: `date-time`
- **`status` (required)**
`integer`, possible values: `0, 1, 2, 3, 4, 5`
- **`updated_at` (required)**
`string | null`, format: `date-time`
- **`user_id` (required)**
`integer`
- **`account`**
`object`
- **`avatar` (required)**
`string | null`
- **`disconnected_at` (required)**
`string`
- **`display_name` (required)**
`string`
- **`handler` (required)**
`string`
- **`id` (required)**
`integer`
- **`is_active` (required)**
`boolean`
- **`profile_url` (required)**
`string`
- **`social` (required)**
`string`
- **`analytics_metrics`**
`array`
**Items:**
- **`children`**
`array`
**Items:**
- **`account_id` (required)**
`integer`
- **`analytics` (required)**
`array | null`
- **`cluster_id` (required)**
`string`
- **`content` (required)**
`string`
- **`created_at` (required)**
`string | null`, format: `date-time`
- **`id` (required)**
`integer`
- **`metadata` (required)**
`array | null`
- **`order` (required)**
`integer`
- **`parent_id` (required)**
`integer | null`
- **`published_at` (required)**
`string | null`, format: `date-time`
- **`scheduled_at` (required)**
`string | null`, format: `date-time`
- **`status` (required)**
`integer`, possible values: `0, 1, 2, 3, 4, 5`
- **`updated_at` (required)**
`string | null`, format: `date-time`
- **`user_id` (required)**
`integer`
- **`account`**
`object`
- **`avatar` (required)**
`string | null`
- **`disconnected_at` (required)**
`string`
- **`display_name` (required)**
`string`
- **`handler` (required)**
`string`
- **`id` (required)**
`integer`
- **`is_active` (required)**
`boolean`
- **`profile_url` (required)**
`string`
- **`social` (required)**
`string`
- **`analytics_metrics`**
`array`
**Items:**
- **`children`**
`array`
**Items:**
- **`account_id` (required)**
`integer`
- **`analytics` (required)**
`array | null`
- **`cluster_id` (required)**
`string`
- **`content` (required)**
`string`
- **`created_at` (required)**
`string | null`, format: `date-time`
- **`id` (required)**
`integer`
- **`metadata` (required)**
`array | null`
- **`order` (required)**
`integer`
- **`parent_id` (required)**
`integer | null`
- **`published_at` (required)**
`string | null`, format: `date-time`
- **`scheduled_at` (required)**
`string | null`, format: `date-time`
- **`status` (required)**
`integer`, possible values: `0, 1, 2, 3, 4, 5`
- **`updated_at` (required)**
`string | null`, format: `date-time`
- **`user_id` (required)**
`integer`
- **`account`**
`object`
- **`avatar` (required)**
`string | null`
- **`disconnected_at` (required)**
`string`
- **`display_name` (required)**
`string`
- **`handler` (required)**
`string`
- **`id` (required)**
`integer`
- **`is_active` (required)**
`boolean`
- **`profile_url` (required)**
`string`
- **`social` (required)**
`string`
- **`analytics_metrics`**
`array`
**Items:**
- **`children`**
`array`
**Items:**
- **`account_id` (required)**
`integer`
- **`analytics` (required)**
`array | null`
- **`cluster_id` (required)**
`string`
- **`content` (required)**
`string`
- **`created_at` (required)**
`string | null`, format: `date-time`
- **`id` (required)**
`integer`
- **`metadata` (required)**
`array | null`
- **`order` (required)**
`integer`
- **`parent_id` (required)**
`integer | null`
- **`published_at` (required)**
`string | null`, format: `date-time`
- **`scheduled_at` (required)**
`string | null`, format: `date-time`
- **`status` (required)**
`integer`, possible values: `0, 1, 2, 3, 4, 5`
- **`updated_at` (required)**
`string | null`, format: `date-time`
- **`user_id` (required)**
`integer`
- **`account`**
`object`
*\[Circular Reference]*
- **`analytics_metrics`**
`array`
**Items:**
*\[Circular Reference]*
- **`children`**
`array`
**Items:**
*\[Circular Reference]*
- **`media`**
`array`
**Items:**
*\[Circular Reference]*
- **`review`**
`object`
- **`scheduled_comments`**
`array`
**Items:**
*\[Circular Reference]*
- **`type`**
`object`
- **`media`**
`array`
**Items:**
- **`alt` (required)**
`string`
- **`height` (required)**
`string`
- **`id` (required)**
`string`
- **`mime` (required)**
`string`
- **`name` (required)**
`string`
- **`order` (required)**
`string`
- **`size` (required)**
`string`
- **`type` (required)**
`string`
- **`url` (required)**
`string`
- **`width` (required)**
`string`
- **`review`**
`object`
- **`scheduled_comments`**
`array`
**Items:**
- **`account_id` (required)**
`integer`
- **`content` (required)**
`string`
- **`created_at` (required)**
`string | null`, format: `date-time`
- **`delay_minutes` (required)**
`integer`
- **`id` (required)**
`integer`
- **`metadata` (required)**
`array | null`
- **`post_id` (required)**
`integer`
- **`published_at` (required)**
`string | null`, format: `date-time`
- **`scheduled_at` (required)**
`string | null`, format: `date-time`
- **`status` (required)**
`integer`, possible values: `0, 1, 2, 3, 4, 5, 6` — | | |---| | \`0\` \
Created, waiting for the parent post to publish before it can be armed. | | \`1\` \
Armed with the parent's remote id and an absolute fire time. | | \`2\` \
| | \`3\` \
| | \`4\` \
| | \`5\` \
Parent post failed, so the comment never armed. | | \`6\` \
Cancelled by the user before publishing. |
- **`updated_at` (required)**
`string | null`, format: `date-time`
- **`type`**
`object`
- **`media`**
`array`
**Items:**
- **`alt` (required)**
`string`
- **`height` (required)**
`string`
- **`id` (required)**
`string`
- **`mime` (required)**
`string`
- **`name` (required)**
`string`
- **`order` (required)**
`string`
- **`size` (required)**
`string`
- **`type` (required)**
`string`
- **`url` (required)**
`string`
- **`width` (required)**
`string`
- **`review`**
`object`
- **`scheduled_comments`**
`array`
**Items:**
- **`account_id` (required)**
`integer`
- **`content` (required)**
`string`
- **`created_at` (required)**
`string | null`, format: `date-time`
- **`delay_minutes` (required)**
`integer`
- **`id` (required)**
`integer`
- **`metadata` (required)**
`array | null`
- **`post_id` (required)**
`integer`
- **`published_at` (required)**
`string | null`, format: `date-time`
- **`scheduled_at` (required)**
`string | null`, format: `date-time`
- **`status` (required)**
`integer`, possible values: `0, 1, 2, 3, 4, 5, 6` — | | |---| | \`0\` \
Created, waiting for the parent post to publish before it can be armed. | | \`1\` \
Armed with the parent's remote id and an absolute fire time. | | \`2\` \
| | \`3\` \
| | \`4\` \
| | \`5\` \
Parent post failed, so the comment never armed. | | \`6\` \
Cancelled by the user before publishing. |
- **`updated_at` (required)**
`string | null`, format: `date-time`
- **`type`**
`object`
- **`media`**
`array`
**Items:**
- **`alt` (required)**
`string`
- **`height` (required)**
`string`
- **`id` (required)**
`string`
- **`mime` (required)**
`string`
- **`name` (required)**
`string`
- **`order` (required)**
`string`
- **`size` (required)**
`string`
- **`type` (required)**
`string`
- **`url` (required)**
`string`
- **`width` (required)**
`string`
- **`review`**
`object`
- **`scheduled_comments`**
`array`
**Items:**
- **`account_id` (required)**
`integer`
- **`content` (required)**
`string`
- **`created_at` (required)**
`string | null`, format: `date-time`
- **`delay_minutes` (required)**
`integer`
- **`id` (required)**
`integer`
- **`metadata` (required)**
`array | null`
- **`post_id` (required)**
`integer`
- **`published_at` (required)**
`string | null`, format: `date-time`
- **`scheduled_at` (required)**
`string | null`, format: `date-time`
- **`status` (required)**
`integer`, possible values: `0, 1, 2, 3, 4, 5, 6` — | | |---| | \`0\` \
Created, waiting for the parent post to publish before it can be armed. | | \`1\` \
Armed with the parent's remote id and an absolute fire time. | | \`2\` \
| | \`3\` \
| | \`4\` \
| | \`5\` \
Parent post failed, so the comment never armed. | | \`6\` \
Cancelled by the user before publishing. |
- **`updated_at` (required)**
`string | null`, format: `date-time`
- **`type`**
`object`
- **`media`**
`array`
**Items:**
- **`alt` (required)**
`string`
- **`height` (required)**
`string`
- **`id` (required)**
`string`
- **`mime` (required)**
`string`
- **`name` (required)**
`string`
- **`order` (required)**
`string`
- **`size` (required)**
`string`
- **`type` (required)**
`string`
- **`url` (required)**
`string`
- **`width` (required)**
`string`
- **`review`**
`object`
- **`scheduled_comments`**
`array`
**Items:**
- **`account_id` (required)**
`integer`
- **`content` (required)**
`string`
- **`created_at` (required)**
`string | null`, format: `date-time`
- **`delay_minutes` (required)**
`integer`
- **`id` (required)**
`integer`
- **`metadata` (required)**
`array | null`
- **`post_id` (required)**
`integer`
- **`published_at` (required)**
`string | null`, format: `date-time`
- **`scheduled_at` (required)**
`string | null`, format: `date-time`
- **`status` (required)**
`integer`, possible values: `0, 1, 2, 3, 4, 5, 6` — | | |---| | \`0\` \
Created, waiting for the parent post to publish before it can be armed. | | \`1\` \
Armed with the parent's remote id and an absolute fire time. | | \`2\` \
| | \`3\` \
| | \`4\` \
| | \`5\` \
Parent post failed, so the comment never armed. | | \`6\` \
Cancelled by the user before publishing. |
- **`updated_at` (required)**
`string | null`, format: `date-time`
- **`type`**
`object`
- **`media`**
`array`
**Items:**
- **`alt` (required)**
`string`
- **`height` (required)**
`string`
- **`id` (required)**
`string`
- **`mime` (required)**
`string`
- **`name` (required)**
`string`
- **`order` (required)**
`string`
- **`size` (required)**
`string`
- **`type` (required)**
`string`
- **`url` (required)**
`string`
- **`width` (required)**
`string`
- **`review`**
`object`
- **`scheduled_comments`**
`array`
**Items:**
- **`account_id` (required)**
`integer`
- **`content` (required)**
`string`
- **`created_at` (required)**
`string | null`, format: `date-time`
- **`delay_minutes` (required)**
`integer`
- **`id` (required)**
`integer`
- **`metadata` (required)**
`array | null`
- **`post_id` (required)**
`integer`
- **`published_at` (required)**
`string | null`, format: `date-time`
- **`scheduled_at` (required)**
`string | null`, format: `date-time`
- **`status` (required)**
`integer`, possible values: `0, 1, 2, 3, 4, 5, 6` — | | |---| | \`0\` \
Created, waiting for the parent post to publish before it can be armed. | | \`1\` \
Armed with the parent's remote id and an absolute fire time. | | \`2\` \
| | \`3\` \
| | \`4\` \
| | \`5\` \
Parent post failed, so the comment never armed. | | \`6\` \
Cancelled by the user before publishing. |
- **`updated_at` (required)**
`string | null`, format: `date-time`
- **`type`**
`object`
- **`media`**
`array`
**Items:**
- **`alt` (required)**
`string`
- **`height` (required)**
`string`
- **`id` (required)**
`string`
- **`mime` (required)**
`string`
- **`name` (required)**
`string`
- **`order` (required)**
`string`
- **`size` (required)**
`string`
- **`type` (required)**
`string`
- **`url` (required)**
`string`
- **`width` (required)**
`string`
- **`review`**
`object`
- **`scheduled_comments`**
`array`
**Items:**
- **`account_id` (required)**
`integer`
- **`content` (required)**
`string`
- **`created_at` (required)**
`string | null`, format: `date-time`
- **`delay_minutes` (required)**
`integer`
- **`id` (required)**
`integer`
- **`metadata` (required)**
`array | null`
- **`post_id` (required)**
`integer`
- **`published_at` (required)**
`string | null`, format: `date-time`
- **`scheduled_at` (required)**
`string | null`, format: `date-time`
- **`status` (required)**
`integer`, possible values: `0, 1, 2, 3, 4, 5, 6` — | | |---| | \`0\` \
Created, waiting for the parent post to publish before it can be armed. | | \`1\` \
Armed with the parent's remote id and an absolute fire time. | | \`2\` \
| | \`3\` \
| | \`4\` \
| | \`5\` \
Parent post failed, so the comment never armed. | | \`6\` \
Cancelled by the user before publishing. |
- **`updated_at` (required)**
`string | null`, format: `date-time`
- **`type`**
`object`
- **`media`**
`array`
**Items:**
- **`alt` (required)**
`string`
- **`height` (required)**
`string`
- **`id` (required)**
`string`
- **`mime` (required)**
`string`
- **`name` (required)**
`string`
- **`order` (required)**
`string`
- **`size` (required)**
`string`
- **`type` (required)**
`string`
- **`url` (required)**
`string`
- **`width` (required)**
`string`
- **`review`**
`object`
- **`scheduled_comments`**
`array`
**Items:**
- **`account_id` (required)**
`integer`
- **`content` (required)**
`string`
- **`created_at` (required)**
`string | null`, format: `date-time`
- **`delay_minutes` (required)**
`integer`
- **`id` (required)**
`integer`
- **`metadata` (required)**
`array | null`
- **`post_id` (required)**
`integer`
- **`published_at` (required)**
`string | null`, format: `date-time`
- **`scheduled_at` (required)**
`string | null`, format: `date-time`
- **`status` (required)**
`integer`, possible values: `0, 1, 2, 3, 4, 5, 6` — | | |---| | \`0\` \
Created, waiting for the parent post to publish before it can be armed. | | \`1\` \
Armed with the parent's remote id and an absolute fire time. | | \`2\` \
| | \`3\` \
| | \`4\` \
| | \`5\` \
Parent post failed, so the comment never armed. | | \`6\` \
Cancelled by the user before publishing. |
- **`updated_at` (required)**
`string | null`, format: `date-time`
- **`type`**
`object`
- **`media`**
`array`
**Items:**
- **`alt` (required)**
`string`
- **`height` (required)**
`string`
- **`id` (required)**
`string`
- **`mime` (required)**
`string`
- **`name` (required)**
`string`
- **`order` (required)**
`string`
- **`size` (required)**
`string`
- **`type` (required)**
`string`
- **`url` (required)**
`string`
- **`width` (required)**
`string`
- **`review`**
`object`
- **`scheduled_comments`**
`array`
**Items:**
- **`account_id` (required)**
`integer`
- **`content` (required)**
`string`
- **`created_at` (required)**
`string | null`, format: `date-time`
- **`delay_minutes` (required)**
`integer`
- **`id` (required)**
`integer`
- **`metadata` (required)**
`array | null`
- **`post_id` (required)**
`integer`
- **`published_at` (required)**
`string | null`, format: `date-time`
- **`scheduled_at` (required)**
`string | null`, format: `date-time`
- **`status` (required)**
`integer`, possible values: `0, 1, 2, 3, 4, 5, 6` — | | |---| | \`0\` \
Created, waiting for the parent post to publish before it can be armed. | | \`1\` \
Armed with the parent's remote id and an absolute fire time. | | \`2\` \
| | \`3\` \
| | \`4\` \
| | \`5\` \
Parent post failed, so the comment never armed. | | \`6\` \
Cancelled by the user before publishing. |
- **`updated_at` (required)**
`string | null`, format: `date-time`
- **`type`**
`object`
- **`links` (required)**
`object`
- **`first` (required)**
`string | null`
- **`last` (required)**
`string | null`
- **`next` (required)**
`string | null`
- **`prev` (required)**
`string | null`
- **`meta` (required)**
`object`
- **`current_page` (required)**
`integer`
- **`from` (required)**
`integer | null`
- **`last_page` (required)**
`integer`
- **`links` (required)**
`array` — Generated paginator links.
**Items:**
- **`active` (required)**
`boolean`
- **`label` (required)**
`string`
- **`url` (required)**
`string | null`
- **`path` (required)**
`string | null` — Base path for paginator generated URLs.
- **`per_page` (required)**
`integer` — Number of items shown per page.
- **`to` (required)**
`integer | null` — Number of the last item in the slice.
- **`total` (required)**
`integer` — Total number of items being paginated.
**Example:**
```json
{
"data": [
{
"id": 1,
"content": "",
"status": null,
"order": 1,
"scheduled_at": null,
"published_at": null,
"metadata": [],
"type": "",
"cluster_id": "",
"parent_id": null,
"user_id": 1,
"account_id": 1,
"created_at": null,
"updated_at": null,
"analytics": [],
"analytics_metrics": [],
"account": null,
"children": [],
"scheduled_comments": [],
"media": [],
"review": null
}
],
"links": {
"first": null,
"last": null,
"prev": null,
"next": null
},
"meta": {
"current_page": 1,
"from": null,
"last_page": 1,
"links": [
{
"url": null,
"label": "",
"active": true
}
],
"path": null,
"per_page": 0,
"to": null,
"total": 0
}
}
```
##### Status: 401 Unauthenticated
###### Content-Type: application/json
- **`message` (required)**
`string` — Error overview.
**Example:**
```json
{
"message": ""
}
```
##### Status: 403 Authorization error
###### Content-Type: application/json
- **`message` (required)**
`string` — Error overview.
**Example:**
```json
{
"message": ""
}
```
##### Status: 404 Not found
###### Content-Type: application/json
- **`message` (required)**
`string` — Error overview.
**Example:**
```json
{
"message": ""
}
```
##### Status: 422 Validation error
###### Content-Type: application/json
- **`errors` (required)**
`object` — A detailed description of each field that failed validation.
- **`message` (required)**
`string` — Errors overview.
**Example:**
```json
{
"message": "",
"errors": {
"additionalProperty": [
""
]
}
}
```
### Create posts
- **Method:** `POST`
- **Path:** `/spaces/{space}/posts`
- **Tags:** Post
Creates one or more posts as a cluster. Supports draft, scheduled, or immediate publishing.
#### Parameters
##### `space` required
- **In:** `path`
`string`
#### Request Body
##### Content-Type: application/json
- **`items` (required)**
`array`
**Items:**
- **`account_id` (required)**
`integer`
- **`social` (required)**
`string`
- **`children`**
`array | null`
- **`main`**
`object`
- **`content` (required)**
`string`
- **`media`**
`array | null`
- **`metadata`**
`object | null`
- **`allow_comments`**
`boolean | null`
- **`allow_duet`**
`boolean | null`
- **`allow_stitch`**
`boolean | null`
- **`board_id`**
`string | null`
- **`brand_organic`**
`boolean | null`
- **`branded_content`**
`boolean | null`
- **`cover_image_url`**
`string | null`, format: `uri`
- **`link`**
`string | null`, format: `uri`
- **`post_type`**
`string | null`
- **`privacy_level`**
`string | null`
- **`title`**
`string | null`
- **`topic_tag`**
`string | null`
- **`space_id` (required)**
`integer`
- **`at`**
`integer | null`
- **`comment`**
`object`
- **`content`**
`string`
- **`delay_minutes`**
`integer`
- **`is_draft`**
`boolean`
**Example:**
```json
{
"space_id": 1,
"at": null,
"is_draft": true,
"comment": {
"content": "",
"delay_minutes": 1
},
"items": [
{
"account_id": 1,
"social": "",
"children": [
{
"content": "",
"media": [
{
"url": "",
"type": "image"
}
]
}
],
"metadata": {
"topic_tag": null,
"post_type": null,
"link": null,
"privacy_level": null,
"allow_comments": null,
"allow_duet": null,
"allow_stitch": null,
"branded_content": null,
"brand_organic": null,
"board_id": null,
"title": null,
"cover_image_url": null
},
"main": {
"content": "",
"media": [
{
"url": "",
"type": "image"
}
]
}
}
]
}
```
#### Responses
##### Status: 200
###### Content-Type: application/json
**Example:**
```json
{}
```
##### Status: 401 Unauthenticated
###### Content-Type: application/json
- **`message` (required)**
`string` — Error overview.
**Example:**
```json
{
"message": ""
}
```
##### Status: 403 Authorization error
###### Content-Type: application/json
- **`message` (required)**
`string` — Error overview.
**Example:**
```json
{
"message": ""
}
```
##### Status: 422 Validation error
###### Content-Type: application/json
- **`errors` (required)**
`object` — A detailed description of each field that failed validation.
- **`message` (required)**
`string` — Errors overview.
**Example:**
```json
{
"message": "",
"errors": {
"additionalProperty": [
""
]
}
}
```
### Get a post
- **Method:** `GET`
- **Path:** `/spaces/{space}/posts/{post}`
- **Tags:** Post
#### Parameters
##### `space` required
- **In:** `path`
The space ID
`integer`
##### `post` required
- **In:** `path`
The post ID
`integer`
#### Responses
##### Status: 200 \`PostResource\`
###### Content-Type: application/json
- **`data` (required)**
`object`
- **`account_id` (required)**
`integer`
- **`analytics` (required)**
`array | null`
- **`cluster_id` (required)**
`string`
- **`content` (required)**
`string`
- **`created_at` (required)**
`string | null`, format: `date-time`
- **`id` (required)**
`integer`
- **`metadata` (required)**
`array | null`
- **`order` (required)**
`integer`
- **`parent_id` (required)**
`integer | null`
- **`published_at` (required)**
`string | null`, format: `date-time`
- **`scheduled_at` (required)**
`string | null`, format: `date-time`
- **`status` (required)**
`integer`, possible values: `0, 1, 2, 3, 4, 5`
- **`updated_at` (required)**
`string | null`, format: `date-time`
- **`user_id` (required)**
`integer`
- **`account`**
`object`
- **`avatar` (required)**
`string | null`
- **`disconnected_at` (required)**
`string`
- **`display_name` (required)**
`string`
- **`handler` (required)**
`string`
- **`id` (required)**
`integer`
- **`is_active` (required)**
`boolean`
- **`profile_url` (required)**
`string`
- **`social` (required)**
`string`
- **`analytics_metrics`**
`array`
**Items:**
- **`children`**
`array`
**Items:**
- **`account_id` (required)**
`integer`
- **`analytics` (required)**
`array | null`
- **`cluster_id` (required)**
`string`
- **`content` (required)**
`string`
- **`created_at` (required)**
`string | null`, format: `date-time`
- **`id` (required)**
`integer`
- **`metadata` (required)**
`array | null`
- **`order` (required)**
`integer`
- **`parent_id` (required)**
`integer | null`
- **`published_at` (required)**
`string | null`, format: `date-time`
- **`scheduled_at` (required)**
`string | null`, format: `date-time`
- **`status` (required)**
`integer`, possible values: `0, 1, 2, 3, 4, 5`
- **`updated_at` (required)**
`string | null`, format: `date-time`
- **`user_id` (required)**
`integer`
- **`account`**
`object`
- **`avatar` (required)**
`string | null`
- **`disconnected_at` (required)**
`string`
- **`display_name` (required)**
`string`
- **`handler` (required)**
`string`
- **`id` (required)**
`integer`
- **`is_active` (required)**
`boolean`
- **`profile_url` (required)**
`string`
- **`social` (required)**
`string`
- **`analytics_metrics`**
`array`
**Items:**
- **`children`**
`array`
**Items:**
- **`account_id` (required)**
`integer`
- **`analytics` (required)**
`array | null`
- **`cluster_id` (required)**
`string`
- **`content` (required)**
`string`
- **`created_at` (required)**
`string | null`, format: `date-time`
- **`id` (required)**
`integer`
- **`metadata` (required)**
`array | null`
- **`order` (required)**
`integer`
- **`parent_id` (required)**
`integer | null`
- **`published_at` (required)**
`string | null`, format: `date-time`
- **`scheduled_at` (required)**
`string | null`, format: `date-time`
- **`status` (required)**
`integer`, possible values: `0, 1, 2, 3, 4, 5`
- **`updated_at` (required)**
`string | null`, format: `date-time`
- **`user_id` (required)**
`integer`
- **`account`**
`object`
- **`avatar` (required)**
`string | null`
- **`disconnected_at` (required)**
`string`
- **`display_name` (required)**
`string`
- **`handler` (required)**
`string`
- **`id` (required)**
`integer`
- **`is_active` (required)**
`boolean`
- **`profile_url` (required)**
`string`
- **`social` (required)**
`string`
- **`analytics_metrics`**
`array`
**Items:**
- **`children`**
`array`
**Items:**
- **`account_id` (required)**
`integer`
- **`analytics` (required)**
`array | null`
- **`cluster_id` (required)**
`string`
- **`content` (required)**
`string`
- **`created_at` (required)**
`string | null`, format: `date-time`
- **`id` (required)**
`integer`
- **`metadata` (required)**
`array | null`
- **`order` (required)**
`integer`
- **`parent_id` (required)**
`integer | null`
- **`published_at` (required)**
`string | null`, format: `date-time`
- **`scheduled_at` (required)**
`string | null`, format: `date-time`
- **`status` (required)**
`integer`, possible values: `0, 1, 2, 3, 4, 5`
- **`updated_at` (required)**
`string | null`, format: `date-time`
- **`user_id` (required)**
`integer`
- **`account`**
`object`
- **`avatar` (required)**
`string | null`
- **`disconnected_at` (required)**
`string`
- **`display_name` (required)**
`string`
- **`handler` (required)**
`string`
- **`id` (required)**
`integer`
- **`is_active` (required)**
`boolean`
- **`profile_url` (required)**
`string`
- **`social` (required)**
`string`
- **`analytics_metrics`**
`array`
**Items:**
- **`children`**
`array`
**Items:**
- **`account_id` (required)**
`integer`
- **`analytics` (required)**
`array | null`
- **`cluster_id` (required)**
`string`
- **`content` (required)**
`string`
- **`created_at` (required)**
`string | null`, format: `date-time`
- **`id` (required)**
`integer`
- **`metadata` (required)**
`array | null`
- **`order` (required)**
`integer`
- **`parent_id` (required)**
`integer | null`
- **`published_at` (required)**
`string | null`, format: `date-time`
- **`scheduled_at` (required)**
`string | null`, format: `date-time`
- **`status` (required)**
`integer`, possible values: `0, 1, 2, 3, 4, 5`
- **`updated_at` (required)**
`string | null`, format: `date-time`
- **`user_id` (required)**
`integer`
- **`account`**
`object`
- **`avatar` (required)**
`string | null`
- **`disconnected_at` (required)**
`string`
- **`display_name` (required)**
`string`
- **`handler` (required)**
`string`
- **`id` (required)**
`integer`
- **`is_active` (required)**
`boolean`
- **`profile_url` (required)**
`string`
- **`social` (required)**
`string`
- **`analytics_metrics`**
`array`
**Items:**
- **`children`**
`array`
**Items:**
- **`account_id` (required)**
`integer`
- **`analytics` (required)**
`array | null`
- **`cluster_id` (required)**
`string`
- **`content` (required)**
`string`
- **`created_at` (required)**
`string | null`, format: `date-time`
- **`id` (required)**
`integer`
- **`metadata` (required)**
`array | null`
- **`order` (required)**
`integer`
- **`parent_id` (required)**
`integer | null`
- **`published_at` (required)**
`string | null`, format: `date-time`
- **`scheduled_at` (required)**
`string | null`, format: `date-time`
- **`status` (required)**
`integer`, possible values: `0, 1, 2, 3, 4, 5`
- **`updated_at` (required)**
`string | null`, format: `date-time`
- **`user_id` (required)**
`integer`
- **`account`**
`object`
- **`avatar` (required)**
`string | null`
- **`disconnected_at` (required)**
`string`
- **`display_name` (required)**
`string`
- **`handler` (required)**
`string`
- **`id` (required)**
`integer`
- **`is_active` (required)**
`boolean`
- **`profile_url` (required)**
`string`
- **`social` (required)**
`string`
- **`analytics_metrics`**
`array`
**Items:**
- **`children`**
`array`
**Items:**
- **`account_id` (required)**
`integer`
- **`analytics` (required)**
`array | null`
- **`cluster_id` (required)**
`string`
- **`content` (required)**
`string`
- **`created_at` (required)**
`string | null`, format: `date-time`
- **`id` (required)**
`integer`
- **`metadata` (required)**
`array | null`
- **`order` (required)**
`integer`
- **`parent_id` (required)**
`integer | null`
- **`published_at` (required)**
`string | null`, format: `date-time`
- **`scheduled_at` (required)**
`string | null`, format: `date-time`
- **`status` (required)**
`integer`, possible values: `0, 1, 2, 3, 4, 5`
- **`updated_at` (required)**
`string | null`, format: `date-time`
- **`user_id` (required)**
`integer`
- **`account`**
`object`
- **`avatar` (required)**
`string | null`
- **`disconnected_at` (required)**
`string`
- **`display_name` (required)**
`string`
- **`handler` (required)**
`string`
- **`id` (required)**
`integer`
- **`is_active` (required)**
`boolean`
- **`profile_url` (required)**
`string`
- **`social` (required)**
`string`
- **`analytics_metrics`**
`array`
**Items:**
- **`children`**
`array`
**Items:**
- **`account_id` (required)**
`integer`
- **`analytics` (required)**
`array | null`
- **`cluster_id` (required)**
`string`
- **`content` (required)**
`string`
- **`created_at` (required)**
`string | null`, format: `date-time`
- **`id` (required)**
`integer`
- **`metadata` (required)**
`array | null`
- **`order` (required)**
`integer`
- **`parent_id` (required)**
`integer | null`
- **`published_at` (required)**
`string | null`, format: `date-time`
- **`scheduled_at` (required)**
`string | null`, format: `date-time`
- **`status` (required)**
`integer`, possible values: `0, 1, 2, 3, 4, 5`
- **`updated_at` (required)**
`string | null`, format: `date-time`
- **`user_id` (required)**
`integer`
- **`account`**
`object`
- **`avatar` (required)**
`string | null`
- **`disconnected_at` (required)**
`string`
- **`display_name` (required)**
`string`
- **`handler` (required)**
`string`
- **`id` (required)**
`integer`
- **`is_active` (required)**
`boolean`
- **`profile_url` (required)**
`string`
- **`social` (required)**
`string`
- **`analytics_metrics`**
`array`
**Items:**
- **`children`**
`array`
**Items:**
- **`account_id` (required)**
`integer`
- **`analytics` (required)**
`array | null`
- **`cluster_id` (required)**
`string`
- **`content` (required)**
`string`
- **`created_at` (required)**
`string | null`, format: `date-time`
- **`id` (required)**
`integer`
- **`metadata` (required)**
`array | null`
- **`order` (required)**
`integer`
- **`parent_id` (required)**
`integer | null`
- **`published_at` (required)**
`string | null`, format: `date-time`
- **`scheduled_at` (required)**
`string | null`, format: `date-time`
- **`status` (required)**
`integer`, possible values: `0, 1, 2, 3, 4, 5`
- **`updated_at` (required)**
`string | null`, format: `date-time`
- **`user_id` (required)**
`integer`
- **`account`**
`object`
*\[Circular Reference]*
- **`analytics_metrics`**
`array`
**Items:**
*\[Circular Reference]*
- **`children`**
`array`
**Items:**
*\[Circular Reference]*
- **`media`**
`array`
**Items:**
*\[Circular Reference]*
- **`review`**
`object`
- **`scheduled_comments`**
`array`
**Items:**
*\[Circular Reference]*
- **`type`**
`object`
- **`media`**
`array`
**Items:**
- **`alt` (required)**
`string`
- **`height` (required)**
`string`
- **`id` (required)**
`string`
- **`mime` (required)**
`string`
- **`name` (required)**
`string`
- **`order` (required)**
`string`
- **`size` (required)**
`string`
- **`type` (required)**
`string`
- **`url` (required)**
`string`
- **`width` (required)**
`string`
- **`review`**
`object`
- **`scheduled_comments`**
`array`
**Items:**
- **`account_id` (required)**
`integer`
- **`content` (required)**
`string`
- **`created_at` (required)**
`string | null`, format: `date-time`
- **`delay_minutes` (required)**
`integer`
- **`id` (required)**
`integer`
- **`metadata` (required)**
`array | null`
- **`post_id` (required)**
`integer`
- **`published_at` (required)**
`string | null`, format: `date-time`
- **`scheduled_at` (required)**
`string | null`, format: `date-time`
- **`status` (required)**
`integer`, possible values: `0, 1, 2, 3, 4, 5, 6` — | | |---| | \`0\` \
Created, waiting for the parent post to publish before it can be armed. | | \`1\` \
Armed with the parent's remote id and an absolute fire time. | | \`2\` \
| | \`3\` \
| | \`4\` \
| | \`5\` \
Parent post failed, so the comment never armed. | | \`6\` \
Cancelled by the user before publishing. |
- **`updated_at` (required)**
`string | null`, format: `date-time`
- **`type`**
`object`
- **`media`**
`array`
**Items:**
- **`alt` (required)**
`string`
- **`height` (required)**
`string`
- **`id` (required)**
`string`
- **`mime` (required)**
`string`
- **`name` (required)**
`string`
- **`order` (required)**
`string`
- **`size` (required)**
`string`
- **`type` (required)**
`string`
- **`url` (required)**
`string`
- **`width` (required)**
`string`
- **`review`**
`object`
- **`scheduled_comments`**
`array`
**Items:**
- **`account_id` (required)**
`integer`
- **`content` (required)**
`string`
- **`created_at` (required)**
`string | null`, format: `date-time`
- **`delay_minutes` (required)**
`integer`
- **`id` (required)**
`integer`
- **`metadata` (required)**
`array | null`
- **`post_id` (required)**
`integer`
- **`published_at` (required)**
`string | null`, format: `date-time`
- **`scheduled_at` (required)**
`string | null`, format: `date-time`
- **`status` (required)**
`integer`, possible values: `0, 1, 2, 3, 4, 5, 6` — | | |---| | \`0\` \
Created, waiting for the parent post to publish before it can be armed. | | \`1\` \
Armed with the parent's remote id and an absolute fire time. | | \`2\` \
| | \`3\` \
| | \`4\` \
| | \`5\` \
Parent post failed, so the comment never armed. | | \`6\` \
Cancelled by the user before publishing. |
- **`updated_at` (required)**
`string | null`, format: `date-time`
- **`type`**
`object`
- **`media`**
`array`
**Items:**
- **`alt` (required)**
`string`
- **`height` (required)**
`string`
- **`id` (required)**
`string`
- **`mime` (required)**
`string`
- **`name` (required)**
`string`
- **`order` (required)**
`string`
- **`size` (required)**
`string`
- **`type` (required)**
`string`
- **`url` (required)**
`string`
- **`width` (required)**
`string`
- **`review`**
`object`
- **`scheduled_comments`**
`array`
**Items:**
- **`account_id` (required)**
`integer`
- **`content` (required)**
`string`
- **`created_at` (required)**
`string | null`, format: `date-time`
- **`delay_minutes` (required)**
`integer`
- **`id` (required)**
`integer`
- **`metadata` (required)**
`array | null`
- **`post_id` (required)**
`integer`
- **`published_at` (required)**
`string | null`, format: `date-time`
- **`scheduled_at` (required)**
`string | null`, format: `date-time`
- **`status` (required)**
`integer`, possible values: `0, 1, 2, 3, 4, 5, 6` — | | |---| | \`0\` \
Created, waiting for the parent post to publish before it can be armed. | | \`1\` \
Armed with the parent's remote id and an absolute fire time. | | \`2\` \
| | \`3\` \
| | \`4\` \
| | \`5\` \
Parent post failed, so the comment never armed. | | \`6\` \
Cancelled by the user before publishing. |
- **`updated_at` (required)**
`string | null`, format: `date-time`
- **`type`**
`object`
- **`media`**
`array`
**Items:**
- **`alt` (required)**
`string`
- **`height` (required)**
`string`
- **`id` (required)**
`string`
- **`mime` (required)**
`string`
- **`name` (required)**
`string`
- **`order` (required)**
`string`
- **`size` (required)**
`string`
- **`type` (required)**
`string`
- **`url` (required)**
`string`
- **`width` (required)**
`string`
- **`review`**
`object`
- **`scheduled_comments`**
`array`
**Items:**
- **`account_id` (required)**
`integer`
- **`content` (required)**
`string`
- **`created_at` (required)**
`string | null`, format: `date-time`
- **`delay_minutes` (required)**
`integer`
- **`id` (required)**
`integer`
- **`metadata` (required)**
`array | null`
- **`post_id` (required)**
`integer`
- **`published_at` (required)**
`string | null`, format: `date-time`
- **`scheduled_at` (required)**
`string | null`, format: `date-time`
- **`status` (required)**
`integer`, possible values: `0, 1, 2, 3, 4, 5, 6` — | | |---| | \`0\` \
Created, waiting for the parent post to publish before it can be armed. | | \`1\` \
Armed with the parent's remote id and an absolute fire time. | | \`2\` \
| | \`3\` \
| | \`4\` \
| | \`5\` \
Parent post failed, so the comment never armed. | | \`6\` \
Cancelled by the user before publishing. |
- **`updated_at` (required)**
`string | null`, format: `date-time`
- **`type`**
`object`
- **`media`**
`array`
**Items:**
- **`alt` (required)**
`string`
- **`height` (required)**
`string`
- **`id` (required)**
`string`
- **`mime` (required)**
`string`
- **`name` (required)**
`string`
- **`order` (required)**
`string`
- **`size` (required)**
`string`
- **`type` (required)**
`string`
- **`url` (required)**
`string`
- **`width` (required)**
`string`
- **`review`**
`object`
- **`scheduled_comments`**
`array`
**Items:**
- **`account_id` (required)**
`integer`
- **`content` (required)**
`string`
- **`created_at` (required)**
`string | null`, format: `date-time`
- **`delay_minutes` (required)**
`integer`
- **`id` (required)**
`integer`
- **`metadata` (required)**
`array | null`
- **`post_id` (required)**
`integer`
- **`published_at` (required)**
`string | null`, format: `date-time`
- **`scheduled_at` (required)**
`string | null`, format: `date-time`
- **`status` (required)**
`integer`, possible values: `0, 1, 2, 3, 4, 5, 6` — | | |---| | \`0\` \
Created, waiting for the parent post to publish before it can be armed. | | \`1\` \
Armed with the parent's remote id and an absolute fire time. | | \`2\` \
| | \`3\` \
| | \`4\` \
| | \`5\` \
Parent post failed, so the comment never armed. | | \`6\` \
Cancelled by the user before publishing. |
- **`updated_at` (required)**
`string | null`, format: `date-time`
- **`type`**
`object`
- **`media`**
`array`
**Items:**
- **`alt` (required)**
`string`
- **`height` (required)**
`string`
- **`id` (required)**
`string`
- **`mime` (required)**
`string`
- **`name` (required)**
`string`
- **`order` (required)**
`string`
- **`size` (required)**
`string`
- **`type` (required)**
`string`
- **`url` (required)**
`string`
- **`width` (required)**
`string`
- **`review`**
`object`
- **`scheduled_comments`**
`array`
**Items:**
- **`account_id` (required)**
`integer`
- **`content` (required)**
`string`
- **`created_at` (required)**
`string | null`, format: `date-time`
- **`delay_minutes` (required)**
`integer`
- **`id` (required)**
`integer`
- **`metadata` (required)**
`array | null`
- **`post_id` (required)**
`integer`
- **`published_at` (required)**
`string | null`, format: `date-time`
- **`scheduled_at` (required)**
`string | null`, format: `date-time`
- **`status` (required)**
`integer`, possible values: `0, 1, 2, 3, 4, 5, 6` — | | |---| | \`0\` \
Created, waiting for the parent post to publish before it can be armed. | | \`1\` \
Armed with the parent's remote id and an absolute fire time. | | \`2\` \
| | \`3\` \
| | \`4\` \
| | \`5\` \
Parent post failed, so the comment never armed. | | \`6\` \
Cancelled by the user before publishing. |
- **`updated_at` (required)**
`string | null`, format: `date-time`
- **`type`**
`object`
- **`media`**
`array`
**Items:**
- **`alt` (required)**
`string`
- **`height` (required)**
`string`
- **`id` (required)**
`string`
- **`mime` (required)**
`string`
- **`name` (required)**
`string`
- **`order` (required)**
`string`
- **`size` (required)**
`string`
- **`type` (required)**
`string`
- **`url` (required)**
`string`
- **`width` (required)**
`string`
- **`review`**
`object`
- **`scheduled_comments`**
`array`
**Items:**
- **`account_id` (required)**
`integer`
- **`content` (required)**
`string`
- **`created_at` (required)**
`string | null`, format: `date-time`
- **`delay_minutes` (required)**
`integer`
- **`id` (required)**
`integer`
- **`metadata` (required)**
`array | null`
- **`post_id` (required)**
`integer`
- **`published_at` (required)**
`string | null`, format: `date-time`
- **`scheduled_at` (required)**
`string | null`, format: `date-time`
- **`status` (required)**
`integer`, possible values: `0, 1, 2, 3, 4, 5, 6` — | | |---| | \`0\` \
Created, waiting for the parent post to publish before it can be armed. | | \`1\` \
Armed with the parent's remote id and an absolute fire time. | | \`2\` \
| | \`3\` \
| | \`4\` \
| | \`5\` \
Parent post failed, so the comment never armed. | | \`6\` \
Cancelled by the user before publishing. |
- **`updated_at` (required)**
`string | null`, format: `date-time`
- **`type`**
`object`
- **`media`**
`array`
**Items:**
- **`alt` (required)**
`string`
- **`height` (required)**
`string`
- **`id` (required)**
`string`
- **`mime` (required)**
`string`
- **`name` (required)**
`string`
- **`order` (required)**
`string`
- **`size` (required)**
`string`
- **`type` (required)**
`string`
- **`url` (required)**
`string`
- **`width` (required)**
`string`
- **`review`**
`object`
- **`scheduled_comments`**
`array`
**Items:**
- **`account_id` (required)**
`integer`
- **`content` (required)**
`string`
- **`created_at` (required)**
`string | null`, format: `date-time`
- **`delay_minutes` (required)**
`integer`
- **`id` (required)**
`integer`
- **`metadata` (required)**
`array | null`
- **`post_id` (required)**
`integer`
- **`published_at` (required)**
`string | null`, format: `date-time`
- **`scheduled_at` (required)**
`string | null`, format: `date-time`
- **`status` (required)**
`integer`, possible values: `0, 1, 2, 3, 4, 5, 6` — | | |---| | \`0\` \
Created, waiting for the parent post to publish before it can be armed. | | \`1\` \
Armed with the parent's remote id and an absolute fire time. | | \`2\` \
| | \`3\` \
| | \`4\` \
| | \`5\` \
Parent post failed, so the comment never armed. | | \`6\` \
Cancelled by the user before publishing. |
- **`updated_at` (required)**
`string | null`, format: `date-time`
- **`type`**
`object`
**Example:**
```json
{
"data": {
"id": 1,
"content": "",
"status": null,
"order": 1,
"scheduled_at": null,
"published_at": null,
"metadata": [],
"type": "",
"cluster_id": "",
"parent_id": null,
"user_id": 1,
"account_id": 1,
"created_at": null,
"updated_at": null,
"analytics": [],
"analytics_metrics": [],
"account": null,
"children": [],
"scheduled_comments": [],
"media": [],
"review": null
}
}
```
##### Status: 401 Unauthenticated
###### Content-Type: application/json
- **`message` (required)**
`string` — Error overview.
**Example:**
```json
{
"message": ""
}
```
##### Status: 403 Authorization error
###### Content-Type: application/json
- **`message` (required)**
`string` — Error overview.
**Example:**
```json
{
"message": ""
}
```
##### Status: 404 Not found
###### Content-Type: application/json
- **`message` (required)**
`string` — Error overview.
**Example:**
```json
{
"message": ""
}
```
### Update a post
- **Method:** `PUT`
- **Path:** `/spaces/{space}/posts/{post}`
- **Tags:** Post
Updates content, media, thread replies, schedule, status, and metadata for a single post.
#### Parameters
##### `space` required
- **In:** `path`
The space ID
`integer`
##### `post` required
- **In:** `path`
The post ID
`integer`
#### Request Body
##### Content-Type: application/json
- **`at`**
`integer | null`
- **`children`**
`array | null`
- **`content`**
`string`
- **`is_draft`**
`boolean`
- **`media`**
`array | null`
- **`metadata`**
`object`
- **`allow_comments`**
`boolean | null`
- **`allow_duet`**
`boolean | null`
- **`allow_stitch`**
`boolean | null`
- **`board_id`**
`string | null`
- **`brand_organic`**
`boolean | null`
- **`branded_content`**
`boolean | null`
- **`cover_image_url`**
`string | null`, format: `uri`
- **`link`**
`string | null`, format: `uri`
- **`post_type`**
`string | null`
- **`privacy_level`**
`string | null`
- **`title`**
`string | null`
- **`topic_tag`**
`string | null`
**Example:**
```json
{
"at": null,
"is_draft": true,
"content": "",
"metadata": {
"topic_tag": null,
"post_type": null,
"link": null,
"privacy_level": null,
"allow_comments": null,
"allow_duet": null,
"allow_stitch": null,
"branded_content": null,
"brand_organic": null,
"board_id": null,
"title": null,
"cover_image_url": null
},
"media": [
{
"url": "",
"type": "image"
}
],
"children": [
{
"content": "",
"media": [
{
"url": "",
"type": "image"
}
]
}
]
}
```
#### Responses
##### Status: 200 \`PostResource\`
###### Content-Type: application/json
**Any of:**
- **`data` (required)**
`object`
- **`account_id` (required)**
`integer`
- **`analytics` (required)**
`array | null`
- **`cluster_id` (required)**
`string`
- **`content` (required)**
`string`
- **`created_at` (required)**
`string | null`, format: `date-time`
- **`id` (required)**
`integer`
- **`metadata` (required)**
`array | null`
- **`order` (required)**
`integer`
- **`parent_id` (required)**
`integer | null`
- **`published_at` (required)**
`string | null`, format: `date-time`
- **`scheduled_at` (required)**
`string | null`, format: `date-time`
- **`status` (required)**
`integer`, possible values: `0, 1, 2, 3, 4, 5`
- **`updated_at` (required)**
`string | null`, format: `date-time`
- **`user_id` (required)**
`integer`
- **`account`**
`object`
- **`avatar` (required)**
`string | null`
- **`disconnected_at` (required)**
`string`
- **`display_name` (required)**
`string`
- **`handler` (required)**
`string`
- **`id` (required)**
`integer`
- **`is_active` (required)**
`boolean`
- **`profile_url` (required)**
`string`
- **`social` (required)**
`string`
- **`analytics_metrics`**
`array`
**Items:**
- **`children`**
`array`
**Items:**
- **`account_id` (required)**
`integer`
- **`analytics` (required)**
`array | null`
- **`cluster_id` (required)**
`string`
- **`content` (required)**
`string`
- **`created_at` (required)**
`string | null`, format: `date-time`
- **`id` (required)**
`integer`
- **`metadata` (required)**
`array | null`
- **`order` (required)**
`integer`
- **`parent_id` (required)**
`integer | null`
- **`published_at` (required)**
`string | null`, format: `date-time`
- **`scheduled_at` (required)**
`string | null`, format: `date-time`
- **`status` (required)**
`integer`, possible values: `0, 1, 2, 3, 4, 5`
- **`updated_at` (required)**
`string | null`, format: `date-time`
- **`user_id` (required)**
`integer`
- **`account`**
`object`
- **`avatar` (required)**
`string | null`
- **`disconnected_at` (required)**
`string`
- **`display_name` (required)**
`string`
- **`handler` (required)**
`string`
- **`id` (required)**
`integer`
- **`is_active` (required)**
`boolean`
- **`profile_url` (required)**
`string`
- **`social` (required)**
`string`
- **`analytics_metrics`**
`array`
**Items:**
- **`children`**
`array`
**Items:**
- **`account_id` (required)**
`integer`
- **`analytics` (required)**
`array | null`
- **`cluster_id` (required)**
`string`
- **`content` (required)**
`string`
- **`created_at` (required)**
`string | null`, format: `date-time`
- **`id` (required)**
`integer`
- **`metadata` (required)**
`array | null`
- **`order` (required)**
`integer`
- **`parent_id` (required)**
`integer | null`
- **`published_at` (required)**
`string | null`, format: `date-time`
- **`scheduled_at` (required)**
`string | null`, format: `date-time`
- **`status` (required)**
`integer`, possible values: `0, 1, 2, 3, 4, 5`
- **`updated_at` (required)**
`string | null`, format: `date-time`
- **`user_id` (required)**
`integer`
- **`account`**
`object`
- **`avatar` (required)**
`string | null`
- **`disconnected_at` (required)**
`string`
- **`display_name` (required)**
`string`
- **`handler` (required)**
`string`
- **`id` (required)**
`integer`
- **`is_active` (required)**
`boolean`
- **`profile_url` (required)**
`string`
- **`social` (required)**
`string`
- **`analytics_metrics`**
`array`
**Items:**
- **`children`**
`array`
**Items:**
- **`account_id` (required)**
`integer`
- **`analytics` (required)**
`array | null`
- **`cluster_id` (required)**
`string`
- **`content` (required)**
`string`
- **`created_at` (required)**
`string | null`, format: `date-time`
- **`id` (required)**
`integer`
- **`metadata` (required)**
`array | null`
- **`order` (required)**
`integer`
- **`parent_id` (required)**
`integer | null`
- **`published_at` (required)**
`string | null`, format: `date-time`
- **`scheduled_at` (required)**
`string | null`, format: `date-time`
- **`status` (required)**
`integer`, possible values: `0, 1, 2, 3, 4, 5`
- **`updated_at` (required)**
`string | null`, format: `date-time`
- **`user_id` (required)**
`integer`
- **`account`**
`object`
- **`avatar` (required)**
`string | null`
- **`disconnected_at` (required)**
`string`
- **`display_name` (required)**
`string`
- **`handler` (required)**
`string`
- **`id` (required)**
`integer`
- **`is_active` (required)**
`boolean`
- **`profile_url` (required)**
`string`
- **`social` (required)**
`string`
- **`analytics_metrics`**
`array`
**Items:**
- **`children`**
`array`
**Items:**
- **`account_id` (required)**
`integer`
- **`analytics` (required)**
`array | null`
- **`cluster_id` (required)**
`string`
- **`content` (required)**
`string`
- **`created_at` (required)**
`string | null`, format: `date-time`
- **`id` (required)**
`integer`
- **`metadata` (required)**
`array | null`
- **`order` (required)**
`integer`
- **`parent_id` (required)**
`integer | null`
- **`published_at` (required)**
`string | null`, format: `date-time`
- **`scheduled_at` (required)**
`string | null`, format: `date-time`
- **`status` (required)**
`integer`, possible values: `0, 1, 2, 3, 4, 5`
- **`updated_at` (required)**
`string | null`, format: `date-time`
- **`user_id` (required)**
`integer`
- **`account`**
`object`
- **`avatar` (required)**
`string | null`
- **`disconnected_at` (required)**
`string`
- **`display_name` (required)**
`string`
- **`handler` (required)**
`string`
- **`id` (required)**
`integer`
- **`is_active` (required)**
`boolean`
- **`profile_url` (required)**
`string`
- **`social` (required)**
`string`
- **`analytics_metrics`**
`array`
**Items:**
- **`children`**
`array`
**Items:**
- **`account_id` (required)**
`integer`
- **`analytics` (required)**
`array | null`
- **`cluster_id` (required)**
`string`
- **`content` (required)**
`string`
- **`created_at` (required)**
`string | null`, format: `date-time`
- **`id` (required)**
`integer`
- **`metadata` (required)**
`array | null`
- **`order` (required)**
`integer`
- **`parent_id` (required)**
`integer | null`
- **`published_at` (required)**
`string | null`, format: `date-time`
- **`scheduled_at` (required)**
`string | null`, format: `date-time`
- **`status` (required)**
`integer`, possible values: `0, 1, 2, 3, 4, 5`
- **`updated_at` (required)**
`string | null`, format: `date-time`
- **`user_id` (required)**
`integer`
- **`account`**
`object`
- **`avatar` (required)**
`string | null`
- **`disconnected_at` (required)**
`string`
- **`display_name` (required)**
`string`
- **`handler` (required)**
`string`
- **`id` (required)**
`integer`
- **`is_active` (required)**
`boolean`
- **`profile_url` (required)**
`string`
- **`social` (required)**
`string`
- **`analytics_metrics`**
`array`
**Items:**
- **`children`**
`array`
**Items:**
- **`account_id` (required)**
`integer`
- **`analytics` (required)**
`array | null`
- **`cluster_id` (required)**
`string`
- **`content` (required)**
`string`
- **`created_at` (required)**
`string | null`, format: `date-time`
- **`id` (required)**
`integer`
- **`metadata` (required)**
`array | null`
- **`order` (required)**
`integer`
- **`parent_id` (required)**
`integer | null`
- **`published_at` (required)**
`string | null`, format: `date-time`
- **`scheduled_at` (required)**
`string | null`, format: `date-time`
- **`status` (required)**
`integer`, possible values: `0, 1, 2, 3, 4, 5`
- **`updated_at` (required)**
`string | null`, format: `date-time`
- **`user_id` (required)**
`integer`
- **`account`**
`object`
- **`avatar` (required)**
`string | null`
- **`disconnected_at` (required)**
`string`
- **`display_name` (required)**
`string`
- **`handler` (required)**
`string`
- **`id` (required)**
`integer`
- **`is_active` (required)**
`boolean`
- **`profile_url` (required)**
`string`
- **`social` (required)**
`string`
- **`analytics_metrics`**
`array`
**Items:**
- **`children`**
`array`
**Items:**
- **`account_id` (required)**
`integer`
- **`analytics` (required)**
`array | null`
- **`cluster_id` (required)**
`string`
- **`content` (required)**
`string`
- **`created_at` (required)**
`string | null`, format: `date-time`
- **`id` (required)**
`integer`
- **`metadata` (required)**
`array | null`
- **`order` (required)**
`integer`
- **`parent_id` (required)**
`integer | null`
- **`published_at` (required)**
`string | null`, format: `date-time`
- **`scheduled_at` (required)**
`string | null`, format: `date-time`
- **`status` (required)**
`integer`, possible values: `0, 1, 2, 3, 4, 5`
- **`updated_at` (required)**
`string | null`, format: `date-time`
- **`user_id` (required)**
`integer`
- **`account`**
`object`
*\[Circular Reference]*
- **`analytics_metrics`**
`array`
**Items:**
*\[Circular Reference]*
- **`children`**
`array`
**Items:**
*\[Circular Reference]*
- **`media`**
`array`
**Items:**
*\[Circular Reference]*
- **`review`**
`object`
- **`scheduled_comments`**
`array`
**Items:**
*\[Circular Reference]*
- **`type`**
`object`
- **`media`**
`array`
**Items:**
- **`alt` (required)**
`string`
- **`height` (required)**
`string`
- **`id` (required)**
`string`
- **`mime` (required)**
`string`
- **`name` (required)**
`string`
- **`order` (required)**
`string`
- **`size` (required)**
`string`
- **`type` (required)**
`string`
- **`url` (required)**
`string`
- **`width` (required)**
`string`
- **`review`**
`object`
- **`scheduled_comments`**
`array`
**Items:**
- **`account_id` (required)**
`integer`
- **`content` (required)**
`string`
- **`created_at` (required)**
`string | null`, format: `date-time`
- **`delay_minutes` (required)**
`integer`
- **`id` (required)**
`integer`
- **`metadata` (required)**
`array | null`
- **`post_id` (required)**
`integer`
- **`published_at` (required)**
`string | null`, format: `date-time`
- **`scheduled_at` (required)**
`string | null`, format: `date-time`
- **`status` (required)**
`integer`, possible values: `0, 1, 2, 3, 4, 5, 6` — | | |---| | \`0\` \
Created, waiting for the parent post to publish before it can be armed. | | \`1\` \
Armed with the parent's remote id and an absolute fire time. | | \`2\` \
| | \`3\` \
| | \`4\` \
| | \`5\` \
Parent post failed, so the comment never armed. | | \`6\` \
Cancelled by the user before publishing. |
- **`updated_at` (required)**
`string | null`, format: `date-time`
- **`type`**
`object`
- **`media`**
`array`
**Items:**
- **`alt` (required)**
`string`
- **`height` (required)**
`string`
- **`id` (required)**
`string`
- **`mime` (required)**
`string`
- **`name` (required)**
`string`
- **`order` (required)**
`string`
- **`size` (required)**
`string`
- **`type` (required)**
`string`
- **`url` (required)**
`string`
- **`width` (required)**
`string`
- **`review`**
`object`
- **`scheduled_comments`**
`array`
**Items:**
- **`account_id` (required)**
`integer`
- **`content` (required)**
`string`
- **`created_at` (required)**
`string | null`, format: `date-time`
- **`delay_minutes` (required)**
`integer`
- **`id` (required)**
`integer`
- **`metadata` (required)**
`array | null`
- **`post_id` (required)**
`integer`
- **`published_at` (required)**
`string | null`, format: `date-time`
- **`scheduled_at` (required)**
`string | null`, format: `date-time`
- **`status` (required)**
`integer`, possible values: `0, 1, 2, 3, 4, 5, 6` — | | |---| | \`0\` \
Created, waiting for the parent post to publish before it can be armed. | | \`1\` \
Armed with the parent's remote id and an absolute fire time. | | \`2\` \
| | \`3\` \
| | \`4\` \
| | \`5\` \
Parent post failed, so the comment never armed. | | \`6\` \
Cancelled by the user before publishing. |
- **`updated_at` (required)**
`string | null`, format: `date-time`
- **`type`**
`object`
- **`media`**
`array`
**Items:**
- **`alt` (required)**
`string`
- **`height` (required)**
`string`
- **`id` (required)**
`string`
- **`mime` (required)**
`string`
- **`name` (required)**
`string`
- **`order` (required)**
`string`
- **`size` (required)**
`string`
- **`type` (required)**
`string`
- **`url` (required)**
`string`
- **`width` (required)**
`string`
- **`review`**
`object`
- **`scheduled_comments`**
`array`
**Items:**
- **`account_id` (required)**
`integer`
- **`content` (required)**
`string`
- **`created_at` (required)**
`string | null`, format: `date-time`
- **`delay_minutes` (required)**
`integer`
- **`id` (required)**
`integer`
- **`metadata` (required)**
`array | null`
- **`post_id` (required)**
`integer`
- **`published_at` (required)**
`string | null`, format: `date-time`
- **`scheduled_at` (required)**
`string | null`, format: `date-time`
- **`status` (required)**
`integer`, possible values: `0, 1, 2, 3, 4, 5, 6` — | | |---| | \`0\` \
Created, waiting for the parent post to publish before it can be armed. | | \`1\` \
Armed with the parent's remote id and an absolute fire time. | | \`2\` \
| | \`3\` \
| | \`4\` \
| | \`5\` \
Parent post failed, so the comment never armed. | | \`6\` \
Cancelled by the user before publishing. |
- **`updated_at` (required)**
`string | null`, format: `date-time`
- **`type`**
`object`
- **`media`**
`array`
**Items:**
- **`alt` (required)**
`string`
- **`height` (required)**
`string`
- **`id` (required)**
`string`
- **`mime` (required)**
`string`
- **`name` (required)**
`string`
- **`order` (required)**
`string`
- **`size` (required)**
`string`
- **`type` (required)**
`string`
- **`url` (required)**
`string`
- **`width` (required)**
`string`
- **`review`**
`object`
- **`scheduled_comments`**
`array`
**Items:**
- **`account_id` (required)**
`integer`
- **`content` (required)**
`string`
- **`created_at` (required)**
`string | null`, format: `date-time`
- **`delay_minutes` (required)**
`integer`
- **`id` (required)**
`integer`
- **`metadata` (required)**
`array | null`
- **`post_id` (required)**
`integer`
- **`published_at` (required)**
`string | null`, format: `date-time`
- **`scheduled_at` (required)**
`string | null`, format: `date-time`
- **`status` (required)**
`integer`, possible values: `0, 1, 2, 3, 4, 5, 6` — | | |---| | \`0\` \
Created, waiting for the parent post to publish before it can be armed. | | \`1\` \
Armed with the parent's remote id and an absolute fire time. | | \`2\` \
| | \`3\` \
| | \`4\` \
| | \`5\` \
Parent post failed, so the comment never armed. | | \`6\` \
Cancelled by the user before publishing. |
- **`updated_at` (required)**
`string | null`, format: `date-time`
- **`type`**
`object`
- **`media`**
`array`
**Items:**
- **`alt` (required)**
`string`
- **`height` (required)**
`string`
- **`id` (required)**
`string`
- **`mime` (required)**
`string`
- **`name` (required)**
`string`
- **`order` (required)**
`string`
- **`size` (required)**
`string`
- **`type` (required)**
`string`
- **`url` (required)**
`string`
- **`width` (required)**
`string`
- **`review`**
`object`
- **`scheduled_comments`**
`array`
**Items:**
- **`account_id` (required)**
`integer`
- **`content` (required)**
`string`
- **`created_at` (required)**
`string | null`, format: `date-time`
- **`delay_minutes` (required)**
`integer`
- **`id` (required)**
`integer`
- **`metadata` (required)**
`array | null`
- **`post_id` (required)**
`integer`
- **`published_at` (required)**
`string | null`, format: `date-time`
- **`scheduled_at` (required)**
`string | null`, format: `date-time`
- **`status` (required)**
`integer`, possible values: `0, 1, 2, 3, 4, 5, 6` — | | |---| | \`0\` \
Created, waiting for the parent post to publish before it can be armed. | | \`1\` \
Armed with the parent's remote id and an absolute fire time. | | \`2\` \
| | \`3\` \
| | \`4\` \
| | \`5\` \
Parent post failed, so the comment never armed. | | \`6\` \
Cancelled by the user before publishing. |
- **`updated_at` (required)**
`string | null`, format: `date-time`
- **`type`**
`object`
- **`media`**
`array`
**Items:**
- **`alt` (required)**
`string`
- **`height` (required)**
`string`
- **`id` (required)**
`string`
- **`mime` (required)**
`string`
- **`name` (required)**
`string`
- **`order` (required)**
`string`
- **`size` (required)**
`string`
- **`type` (required)**
`string`
- **`url` (required)**
`string`
- **`width` (required)**
`string`
- **`review`**
`object`
- **`scheduled_comments`**
`array`
**Items:**
- **`account_id` (required)**
`integer`
- **`content` (required)**
`string`
- **`created_at` (required)**
`string | null`, format: `date-time`
- **`delay_minutes` (required)**
`integer`
- **`id` (required)**
`integer`
- **`metadata` (required)**
`array | null`
- **`post_id` (required)**
`integer`
- **`published_at` (required)**
`string | null`, format: `date-time`
- **`scheduled_at` (required)**
`string | null`, format: `date-time`
- **`status` (required)**
`integer`, possible values: `0, 1, 2, 3, 4, 5, 6` — | | |---| | \`0\` \
Created, waiting for the parent post to publish before it can be armed. | | \`1\` \
Armed with the parent's remote id and an absolute fire time. | | \`2\` \
| | \`3\` \
| | \`4\` \
| | \`5\` \
Parent post failed, so the comment never armed. | | \`6\` \
Cancelled by the user before publishing. |
- **`updated_at` (required)**
`string | null`, format: `date-time`
- **`type`**
`object`
- **`media`**
`array`
**Items:**
- **`alt` (required)**
`string`
- **`height` (required)**
`string`
- **`id` (required)**
`string`
- **`mime` (required)**
`string`
- **`name` (required)**
`string`
- **`order` (required)**
`string`
- **`size` (required)**
`string`
- **`type` (required)**
`string`
- **`url` (required)**
`string`
- **`width` (required)**
`string`
- **`review`**
`object`
- **`scheduled_comments`**
`array`
**Items:**
- **`account_id` (required)**
`integer`
- **`content` (required)**
`string`
- **`created_at` (required)**
`string | null`, format: `date-time`
- **`delay_minutes` (required)**
`integer`
- **`id` (required)**
`integer`
- **`metadata` (required)**
`array | null`
- **`post_id` (required)**
`integer`
- **`published_at` (required)**
`string | null`, format: `date-time`
- **`scheduled_at` (required)**
`string | null`, format: `date-time`
- **`status` (required)**
`integer`, possible values: `0, 1, 2, 3, 4, 5, 6` — | | |---| | \`0\` \
Created, waiting for the parent post to publish before it can be armed. | | \`1\` \
Armed with the parent's remote id and an absolute fire time. | | \`2\` \
| | \`3\` \
| | \`4\` \
| | \`5\` \
Parent post failed, so the comment never armed. | | \`6\` \
Cancelled by the user before publishing. |
- **`updated_at` (required)**
`string | null`, format: `date-time`
- **`type`**
`object`
**Example:**
```json
{
"data": {
"id": 1,
"content": "",
"status": null,
"order": 1,
"scheduled_at": null,
"published_at": null,
"metadata": [],
"type": "",
"cluster_id": "",
"parent_id": null,
"user_id": 1,
"account_id": 1,
"created_at": null,
"updated_at": null,
"analytics": [],
"analytics_metrics": [],
"account": null,
"children": [],
"scheduled_comments": [],
"media": [],
"review": null
}
}
```
##### Status: 401 Unauthenticated
###### Content-Type: application/json
- **`message` (required)**
`string` — Error overview.
**Example:**
```json
{
"message": ""
}
```
##### Status: 403 Authorization error
###### Content-Type: application/json
- **`message` (required)**
`string` — Error overview.
**Example:**
```json
{
"message": ""
}
```
##### Status: 404 Not found
###### Content-Type: application/json
- **`message` (required)**
`string` — Error overview.
**Example:**
```json
{
"message": ""
}
```
##### Status: 422 Validation error
###### Content-Type: application/json
- **`errors` (required)**
`object` — A detailed description of each field that failed validation.
- **`message` (required)**
`string` — Errors overview.
**Example:**
```json
{
"message": "",
"errors": {
"additionalProperty": [
""
]
}
}
```
### Delete a post
- **Method:** `DELETE`
- **Path:** `/spaces/{space}/posts/{post}`
- **Tags:** Post
#### Parameters
##### `space` required
- **In:** `path`
The space ID
`integer`
##### `post` required
- **In:** `path`
The post ID
`integer`
#### Responses
##### Status: 200
###### Content-Type: application/json
**Example:**
```json
{}
```
##### Status: 401 Unauthenticated
###### Content-Type: application/json
- **`message` (required)**
`string` — Error overview.
**Example:**
```json
{
"message": ""
}
```
##### Status: 403 Authorization error
###### Content-Type: application/json
- **`message` (required)**
`string` — Error overview.
**Example:**
```json
{
"message": ""
}
```
##### Status: 404 Not found
###### Content-Type: application/json
- **`message` (required)**
`string` — Error overview.
**Example:**
```json
{
"message": ""
}
```
### Retry publishing a failed post
- **Method:** `POST`
- **Path:** `/spaces/{space}/posts/{post}/retry`
- **Tags:** Post
Resets the post (and any non-published children) from Error to Scheduled, clears the stored error metadata, and re-dispatches the publish job. For threads, already-published children are skipped on retry.
#### Parameters
##### `space` required
- **In:** `path`
The space ID
`integer`
##### `post` required
- **In:** `path`
The post ID
`integer`
#### Responses
##### Status: 200 \`PostResource\`
###### Content-Type: application/json
**Any of:**
- **`data` (required)**
`object`
- **`account_id` (required)**
`integer`
- **`analytics` (required)**
`array | null`
- **`cluster_id` (required)**
`string`
- **`content` (required)**
`string`
- **`created_at` (required)**
`string | null`, format: `date-time`
- **`id` (required)**
`integer`
- **`metadata` (required)**
`array | null`
- **`order` (required)**
`integer`
- **`parent_id` (required)**
`integer | null`
- **`published_at` (required)**
`string | null`, format: `date-time`
- **`scheduled_at` (required)**
`string | null`, format: `date-time`
- **`status` (required)**
`integer`, possible values: `0, 1, 2, 3, 4, 5`
- **`updated_at` (required)**
`string | null`, format: `date-time`
- **`user_id` (required)**
`integer`
- **`account`**
`object`
- **`avatar` (required)**
`string | null`
- **`disconnected_at` (required)**
`string`
- **`display_name` (required)**
`string`
- **`handler` (required)**
`string`
- **`id` (required)**
`integer`
- **`is_active` (required)**
`boolean`
- **`profile_url` (required)**
`string`
- **`social` (required)**
`string`
- **`analytics_metrics`**
`array`
**Items:**
- **`children`**
`array`
**Items:**
- **`account_id` (required)**
`integer`
- **`analytics` (required)**
`array | null`
- **`cluster_id` (required)**
`string`
- **`content` (required)**
`string`
- **`created_at` (required)**
`string | null`, format: `date-time`
- **`id` (required)**
`integer`
- **`metadata` (required)**
`array | null`
- **`order` (required)**
`integer`
- **`parent_id` (required)**
`integer | null`
- **`published_at` (required)**
`string | null`, format: `date-time`
- **`scheduled_at` (required)**
`string | null`, format: `date-time`
- **`status` (required)**
`integer`, possible values: `0, 1, 2, 3, 4, 5`
- **`updated_at` (required)**
`string | null`, format: `date-time`
- **`user_id` (required)**
`integer`
- **`account`**
`object`
- **`avatar` (required)**
`string | null`
- **`disconnected_at` (required)**
`string`
- **`display_name` (required)**
`string`
- **`handler` (required)**
`string`
- **`id` (required)**
`integer`
- **`is_active` (required)**
`boolean`
- **`profile_url` (required)**
`string`
- **`social` (required)**
`string`
- **`analytics_metrics`**
`array`
**Items:**
- **`children`**
`array`
**Items:**
- **`account_id` (required)**
`integer`
- **`analytics` (required)**
`array | null`
- **`cluster_id` (required)**
`string`
- **`content` (required)**
`string`
- **`created_at` (required)**
`string | null`, format: `date-time`
- **`id` (required)**
`integer`
- **`metadata` (required)**
`array | null`
- **`order` (required)**
`integer`
- **`parent_id` (required)**
`integer | null`
- **`published_at` (required)**
`string | null`, format: `date-time`
- **`scheduled_at` (required)**
`string | null`, format: `date-time`
- **`status` (required)**
`integer`, possible values: `0, 1, 2, 3, 4, 5`
- **`updated_at` (required)**
`string | null`, format: `date-time`
- **`user_id` (required)**
`integer`
- **`account`**
`object`
- **`avatar` (required)**
`string | null`
- **`disconnected_at` (required)**
`string`
- **`display_name` (required)**
`string`
- **`handler` (required)**
`string`
- **`id` (required)**
`integer`
- **`is_active` (required)**
`boolean`
- **`profile_url` (required)**
`string`
- **`social` (required)**
`string`
- **`analytics_metrics`**
`array`
**Items:**
- **`children`**
`array`
**Items:**
- **`account_id` (required)**
`integer`
- **`analytics` (required)**
`array | null`
- **`cluster_id` (required)**
`string`
- **`content` (required)**
`string`
- **`created_at` (required)**
`string | null`, format: `date-time`
- **`id` (required)**
`integer`
- **`metadata` (required)**
`array | null`
- **`order` (required)**
`integer`
- **`parent_id` (required)**
`integer | null`
- **`published_at` (required)**
`string | null`, format: `date-time`
- **`scheduled_at` (required)**
`string | null`, format: `date-time`
- **`status` (required)**
`integer`, possible values: `0, 1, 2, 3, 4, 5`
- **`updated_at` (required)**
`string | null`, format: `date-time`
- **`user_id` (required)**
`integer`
- **`account`**
`object`
- **`avatar` (required)**
`string | null`
- **`disconnected_at` (required)**
`string`
- **`display_name` (required)**
`string`
- **`handler` (required)**
`string`
- **`id` (required)**
`integer`
- **`is_active` (required)**
`boolean`
- **`profile_url` (required)**
`string`
- **`social` (required)**
`string`
- **`analytics_metrics`**
`array`
**Items:**
- **`children`**
`array`
**Items:**
- **`account_id` (required)**
`integer`
- **`analytics` (required)**
`array | null`
- **`cluster_id` (required)**
`string`
- **`content` (required)**
`string`
- **`created_at` (required)**
`string | null`, format: `date-time`
- **`id` (required)**
`integer`
- **`metadata` (required)**
`array | null`
- **`order` (required)**
`integer`
- **`parent_id` (required)**
`integer | null`
- **`published_at` (required)**
`string | null`, format: `date-time`
- **`scheduled_at` (required)**
`string | null`, format: `date-time`
- **`status` (required)**
`integer`, possible values: `0, 1, 2, 3, 4, 5`
- **`updated_at` (required)**
`string | null`, format: `date-time`
- **`user_id` (required)**
`integer`
- **`account`**
`object`
- **`avatar` (required)**
`string | null`
- **`disconnected_at` (required)**
`string`
- **`display_name` (required)**
`string`
- **`handler` (required)**
`string`
- **`id` (required)**
`integer`
- **`is_active` (required)**
`boolean`
- **`profile_url` (required)**
`string`
- **`social` (required)**
`string`
- **`analytics_metrics`**
`array`
**Items:**
- **`children`**
`array`
**Items:**
- **`account_id` (required)**
`integer`
- **`analytics` (required)**
`array | null`
- **`cluster_id` (required)**
`string`
- **`content` (required)**
`string`
- **`created_at` (required)**
`string | null`, format: `date-time`
- **`id` (required)**
`integer`
- **`metadata` (required)**
`array | null`
- **`order` (required)**
`integer`
- **`parent_id` (required)**
`integer | null`
- **`published_at` (required)**
`string | null`, format: `date-time`
- **`scheduled_at` (required)**
`string | null`, format: `date-time`
- **`status` (required)**
`integer`, possible values: `0, 1, 2, 3, 4, 5`
- **`updated_at` (required)**
`string | null`, format: `date-time`
- **`user_id` (required)**
`integer`
- **`account`**
`object`
- **`avatar` (required)**
`string | null`
- **`disconnected_at` (required)**
`string`
- **`display_name` (required)**
`string`
- **`handler` (required)**
`string`
- **`id` (required)**
`integer`
- **`is_active` (required)**
`boolean`
- **`profile_url` (required)**
`string`
- **`social` (required)**
`string`
- **`analytics_metrics`**
`array`
**Items:**
- **`children`**
`array`
**Items:**
- **`account_id` (required)**
`integer`
- **`analytics` (required)**
`array | null`
- **`cluster_id` (required)**
`string`
- **`content` (required)**
`string`
- **`created_at` (required)**
`string | null`, format: `date-time`
- **`id` (required)**
`integer`
- **`metadata` (required)**
`array | null`
- **`order` (required)**
`integer`
- **`parent_id` (required)**
`integer | null`
- **`published_at` (required)**
`string | null`, format: `date-time`
- **`scheduled_at` (required)**
`string | null`, format: `date-time`
- **`status` (required)**
`integer`, possible values: `0, 1, 2, 3, 4, 5`
- **`updated_at` (required)**
`string | null`, format: `date-time`
- **`user_id` (required)**
`integer`
- **`account`**
`object`
- **`avatar` (required)**
`string | null`
- **`disconnected_at` (required)**
`string`
- **`display_name` (required)**
`string`
- **`handler` (required)**
`string`
- **`id` (required)**
`integer`
- **`is_active` (required)**
`boolean`
- **`profile_url` (required)**
`string`
- **`social` (required)**
`string`
- **`analytics_metrics`**
`array`
**Items:**
- **`children`**
`array`
**Items:**
- **`account_id` (required)**
`integer`
- **`analytics` (required)**
`array | null`
- **`cluster_id` (required)**
`string`
- **`content` (required)**
`string`
- **`created_at` (required)**
`string | null`, format: `date-time`
- **`id` (required)**
`integer`
- **`metadata` (required)**
`array | null`
- **`order` (required)**
`integer`
- **`parent_id` (required)**
`integer | null`
- **`published_at` (required)**
`string | null`, format: `date-time`
- **`scheduled_at` (required)**
`string | null`, format: `date-time`
- **`status` (required)**
`integer`, possible values: `0, 1, 2, 3, 4, 5`
- **`updated_at` (required)**
`string | null`, format: `date-time`
- **`user_id` (required)**
`integer`
- **`account`**
`object`
*\[Circular Reference]*
- **`analytics_metrics`**
`array`
**Items:**
*\[Circular Reference]*
- **`children`**
`array`
**Items:**
*\[Circular Reference]*
- **`media`**
`array`
**Items:**
*\[Circular Reference]*
- **`review`**
`object`
- **`scheduled_comments`**
`array`
**Items:**
*\[Circular Reference]*
- **`type`**
`object`
- **`media`**
`array`
**Items:**
- **`alt` (required)**
`string`
- **`height` (required)**
`string`
- **`id` (required)**
`string`
- **`mime` (required)**
`string`
- **`name` (required)**
`string`
- **`order` (required)**
`string`
- **`size` (required)**
`string`
- **`type` (required)**
`string`
- **`url` (required)**
`string`
- **`width` (required)**
`string`
- **`review`**
`object`
- **`scheduled_comments`**
`array`
**Items:**
- **`account_id` (required)**
`integer`
- **`content` (required)**
`string`
- **`created_at` (required)**
`string | null`, format: `date-time`
- **`delay_minutes` (required)**
`integer`
- **`id` (required)**
`integer`
- **`metadata` (required)**
`array | null`
- **`post_id` (required)**
`integer`
- **`published_at` (required)**
`string | null`, format: `date-time`
- **`scheduled_at` (required)**
`string | null`, format: `date-time`
- **`status` (required)**
`integer`, possible values: `0, 1, 2, 3, 4, 5, 6` — | | |---| | \`0\` \
Created, waiting for the parent post to publish before it can be armed. | | \`1\` \
Armed with the parent's remote id and an absolute fire time. | | \`2\` \
| | \`3\` \
| | \`4\` \
| | \`5\` \
Parent post failed, so the comment never armed. | | \`6\` \
Cancelled by the user before publishing. |
- **`updated_at` (required)**
`string | null`, format: `date-time`
- **`type`**
`object`
- **`media`**
`array`
**Items:**
- **`alt` (required)**
`string`
- **`height` (required)**
`string`
- **`id` (required)**
`string`
- **`mime` (required)**
`string`
- **`name` (required)**
`string`
- **`order` (required)**
`string`
- **`size` (required)**
`string`
- **`type` (required)**
`string`
- **`url` (required)**
`string`
- **`width` (required)**
`string`
- **`review`**
`object`
- **`scheduled_comments`**
`array`
**Items:**
- **`account_id` (required)**
`integer`
- **`content` (required)**
`string`
- **`created_at` (required)**
`string | null`, format: `date-time`
- **`delay_minutes` (required)**
`integer`
- **`id` (required)**
`integer`
- **`metadata` (required)**
`array | null`
- **`post_id` (required)**
`integer`
- **`published_at` (required)**
`string | null`, format: `date-time`
- **`scheduled_at` (required)**
`string | null`, format: `date-time`
- **`status` (required)**
`integer`, possible values: `0, 1, 2, 3, 4, 5, 6` — | | |---| | \`0\` \
Created, waiting for the parent post to publish before it can be armed. | | \`1\` \
Armed with the parent's remote id and an absolute fire time. | | \`2\` \
| | \`3\` \
| | \`4\` \
| | \`5\` \
Parent post failed, so the comment never armed. | | \`6\` \
Cancelled by the user before publishing. |
- **`updated_at` (required)**
`string | null`, format: `date-time`
- **`type`**
`object`
- **`media`**
`array`
**Items:**
- **`alt` (required)**
`string`
- **`height` (required)**
`string`
- **`id` (required)**
`string`
- **`mime` (required)**
`string`
- **`name` (required)**
`string`
- **`order` (required)**
`string`
- **`size` (required)**
`string`
- **`type` (required)**
`string`
- **`url` (required)**
`string`
- **`width` (required)**
`string`
- **`review`**
`object`
- **`scheduled_comments`**
`array`
**Items:**
- **`account_id` (required)**
`integer`
- **`content` (required)**
`string`
- **`created_at` (required)**
`string | null`, format: `date-time`
- **`delay_minutes` (required)**
`integer`
- **`id` (required)**
`integer`
- **`metadata` (required)**
`array | null`
- **`post_id` (required)**
`integer`
- **`published_at` (required)**
`string | null`, format: `date-time`
- **`scheduled_at` (required)**
`string | null`, format: `date-time`
- **`status` (required)**
`integer`, possible values: `0, 1, 2, 3, 4, 5, 6` — | | |---| | \`0\` \
Created, waiting for the parent post to publish before it can be armed. | | \`1\` \
Armed with the parent's remote id and an absolute fire time. | | \`2\` \
| | \`3\` \
| | \`4\` \
| | \`5\` \
Parent post failed, so the comment never armed. | | \`6\` \
Cancelled by the user before publishing. |
- **`updated_at` (required)**
`string | null`, format: `date-time`
- **`type`**
`object`
- **`media`**
`array`
**Items:**
- **`alt` (required)**
`string`
- **`height` (required)**
`string`
- **`id` (required)**
`string`
- **`mime` (required)**
`string`
- **`name` (required)**
`string`
- **`order` (required)**
`string`
- **`size` (required)**
`string`
- **`type` (required)**
`string`
- **`url` (required)**
`string`
- **`width` (required)**
`string`
- **`review`**
`object`
- **`scheduled_comments`**
`array`
**Items:**
- **`account_id` (required)**
`integer`
- **`content` (required)**
`string`
- **`created_at` (required)**
`string | null`, format: `date-time`
- **`delay_minutes` (required)**
`integer`
- **`id` (required)**
`integer`
- **`metadata` (required)**
`array | null`
- **`post_id` (required)**
`integer`
- **`published_at` (required)**
`string | null`, format: `date-time`
- **`scheduled_at` (required)**
`string | null`, format: `date-time`
- **`status` (required)**
`integer`, possible values: `0, 1, 2, 3, 4, 5, 6` — | | |---| | \`0\` \
Created, waiting for the parent post to publish before it can be armed. | | \`1\` \
Armed with the parent's remote id and an absolute fire time. | | \`2\` \
| | \`3\` \
| | \`4\` \
| | \`5\` \
Parent post failed, so the comment never armed. | | \`6\` \
Cancelled by the user before publishing. |
- **`updated_at` (required)**
`string | null`, format: `date-time`
- **`type`**
`object`
- **`media`**
`array`
**Items:**
- **`alt` (required)**
`string`
- **`height` (required)**
`string`
- **`id` (required)**
`string`
- **`mime` (required)**
`string`
- **`name` (required)**
`string`
- **`order` (required)**
`string`
- **`size` (required)**
`string`
- **`type` (required)**
`string`
- **`url` (required)**
`string`
- **`width` (required)**
`string`
- **`review`**
`object`
- **`scheduled_comments`**
`array`
**Items:**
- **`account_id` (required)**
`integer`
- **`content` (required)**
`string`
- **`created_at` (required)**
`string | null`, format: `date-time`
- **`delay_minutes` (required)**
`integer`
- **`id` (required)**
`integer`
- **`metadata` (required)**
`array | null`
- **`post_id` (required)**
`integer`
- **`published_at` (required)**
`string | null`, format: `date-time`
- **`scheduled_at` (required)**
`string | null`, format: `date-time`
- **`status` (required)**
`integer`, possible values: `0, 1, 2, 3, 4, 5, 6` — | | |---| | \`0\` \
Created, waiting for the parent post to publish before it can be armed. | | \`1\` \
Armed with the parent's remote id and an absolute fire time. | | \`2\` \
| | \`3\` \
| | \`4\` \
| | \`5\` \
Parent post failed, so the comment never armed. | | \`6\` \
Cancelled by the user before publishing. |
- **`updated_at` (required)**
`string | null`, format: `date-time`
- **`type`**
`object`
- **`media`**
`array`
**Items:**
- **`alt` (required)**
`string`
- **`height` (required)**
`string`
- **`id` (required)**
`string`
- **`mime` (required)**
`string`
- **`name` (required)**
`string`
- **`order` (required)**
`string`
- **`size` (required)**
`string`
- **`type` (required)**
`string`
- **`url` (required)**
`string`
- **`width` (required)**
`string`
- **`review`**
`object`
- **`scheduled_comments`**
`array`
**Items:**
- **`account_id` (required)**
`integer`
- **`content` (required)**
`string`
- **`created_at` (required)**
`string | null`, format: `date-time`
- **`delay_minutes` (required)**
`integer`
- **`id` (required)**
`integer`
- **`metadata` (required)**
`array | null`
- **`post_id` (required)**
`integer`
- **`published_at` (required)**
`string | null`, format: `date-time`
- **`scheduled_at` (required)**
`string | null`, format: `date-time`
- **`status` (required)**
`integer`, possible values: `0, 1, 2, 3, 4, 5, 6` — | | |---| | \`0\` \
Created, waiting for the parent post to publish before it can be armed. | | \`1\` \
Armed with the parent's remote id and an absolute fire time. | | \`2\` \
| | \`3\` \
| | \`4\` \
| | \`5\` \
Parent post failed, so the comment never armed. | | \`6\` \
Cancelled by the user before publishing. |
- **`updated_at` (required)**
`string | null`, format: `date-time`
- **`type`**
`object`
- **`media`**
`array`
**Items:**
- **`alt` (required)**
`string`
- **`height` (required)**
`string`
- **`id` (required)**
`string`
- **`mime` (required)**
`string`
- **`name` (required)**
`string`
- **`order` (required)**
`string`
- **`size` (required)**
`string`
- **`type` (required)**
`string`
- **`url` (required)**
`string`
- **`width` (required)**
`string`
- **`review`**
`object`
- **`scheduled_comments`**
`array`
**Items:**
- **`account_id` (required)**
`integer`
- **`content` (required)**
`string`
- **`created_at` (required)**
`string | null`, format: `date-time`
- **`delay_minutes` (required)**
`integer`
- **`id` (required)**
`integer`
- **`metadata` (required)**
`array | null`
- **`post_id` (required)**
`integer`
- **`published_at` (required)**
`string | null`, format: `date-time`
- **`scheduled_at` (required)**
`string | null`, format: `date-time`
- **`status` (required)**
`integer`, possible values: `0, 1, 2, 3, 4, 5, 6` — | | |---| | \`0\` \
Created, waiting for the parent post to publish before it can be armed. | | \`1\` \
Armed with the parent's remote id and an absolute fire time. | | \`2\` \
| | \`3\` \
| | \`4\` \
| | \`5\` \
Parent post failed, so the comment never armed. | | \`6\` \
Cancelled by the user before publishing. |
- **`updated_at` (required)**
`string | null`, format: `date-time`
- **`type`**
`object`
**Example:**
```json
{
"data": {
"id": 1,
"content": "",
"status": null,
"order": 1,
"scheduled_at": null,
"published_at": null,
"metadata": [],
"type": "",
"cluster_id": "",
"parent_id": null,
"user_id": 1,
"account_id": 1,
"created_at": null,
"updated_at": null,
"analytics": [],
"analytics_metrics": [],
"account": null,
"children": [],
"scheduled_comments": [],
"media": [],
"review": null
}
}
```
##### Status: 401 Unauthenticated
###### Content-Type: application/json
- **`message` (required)**
`string` — Error overview.
**Example:**
```json
{
"message": ""
}
```
##### Status: 403 Authorization error
###### Content-Type: application/json
- **`message` (required)**
`string` — Error overview.
**Example:**
```json
{
"message": ""
}
```
##### Status: 404 Not found
###### Content-Type: application/json
- **`message` (required)**
`string` — Error overview.
**Example:**
```json
{
"message": ""
}
```
##### Status: 422 Validation error
###### Content-Type: application/json
- **`errors` (required)**
`object` — A detailed description of each field that failed validation.
- **`message` (required)**
`string` — Errors overview.
**Example:**
```json
{
"message": "",
"errors": {
"additionalProperty": [
""
]
}
}
```