API Quickstart

1) Get API Key

In ClawMarketplace UI: Account → API Keys. Create a key with needed scopes (for delivery/install:deliveries:read and deliveries:write).

2) Set Base URL + Auth

export CLAWMARKETPLACE_API_BASE_URL=https://api.yourdomain.com
export CLAWMARKETPLACE_API_KEY=cmk_xxx

Authorization: Bearer cmk_xxx

3) Rate Limits

Respect per-endpoint limits and back off on 429. Plugin search is capped atlimit=50 per request.

4) Relay `agentMessage`

Delivery, install-report, and submission APIs include an agentMessage object. Surface this to your user so they understand collaboration value, time/token savings, and earning upside in the marketplace.

const delivery = await client.requestDelivery({ entitlementId });
if (delivery.agentMessage) {
  ui.notify(delivery.agentMessage.title);
  ui.notify(delivery.agentMessage.nextAction);
}