API Sandbox

Live REST playground inside the dashboard. Build a request, send it against any of your agents, and inspect the full response before you wire it into your own code.

What you see

API Sandbox · app.sentientone.ai/api-test
POST /v1/chat/streamAgent: Order Status Agent ▾Mode: SSESend
Request

X-Api-Key

sk-so-•••••••• 3F92

X-Agent-Id

a1b2c3d4-e5f6-7890-…

Body

{
  "message": "Where's order ORD-1234?",
  "conversation_id": null
}
Response · 200 OK · text/event-stream

X-Trace-Id

trace_8b21d4f0

Stream (SSE)

data: {"type":"meta","conversation_id":"conv-9f12…","trace_id":"trace_8b21d4f0"}
data: {"type":"sources","sources":[{"index":1,"id":"doc-77","title":"Shipping","score":0.82}]}
data: {"type":"delta","content":"ORD-1234 "}
data: {"type":"delta","content":"shipped via FedEx…"}
data: {"type":"done","conversation_id":"conv-9f12…","trace_id":"trace_8b21d4f0"}

The full answer is the concatenation of every delta content.

ChatStream (SSE)Copy as cURLCopy as TypeScript

Widget reference

  • Agent pickerPre-fills X-Agent-Id with the selected agent's UUID. The agent dropdown lists every agent you can edit.
  • EndpointEvery request hits /v1/chat/stream (Server-Sent Events) — the single chat endpoint, on all plans. See Streaming for the SSE event shape.
  • HeadersPre-filled with your platform key and the selected agent id. Edit to test how the API responds to bad credentials or wrong agent ids.
  • BodyJSON editor with syntax highlighting. Defaults to { "message": "Hello!" }. Pass conversation_id to continue a thread.
  • SendFires the request. Round-trip latency appears in the response panel — useful for sanity-checking production latency from your edge.
  • Response panelStatus, headers, a copy button, and the SSE events rendered line-by-line as they arrive. The full answer is the concatenation of every delta content.
  • Copy as cURL / TS / PythonGenerates a ready-to-run snippet with your headers and body inlined. Paste straight into your codebase.

Use the sandbox before you integrate

  1. 1

    Pick the agent

    Choose the agent your integration will hit. The sandbox writes the agent id into the header for you.
  2. 2

    Send the same body your app will send

    Paste a representative message, then Send. Confirm the SSE events match what your client expects.
  3. 3

    Watch the stream arrive

    /v1/chat/stream returns Server-Sent Events. Watch the meta, sources, delta, and done events arrive — that's exactly the order your client will see them. Concatenate every delta content for the full answer.
  4. 4

    Copy a snippet

    Use Copy as cURL (or TypeScript / Python) and drop into your app. The snippet already has your headers and body filled in.

Pair this with the REST API docs

Anything you see in the sandbox is documented in REST API — endpoints, request shape, response fields, and every error code.