---
title: "Create an API token"
method: POST
path: "/v1/me/tokens"
tags: ["Tokens"]
---

# Create an API token

`POST /v1/me/tokens`

## Request

- Base URL: `https://shareout.site`
- URL: `https://shareout.site/v1/me/tokens`
- Auth: HTTP bearer

Mints a personal token, returned once. Body optional; `{ "regenerate": true }` first revokes all of the caller's existing tokens.

## Request body

- object
  - `regenerate` boolean

## Response `200`

Created

- object
  - `ok` boolean
  - `token` string
  - `shown_once` boolean

## Other responses

- `401`: Authentication required

## Changes

- **2026-10-13** `ed6fa61bd690`: 1 info
  - endpoint added

[Operation history](https://skmtc.dev/shareout/apis/shareout-rest-api/changes/v1/me/tokens/post.md)

---

[API](https://skmtc.dev/shareout/apis/shareout-rest-api.md) - [All operations](https://skmtc.dev/shareout/apis/shareout-rest-api/llms.txt) - [OpenAPI document](https://skmtc.dev/shareout/apis/shareout-rest-api/revisions/1e3f7fd34f6d?raw)