API reference / Admin

post/v1/admin/applications/{id}/decision-document

Attach an authority decision PDF

Operation
adminAttachDecisionDocument
Authentication
API key

Stores a validated PDF privately for an approved application and queues applicant delivery.

Request

Parameters

idpathrequiredstring

Body

content_base64stringrequired

Responses

201Decision PDF stored.

Free-form JSON object.

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
409A PDF can only be attached once an application is approved.
503Private document storage is unavailable.

Example

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

More in Admin

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