---
title: "Rotate a refresh token for a new session"
method: POST
path: "/refresh"
tags: ["auth"]
---

# Rotate a refresh token for a new session

`POST /refresh`

## Request

- Base URL: `https://api.catena.com/v1/agent-api`
- URL: `https://api.catena.com/v1/agent-api/refresh`
- Auth: none declared

## Request body

- object
  - `refreshToken` string, required

## Response `200`

New session and refresh tokens minted

- object
  - `sessionToken` string, required
  - `refreshToken` string, required
  - `apiKey` string, required
  - `expiresAt` string, date-time, required

## Other responses

- `401`: Unknown, revoked, or expired refresh token
- `403`: Agent revoked, suspended, or inactive

---

[API](https://skmtc.dev/catena/apis/catena-agent-api.md) - [All operations](https://skmtc.dev/catena/apis/catena-agent-api/llms.txt) - [OpenAPI document](https://skmtc.dev/catena/apis/catena-agent-api/revisions/9b72e32d21f1?raw)