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

operation_id path · string · required

Request body

compact_acknowledgements boolean

Successful batches may omit per-item acknowledgements. Counts remain authoritative; any item failure forces the full acknowledgement list.

items array

Expand fields

event_key string

Stable key used by the caller to correlate an acknowledgement. For usage this should be source_event_id; for a Span it should include span_id and sequence_no.

span object

Expand fields

attributes_json string

content_capture string

ended_at string

entry_point string

error_code string

error_message string

error_type string

input_digest string

input_preview string

kind string

links array

Expand fields

attributes_json string

relation string

span_id string

trace_id string

name string

operation_id string

output_digest string

output_preview string

parent_span_id string

sequence_no string

span_id string

span_key string

started_at string

status string

trace_id string

usage object

Expand fields

attempt_id string

cumulative_quantity string

dimensions_json string

meter_code string

observed_at string

operation_id string

sequence_no string

source_event_id string

stage string

operation_id string

curl --request POST 'https://nexus-api.rainlib.com/v1/metering/operations/{operation_id}/evidence:batch-report' \
  --header 'Authorization: Bearer <NEXUS_ACCESS_TOKEN>' \
  --header 'Content-Type: application/json' \
  --data '{
  "compact_acknowledgements": false,
  "items": [
    {
      "event_key": "<value>",
      "span": {
        "attributes_json": "<value>",
        "content_capture": "<value>",
        "ended_at": "<value>",
        "entry_point": "<value>",
        "error_code": "<value>",
        "error_message": "<value>",
        "error_type": "<value>",
        "input_digest": "<value>",
        "input_preview": "<value>",
        "kind": "<value>",
        "links": [
          {}
        ],
        "name": "<value>",
        "operation_id": "<value>",
        "output_digest": "<value>",
        "output_preview": "<value>",
        "parent_span_id": "<value>",
        "sequence_no": "<value>",
        "span_id": "<value>",
        "span_key": "<value>",
        "started_at": "<value>",
        "status": "<value>",
        "trace_id": "<value>"
      },
      "usage": {
        "attempt_id": "<value>",
        "cumulative_quantity": "<value>",
        "dimensions_json": "<value>",
        "meter_code": "<value>",
        "observed_at": "<value>",
        "operation_id": "<value>",
        "sequence_no": "<value>",
        "source_event_id": "<value>",
        "stage": "<value>"
      }
    }
  ]
}'

Response contract

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