Create an access token

POST

/v1/me/tokens

curl --request POST \
  --url https://api.gampeon.com/v1/me/tokens \
  --header 'Authorization: Bearer <token>' \
  --header 'Content-Type: application/json' \
  --data '{ "name": "example", "scopes": [ "profile:read" ], "expiresInDays": 1 }'

• Production

Creates a personal access token for an AI assistant, an MCP client or a tool. The answer contains the token once; only a hash is stored. A notification token_created is added to the account. Only with a portal session. Access tokens cannot manage tokens (403 token_not_allowed).

Not available with access tokens.

Rate limit: 10 per hour per account.

Authorizations

• session

Request Body^required

Media typeapplication/json

object

name

required

Name to recognise the token, for example “Claude Desktop”

string

>= 1 characters <= 64 characters

scopes

required

At least one scope

Array<string>

>= 1 items

Allowed values: profile:read projects:read projects:write marketplace:read marketplace:write servers:read

expiresInDays

Validity in days, default 30

integer

>= 1 <= 365

Responses

201

Token created

Media typeapplication/json

object

id

required

string

name

required

string

token

required

The token, gpat_ and 43 characters. Shown only in this answer.

string

prefix

required

string

scopes

required

Array<string>

Allowed values: profile:read projects:read projects:write marketplace:read marketplace:write servers:read

expiresAt

required

Unix time in milliseconds

integer format: int64

Example

{
  "scopes": [
    "profile:read"
  ]
}

400

Error codes: invalid_field

Media typeapplication/json

object

error

required

Machine-readable error code, for example not_found or rate_limited.

string

message

Human-readable detail. Only present for some errors.

string

Example ^generated

{
  "error": "example",
  "message": "example"
}

401

Error codes: unauthorized

Media typeapplication/json

object

error

required

Machine-readable error code, for example not_found or rate_limited.

string

message

Human-readable detail. Only present for some errors.

string

Example ^generated

{
  "error": "example",
  "message": "example"
}

403

Error codes: token_not_allowed

Media typeapplication/json

object

error

required

Machine-readable error code, for example not_found or rate_limited.

string

message

Human-readable detail. Only present for some errors.

string

Example ^generated

{
  "error": "example",
  "message": "example"
}

409

Error codes: token_limit_reached

Media typeapplication/json

object

error

required

Machine-readable error code, for example not_found or rate_limited.

string

message

Human-readable detail. Only present for some errors.

string

Example ^generated

{
  "error": "example",
  "message": "example"
}

429

Limit: 10 per hour per account. Error codes: rate_limited

Media typeapplication/json

object

error

required

Machine-readable error code, for example not_found or rate_limited.

string

message

Human-readable detail. Only present for some errors.

string

Example ^generated

{
  "error": "example",
  "message": "example"
}