Atomizations

Create several atomizations for one article

Queues up to four channel formats for a single content item in one call. Requires the write:atomize scope.

Same gate order as POST /atomizations: body validation, then the plan gate (professional or higher), then the 20/hour per organization+user and 50/hour per organization limiters, then billing. types must be a non-empty array of at most 4 entries; unknown type values come back as a 400 with param: "input".

Billing is one charge for the whole batch, taken lazily just before the first type that actually dispatches — so a batch in which every type is already in flight costs nothing. overage_incurred is therefore a single flag for the call, not one per type.

Each type is processed sequentially: a row already at generating is reported back unchanged and skipped (no second dispatch), any other row is reset to generating, and new rows are inserted. Every dispatched type fires its own atomization/create background event, so the 201 means "queued", not "generated" — poll GET /atomizations/{id} for each returned id. There is no transaction across the loop: a mid-loop failure can leave some types queued and the ledger charged, but a retry is free within the same billing period.

post/atomizations/batch

Request

  • Base URL: https://next.frase.io/api/v1
  • URL: https://next.frase.io/api/v1/atomizations/batch
  • Auth: API key in header X-API-KEY

Request body

content_idstring uuid required

Required. The content item to atomize. Must be a UUID belonging to your organization.

typesstring[] required

Required. 1-4 channel formats to produce.

Response

Batch queued

Changes

No recorded changes to this operation across all 1 revision of this API.