Retry a failed result

POST

/results/{result_id}/retry

const url = 'https://api.prismlet.com/v1/results/0192f5c1-7c1a-7b3e-9f55-3c1d2e4a5b6c/retry?format=json';
const options = {method: 'POST', 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 POST \
  --url 'https://api.prismlet.com/v1/results/0192f5c1-7c1a-7b3e-9f55-3c1d2e4a5b6c/retry?format=json' \
  --header 'Authorization: Bearer <token>'

Sends a failed result’s fields to the model again, against the same prism version, and saves the answer as a new result with its own id. The response is that new result, on 200 or 502. Send no body.

Only a failed result can be retried, and only once. A second retry answers 409 and names the result that retried it. If that retry failed too, retry it in turn. An idempotency key held by the failed result moves to the new one. A result of an archived prism cannot be retried and answers 404.

Authorizations

api_key

Parameters

Path Parameters

result_id

required

string format: uuid

The result’s id.

Example

0192f5c1-7c1a-7b3e-9f55-3c1d2e4a5b6c

Query Parameters

format

string

default: json

Allowed values: json raw csv tsv jsonl

What the response body holds.

json: the result, with answers shaped by the prism’s Lens.
raw: the result, with the stored answers and every probability.
csv, tsv: a header row and one row for the result.
jsonl: one line holding the same row as a JSON object.

Defaults to json, also when sent empty. An unknown value answers 400. Errors are JSON in every format.

Responses

200

The retry was answered and saved as a new result.

Any of:

Result (json)
RawResult (raw)

Result (json)

A result in the default json format. answers is shaped by the prism’s current Lens, so editing the Lens changes what an old result returns.

object

required

The result id. Use it to read or retry the result.

string format: uuid

ref

required

The ref sent with the call, or null.

string | null

prism

required

The prism’s slug.

string

version

required

The prism version that answered.

integer

>= 1

status

required

ok, or failed when the model gave no usable answer.

string

Allowed values: ok failed

error

required

Why the result failed, in words. Null when status is ok.

string | null

took_ms

required

How long the call to the model took, in milliseconds.

integer

created_at

required

When the result was saved, ISO 8601 in UTC.

string format: date-time

answers

required

One entry per column of the prism’s Lens, keyed by column name, in Lens order. Null when the result failed.

object | null

RawResult (raw)

A result in raw format, with the stored answers and every probability. Lens edits never change it.

object

required

The result id. Use it to read or retry the result.

string format: uuid

ref

required

The ref sent with the call, or null.

string | null

prism

required

The prism’s slug.

string

version

required

The prism version that answered.

integer

>= 1

status

required

ok, or failed when the model gave no usable answer.

string

Allowed values: ok failed

error

required

Why the result failed, in words. Null when status is ok.

string | null

took_ms

required

How long the call to the model took, in milliseconds.

integer

created_at

required

When the result was saved, ISO 8601 in UTC.

string format: date-time

answers

required

The stored answer to every question, keyed by question key. Null when the result failed.

object | null

Examples

Answered on retry, format=json

{
  "id": "0192f5c4-9e27-7c55-b3d8-41a6f0e8c9b2",
  "ref": "TCK-8812",
  "prism": "support-routing",
  "version": 3,
  "status": "ok",
  "error": null,
  "took_ms": 640,
  "created_at": "2026-09-23T09:16:05.931Z",
  "answers": {
    "team": "billing",
    "team_probability": 0.91,
    "urgent": "yes",
    "tone": "annoyed",
    "tone_average": 2.05
  }
}

Answered on retry, format=raw

{
  "id": "0192f5c4-9e27-7c55-b3d8-41a6f0e8c9b2",
  "ref": "TCK-8812",
  "prism": "support-routing",
  "version": 3,
  "status": "ok",
  "error": null,
  "took_ms": 640,
  "created_at": "2026-09-23T09:16:05.931Z",
  "answers": {
    "team": {
      "type": "choice",
      "value": "billing",
      "probabilities": {
        "billing": 0.91,
        "technical": 0.05,
        "other": 0.03,
        "insufficient_information": 0.01
      },
      "confidence": 0.88
    },
    "urgent": {
      "type": "yes_no",
      "probability": 0.83
    },
    "tone": {
      "type": "scale",
      "level": "annoyed",
      "probabilities": {
        "calm": 0.12,
        "annoyed": 0.71,
        "angry": 0.17
      }
    }
  }
}

A header row, then one row. The columns are result_id, ref, version, status, error, created_at, one per field of the latest prism version, then the Lens columns. Cells hold option labels and Yes, No or Unsure. Lines end in CRLF. A cell holding a comma, a quote or a line break is quoted, with quotes doubled. An empty value is an empty cell.

string

Examples

csv

Answered on retry, format=csv

result_id,ref,version,status,error,created_at,subject,text,team,team_probability,urgent,tone,tone_average
0192f5c4-9e27-7c55-b3d8-41a6f0e8c9b2,TCK-8812,3,ok,,2026-09-23T09:16:05.931Z,Charged twice this month,"Hi, I was billed twice for September. Please refund the second charge before Friday.",Billing,0.91,Yes,Annoyed,2.05

The csv columns, separated by tabs, with lines ending in LF. Tabs and line breaks inside a cell become spaces.

string

Examples

tsv

Answered on retry, format=tsv

result_id  ref  version  status  error  created_at  subject  text  team  team_probability  urgent  tone  tone_average
0192f5c4-9e27-7c55-b3d8-41a6f0e8c9b2  TCK-8812  3  ok    2026-09-23T09:16:05.931Z  Charged twice this month  Hi, I was billed twice for September. Please refund the second charge before Friday.  Billing  0.91  Yes  Annoyed  2.05

One line ending in LF, holding the csv row as a JSON object, with option keys and yes, no or unsure instead of labels, and all columns as objects.

string

Examples

jsonl

Answered on retry, format=jsonl

{"result_id":"0192f5c4-9e27-7c55-b3d8-41a6f0e8c9b2","ref":"TCK-8812","version":3,"status":"ok","error":null,"created_at":"2026-09-23T09:16:05.931Z","subject":"Charged twice this month","text":"Hi, I was billed twice for September. Please refund the second charge before Friday.","team":"billing","team_probability":0.91,"urgent":"yes","tone":"annoyed","tone_average":2.05}

400

The result id or the format is invalid, or the body is not valid JSON.

application/json; charset=utf-8

Every error has this body, in JSON, whatever format asked for.

object

error

required

object

code

required

validation_failed, bad_request, unauthorized, not_found, conflict or internal_error.

string

message

required

What went wrong, in words. A validation message names the failing paths and never repeats a value sent. Unknown fields lists the keys sent.

string

Examples

Result id is not a UUID

{
  "error": {
    "code": "validation_failed",
    "message": "Invalid request: result_id: Invalid uuid"
  }
}

Unknown format

{
  "error": {
    "code": "validation_failed",
    "message": "Invalid request: format: Expected 'json' | 'raw' | 'csv' | 'tsv' | 'jsonl'"
  }
}

Body is not valid JSON

{
  "error": {
    "code": "bad_request",
    "message": "Malformed request"
  }
}

401

No API key, or one that is unknown or revoked.

application/json; charset=utf-8

Every error has this body, in JSON, whatever format asked for.

object

error

required

object

code

required

validation_failed, bad_request, unauthorized, not_found, conflict or internal_error.

string

message

required

What went wrong, in words. A validation message names the failing paths and never repeats a value sent. Unknown fields lists the keys sent.

string

Examples

No Authorization header

{
  "error": {
    "code": "unauthorized",
    "message": "Authentication required"
  }
}

Unknown or revoked key

{
  "error": {
    "code": "unauthorized",
    "message": "Invalid API key"
  }
}

404

No result with this id in this account, or its prism is archived.

application/json; charset=utf-8

Every error has this body, in JSON, whatever format asked for.

object

error

required

object

code

required

validation_failed, bad_request, unauthorized, not_found, conflict or internal_error.

string

message

required

What went wrong, in words. A validation message names the failing paths and never repeats a value sent. Unknown fields lists the keys sent.

string

Examples

Unknown result

{
  "error": {
    "code": "not_found",
    "message": "Result not found"
  }
}

Archived prism

{
  "error": {
    "code": "not_found",
    "message": "This prism is archived, so it cannot answer."
  }
}

409

The result succeeded, or it was already retried.

application/json; charset=utf-8

Every error has this body, in JSON, whatever format asked for.

object

error

required

object

code

required

validation_failed, bad_request, unauthorized, not_found, conflict or internal_error.

string

message

required

What went wrong, in words. A validation message names the failing paths and never repeats a value sent. Unknown fields lists the keys sent.

string

Examples

Result succeeded

{
  "error": {
    "code": "conflict",
    "message": "Only a failed result can be retried."
  }
}

Already retried

{
  "error": {
    "code": "conflict",
    "message": "This result was already retried as 0192f5c4-9e27-7c55-b3d8-41a6f0e8c9b2."
  }
}

413

A body over 1 MiB was sent. Send no body.

application/json; charset=utf-8

Every error has this body, in JSON, whatever format asked for.

object

error

required

object

code

required

validation_failed, bad_request, unauthorized, not_found, conflict or internal_error.

string

message

required

What went wrong, in words. A validation message names the failing paths and never repeats a value sent. Unknown fields lists the keys sent.

string

Examples

body_too_large

Body too large

{
  "error": {
    "code": "bad_request",
    "message": "Malformed request"
  }
}

415

A body was sent with a content type the server does not parse. Send no body.

application/json; charset=utf-8

Every error has this body, in JSON, whatever format asked for.

object

error

required

object

code

required

validation_failed, bad_request, unauthorized, not_found, conflict or internal_error.

string

message

required

What went wrong, in words. A validation message names the failing paths and never repeats a value sent. Unknown fields lists the keys sent.

string

Examples

unsupported_content_type

Unsupported content type

{
  "error": {
    "code": "bad_request",
    "message": "Malformed request"
  }
}

500

A bug on our side. The message is always the same.

application/json; charset=utf-8

Every error has this body, in JSON, whatever format asked for.

object

error

required

object

code

required

validation_failed, bad_request, unauthorized, not_found, conflict or internal_error.

string

message

required

What went wrong, in words. A validation message names the failing paths and never repeats a value sent. Unknown fields lists the keys sent.

string

Examples

unexpected_error

Unexpected error

{
  "error": {
    "code": "internal_error",
    "message": "Internal server error"
  }
}

502

The model failed again. The new failed result is saved and returned, and can be retried in turn.

Any of:

Result (json)
RawResult (raw)

Result (json)

A result in the default json format. answers is shaped by the prism’s current Lens, so editing the Lens changes what an old result returns.

object

required

The result id. Use it to read or retry the result.

string format: uuid

ref

required

The ref sent with the call, or null.

string | null

prism

required

The prism’s slug.

string

version

required

The prism version that answered.

integer

>= 1

status

required

ok, or failed when the model gave no usable answer.

string

Allowed values: ok failed

error

required

Why the result failed, in words. Null when status is ok.

string | null

took_ms

required

How long the call to the model took, in milliseconds.

integer

created_at

required

When the result was saved, ISO 8601 in UTC.

string format: date-time

answers

required

One entry per column of the prism’s Lens, keyed by column name, in Lens order. Null when the result failed.

object | null

RawResult (raw)

A result in raw format, with the stored answers and every probability. Lens edits never change it.

object

required

The result id. Use it to read or retry the result.

string format: uuid

ref

required

The ref sent with the call, or null.

string | null

prism

required

The prism’s slug.

string

version

required

The prism version that answered.

integer

>= 1

status

required

ok, or failed when the model gave no usable answer.

string

Allowed values: ok failed

error

required

Why the result failed, in words. Null when status is ok.

string | null

took_ms

required

How long the call to the model took, in milliseconds.

integer

created_at

required

When the result was saved, ISO 8601 in UTC.

string format: date-time

answers

required

The stored answer to every question, keyed by question key. Null when the result failed.

object | null

Examples

Model timed out again, format=json

{
  "id": "0192f5c5-4d81-7a02-9c3e-6b27d1f0a845",
  "ref": "TCK-8812",
  "prism": "support-routing",
  "version": 3,
  "status": "failed",
  "error": "The model took too long to answer, so we stopped after 15 seconds.",
  "took_ms": 15012,
  "created_at": "2026-09-23T09:16:38.644Z",
  "answers": null
}

Model timed out again, format=raw

{
  "id": "0192f5c5-4d81-7a02-9c3e-6b27d1f0a845",
  "ref": "TCK-8812",
  "prism": "support-routing",
  "version": 3,
  "status": "failed",
  "error": "The model took too long to answer, so we stopped after 15 seconds.",
  "took_ms": 15012,
  "created_at": "2026-09-23T09:16:38.644Z",
  "answers": null
}

string

Examples

csv

Model timed out again, format=csv

result_id,ref,version,status,error,created_at,subject,text,team,team_probability,urgent,tone,tone_average
0192f5c5-4d81-7a02-9c3e-6b27d1f0a845,TCK-8812,3,failed,"The model took too long to answer, so we stopped after 15 seconds.",2026-09-23T09:16:38.644Z,Charged twice this month,"Hi, I was billed twice for September. Please refund the second charge before Friday.",,,,,

The csv columns, separated by tabs, with lines ending in LF. Tabs and line breaks inside a cell become spaces.

string

Examples

tsv

Model timed out again, format=tsv

result_id  ref  version  status  error  created_at  subject  text  team  team_probability  urgent  tone  tone_average
0192f5c5-4d81-7a02-9c3e-6b27d1f0a845  TCK-8812  3  failed  The model took too long to answer, so we stopped after 15 seconds.  2026-09-23T09:16:38.644Z  Charged twice this month  Hi, I was billed twice for September. Please refund the second charge before Friday.

One line ending in LF, holding the csv row as a JSON object, with option keys and yes, no or unsure instead of labels, and all columns as objects.

string

Examples

jsonl

Model timed out again, format=jsonl

{"result_id":"0192f5c5-4d81-7a02-9c3e-6b27d1f0a845","ref":"TCK-8812","version":3,"status":"failed","error":"The model took too long to answer, so we stopped after 15 seconds.","created_at":"2026-09-23T09:16:38.644Z","subject":"Charged twice this month","text":"Hi, I was billed twice for September. Please refund the second charge before Friday.","team":null,"team_probability":null,"urgent":null,"tone":null,"tone_average":null}