Run your AI agents from your own code

Three surfaces

Authentication

Every request authenticates with a bearer API key created in your dashboard. The raw key is shown once at creation — store it securely. Keys carry scopes: chat (run agents, safe to embed client-side), manage (configure agents), and messages (send outbound) — the last two are server-side only.

Authorization: Bearer dz_live_a1b2c3d4...

Find your agent ID

Every call takes an agentId. Two ways to get it:

• Dashboard — open the agent; its ID is in the URL: www.dailzero.com/dashboard/agent/<AGENT_ID>
• API — call GET /v1/agents with a manage-scoped key (see List your agents below); each item's id is the agent ID.

Run an agent — chat completions

Send the conversation so far, get the agent's reply with its persona, knowledge base, and tools. Billed by token-weighted credits.

curl https://www.dailzero.com/api/v1/chat/completions \
  -H "Authorization: Bearer dz_live_..." \
  -H "Content-Type: application/json" \
  -d '{
    "agentId": "<your-agent-id>",
    "messages": [{ "role": "user", "content": "do you sell ferrari caps?" }]
  }'

Response

{
  "message": { "role": "assistant", "content": "Yes — Ferrari F1 White Cap (₦23,000)..." },
  "usage": { "input_tokens": 1240, "output_tokens": 142, "credits": 2 },
  "remaining_credits": 11218
}

Send a WhatsApp message

Once your agent's WhatsApp is connected, send outbound messages programmatically. Sends go through the same anti-ban pacing as the dashboard and are billed per message. Want pure outbound with no AI auto-replies? Turn AI replies off for the agent in its settings.

curl https://www.dailzero.com/api/v1/messages \
  -H "Authorization: Bearer dz_live_..." \
  -H "Content-Type: application/json" \
  -d '{
    "agentId": "<your-agent-id>",
    "to": "2348012345678",
    "text": "Hi! Your order #1234 has shipped"
  }'

Response

{
  "message_id": "a1b2c3",
  "status": "queued",
  "usage": { "credits": 5 },
  "remaining_credits": 11195
}

Verify a contact

Check a number is reachable on WhatsApp before sending. Free (no credits).

curl https://www.dailzero.com/api/v1/contacts/check \
  -H "Authorization: Bearer dz_live_..." \
  -H "Content-Type: application/json" \
  -d '{ "agentId": "<your-agent-id>", "phone": "2348012345678" }'

List your agents

Find an agent's id to use in the calls above.

curl https://www.dailzero.com/api/v1/agents \
  -H "Authorization: Bearer dz_live_..."

Manage an agent's tools

Define the webhook tools your agent can call — the same tools it uses on WhatsApp.

curl -X PUT https://www.dailzero.com/api/v1/agents/<id>/tools \
  -H "Authorization: Bearer dz_live_..." \
  -H "Content-Type: application/json" \
  -d '{ "tools": [
    { "name": "check_stock", "description": "Check stock for a product",
      "url": "https://your-api.com/stock", "method": "GET",
      "parameters": [
        { "name": "sku", "type": "string", "description": "Product SKU", "required": true }
      ] }
  ] }'

Limits & safety

• Per-key rate limit (default 60 requests/minute) → 429 with Retry-After.
• Optional per-key daily spending cap, set when you create the key.
• Hard per-request output cap so a single call can't run up a huge bill.
• Send an Idempotency-Key header to safely retry without double-charging.
• A pre-flight credit check blocks calls your balance can't cover.

Errors

Every error returns { "error": { "code", "message", "request_id" } }. Branch on code.