REST API & keys

https://api.oneli.io

# Every request: the key in the Authorization header, JSON bodies.
export ONELI_API_KEY="oli_..."
export API="https://api.oneli.io"

curl -X POST $API/v1/call-tasks \
  -H "Authorization: Bearer $ONELI_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "idempotency_key": "order-1234-call",
    "to_number": "05XXXXXXXX",
    "goal": "לבדוק אם הזמנה 1234 מוכנה לאיסוף ועד מתי אפשר להגיע",
    "instructions": "לדבר בקצרה ובנימוס. אם אין תשובה ברורה, לבקש שעה לחזור.",
    "constraints": { "max_price_ils": 50 },
    "max_duration_s": 180
  }'

# Events after the last sequence you have seen (start at 0). Repeat with after=<next_cursor>.
curl "$API/v1/call-tasks/$TASK_ID/events?after=0&limit=100" \
  -H "Authorization: Bearer $ONELI_API_KEY"

# The task itself: status, outcome, summary, revision
curl $API/v1/call-tasks/$TASK_ID -H "Authorization: Bearer $ONELI_API_KEY"

curl -X POST $API/v1/consultations/con_3d48e1a72832d769/response \
  -H "Authorization: Bearer $ONELI_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{ "decision": "approve", "reason": "בתוך התקציב" }'

# → { "status": "accepted" }  (or "expired" / "conflict" with the decision that won)

# expected_revision = task.revision from GET /v1/call-tasks/:id
curl -X POST $API/v1/call-tasks/$TASK_ID/instructions \
  -H "Authorization: Bearer $ONELI_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "instruction": "לשאול גם אם אפשר לאסוף מחר אחרי 18:00",
    "expected_revision": 1,
    "idempotency_key": "order-1234-instr-1"
  }'

# → { "command_id": "cmd_…", "revision": 2, "status": "pending" }

curl -X POST $API/v1/call-tasks/$TASK_ID/cancel \
  -H "Authorization: Bearer $ONELI_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{ "reason": "user_changed_plans" }'

# queued → { "status": "cancelled" }   during the call → { "status": "cancel_requested" }

curl -X POST https://api.oneli.io/v1/voice-agents/va_…/outbound-calls \
  -H "Authorization: Bearer $ONELI_API_KEY" \
  -H "Content-Type: application/json" \
  -H "Idempotency-Key: lead-42" \
  -d '{"to":"0521234567","variables":{"name":"Dana","interest":"kitchen renovation"}}'

curl -X POST https://api.oneli.io/v1/voice-agents/va_…/whatsapp/send \
  -H "Authorization: Bearer $ONELI_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{"to":"0521234567","text":"Thanks for the call! Here are the details you asked for: …"}'

// Two tools for your agent. Map them to your framework's tool format.
export const tools = [
  {
    name: "place_phone_call",
    description: "Phone an Israeli number in Hebrew through OneLi to reach a goal. Returns a task_id.",
    parameters: {
      type: "object",
      properties: {
        to_number: { type: "string", description: "Israeli number, e.g. 03-1234567 or 050-1234567" },
        goal: { type: "string", description: "What the call should achieve (max 500 characters)" },
        instructions: { type: "string", description: "How to conduct the call (optional)" },
        max_price_ils: { type: "number", description: "Above this price the voice agent consults you" },
      },
      required: ["to_number", "goal"],
    },
  },
  {
    name: "get_call_result",
    description: "Status, outcome and summary of a OneLi call task.",
    parameters: { type: "object", properties: { task_id: { type: "string" } }, required: ["task_id"] },
  },
];

export async function runTool(name, args) {
  if (name === "place_phone_call") {
    const { task } = await oneli("POST", "/v1/call-tasks", {
      idempotency_key: crypto.randomUUID(),
      to_number: args.to_number,
      goal: args.goal,
      instructions: args.instructions,
      ...(args.max_price_ils != null ? { constraints: { max_price_ils: args.max_price_ils } } : {}),
    });
    return { task_id: task.id, status: task.status };
  }
  if (name === "get_call_result") {
    const { task, pending_consultation } = await oneli("GET", `/v1/call-tasks/${args.task_id}`);
    return { status: task.status, outcome: task.outcome, summary: task.summary, pending_consultation };
  }
}

Method:  POST
URL:     https://api.oneli.io/v1/call-tasks
Headers: Authorization: Bearer oli_...        (store it as a credential)
         Content-Type: application/json
Body:    {
           "idempotency_key": "lead-{{ id }}",
           "to_number": "{{ phone }}",
           "goal": "לאשר את פרטי הפנייה ואת מועד הפגישה"
         }