Public docs
Partner Map
How to upload and manage your partner database — the foundation of alert auto-matching.
What the partner map is
The partner map is your master list of all partners — their names, the API scopes they use, what product area they're in, and their current lifecycle status. It's the foundation that makes opSentry's alert matching work: when an alert identifies impacted scopes, opSentry cross-references those scopes against your partner map to surface the affected partners automatically.
---
Uploading your partner map
You can upload your partner list in two formats from Partners → Partner Map:
CSV upload
Upload a CSV file with a header row. Column names are flexible — opSentry auto-detects common variations:
- Partner name:
partner_name,name,customer,account,company,client,org - Scopes:
scopes,scope,permissions,oauth_scopes,api_scopes - Area:
area,product_area,domain,service,team - Status:
status,state,health,condition
JSON upload
Upload a JSON array of objects. Same aliasing rules apply.
Uploading a new file replaces the existing dataset. If you need to preserve existing data, export first.
---
Partner statuses
Each partner has a lifecycle status. The default statuses are:
- Active — partner is live and integrated
- Onboarding — partner is in the integration process
- At Risk — partner has open issues or elevated support activity
- Triaging — partner is being actively investigated for a problem
- Inactive — partner is no longer active; excluded from alert auto-matching
You can add, remove, and rename statuses in Settings → Partner Map → Partner statuses. Partners marked Inactive will not appear in alert match results.
---
Adding and editing rows
You can add individual partner rows manually without re-uploading the whole file. Use the Add row button in the Partner Map table. All columns from your current dataset are available for input.
Edit existing rows by switching to Edit mode — all cells become editable inline. Save changes with the Save button.
---
Columns and display order
Your partner map columns are determined by your uploaded file. The order in which columns appear is preserved from the original upload. You can't rename columns directly — if you need different column names, re-upload with a new file.
---
Partner health on the board
Partners in the Partner Onboarding pipeline show a health badge based on their highest active alert severity. This badge is derived live from the alert system — it updates automatically as alerts are created and resolved. You don't need to manually update a health field.