---
title: "Create initial plan"
method: POST
path: "/ai/missions/{mission_id}/runs/{run_id}/plan"
tags: ["Missions"]
---

# Create initial plan

`POST /ai/missions/{mission_id}/runs/{run_id}/plan`

## Request

- Base URL: `https://api.telnyx.com/v2`
- URL: `https://api.telnyx.com/v2/ai/missions/{mission_id}/runs/{run_id}/plan`
- Auth: HTTP bearer

Creates the initial plan for the specified run from the provided steps and returns the created plan steps. Progress is subsequently reported by updating individual steps.

## Path parameters

- `mission_id` string, uuid, required
- `run_id` string, uuid, required

## Request body

- CreatePlanRequest
  - `steps` CreatePlanStepRequest[], required
    - `step_id` string, required
    - `description` string, required
    - `sequence` integer, required
    - `parent_step_id` string
    - `metadata` object

## Response `201`

Successful Response

- PlanStepsCreatedResponse
  - `data` PlanStepData[], required
    - `step_id` string, required
    - `run_id` string, uuid, required
    - `parent_step_id` string
    - `sequence` integer, required
    - `description` string, required
    - `status` 'pending' | 'in_progress' | 'completed' | 'skipped' | 'failed', required
    - `started_at` string, date-time
    - `completed_at` string, date-time
    - `metadata` object

## Other responses

- `422`: Validation Error

---

[API](https://skmtc.dev/team-telnyx/apis/telnyx-api-2.md) - [All operations](https://skmtc.dev/team-telnyx/apis/telnyx-api-2/llms.txt) - [OpenAPI document](https://skmtc.dev/team-telnyx/apis/telnyx-api-2/revisions/f82938f53ff4?raw)