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. Responses mirror what security leaders see in the console and are optimised for asynchronous sync jobs rather than interactive queries.

Base URL

All endpoints share the base URL https://api.<TENANT>.nullify.ai. Replace <TENANT> with your tenant slug (for example https://api.acme.nullify.ai). Include a service-account token in every request; see Authentication.

Get Repositories

Get Repositories

get

Get a list of repositories in the org

Query parameters

nextTokenstring · nullableOptional

limitinteger · nullableOptional

azureOrganizationIdstringOptional

The Azure organization ID

bitbucketWorkspaceIdstringOptional

The Bitbucket workspace ID

githubOwnerIdinteger · int64Optional

The Github owner ID

gitlabGroupIdinteger · int64Optional

The GitLab group ID

installationIdstringOptional

The Nullify installation ID

azureRepositoryIdstring[]Optional

githubRepositoryIdinteger · int64[]Optional

githubTeamIdinteger · int64Optional

bitbucketRepositoryIdstring[]Optional

Responses

200

OK

application/json

nextTokenstringRequired

numItemsintegerRequired

versionstringRequired

401

Unauthorized

application/json

500

Internal Server Error

application/json

get

/admin/repositories

HTTPcURLJavaScriptPython

GET /admin/repositories HTTP/1.1
Accept: */*

{
  "nextToken": "text",
  "numItems": 1,
  "repositories": {
    "ANY_ADDITIONAL_PROPERTY": {
      "countsBySeverity": {
        "ANY_ADDITIONAL_PROPERTY": 1
      },
      "countsByType": {
        "ANY_ADDITIONAL_PROPERTY": 1
      },
      "id": "text",
      "isDefaultBranch": true,
      "nullifyConfigFile": {},
      "nullifyRepoConfigFile": {},
      "owner": "text",
      "ownerType": "text",
      "pii": {
        "collections": [
          {
            "collectionId": "text",
            "collections": [
              {
                "occurrences": [
                  {
                    "columnNumber": 1,
                    "excerpt": "text",
                    "fileName": "text",
                    "lineNumber": 1,
                    "sample": "text"
                  }
                ],
                "sourceId": "text"
              }
            ],
            "isSensitive": true,
            "name": "text"
          }
        ],
        "language": "text",
        "probableSinks": [
          "text"
        ],
        "processing": [
          {
            "occurrences": [
              {
                "columnNumber": 1,
                "excerpt": "text",
                "fileName": "text",
                "lineNumber": 1,
                "sample": "text"
              }
            ],
            "sourceId": "text"
          }
        ],
        "sinkProcessing": [
          {
            "occurrences": [
              {
                "columnNumber": 1,
                "excerpt": "text",
                "fileName": "text",
                "lineNumber": 1,
                "sample": "text"
              }
            ],
            "sinkId": "text"
          }
        ],
        "sources": [
          {
            "category": "text",
            "id": "text",
            "isSensitive": true,
            "name": "text",
            "sensitivity": "LOW",
            "sourceType": "text",
            "tags": {
              "ANY_ADDITIONAL_PROPERTY": "text"
            }
          }
        ]
      },
      "platform": "text",
      "repository": "text",
      "repositoryId": "text",
      "sbom": "text",
      "tenantId": "text",
      "timestamp": "text",
      "timestampUnix": 1
    }
  },
  "version": "text"
}

curl -L \
   -H "Accept: application/json" \
   -H "Authorization: Bearer <TOKEN>" \
   https://api.<TENANT>.nullify.ai/admin/repositories?githubOwnerId=1234

Get Teams

Returns team definitions harvested from GitHub or Bitbucket. GitHub tenants also include CODEOWNERS membership so you can align ownership data across tools.

Get All Teams

get

Get a list of teams, global across all platforms, with user and repository details populated.

Query parameters

azureOrganizationIdstringOptional

The Azure organization ID

bitbucketWorkspaceIdstringOptional

The Bitbucket workspace ID

githubOwnerIdinteger · int64Optional

The Github owner ID

gitlabGroupIdinteger · int64Optional

The GitLab group ID

installationIdstringOptional

The Nullify installation ID

azureRepositoryIdstring[]Optional

githubRepositoryIdinteger · int64[]Optional

githubTeamIdinteger · int64Optional

bitbucketRepositoryIdstring[]Optional

Responses

200

OK

application/json

401

Unauthorized

application/json

500

Internal Server Error

application/json

get

/admin/teams

HTTPcURLJavaScriptPython

GET /admin/teams HTTP/1.1
Accept: */*

{
  "teams": [
    {
      "codeOwnerships": [
        {
          "globPatterns": [
            "text"
          ],
          "repository": {
            "azure": {
              "projectId": "text",
              "projectName": "text",
              "repositoryId": "text",
              "repositoryName": "text"
            },
            "bitbucket": {
              "projectKey": "text",
              "projectName": "text",
              "repositoryId": "text",
              "repositoryName": "text"
            },
            "github": {
              "hasIssue": true,
              "nodeId": "text",
              "owner": "text",
              "ownerId": 1,
              "repositoryId": 1,
              "repositoryName": "text"
            },
            "gitlab": {
              "projectId": 1,
              "projectName": "text"
            },
            "id": "Nullify"
          }
        }
      ],
      "id": "text",
      "lead": {
        "email": "text",
        "id": "text",
        "isBot": true,
        "name": "text",
        "provider": {
          "azure": {
            "id": "text"
          },
          "bitBucket": {
            "id": "text"
          },
          "gitHub": {
            "id": 1,
            "nodeId": "text"
          },
          "gitlab": {
            "id": 1
          },
          "id": "Nullify",
          "jira": {
            "id": "text"
          },
          "linear": {
            "id": "text"
          },
          "okta": {
            "id": "text"
          },
          "slack": {
            "id": "text"
          },
          "teams": {
            "id": "text",
            "teamIDs": [
              "text"
            ]
          }
        },
        "slug": "text",
        "username": "text"
      },
      "leadId": "text",
      "memberIds": [
        "text"
      ],
      "members": [
        {
          "email": "text",
          "id": "text",
          "isBot": true,
          "name": "text",
          "provider": {
            "azure": {
              "id": "text"
            },
            "bitBucket": {
              "id": "text"
            },
            "gitHub": {
              "id": 1,
              "nodeId": "text"
            },
            "gitlab": {
              "id": 1
            },
            "id": "Nullify",
            "jira": {
              "id": "text"
            },
            "linear": {
              "id": "text"
            },
            "okta": {
              "id": "text"
            },
            "slack": {
              "id": "text"
            },
            "teams": {
              "id": "text",
              "teamIDs": [
                "text"
              ]
            }
          },
          "slug": "text",
          "username": "text"
        }
      ],
      "name": "text",
      "numMembers": 1,
      "privacy": "text",
      "provider": "Nullify",
      "repositoryIds": [
        "text"
      ],
      "slug": "text"
    }
  ]
}

curl -L \
   -H "Accept: application/json" \
   -H "Authorization: Bearer <TOKEN>" \
   https://api.<TENANT>.nullify.ai/admin/teams?githubOwnerId=1234