Skip to main content
POST
/
external
/
v1
/
applications
/
advance
Bulk Update Application Status
curl --request POST \
  --url https://api.example.com/external/v1/applications/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.

​
Bulk Update Application Status

Update the status of multiple applications in a single request.

​
Endpoint

POST /external/v1/applications/advance/

​
Authentication

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

​
Request Body

FieldTypeRequiredDescription
application_idsarray of stringsYesA list of application IDs to update
page_or_stage_idstring (UUID)YesThe new page/status to move the applications to
stage_reason_idstring (UUID)NoReason ID for the stage update (if applicable)

​
Example Request

curl -X POST "https://api.firstwork.com/external/v1/applications/advance/" \
  -H "Authorization: Api-Key YOUR_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "application_ids": [
      "uuid-1",
      "uuid-2",
      "uuid-3"
    ],
    "page_or_stage_id": "stage-uuid",
    "stage_reason_id": "reason-uuid"
  }'

​
Responses

​
200
OK
The bulk status update was successfully initiated.
​
400
Bad Request
Invalid request or failed operation.
​
500
Internal Server Error
Internal server error occurred while initiating the bulk update.