Core API resources

Product usage: prefer Using the dashboard and Quickstart. This page is a route reference for engineers calling /api/* directly.

Workflow-oriented reference for Intello’s /api/* surface. Replace $API_URL, $TOKEN, UUIDs, and ids with your own. All examples assume Authorization: Bearer $TOKEN.

Monitored dependencies

Method	Path	Notes
GET	/api/dependencies	List org dependencies.
POST	/api/dependencies	Create (see Add a dependency).
GET	/api/dependencies/:id	Fetch one; 404 if not in org.
PUT	/api/dependencies/:id	Update mutable fields.
DELETE	/api/dependencies/:id	Delete dependency and cascaded data.
POST	/api/dependencies/:id/sync	Manual sync → 202 Accepted with job_id; 409 if already running.
POST	/api/dependencies/:id/enable	Resume scheduling.
POST	/api/dependencies/:id/disable	Pause automatic scheduling.
GET	/api/dependencies/:id/specs	List attached spec slices (when enabled).
PUT	/api/dependencies/:id/specs/:specId	Toggle subscription to a slice.

Create (minimal BYO example):

curl -sS -X POST "$API_URL/api/dependencies" \
  -H "Authorization: Bearer $TOKEN" -H "Content-Type: application/json" \
  -d '{
    "name": "Payments",
    "spec_source": "url",
    "spec_url": "https://api.vendor.com/openapi.json",
    "base_url": "https://api.vendor.com",
    "sync_frequency_hrs": 24
  }'

Snapshots

Method	Path	Notes
GET	/api/dependencies/:id/snapshots	Historical snapshots newest-first.
GET	/api/dependencies/:id/snapshots/:snapId	Metadata + summary fields.
GET	/api/dependencies/:id/snapshots/:snapId/operations	Resolved HTTP operations (may be large).
GET	/api/dependencies/:id/snapshots/:snapId/raw	Normalized document body (large JSON).

Change events

Method	Path	Notes
GET	/api/changes	Org-wide list; limit, page, status filters.
GET	/api/changes/:changeId	Org-scoped fetch.
GET	/api/dependencies/:id/changes	Grouped list for triage.
GET	/api/dependencies/:id/changes/:changeId	Single event for dependency.
POST	/api/dependencies/:id/changes/:changeId/ack	Body: { "acknowledged_by": "name@company.com" }.
POST	/api/change-groups/:causeKey/ack	Group acknowledgement.

Sync jobs

Method	Path	Notes
GET	/api/dependencies/:id/sync-jobs	Recent jobs for dependency.
GET	/api/sync-jobs/:id	Job detail (stage, status, last_error, …).
POST	/api/sync-jobs/:id/retry	Re-queue failed job.
POST	/api/sync-jobs/:id/cancel	Cancel in-flight job when permitted.

Domain mappings

Method	Path
GET	/api/dependencies/:id/domains
POST	/api/dependencies/:id/domains
PUT	/api/dependencies/:id/domains/:domainId
DELETE	/api/dependencies/:id/domains/:domainId
POST	/api/dependencies/:id/domains/refresh

Alert preferences (BYO)

Method	Path
GET	/api/dependencies/:id/alert-preferences
POST	/api/dependencies/:id/alert-preferences
PUT	/api/dependencies/:id/alert-preferences/:prefId
DELETE	/api/dependencies/:id/alert-preferences/:prefId

Create example:

{
  "scope": "api",
  "min_severity": "breaking",
  "notify_on_breaking": true,
  "channels": ["slack", "pagerduty"]
}

Provider catalog & subscriptions

Method	Path	Notes
GET	/api/providers	Authenticated catalog.
POST	/api/providers	Admin/catalog write (permissions vary).
GET	/api/providers/:id	Provider detail.
PUT	/api/providers/:id	Update provider metadata.
DELETE	/api/providers/:id	Delete provider (rare).
GET	/api/provider-subscriptions	List org subscriptions.
POST	/api/provider-subscriptions	Body: { "provider_id": "<uuid>" }.
GET	/api/provider-subscriptions/:id	Subscription detail.
DELETE	/api/provider-subscriptions/:id	Unsubscribe.
GET	/api/provider-subscriptions/:id/specs	Spec slices + mute flags.
PUT	/api/provider-subscriptions/:id/specs/:specId	Body: `{ "is_muted": true

Provider alert preferences

Method	Path
GET	/api/provider-subscriptions/:id/alert-preferences
POST	/api/provider-subscriptions/:id/alert-preferences
PUT	/api/provider-subscriptions/:id/alert-preferences/:prefId
DELETE	/api/provider-subscriptions/:id/alert-preferences/:prefId

Provider change events

Method	Path
GET	/api/provider-changes
GET	/api/provider-changes/:id
POST	/api/provider-changes/:id/ack

Chat & incident integrations

Method	Path	Notes
GET	/api/integrations	List connected integrations (shape varies).
POST	/api/integrations/slack/oauth/start	Begin OAuth (typically UI-driven).
POST	/api/integrations/slack/oauth/complete	Finish OAuth.
POST	/api/integrations/teams/oauth/start	Begin Teams OAuth.
POST	/api/integrations/teams/oauth/complete	Finish Teams OAuth.
GET	/api/integrations/teams/joined-teams	Teams picker data.
GET	/api/integrations/teams/teams/:teamId/channels	Channel listing.
PUT	/api/integrations/teams/destination	Persist channel routing.
PUT	/api/integrations/pagerduty	Save routing/integration configuration.
DELETE	/api/integrations/:provider	Disconnect provider key.

Notifications (in-app)

Method	Path
GET	/api/notifications
GET	/api/notifications/unread-count
PUT/POST	/api/notifications/:id/read
PUT/POST	/api/notifications/read-all
GET	/api/notifications/preferences
PUT	/api/notifications/preferences

Organization & members

Method	Path	Notes
PUT	/api/organizations	Update org profile (admin).
GET	/api/organizations/members	List members.
POST	/api/organizations/members	Invite user (admin).
PUT	/api/organizations/members/:id	Change role (admin).
DELETE	/api/organizations/members/:id	Remove member (admin).
GET	/api/organizations/invitations	Pending invites (admin).
POST	/api/organizations/invitations	Create invite (admin).
DELETE	/api/organizations/invitations/:id	Cancel invite (admin).
POST	/api/organizations/invitations/:id/resend	Resend (admin).

User profile

Method	Path
PUT	/api/users/me

Dashboard & incidents

Method	Path
GET	/api/dashboard/stats
GET	/api/incidents
GET	/api/incidents/:id

Onboarding

Method	Path
GET	/api/onboarding/state
POST	/api/onboarding/complete-step
POST	/api/onboarding/dismiss

Billing

Method	Path
GET	/api/billing/subscription
GET	/api/billing/usage
GET	/api/billing/plans
POST	/api/billing/checkout
POST	/api/billing/portal

Related topics

• API overview
• Authentication
• Alert preferences