Skip to main content

Configure webhooks

Certain actions in SE2 can trigger webhooks to notify other services of the event. The receivers of webhooks get contextually relevant information about the request SE2 receiver. By default, no webhooks are configured.

You can set your own webhooks in the se2-config.yaml file that subo created for you in your suborbital/config directory.

Configuration options

The webhooks stanza in se2-config.yaml consists of a top level webhooks object with a list of entries.

Each entry has an id referencing the builder.function.promoted hook point and a list of one or more HTTP targets, which consist of a url, method, and dictionary of headers (optional).

Examples

A simple inline example:

se2-config.yaml
capabilities:
# ...

webhooks:
- id: builder.function.promoted
targets:
- url: http://example.com/promoted
method: POST
headers:
'X-Some-Header': 'some value'

An example with shared headers and multiple targets for a single hook point:

se2-config.yaml
commonHeaders: &commonHeaders
'Authorization': 'Bearer d2UncmUgaGlyaW5nCg=='

webhooks:
- id: builder.function.promoted
targets:
- url: http://echo-server:1234/promoted
method: POST
headers: *commonHeaders

- url: https://postman-echo.com/post
method: POST
headers: *commonHeaders

Hook points

Devs at work

Stay tuned for more hook points!

builder.function.promoted

Description Runs when an end user successfully deploys a plugin.

Sample response(JSON):

{
"webhook_id": "builder.function.promoted",
"compute_context": {
"request_id": "ac1f5e84-5327-46a5-9d71-8ad766f39979",
"request_url": "/api/v1/draft/com.suborbital.demo/default/webhook/promote"
},
"response_body": {
"ident": "com.suborbital.demo",
"namespace": "default",
"fn": "webhook",
"version": "v1.0.0"
}
}