---
title: "Create new API token for automation"
method: POST
path: "/tokens"
tags: ["Tokens"]
---

# Create new API token for automation

`POST /tokens`

## Request body

- ModelsCreateAPITokenRequest
  - `name` string
  - `ttl` integer, required — from 1 minute to 3 years

## Response `201`

token created successful

- object
  - `data` object
    - `created_at` string, required
    - `deleted_at` string
    - `id` integer
    - `name` string
    - `role_id` integer
    - `status` string, required
    - `token` string, required
    - `token_id` string, required
    - `ttl` integer, required
    - `updated_at` string, required
    - `user_id` integer
  - `status` string

## Other responses

- `400` — invalid token request or default salt
- `403` — creating token not permitted
- `500` — internal error on creating token

---

[API](https://skmtc.dev/vxcontrol/apis/pentagi-swagger-api.md) · [All operations](https://skmtc.dev/vxcontrol/apis/pentagi-swagger-api/llms.txt) · [OpenAPI document](https://skmtc-service-production.skmtc.workers.dev/v1/apis/vxcontrol/pentagi-swagger-api/revisions/7c1cbf7abaa1/schema)