Agent testing

Start a test conversation with an agent.

Starts a test conversation, optionally running the first message in the same call. Send an Idempotency-Key header to make retries safe. Up to 20 test conversations can be active per account over the API/MCP; each allows 50 turns and expires after 30 minutes without a message. A conversation is charged once, at your normal per-conversation rate, when the agent sends its first successful reply to a message sent with an API key or MCP. Creating a conversation without a message costs nothing. Test conversations expire after 30 minutes of inactivity, so each test conversation is charged at most once. Messages sent from the Cysora dashboard are never charged. Test conversations are marked test and never reach your sales pipeline: signups, bookings, payments, and emails are simulated and reported back as simulatedActions.

post/api/v1/agents/{agent}/test-conversations

Request

  • Base URL: https://www.cysora.com
  • URL: https://www.cysora.com/api/v1/agents/{agent}/test-conversations
  • Auth: one of:
    • HTTP bearer
    • API key in header x-api-key

Request body

channel'web' | 'whatsapp'

Which channel's prompt and formatting to test. Defaults to web.

labelstring

Optional name shown in the conversations tab.

messagestring

Optional first message; runs the first turn in the same call.

Response

Success.

Changes

No recorded changes to this operation across all 1 revision of this API.