Admin
General admin API endpoints for Nullify.
Overview
The Admin API exposes tenant-wide inventory so you can keep internal systems aligned with Nullify’s view of repositories, services, and teams. It also exposes access management, configuration, ticketing, usage, and data-subject operations used by the dashboard and automation.
Base URL
Use the tenant API URL supplied for your workspace, normally https://api.<TENANT>.nullify.ai. Include the appropriate authenticated bearer token; see Authentication. Do not assume every admin operation accepts a service account: identity linking, consent and Entra-only policy changes require an authorized human session and, for policy changes, a recent verified Microsoft sign-in. Use the dashboard's generated consent/link URLs rather than constructing shared-router callback URLs.
Identity and provisioning
Follow Entra setup and recovery, group-driven role mapping and the LIAM/Saviynt contract for complete workflows. SCIM uses the tenant-specific base URL displayed in Settings → Identity and its own SCIM bearer credential, not a service-account token. Azure DevOps consent and organization setup are documented in the Azure DevOps installation guide. The operations that manage these settings are in Identity, Access and Service Accounts.
Common conventions
Most operations are scoped to a provider organization with a query parameter such as
githubOwnerId; each page notes where it is required.Pagination varies by operation: follow its documented cursor or offset; see Pagination.
Requests are scoped to the tenant that issued your token.
Write operations are authorized by role; see Authentication for tokens and service accounts.
Service Accounts
Service accounts issue the tokens that authenticate API automation (see Authentication). List, create and delete them with GET, POST and DELETE /admin/service_accounts; see Identity, Access and Service Accounts.
Data Subject Requests
GET /admin/users/{userId}/export and DELETE /admin/users/{userId}/erasure support data-subject access and erasure requests. Their scope and limits are described in Users and Data Subject Requests.
Guides in this section
Identity, Access and Service Accounts: role assignments, Entra directory binding and sign-in policy, SCIM credentials, IP allowlist, privacy acknowledgment, service accounts.
Users and Data Subject Requests: users, identity mappings, activation, and GDPR export and erasure.
Teams and Ownership: teams, team sync, code ownership, team findings and SLA breakdown.
Repositories, Pull Requests and Code: repository inventory and scan scope, pull request records, file contents and owners, context upload.
Findings, Events and Metrics: cross-product finding queries, the events feed, scan coverage and metrics. AI usage metrics are on AI Usage.
Source Control and CI Integrations: Azure DevOps, GitHub, Buildkite, CircleCI and Jenkins.
Ticketing, Chat and Generic Integrations: Jira, Linear, Asana, Slack, Teams, notifications and the generic connection operations.
Cloud Integrations: AWS, Azure, GCP and Kubernetes settings.
Configuration and Policies: SLAs, PR gate, fix effort, routing exclusions, manager settings, UI preferences.
Ticketing Workbench: ticket listing, bulk operations, saved filters and ticket settings.
AI Usage: usage ledger, aggregate and time series.
Published operation index
This index comes from the published specification. Check its request and response schemas before calling an operation; deployment versions and feature availability can differ.
GET
/admin/access/me
Get Caller Access
GET
/admin/access/preferences
Get RBAC Preferences
PUT
/admin/access/preferences
Set RBAC Preferences
GET
/admin/access/users
List User Roles
PUT
/admin/access/users/roles
Set User Roles
GET
/admin/assessments/scan-coverage
Get Scan Coverage
GET
/admin/assessments/scan-coverage/findings
Get Scan Coverage Findings
GET
/admin/checklist
Get Checklist
GET
/admin/config/routing-exclusions
Get Routing Exclusions
PUT
/admin/config/routing-exclusions
Set Routing Exclusions
GET
/admin/config/security-owner
Get Security Owner
PUT
/admin/config/security-owner
Set Security Owner
POST
/admin/context/ingest
Get Context Upload Credentials
POST
/admin/events
List Unified Events
GET
/admin/finding/{findingId}
Get Finding
POST
/admin/findings
Query Findings
POST
/admin/findings/download
Download Findings
POST
/admin/findings/progress
Post Findings Progress
GET
/admin/fix-effort
Get Fix Effort Mapping
PUT
/admin/fix-effort
Put Fix Effort Mapping
GET
/admin/getFileContents
Get File Contents
POST
/admin/getFileOwners
Get File Owners
GET
/admin/getPullRequest
Get PR State
DELETE
/admin/identity/entra
Disconnect Microsoft Entra directory binding
GET
/admin/identity/entra
Get Microsoft Entra directory binding status
POST
/admin/identity/entra/connect
Start Microsoft Entra connect
POST
/admin/identity/entra/handoff
Delegate Microsoft Entra directory consent
POST
/admin/identity/entra/link
Start Microsoft Entra self-service account link
GET
/admin/identity/entra/policy
Get Microsoft Entra sign-in policy
PUT
/admin/identity/entra/policy
Check or update Microsoft Entra sign-in policy
GET
/admin/identity/scim
Get SCIM Identity Settings
POST
/admin/identity/scim/credentials
Create SCIM Credential
DELETE
/admin/identity/scim/credentials/{id}
Revoke SCIM Credential
GET
/admin/installations
Get App Installations
GET
/admin/integrations/asana/oauth
Get Asana install status
POST
/admin/integrations/asana/ticket-config
Set Asana Ticket Configuration
GET
/admin/integrations/azure
Get Azure Configuration
POST
/admin/integrations/azure
Install Azure DevOps Integration
POST
/admin/integrations/azure/codeowners/preview
Preview CODEOWNERS as Azure DevOps required-reviewer policies
POST
/admin/integrations/azure/credentials
Set Azure Credentials
DELETE
/admin/integrations/azure/installations
Delete Azure DevOps webhook installation
GET
/admin/integrations/azure/installations
List Azure DevOps webhook installations
POST
/admin/integrations/azure/installations
Register Azure DevOps webhook installation
POST
/admin/integrations/azure/installations/suspend
Suspend or resume an Azure DevOps organization's installations
POST
/admin/integrations/azure/installations/test
Test an Azure DevOps organization's provisioning state
DELETE
/admin/integrations/buildkite
Delete Buildkite Integration
GET
/admin/integrations/buildkite
Get Buildkite Integration Status
POST
/admin/integrations/buildkite/organizations
List Buildkite Organizations For Token
POST
/admin/integrations/buildkite/token
Set Buildkite API Token
GET
/admin/integrations/catalog
Get Integrations Catalog
DELETE
/admin/integrations/circleci
Delete CircleCI Integration
GET
/admin/integrations/circleci
Get CircleCI Integration Status
POST
/admin/integrations/circleci/token
Set CircleCI API Token
DELETE
/admin/integrations/cloud/aws/settings
Delete Cloud AWS Settings
GET
/admin/integrations/cloud/aws/settings
Get Cloud AWS Settings
POST
/admin/integrations/cloud/aws/settings
Upsert Cloud AWS Settings
POST
/admin/integrations/cloud/aws/validate-role
Validate AWS Role
DELETE
/admin/integrations/cloud/azure/settings
Delete Cloud Azure Settings
GET
/admin/integrations/cloud/azure/settings
Get Cloud Azure Settings
POST
/admin/integrations/cloud/azure/settings
Upsert Cloud Azure Settings
POST
/admin/integrations/cloud/azure/validate
Validate Azure Credentials
POST
/admin/integrations/cloud/gcp/access-token
Mint GCP Access Token
DELETE
/admin/integrations/cloud/gcp/settings
Delete Cloud GCP Settings
GET
/admin/integrations/cloud/gcp/settings
Get Cloud GCP Settings
POST
/admin/integrations/cloud/gcp/settings
Upsert Cloud GCP Settings
POST
/admin/integrations/cloud/gcp/validate
Validate GCP Credentials
POST
/admin/integrations/cloud/k8s/clusters
Add or Update a K8s Cluster
DELETE
/admin/integrations/cloud/k8s/clusters/{clusterId}
Remove a K8s Cluster
DELETE
/admin/integrations/cloud/k8s/settings
Delete Cloud K8s Settings
GET
/admin/integrations/cloud/k8s/settings
Get Cloud K8s Settings
POST
/admin/integrations/cloud/k8s/settings
Upsert Cloud K8s Settings
POST
/admin/integrations/cloud/k8s/whitelist
Whitelist K8s Connector Accounts
GET
/admin/integrations/connections
List Integration Connections
DELETE
/admin/integrations/connections/{connectionId}
Disconnect Integration Connection
PUT
/admin/integrations/connections/{connectionId}/rotate
Rotate Integration Connection
POST
/admin/integrations/connections/{connectionId}/test
Test Integration Connection
POST
/admin/integrations/github-packages/discover
Discover GitHub Packages Identity
GET
/admin/integrations/github/app-settings
Get GitHub App Settings
DELETE
/admin/integrations/jenkins
Delete Jenkins Integration
GET
/admin/integrations/jenkins
Get Jenkins Integration Status
POST
/admin/integrations/jenkins/token
Set Jenkins API Token
GET
/admin/integrations/jira
Get Jira Configuration
POST
/admin/integrations/jira
Update Jira Configuration
GET
/admin/integrations/jira/forge
Get Jira Forge connection status
GET
/admin/integrations/jira/install
Start Jira Forge OAuth connect
GET
/admin/integrations/linear
Get Linear Configuration
GET
/admin/integrations/linear/install
Start Linear OAuth install
GET
/admin/integrations/linear/members
List Linear Team Members
GET
/admin/integrations/linear/oauth
Get Linear OAuth install status
GET
/admin/integrations/linear/teams
List Linear Teams
POST
/admin/integrations/linear/ticket-config
Set Linear Ticket Configuration
GET
/admin/integrations/notifications
Get Notification Config
PUT
/admin/integrations/notifications
Put Notification Config
GET
/admin/integrations/slack
Get Slack Configuration
GET
/admin/integrations/slack/install
Start Slack distributed install
POST
/admin/integrations/slack/key
Set Slack API Key
GET
/admin/integrations/teams
Get Integration Teams
GET
/admin/integrations/users
Get Integration Users
PUT
/admin/integrations/{providerId}/{capability}/configure
Configure Integration
POST
/admin/integrations/{providerId}/{capability}/connect
Connect Integration
POST
/admin/integrations/{providerId}/{capability}/connections
Create Integration Connection
DELETE
/admin/integrations/{providerId}/{capability}/disconnect
Disconnect Integration
GET
/admin/integrations/{providerId}/{capability}/install
Start Integration OAuth install
POST
/admin/integrations/{providerId}/{capability}/test
Test Integration
GET
/admin/manager/settings
Get Manager Settings
PUT
/admin/manager/settings
Update Manager Settings
POST
/admin/metrics/findings
Post Findings Metrics
POST
/admin/metrics/findings/by-repository
Post Findings Metrics By Repository
POST
/admin/metrics/findings/frameworks
Post Findings Compliance Frameworks
GET
/admin/metrics/interactions
Get Interactions
POST
/admin/metrics/over-time
Get Metrics Over Time
POST
/admin/metrics/overview
Query Overview
POST
/admin/metrics/pullrequests
Post Pull Request Metrics
POST
/admin/metrics/raw
Query Raw Metrics
POST
/admin/metrics/tickets
Post Ticket Metrics
GET
/admin/metrics/usage/aggregate
Usage Aggregate
GET
/admin/metrics/usage/ledger
Usage Ledger
GET
/admin/metrics/usage/timeseries
Usage Timeseries
GET
/admin/network/ip-allowlist
Get IP Allowlist
PUT
/admin/network/ip-allowlist
Replace IP Allowlist
POST
/admin/network/ip-allowlist/preview
Preview IP Allowlist
GET
/admin/operator/package-feeds
Read Staff Package Feeds
POST
/admin/operator/package-feeds
Control Staff Package Feed
GET
/admin/organization
Get Organization
GET
/admin/pr-gate-settings
Get PR Gate Settings
PUT
/admin/pr-gate-settings
Put PR Gate Settings
GET
/admin/privacy/acknowledgment
Get Privacy Acknowledgment
POST
/admin/privacy/acknowledgment
Post Privacy Acknowledgment
GET
/admin/pullrequests
Get Pull Request Record
POST
/admin/pullrequests
Query Pull Requests
POST
/admin/pullrequests/refresh-ci
Refresh Pull Request CI
GET
/admin/repositories
Get Repositories
PUT
/admin/repositories/enrollment
Update Repository Enrollment
POST
/admin/repositories/enrollment/enroll-all
Enroll All Repositories
GET
/admin/repositories/enrollment/limit
Get Repository Enrollment Limit
PUT
/admin/repositories/enrollment/limit
Set Repository Enrollment Limit
GET
/admin/repositories/enrollment/scoping
Get Repository Enrollment Scoping
PUT
/admin/repositories/enrollment/scoping
Set Repository Enrollment Scoping
POST
/admin/repositories/initialize
Initialize Repositories
GET
/admin/repositories/recommendations
Get Repository PoV Recommendations
POST
/admin/repositories/uninitialize
Uninitialize Repositories
DELETE
/admin/repository-property-team-keys
Delete Repository Property Team Key
GET
/admin/repository-property-team-keys
List Repository Property Team Keys
POST
/admin/repository-property-team-keys
Create Repository Property Team Key
GET
/admin/scans/orchestrator
List Orchestrator Scans
DELETE
/admin/service_accounts
Delete Service Account
GET
/admin/service_accounts
Get Service Accounts
POST
/admin/service_accounts
Create Service Account
GET
/admin/settings/cspm-scan-cadence
Get CSPM Scan Cadence
PUT
/admin/settings/cspm-scan-cadence
Set CSPM Scan Cadence
GET
/admin/sla
Get SLAs
POST
/admin/sla
Post SLA
PUT
/admin/sla/bulk
Put Bulk SLA
PATCH
/admin/sla/{slaId}
Patch SLA
GET
/admin/team-source-preferences
Get Team Source Preferences
PUT
/admin/team-source-preferences
Update Team Source Preferences
GET
/admin/team-sync-runs
List Team Sync Runs
POST
/admin/team-sync-runs
Trigger Team Sync
GET
/admin/team/{teamID}
Get Team
GET
/admin/teams
Get All Teams
POST
/admin/teams
Post Team
GET
/admin/teams/appzip
Get Teams App Zip
POST
/admin/teams/compass
Post Compass/Atlassian Team
GET
/admin/teams/findings
Get All Team Findings mapping
POST
/admin/teams/findings
Manual Team Findings Assignment
POST
/admin/teams/findings/sync
Sync Team Findings
POST
/admin/teams/merge
Merge Teams
POST
/admin/teams/sla-breakdown
Get Team SLA Breakdown
DELETE
/admin/teams/{teamID}
Delete Manual Team
PATCH
/admin/teams/{teamID}
Patch Team
POST
/admin/teams/{teamID}/code-ownership
Make Team The Owner Of A Repository
POST
/admin/teams/{teamID}/events
List Team Unified Events
GET
/admin/teams/{teamID}/findings
Get Team Findings mapping
GET
/admin/ticketing/activity
List Ticketing Activity
GET
/admin/ticketing/bulk-operations/{operationId}
Get Bulk Operation Status
POST
/admin/ticketing/bulk-operations/{operationId}/cancel
Request Bulk Operation Cancellation
GET
/admin/ticketing/saved-filters
List Saved Ticket Filters
POST
/admin/ticketing/saved-filters
Create Saved Ticket Filter
DELETE
/admin/ticketing/saved-filters/{id}
Delete Saved Ticket Filter
PATCH
/admin/ticketing/saved-filters/{id}
Update Saved Ticket Filter
POST
/admin/ticketing/settings/{findingType}
Save Ticket Settings
GET
/admin/ticketing/settings/{findingType}/history
List Ticket Settings History
POST
/admin/ticketing/settings/{findingType}/preview
Preview Ticket Settings Impact
GET
/admin/ticketing/tickets
List Tickets (Power-User Workbench)
POST
/admin/ticketing/tickets/bulk-add-comment
Bulk Add Comment To Tickets
POST
/admin/ticketing/tickets/bulk-close
Bulk Close Tickets
POST
/admin/ticketing/tickets/bulk-move
Bulk Move Tickets
POST
/admin/ticketing/tickets/bulk-reassign-assignee
Bulk Reassign Ticket Assignee
POST
/admin/ticketing/tickets/bulk-reassign-team
Bulk Reassign Tickets to Team
POST
/admin/ticketing/tickets/bulk-relabel
Bulk Relabel Tickets
POST
/admin/ticketing/tickets/bulk-reopen
Bulk Reopen Tickets
POST
/admin/ticketing/tickets/bulk-resync
Bulk Re-Sync Tickets
POST
/admin/ticketing/tickets/bulk-set-priority
Bulk Set Ticket Priority
GET
/admin/ticketing/tickets/counts
Get Ticket Facet Counts
GET
/admin/ticketing/tickets/{ticketId}
Get Ticket Drill-Down
POST
/admin/triage/context-census
Post Triage Context Census
DELETE
/admin/ui/preferences
Delete UI Preferences
GET
/admin/ui/preferences
Get UI Preferences
PUT
/admin/ui/preferences
Put UI Preferences
GET
/admin/ui/savedViews
Get UI Saved Views
POST
/admin/ui/savedViews
Post UI Saved View
DELETE
/admin/ui/savedViews/{savedViewId}
Delete UI Saved View
PATCH
/admin/ui/savedViews/{savedViewId}
Patch UI Saved View
GET
/admin/user/current
Get Current User
GET
/admin/user/mapping
Get User Mapping
POST
/admin/user/mapping
Post Add User Mappings
GET
/admin/user/mapping/suggestions
Get User Mapping Suggestions
DELETE
/admin/user/mapping/{userId}
Delete User Mapping
PUT
/admin/user/mapping/{userId}
Edit User Mapping
GET
/admin/user/mappings
Get User Mappings
GET
/admin/user/{userID}
Get User
GET
/admin/users
Get All Users
POST
/admin/users
Post User
POST
/admin/users/activate
Activate Users
POST
/admin/users/bulkSearchMappings
Post Bulk Get User Mappings
POST
/admin/users/deactivate
Deactivate User
GET
/admin/users/identity/{providerID}/{providerUserID}
Get User By Git Identity
POST
/admin/users/reactivate
Reactivate User
GET
/admin/users/{providerID}
Get Provider Users
GET
/admin/users/{providerID}/{userID}
Get User By Provider
DELETE
/admin/users/{userId}/erasure
Delete User Erasure (GDPR Art. 17)
GET
/admin/users/{userId}/export
Get User Data Export (GDPR Art. 15, 20)
Last updated