Run a test sequence

POST 
/app_installs/:id/test_events

A synthetic call sequence — a duplicate included — through the real telephony mapper, in a savepoint that is rolled back: nothing is left in any table. Answers with the run's own rows, source: test. 422 test_unavailable unless the install is a live telephony-contract install with an active source. integrations.manage. Throttles: app_installs/test_events/minute (10 a minute) on top of the write bucket, app_installs/write/minute (30 a minute).

A signed-in session or the person's own personal access token; an app's OAuth token is refused (403 resource_not_grantable).

Request

Responses

200

The terminal's rows, newest first.

401

No session or token, or one that is no longer valid. A request that presented a token gets WWW-Authenticate: Bearer realm="KudosCRM", error="invalid_token" (refresh it); one with no credentials and no session cookie gets the bare challenge.

Response Headers

WWW-Authenticate
Example: Bearer realm="KudosCRM", error="invalid_token"

403

Not allowed: the permission this route needs is missing, the Integrations module is off (code: module_disabled, meta.module_key, meta.blocked_at_layer), or the caller is an app's own OAuth token (code: resource_not_grantable).

404

Not found in this workspace — or not something the caller may know exists.

422

The install's lifecycle refused the change: not_installed / already_uninstalled (an uninstalled install), already_paused / not_paused, invalid_decision / nothing_pending (re-consent), install_paused / app_suspended / no_subscription (retries), not_replayable / payload_gone / subscription_inactive / not_granted / not_subscribed (replays), test_unavailable.

429

A throttle refused the request. Wait Retry-After seconds — the time left in the refusing window plus 0–3 s of jitter. The X-RateLimit-* headers describe the bucket that refused it.

Response Headers

Retry-After
X-RateLimit-Limit
X-RateLimit-Remaining
X-RateLimit-Reset

Seconds until the window rolls.