connect

Invoke one grant-bound governed provider operation

post/v1/provider-operations

Request

  • Base URL: https://api.runx.ai
  • URL: https://api.runx.ai/v1/provider-operations
  • Auth: HTTP bearer

Request body

grant_idstring required
operationstring required
operation_digeststring required

The digest of the connector operation the caller admitted. Cloud refuses one that is not its manifest's with operation_contract_mismatch.

targetstring required

Exact provider-neutral target locator bound into the operation readback evidence.

scopesstring[]

Optional exact Runx capability scopes already admitted by the runtime; Cloud checks supplied evidence against the connector manifest and grant.

inputobject
access'read' | 'mutate'

Optional caller assertion checked against the connector manifest's operation before dispatch.

Response

Provider operation result.

status'success' required
providerstring required
operationstring required
targetstring required
access'read' | 'mutate' required

The access the connector manifest declares for the executed operation.

resultunknown required
readback_refstring required
operation_idstring
idempotency_keystring

Changes

No recorded changes to this operation across all 1 revision of this API.