2020-08-04 02:10:16 -04:00
---
stage: Verify
2021-05-26 11:10:57 -04:00
group: Pipeline Execution
2020-11-26 01:09:20 -05:00
info: To determine the technical writer assigned to the Stage/Group associated with this page, see https://about.gitlab.com/handbook/engineering/ux/technical-writing/#assignments
2020-08-04 02:10:16 -04:00
---
2021-05-30 23:10:48 -04:00
# Pipeline triggers API **(FREE)**
2017-03-05 15:18:00 -05:00
2021-06-28 08:38:12 -04:00
You can read more about [triggering pipelines through the API ](../ci/triggers/index.md ).
2017-03-05 15:18:00 -05:00
## List project triggers
Get a list of project's build triggers.
2020-02-28 22:07:51 -05:00
```plaintext
2017-03-05 15:18:00 -05:00
GET /projects/:id/triggers
```
| Attribute | Type | required | Description |
|-----------|---------|----------|---------------------|
2021-06-28 11:08:03 -04:00
| `id` | integer/string | yes | The ID or [URL-encoded path of the project ](index.md#namespaced-path-encoding ) owned by the authenticated user |
2017-03-05 15:18:00 -05:00
2020-02-28 22:07:51 -05:00
```shell
2018-12-27 04:03:08 -05:00
curl --header "PRIVATE-TOKEN: < your_access_token > " "https://gitlab.example.com/api/v4/projects/1/triggers"
2017-03-05 15:18:00 -05:00
```
```json
[
{
"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
}
]
```
2021-08-25 23:09:01 -04:00
The trigger token is displayed in full if the trigger token was created by the authenticated
user. Trigger tokens created by other users are shortened to four characters.
2017-03-05 15:18:00 -05:00
## Get trigger details
Get details of project's build trigger.
2020-02-28 22:07:51 -05:00
```plaintext
2017-03-05 15:18:00 -05:00
GET /projects/:id/triggers/:trigger_id
```
2017-03-22 08:18:06 -04:00
| Attribute | Type | required | Description |
|--------------|---------|----------|--------------------------|
2021-06-28 11:08:03 -04:00
| `id` | integer/string | yes | The ID or [URL-encoded path of the project ](index.md#namespaced-path-encoding ) owned by the authenticated user |
2020-05-07 02:09:38 -04:00
| `trigger_id` | integer | yes | The trigger ID |
2017-03-05 15:18:00 -05:00
2020-02-28 22:07:51 -05:00
```shell
2018-12-27 04:03:08 -05:00
curl --header "PRIVATE-TOKEN: < your_access_token > " "https://gitlab.example.com/api/v4/projects/1/triggers/5"
2017-03-05 15:18:00 -05:00
```
```json
{
"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.
2020-02-28 22:07:51 -05:00
```plaintext
2017-03-05 15:18:00 -05:00
POST /projects/:id/triggers
```
| Attribute | Type | required | Description |
|---------------|---------|----------|--------------------------|
2021-06-28 11:08:03 -04:00
| `id` | integer/string | yes | The ID or [URL-encoded path of the project ](index.md#namespaced-path-encoding ) owned by the authenticated user |
2017-03-05 15:18:00 -05:00
| `description` | string | yes | The trigger name |
2020-02-28 22:07:51 -05:00
```shell
2021-06-02 11:09:59 -04:00
curl --request POST --header "PRIVATE-TOKEN: < your_access_token > " \
--form description="my description" "https://gitlab.example.com/api/v4/projects/1/triggers"
2017-03-05 15:18:00 -05:00
```
```json
{
"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.
2020-02-28 22:07:51 -05:00
```plaintext
2017-03-05 15:18:00 -05:00
PUT /projects/:id/triggers/:trigger_id
```
| Attribute | Type | required | Description |
|---------------|---------|----------|--------------------------|
2021-06-28 11:08:03 -04:00
| `id` | integer/string | yes | The ID or [URL-encoded path of the project ](index.md#namespaced-path-encoding ) owned by the authenticated user |
2020-05-07 02:09:38 -04:00
| `trigger_id` | integer | yes | The trigger ID |
2017-03-05 15:18:00 -05:00
| `description` | string | no | The trigger name |
2020-02-28 22:07:51 -05:00
```shell
2021-06-02 11:09:59 -04:00
curl --request PUT --header "PRIVATE-TOKEN: < your_access_token > " \
--form description="my description" "https://gitlab.example.com/api/v4/projects/1/triggers/10"
2017-03-05 15:18:00 -05:00
```
```json
{
"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.
2020-02-28 22:07:51 -05:00
```plaintext
2017-03-05 15:18:00 -05:00
DELETE /projects/:id/triggers/:trigger_id
```
| Attribute | Type | required | Description |
|----------------|---------|----------|--------------------------|
2021-06-28 11:08:03 -04:00
| `id` | integer/string | yes | The ID or [URL-encoded path of the project ](index.md#namespaced-path-encoding ) owned by the authenticated user |
2020-05-07 02:09:38 -04:00
| `trigger_id` | integer | yes | The trigger ID |
2017-03-05 15:18:00 -05:00
2020-02-28 22:07:51 -05:00
```shell
2018-12-27 04:03:08 -05:00
curl --request DELETE --header "PRIVATE-TOKEN: < your_access_token > " "https://gitlab.example.com/api/v4/projects/1/triggers/5"
2017-03-05 15:18:00 -05:00
```