---
title: "Changes to Create an API token."
method: POST
path: "/v1/api_tokens"
---

# Changes to Create an API token.

`POST /v1/api_tokens`

> Every recorded change to this operation, newest first.

## Timeline

Changed in 3 of 35 revisions.

- **2026-10-21** `426ea32f227a`: 2 warning, 2 info
- **2026-10-06** `60f786a4fd4c`: 9 warning, 9 info
- **2026-10-02** `c189f3097df5`: 2 warning, 2 info

## Changes

- **2026-10-21** `426ea32f227a`: 2 warning, 2 info
  - added the new `nhi:read` enum value to the `allOf[subschema #1: API Token Details]/scopes/items/` response property for the response status `201`
  - added the new `nhi:write` enum value to the `allOf[subschema #1: API Token Details]/scopes/items/` response property for the response status `201`
  - added the new `nhi:read` enum value to the request property `scopes/items/`
  - added the new `nhi:write` enum value to the request property `scopes/items/`
- **2026-10-06** `60f786a4fd4c`: 9 warning, 9 info
  - added the new `custom_tags:read` enum value to the `allOf[subschema #1: API Token Details]/scopes/items/` response property for the response status `201`
  - added the new `custom_tags:write` enum value to the `allOf[subschema #1: API Token Details]/scopes/items/` response property for the response status `201`
  - added the new `health_checks:read` enum value to the `allOf[subschema #1: API Token Details]/scopes/items/` response property for the response status `201`
  - added the new `health_checks:write` enum value to the `allOf[subschema #1: API Token Details]/scopes/items/` response property for the response status `201`
  - added the new `public-perimeter:read` enum value to the `allOf[subschema #1: API Token Details]/scopes/items/` response property for the response status `201`
  - added the new `scan:create-incidents` enum value to the `allOf[subschema #1: API Token Details]/scopes/items/` response property for the response status `201`
  - added the new `secrets:read` enum value to the `allOf[subschema #1: API Token Details]/scopes/items/` response property for the response status `201`
  - added the new `secrets:write` enum value to the `allOf[subschema #1: API Token Details]/scopes/items/` response property for the response status `201`
  - added the new `sources:scan` enum value to the `allOf[subschema #1: API Token Details]/scopes/items/` response property for the response status `201`
  - added the new `custom_tags:read` enum value to the request property `scopes/items/`
  - added the new `custom_tags:write` enum value to the request property `scopes/items/`
  - added the new `health_checks:read` enum value to the request property `scopes/items/`
  - added the new `health_checks:write` enum value to the request property `scopes/items/`
  - added the new `public-perimeter:read` enum value to the request property `scopes/items/`
  - added the new `scan:create-incidents` enum value to the request property `scopes/items/`
  - added the new `secrets:read` enum value to the request property `scopes/items/`
  - added the new `secrets:write` enum value to the request property `scopes/items/`
  - added the new `sources:scan` enum value to the request property `scopes/items/`
- **2026-10-02** `c189f3097df5`: 2 warning, 2 info
  - added the new `nhi:ownership:read` enum value to the `allOf[subschema #1: API Token Details]/scopes/items/` response property for the response status `201`
  - added the new `nhi:ownership:write` enum value to the `allOf[subschema #1: API Token Details]/scopes/items/` response property for the response status `201`
  - added the new `nhi:ownership:read` enum value to the request property `scopes/items/`
  - added the new `nhi:ownership:write` enum value to the request property `scopes/items/`

---

[Operation](https://skmtc.dev/gitguardian/apis/gitguardian-api/docs/v1/api_tokens/post.md) - [API](https://skmtc.dev/gitguardian/apis/gitguardian-api.md) - [Page](https://skmtc.dev/gitguardian/apis/gitguardian-api/changes/v1/api_tokens/post)