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

# Pause Job

> Pause a published job posting

## Endpoint

```
POST /api/v1/companies/me/jobs/{jobId}/pause
```

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

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

## Authentication

Include the access token in the Authorization header:

```bash theme={null}
Authorization: Bearer YOUR_ACCESS_TOKEN
```

## Description

Temporarily pause a published job posting. Paused jobs are hidden from candidates but can be published again later.

## Path Parameters

<ParamField name="jobId" type="string" required>
  The UUID of the job to pause.
</ParamField>

## Response

### Success Response (201 Created)

```json theme={null}
{
  "success": true,
  "data": {
    "id": "6cc9f0af-10c0-4998-b252-fc6c52394759",
    "title": "Backend Engineer",
    "description": "Job Description",
    "requirements": null,
    "responsibilities": null,
    "location": null,
    "salaryMin": null,
    "salaryMax": null,
    "jobType": "FULL_TIME",
    "workPreference": "REMOTE",
    "experienceLevel": "MID",
    "status": "PAUSED",
    "deadline": null,
    "publishedAt": "2026-02-22T14:51:00.000Z",
    "company": {
      "id": "8cfee915-6e24-4741-9493-fd5680743a84",
      "name": "Tech Corp",
      "logoUrl": null
    },
    "skills": [
      {
        "skillId": "1d1d1d93-c910-47e3-b2ff-5f5bc2ce0541",
        "name": "Node.js"
      }
    ]
  },
  "message": "Success",
  "meta": {
    "timestamp": "2026-04-23T20:00:00.000Z",
    "path": "/companies/me/jobs/{jobId}/pause",
    "method": "POST"
  }
}
```

## Error Responses

### 401 Unauthorized

```json theme={null}
{
  "success": false,
  "error": {
    "message": "Unauthorized",
    "statusCode": 401,
    "timestamp": "2026-04-23T20:00:00.000Z",
    "path": "/companies/me/jobs/{jobId}/pause",
    "method": "POST",
    "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/jobs/{jobId}/pause",
    "method": "POST",
    "details": "Forbidden"
  }
}
```

### 404 Not Found

```json theme={null}
{
  "success": false,
  "error": {
    "message": "Job not found",
    "statusCode": 404,
    "timestamp": "2026-04-23T20:00:00.000Z",
    "path": "/companies/me/jobs/{jobId}/pause",
    "method": "POST",
    "details": "Not Found"
  }
}
```

### 400 Bad Request - Invalid Status

```json theme={null}
{
  "success": false,
  "error": {
    "message": "Only published jobs can be paused",
    "statusCode": 400,
    "timestamp": "2026-04-23T20:00:00.000Z",
    "path": "/companies/me/jobs/{jobId}/pause",
    "method": "POST",
    "details": "Bad Request"
  }
}
```

## Notes

<Info>Only jobs with status `PUBLISHED` can be paused.</Info>

<Tip>**Reverting**: You can publish a paused job again using the publish endpoint.</Tip>