---
title: "Create v2 run"
method: POST
path: "/agent/v2/run"
tags: ["Agents"]
---

# Create v2 run

`POST /agent/v2/run`

Creates a v2 run in queued state. Call POST /agent/v2/run/:id/exec to start execution on the Daytona runtime.

## Request body

- object
  - `agentId` string, required
  - `prompt` string, required
  - `guidance` string, nullable
  - `model` string, nullable
  - `objectIds` string[], nullable
  - `callbackUrl` string, uri, nullable

## Response `200`

Run created in queued state

- object
  - `id` string
  - `agentId` string
  - `status` 'queued'
  - `objectIds` string[], nullable
  - `createdAt` string, date-time

## Other responses

- `400` — Missing required fields (agentId, prompt)
- `401` — Invalid API key
- `403` — No agent access
- `404` — Agent not found

## Changes

- **2026-03-27** `220d723a75ba` — 1 info
  - endpoint added

[Change history](https://skmtc.dev/casemark/apis/case-dev-api/changes/agent/v2/run/post.md)

---

[API](https://skmtc.dev/casemark/apis/case-dev-api.md) · [All operations](https://skmtc.dev/casemark/apis/case-dev-api/llms.txt) · [OpenAPI document](https://skmtc-service-production.skmtc.workers.dev/v1/apis/casemark/case-dev-api/revisions/2a016c5bb11e/schema)