### GET /v1/admin/models/{model_id}/examples/{id}

Source: https://api.runflow.io/v1/openapi.json

Retrieve a single model example by ID.

```markdown
### Parameters

- **id** (string (uuid), path, required)
- **model_id** (string, path, required): Model ID

### Responses

#### 200 - The requested model example.

**models__model_content__ModelExample__FullValidator**
- **id** (string (uuid))
- **model_id** (string (uuid))
- **title** (string)
- **description** (string)
- **input** (object)
- **output** (object)
- **status_code** (integer)
- **cost** (string)
- **start_type** (string)
- **timing** (object)
- **duration_ms** (integer)
- **total_ms** (integer)
- **thumbnail_url** (string)
- **category_code** (string)
- **is_featured** (boolean)
- **is_public** (boolean)
- **sort_order** (integer)
- **ran_at** (string (date-time))
- **created_at** (string (date-time))
- **updated_at** (string (date-time))

#### 400 - Bad request

**ErrorResponse**
- **code** (string) (required)
- **message** (string) (required)
- **errors** (array (object))

#### 401 - Unauthorized

**ErrorResponse**
- **code** (string) (required)
- **message** (string) (required)
- **errors** (array (object))

#### 403 - Forbidden — inspect response body `code` for the specific reason (for example: PERMISSION_DENIED, EMAIL_NOT_VERIFIED, ORGANIZATION_MEMBERSHIP_REQUIRED, ROLE_UNRESOLVED, IMPERSONATION_READ_ONLY)

**ErrorResponse**
- **code** (string) (required)
- **message** (string) (required)
- **errors** (array (object))

#### 404 - Not found

**ErrorResponse**
- **code** (string) (required)
- **message** (string) (required)
- **errors** (array (object))

#### 422 - Validation error

**ErrorResponse**
- **code** (string) (required)
- **message** (string) (required)
- **errors** (array (object))

### Example Usage

```bash
curl -X GET "https://api.example.com/v1/admin/models/{model_id}/examples/{id}"
```

```

--------------------------------

### GET /v1/admin/models/{model_id}/examples

Source: https://api.runflow.io/v1/openapi.json

List model examples with filtering, sorting, and pagination.

```markdown
### Parameters

- **model_id** (string, path, required): Model ID
- **q** (union, query, optional): ANTLR filter expression
- **limit** (union, query, optional): Page size
- **sort_by** (union, query, optional): Sort expression (e.g. created_at:desc)
- **fields** (union, query, optional): Field projection (e.g. id,name)
- **pq** (union, query, optional): Pagination cursor query
- **from_prev** (boolean, query, optional): Backward pagination flag

### Responses

#### 200 - Paginated model example list.

**models__model_content__ModelExample__SearchValidator**
- **items** (array (models__model_content__ModelExample__FullValidator)) (required)
  Array items:
    - **id** (string (uuid))
    - **model_id** (string (uuid))
    - **title** (string)
    - **description** (string)
    - **input** (object)
    - **output** (object)
    - **status_code** (integer)
    - **cost** (string)
    - **start_type** (string)
    - **timing** (object)
    - **duration_ms** (integer)
    - **total_ms** (integer)
    - **thumbnail_url** (string)
    - **category_code** (string)
    - **is_featured** (boolean)
    - **is_public** (boolean)
    - **sort_order** (integer)
    - **ran_at** (string (date-time))
    - **created_at** (string (date-time))
    - **updated_at** (string (date-time))
- **first** (string)
- **next** (string)
- **previous** (string)

#### 400 - Bad request

**ErrorResponse**
- **code** (string) (required)
- **message** (string) (required)
- **errors** (array (object))

#### 401 - Unauthorized

**ErrorResponse**
- **code** (string) (required)
- **message** (string) (required)
- **errors** (array (object))

#### 403 - Forbidden — inspect response body `code` for the specific reason (for example: PERMISSION_DENIED, EMAIL_NOT_VERIFIED, ORGANIZATION_MEMBERSHIP_REQUIRED, ROLE_UNRESOLVED, IMPERSONATION_READ_ONLY)

**ErrorResponse**
- **code** (string) (required)
- **message** (string) (required)
- **errors** (array (object))

#### 422 - Validation error

**ErrorResponse**
- **code** (string) (required)
- **message** (string) (required)
- **errors** (array (object))

### Example Usage

```bash
curl -X GET "https://api.example.com/v1/admin/models/{model_id}/examples?q=value&limit=value&sort_by=value&fields=value&pq=value&from_prev=false"
```

```

--------------------------------

### GET /v1/models/example-categories/{code}

Source: https://api.runflow.io/v1/openapi.json

Return a single Model Example Category record by its primary key.

