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

POST/v1/echo/{token}

Echo Store

Store a webhook payload in a temporary buffer keyed by token. No auth. Used for webhook signature testing in the docs API playground and the cueapi quickstart flow.

Stores an incoming HTTP body in a Redis-backed buffer keyed by token, alongside the request headers. Used to test webhook delivery without standing up a public endpoint — point a cue's callback URL at https://api.cueapi.ai/v1/echo/{token} and read the captured payload + headers via GET /v1/echo/{token}.

Note

No bearer auth required. This is intentionally a public endpoint so cue webhook delivery can hit it. The token (≥16 chars, your responsibility) is the only access control on the read side.

Limits

TTL5 minutes
Max payload1 MB
Rate limit10 stores per IP per hour

Request

bash
curl -X POST https://api.cueapi.ai/v1/echo/my-test-token-1234567890 \
  -H "Content-Type: application/json" \
  -d '{"hello": "world"}'

Response

json
{"stored": true}

Captured headers

Only headers relevant for webhook signature verification are kept:

  • All headers starting with X-CueAPI-
  • Content-Type
  • User-Agent

This lets you verify that CueAPI's signing convention is producing the expected X-CueAPI-Signature and X-CueAPI-Timestamp headers without leaking unrelated request metadata.

Errors

StatusCodeCause
400invalid_tokenToken shorter than 16 characters
413payload_too_largeBody exceeds 1 MB
429rate_limit_exceededMore than 10 stores from this IP in the past hour
POST/v1/echo/{token}
Try it
Replace path parameters (e.g. {cue_id}) in the URL before sending.
Request Body
Enter your API key above to send requests
How do I know if my agent ran successfully?
Ctrl+K