API center

The server validates credentials, tenant, environment and permissions. This page does not send requests. Replace example values; deployed server validation remains authoritative.

Parameters

No path or query parameters.

Request body

billing_meter_code string

capability_id string

Capability is resolved from a previously fetched published execution profile. Metering validates it against the trusted Offer snapshot and freezes the corresponding revision on the Operation for Trace/audit.

capability_revision_id string

Revision returned by the profile. A fresh execution rejects a stale revision instead of silently adopting a newer price/route policy. An idempotent retry for an already-created execution still returns the original reservation.

customer_account_id string

estimates array

Expand fields

meter_code string

quantity string

execution_key string

model string

offer_id string

operation_type string

provider string

Provider must come from a trusted route or Sidecar configuration. It is used to acquire provider-scoped capacity leases before external I/O.

quotas array

Expand fields

amount string

entitlement_code string

resource_id string

ttl_seconds integer · int32

resource_id string

resource_type string

subject_id string

subject_type string

ttl_seconds integer · int32

curl --request POST 'https://nexus-api.rainlib.com/v1/executions' \
  --header 'Authorization: Bearer <NEXUS_ACCESS_TOKEN>' \
  --header 'Content-Type: application/json' \
  --data '{
  "billing_meter_code": "<value>",
  "capability_id": "<value>",
  "capability_revision_id": "<value>",
  "customer_account_id": "<value>",
  "estimates": [
    {
      "meter_code": "<value>",
      "quantity": "<value>"
    }
  ],
  "execution_key": "<value>",
  "model": "<value>",
  "offer_id": "<value>",
  "operation_type": "<value>",
  "provider": "<value>",
  "quotas": [
    {
      "amount": "<value>",
      "entitlement_code": "<value>",
      "resource_id": "<value>",
      "ttl_seconds": 0
    }
  ],
  "resource_id": "<value>",
  "resource_type": "<value>",
  "subject_id": "<value>",
  "subject_type": "<value>",
  "ttl_seconds": 0
}'

Response contract

Generated responses do not enumerate every runtime error. See the integration guide for authentication, conflicts and retries.