Transmutify Docs
POSThttps://api.transmutify.io/v1/transformations/raw

Start a raw-content transformation run

Stores the submitted `content`, creates a queued review-stage run, and dispatches review preparation immediately. Use this endpoint when callers can send the full input body in the API request instead of uploading a file.

Requires a bearer token. Learn more about authentication

Request body

Send as application/json

schema_idstring required

Target schema UUID that defines the desired output fields for this raw transformation.

provider_idstring required

AI provider UUID required for the raw flow. Dry-runs keep this shape but do not call the provider.

contentstring required

Raw source content to transform. In non-dry-runs this content is sent to the configured AI provider.

Max length: 50,000 characters

dry_runboolean

When true, generate synthetic schema-shaped output instead of sending raw content to AI.

output_formatstring

Output artifact format for the immediately queued final run. Defaults to JSON when omitted.

jsoncsv

notify_urlstring | null

Optional webhook URL for transformation completion notifications. Production callbacks must use HTTPS.

success_callbackstring | null

Optional hosted-review success callback used after a reviewer approves the review. Production callback URLs must use HTTPS.

cancel_callbackstring | null

Optional hosted-review cancel callback used after a reviewer cancels the review. Production callback URLs must use HTTPS.

localestring | null

Optional locale for the hosted review UI translations. Case-insensitive; unsupported values fall back to `en`.

endefrnlesitplar

appearancestring | null

Optional hosted-review appearance persisted for all review interactions.

lightdark

metadataobject | null

Optional caller-defined metadata JSON object echoed in transformation responses and customer webhooks.

column_labelsobject | null

Optional JSON object keyed by schema field name. Values override the labels shown in the hosted Review UI.

Responses

idstring required

Stable UUID of the transformation run. Use this in subsequent requests against the run.

statusstring required

Current lifecycle status. File runs start as `awaiting_upload`; raw runs start as `queued`.

stagestring required

Current stage of the run. Create responses start in `review`.

input_sourcestring required

Input source for this run (`upload`, `raw`, or `image`).

schema_idstring required

UUID of the schema this run targets.

review_urlstring required

Signed hosted-review URL for end-user review.

cURL
curl -X POST 'https://api.transmutify.io/v1/transformations/raw' \
  -H 'Authorization: Bearer <api-key>' \
  -H 'Content-Type: application/json' \
  -d '{
    "schema_id": "9b2e1f6c-8e6d-4a3b-9c1f-7d2e5a8b3c4d",
    "provider_id": "9b2e1f6c-8e6d-4a3b-9c1f-7d2e5a8b3c4d",
    "content": "string",
    "dry_run": false,
    "output_format": "json",
    "notify_url": "https://example.com/webhooks/transmutify",
    "success_callback": "https://example.com/webhooks/transmutify",
    "cancel_callback": "https://example.com/webhooks/transmutify",
    "locale": "en",
    "appearance": "light",
    "metadata": {
      "external_id": "import-2026-01-15",
      "source": {
        "system": "hris",
        "batch": 42
      }
    },
    "column_labels": {
      "employee_id": "Employee ID",
      "work_email": "Work email",
      "department": "Department"
    }
  }'
Response · 201
{
  "id": "019dc45d-3b81-7369-a776-2d95c5caab97",
  "status": "queued",
  "stage": "review",
  "input_source": "raw",
  "schema_id": "019dc458-710e-73a0-9b5a-bb7d6f7ddc42",
  "review_url": "https://review.transmutify.io/reviews/019dc45d-3b81-7369-a776-2d95c5caab97?signature=..."
}