```markdown
### Parameters

- **code** (string, path, required)

### Responses

#### 200 - Model Example Category record

**ModelExampleCategoryReferenceFullValidator**
- **code** (string)
- **display_name** (string)
- **sort_order** (integer)
- **is_active** (boolean)
- **created_at** (string (date-time))
- **updated_at** (string (date-time))

#### 401 - Unauthorized

**ErrorResponse**
- **code** (string) (required)
- **message** (string) (required)
- **errors** (array (object))

#### 403 - Email verification required (EMAIL_NOT_VERIFIED)

**ErrorResponse**
- **code** (string) (required)
- **message** (string) (required)
- **errors** (array (object))

#### 404 - Not found

**ErrorResponse**
- **code** (string) (required)
- **message** (string) (required)
- **errors** (array (object))

#### 422 - Validation error

**ErrorResponse**
- **code** (string) (required)
- **message** (string) (required)
- **errors** (array (object))

### Example Usage

```bash
curl -X GET "https://api.example.com/v1/models/example-categories/{code}"
```

```

--------------------------------

### GET /v1/models/{model_id}/examples

Source: https://api.runflow.io/v1/openapi.json

List model examples with filtering, sorting, and pagination. Use 'any' as model_id to search across all parents in the organization.

```markdown
### Parameters

- **model_id** (string, path, required): Model ID. Use 'any' to search across all parents.
- **q** (union, query, optional): ANTLR filter expression
- **limit** (union, query, optional): Page size
- **sort_by** (union, query, optional): Sort expression (e.g. created_at:desc)
- **fields** (union, query, optional): Field projection (e.g. id,name)
- **pq** (union, query, optional): Pagination cursor query
- **from_prev** (boolean, query, optional): Backward pagination flag
- **X-Organization-Id** (union, header, optional)

### Responses

#### 200 - Paginated model example list.

**models__model_content__ModelExample__SearchValidator**
- **items** (array (models__model_content__ModelExample__FullValidator)) (required)
  Array items:
    - **id** (string (uuid))
    - **model_id** (string (uuid))
    - **title** (string)
    - **description** (string)
    - **input** (object)
    - **output** (object)
    - **status_code** (integer)
    - **cost** (string)
    - **start_type** (string)
    - **timing** (object)
    - **duration_ms** (integer)
    - **total_ms** (integer)
    - **thumbnail_url** (string)
    - **category_code** (string)
    - **is_featured** (boolean)
    - **is_public** (boolean)
    - **sort_order** (integer)
    - **ran_at** (string (date-time))
    - **created_at** (string (date-time))
    - **updated_at** (string (date-time))
- **first** (string)
- **next** (string)
- **previous** (string)

#### 400 - Bad request

**ErrorResponse**
- **code** (string) (required)
- **message** (string) (required)
- **errors** (array (object))

#### 401 - Unauthorized

**ErrorResponse**
- **code** (string) (required)
- **message** (string) (required)
- **errors** (array (object))

#### 403 - Forbidden — inspect response body `code` for the specific reason (for example: PERMISSION_DENIED, EMAIL_NOT_VERIFIED, ORGANIZATION_MEMBERSHIP_REQUIRED, ROLE_UNRESOLVED, IMPERSONATION_READ_ONLY)

**ErrorResponse**
- **code** (string) (required)
- **message** (string) (required)
- **errors** (array (object))

#### 422 - Validation error

**ErrorResponse**
- **code** (string) (required)
- **message** (string) (required)
- **errors** (array (object))

### Example Usage

```bash
curl -X GET "https://api.example.com/v1/models/{model_id}/examples?q=value&limit=value&sort_by=value&fields=value&pq=value&from_prev=false"
```

```

--------------------------------

### GET /v1/models/{model_id}/examples/{id}

Source: https://api.runflow.io/v1/openapi.json

Retrieve a single model example by ID. Use 'any' as model_id to skip parent validation.

```markdown
### Parameters

- **id** (string (uuid), path, required)
- **model_id** (string, path, required): Model ID. Use 'any' to search across all parents.
- **X-Organization-Id** (union, header, optional)

### Responses

#### 200 - The requested model example.

**models__model_content__ModelExample__FullValidator**
- **id** (string (uuid))
- **model_id** (string (uuid))
- **title** (string)
- **description** (string)
- **input** (object)
- **output** (object)
- **status_code** (integer)
- **cost** (string)
- **start_type** (string)
- **timing** (object)
- **duration_ms** (integer)
- **total_ms** (integer)
- **thumbnail_url** (string)
- **category_code** (string)
- **is_featured** (boolean)
- **is_public** (boolean)
- **sort_order** (integer)
- **ran_at** (string (date-time))
- **created_at** (string (date-time))
- **updated_at** (string (date-time))

#### 400 - Bad request

**ErrorResponse**
- **code** (string) (required)
- **message** (string) (required)
- **errors** (array (object))

#### 401 - Unauthorized

**ErrorResponse**
- **code** (string) (required)
- **message** (string) (required)
- **errors** (array (object))

#### 403 - Forbidden — inspect response body `code` for the specific reason (for example: PERMISSION_DENIED, EMAIL_NOT_VERIFIED, ORGANIZATION_MEMBERSHIP_REQUIRED, ROLE_UNRESOLVED, IMPERSONATION_READ_ONLY)

**ErrorResponse**
- **code** (string) (required)
- **message** (string) (required)
- **errors** (array (object))

#### 404 - Not found

**ErrorResponse**
- **code** (string) (required)
- **message** (string) (required)
- **errors** (array (object))

#### 422 - Validation error

**ErrorResponse**
- **code** (string) (required)
- **message** (string) (required)
- **errors** (array (object))

### Example Usage

```bash
curl -X GET "https://api.example.com/v1/models/{model_id}/examples/{id}"
```

```

