Update an application status

Update application status (FCRA-gated decline). Requires a browser session or an org API key with applications:write. A missing or wrong key is 404, not 401. Declining requires declineReason background_check, not_a_fit, or incomplete.

patch/api/v1/applications/{id}

Request

  • Base URL: https://applytovolunteer.com
  • URL: https://applytovolunteer.com/api/v1/applications/{id}
  • Auth: HTTP bearer

Path parameters

idstring required

Application id.

Request body

status'new' | 'in_review' | 'advanced' | 'accepted' | 'declined' | 'withdrawn' | 'on_hold'

Next application status. Omitted status keeps the current one.

notesstring

Reviewer notes. Omitted notes keep the current notes.

declineReasonstring

Required when status is declined. The handler accepts only background_check, not_a_fit, incomplete. Any other value is 400, or 409 when the reason is usable but the background-check gate blocks the decline.

Response

Update application status (FCRA-gated decline)

Changes

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