---
title: "Refresh the connection"
method: POST
path: "/api/v2/connect/refresh"
tags: ["Connect"]
---

# Refresh the connection

`POST /api/v2/connect/refresh`

Connection access tokens expire after one hour. Exchange the refresh token for a new pair before then.

Each refresh returns a **new** refresh token and invalidates the old one — replace the stored token every time.

## Request body

- object
  - `refresh_token` string, required — The refresh token from the most recent `/connect/verify` or `/connect/refresh`.

## Response `200`

The new token pair.

- ConnectionRefreshed
  - `object` 'connection'
  - `access_token` string — The new connection access token.
  - `refresh_token` string — The new refresh token. The old one is now invalid — replace the stored token every time.
  - `token_type` 'Bearer'
  - `expires_in` integer — Seconds until the access token expires (3600 = one hour).

## Other responses

- `400` — `invalid_request` — missing `refresh_token`. `client_credentials_required` — the token wasn't minted from client credentials.
- `401` — `invalid_refresh_token` — that refresh token is invalid or expired.

---

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