--------------------------------

### GET /v1/admin/models/example-categories

Source: https://api.runflow.io/v1/openapi.json

Return all Model Example Category reference records with optional filtering and sorting.

```markdown
### Parameters

- **q** (union, query, optional): Search filter (ANTLR syntax)
- **sort_by** (union, query, optional): Sort expression (e.g. 'name:asc')
- **limit** (union, query, optional): Page size
- **fields** (union, query, optional): Field projection
- **pq** (union, query, optional): Previous-page query
- **from_prev** (boolean, query, optional): Backward pagination flag

### Responses

#### 200 - Paginated list of Model Example Category records

**SearchResponse_ModelExampleCategoryReferenceFullValidator_**
- **items** (array (ModelExampleCategoryReferenceFullValidator)) (required)
  Array items:
    - **code** (string)
    - **display_name** (string)
    - **sort_order** (integer)
    - **is_active** (boolean)
    - **created_at** (string (date-time))
    - **updated_at** (string (date-time))
- **first** (string)
- **next** (string)
- **previous** (string)

#### 401 - Unauthorized

**ErrorResponse**
- **code** (string) (required)
- **message** (string) (required)
- **errors** (array (object))

#### 403 - Permission denied (PERMISSION_DENIED) or email not verified (EMAIL_NOT_VERIFIED)

**ErrorResponse**
- **code** (string) (required)
- **message** (string) (required)
- **errors** (array (object))

#### 422 - Validation error

**ErrorResponse**
- **code** (string) (required)
- **message** (string) (required)
- **errors** (array (object))

### Example Usage

```bash
curl -X GET "https://api.example.com/v1/admin/models/example-categories?q=value&sort_by=value&limit=value&fields=value&pq=value&from_prev=false"
```

```

--------------------------------

### GET /v1/models/example-categories

Source: https://api.runflow.io/v1/openapi.json

Return all Model Example Category reference records with optional filtering and sorting.

```markdown
### Parameters

- **q** (union, query, optional): Search filter (ANTLR syntax)
- **sort_by** (union, query, optional): Sort expression (e.g. 'name:asc')
- **limit** (union, query, optional): Page size
- **fields** (union, query, optional): Field projection
- **pq** (union, query, optional): Previous-page query
- **from_prev** (boolean, query, optional): Backward pagination flag

### Responses

#### 200 - Paginated list of Model Example Category records

**SearchResponse_ModelExampleCategoryReferenceFullValidator_**
- **items** (array (ModelExampleCategoryReferenceFullValidator)) (required)
  Array items:
    - **code** (string)
    - **display_name** (string)
    - **sort_order** (integer)
    - **is_active** (boolean)
    - **created_at** (string (date-time))
    - **updated_at** (string (date-time))
- **first** (string)
- **next** (string)
- **previous** (string)

#### 401 - Unauthorized

**ErrorResponse**
- **code** (string) (required)
- **message** (string) (required)
- **errors** (array (object))

#### 403 - Email verification required (EMAIL_NOT_VERIFIED)

**ErrorResponse**
- **code** (string) (required)
- **message** (string) (required)
- **errors** (array (object))

#### 422 - Validation error

**ErrorResponse**
- **code** (string) (required)
- **message** (string) (required)
- **errors** (array (object))

### Example Usage

```bash
curl -X GET "https://api.example.com/v1/models/example-categories?q=value&sort_by=value&limit=value&fields=value&pq=value&from_prev=false"
```

```

--------------------------------

### GET /v1/admin/models/example-categories/{code}

Source: https://api.runflow.io/v1/openapi.json

Return a single Model Example Category record by its primary key.

