Testkube Control Plane ../webhooks operations

• getList webhooks
• postCreate new webhook
• delDelete webhooks
• getGet webhook details
• delDelete webhook
• patchUpdate new webhook

API docs by Redocly

Testkube Pro API (cloud-api/1.10.38)

Download OpenAPI specification:Download

E-mail: testkube@kubeshop.io License: COMMERICAL

API for Testkube Pro

List webhooks

List webhooks available in cluster

path Parameters

id required	string organizationId
environmentId required	string environmentID

query Parameters

selector

string Example: selector=kubernetes.io/app=demo Only workflow executions with given status are included in this time series chart.

Responses

https://raw.githubusercontent.com/organizations/{id}/environments/{environmentId}/agent/webhooks

Response samples

• 200
• 400
• 502

Content type

application/jsontext/yamlapplication/json

[

• {

  • "name": "webhook1",
  • "namespace": "testkube",
  • "uri": "https://hooks.app.com/services/1",
  • "events": [

    • "start-test"

    ],
  • "selector": "string",
  • "payloadObjectField": "string",
  • "payloadTemplate": "string",
  • "payloadTemplateReference": "string",
  • "headers": {

    • "Content-Type": "application/xml"

    },
  • "labels": {

    • "app": "backend",
    • "env": "prod"

    },
  • "disabled": [

    • true,
    • false

    ],
  • "onStateChange": [

    • true,
    • false

    ]

  }

]

Create new webhook

Create new webhook based on variables passed in request

path Parameters

id required	string organizationId
environmentId required	string environmentID

Request Body schema:

application/jsontext/yamlapplication/json

required

webhook request body data

name	string
namespace	string
uri required	string
events required	Array of strings (EventType) Items Enum: "start-test" "end-test-success" "end-test-failed" "end-test-aborted" "end-test-timeout" "start-testsuite" "end-testsuite-success" "end-testsuite-failed" "end-testsuite-aborted" "end-testsuite-timeout" "queue-testworkflow" "start-testworkflow" "end-testworkflow-success" "end-testworkflow-failed" "end-testworkflow-aborted" "created" "updated" "deleted"
selector	string Labels to filter for tests and test suites
payloadObjectField	string will load the generated payload for notification inside the object
payloadTemplate	string golang based template for notification payload
payloadTemplateReference	string name of the template resource
	object webhook headers (golang template supported)
	object webhook labels
disabled	boolean Default: false whether webhook is disabled
onStateChange	boolean Default: false whether webhook is triggered on state change only

Responses

https://raw.githubusercontent.com/organizations/{id}/environments/{environmentId}/agent/webhooks

Request samples

• Payload

Content type

application/jsontext/yamlapplication/json

{

• "name": "webhook1",
• "namespace": "testkube",
• "uri": "https://hooks.app.com/services/1",
• "events": [

  • "start-test"

  ],
• "selector": "string",
• "payloadObjectField": "string",
• "payloadTemplate": "string",
• "payloadTemplateReference": "string",
• "headers": {

  • "Content-Type": "application/xml"

  },
• "labels": {

  • "app": "backend",
  • "env": "prod"

  },
• "disabled": [

  • true,
  • false

  ],
• "onStateChange": [

  • true,
  • false

  ]

}

Response samples

• 201
• 400
• 502

Content type

application/json

{

• "name": "webhook1",
• "namespace": "testkube",
• "uri": "https://hooks.app.com/services/1",
• "events": [

  • "start-test"

  ],
• "selector": "string",
• "payloadObjectField": "string",
• "payloadTemplate": "string",
• "payloadTemplateReference": "string",
• "headers": {

  • "Content-Type": "application/xml"

  },
• "labels": {

  • "app": "backend",
  • "env": "prod"

  },
• "disabled": [

  • true,
  • false

  ],
• "onStateChange": [

  • true,
  • false

  ]

}

Delete webhooks

Deletes labeled webhooks

path Parameters

id required	string organizationId
environmentId required	string environmentID

query Parameters

selector

string Example: selector=kubernetes.io/app=demo Only workflow executions with given status are included in this time series chart.

Responses

https://raw.githubusercontent.com/organizations/{id}/environments/{environmentId}/agent/webhooks

Response samples

• 502

Content type

application/problem+json

