Endpoints for managing rules within a playbook.
List playbook rules
Returns all rules for the given playbook, scoped to the current organization.
path Parameters
playbook_idstring · uuid · requiredParent playbook id
Headers
Authorizationstring · requiredThe
Authorizationheader is used to authenticate with the API using your API key. Value is of the formatBearer YOUR_KEY_HERE.
Responses
A list of playbook rules
dataobject[] · required
Create a playbook rule
Creates a new rule under the given playbook. name and actions are required; description is optional.
path Parameters
playbook_idstring · uuid · requiredParent playbook id
Headers
Authorizationstring · requiredThe
Authorizationheader is used to authenticate with the API using your API key. Value is of the formatBearer YOUR_KEY_HERE.
Request Body
namestring · requiredName for the rule.
actionsstring · requiredActions to take when this rule is triggered.
descriptionstringOptional description for the rule.
Responses
Playbook rule created; returns the new rule resource
dataobject · required
Retrieve a playbook rule
Returns one rule by id under the given playbook, scoped to the current organization.
path Parameters
playbook_idstring · uuid · requiredParent playbook id
rule_idstring · uuid · requiredPlaybook rule id
Headers
Authorizationstring · requiredThe
Authorizationheader is used to authenticate with the API using your API key. Value is of the formatBearer YOUR_KEY_HERE.
Responses
A single playbook rule
dataobject · required
Delete a playbook rule
Permanently deletes one rule by id under the given playbook.
path Parameters
playbook_idstring · uuid · requiredParent playbook id
rule_idstring · uuid · requiredPlaybook rule id
Headers
Authorizationstring · requiredThe
Authorizationheader is used to authenticate with the API using your API key. Value is of the formatBearer YOUR_KEY_HERE.
Responses
Playbook rule deleted; no content returned
Update a playbook rule
Updates one or more fields on a single playbook rule. Send only the fields you want to change.
path Parameters
playbook_idstring · uuid · requiredParent playbook id
rule_idstring · uuid · requiredPlaybook rule id
Headers
Authorizationstring · requiredThe
Authorizationheader is used to authenticate with the API using your API key. Value is of the formatBearer YOUR_KEY_HERE.
Request Body
namestringUpdated name for the rule.
descriptionstringUpdated description for the rule.
actionsstringUpdated actions for the rule.
Responses
Updated playbook rule
dataobject · required