---
title: "POST /agent_runners"
method: POST
path: "/agent_runners"
tags: ["agentRunner"]
---

# POST /agent_runners

`POST /agent_runners`

## Query parameters

- `site_id` string, required
- `deploy_id` string
- `branch` string
- `prompt` string
- `agent` string
- `model` string
- `parent_agent_runner_id` string
- `dev_server_image` string
- `file_keys` string[]

## Response `200`

OK

- AgentRunner
  - `id` string
  - `site_id` string
  - `parent_agent_runner_id` string
  - `state` string
  - `created_at` string, dateTime
  - `updated_at` string, dateTime
  - `done_at` string, dateTime
  - `title` string
  - `branch` string
  - `result_branch` string
  - `pr_url` string
  - `pr_branch` string
  - `pr_state` string
  - `pr_number` integer
  - `pr_is_being_created` boolean
  - `pr_error` string
  - `current_task` string
  - `result_diff` string
  - `sha` string
  - `merge_commit_sha` string
  - `merge_commit_error` string
  - `merge_commit_is_being_created` boolean
  - `base_deploy_id` string
  - `attached_file_keys` string[]
  - `active_session_created_at` string, dateTime
  - `latest_session_deploy_id` string
  - `latest_session_deploy_url` string
  - `user` AgentRunnerUser
    - `id` string
    - `full_name` string
    - `email` string
    - `avatar_url` string

## Other responses

- `404` — Not Found
- `422` — Unprocessable Entity
- `default` — error

---

[API](https://skmtc.net/netlify/apis/netlify-s-api-documentation.md) · [All operations](https://skmtc.net/netlify/apis/netlify-s-api-documentation/llms.txt) · [OpenAPI document](https://skmtc-service-staging.skmtc.workers.dev/v1/apis/netlify/netlify-s-api-documentation/revisions/71540d1b5d9d/schema)