[

• {

  • "type": "https://kubeshop.io/testkube/problems/invalidtestname",
  • "title": "Invalid test name",
  • "status": 500,
  • "detail": "Your test name can't contain forbidden characters like \"}}}\" passed",
  • "instance": "http://10.23.23.123:8088/tests"

  }

]

Get webhook details

Returns webhook

path Parameters

environmentId required	string environmentID
id required	string unique id of the object

Responses

https://raw.githubusercontent.com/organizations/{id}/environments/{environmentId}/agent/webhooks/{id}

Response samples

• 200
• 400
• 404
• 500
• 502

Content type

application/jsontext/yamlapplication/json

{

• "name": "webhook1",
• "namespace": "testkube",
• "uri": "https://hooks.app.com/services/1",
• "events": [

  • "start-test"

  ],
• "selector": "string",
• "payloadObjectField": "string",
• "payloadTemplate": "string",
• "payloadTemplateReference": "string",
• "headers": {

  • "Content-Type": "application/xml"

  },
• "labels": {

  • "app": "backend",
  • "env": "prod"

  },
• "disabled": [

  • true,
  • false

  ],
• "onStateChange": [

  • true,
  • false

  ]

}

Delete webhook

Deletes webhook by its name

path Parameters

environmentId required	string environmentID
id required	string unique id of the object

Responses

https://raw.githubusercontent.com/organizations/{id}/environments/{environmentId}/agent/webhooks/{id}

Response samples

• 404
• 502

Content type

application/problem+json

[

• {

  • "type": "https://kubeshop.io/testkube/problems/invalidtestname",
  • "title": "Invalid test name",
  • "status": 500,
  • "detail": "Your test name can't contain forbidden characters like \"}}}\" passed",
  • "instance": "http://10.23.23.123:8088/tests"

  }

]

Update new webhook

Update new webhook based on variables passed in request

path Parameters

environmentId required	string environmentID
id required	string unique id of the object

Request Body schema:

application/jsontext/yamlapplication/json

required

webhook request body data

name	string
namespace	string
uri required	string
events required	Array of strings (EventType) Items Enum: "start-test" "end-test-success" "end-test-failed" "end-test-aborted" "end-test-timeout" "start-testsuite" "end-testsuite-success" "end-testsuite-failed" "end-testsuite-aborted" "end-testsuite-timeout" "queue-testworkflow" "start-testworkflow" "end-testworkflow-success" "end-testworkflow-failed" "end-testworkflow-aborted" "created" "updated" "deleted"
selector	string Labels to filter for tests and test suites
payloadObjectField	string will load the generated payload for notification inside the object
payloadTemplate	string golang based template for notification payload
payloadTemplateReference	string name of the template resource
	object webhook headers (golang template supported)
	object webhook labels
disabled	boolean Default: false whether webhook is disabled
onStateChange	boolean Default: false whether webhook is triggered on state change only

Responses

https://raw.githubusercontent.com/organizations/{id}/environments/{environmentId}/agent/webhooks/{id}

Request samples

• Payload

Content type

application/jsontext/yamlapplication/json

{

• "name": "webhook1",
• "namespace": "testkube",
• "uri": "https://hooks.app.com/services/1",
• "events": [

  • "start-test"

  ],
• "selector": "string",
• "payloadObjectField": "string",
• "payloadTemplate": "string",
• "payloadTemplateReference": "string",
• "headers": {

  • "Content-Type": "application/xml"

  },
• "labels": {

  • "app": "backend",
  • "env": "prod"

  },
• "disabled": [

  • true,
  • false

  ],
• "onStateChange": [

  • true,
  • false

  ]

}

Response samples

• 200
• 400
• 404
• 502

Content type

application/json

{

• "name": "webhook1",
• "namespace": "testkube",
• "uri": "https://hooks.app.com/services/1",
• "events": [

  • "start-test"

  ],
• "selector": "string",
• "payloadObjectField": "string",
• "payloadTemplate": "string",
• "payloadTemplateReference": "string",
• "headers": {

  • "Content-Type": "application/xml"

  },
• "labels": {

  • "app": "backend",
  • "env": "prod"

  },
• "disabled": [

  • true,
  • false

  ],
• "onStateChange": [

  • true,
  • false

  ]

}