Quickstart

Handle It in six curl commands

Use a sandbox key (hk_test_...) for zero risk. Base URL defaults to

https://api.gethandleit.com.

export K="Authorization: Bearer hk_test_..."
export BASE=https://api.gethandleit.com

# 1. Discover AI-Ready businesses
curl -s "$BASE/v1/businesses?ai_ready=true" -H "$K"

# 2. Create a task (plain language)
curl -s -X POST "$BASE/v1/tasks" -H "$K" -H 'content-type: application/json' \
  -d '{"request":"table for 2 tonight 9pm","sandbox":{"persona":"asks_deposit"}}'
#   -> {"task_id":"tsk_...","status":"received",...}

export T=tsk_...   # from the response

# 3. Check status / outcome / evidence / cost
curl -s "$BASE/v1/tasks/$T" -H "$K"

# 4. Answer a decision (e.g. accept a deposit or a delivery quote)
curl -s -X POST "$BASE/v1/tasks/$T/respond" -H "$K" -H 'content-type: application/json' \
  -d '{"choice_id":"pay"}'

# 5. Stream the event log (Server-Sent Events)
curl -sN "$BASE/v1/tasks/$T/events?stream=true" -H "$K"

# 6. Grab the tool schemas for your own agent framework
curl -s "$BASE/v1/schemas/openai" -H "$K"      # or /v1/schemas/anthropic

Every tool is also callable directly: POST /v1/tools/{name} with a JSON body of

arguments (the same registry behind MCP and the schema endpoints).