Praxa Execution Fabric: Quickstart

curl -X POST https://api.praxa.io/api/custom-agent-run \
  -H "Authorization: Bearer <custom-agent-deployment-key>" \
  -H "Content-Type: application/json" \
  -d '{
    "message": "Summarize the last five support tickets for this customer.",
    "externalSessionId": "customer-482910"
  }'

const response = await fetch("https://api.praxa.io/api/custom-agent-run", {
  method: "POST",
  headers: {
    Authorization: `Bearer ${process.env.PRAXA_AGENT_KEY}`,
    "Content-Type": "application/json",
  },
  body: JSON.stringify({
    message: "Summarize the last five support tickets for this customer.",
    externalSessionId: "customer-482910",
  }),
});

if (!response.ok) {
  throw new Error(`Agent run failed: ${response.status}`);
}

const result = await response.json();

curl -X POST https://api.praxa.io/v1/execute \
  -H "Authorization: Bearer praxa_sk_<64 lowercase hex characters>" \
  -H "Content-Type: application/json" \
  -H "X-AI-Platform-Version: v1" \
  -H "Idempotency-Key: 5f2b1e3a-2b3e-4a6d-9c1a-3a2b1e3a2b3e" \
  -d '{
    "apiVersion": "v1",
    "requestId": "req-competitor-001",
    "mode": "task",
    "task": { "input": "Research three competitors and draft a one-page comparison." },
    "idempotencyKey": "5f2b1e3a-2b3e-4a6d-9c1a-3a2b1e3a2b3e"
  }'

const idempotencyKey = crypto.randomUUID();

const response = await fetch("https://api.praxa.io/v1/execute", {
  method: "POST",
  headers: {
    Authorization: `Bearer ${process.env.PRAXA_SK_KEY}`,
    "Content-Type": "application/json",
    "X-AI-Platform-Version": "v1",
    "Idempotency-Key": idempotencyKey,
  },
  body: JSON.stringify({
    apiVersion: "v1",
    requestId: crypto.randomUUID(),
    mode: "task",
    task: { input: "Research three competitors and draft a one-page comparison." },
    idempotencyKey,
  }),
});

if (!response.ok) {
  throw new Error(`Execute request failed: ${response.status}`);
}

const run = await response.json();
console.log(run.run_id, run.status);

curl -X POST https://api.praxa.io/v1/runs/2f47a86e-72ce-4f27-8ff0-7dc0c959fd35/approve \
  -H "Authorization: Bearer praxa_sk_<64 lowercase hex characters>" \
  -H "Content-Type: application/json" \
  -d '{ "action_digest": "...", "decision": "approve" }'