---
title: "CreatePersonalAccessToken"
method: POST
path: "/gitpod.v1.UserService/CreatePersonalAccessToken"
tags: ["gitpod.v1.UserService"]
---

# CreatePersonalAccessToken

`POST /gitpod.v1.UserService/CreatePersonalAccessToken`

Creates a new personal access token for API authentication.

 Use this method to:
 - Generate API access tokens
 - Create service account credentials
 - Set up automated access

 ### Examples

 - Create token:

   Creates a new access token valid for 30 days.

   ```yaml
   userId: "f53d2330-3795-4c5d-a1f3-453121af9c60"
   description: "CI/CD Pipeline Token"
   validFor: "2592000s"  # 30 days
   ```

## Request body

- GitpodV1CreatePersonalAccessTokenRequest
  - `description` string
  - `readOnly` boolean — When true, the token can only be used for read operations. Mutations will be denied at the data layer.
  - `userId` string, uuid
  - `validFor` string, regex — A Duration represents a signed, fixed-length span of time represented as a count of seconds and fractions of seconds at nanosecond resolution. It is independent of any calendar and concepts like "day" or "month". It is related to Timestamp in that the difference between two Timestamp values is a Duration and it can be added or subtracted from a Timestamp. Range is approximately +-10,000 years. # Examples Example 1: Compute Duration from two Timestamps in pseudo code. Timestamp start = ...; Timestamp end = ...; Duration duration = ...; duration.seconds = end.seconds - start.seconds; duration.nanos = end.nanos - start.nanos; if (duration.seconds < 0 && duration.nanos > 0) { duration.seconds += 1; duration.nanos -= 1000000000; } else if (duration.seconds > 0 && duration.nanos < 0) { duration.seconds -= 1; duration.nanos += 1000000000; } Example 2: Compute Timestamp from Timestamp + Duration in pseudo code. Timestamp start = ...; Duration duration = ...; Timestamp end = ...; end.seconds = start.seconds + duration.seconds; end.nanos = start.nanos + duration.nanos; if (end.nanos < 0) { end.seconds -= 1; end.nanos += 1000000000; } else if (end.nanos >= 1000000000) { end.seconds += 1; end.nanos -= 1000000000; } Example 3: Compute Duration from datetime.timedelta in Python. td = datetime.timedelta(days=3, minutes=10) duration = Duration() duration.FromTimedelta(td) # JSON Mapping In JSON format, the Duration type is encoded as a string rather than an object, where the string ends in the suffix "s" (indicating seconds) and is preceded by the number of seconds, with nanoseconds expressed as fractional seconds. For example, 3 seconds with 0 nanoseconds should be encoded in JSON format as "3s", while 3 seconds and 1 nanosecond should be expressed in JSON format as "3.000000001s", and 3 seconds and 1 microsecond should be expressed in JSON format as "3.000001s".

## Response `200`

Success

- GitpodV1CreatePersonalAccessTokenResponse
  - `token` string, required

## Other responses

- `default` — Error

---

[API](https://skmtc.net/gitpod-io/apis/gitpod-v1.md) · [All operations](https://skmtc.net/gitpod-io/apis/gitpod-v1/llms.txt) · [OpenAPI document](https://skmtc-service-staging.skmtc.workers.dev/v1/apis/gitpod-io/gitpod-v1/revisions/44d50c2ac284/schema)