```markdown
### Parameters

- **code** (string, path, required)

### Responses

#### 200 - Model Example Category record

**ModelExampleCategoryReferenceFullValidator**
- **code** (string)
- **display_name** (string)
- **sort_order** (integer)
- **is_active** (boolean)
- **created_at** (string (date-time))
- **updated_at** (string (date-time))

#### 401 - Unauthorized

**ErrorResponse**
- **code** (string) (required)
- **message** (string) (required)
- **errors** (array (object))

#### 403 - Permission denied (PERMISSION_DENIED) or email not verified (EMAIL_NOT_VERIFIED)

**ErrorResponse**
- **code** (string) (required)
- **message** (string) (required)
- **errors** (array (object))

#### 404 - Not found

**ErrorResponse**
- **code** (string) (required)
- **message** (string) (required)
- **errors** (array (object))

#### 422 - Validation error

**ErrorResponse**
- **code** (string) (required)
- **message** (string) (required)
- **errors** (array (object))

### Example Usage

```bash
curl -X GET "https://api.example.com/v1/admin/models/example-categories/{code}"
```

```

--------------------------------

### GET /v1/solutions

Source: https://api.runflow.io/v1/openapi.json

List solutions with filtering, sorting, and pagination.

```markdown
### Parameters

- **q** (union, query, optional): ANTLR filter expression
- **limit** (union, query, optional): Page size
- **sort_by** (union, query, optional): Sort expression (e.g. created_at:desc)
- **fields** (union, query, optional): Field projection (e.g. id,name)
- **embed** (union, query, optional): Relation embedding. Available values: solution_comfyui_workflows, solution_flows, solution_models. Use a comma-separated list to request multiple embeds.
- **pq** (union, query, optional): Pagination cursor query
- **from_prev** (boolean, query, optional): Backward pagination flag
- **X-Organization-Id** (union, header, optional)

### Responses

#### 200 - Paginated solution list.

**models__solution__Solution__SearchValidator**
- **items** (array (models__solution__Solution__FullValidator)) (required)
  Array items:
    - **id** (string (uuid))
    - **title** (string)
    - **subtitle** (string)
    - **slug** (string)
    - **icon** (string)
    - **accent_color** (string)
    - **gradient_start** (string)
    - **gradient_end** (string)
    - **content_markdown** (string)
    - **section_code** (string)
    - **sort_order** (integer)
    - **is_active** (boolean)
    - **created_at** (string (date-time))
    - **updated_at** (string (date-time))
    - **solution_flows** (array (models__solution__SolutionFlow__FullValidator))
      Array items:
    - **solution_models** (array (models__solution__SolutionModel__FullValidator))
      Array items:
    - **solution_comfyui_workflows** (array (models__solution__SolutionComfyuiWorkflow__FullValidator))
      Array items:
- **first** (string)
- **next** (string)
- **previous** (string)

#### 400 - Bad request

**ErrorResponse**
- **code** (string) (required)
- **message** (string) (required)
- **errors** (array (object))

#### 401 - Unauthorized

**ErrorResponse**
- **code** (string) (required)
- **message** (string) (required)
- **errors** (array (object))

#### 403 - Forbidden — inspect response body `code` for the specific reason (for example: PERMISSION_DENIED, EMAIL_NOT_VERIFIED, ORGANIZATION_MEMBERSHIP_REQUIRED, ROLE_UNRESOLVED, IMPERSONATION_READ_ONLY)

**ErrorResponse**
- **code** (string) (required)
- **message** (string) (required)
- **errors** (array (object))

#### 422 - Validation error

**ErrorResponse**
- **code** (string) (required)
- **message** (string) (required)
- **errors** (array (object))

### Example Usage

```bash
curl -X GET "https://api.example.com/v1/solutions?q=value&limit=value&sort_by=value&fields=value&embed=value&pq=value&from_prev=false"
```

```

--------------------------------

### GET /v1/admin/solutions

Source: https://api.runflow.io/v1/openapi.json

List solutions with filtering, sorting, and pagination.

```markdown
### Parameters

- **q** (union, query, optional): ANTLR filter expression
- **limit** (union, query, optional): Page size
- **sort_by** (union, query, optional): Sort expression (e.g. created_at:desc)
- **fields** (union, query, optional): Field projection (e.g. id,name)
- **embed** (union, query, optional): Relation embedding. Available values: solution_comfyui_workflows, solution_flows, solution_models. Use a comma-separated list to request multiple embeds.
- **pq** (union, query, optional): Pagination cursor query
- **from_prev** (boolean, query, optional): Backward pagination flag

### Responses

#### 200 - Paginated solution list.

**models__solution__Solution__SearchValidator**
- **items** (array (models__solution__Solution__FullValidator)) (required)
  Array items:
    - **id** (string (uuid))
    - **title** (string)
    - **subtitle** (string)
    - **slug** (string)
    - **icon** (string)
    - **accent_color** (string)
    - **gradient_start** (string)
    - **gradient_end** (string)
    - **content_markdown** (string)
    - **section_code** (string)
    - **sort_order** (integer)
    - **is_active** (boolean)
    - **created_at** (string (date-time))
    - **updated_at** (string (date-time))
    - **solution_flows** (array (models__solution__SolutionFlow__FullValidator))
      Array items:
    - **solution_models** (array (models__solution__SolutionModel__FullValidator))
      Array items:
    - **solution_comfyui_workflows** (array (models__solution__SolutionComfyuiWorkflow__FullValidator))
      Array items:
- **first** (string)
- **next** (string)
- **previous** (string)

#### 401 - Unauthorized

**ErrorResponse**
- **code** (string) (required)
- **message** (string) (required)
- **errors** (array (object))

#### 403 - Permission denied (PERMISSION_DENIED) or email not verified (EMAIL_NOT_VERIFIED)

**ErrorResponse**
- **code** (string) (required)
- **message** (string) (required)
- **errors** (array (object))

#### 422 - Validation error

**ErrorResponse**
- **code** (string) (required)
- **message** (string) (required)
- **errors** (array (object))

### Example Usage

```bash
curl -X GET "https://api.example.com/v1/admin/solutions?q=value&limit=value&sort_by=value&fields=value&embed=value&pq=value&from_prev=false"
```

```

