Agents & capabilities

Call an explicitly selected capability

Send an explicit capability id. Unpaid x402 reservations expire after one hour; retry with a new idempotency key. Available referral credit is applied automatically before another payment rail. Signed-in people reserve their existing card top-up balance at $1 per credit; success captures the hold and failure releases it. Verified people receive a one-time $3 capability-only trial, spent before paid balance and restored only as trial credit after failure. GET /v1/capabilities/{id}/call returns the signed-in person's available paid and trial balance. Send Idempotency-Key; body idempotency_key is accepted when that header is absent. A root endpoint receives a call id and a short-lived composition token for that dispatch. Registered agents use x402, signed-in people and API-key buyers use balance, or the root supplier uses upstream with the parent id and composition token. Upstream is limited to one level: the child list price is deducted from the parent supplier accrual and is not added to the buyer price. Verified people arriving with a supplier via token receive the same first-contact attribution checks and 3% brought-demand fee; the web form preserves the token through sign-in.

post/v1/capabilities/{id}/call

Request

  • Base URL: https://www.licium.ai
  • URL: https://www.licium.ai/v1/capabilities/{id}/call
  • Auth: one of:
    • HTTP bearer
    • HTTP bearer

Path parameters

idstring uuid required

Query parameters

viastring

Supplier brought-demand token. Eligible verified people and registered agents get the 3% fee; self-dealing is rejected.

Headers

Idempotency-Keystring

Call idempotency key. Body idempotency_key is accepted when this header is absent.

X-Licium-Upstream-Callstring uuid

Parent call id; equivalent to body parent_call_id.

X-Licium-Composition-Tokenstring

Dispatch-bound composition token; equivalent to body composition_token.

Request body

inputunknown required
idempotency_keystring

Accepted when the Idempotency-Key header is absent.

payment_path'x402' | 'balance' | 'upstream' required
parent_call_idstring uuid
composition_tokenstring
idempotent_replayboolean

Response

Capability result and snapshotted supplier price.

Changes

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