Skip to main content
PATCH
Update operation
Read Get operation, then send its revision as expectedRevision with an Idempotency-Key. Omitted fields stay unchanged. The stable operationId stays the same; the revision increments. An edit creates a new definition revision and resets executable-route verification. Earlier bindings do not silently authorize changed inputs or effects. Archived operations cannot be edited. A stale revision returns 409.

Authorizations

x-api-key
string
header
required

Headers

Idempotency-Key
string
required

Stable key for this exact mutation. Reusing it with different input returns 409.

Required string length: 1 - 200

Path Parameters

operationId
string
required

Body

application/json
expectedRevision
integer
required
Required range: 1 <= x <= 2147483647
handle
string
Pattern: ^[a-z0-9](?:[a-z0-9-]{0,39}[a-z0-9])?$
name
string
Required string length: 1 - 160
description
string
Maximum string length: 20000
visibility
enum<string>
Available options:
PRIVATE,
PUBLIC
status
enum<string>
Available options:
DRAFT,
ACTIVE,
PAUSED,
ARCHIVED
inputSchema
object
outputSchema
object
fulfillment
object
pricing
object
ownerApproval
enum<string>
Available options:
MANUAL,
AUTO

Response

Current owner-scoped result. A mutation retry returns its saved response.

operation
object
required
pendingApprovals
object[]
Last modified on October 19, 2026