Create an action on an object

curl -X POST https://api.middesk.com/v1/actions \
     -H "Authorization: Bearer <token>" \
     -H "Content-Type: application/json" \
     -d '{
  "object_type": "businesses",
  "object_id": "b1c2d3e4-5678-90ab-cdef-1234567890ab",
  "type": "add_sources",
  "payload": {
    "sources": [
      {
        "source_type": "faa_airmen_certificate",
        "source_name": "FAA Airmen Registry",
        "tier": "government",
        "url": "https://faa.gov/pilots/records",
        "addresses": [
          {
            "full_address": "123 Main St, San Francisco, CA 94102"
          }
        ],
        "people": [
          {
            "name": "Kyle Mack",
            "titles": [
              "Registered Agent"
            ]
          }
        ]
      }
    ]
  },
  "note": "Adding government verification source",
  "thread_id": "11111111-2222-3333-4444-555555555555",
  "run_id": "66666666-7777-8888-9999-000000000000"
}'

{
  "id": "a1b2c3d4-5678-90ab-cdef-1234567890ab",
  "type": "add_sources",
  "object_type": "Business",
  "object_id": "b1c2d3e4-5678-90ab-cdef-1234567890ab",
  "created_at": "2026-01-15T12:00:00Z",
  "effects": [
    {
      "operation": "created",
      "target": {
        "object": "faa_airmen_certificate",
        "id": "c1d2e3f4-5678-90ab-cdef-1234567890ab"
      }
    }
  ],
  "actors": [
    {
      "actor_type": "account",
      "data": {
        "id": "d1e2f3a4-5678-90ab-cdef-1234567890ab",
        "name": "Example Account"
      }
    },
    {
      "actor_type": "run",
      "data": {
        "id": "66666666-7777-8888-9999-000000000000",
        "thread_id": "11111111-2222-3333-4444-555555555555",
        "status": "running",
        "agent": "address_verification"
      }
    }
  ],
  "note": "Adding government verification source",
  "metadata": {
    "key": "value"
  }
}

Authentication

AuthorizationBearer

Bearer authentication of the form Bearer <token>, where token is your auth token.

Request

This endpoint expects an object.

object_typeenumRequired

Type of object to perform the action on

Allowed values:

object_idstringRequiredformat: "uuid"

ID of the object to perform the action on

typeenumRequired

The type of action to perform

Allowed values:

payloadmap from strings to anyRequired

Action-specific parameters (varies by action type)

notestringOptional

Optional text note describing the reason for the action

thread_idstringOptionalformat: "uuid"

Optional operator thread ID used to resolve an action actor

run_idstringOptionalformat: "uuid"

Optional operator run ID used to resolve an action actor

Response

action created - verify TIN

idstringformat: "uuid"

typeenum

The action type that was performed

object_typeenum

The type of object the action was performed on

Allowed values:

object_idstringformat: "uuid"

The ID of the object the action was performed on

created_atdatetime

effectslist of objects

List of effects describing what changed

actorslist of objects

List of actors describing who initiated the action

notestring or null

Optional text note describing the reason for the action

metadatamap from strings to any

Additional metadata associated with the action

Errors

400

Post V1actions Request Bad Request Error

404

Post V1actions Request Not Found Error

422

Post V1actions Request Unprocessable Entity Error