--------------------------------

### GET /v1/assets

Source: https://api.runflow.io/v1/openapi.json

List assets with filtering, sorting, and pagination.

```markdown
### Parameters

- **add_signature** (boolean, query, optional): Replace url and thumbnail_url with presigned GET URLs valid for up to 1 week. Default: true on detail (GET /assets/{id}), false on search (GET /assets). When false, storage does not need to be configured.
- **q** (union, query, optional): ANTLR filter expression
- **limit** (union, query, optional): Page size
- **sort_by** (union, query, optional): Sort expression (e.g. created_at:desc)
- **fields** (union, query, optional): Field projection (e.g. id,name)
- **embed** (union, query, optional): Relation embedding. Available values: created_by_user. Use a comma-separated list to request multiple embeds.
- **pq** (union, query, optional): Pagination cursor query
- **from_prev** (boolean, query, optional): Backward pagination flag
- **X-Organization-Id** (union, header, optional)

### Responses

#### 200 - Paginated asset list.

**models__asset__Asset__SearchValidator**
- **items** (array (models__asset__Asset__FullValidator)) (required)
  Array items:
    - **id** (string (uuid))
    - **org_id** (string (uuid))
    - **folder_id** (string (uuid))
    - **name** (string)
    - **r2_key** (string)
    - **url** (string)
    - **thumbnail_url** (string)
    - **mime_type** (string)
    - **size_bytes** (integer)
    - **asset_type** (string)
    - **source_type** (string)
    - **source_id** (string)
    - **created_by** (string (uuid))
    - **created_at** (string (date-time))
    - **updated_at** (string (date-time))
    - **deleted_at** (string (date-time))
    - **deleted_by** (string (uuid))
    - **created_by_user** (object): Minimal user shape for embedded user fields.

Includes only display-relevant fields. Excludes sensitive/admin
fields: email_verified_at, disabled_at, is_internal, locale_code,
timezone.
      - **id** (string (uuid)) (required)
      - **email** (string) (required)
      - **first_name** (string) (required)
      - **last_name** (string) (required)
      - **avatar_url** (string) (required)
- **first** (string)
- **next** (string)
- **previous** (string)

#### 400 - Bad request

**ErrorResponse**
- **code** (string) (required)
- **message** (string) (required)
- **errors** (array (object))

#### 401 - Unauthorized

**ErrorResponse**
- **code** (string) (required)
- **message** (string) (required)
- **errors** (array (object))

#### 403 - Forbidden — inspect response body `code` for the specific reason (for example: PERMISSION_DENIED, EMAIL_NOT_VERIFIED, ORGANIZATION_MEMBERSHIP_REQUIRED, ROLE_UNRESOLVED, IMPERSONATION_READ_ONLY)

**ErrorResponse**
- **code** (string) (required)
- **message** (string) (required)
- **errors** (array (object))

#### 422 - Validation error

**ErrorResponse**
- **code** (string) (required)
- **message** (string) (required)
- **errors** (array (object))

### Example Usage

```bash
curl -X GET "https://api.example.com/v1/assets?add_signature=false&q=value&limit=value&sort_by=value&fields=value&embed=value&pq=value&from_prev=false"
```

```

--------------------------------

### POST /v1/admin/models/{model_id}/examples

Source: https://api.runflow.io/v1/openapi.json

Create a new model example.

