Responses API

Retrieve a response

Changed on

Results can expire 10 minutes after first successful delivery.

get/responses/{response_id}

Request

  • Base URL
    https://api.sailresearch.com/v1
  • URL
    https://api.sailresearch.com/v1/responses/{response_id}
  • Auth
    HTTP bearer

Path parameters

response_idstring required

Response

The response object.

idstring required
object'response' required
created_atinteger required
status'queued' | 'in_progress' | 'failed' | 'completed' | 'incomplete' | 'cancelled' required
modelstring required
errorobject nullable
incomplete_detailsobject nullable
max_output_tokensinteger nullable
reasoningobject
storeboolean
temperaturenumber
top_pnumber
parallel_tool_callsboolean
toolsobject[]
userstring nullable
service_tier'asap' | 'balanced' | 'flex'

The completion window Sail selected for this request, including when no window was requested. The legacy request value standard is reported as balanced. Older stored responses may omit this field.

Changes

    • breaking

      added to the ///////// response property oneOf list for the response status

    • breaking

      added to the ///// response property oneOf list for the response status

    • breaking

      added subschema #2 to the response property oneOf list for the response status

    • breaking

      the response's property type changed from object to no type for status

    • breaking

      removed the required property / from the response with the status

    • breaking

      removed the required property / from the response with the status

    • breaking

      removed the required property / from the response with the status

    • breaking

      removed the required property / from the response with the status

    • breaking

      removed the required property / from the response with the status

    • warning

      removed the optional property / from the response with the status

    • warning

      removed the optional property / from the response with the status

    • warning

      added the new in_progress enum value to the response property for the response status

    • warning

      added the new incomplete enum value to the response property for the response status

    • warning

      added the new queued enum value to the response property for the response status

    • info

      added the optional property / to the response with the status

    • info

      added the optional property / to the response with the status

    • info

      added the optional property to the response with the status

    • info

      removed the pending enum value from the response property for the response status

    • info

      removed the running enum value from the response property for the response status