---
title: "PUT /v1/accessTokens"
method: PUT
path: "/v1/accessTokens"
---

# PUT /v1/accessTokens

`PUT /v1/accessTokens`

Creates a personal access token (PAT) for the current user. A personal access token (PAT) is similar to a password. It is associated with your user identity for use across all spaces and projects in Amazon CodeCatalyst. You use PATs to access CodeCatalyst from resources that include integrated development environments (IDEs) and Git-based source repositories. PATs represent you in Amazon CodeCatalyst and you can manage them in your user settings.For more information, see <a href="https://docs.aws.amazon.com/codecatalyst/latest/userguide/ipa-tokens-keys.html">Managing personal access tokens in Amazon CodeCatalyst</a>.

## Request body

- object
  - `name` string, required — The friendly name of the personal access token.
  - `expiresTime` string, date-time — The date and time the personal access token expires, in coordinated universal time (UTC) timestamp format as specified in <a href="https://www.rfc-editor.org/rfc/rfc3339#section-5.6">RFC 3339</a>.

## Response `201`

Success

- CreateAccessTokenResponse
  - `secret` string, password, required — The secret value of the personal access token.
  - `name` string, required — The friendly name of the personal access token.
  - `expiresTime` string, date-time, required — The date and time the personal access token expires, in coordinated universal time (UTC) timestamp format as specified in <a href="https://www.rfc-editor.org/rfc/rfc3339#section-5.6">RFC 3339</a>. If not specified, the default is one year from creation.
  - `accessTokenId` string, required — The system-generated unique ID of the access token.

## Other responses

- `480` — ThrottlingException
- `481` — ConflictException
- `482` — ValidationException
- `483` — ServiceQuotaExceededException
- `484` — ResourceNotFoundException
- `485` — AccessDeniedException

---

[API](https://skmtc.net/aws/apis/codecatalyst.md) · [All operations](https://skmtc.net/aws/apis/codecatalyst/llms.txt) · [OpenAPI document](https://skmtc-service-staging.skmtc.workers.dev/v1/apis/aws/codecatalyst/versions/b82f5a10dc49/schema)