ReferencePlatform API v1

Platform REST API

A scoped JSON and multipart API at one versioned origin, with canonical errors, cursor pagination, and explicit idempotency.

Protocol essentials

Base URL: https://api.autocontentapi.com/v1.
Authenticate with Authorization: Bearer <Platform API key or OAuth access token>.
Send Content-Type: application/json except documented multipart uploads.
Send Idempotency-Key on keyed mutations and retain it through recovery.
Use limit and opaque cursor; one response never implies all later pages were fetched.

Account check

shell

curl https://api.autocontentapi.com/v1/account \
  --header "Authorization: Bearer $AUTOCONTENT_API_KEY"

Resource surface

Area	Endpoints	Required scope
Projects	`POST/GET /projects`, `GET/PATCH/DELETE /projects/{id}`, refresh and logo routes	`platform.read` or `platform.write`
Knowledge	Project collections and Sources; URL, text, or multipart upload	`platform.read` or `platform.write`
Discovery	`GET /asset-types`, `/models`, `/voices`, `/avatars`	`platform.read`
Generations	Preview, create, list, get, cancel, and full-Asset edit routes	`platform.generate` or `platform.read`
Assets	`GET /assets`, `GET /assets/{id}`, usefulness feedback	`platform.read` or `platform.write`
Content Loops	Create, list, get, update, archive, run, run history, and feedback	`platform.read`, `platform.write`, `platform.generate`
Account	Account, API keys, usage, and prepaid Checkout	Account-specific scopes
Webhooks	Create, list, and revoke destinations	`platform.write`

Machine-readable contract

Download the OpenAPI 3.1 document for exact request, response, schema, enum, scope, and error definitions. The live Asset and model discovery endpoints remain authoritative for activated catalog capabilities.

OpenAPI

text

https://autocontentapi.com/openapi/autocontent-platform-v1.json