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

# Update Action

`PATCH /api/v1/actions/{action_id}`

## Path parameters

- `action_id` string, uuid, required

## Request body

- ActionUpdate
  - `display_name` string, nullable
  - `description` string, nullable
  - `status` 'draft' | 'active' | 'archived'
  - `parameters` ParameterIn[], nullable
    - `name` string, required
    - `data_type` string
    - `required` boolean
    - `validation` object
    - `order` integer
  - `effects` EffectIn[], nullable
    - `entity_id` string, uuid, required
    - `kind` 'create' | 'modify' | 'delete', required — Which ontology row operation an Action drives.
    - `is_anchor` boolean
    - `relationship_id` string, uuid, nullable
    - `field_writes` FieldWriteIn[]
      - `column_name` string, required
      - `source_kind` 'const' | 'param', required — Where a field-write's value comes from.
      - `const_value` unknown
      - `param_name` string, nullable
    - `guards` GuardIn[]
      - `column_name` string, required
      - `op` string, required
      - `value` unknown, required
  - `grants` GrantIn[], nullable
    - `principal_kind` 'role' | 'user', required — What an action_grant points at.
    - `role` string, nullable
    - `user_id` string, uuid, nullable

## Response `204`

Successful Response

## Other responses

- `422` — Validation Error

---

[API](https://skmtc.net/netter/apis/dmi-backend.md) · [All operations](https://skmtc.net/netter/apis/dmi-backend/llms.txt) · [OpenAPI document](https://skmtc-service-staging.skmtc.workers.dev/v1/apis/netter/dmi-backend/versions/a59877bf911b/schema)