> ## 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.

# Schedule a post

> Schedule a future post with the PostOnce Public API.

Add `publish_at` to create a scheduled post.

```bash theme={null}
curl -s \
  -H "Authorization: Bearer po_live_xxxxx_xxxxx" \
  -H "Content-Type: application/json" \
  -H "Idempotency-Key: scheduled-launch-001" \
  -X POST https://postonce.to/api/public/v1/posts \
  -d '{
    "content": "Scheduled launch note",
    "publish_at": "2026-04-01T14:00:00.000Z",
    "targets": [
      { "account_id": "account-1" }
    ]
  }'
```

## Supported follow-up actions

* `GET /v1/posts/{id}` to inspect the aggregate scheduled post
* `PATCH /v1/posts/{id}` to update it before it runs
* `POST /v1/posts/{id}/publish` to run it now
* `POST /v1/posts/{id}/cancel` or `DELETE /v1/posts/{id}` to cancel it