> ## 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 at once

## Bulk Update Application Status

Update the status of multiple applications in a single request.

### Endpoint

```
POST /external/v1/applications/advance/
```

### Authentication

> \[!NOTE]
> Requires a valid company API key in the `Authorization` header (format: `Api-Key <key>`).

### Request Body

| Field              | Type             | Required | Description                                     |
| ------------------ | ---------------- | -------- | ----------------------------------------------- |
| `application_ids`  | array of strings | Yes      | A list of application IDs to update             |
| `page_or_stage_id` | string (UUID)    | Yes      | The new page/status to move the applications to |
| `stage_reason_id`  | string (UUID)    | No       | Reason ID for the stage update (if applicable)  |

### Example Request

```bash theme={null}
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.