Skip to main content
POST
/
external
/
v1
/
applications
/
{application_id}
/
advance
Update Application Status
curl --request POST \
  --url https://api.example.com/external/v1/applications/{application_id}/advance/
{
  "200": {},
  "400": {},
  "500": {}
}

Documentation Index

Fetch the complete documentation index at: https://docs.firstwork.com/llms.txt

Use this file to discover all available pages before exploring further.

​
Update Application Status

Change an application’s status or advance it to a different stage in the hiring flow.

​
Endpoint

POST /external/v1/applications/{application_id}/advance/

​
Authentication

Requires a valid company API key in the Authorization header (format: Api-Key <key>).

​
Path Parameters

ParameterTypeRequiredDescription
application_idstring (UUID)YesThe application ID

​
Request Body

FieldTypeRequiredDescription
page_or_stage_idstring (UUID)YesThe new page/status where the application should be moved
stage_reason_idstring (UUID)NoReason ID for the stage update (if applicable)

​
Example Request

curl -X POST "https://api.firstwork.com/external/v1/applications/7c9e6679-7425-40de-944b-e07fc1f90ae7/advance/" \
  -H "Authorization: Api-Key YOUR_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "page_or_stage_id": "next-stage-uuid",
    "stage_reason_id": "reason-uuid"
  }'

​
Responses

​
200
OK
The status update was successfully initiated.
​
400
Bad Request
Invalid request, missing required fields, or invalid application ID.
​
500
Internal Server Error
Internal server error occurred while initiating the status update.

​
Notes

  • Stage transitions trigger any configured automations
  • Transition history is automatically recorded
  • For updating multiple applications at once, see Bulk Update Status