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

> Advance or change the status of an application

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

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

### Path Parameters

| Parameter        | Type          | Required | Description        |
| ---------------- | ------------- | -------- | ------------------ |
| `application_id` | string (UUID) | Yes      | The application ID |

### Request Body

| Field              | Type          | Required | Description                                               |
| ------------------ | ------------- | -------- | --------------------------------------------------------- |
| `page_or_stage_id` | string (UUID) | Yes      | The new page/status where the application should be moved |
| `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/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](/api-reference/endpoints/bulk-update-status)