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

# Get Action

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

## Path parameters

- `action_id` string, uuid, required

## Response `200`

Successful Response

- ActionRead
  - `id` string, uuid, required
  - `name` string, required
  - `display_name` string, required
  - `description` string, required
  - `status` 'draft' | 'active' | 'archived', required
  - `is_default_edit` boolean, required
  - `parameters` ParameterRead[], required
    - `name` string, required
    - `data_type` string
    - `required` boolean
    - `validation` object
    - `order` integer
  - `effects` EffectRead[], required
    - `id` string, uuid, required
    - `entity_id` string, uuid, required
    - `kind` 'create' | 'modify' | 'delete', required — Which ontology row operation an Action drives.
    - `is_anchor` boolean, required
    - `relationship_id` string, uuid, nullable, required
    - `field_writes` FieldWriteRead[], required
      - `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` GuardRead[], required
      - `column_name` string, required
      - `op` string, required
      - `value` unknown, required
  - `grants` GrantRead[], required
    - `principal_kind` 'role' | 'user', required — What an action_grant points at.
    - `role` string, nullable
    - `user_id` string, uuid, nullable

## 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)