SIGNL4 API
Use our API for systems integration or to build your own use cases. Sample scenarios include but are not limited to:
- 2-way integration: Triggering of Signls and updates in the third party systems when alert state changes occur
- Retrieving alarms for logging purposes
- Calendar integrations: Creation and management of on-call duties
- Punch users in and out based on external calendars
- etc.
AUTHENTICATION
Using the API requires an API key, which you can generate in the SIGNL4 portal under 'Developers'.
This key must then be specified in a special header in every HTTP request.
This header is called X-S4-Api-Key.
The base URL of the API is .
Copyright © Derdack GmbH
- Homepage
- https://api.apis.guru/v2/specs/signl4.com/v1.json
- Provider
- signl4.com
- OpenAPI version
- 3.0.1
- Spec (JSON)
- https://api.apis.guru/v2/specs/signl4.com/v1/openapi.json
- Spec (YAML)
- https://api.apis.guru/v2/specs/signl4.com/v1/openapi.yaml
Tools (103)
Extracted live via the executor SDK.
-
alerts.getAlertsAlertIdGets an alert by id.
-
alerts.getAlertsAlertIdAnnotationsGet annotations of an alert by id.
-
alerts.getAlertsAlertIdAttachmentsGet attachments of an alert by id.
-
alerts.getAlertsAlertIdAttachmentsAttachmentIdGets a specified attachment of a specified alert.
-
alerts.getAlertsAlertIdNotificationsGet notifications of all users by alert id.
-
alerts.getAlertsAlertIdOverviewGet overview alert by id.
-
alerts.getAlertsReportReturns information about the occurred alert volume in different time periods as well as information about the response behaviour (amount of confirmed and unhandled alerts) of your team members.
-
alerts.postAlertsTriggers a new alert for your team. All team members on duty will receive alert notifications.
-
alerts.postAlertsAcknowledgeAllThis method confirms all unhandled alerts your team currently has by a specific user.
-
alerts.postAlertsAcknowledgeMultipleThis method confirms all alerts provided.
-
alerts.postAlertsAlertIdAcknowledgeAcknowledge an alert
-
alerts.postAlertsAlertIdAnnotateAnnotates an alert by given Annotation Info.
-
alerts.postAlertsAlertIdCloseClose an alert
-
alerts.postAlertsAlertIdUndoAcknowledgeThis method tries to undo an alert acknowledgement.
-
alerts.postAlertsAlertIdUndoCloseThis method tries to undo an alert close.
-
alerts.postAlertsCloseAllThis method closes all acknowledged alerts your team currently has.
-
alerts.postAlertsCloseMultipleThis method closes all alerts provided.
-
alerts.postAlertsPagedGets alerts paged
-
alerts.postAlertsUndoAcknowledgeMultipleThis method tries to undo the acknowledgement of multiple alerts via a queue. The operation is handled in the background.
-
alerts.postAlertsUndoCloseMultipleThis method tries to undo multiple alert closes. The operation is handled in the background.
-
categories.deleteCategoriesTeamIdCategoryIdSample Request:
-
categories.getCategoriesImagesGets the names of all alert category images. You can get the image by going to account.signl4.com/images/alerts/categoryImageName.svg
-
categories.getCategoriesTeamIdSample Request:
-
categories.getCategoriesTeamIdCategoryIdSample Request:
-
categories.getCategoriesTeamIdCategoryIdMetricsSample Request:
-
categories.getCategoriesTeamIdCategoryIdSubscriptionsSample Request:
-
categories.getCategoriesTeamIdMetricsSample Request:
-
categories.postCategoriesTeamIdSample Request:
POST /categories/cbb70402-1359-477f-ac92-0171cf2b5ff7{ "name": "Water", "imageName": "water.svg", "color": "#0000cc", "keywordMatching": "Any", "keywords": [ { "value": "H2O" }, { "value": "Water" } ]} -
categories.postCategoriesTeamIdCategoryIdSubscriptionsSample Request:
-
categories.putCategoriesTeamIdCategoryIdSample Request:
PUT /categories/cbb70402-1359-477f-ac92-0171cf2b5ff7/c0054336-cd89-4abf-882d-ba69b5adb25e{ "name": "Water-Updated", "imageName": "water.svg", "color": "#0000cc", "keywordMatching": "All", "keywords": [ { "value": "H2O" }, { "value": "Water" }, { "value": "Wet" } ]} -
duties.deleteTeamsTeamIdSchedulesDutyIdDelete a specific duty.
-
duties.getTeamsTeamIdDutyReportsGet Information about downloadable reports
-
duties.getTeamsTeamIdDutyReportsFileNameDownload duty report with a specific fileName
-
duties.getTeamsTeamIdDutysummaryGet duty assistant info for a team
-
duties.getTeamsTeamIdSchedulesReturns information about all duties that belong to the team.
-
duties.getTeamsTeamIdSchedulesScheduleIdReturns information of the duty schedule with the specified Id.
-
duties.postTeamsTeamIdSchedulesCreate/Update given duty schedule.
-
duties.postTeamsTeamIdSchedulesDeleteRangeDelete duty schedules in range
-
duties.postTeamsTeamIdSchedulesMultipleSave multiple schedules. It is possible to override existing schedules if you wish
-
events.getEventsEventIdOverviewGet overview event by id.
-
events.getEventsEventIdParametersGet parameters of an event by id.
-
events.postEventsPagedGet overview event paged. If there are more results, you also get a continuation token which you can add to the event filter.
-
prepaid.getPrepaidBalanceGet your subscription's current prepaid balance.
-
prepaid.getPrepaidSettingsGet your subscription's current prepaid settings.
-
prepaid.getPrepaidTransactionsGet your subscription's prepaid transactions.
-
prepaid.getSubscriptionsSubscriptionIdPrepaidBalanceGet a subscription's current prepaid balance.
-
prepaid.getSubscriptionsSubscriptionIdPrepaidSettingsGet a subscription's current prepaid settings.
-
prepaid.getSubscriptionsSubscriptionIdPrepaidTransactionsGet a subscription's prepaid transactions.
-
prepaid.putPrepaidSettingsUpdate your subscription's current prepaid settings.
-
prepaid.putSubscriptionsSubscriptionIdPrepaidSettingsUpdate a subscription's current prepaid settings.
-
scripts.deleteScriptsInstancesInstanceIdGets the script instance specified by the passed instance id.
-
scripts.getScriptsInstancesReturns all script instances in the subscription.
-
scripts.getScriptsInstancesInstanceIdGets the script instance specified by the passed instance id.
-
scripts.getScriptsInventoryReturns all available inventory scripts which can be added to a SIGNL4 subscription.
-
scripts.getScriptsInventoryParsedReturns all inventory scripts.
-
scripts.getScriptsInventoryParsedScriptIdGets the script specified by the passed script id.
-
scripts.postScriptsInstancesCreates a new script instance of the script specified in the request body.
-
scripts.postScriptsInstancesInstanceIdDisableDisables a given script instance.
-
scripts.postScriptsInstancesInstanceIdEnableEnables a script instance.
-
scripts.putScriptsInstancesInstanceIdUpdates the specified script instance.
-
scripts.putScriptsInstancesInstanceIdDataUpdates the specified script instance.
-
subscriptions.getSubscriptionsGet infos of all available/managed subscriptions.
-
subscriptions.getSubscriptionsSubscriptionIdGet infos of a specific subscription.
-
subscriptions.getSubscriptionsSubscriptionIdChannelPricesReturns the subscription's channel price information.
-
subscriptions.getSubscriptionsSubscriptionIdFeaturesReturns the features of a specified subscription.
-
subscriptions.getSubscriptionsSubscriptionIdUserLicensesGets a subscription's user licenses.
-
subscriptions.putSubscriptionsSubscriptionIdProfileUpdates a subscriptions profile.
-
teams.getSubscriptionsSubscriptionIdTeamsGet infos for all teams of the subscription.
-
teams.getTeamsGet infos of all teams.
-
teams.getTeamsTeamIdGets infos of a specific team.
-
teams.getTeamsTeamIdAlertReportsGet information about downloadable alert reports
-
teams.getTeamsTeamIdAlertReportsFileNameReturns Alert Report
-
teams.getTeamsTeamIdAlertSettingsGets alert settings of a specific team.
-
teams.getTeamsTeamIdEventSourcesGets event sources of a specific team.
-
teams.getTeamsTeamIdSetupProgressGets setup progress of a specific team.
-
teams.postTeamsTeamIdAlertSettingsSets alert settings of a specific team.
-
teams.putTeamsTeamIdProfileUpdates team profile of a team
-
teamsMemberships.deleteTeamsTeamIdMembershipsUserIdRemoves a user or invitation from a team, and may delete the user if he is not in any team.
-
teamsMemberships.getTeamsTeamIdMembershipsGet all invites of a team.
-
teamsMemberships.postTeamsTeamIdMembershipsInvite users to a team
-
teamsMemberships.postTeamsTeamIdMembershipsResendInviteMailSends invite email again if an invite exists
-
teamsMemberships.putTeamsTeamIdMembershipsUserIdUpdates the user's team membership. You can move the user to another team within the subscription and/or change the user's role.
-
users.getUsersReturns a list of user objects with details such as their email address and duty information. Only users who are part of your team will be returned.
-
users.getUsersUserIdReturns a user object with details such as his email address and duty information.
-
users.getUsersUserIdDutyStatusReturns a object with duty information.
-
users.getUsersUserIdImageGET /users/{userId}/image
-
users.getUsersUserIdSetupProgressGets setup progress of a specific user.
-
users.postUsersUserIdCheckPermissionsChecks if a user has the provided permission.
-
users.postUsersUserIdImageUploaded a profile image for a specified user.
-
users.postUsersUserIdPunchInThe specified user will be punched in to duty.
-
users.postUsersUserIdPunchInAsManagerThe specified user will be punched in to duty as a manager.
-
users.postUsersUserIdPunchOutThe specified user will be punched out from duty.
-
users.putUsersUserIdChangePasswordUpdates the password of a user
-
users.putUsersUserIdProfileUpdates user profile of an user
-
webhooks.deleteWebhooksWebhookIdDeletes the specified webhook so that it will no longer be notified.
-
webhooks.getWebhookByIdReturns information of the webhook specified by the passed id.
-
webhooks.getWebhooksReturns a collection of defined outbound webhooks in the system.
-
webhooks.postWebhooksCreates a new outbound webhook that will be notified when certain events occur.
-
webhooks.postWebhooksWebhookIdDisableAbility to enable a webHook.
-
webhooks.postWebhooksWebhookIdEnableAbility to disable a webHook.
-
webhooks.putWebhooksWebhookIdUpdates the specified webhook.
-
openapi.previewSpecPreview an OpenAPI document before adding it as a source
-
openapi.addSourceAdd an OpenAPI source and register its operations as tools