Where an AI extraction of requirements stands, and what it proposed
const url = 'https://beta-api.plune.ai/v1/projects/example/requirements/import/extractions/example';const options = {method: 'GET', headers: {Authorization: 'Bearer <token>'}};
try { const response = await fetch(url, options); const data = await response.json(); console.log(data);} catch (error) { console.error(error);}curl --request GET \ --url https://beta-api.plune.ai/v1/projects/example/requirements/import/extractions/example \ --header 'Authorization: Bearer <token>'The extraction (#2292, ADR 0076), for the person who asked for it: its state, what was sent, the cost and, once done, the proposals in result until resultKeptUntil (24 hours after it ended; then result is null and the cost stays). failed names its failureKind; one still running 25 minutes after its try began, or still queued 2 hours after it was asked for, reads failed / stalled. Anyone else in the project gets the 404 of an extraction nobody made.
Authorizations
Section titled “Authorizations ”Parameters
Section titled “ Parameters ”Path Parameters
Section titled “Path Parameters ”An id from GET /v1/projects
The id a POST …/extractions answered with
Responses
Section titled “ Responses ”The extraction
object
True only on a POST that found the earlier extraction of the same text; false on GET and DELETE.
object
Characters sent, after masking.
Secrets masked before anything left.
The project’s provider when it was queued.
Tokens null = the provider reported none; costUsd null beside tokens = the model’s price is unknown, never 0.
object
Null unless failed: timeout (no answer within 5 minutes), the provider’s own kind (key_rejected, provider_rate_limited, provider_unavailable, invalid_response, address_rejected), stalled (it did not finish), ai_unavailable (the project’s AI was gone when it ran), or ai_budget_spent (the project’s monthly AI limit ran out while it waited in the queue: the provider was not called, nothing was spent).
What it proposed, each line in the file as sent: only while done and until resultKeptUntil, null otherwise.
object
object
Only when the text states it.
Only the ones the text states.
object
object
finishedAt plus 24 hours when done; then result reads null and the cost stays. Null otherwise.
Example
{ "id": "7a2c4e10-0000-4000-8000-0000000000b1", "state": "done", "reused": false, "createdAt": "2026-11-04T09:00:00.000Z", "startedAt": "2026-11-04T09:00:02.000Z", "finishedAt": "2026-11-04T09:00:41.000Z", "fetched": { "text": 268 }, "redactions": 0, "provider": "anthropic", "model": "claude-haiku-4-5", "cost": { "inputTokens": 290, "outputTokens": 180, "costUsd": 0.00119 }, "failureKind": null, "result": { "requirements": [ { "line": 4, "title": "Accept a card payment", "quote": "The system shall accept a card payment.", "priority": "High", "type": "user_story" } ], "questions": [ { "line": 6, "title": "Support Apple Pay?", "quote": "We could maybe support Apple Pay later." } ], "refused": [] }, "resultKeptUntil": "2026-11-05T09:00:41.000Z"}No / invalid token or session
You are in the project as a reader
No such project among yours, or no such extraction of yours in it
object
Example generated
{ "error": "example"}Rate-limited: the per-route throttle, or the per-minute request limit of the plan an API token counts by (#1442; the body names the plan, #2092). Retry-After carries the seconds until the window rolls over.
object
Example generated
{ "error": "example"}Headers
Section titled “Headers ”Seconds until the window rolls over