# Rotate a URL token atomically

`POST /v1/sandboxes/{sandbox}/endpoints/{endpoint}/rotate`

**In this build:** Real.

**Scope:** `host`

**CLI:** `harebox host rotate`

## Request: `RotateRequest`

| Field | Type | Notes |
|---|---|---|
| `overlap_seconds` | `integer` | How long the old value stays valid. |

## Response: 200

`Endpoint`

| Field | Type | Notes |
|---|---|---|
| `id` (required) | `string` |  |
| `port` (required) | `integer` |  |
| `protocol` (required) | `string` |  |
| `auth` (required) | `string` |  |
| `url` (required) | `string` |  |
| `token` | `string or null` | Returned on create and on rotate only. |
| `domain` | `string or null` |  |

Errors follow [one format](../errors.html).