Nsr responses handler

Required scope: write

POST /v1/responses

cURL

curl --request POST \
  --url 'https://api.nsr.stateset.com/v1/responses' \
  --header "X-API-Key: $STATESET_NSR_API_KEY" \
  --header 'Content-Type: application/json' \
  --data '{
  "model": "string",
  "input": "string",
  "instructions": "Two-person tent, green — replacement for damaged pole set.",
  "tools": [
    {}
  ],
  "tool_choice": "string",
  "max_output_tokens": 1,
  "response_format": {
    "type": "standard",
    "json_schema": {
      "name": "Two-Person Tent",
      "schema": {},
      "strict": true
    }
  },
  "text": {
    "format": {}
  },
  "session_id": "3fa85f64-5717-4562-b3fc-2c963f66afa6",
  "goal": "string",
  "target": "string",
  "facts": [
    {}
  ],
  "rules": [
    {}
  ],
  "decompositions": [
    {}
  ],
  "hydrate_org_context": true,
  "kb_limits": {},
  "max_depth": 1,
  "max_iterations": 8,
  "confidence_threshold": 7.5,
  "stream": true,
  "stream_options": {
    "include_usage": true
  },
  "previous_response_id": "3fa85f64-5717-4562-b3fc-2c963f66afa6",
  "store": true,
  "metadata": {},
  "include_nsr_metadata": true
}'

200

{
  "id": "3fa85f64-5717-4562-b3fc-2c963f66afa6",
  "object": "string",
  "created_at": 1,
  "status": "pending",
  "model": "string",
  "output": [
    {
      "type": "standard",
      "id": "3fa85f64-5717-4562-b3fc-2c963f66afa6",
      "status": "pending",
      "role": "string",
      "content": [],
      "call_id": "3fa85f64-5717-4562-b3fc-2c963f66afa6",
      "name": "Two-Person Tent",
      "arguments": "string"
    }
  ],
  "output_text": "string",
  "usage": {
    "input_tokens": 1,
    "output_tokens": 1,
    "total_tokens": 1
  },
  "metadata": {},
  "previous_response_id": "3fa85f64-5717-4562-b3fc-2c963f66afa6",
  "x_nsr": {}
}

Required scope: write

Request body

object

model · string

input · string

A text string, a single input item object, or an array of input items.

instructions · string

tools · object[]

tool_choice · string

Tool selection mode (auto, none, required) or a specific function as {'type': 'function', 'function': {'name': …}}.

max_output_tokens · integer

response_format · object

text · object

OpenAI Responses-style text config; format takes the same shape as response_format.

session_id · string

goal · string

target · string

facts · object[]

rules · object[]

decompositions · object[]

hydrate_org_context · boolean

kb_limits · object

max_depth · integer

max_iterations · integer

confidence_threshold · number

stream · boolean

When true, emit an SSE stream instead of a JSON body.

stream_options · object

previous_response_id · string

store · boolean

metadata · object

include_nsr_metadata · boolean

When true, include the full recursive payload under x_nsr.

Response

object

id · string · required

object · string · required

created_at · integer · required

Unix timestamp (seconds).

status · string · required

model · string · required

output · object[] · required

Show output

type · string · required

id · string · required

status · string · required

role · string

Present on message items.

content · object[]

Present on message items.

Show content

type · string

text · string

annotations · object[]

call_id · string

Present on function_call items.

name · string

Present on function_call items.

arguments · string

JSON-encoded arguments string. Present on function_call items.

output_text · string

Convenience concatenation of the output text. Omitted when there is none.

usage · object · required

Show usage

input_tokens · integer · required

output_tokens · integer · required

total_tokens · integer · required

metadata · object

Echoed request metadata. Omitted when absent.

previous_response_id · string

Omitted when absent.

x_nsr · object

Full recursive NSR payload. Present only when include_nsr_metadata is true.

Status codes

Code	Meaning
200	OpenAI-compatible response object. With stream: true the body is a text/event-stream instead.
401	Unauthorized — missing or invalid credentials
403	Forbidden — the key/token lacks the required scope
429	Rate limited — see Retry-After / X-RateLimit-Reset

cURL

curl --request POST \
  --url 'https://api.nsr.stateset.com/v1/responses' \
  --header "X-API-Key: $STATESET_NSR_API_KEY" \
  --header 'Content-Type: application/json' \
  --data '{
  "model": "string",
  "input": "string",
  "instructions": "Two-person tent, green — replacement for damaged pole set.",
  "tools": [
    {}
  ],
  "tool_choice": "string",
  "max_output_tokens": 1,
  "response_format": {
    "type": "standard",
    "json_schema": {
      "name": "Two-Person Tent",
      "schema": {},
      "strict": true
    }
  },
  "text": {
    "format": {}
  },
  "session_id": "3fa85f64-5717-4562-b3fc-2c963f66afa6",
  "goal": "string",
  "target": "string",
  "facts": [
    {}
  ],
  "rules": [
    {}
  ],
  "decompositions": [
    {}
  ],
  "hydrate_org_context": true,
  "kb_limits": {},
  "max_depth": 1,
  "max_iterations": 8,
  "confidence_threshold": 7.5,
  "stream": true,
  "stream_options": {
    "include_usage": true
  },
  "previous_response_id": "3fa85f64-5717-4562-b3fc-2c963f66afa6",
  "store": true,
  "metadata": {},
  "include_nsr_metadata": true
}'

200

{
  "id": "3fa85f64-5717-4562-b3fc-2c963f66afa6",
  "object": "string",
  "created_at": 1,
  "status": "pending",
  "model": "string",
  "output": [
    {
      "type": "standard",
      "id": "3fa85f64-5717-4562-b3fc-2c963f66afa6",
      "status": "pending",
      "role": "string",
      "content": [],
      "call_id": "3fa85f64-5717-4562-b3fc-2c963f66afa6",
      "name": "Two-Person Tent",
      "arguments": "string"
    }
  ],
  "output_text": "string",
  "usage": {
    "input_tokens": 1,
    "output_tokens": 1,
    "total_tokens": 1
  },
  "metadata": {},
  "previous_response_id": "3fa85f64-5717-4562-b3fc-2c963f66afa6",
  "x_nsr": {}
}