Activate a Zam

Documentation Index

Fetch the complete documentation index at: https://docs.zeroclick.am/llms.txt

Use this file to discover all available pages before exploring further.

​

Prerequisites

• A ZAM API key with order:create scope
• The ID of a published listing

​

Activate

zam activate LISTING_ID --request-body '{"city": "San Francisco"}'

zam activate LISTING_ID --timeout 30 --request-body '{"city": "San Francisco"}'

curl -X POST https://api.zeroclick.am/v1/orders \
  -H "Content-Type: application/json" \
  -H "x-zam-api-key: zam_your_key_here" \
  -d '{
    "listingId": "LISTING_ID",
    "requestBody": {"city": "San Francisco"}
  }'

{
  "id": "ORDER_ID",
  "listingId": "LISTING_ID",
  "orderState": "completed",
  "result": {"forecast": "sunny, 72°F"},
  "startedAt": "2025-01-15T10:30:00Z",
  "completedAt": "2025-01-15T10:30:00Z"
}

​

What happens during activation

1. ZAM validates your requestBody against the listing’s inputSchema (if defined). Invalid input returns 400.
2. ZAM creates an order in pending state.
3. ZAM signs the request with HMAC-SHA256 (if the seller has a signing secret) and calls the seller’s endpoint with a 30-second timeout.
4. On success, the order moves to completed and stores the response. On failure, it moves to failed and stores the error.

​

Error cases