---
title: "POST /api/users/{user}/personalAccessTokens"
method: POST
path: "/api/users/{user}/personalAccessTokens"
tags: ["UserService"]
---

# POST /api/users/{user}/personalAccessTokens

`POST /api/users/{user}/personalAccessTokens`

## Request

- The document declares no server URL.
- Auth: none declared

CreatePersonalAccessToken creates a personal access token for a user.
 Only the user may call it. The token value is returned only once, in the
 response.

## Path parameters

- `user` string, required

## Request body

- CreatePersonalAccessTokenRequest: Request message for UserService.CreatePersonalAccessToken.
  - `parent` string, required: Required. The user who owns the token. Must be the caller. Format: users/{user}
  - `description` string: Optional. The description of the token.
  - `expiresInDays` integer: Optional. The lifetime of the token in days. 0 means the token never expires.

## Response `200`

OK

- CreatePersonalAccessTokenResponse: Response message for UserService.CreatePersonalAccessToken.
  - `personalAccessToken` PersonalAccessToken: PersonalAccessToken is a long-lived token for API and script access. PATs are distinct from short-lived JWT access tokens used for session authentication.
    - `name` string: Identifier. The resource name of the personal access token. Format: users/{user}/personalAccessTokens/{personal_access_token}
    - `description` string: Optional. The description of the token.
    - `createTime` string, date-time: Output only. The creation time.
    - `expireTime` string, date-time: Optional. The expiration time. Unset means the token never expires.
    - `lastUseTime` string, date-time: Output only. The time the token was last used.
  - `token` string: The token value. This is the only time it is returned.

## Other responses

- `default`: Default error response

## Changes

- **2026-10-08** `1846a777b0ef`: 1 info
  - endpoint added

[Operation history](https://skmtc.dev/usememos/apis/untitled-api/changes/api/users/:user/personalAccessTokens/post.md)

---

[API](https://skmtc.dev/usememos/apis/untitled-api.md) - [All operations](https://skmtc.dev/usememos/apis/untitled-api/llms.txt) - [OpenAPI document](https://skmtc.dev/usememos/apis/untitled-api/revisions/f587355e35b4?raw)