Create a new event subscription
On this page:
POST /v1/command/create-subscription
Requires authentication via primary certificate (RBAC not required).
Body parameter
{
"service_name": "string",
"event_types": [
"node_errored"
],
"callback_url": "http://example.com",
"secret": "string",
"enabled": true
}
Parameters
| Name | In | Type | Required | Description |
|---|---|---|---|---|
| body | body | subscription | true | none |
Example response
201 response
{
"id": "497f6eca-6276-4993-bfeb-53cbbbba6f08"
}
Responses
| Status | Meaning | Description | Schema |
|---|---|---|---|
| 201 | Created | Subscription created successfully | entity-id |
| 401 | Unauthorized | Authentication failed | not-authenticated-error |
| 403 | Forbidden | Requestor does not have create permissions. | forbidden-request-error |
| 415 | Unsupported Media Type | Content type of payload is unsupported | content-type-error |
| 500 | Internal Server Error | Unexpected server error | error |
