---
title: "POST /auth/refresh"
method: POST
path: "/auth/refresh"
tags: ["auth"]
---

# POST /auth/refresh

`POST /auth/refresh`

Generates a new auth token if the refresh token is valid.

## Headers

- `x-refresh-token` string, required
- `authorization` string, required

## Request body

- object

## Response `200`

New access token generated.

- SuccessResponse
  - `success` boolean
  - `msg` string
  - `data` object

## Other responses

- `401` — Unauthorized or invalid refresh token.
- `500` — Internal Server Error

## Changes

- **2025-04-20** `b97ec6888b3c` — 1 info
  - endpoint added

[Change history](https://skmtc.dev/bluewave-labs/apis/checkmate-api/changes/auth/refresh/post.md)

---

[API](https://skmtc.dev/bluewave-labs/apis/checkmate-api.md) · [All operations](https://skmtc.dev/bluewave-labs/apis/checkmate-api/llms.txt) · [OpenAPI document](https://skmtc-service-production.skmtc.workers.dev/v1/apis/bluewave-labs/checkmate-api/revisions/b97ec6888b3c/schema)