API reference

A REST API over JSON. One base URL, bearer auth, predictable resources.

https://api.cutedyno.com

OpenAPI (always in sync with the server): /docs/api/openapi.json.

Conventions

See Authentication, Idempotency, Errors, Rate limits.

Pagination

Two styles, depending on the resource:

Offset pagination — posts, events, logs. Send page and limit, read total and hasMore:

const { posts, hasMore } = await cutedyno.posts.list({ page: 2, limit: 50 });

Or let the SDK walk it for you:

for await (const post of cutedyno.posts.iterate({ status: 'failed' })) {
  console.log(post.id);
}

Cursor pagination — comments, which change while you read them. Send cursor from the previous response's nextCursor, and stop when it is null.

limit is capped at 100 everywhere. Requesting more is not an error; you get 100.

Status values

A post moves through these:

partially_published is the one people forget. Posting one video to five platforms means five independent uploads with five sets of rules, and a duration that TikTok accepts may exceed what another allows. Treat it as an expected outcome: read results, and retry only what failed.

Endpoints