post/v1/admin/applications/{id}/submission/enqueue

Queue a browser submission

Operation: adminEnqueueSubmission
Authentication: API key

Hands the application to the submission worker, which drives the destination’s portal.

**Nothing is filed by this call.** It queues a row and returns, so a 202 here means the work is scheduled, not done — the submission’s progress lands on the application detail. Destinations that do not sanction third-party filing require the ops approval this call records, and the adapter refuses without it.

Set `dry_run` to fill the form and stop before submitting. That files nothing and is how a destination’s selectors get verified against a live portal.

Request

Parameters

idpathrequiredstring

Body (optional)

dry_runboolean

Fill the portal form and stop before submitting. Nothing is filed, so this is safe to run against a live portal — it is how a destination’s selectors get verified.

Responses

202Queued. The worker has not run yet.

idstringrequired

The queued `government_submissions` row.

attemptintegerrequired

Attempt number for this application, counted from its submission history.

channelstringrequired

`browser`, or `browser_dry_run` when `dry_run` was set.

statusstringrequired

Always `queued` — the worker has not run yet.

dry_runbooleanrequired

400The request body or query failed validation.

errorobjectrequired

401No key, an unknown key, a revoked key, or a key whose tenant is not active. All four return an identical body on purpose: distinguishing them would let a caller discover which partners we have.

errorobjectrequired

403`projects:write` is required. No partner key is ever issued this scope.

errorobjectrequired

404Not found, or not yours. A resource belonging to another tenant answers 404 rather than 403, because 403 would confirm the record exists.

errorobjectrequired

Example

curl

curl -X POST https://api.haavisa.com/v1/admin/applications/<id>/submission/enqueue \
  -H "Authorization: Bearer $HAAVISA_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{}'

More in Admin

Something unclear? The eligibility guide explains the model behind the answers; the errors guide covers the envelope.