Create incidents, configure workflows, and trigger automations via the Rootly REST API

Steps

1. Authenticate with Authorization: Bearer YOUR_TOKEN; Rootly's API follows the JSON:API specification, so request and response bodies use the data.type and data.attributes structure
2. Fetch reference IDs: GET /v1/severities, GET /v1/teams, and GET /v1/environments to collect IDs needed for incident creation
3. Create an incident: POST /v1/incidents with data.attributes containing title, severity_id, team_id, and environment_id; the API returns the incident ID and a Slack channel link if Slack is integrated
4. Update incident fields mid-incident: PATCH /v1/incidents/{id} with updated attributes such as status (mitigated, resolved) or a summary string
5. Trigger a workflow automation: Rootly workflows fire based on incident lifecycle events (declared, mitigated, resolved); configure triggers in the Rootly UI and use the API to advance incident state to trigger them
6. Create a postmortem: POST /v1/post_mortems with incident_id; Rootly auto-populates the postmortem template with the incident timeline and signals Jira or Confluence integrations to create linked documents