PermuteDocs
Dashboard

Answers · answerJobsGet

Get an answer job

Returns the current status and final result for a Permute answer job.

GET/v1/answer-jobs/{answerJobId}
betaapiKeyworkspace

When to use

Poll a previously started analysis until it is completed or failed.

For agents

Call this with the answerJobId returned by answerJobsCreate. Do not redo Permute analysis while waiting.

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.getAnswerJob('ansj_abc123');

Response

json
{
  "data": {
    "answerJobId": "ansj_abc123",
    "status": "completed",
    "result": {
      "answer": "Revenue increased because expansion and renewal activity outweighed churn in the selected period.",
      "citations": [
        {
          "type": "table",
          "sourceId": "conn_hubspot123",
          "ref": "table_1"
        }
      ],
      "followUps": [
        "Break this down by segment",
        "Show the largest underlying deals"
      ],
      "confidence": {
        "score": 88,
        "queryComplexity": "medium",
        "reason": "Answer is limited to accessible workspace sources."
      }
    },
    "createdAt": "2026-05-18T12:00:00.000Z",
    "updatedAt": "2026-05-18T12:00:08.000Z",
    "completedAt": "2026-05-18T12:00:08.000Z"
  }
}