---
title: "POST /simulate/api/alk-simulate/run-tests/provision/"
method: POST
path: "/simulate/api/alk-simulate/run-tests/provision/"
tags: ["simulate"]
---

# POST /simulate/api/alk-simulate/run-tests/provision/

`POST /simulate/api/alk-simulate/run-tests/provision/`

## Request

- Base URL: `http://localhost:8000`
- URL: `http://localhost:8000/simulate/api/alk-simulate/run-tests/provision/`
- Auth: one of:
  - API key in header `X-Api-Key`
  - API key in header `X-Secret-Key`

Stand up a chat RunTest + scenario-of-record from SDK personas so an
SDK-first run has somewhere to post — without the native UI's async
scenario generation. See ``provision_alk_sim_run_test``.

## Request body

- ALKSimulateProvisionRunTestRequest
  - `name` string, required
  - `modality` 'text' | 'chat' | 'voice'
  - `description` string
  - `personas` ALKSimulateProvisionPersona[]
    - `name` string
    - `scenario_name` string
    - `role` string
    - `situation` string
    - `outcome` string
    - `persona` object
  - `scenario_ids` string[]
  - `agent_definition_id` string, uuid, nullable
  - `agent_name` string
  - `enable_tool_evaluation` boolean

## Response `200`

OK

- ALKSimulateProvisionResponse
  - `status` boolean
  - `result` ALKSimulateProvisionResult, required
    - `run_test_id` string, uuid, required
    - `scenario_ids` string[], required
    - `agent_definition_id` string, uuid, required

## Other responses

- `400`: Bad Request
- `404`: Not Found
- `500`: Internal Server Error
- `default`: Default error response

---

[API](https://skmtc.dev/futureagi/apis/future-agi-management-api.md) · [All operations](https://skmtc.dev/futureagi/apis/future-agi-management-api/llms.txt) · [OpenAPI document](https://skmtc.dev/futureagi/apis/future-agi-management-api/revisions/c8684118e142?raw)