---
title: "Update a registered machine actor"
method: PATCH
path: "/agents/{actor_id}"
tags: ["agents"]
---

# Update a registered machine actor

`PATCH /agents/{actor_id}`

## Request

- Base URL: `https://catalyst.stratogenic.ai` (the document declares no server; this is the origin it was published from)
- URL: `https://catalyst.stratogenic.ai/agents/{actor_id}`
- Auth: API key in header `X-API-Key`

## Path parameters

- `actor_id` string, required

## Request body

- ActorPatch
  - `display_name` string, nullable
  - `runtime_type` string, nullable
  - `owner_group` string, nullable
  - `capabilities` string[], nullable
  - `scopes` string[], nullable
  - `risk_class` 'low' | 'standard' | 'high', nullable
  - `governance_mode` 'observe' | 'advisory' | 'proposal' | 'strict', nullable
  - `is_active` boolean, nullable
  - `notes` string, nullable

## Response `200`

Successful Response

- unknown

## Other responses

- `404`: Actor not found.
- `422`: Validation Error

---

[API](https://skmtc.dev/stratogenic/apis/stratogenic-catalyst-api.md) · [All operations](https://skmtc.dev/stratogenic/apis/stratogenic-catalyst-api/llms.txt) · [OpenAPI document](https://skmtc.dev/stratogenic/apis/stratogenic-catalyst-api/revisions/ad906ad7a85d?raw)