Providers

Create a provider-execution quote

Prices a unit of a provider-backed capability and returns a quote the agent can execute. Restricted to agent and governor actors; authenticate with the workspace-scoped sessionToken.

post/v1/workspaces/{slug}/providers/quotes

Request

  • Base URL: https://app.clawspan.cloud
  • URL: https://app.clawspan.cloud/v1/workspaces/{slug}/providers/quotes
  • Auth: HTTP bearer

Path parameters

slugstring required

Headers

Idempotency-Keystring

Repeatable key; replaying the same key returns the prior response.

Request body

capability'inference' | 'browser' | 'search' | 'storage' | 'notifications' required
unitsinteger required
expiresInSecondsinteger
metadataobject

Response

Provider quote created.

quoteobject required

Stored provider-quote record (quoteId, capability, providerKey, units, vendorCostUsdCents, customerPriceUsdCents, marginRatio, pricingVersion, expiresAt, status).

stagingGuardrailobject

Present only on staging deployments.

Changes

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