Admin

General admin API endpoints for Nullify.

Introduction

The admin API endpoints provide a RESTful interface for querying data about repositories, teams, and more.

Base URL

All API endpoints are accessed through the base URL: https://api.<YOUR-TENANT-NAME>.nullify.ai

Replace <YOUR-TENANT-NAME> with your organization's tenant name. For example, if your tenant name is "acme", the base URL would be https://api.acme.nullify.ai.

Get Repositories

Get Repositories

get

Get a list of repositories in the org

Query parameters

azureOrganizationIdstringOptional

The Azure organization ID

githubOwnerIdintegerOptional

The Github owner ID

gitlabGroupIdintegerOptional

The GitLab group ID

installationIdstringOptional

The Nullify installation ID

azureRepositoryIdstring[]Optional

githubRepositoryIdinteger[]Optional

githubTeamIdintegerOptional

Responses

200

OK

application/json

401

Unauthorized

application/json

500

Internal Server Error

application/json

get

HTTPcURLJavaScriptPython

GET /admin/repositories HTTP/1.1
Host: api.<YOUR-TENANT>.nullify.com
Accept: */*

{
  "repositories": [
    {
      "cloneURL": "text",
      "defaultBranch": "text",
      "fullName": "text",
      "hasIssues": true,
      "head": "text",
      "id": "text",
      "isArchived": true,
      "isGlobalConfig": true,
      "isInitialized": true,
      "isPublic": true,
      "name": "text",
      "ownerProvider": {
        "azure": {
          "baseUrl": "text",
          "organizationId": "text",
          "organizationName": "text",
          "tenantId": "text"
        },
        "bitbucket": {
          "appKey": "text",
          "baseUrl": "text",
          "clientKey": "text",
          "ownerId": "text",
          "ownerName": "text",
          "sharedSecret": "text"
        },
        "external": {
          "installationId": "text"
        },
        "github": {
          "installationId": 1,
          "owner": "text",
          "ownerId": 1,
          "ownerType": "text"
        },
        "gitlab": {
          "baseUrl": "text",
          "groupId": 1,
          "groupName": "text"
        },
        "id": "text",
        "jira": {
          "appKeyId": "text",
          "baseUrl": "text",
          "installationId": "text",
          "ownerId": "text",
          "sharedSecret": "text"
        },
        "slack": {}
      },
      "provider": {
        "azure": {
          "projectId": "text",
          "projectName": "text",
          "repositoryId": "text",
          "repositoryName": "text"
        },
        "bitbucket": {
          "projectKey": "text",
          "projectName": "text",
          "repositoryId": "text",
          "repositoryName": "text"
        },
        "github": {
          "hasIssue": true,
          "owner": "text",
          "ownerId": 1,
          "repositoryId": 1,
          "repositoryName": "text"
        },
        "gitlab": {
          "projectId": 1,
          "projectName": "text"
        },
        "id": "text"
      },
      "repoSizeGiB": 1
    }
  ]
}

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

Get Teams

This endpoint only works for GitHub organisations currently.

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