GIgitlab
ci_triggers

Create a trigger token

Creates a pipeline trigger token for a project.

post/api/v4/projects/{id}/triggers

Request

  • Base URL
    https://gitlab.com
  • Auth
    none declared

Path parameters

idstring required

The ID or URL-encoded path of the project

Request body

descriptionstring required

The trigger token description

expires_atstring date-time

Timestamp of when the pipeline trigger token expires.

Example request

{
  "description": "my trigger token description",
  "expires_at": "2024-07-01T00:00:00.000Z"
}

Response

Create a trigger token

idinteger required
tokenstring required
descriptionstring required
created_atstring date-time required
updated_atstring date-time required
last_usedstring date-time required
expires_atstring date-time required

Example response

{
  "id": 10,
  "token": "6d056f63e50fe6f8c5f8f4aa10edb7",
  "description": "test",
  "created_at": "2015-12-24T15:51:21.880Z",
  "updated_at": "2015-12-24T17:54:31.198Z",
  "last_used": "2015-12-24T17:54:31.198Z",
  "expires_at": "2015-12-24T17:54:31.198Z",
  "owner": {
    "id": 1,
    "username": "admin",
    "public_email": "john@example.com",
    "name": "Administrator",
    "state": "active",
    "avatar_url": "https://gravatar.com/avatar/1",
    "avatar_path": "/user/avatar/28/The-Big-Lebowski-400-400.png",
    "custom_attributes": [
      {
        "key": "foo",
        "value": "bar"
      }
    ],
    "web_url": "https://gitlab.example.com/root"
  }
}

Changes

No recorded changes to this operation across all 5 revisions of this API.