Skip to main content

Add Tags to Webhook

Endpoint: PUT /api/metadata/webhook/{id}/tags

Adds tags to a webhook. You can add a single tag or multiple tags in one request. This operation updates any existing tags with the provided ones.

Path parameters

ParamaeterDescriptionTypeRequired
idThe unique identifier of the webhook to which the tags are to be added.stringRequired.

Response

Returns 200 OK with an array of webhook objects, including parameters such as id, name, sourcePlatform, verifier, webhookExecutionHistory, and more.

Request body

The request body should be an array of tag objects.

ParamaeterDescriptionTypeRequired
keyThe tag key.stringRequired.
valueThe tag value.stringRequired.

Example for adding multiple tags in a single request:

[
{
"key": "dev",
"value": "automation"
},
{
"key": "backend",
"value": "PR"
}
]

Response

Returns 200 OK, indicating that the tags have been added to the webhook.

Examples

Add a single tag to a webhook

Request

curl -X 'PUT' \
'https://<YOUR-SERVER-URL>/api/metadata/webhook/897f37a7-f2a4-11f0-97ee-8e75126ccff4/tags' \
-H 'accept: */*' \
-H 'X-Authorization: <TOKEN>' \
-H 'Content-Type: application/json' \
-d '[
{
"key": "platform",
"value": "Jira"
}
]'

Response

Returns 200 OK, indicating that the tags have been added to the webhook.

Add multiple tags to a webhook

Request

curl -X 'PUT' \
'https://<YOUR-SERVER-URL>/api/metadata/webhook/897f37a7-f2a4-11f0-97ee-8e75126ccff4/tags' \
-H 'accept: */*' \
-H 'X-Authorization: <TOKEN>' \
-H 'Content-Type: application/json' \
-d '[
{
"key": "dev",
"value": "automation"
},
{
"key": "backend",
"value": "PR"
}
]
'

Response

Returns 200 OK, indicating that the tags have been added to the webhook.