Start a job (the survey container). Contact details are NOT accepted here — funnel rule. Send `Idempotency-Key` so a retry cannot create a second job.

post/jobs

Request

  • Base URL: https://widget.reelquoteai.com/api/v1
  • URL: https://widget.reelquoteai.com/api/v1/jobs
  • Auth: HTTP bearer

Headers

Idempotency-Keystring

Any unique string per intended job (a UUID, your order id). For 24 hours, the same key with the same body returns the ORIGINAL 201 body with Idempotent-Replayed: true and creates nothing; the same key with a different body is a 422 idempotency_key_reused; the same key while the first request is still running is a 409 idempotency_in_progress with Retry-After: 1. Scoped to your account and partitioned by the calling key's kind and mode. Omit it and the request is never deduplicated.

Request body

quote_kind'ballpark' | 'firm'

What the job is for. A firm job becomes bookable once filmed.

dwellingstring

What the customer says their home is (any wording; stored beside what the video measures)

move_datestring date

YYYY-MM-DD

Example request

{
  "dwelling": "2br_apt"
}

Response

Created — or, with an Idempotency-Key seen before, the original creation replayed. The inferred access profiles come straight back so a UI can ask 'elevator building?' without a second round trip.

job_idstring

ULID — the id for every later call

status'created'

Changes

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