Your API key:

All requests below will use this key. Your API key is sent directly to api.cueapi.ai and never stored by the docs site.

GET/v1/echo/{token}

Echo Retrieve

Retrieve a stored echo payload + captured headers. Auth required.

Retrieves the payload + captured headers stored by the most recent POST /v1/echo/{token} for the same token. Used to inspect what CueAPI's webhook delivery actually sent.

Note

Auth required. Reads are gated by your API key — only the user holding the key for this account can retrieve. Writes (the POST side) are public so that webhook delivery can hit them.

Request

bash

curl https://api.cueapi.ai/v1/echo/my-test-token-1234567890 \
  -H "Authorization: Bearer cue_sk_YOUR_KEY"

Response

json

{
  "status": "delivered",
  "payload": {"hello": "world"},
  "headers": {
    "x-cueapi-signature": "v1=abcdef…",
    "x-cueapi-timestamp": "1745099400",
    "content-type": "application/json",
    "user-agent": "CueAPI-Webhook/1.0"
  },
  "received_at": "2026-04-19T22:30:00Z"
}

json

{"status": "waiting"}

Status values

`status`	Meaning
`waiting`	No POST has hit this token within the last 5 minutes (TTL)
`delivered`	A POST landed and the payload + headers are returned

Errors

Status	Code	Cause
401	`not_authenticated`	Missing/invalid bearer token

GET/v1/echo/{token}

Try it

Replace path parameters (e.g. {cue_id}) in the URL before sending.

Enter your API key above to send requests

Previous← Store Payload NextSubmit Ticket →