Create a project access token
Creates a project access token for a specified project. You cannot create a token with an access level greater than your account. For example, a user with the Maintainer role cannot create a project access token with the Owner role. You must use a personal access token with this endpoint. You cannot authenticate with a project access token.
Authorizations
Section titled “ Authorizations ”Parameters
Section titled “ Parameters ”Path Parameters
Section titled “ Path Parameters ”The project ID
Example
2Request Body required
Section titled “ Request Body required ”object
The name of the access token
Example
My tokenThe description of the access token
Example
A token used for k8sThe expiration date of the token. If ‘Require personal access token expiry’ is enabled, you must provide a valid value, if not, the token will never expire.
Example
2026-02-14The permissions of the token
The access level of the token in the project
Responses
Section titled “ Responses ”Created
object
The five most recent unique IP addresses that have authenticated with this token. When the limit is reached, the oldest IP address is removed. The list updates once per minute per token.
object
Example
{ "id": 2, "name": "John Doe", "description": "Token to manage api", "scopes": [ "api" ], "user_id": 3, "last_used_at": "2020-08-31T15:53:00.073Z", "expires_at": "2020-08-31T15:53:00.073Z", "last_used_ips": [ "127.0.0.1", "127.0.0.2", "127.0.0.3" ], "granular_scopes": [ { "access": "personal_projects", "permissions": [ "read_job" ], "project_id": 3, "group_id": 5 } ], "access_level": 40, "resource_type": "project", "resource_id": 1234}Bad Request
Not Found