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

components array

Expand fields

component_key string

Stable within the root execution, for example `model`, `image-1` or `video-transcode`. Nexus derives the child execution key from it.

execution object

Expand fields

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

customer_account_id string

The billing owner is declared once at the ingress. A component cannot replace it with a different customer account.

execution_key string

Stable business id for the whole user-visible run. The component keys are deterministically derived from it and can be safely replayed after a process crash.

root_span_id string

trace_id string

Canonical W3C identifiers of the caller-owned root span. Normal SDK span reporting carries the durable parent/child topology for each component.

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

Response contract

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