---
title: "Refresh an OAuth2 access token. Rate limit to 10 calls per minute."
method: POST
path: "/v1/auth/refresh"
tags: ["Auth"]
---

# Refresh an OAuth2 access token. Rate limit to 10 calls per minute.

`POST /v1/auth/refresh`

Use the refresh token to obtain a new access token. The refresh token must be valid and unexpired.

## Request body

- object
  - `refresh_token` string, required — The refresh token issued during login.

## Response `200`

New access token generated successfully.

- object
  - `access_token` string — The new JWT token for API access.
  - `token_type` string — The type of token issued.
  - `expires_in` integer — Time in seconds until the access token expires.

## Other responses

- `400` — Invalid or missing refresh token.
- `401` — Expired refresh token.
- `404` — User associated with the token does not exist.
- `500` — Server error.

---

[API](https://skmtc.net/ellipsend/apis/ellipsend-api.md) · [All operations](https://skmtc.net/ellipsend/apis/ellipsend-api/llms.txt) · [OpenAPI document](https://skmtc-service-staging.skmtc.workers.dev/v1/apis/ellipsend/ellipsend-api/revisions/1031d523652c/schema)