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/chatAgent: Order Status Agent ▾Mode: JSONSend
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 · 1.2s

X-Trace-Id

trace_8b21d4f0

Body

{
  "conversation_id": "conv-9f12…",
  "message": {
    "role": "assistant",
    "content": "ORD-1234 shipped via FedEx…",
    "token_count": 156
  }
}
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.
  • Endpoint switcherToggle between /v1/chat (single JSON response) and /v1/chat/stream (Server-Sent Events). 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, body, and a copy button. Switching to streaming mode renders the SSE events line-by-line as they arrive.
  • 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 response shape matches what your client expects.
  3. 3

    Switch to streaming if your UI needs it

    Toggle Stream (SSE) and re-send. Watch the events arrive — that's exactly the order your client will see them.
  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.