---
title: "Create Action"
method: POST
path: "/api/v1/actions"
tags: ["actions"]
---

# Create Action

`POST /api/v1/actions`

## Request body

- ActionCreate
  - `name` string, required
  - `display_name` string, required
  - `description` string
  - `parameters` ParameterIn[]
    - `name` string, required
    - `data_type` string
    - `required` boolean
    - `validation` object
    - `order` integer
  - `grants` GrantIn[]
    - `principal_kind` 'role' | 'user', required — What an action_grant points at.
    - `role` string, nullable
    - `user_id` string, uuid, nullable
  - `effects` EffectIn[]
    - `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

## Response `201`

Successful Response

- object

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