---
title: "Create an action on an object"
method: POST
path: "/v1/actions"
tags: ["actions"]
---

# Create an action on an object

`POST /v1/actions`

## Headers

- `Authorization` string, required

## Request body

- object
  - `object_type` 'businesses' | 'watchlist_result', required — Type of object to perform the action on
  - `object_id` string, uuid, required — ID of the object to perform the action on
  - `type` 'add_sources' | 'add_attributes' | 'verify_tin' | 'decision' | 'dismissal', required — The type of action to perform
  - `note` string — Optional text note describing the reason for the action
  - `thread_id` string, uuid — Optional operator thread ID used to resolve an action actor
  - `run_id` string, uuid — Optional operator run ID used to resolve an action actor
  - `payload` object, required — Action-specific parameters (varies by action type)

## Response `201`

action created - verify TIN

- TypeAction
  - `id` string, uuid, required
  - `type` 'add_sources' | 'add_attributes' | 'update_address_risk' | 'verify_tin' | 'decision' | 'dismissal', required — The action type that was performed
  - `object_type` 'Business' | 'Watchlist::Result', required — The type of object the action was performed on
  - `object_id` string, uuid, required — The ID of the object the action was performed on
  - `created_at` string, date-time, required
  - `note` string, nullable — Optional text note describing the reason for the action
  - `metadata` object — Additional metadata associated with the action
  - `effects` TypeActionEffect[], required — List of effects describing what changed
    - `operation` 'created' | 'updated' | 'linked', required — The type of change that was made
    - `diff` object, nullable, required — Before/after values for each changed field
    - `target` TypeActionEffectTarget, required
      - `object` string, required — The type of the affected resource
      - `id` string, uuid, required — The ID of the affected resource
  - `actors` TypeActionActor[], required — List of actors describing who initiated the action
    - `actor_type` 'account' | 'user' | 'run', required — The type of actor
    - `data` object — Actor details (varies by actor type)

## Other responses

- `400` — invalid action type
- `404` — object not found
- `422` — invalid payload

---

[API](https://skmtc.net/middesk/apis/middesk-api.md) · [All operations](https://skmtc.net/middesk/apis/middesk-api/llms.txt) · [OpenAPI document](https://skmtc-service-staging.skmtc.workers.dev/v1/apis/middesk/middesk-api/versions/9882e52b445b/schema)