Public docs

Partner Map

How to upload and manage your partner database — the foundation of alert auto-matching.

Phase 1 shell: this docs surface is wired to the existing backend and repo documentation, and will be expanded as the private dashboard comes online.

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.