# Create a share code

`POST /v1/templates/{template}/shares`

**In this build:** Real.

**Scope:** `snapshot.write`

**CLI:** `harebox template share`

## Request: `CreateShareRequest`

| Field | Type | Notes |
|---|---|---|
| `expires_seconds` | `integer` |  |
| `max_uses` | `integer` |  |

## Response: 201

`ShareWithCode`

`ShareWithCode`

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