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

# Errors

> Understand the PostOnce Public API response envelope and common error codes.

Successful responses use:

```json theme={null}
{
  "data": {}
}
```

Errors use:

```json theme={null}
{
  "error": {
    "code": "missing_scope",
    "message": "Missing required scope: posts:write"
  }
}
```

## Common error codes

* `invalid_api_key`
* `missing_scope`
* `plan_not_allowed`
* `account_limit_reached`
* `workflow_limit_reached`
* `invalid_targets`
* `inactive_target`
* `invalid_media_id`