analytics110

ask-feather12

assistants41

billing3

communication12

conversation-exports4

conversations18

email7

email-drafts6

evals19

extraction-schemas4

extractions3

hitl10

identity28

integrations17

knowledge-base29

knowledge-base-acl6

knowledge-base-audit6

knowledge-base-connectors12

knowledge-base-evals13

knowledge-base-governance4

knowledge-gap-analytics9

library12

mcp-chat2

memory4

mocks16

model-router10

notifications19

personas7

policies22

privacy5

retention-policies4

scenarios7

sessions1

sim_suites15

simulation_runs6

sms5

teams15

tools17

voice40

webchat10

webhooks2

workflow-playground4

workflows22

simulation_runs

Dispatch a simulation run

Changed on Aug 12, 2026

post/v1/simulation/runs

Request

The document declares no server URL.
Auth
API key in header x-api-key
TypeScript
https://skmtc.dev/oneloop-hq/apis/feather-api/docs/v1/simulation/runs/post.ts
A function with typed inputs. Its response is checked against the schema.

Request body

agent_idstring uuid required

agent_revision_idstring uuid nullable

persona_idstring uuid required

scenario_idstring uuid required

channel'text' | 'voice'

tool_overridesobject nullable

idempotency_keystring nullable

Response

Successful Response

idstring uuid required

session_idstring uuid required

organization_idstring uuid required

agent_idstring uuid required

agent_revision_idstring uuid nullable required

persona_idstring uuid required

scenario_idstring uuid required

suite_idstring uuid nullable

suite_run_idstring uuid nullable

suite_item_idstring uuid nullable

suite_attemptinteger

channel'text' | 'voice' required

tool_overridesobject nullable required

sut_snapshot_sha256string nullable

statusstring required

idempotency_keystring nullable

budget_usdstring nullable

spent_usdstring nullable

started_atstring date-time nullable required

finished_atstring date-time nullable required

error_textstring nullable required

stop_reasonstring nullable

persona_turn_countinteger

agent_turn_countinteger

transcript_charsinteger

heartbeat_atstring date-time nullable

inputs_snapshotobject required

created_atstring date-time required

recording_idstring uuid nullable

recording_statusstring nullable

Changes

Aug 12, 20265a5597ebb2d6 Revision changes
- info
  added the new optional request property
- info
  added the new optional request property
- info
  added the optional property to the response with the status
- info
  added the optional property to the response with the status
- info
  added the optional property to the response with the status
- info
  added the optional property to the response with the status
- info
  added the optional property to the response with the status
- info
  added the optional property to the response with the status
- info
  added the optional property to the response with the status
- info
  added the optional property to the response with the status
- info
  added the optional property to the response with the status
- info
  added the optional property to the response with the status
- info
  added the optional property to the response with the status
- info
  added the optional property to the response with the status
- info
  added the optional property to the response with the status
- info
  added the optional property to the response with the status
- info
  added the optional property to the response with the status
- info
  added the optional property to the response with the status
- info
  added the optional property to the response with the status

Operation history

Dispatch a simulation run

Request

Request body

Response 201Created

Changes

Response