G-g-core
API Tokens

Create API token

Changed on

Deprecated: This endpoint will be removed on 2026-07-17. Use POST /v2/clients/{clientId}/tokens instead.

Create an API token in the current account.

post/iam/clients/{clientId}/tokens

Request

  • Base URL
    https://api.gcore.com
  • URL
    https://api.gcore.com/iam/clients/{clientId}/tokens
  • Auth
    HTTP apikey

Path parameters

clientIdinteger required

Account ID.

Request body

namestring required

API token name.

descriptionstring

API token description.

exp_datestring nullable required

Date when the API token becomes expired (ISO 8086/RFC 3339 format), UTC. If null, then the API token will never expire.

Example request

{
  "name": "My token",
  "description": "It's my token",
  "exp_date": "2021-01-01T12:00:00.000000Z",
  "client_user": {
    "role": {
      "id": 1,
      "name": "Administrators"
    }
  }
}

Response

OK.

tokenstring

API token. Copy it, because you will not be able to get it again. We do not store tokens. All responsibility for token storage and usage is on the issuer.

namestring required

API token name.

descriptionstring

API token description.

exp_datestring nullable required

Date when the API token becomes expired (ISO 8086/RFC 3339 format), UTC. If null, then the API token will never expire.

idinteger required

API token ID.

deletedboolean required

Deletion flag. If true, then the API token was deleted.

expiredboolean required

Expiration flag. If true, then the API token has expired. When an API token expires it will be automatically deleted.

createdstring required

Date when the API token was issued (ISO 8086/RFC 3339 format), UTC.

last_usagestring required

Date when the API token was last used (ISO 8086/RFC 3339 format), UTC.

Example response

{
  "name": "My token",
  "description": "It's my token",
  "exp_date": "2021-01-01T12:00:00.000000Z",
  "client_user": {
    "role": {
      "id": 1,
      "name": "Administrators"
    },
    "user_id": 123,
    "user_name": "John Doe",
    "user_email": "some@email.com",
    "client_id": 456
  },
  "id": 42,
  "created": "2021-01-01T12:00:00.000000Z",
  "last_usage": "2021-01-01T12:00:00.000000Z"
}

Changes

  • eb97fe6d936eRevision changes
    • info

      endpoint deprecated

  • a02801156a6aRevision changes
    • info

      added to the /// response property allOf list for the response status

    • info

      removed from the /// response property allOf list for the response status