agents

Create asynchronous ask job

NLWeb-compatible asynchronous ask pattern. Returns 202 Accepted with Location, Retry-After, job_id, and status_url so agents can poll instead of holding a long request open.

post/ask/jobs

Request

  • Base URL: https://mana.am
  • URL: https://mana.am/ask/jobs
  • Auth: none required

Headers

Mana-API-Versionstring

Optional API version hint. Current public read version is 2026-05-26. The API is additive; breaking changes are announced before removal and may emit Deprecation and Sunset headers.

Idempotency-Keystring

Optional retry key for POST discovery requests. Mana public POST endpoints are read-only, but agents can send this key to correlate safe retries.

Request body

questionstring

Alias for query.

streamingboolean

Set true to request SSE streaming.

streamboolean

Alias for streaming.

Response

Ask job accepted for asynchronous polling.

job_idstring required
status'queued' | 'running' | 'completed' | 'failed' required
status_urlstring uri required
querystring
_metaobject

Changes

No recorded changes to this operation across all 1 revision of this API.