Run Promarkia squads from your product or automation stack

1. Create an API key in Settings.
2. Use the request builder below to create a digest-bound draft-only request.
3. Submit it once with the generated idempotency key.
4. Poll the returned run ID until completed or error.
5. Inspect the result, final credit settlement, and any external-action receipt.

import { buildDraftOnlyRequest } from 'https://www.promarkia.com/external-api/promarkia-request-builder.mjs';

const request = await buildDraftOnlyRequest({
  squadId: '12',
  userPrompt: 'Draft an evidence-backed WordPress outline. Do not publish it.'
});

const response = await fetch('https://www.promarkia.com/api/external/tasks', {
  method: 'POST', headers: request.headers, body: JSON.stringify(request.body)
});
const accepted = await response.json();
const result = await fetch(`https://www.promarkia.com/api/external/runs/${accepted.runId}`, {
  headers: { 'X-API-Key': request.headers['X-API-Key'] }
}).then((value) => value.json());

Complete request · Processing response · Completed response · Redacted action receipt · OpenAPI 3.1

Retries and errors

Reuse the same idempotency key only for the exact same body. A changed body requires a new UUID and digest. Never retry an ambiguous external write until its run receipt is checked.