Support Assistant

Ask a support question

Changed on

Asks the Zernio Support Assistant a question about your workspace. Each question starts a run that answers asynchronously: this returns 202 with a runId, and the answer arrives through the support.run.completed and support.run.failed webhooks. GET /v1/support/runs/{runId} is the fallback. Pass threadId to continue an earlier conversation, and context to point the assistant at a post, account, profile or a failed request (its X-Request-Id). When the assistant finds a problem on Zernio's side it opens a support ticket with the team (see supportTicket on the run) and the run ends as needs_human.

Pricing. You pay per question, once it finishes. The exact amount charged is the run's costUsd.

QuestionYou pay
Typical question$0.10 to $0.50
Most one question can costIts maxCostUsd: $0.50 to $3, $3 by default
Handed to the Zernio team (needs_human)Charged like an answered question
Failed or expired$0
All questions in a UTC monthAt most $100 per account

Near its maxCostUsd a run stops investigating and answers with what it found so far, so it never charges more than the cap; with nothing to answer yet it fails and costs nothing. Charges appear as "Support API" on your invoice.

Requires an unrestricted API key, usage-based billing and a card on file. Limits per account: 3 active runs and $100 of runs per UTC month. Send an Idempotency-Key header to make retries safe.

post/v1/support/runs

Request

  • Base URL: https://zernio.com/api
  • URL: https://zernio.com/api/v1/support/runs
  • Auth: HTTP bearer

Headers

Idempotency-Keystring

Optional client-generated unique key (e.g. a UUID) that makes retries safe. Same key + same body replays the original response; same key + different body → 422; key still processing → 409. A request cut off mid-handler (for example by a function timeout) can leave its key in progress, answering 409 until the key expires after 24 hours.

Request body

messagestring required

The question. Leading and trailing whitespace is trimmed.

threadIdstring

Continue this thread. The thread must have a run started by your team, and no run in progress.

maxCostUsdnumber

Cost cap for this run, in USD. The run stops at the cap and bills at most this amount.

Response

Run accepted

runIdstring required
threadIdstring required
status'queued' required
pollAfterSecondsinteger required

Seconds to wait before the first poll.

Changes

  • 27c96850cc66Revision changes
    • info

      api operation id createSupportRun removed and replaced with askSupportQuestion

    • info

      api tag Support Assistant added

    • info

      api tag Support Runs removed

    • info

      added the new optional request property /

  • 8f72ad19d26bRevision changes
    • info

      added the non-success response with the status