---
name: actor-builds-routes
description: Handle 6 OpenAPI operation(s) under /v2/actor-builds for the actor builds route group.
---

# actor builds API Routes

Handle 6 OpenAPI operation(s) under /v2/actor-builds for the actor builds route group.

Use the generated operation tools to make real API calls. Do not invent API responses.
If a tool reports missing setup, return the exact setup field name to the caller.
For write, update, or delete operations, state the intended action before calling the tool.

## Operations

### actor_builds_get

- Operation ID: `actor_builds_get`
- Route: `GET /v2/actor-builds`
- Mode: READ
- Summary: Get user builds list
- Parameters:
  - `offset` in `query`
  - `limit` in `query`
  - `desc` in `query`

### actor_build_get

- Operation ID: `actor_build_get`
- Route: `GET /v2/actor-builds/{buildId}`
- Mode: READ
- Summary: Get build
- Parameters:
  - `buildId` in `path` required
  - `waitForFinish` in `query`

### actor_build_delete

- Operation ID: `actor_build_delete`
- Route: `DELETE /v2/actor-builds/{buildId}`
- Mode: WRITE
- Summary: Delete build
- Parameters:
  - `buildId` in `path` required

### actor_build_abort_post

- Operation ID: `actor_build_abort_post`
- Route: `POST /v2/actor-builds/{buildId}/abort`
- Mode: WRITE
- Summary: Abort build
- Parameters:
  - `buildId` in `path` required

### actor_build_log_get

- Operation ID: `actor_build_log_get`
- Route: `GET /v2/actor-builds/{buildId}/log`
- Mode: READ
- Summary: Get build's Log
- Parameters:
  - `buildId` in `path` required
  - `stream` in `query`
  - `download` in `query`

### actor_build_openapi_json_get

- Operation ID: `actor_build_openapi_json_get`
- Route: `GET /v2/actor-builds/{buildId}/openapi.json`
- Mode: READ
- Summary: Get OpenAPI definition
- Parameters:
  - `buildId` in `path` required