> ## Documentation Index
> Fetch the complete documentation index at: https://api-docs.hrizn.io/llms.txt
> Use this file to discover all available pages before exploring further.

# social:write

> Create, schedule, update, delete, unpublish, and retry social posts

<code>social:write</code>

The `social:write` scope allows managing social posts across all connected
platforms (X, Facebook, Instagram, LinkedIn, Google Business Profile). A single
post can target multiple platforms via the `platforms[]` array; publishing and
scheduling are delegated to Zernio and reflected asynchronously via
`social.post.*` webhooks.

## Endpoints

| Method   | Path                                  | Description                        |
| -------- | ------------------------------------- | ---------------------------------- |
| `POST`   | `/public/social/posts`                | Create / schedule / publish a post |
| `PATCH`  | `/public/social/posts/{id}`           | Update a draft or scheduled post   |
| `DELETE` | `/public/social/posts/{id}`           | Delete or cancel a post            |
| `POST`   | `/public/social/posts/{id}/unpublish` | Unpublish a platform target        |
| `POST`   | `/public/social/posts/{id}/retry`     | Republish a failed/cancelled post  |

## Error response — Missing scope

```json theme={"theme":{"light":"github-light","dark":"github-dark"}}
{
  "error": {
    "code": "forbidden",
    "message": "This API key requires one of the following scopes: social:write",
    "details": {
      "required_scopes": ["social:write"]
    }
  }
}
```