Pipeline triggers API

You can read more about triggering pipelines through the API.

List project triggers

Get a list of project’s build triggers.

GET /projects/:id/triggers
AttributeTyperequiredDescription
idinteger/stringyesThe ID or URL-encoded path of the project owned by the authenticated user
curl --header "PRIVATE-TOKEN: <your_access_token>" "https://gitlab.example.com/api/v4/projects/1/triggers"
[
    {
        "id": 10,
        "description": "my trigger",
        "created_at": "2016-01-07T09:53:58.235Z",
        "last_used": null,
        "token": "6d056f63e50fe6f8c5f8f4aa10edb7",
        "updated_at": "2016-01-07T09:53:58.235Z",
        "owner": null
    }
]

Get trigger details

Get details of project’s build trigger.

GET /projects/:id/triggers/:trigger_id
AttributeTyperequiredDescription
idinteger/stringyesThe ID or URL-encoded path of the project owned by the authenticated user
trigger_idintegeryesThe trigger id
curl --header "PRIVATE-TOKEN: <your_access_token>" "https://gitlab.example.com/api/v4/projects/1/triggers/5"
{
    "id": 10,
    "description": "my trigger",
    "created_at": "2016-01-07T09:53:58.235Z",
    "last_used": null,
    "token": "6d056f63e50fe6f8c5f8f4aa10edb7",
    "updated_at": "2016-01-07T09:53:58.235Z",
    "owner": null
}

Create a project trigger

Create a trigger for a project.

POST /projects/:id/triggers
AttributeTyperequiredDescription
idinteger/stringyesThe ID or URL-encoded path of the project owned by the authenticated user
descriptionstringyesThe trigger name
curl --request POST --header "PRIVATE-TOKEN: <your_access_token>" --form description="my description" "https://gitlab.example.com/api/v4/projects/1/triggers"
{
    "id": 10,
    "description": "my trigger",
    "created_at": "2016-01-07T09:53:58.235Z",
    "last_used": null,
    "token": "6d056f63e50fe6f8c5f8f4aa10edb7",
    "updated_at": "2016-01-07T09:53:58.235Z",
    "owner": null
}

Update a project trigger

Update a trigger for a project.

PUT /projects/:id/triggers/:trigger_id
AttributeTyperequiredDescription
idinteger/stringyesThe ID or URL-encoded path of the project owned by the authenticated user
trigger_idintegeryesThe trigger id
descriptionstringnoThe trigger name
curl --request PUT --header "PRIVATE-TOKEN: <your_access_token>" --form description="my description" "https://gitlab.example.com/api/v4/projects/1/triggers/10"
{
    "id": 10,
    "description": "my trigger",
    "created_at": "2016-01-07T09:53:58.235Z",
    "last_used": null,
    "token": "6d056f63e50fe6f8c5f8f4aa10edb7",
    "updated_at": "2016-01-07T09:53:58.235Z",
    "owner": null
}

Remove a project trigger

Remove a project’s build trigger.

DELETE /projects/:id/triggers/:trigger_id
AttributeTyperequiredDescription
idinteger/stringyesThe ID or URL-encoded path of the project owned by the authenticated user
trigger_idintegeryesThe trigger id
curl --request DELETE --header "PRIVATE-TOKEN: <your_access_token>" "https://gitlab.example.com/api/v4/projects/1/triggers/5"