---
title: "Submit Plan"
method: POST
path: "/api/v1/plans"
---

# Submit Plan

`POST /api/v1/plans`

## Request

- Base URL: `https://authyouragent.com` (the document declares no server; this is the origin it was published from)
- URL: `https://authyouragent.com/api/v1/plans`
- Auth: none declared

An agent submits a scheduled task's plan; the owner gets one card to
pre-approve it (all steps or some). Rules only: at run time an approval
request goes through without a card only if it matches a pre-approved
step exactly (cloud/plans.py).

## Request body

- PlanIn
  - `agent_id` string, required
  - `agent_jwt` string, required
  - `title` string, required
  - `start_at` integer, required
  - `end_at` integer, required
  - `steps` object[], required
  - `runs` integer
  - `every` string

## Response `200`

Successful Response

- unknown

## Other responses

- `422`: Validation Error

---

[API](https://skmtc.dev/authyouragent/apis/auth-your-agent-cloud-slice.md) · [All operations](https://skmtc.dev/authyouragent/apis/auth-your-agent-cloud-slice/llms.txt) · [OpenAPI document](https://skmtc.dev/authyouragent/apis/auth-your-agent-cloud-slice/revisions/196372971a43?raw)