incident.io
Connect
Connect incident.io from the terminal. Pass --help for the flags incident.io accepts.
praxen integration connect --type incident_ioAn API key from Settings → API keys in incident.io.
Connect your incident.io organization with one API key.
- In incident.io API keys, create an API key with the roles listed under Learn more.
- Paste the key into Praxen Inc. Praxen Inc. checks it and shows what the key turns on, and names the role a feature needs when that role is missing.
Every new live incident in incident.io starts a Praxen Inc. investigation. When Slack is connected to Praxen Inc., the findings post in the incident's Slack channel. Private and test incidents are skipped.
Escalations that Praxen Inc. cannot resolve reach incident.io as alerts when their severity is at or above the level set on the integration page, high by default. An alert pages no one until you add the Praxen Inc. alert source to an alert route in incident.io.
Read incident.io data and request API changes through Praxen Inc. Changes require safety review and approval.
Praxen Inc. maps your incident.io catalog services into the context graph and links them to their repositories.
On connect, Praxen Inc. creates a workflow named "Praxen Inc.: investigate incidents (your workspace name)", a workflow secret, and an HTTP alert source named "Praxen Inc." in incident.io. Disconnecting deletes all three.
Praxen Inc. uses these incident.io roles. A feature whose role is missing stays off, and the integration page names the role.
| Role | What it unlocks |
|---|---|
viewer | Reads incidents, updates, follow-ups, and the catalog, and maps catalog services into the context graph. Required. |
schedules_reader | Reads on-call schedules to tell who is on call. |
workflows_editor, secrets_manage | Creates the workflow that starts an investigation for each new incident. |
on_call_editor | Creates the Praxen Inc. alert source that receives unresolved escalations. |
incident_editor, incident_creator | Creates and edits incidents and posts updates, after safety review and approval. |
escalation_creator | Pages an escalation path, after safety review and approval. |
Disconnecting leaves the API key in incident.io. Remove it under Settings → API keys in incident.io.
Disconnect
Disconnecting stops every sync and check and deletes the credentials Praxen Inc. held. Praxen Inc. removes what incident.io's API lets it remove. The following stays until you remove it yourself:
- incident.io API key
praxen integration disconnect <id>Tools
4Operations agents can perform in threads.