```markdown
### Parameters

- **model_id** (string, path, required): Model ID

### Request Body

**Content-Type:** application/json

- **title** (string)
- **description** (string)
- **input** (object) (required)
- **output** (object)
- **status_code** (integer)
- **cost** (number)
- **start_type** (string)
- **timing** (object)
- **duration_ms** (integer)
- **total_ms** (integer)
- **thumbnail_url** (string)
- **category_code** (string)
- **is_featured** (boolean)
- **is_public** (boolean)
- **sort_order** (integer)
- **ran_at** (string (date-time))

### Responses

#### 201 - The created model example.

**models__model_content__ModelExample__FullValidator**
- **id** (string (uuid))
- **model_id** (string (uuid))
- **title** (string)
- **description** (string)
- **input** (object)
- **output** (object)
- **status_code** (integer)
- **cost** (string)
- **start_type** (string)
- **timing** (object)
- **duration_ms** (integer)
- **total_ms** (integer)
- **thumbnail_url** (string)
- **category_code** (string)
- **is_featured** (boolean)
- **is_public** (boolean)
- **sort_order** (integer)
- **ran_at** (string (date-time))
- **created_at** (string (date-time))
- **updated_at** (string (date-time))

#### 400 - Bad request

**ErrorResponse**
- **code** (string) (required)
- **message** (string) (required)
- **errors** (array (object))

#### 401 - Unauthorized

**ErrorResponse**
- **code** (string) (required)
- **message** (string) (required)
- **errors** (array (object))

#### 403 - Forbidden — inspect response body `code` for the specific reason (for example: PERMISSION_DENIED, EMAIL_NOT_VERIFIED, ORGANIZATION_MEMBERSHIP_REQUIRED, ROLE_UNRESOLVED, IMPERSONATION_READ_ONLY)

**ErrorResponse**
- **code** (string) (required)
- **message** (string) (required)
- **errors** (array (object))

#### 409 - Conflict

**ErrorResponse**
- **code** (string) (required)
- **message** (string) (required)
- **errors** (array (object))

#### 422 - Validation error

**ErrorResponse**
- **code** (string) (required)
- **message** (string) (required)
- **errors** (array (object))

### Example Usage

```bash
curl -X POST "https://api.example.com/v1/admin/models/{model_id}/examples" \
  -H "Content-Type: application/json" \
  -d '{
  "title": "value",
  "description": "value",
  "input": "value",
  "output": "value",
  "status_code": "value",
  "cost": "value",
  "start_type": "value",
  "timing": "value",
  "duration_ms": "value",
  "total_ms": "value",
  "thumbnail_url": "value",
  "category_code": "value",
  "is_featured": "false",
  "is_public": "true",
  "sort_order": "0",
  "ran_at": "value"
}'
```

```

--------------------------------

### POST /v1/billing/setup-sessions

Source: https://api.runflow.io/v1/openapi.json

Create a Stripe Checkout session in setup mode to save a card without charging.

```markdown
### Parameters

- **X-Organization-Id** (union, header, optional)

### Responses

#### 200 - Successful Response

**CheckoutSessionResponse**
- **session_id** (string) (required)
- **url** (string) (required)

#### 400 - Bad request

**ErrorResponse**
- **code** (string) (required)
- **message** (string) (required)
- **errors** (array (object))

#### 401 - Unauthorized

**ErrorResponse**
- **code** (string) (required)
- **message** (string) (required)
- **errors** (array (object))

#### 403 - Forbidden — inspect response body `code` for the specific reason (for example: PERMISSION_DENIED, EMAIL_NOT_VERIFIED, ORGANIZATION_MEMBERSHIP_REQUIRED, ROLE_UNRESOLVED, IMPERSONATION_READ_ONLY)

**ErrorResponse**
- **code** (string) (required)
- **message** (string) (required)
- **errors** (array (object))

#### 409 - Conflict

**ErrorResponse**
- **code** (string) (required)
- **message** (string) (required)
- **errors** (array (object))

#### 422 - Validation error

**ErrorResponse**
- **code** (string) (required)
- **message** (string) (required)
- **errors** (array (object))

### Example Usage

```bash
curl -X POST "https://api.example.com/v1/billing/setup-sessions"
```

```

--------------------------------

### POST /v1/admin/solutions

Source: https://api.runflow.io/v1/openapi.json

Create a new solution.

