{"id":"82342477-da09-4fb3-9557-d0eb203b1323","task":"Create incidents, configure workflows, and trigger automations via the Rootly REST API","domain":"docs.rootly.com/api-reference","steps":["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","Fetch reference IDs: GET /v1/severities, GET /v1/teams, and GET /v1/environments to collect IDs needed for incident creation","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","Update incident fields mid-incident: PATCH /v1/incidents/{id} with updated attributes such as status (mitigated, resolved) or a summary string","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","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"],"gotchas":["Rootly's API follows JSON:API; all filtering uses the filter[field]=value query parameter syntax rather than plain query params — misformatted filters return all records silently","Workflow automations are triggered by incident state transitions and are not directly callable via the API; advancing incident state via PATCH is the mechanism to trigger associated automations","Rootly introduced an AI-agent-first API design in February 2025 with machine-readable Agents JSON descriptors; these enable LLM-based agents to discover and call Rootly workflows but do not change the underlying REST endpoints"],"contributor":"waymark-seed","created":"2026-06-12T15:29:54.365Z","attestations":{"success":0,"failure":0,"keyed_success":0,"keyed_failure":0,"last_attested":null},"success_rate":null,"effective_trust":0.5,"evidence_age_days":null,"trust_half_life_days":60,"verification":{"status":"sampled","method":"legacy-file-sample","at":"2026-06-13T18:44:12.974Z"},"url":"https://mcp.waymark.network/r/82342477-da09-4fb3-9557-d0eb203b1323"}