> ## Documentation Index
> Fetch the complete documentation index at: https://careerk.mintlify.site/llms.txt
> Use this file to discover all available pages before exploring further.

# Update Application Status

> Update the status of a job application

## Endpoint

```
PATCH /api/v1/companies/me/applications/:id
```

**Base URL**: `http://localhost:3000/api/v1`

<Note>This endpoint requires **Company authentication**.</Note>

## Headers

| Header        | Value                 |
| ------------- | --------------------- |
| Authorization | Bearer {access_token} |

## Path Parameters

<ParamField path="id" type="string" required>
  The unique identifier of the application (UUID).
</ParamField>

## Request Body

<ParamField body="status" type="enum" required>
  The new status for the application. Supported values: `PENDING`, `REVIEWED`, `SHORTLISTED`,
  `INTERVIEW_SCHEDULED`, `REJECTED`, `HIRED`, `WITHDRAWN`
</ParamField>

## Example Request

```json theme={null}
{
  "status": "SHORTLISTED"
}
```

## Response

### Success Response (200 OK)

```json theme={null}
{
  "success": true,
  "message": "Application status updated successfully",
  "meta": {
    "timestamp": "2026-04-23T20:00:00.000Z",
    "path": "/companies/me/applications/5d524fd9-8ea1-4c4f-bc15-b32072c144a1",
    "method": "PATCH"
  }
}
```

<Info>
  **Current Implementation**: This endpoint currently returns a success envelope only. It does not
  return the updated application object.
</Info>

## Error Responses

### 400 Bad Request - Validation Error

```json theme={null}
{
  "success": false,
  "error": {
    "message": ["status must be a valid enum value"],
    "statusCode": 400,
    "timestamp": "2026-04-23T20:00:00.000Z",
    "path": "/companies/me/applications/5d524fd9-8ea1-4c4f-bc15-b32072c144a1",
    "method": "PATCH",
    "details": "Bad Request"
  }
}
```

### 401 Unauthorized

```json theme={null}
{
  "success": false,
  "error": {
    "message": "Unauthorized",
    "statusCode": 401,
    "timestamp": "2026-04-23T20:00:00.000Z",
    "path": "/companies/me/applications/5d524fd9-8ea1-4c4f-bc15-b32072c144a1",
    "method": "PATCH",
    "details": "Unauthorized"
  }
}
```

### 403 Forbidden

```json theme={null}
{
  "success": false,
  "error": {
    "message": "Forbidden resource",
    "statusCode": 403,
    "timestamp": "2026-04-23T20:00:00.000Z",
    "path": "/companies/me/applications/5d524fd9-8ea1-4c4f-bc15-b32072c144a1",
    "method": "PATCH",
    "details": "Forbidden"
  }
}
```

### 404 Not Found

```json theme={null}
{
  "success": false,
  "error": {
    "message": "no application exists with this id",
    "statusCode": 404,
    "timestamp": "2026-04-23T20:00:00.000Z",
    "path": "/companies/me/applications/5d524fd9-8ea1-4c4f-bc15-b32072c144a1",
    "method": "PATCH",
    "details": "Not Found"
  }
}
```