/api/v1/auth/refreshRequires none scope with none authentication.
Parameters
| Param | Type | Required | Description | Options |
|---|---|---|---|---|
| refresh_token | string | Yes | Refresh token used to issue new access token. | - |
Security Warning:
IDE tokens (Cursor, Claude Code) are issued from Access Control > IDE and restricted server-side: only allowlisted read endpoints, task status updates (status only) and PR linking are reachable, there is no DELETE, access can be limited to selected projects, and the token can expire or be revoked at any time (revocation is immediate).
Treat refresh tokens like passwords. Do not pass them to LLMs, AI agents, or third-party tools unless you fully trust and control data retention, logging, and access policies. If a refresh token is exposed, an attacker can keep rotating and minting new access tokens until the credential or refresh token chain is revoked.
Request Example
Use the snippet below to call this endpoint from your app or CLI.
Response Example
Toggle between a success and failure payload returned by this endpoint.