```markdown
### Request Body

**Content-Type:** application/json

- **title** (string) (required)
- **subtitle** (string)
- **slug** (string) (required)
- **icon** (string)
- **accent_color** (string)
- **gradient_start** (string)
- **gradient_end** (string)
- **content_markdown** (string)
- **section_code** (string) (required)
- **sort_order** (integer)

### Responses

#### 201 - The created solution.

**models__solution__Solution__FullValidator**
- **id** (string (uuid))
- **title** (string)
- **subtitle** (string)
- **slug** (string)
- **icon** (string)
- **accent_color** (string)
- **gradient_start** (string)
- **gradient_end** (string)
- **content_markdown** (string)
- **section_code** (string)
- **sort_order** (integer)
- **is_active** (boolean)
- **created_at** (string (date-time))
- **updated_at** (string (date-time))
- **solution_flows** (array (models__solution__SolutionFlow__FullValidator))
  Array items:
- **solution_models** (array (models__solution__SolutionModel__FullValidator))
  Array items:
- **solution_comfyui_workflows** (array (models__solution__SolutionComfyuiWorkflow__FullValidator))
  Array items:

#### 400 - Bad request

**ErrorResponse**
- **code** (string) (required)
- **message** (string) (required)
- **errors** (array (object))

#### 401 - Unauthorized

**ErrorResponse**
- **code** (string) (required)
- **message** (string) (required)
- **errors** (array (object))

#### 403 - Forbidden — inspect response body `code` for the specific reason (for example: PERMISSION_DENIED, EMAIL_NOT_VERIFIED, ORGANIZATION_MEMBERSHIP_REQUIRED, ROLE_UNRESOLVED, IMPERSONATION_READ_ONLY)

**ErrorResponse**
- **code** (string) (required)
- **message** (string) (required)
- **errors** (array (object))

#### 409 - Conflict

**ErrorResponse**
- **code** (string) (required)
- **message** (string) (required)
- **errors** (array (object))

#### 422 - Validation error

**ErrorResponse**
- **code** (string) (required)
- **message** (string) (required)
- **errors** (array (object))

### Example Usage

```bash
curl -X POST "https://api.example.com/v1/admin/solutions" \
  -H "Content-Type: application/json" \
  -d '{
  "title": "string",
  "subtitle": "value",
  "slug": "string",
  "icon": "value",
  "accent_color": "value",
  "gradient_start": "value",
  "gradient_end": "value",
  "content_markdown": "value",
  "section_code": "string",
  "sort_order": "0"
}'
```

```

--------------------------------

### POST /v1/docs

Source: https://api.runflow.io/v1/openapi.json

Create a new doc page.

```markdown
### Parameters

- **X-Organization-Id** (union, header, optional)

### Request Body

**Content-Type:** application/json

- **slug** (string) (required)
- **title** (string) (required)
- **section_code** (string) (required)
- **content** (string) (required)
- **sort_order** (integer)
- **published** (boolean)

### Responses

#### 201 - The created doc page.

**models__doc__DocPage__FullValidator**
- **id** (string (uuid))
- **slug** (string)
- **title** (string)
- **section_code** (string)
- **content** (string)
- **sort_order** (integer)
- **published** (boolean)
- **created_at** (string (date-time))
- **updated_at** (string (date-time))

#### 400 - Bad request

**ErrorResponse**
- **code** (string) (required)
- **message** (string) (required)
- **errors** (array (object))

#### 401 - Unauthorized

**ErrorResponse**
- **code** (string) (required)
- **message** (string) (required)
- **errors** (array (object))

#### 403 - Forbidden — inspect response body `code` for the specific reason (for example: PERMISSION_DENIED, EMAIL_NOT_VERIFIED, ORGANIZATION_MEMBERSHIP_REQUIRED, ROLE_UNRESOLVED, IMPERSONATION_READ_ONLY)

**ErrorResponse**
- **code** (string) (required)
- **message** (string) (required)
- **errors** (array (object))

#### 409 - Conflict

**ErrorResponse**
- **code** (string) (required)
- **message** (string) (required)
- **errors** (array (object))

#### 422 - Validation error

**ErrorResponse**
- **code** (string) (required)
- **message** (string) (required)
- **errors** (array (object))

### Example Usage

```bash
curl -X POST "https://api.example.com/v1/docs" \
  -H "Content-Type: application/json" \
  -d '{
  "slug": "string",
  "title": "string",
  "section_code": "string",
  "content": "string",
  "sort_order": "value",
  "published": "value"
}'
```

```

--------------------------------

### GET /v1/batches/{batch_id}/callback

Source: https://api.runflow.io/v1/openapi.json

Get callback delivery history for a batch (with attempts eager-loaded).

```markdown
### Parameters

- **batch_id** (string (uuid), path, required)
- **X-Organization-Id** (union, header, optional)

### Responses

#### 200 - Successful Response

- Array of models__batch_callback_delivery__BatchCallbackDelivery__FullValidator

#### 400 - Bad request

**ErrorResponse**
- **code** (string) (required)
- **message** (string) (required)
- **errors** (array (object))

#### 401 - Unauthorized

**ErrorResponse**
- **code** (string) (required)
- **message** (string) (required)
- **errors** (array (object))

#### 403 - Forbidden — inspect response body `code` for the specific reason (for example: PERMISSION_DENIED, EMAIL_NOT_VERIFIED, ORGANIZATION_MEMBERSHIP_REQUIRED, ROLE_UNRESOLVED, IMPERSONATION_READ_ONLY)

**ErrorResponse**
- **code** (string) (required)
- **message** (string) (required)
- **errors** (array (object))

#### 404 - Not found

**ErrorResponse**
- **code** (string) (required)
- **message** (string) (required)
- **errors** (array (object))

#### 422 - Validation error

**ErrorResponse**
- **code** (string) (required)
- **message** (string) (required)
- **errors** (array (object))

### Example Usage

```bash
curl -X GET "https://api.example.com/v1/batches/{batch_id}/callback"
```

```

--------------------------------

### GET /v1/auth/oauth/google/authorize

