Skip to navigation

Rename or redescribe a custom verb

API key required. Rename (name) and/or update the description of a live custom verb. Renaming is safe by design: the old name becomes a deprecated alias that still resolves in checks, policies that used the old name are migrated to the new name (each touched policy’s version bumps by one), and the old name is rejected in new policies with the offending verbs listed. Writes a VERB_UPDATE receipt. Deprecated verbs cannot be renamed or redescribed (404).

Path parameters

namestringRequired

The verb name; case-insensitive.

Request

This endpoint expects an object.
namestringOptional

The new verb name — same validation and collision rules as POST.

descriptionstringOptional

New description; empty string clears it.

Response

The renamed verb record.

Errors

400
Bad Request Error
401
Unauthorized Error
404
Not Found Error
409
Conflict Error