Start an answer job – POST /v1/answer-jobs

POST/v1/answer-jobs

betaapiKeyworkspace

When to use

Start a durable Permute analysis when the answer may need multiple tool calls or larger source context.

For agents

Prefer this for business questions. Treat the completed result as the analysis system of record.

Example

typescript

import { PermuteClient } from '@permute/sdk';

const orgClient = new PermuteClient({
  apiKey: process.env.PERMUTE_API_KEY!,
});

const client = orgClient.withWorkspace(process.env.PERMUTE_WORKSPACE_ID!);

const result = await client.answerJobs({
  "question": "What changed in revenue this quarter?",
  "sourceIds": [
    "conn_hubspot123"
  ]
});

Request body

json

{
  "question": "What changed in revenue this quarter?",
  "sourceIds": [
    "conn_hubspot123"
  ]
}

Response

json

{
  "data": {
    "answerJobId": "ansj_abc123",
    "status": "queued",
    "pollAfterMs": 1500,
    "createdAt": "2026-05-18T12:00:00.000Z",
    "updatedAt": "2026-05-18T12:00:00.000Z"
  }
}