Source: https://api.runflow.io/v1/openapi.json

Get the Google OAuth authorization URL.

Frontend redirects user to this URL to begin the OAuth flow.
Works unauthenticated (login/register) and authenticated (account linking).

```markdown
### Parameters

- **redirect_uri** (string, query, required): Frontend callback URL

### Responses

#### 200 - Successful Response

**OAuthAuthorizeResponse**
- **authorization_url** (string) (required)
- **state** (string) (required)

#### 422 - Validation Error

**HTTPValidationError**
- **detail** (array (ValidationError))
  Array items:
    - **loc** (array (union)) (required)
    - **msg** (string) (required)
    - **type** (string) (required)
    - **input** (unknown)
    - **ctx** (object)

### Example Usage

```bash
curl -X GET "https://api.example.com/v1/auth/oauth/google/authorize?redirect_uri=string"
```

```

--------------------------------

### GET /v1/batches/{batch_id}

Source: https://api.runflow.io/v1/openapi.json

Get a batch by id with an inline lean items[] for polling.

``items[]`` is always the joined ``batch_items × runs`` handle
projection (see :class:`models.batch.BatchItemHandle`) so customers
don't need a second request to address each item. For the full
per-item projection (input/output/cost/timestamps), use the
paginated ``GET /batches/{id}/items`` endpoint.

```markdown
### Parameters

- **batch_id** (string (uuid), path, required)
- **X-Organization-Id** (union, header, optional)

### Responses

#### 200 - Successful Response

**models__batch__Batch__FullValidator**
- **id** (string (uuid))
- **org_id** (string (uuid))
- **target_type_code** (string)
- **target_type** (string)
- **target_id** (string (uuid))
- **status_code** (string)
- **source_code** (string)
- **items_total** (integer)
- **items_succeeded** (integer)
- **items_failed** (integer)
- **items_cancelled** (integer)
- **input** (array (object))
- **resolved_template_id** (string (uuid))
- **dispatch_provider_link_id** (string (uuid))
- **cost** (string)
- **output** (object)
- **metadata** (object)
- **callback_url** (string)
- **duration_ms** (integer)
- **failure_code** (string)
- **failure_message** (string)
- **failure_stage_code** (string)
- **created_by** (string (uuid))
- **created_at** (string (date-time))
- **started_at** (string (date-time))
- **completed_at** (string (date-time))
- **links** (object)
- **items** (array (BatchItemHandle))
  Array items:
    - **id** (string (uuid)) (required)
    - **sequence_index** (integer) (required)
    - **client_ref** (string)
    - **run_id** (string (uuid)) (required)
    - **status_code** (string) (required)

#### 400 - Bad request

**ErrorResponse**
- **code** (string) (required)
- **message** (string) (required)
- **errors** (array (object))

#### 401 - Unauthorized

**ErrorResponse**
- **code** (string) (required)
- **message** (string) (required)
- **errors** (array (object))

#### 403 - Forbidden — inspect response body `code` for the specific reason (for example: PERMISSION_DENIED, EMAIL_NOT_VERIFIED, ORGANIZATION_MEMBERSHIP_REQUIRED, ROLE_UNRESOLVED, IMPERSONATION_READ_ONLY)

**ErrorResponse**
- **code** (string) (required)
- **message** (string) (required)
- **errors** (array (object))

#### 404 - Not found

**ErrorResponse**
- **code** (string) (required)
- **message** (string) (required)
- **errors** (array (object))

#### 422 - Validation error

**ErrorResponse**
- **code** (string) (required)
- **message** (string) (required)
- **errors** (array (object))

### Example Usage

```bash
curl -X GET "https://api.example.com/v1/batches/{batch_id}"
```

```

--------------------------------

### Schema: BatchItemHandle

Source: https://api.runflow.io/v1/openapi.json

Lean per-item correlation handle for POST /batches responses and
``GET /batches/{id}`` inline items. For the full per-item projection
(input/output/cost/timestamps), use ``GET /batches/{id}/items``.

```markdown
## Schema: BatchItemHandle

Lean per-item correlation handle for POST /batches responses and
``GET /batches/{id}`` inline items. For the full per-item projection
(input/output/cost/timestamps), use ``GET /batches/{id}/items``.

**Type:** object

- **id** (string (uuid)) (required)
- **sequence_index** (integer) (required)
- **client_ref** (string)
- **run_id** (string (uuid)) (required)
- **status_code** (string) (required)

```

--------------------------------

### Schema: CheckoutSessionStatusResponse

Source: https://api.runflow.io/v1/openapi.json

Response for GET /billing/checkout-sessions/{session_id}/status.

```markdown
## Schema: CheckoutSessionStatusResponse

Response for GET /billing/checkout-sessions/{session_id}/status.

**Type:** object

- **stripe_status** (string) (required)
- **payment_status** (string)
- **fulfilled** (boolean) (required)

```