---
title: "POST /auth/v1/tokens"
method: POST
path: "/auth/v1/tokens"
---

# POST /auth/v1/tokens

`POST /auth/v1/tokens`

Authenticates a user with `Authorization` header and returns a `token`
object.

## Headers

- `authorization` string
- `x-forwarded-for` string
- `x-forwarded-user` string

## Request body

- TokenRequest
  - `ttl` integer, nullable

## Response `201`

New token has been created

## Other responses

- `401` — Invalid or missing credentials has been provided
- `default` — Unexpected error

## Changes

- **2023-10-22** `552a9ff50584` — 1 info
  - added the new optional `header` request parameter `x-forwarded-user`
- **2018-08-01** `2c25ec6eb308` — 1 warning
  - deleted the `header` request parameter `x-forwarded-user`

[Change history](https://skmtc.dev/stackstorm/apis/stackstorm-api/changes/auth/v1/tokens/post.md)

---

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