액션

매개변수·검사·실행 단계로 구성된 액션을 만들고 조회·수정·삭제하며 실행하는 API입니다.

📄️ List Actions

List the actions the caller can read. Filter by `collection_id`, `folder_id`, or `name`, and page through the results with `limit` and `cursor`.

📄️ Create Action

Create an action from its parameters, checks, and chain of steps. The definition is validated and the caller's permissions on the types it reads and writes are checked before it is saved.

📄️ Get Action Versions

List version history for a specific action.

📄️ Apply Action

A 4xx is a refusal before the chain started — nothing was written. A 200 means the chain ran; `items` says how far it got (the chain is atomic per item, not as a whole). `?dry_run=true` runs the checks and the write items as dry runs and skips notifications and functions. Existence is read ahead of the `use` check, deliberately against, because the shared 403→404 downgrade exempts `use`: a regular user would otherwise get 403 where every other verb gets 404.

📄️ Get Action

Retrieve a specific action. Returns the specified version if provided.

📄️ Update Action

Update an action. The changed definition is validated and the caller's permissions are checked again before it is saved.

📄️ Delete Action

Delete an action. A deleted action can no longer be applied.