# NOWScale API

> The NOWScale REST API: schedule and publish posts to every connected network, upload media, follow publishing, answer comments and receive signed webhooks.

Every page is Markdown at the address below. The whole documentation is one file at /llms-full.txt, and the OpenAPI 3.1 description is /openapi.json.

## Get started

- [NOWScale API](https://docs.nowscale.dev/index.md): Schedule and publish posts, upload media, answer comments and read analytics from your own code or AI tools.
- [Quickstart](https://docs.nowscale.dev/quickstart.md): Create an API key, check it, and schedule your first post.
- [Authentication](https://docs.nowscale.dev/authentication.md): Workspace keys and personal keys, permissions, Project limits, IP rules and rotation.
- [Use with AI tools](https://docs.nowscale.dev/ai.md): Markdown versions of every page, llms.txt, and instructions to give your coding agent.

## Guides

- [Publish posts](https://docs.nowscale.dev/posts.md): Drafts and schedules, one post to many accounts, approvals, per-network settings and TikTok consent.
- [Upload media](https://docs.nowscale.dev/media.md): Images and thumbnails in one PUT, videos in parts, then attach them to posts.
- [Answer comments](https://docs.nowscale.dev/comments.md): Read comment threads, reply and moderate, safely against changes on the network.
- [Webhooks](https://docs.nowscale.dev/webhooks.md): Signed events sent to your server, how to verify them, retries and secret rotation.
- [Sandboxes and test mode](https://docs.nowscale.dev/sandboxes.md): Test keys, test accounts, presets, magic values and test helpers, without reaching a network.
- [AI operations and Tokens](https://docs.nowscale.dev/ai-operations.md): Paid AI through the API, max_tokens, prices, per-key caps and what a sandbox does instead.

## Concepts

- [Making requests](https://docs.nowscale.dev/requests.md): JSON in and out, request ids, versions, pagination and idempotency.
- [Errors](https://docs.nowscale.dev/errors.md): Problem details, stable codes and what to do about each one.
- [Rate limits](https://docs.nowscale.dev/rate-limits.md): Requests per minute per plan, per key, and the headers that tell you where you stand.
- [Versioning](https://docs.nowscale.dev/versioning.md): Dated API versions, what can change within one, and how you hear about changes.
- [Changelog](https://docs.nowscale.dev/changelog.md): What changed in the API, by version and date.

## API reference

- [Keys](https://docs.nowscale.dev/reference/keys.md): 1 endpoint: retrieve the current key.
- [Workspace](https://docs.nowscale.dev/reference/workspace.md): 1 endpoint: retrieve the workspace.
- [Projects](https://docs.nowscale.dev/reference/projects.md): 2 endpoints: list projects, retrieve a project.
- [Networks](https://docs.nowscale.dev/reference/networks.md): 1 endpoint: list networks and their rules.
- [Accounts](https://docs.nowscale.dev/reference/accounts.md): 2 endpoints: list connected accounts, retrieve an account.
- [Analytics](https://docs.nowscale.dev/reference/analytics.md): 2 endpoints: retrieve an account's analytics summary, retrieve a post's metrics.
- [Posts](https://docs.nowscale.dev/reference/posts.md): 8 endpoints: list posts, retrieve a post, create a post, update a post, unschedule a post, publish a post now, duplicate a post, delete a post.
- [Media](https://docs.nowscale.dev/reference/media.md): 5 endpoints: list media, retrieve media, start a media upload, sign video upload parts, complete a media upload.
- [Comments](https://docs.nowscale.dev/reference/comments.md): 4 endpoints: list comment threads, retrieve a comment thread, reply to a comment thread, moderate a comment.
- [Reviews](https://docs.nowscale.dev/reference/reviews.md): 3 endpoints: send a post for review, approve a post, reject a post.
- [Events](https://docs.nowscale.dev/reference/events.md): 2 endpoints: list events, retrieve an event.
- [Webhooks](https://docs.nowscale.dev/reference/webhooks.md): 9 endpoints: list webhook endpoints, create a webhook endpoint, retrieve a webhook endpoint, update a webhook endpoint, delete a webhook endpoint, roll a webhook secret, send a test event, list deliveries, retry a delivery.
- [Usage](https://docs.nowscale.dev/reference/usage.md): 1 endpoint: retrieve api usage.
- [AI](https://docs.nowscale.dev/reference/ai.md): 1 endpoint: draft a reply to a comment.
- [Test helpers](https://docs.nowscale.dev/reference/test-helpers.md): 3 endpoints: add a test account, change a test account's behaviour, advance a post.

## Optional

- [OpenAPI 3.1](https://docs.nowscale.dev/openapi.json): every endpoint, schema and webhook in one machine-readable file.