---
title: "Patch Action Endpoint"
method: PATCH
path: "/v1/actions/{action_id}"
tags: ["actions"]
---

# Patch Action Endpoint

`PATCH /v1/actions/{action_id}`

## Request

- Base URL: `https://api.actionbox.cloud`
- URL: `https://api.actionbox.cloud/v1/actions/{action_id}`
- Auth: HTTP bearer

## Path parameters

- `action_id` string, required

## Headers

- `authorization` string, nullable

## Request body

- ActionPatch
  - `chat_delivery` 'inherit' | 'disabled', nullable
  - `title` string, nullable
  - `description` string, nullable
  - `priority` 'low' | 'normal' | 'high' | 'urgent'
  - `open_url` string, uri, nullable
  - `controls` ActionControl[], nullable
    - `key` string, required
    - `label` string, required
    - `kind` 'callback' | 'link' | 'actionbox', required
    - `url` string, uri, nullable
    - `destructive` boolean
    - `expires_at` string, date-time, nullable
  - `expires_at` string, date-time, nullable
  - `on_expire` union
    - ReturnExpiredOutcome
      - `type` 'return_expired'
    - ResolveOnExpireOutcome
      - `type` 'resolve', required
      - `response` union, required
        - BooleanResponse
          - `type` 'boolean', required
          - `value` boolean, required
        - TextResponse
          - `type` 'text', required
          - `value` string, required
        - IntegerResponse
          - `type` 'integer', required
          - `value` integer, required
        - NumberResponse
          - `type` 'number', required
          - `value` union, required
            - integer
            - number
        - RatingResponse
          - `type` 'rating', required
          - `value` integer, required
        - SingleChoiceResponse
          - `type` 'single_choice', required
          - `value` string, required
        - MultiChoiceResponse
          - `type` 'multi_choice', required
          - `value` string[], required
        - FormResponse
          - `type` 'form', required
          - `values` object, required
      - `reason` string, nullable
  - `context` union[], nullable
    - union
      - KeyValueContext
        - `title` string, nullable
        - `type` 'key_value', required
        - `items` object, required
      - TextualContext
        - `title` string, nullable
        - `type` 'code' | 'diff' | 'logs' | 'command', required
        - `content` string, required
        - `language` string, nullable
      - JsonContext
        - `title` string, nullable
        - `type` 'json', required
        - `value` unknown, required
      - MetricsContext
        - `title` string, nullable
        - `type` 'metrics', required
        - `items` MetricItem[], required
          - `label` string, required
          - `value` union, required
            - string
            - integer
            - number
          - `unit` string, nullable
      - LinksContext
        - `title` string, nullable
        - `type` 'links', required
        - `items` LinkItem[], required
          - `label` string, required
          - `url` string, uri, required
  - `decision_class` string, nullable
  - `decision_context` DecisionContext
    - `schema_version` 1
    - `reason` string, required
    - `current_state` string, nullable
    - `proposed_change` string, required
    - `expected_effect` string, nullable
    - `risk_level` 'unknown' | 'low' | 'medium' | 'high' | 'critical', required
    - `risk_summary` string, nullable
    - `reversibility` 'unknown' | 'reversible' | 'partially_reversible' | 'irreversible', required
    - `rollback_plan` string, nullable
    - `affected_scope` string[]
  - `metadata` object, nullable

## Response `200`

Successful Response

- object

## Other responses

- `422`: Validation Error

---

[API](https://skmtc.dev/actionbox/apis/actionbox-api.md) · [All operations](https://skmtc.dev/actionbox/apis/actionbox-api/llms.txt) · [OpenAPI document](https://skmtc.dev/actionbox/apis/actionbox-api/revisions/bfb9b622e725?raw)