---
title: "Request a live session (holds the first block and notifies the person)"
method: POST
path: "/api/connect"
---

# Request a live session (holds the first block and notifies the person)

`POST /api/connect`

## Request

- Base URL: `https://api.askingahuman.com`
- URL: `https://api.askingahuman.com/api/connect`
- Auth: HTTP bearer

## Request body

- object
  - `mode` 'message' | 'video', required
  - `humanId` string, required
  - `message` string: What you need help with
  - `maxSpendCents` integer

## Response `201`

Requested

- object
  - `status` 'REQUESTED'
  - `sessionId` string
  - `pricing` Pricing
    - `blockMinutes` integer: 60 for chat, 30 for video
    - `blockPriceCents` integer: Price of each extension block
    - `firstChargeCents` integer: Price of the first block: blockPriceCents or the session minimum, whichever is higher
    - `currency` string
  - `firstChargeCents` integer
  - `sessionMinimumCents` integer
  - `holdAmountCents` integer
  - `blockMinutes` integer
  - `maxBlocks` integer
  - `spendLimitCents` integer
  - `redactions` string[]: Kinds of personal details removed from your text before the person saw it (the original is never stored); empty when none
  - `waitsUntil` string, date-time

## Other responses

- `401`: Missing or invalid API key
- `402`: No usable card or balance on this key, or SPEND_CAP_REACHED
- `404`: No such person or record (also for unlisted people and people who blocked your key)
- `409`: HUMAN_OFFLINE (video), OVER_SPEND_LIMIT, or the person doesn't take this mode
- `429`: Too many requests

---

[API](https://skmtc.dev/askingahuman/apis/askingahuman-api.md) · [All operations](https://skmtc.dev/askingahuman/apis/askingahuman-api/llms.txt) · [OpenAPI document](https://skmtc.dev/askingahuman/apis/askingahuman-api/revisions/dbb2a1a46257?raw)