Invoke an automation primitive
Executes the named operation in the authenticated organization after checking its scope, feature availability and input-dependent Gratona permissions. Obtain the operation-specific body and output schema from the schema endpoint first. Mutation side effects and replay/idempotency behavior are defined by that primitive; Idempotency-Key is made available to implementations that support it.
Authorizations
Passport bearer token authentication for legacy admin sessions.
Headers
Replay key passed to the primitive context. Support and requirements depend on the selected mutation schema.
Path Parameters
Exact dot-separated operation name returned by primitive discovery; route names accept lowercase letters, underscores and dots.
^[a-z._]+$Body
Input accepted by the selected primitive.
Operation-specific input object; use GET /primitives/{name}/schema to discover its properties and required fields.
Response
Operation result; data and metadata follow the selected primitive contract.
The PrimitiveResult envelope serialized by primitive invocation and validation.
Whether the selected primitive succeeded.
true
Operation-specific JSON result, or null on failure. Its schema is returned by primitive discovery.
Domain errors or validation field errors.
Non-fatal operation warnings.
Operation metadata; may contain status, dry_run, replay information or pagination. Empty metadata serializes as an empty array.