---
title: "Resume Agent Run"
method: POST
path: "/v1/organizations/{org_id}/agent/run/resume"
tags: ["agents", "agents", "agents"]
---

# Resume Agent Run

`POST /v1/organizations/{org_id}/agent/run/resume`

Resume a paused agent run.

Resumes a paused agent run, allowing it to continue processing.

Note: Setup commands agents are automatically routed to their dedicated resume function.

## Path parameters

- `org_id` integer, required

## Headers

- `authorization` unknown

## Request body

- ResumeAgentRunInput
  - `agent_run_id` integer, required
  - `prompt` string, required
  - `images` string[], nullable — List of base64 encoded data URIs representing images to be processed by the agent

## Response `200`

Successful Response

- AgentRunResponse — Represents an agent run in API responses
  - `id` integer, required
  - `organization_id` integer, required
  - `status` string, nullable
  - `created_at` string, nullable
  - `web_url` string, nullable
  - `result` string, nullable
  - `summary` string, nullable
  - `source_type` 'LOCAL' | 'SLACK' | 'GITHUB' | 'GITHUB_CHECK_SUITE' | 'GITHUB_PR_REVIEW' | 'LINEAR' | 'API' | 'CHAT' | 'JIRA' | 'CLICKUP' | 'MONDAY' | 'SETUP_COMMANDS'
  - `github_pull_requests` GithubPullRequestResponse[], nullable
    - `id` integer, required
    - `title` string, nullable
    - `url` string, nullable
    - `created_at` string, required
    - `head_branch_name` string, nullable
  - `metadata` object, nullable

## Other responses

- `403` — Forbidden
- `404` — Not Found
- `422` — Validation Error
- `429` — Too Many Requests

## Changes

- **2025-08-21** `a0215d4f2c07` — 1 warning
  - added the new `SETUP_COMMANDS` enum value to the `source_type/anyOf[subschema #1: ApiAgentRunSourceType]/` response property for the response status `200`
- **2025-08-15** `69bfde65bf75` — 4 breaking, 3 warning, 2 info
  - the response property `github_pull_requests/anyOf[subschema #1]/items/title` became optional for the status `200`
  - the response property `github_pull_requests/anyOf[subschema #1]/items/url` became optional for the status `200`
  - response property `github_pull_requests/anyOf[subschema #1]/items/title` list-of-types was widened by adding types `null` to media type `application/json` of response `200`
  - response property `github_pull_requests/anyOf[subschema #1]/items/url` list-of-types was widened by adding types `null` to media type `application/json` of response `200`
  - …5 more
- **2025-06-26** `4b2b8862eea6` — 1 info
  - endpoint added

[Change history](https://skmtc.dev/codegen-sh/apis/developer-api/changes/v1/organizations/:org_id/agent/run/resume/post.md)

---

[API](https://skmtc.dev/codegen-sh/apis/developer-api.md) · [All operations](https://skmtc.dev/codegen-sh/apis/developer-api/llms.txt) · [OpenAPI document](https://skmtc-service-production.skmtc.workers.dev/v1/apis/codegen-sh/developer-api/revisions/e68a3133f727/schema)