Skip to content
For the complete documentation index, see llms.txt. This page is also available as Markdown.

Teams and Ownership

A team groups people and the repositories they own, and drives who findings are assigned to. These endpoints manage teams, control which sources create teams automatically, and map findings to teams. Authenticate as described in Authentication; people and roles are covered in Users and Identity and Access.

Every call is scoped to a workspace with a provider query parameter such as githubOwnerId, gitlabGroupId, azureOrganizationId, bitbucketWorkspaceId or installationId. Which one you pass depends on how your tenant is connected; the call returns 400 when none resolves to a tenant.

Teams have a source: github_teams, repository_property, atlassian_compass, identity_provider or manual. Only manual teams can be created, edited freely and deleted through this API; teams from the other sources are maintained by their sync.

Teams

List teams

Returns a page of teams from every source, with lead and member details filled in. Filter with search (case-insensitive match on the team name) or repositoryId (only teams that own that repository). Page with limit (default 200, at most 1,000) and nextToken, or jump to a position with offset, which wins over nextToken when both are sent; see Pagination. A page is also cut short if it would exceed about 4 MiB serialized, so follow nextToken until it is empty rather than assuming a full page. numItems is the total number of matching teams. Requires ConfigRead.

curl -s \
  -H "Accept: application/json" \
  -H "Authorization: Bearer <TOKEN>" \
  'https://api.<TENANT>.nullify.ai/admin/teams?githubOwnerId=1234&search=platform&limit=50'

Get All Teams

get

Get a paginated list of teams from all sources (Nullify and git platform), with user details populated.

Query parameters
azureOrganizationIdstringOptional

The Azure organization ID

bitbucketWorkspaceIdstringOptional

The Bitbucket workspace ID

githubOwnerIdinteger · int64Optional

The Github owner ID

githubInstallationIdinteger · int64Optional

Operator routes only: the GitHub App installation ID to use alongside githubOwnerId when the tenant's stored record has none. Ignored on customer routes.

gitlabGroupIdinteger · int64Optional

The GitLab group ID

installationIdstringOptional

The Nullify installation ID

azureRepositoryIdstring[]Optional

Filter by Azure repository IDs

githubRepositoryIdinteger · int64[]Optional

Filter by GitHub repository IDs

githubTeamIdinteger · int64Optional

Filter by GitHub team ID

bitbucketRepositoryIdstring[]Optional

Filter by Bitbucket repository IDs

nextTokenstring · nullableOptional

Pagination token for the next page of results

offsetinteger · nullableOptional

Pagination offset; overrides nextToken when set

limitinteger · nullableOptional

Maximum number of teams to return per page

searchstring · nullableOptional

Case-insensitive search filter for team names

repositoryIdstring · nullableOptional

Return only teams that own this repository (canonical repository ID). Skips the full-tenant scan.

skipUserEnrichmentboolean · nullableOptional

Internal callers only: skip user (Lead/Members) enrichment and the synchronous GitHub teams refresh. Returns a pure DB-paginated page.

idsstring[] · max: 100Optional

Return exactly these teams (at most 100), soft-disabled ones included, paged like any other list. Each team carries its own fields only: no members, code ownerships or ground rules. Cannot be combined with search or repositoryId.

Responses
200

OK

application/json
latestUpdatedAtstring · date-time · nullableOptional
nextTokenstringRequired
numItemsintegerRequired
get/admin/teams
GET /admin/teams HTTP/1.1
Host: api.<TENANT>.nullify.ai
Accept: */*
{
  "latestUpdatedAt": "2026-01-01T00:00:00.000Z",
  "nextToken": "text",
  "numItems": 1,
  "teams": [
    {
      "azure": {
        "teamId": "text"
      },
      "codeOwnerships": [
        {
          "dataSource": "dx",
          "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": "DX"
          }
        }
      ],
      "github": {
        "orgLogin": "text",
        "teamId": 1,
        "teamSlug": "text"
      },
      "gitlab": {
        "groupId": 1
      },
      "groundRules": [
        {
          "description": "text",
          "id": "text",
          "title": "text"
        }
      ],
      "id": "text",
      "jira": {
        "teamId": "text"
      },
      "lead": {
        "asana": {
          "id": "text"
        },
        "azure": {
          "id": "text"
        },
        "azureEntra": {
          "id": "text"
        },
        "bitbucket": {
          "id": "text"
        },
        "createdAt": "text",
        "createdBy": "text",
        "deleted": true,
        "displayName": "text",
        "email": "text",
        "github": {
          "id": 1,
          "nodeId": "text"
        },
        "gitlab": {
          "id": 1
        },
        "googleWorkspace": {
          "id": "text"
        },
        "id": "text",
        "isBot": true,
        "isRestricted": true,
        "jira": {
          "id": "text",
          "name": "text"
        },
        "lastUpdatedBy": "text",
        "linear": {
          "id": "text"
        },
        "name": "text",
        "okta": {
          "id": "text"
        },
        "provider": {
          "asana": {
            "id": "text"
          },
          "azure": {
            "id": "text"
          },
          "azureEntra": {
            "id": "text"
          },
          "bitBucket": {
            "id": "text"
          },
          "gitHub": {
            "id": 1,
            "nodeId": "text"
          },
          "gitlab": {
            "id": 1
          },
          "googleWorkspace": {
            "id": "text"
          },
          "id": "DX",
          "jira": {
            "id": "text",
            "name": "text"
          },
          "linear": {
            "id": "text"
          },
          "okta": {
            "id": "text"
          },
          "slack": {
            "id": "text",
            "name": "text"
          },
          "teams": {
            "id": "text",
            "teamIDs": [
              "text"
            ]
          }
        },
        "realName": "text",
        "slack": {
          "id": "text",
          "name": "text"
        },
        "slug": "text",
        "teams": {
          "id": "text",
          "teamIDs": [
            "text"
          ]
        },
        "updatedAt": "text",
        "username": "text"
      },
      "leadId": "text",
      "linear": {
        "teamId": "text"
      },
      "memberIds": [
        "text"
      ],
      "members": [
        {
          "asana": {
            "id": "text"
          },
          "azure": {
            "id": "text"
          },
          "azureEntra": {
            "id": "text"
          },
          "bitbucket": {
            "id": "text"
          },
          "createdAt": "text",
          "createdBy": "text",
          "deleted": true,
          "displayName": "text",
          "email": "text",
          "github": {
            "id": 1,
            "nodeId": "text"
          },
          "gitlab": {
            "id": 1
          },
          "googleWorkspace": {
            "id": "text"
          },
          "id": "text",
          "isBot": true,
          "isRestricted": true,
          "jira": {
            "id": "text",
            "name": "text"
          },
          "lastUpdatedBy": "text",
          "linear": {
            "id": "text"
          },
          "name": "text",
          "okta": {
            "id": "text"
          },
          "provider": {
            "asana": {
              "id": "text"
            },
            "azure": {
              "id": "text"
            },
            "azureEntra": {
              "id": "text"
            },
            "bitBucket": {
              "id": "text"
            },
            "gitHub": {
              "id": 1,
              "nodeId": "text"
            },
            "gitlab": {
              "id": 1
            },
            "googleWorkspace": {
              "id": "text"
            },
            "id": "DX",
            "jira": {
              "id": "text",
              "name": "text"
            },
            "linear": {
              "id": "text"
            },
            "okta": {
              "id": "text"
            },
            "slack": {
              "id": "text",
              "name": "text"
            },
            "teams": {
              "id": "text",
              "teamIDs": [
                "text"
              ]
            }
          },
          "realName": "text",
          "slack": {
            "id": "text",
            "name": "text"
          },
          "slug": "text",
          "teams": {
            "id": "text",
            "teamIDs": [
              "text"
            ]
          },
          "updatedAt": "text",
          "username": "text"
        }
      ],
      "messageChannelProvider": {
        "id": "DX",
        "slack": {
          "id": "text",
          "thread_ts": "text"
        },
        "teams": {
          "channel": "text",
          "id": "text",
          "teamId": "text"
        }
      },
      "messageChannels": [
        {
          "channelProvider": {
            "id": "DX",
            "slack": {
              "id": "text",
              "thread_ts": "text"
            },
            "teams": {
              "channel": "text",
              "id": "text",
              "teamId": "text"
            }
          },
          "description": "text",
          "name": "text",
          "ownerProvider": {
            "asana": {
              "accessToken": "text",
              "workspaceId": "text",
              "workspaceName": "text"
            },
            "azure": {
              "baseUrl": "text",
              "organizationId": "text",
              "organizationName": "text",
              "tenantId": "text"
            },
            "azureEntra": {
              "clientId": "text",
              "clientSecret": "text",
              "tenantId": "text"
            },
            "bitbucket": {
              "appKey": "text",
              "baseUrl": "text",
              "clientKey": "text",
              "ownerId": "text",
              "ownerName": "text",
              "sharedSecret": "text"
            },
            "external": {
              "installationId": "text"
            },
            "github": {
              "baseUrl": "text",
              "executionIdentity": {
                "appID": 1,
                "proof": "text",
                "source": "dedicated_direct"
              },
              "installationId": 1,
              "owner": "text",
              "ownerId": 1,
              "ownerType": "text"
            },
            "gitlab": {
              "baseUrl": "text",
              "groupId": 1,
              "groupName": "text",
              "oauth": true
            },
            "googleWorkspace": {
              "adminEmail": "text",
              "domain": "text",
              "serviceAccountJson": "text"
            },
            "id": "DX",
            "jira": {
              "baseUrl": "text",
              "installationId": "text",
              "ownerId": "text"
            },
            "linear": {
              "accessToken": "text",
              "clientId": "text",
              "clientSecret": "text",
              "urlKey": "text",
              "workspaceId": "text",
              "workspaceName": "text"
            },
            "okta": {
              "apiToken": "text",
              "domain": "text"
            },
            "slack": {
              "teamId": "text"
            },
            "teams": {
              "teamId": "text"
            }
          }
        }
      ],
      "msteams": {
        "channelId": "text",
        "teamId": "text"
      },
      "name": "text",
      "numMembers": 1,
      "okta": {
        "groupId": "text"
      },
      "privacy": "text",
      "provider": "DX",
      "repositories": [
        {
          "cloneURL": "text",
          "createdAt": "text",
          "defaultBranch": "text",
          "description": "text",
          "forksCount": 1,
          "fullName": "text",
          "hasIssues": true,
          "head": "text",
          "htmlURL": "text",
          "id": "text",
          "isArchived": true,
          "isFork": true,
          "isGlobalConfig": true,
          "isInitialized": true,
          "isPublic": true,
          "language": "text",
          "license": "text",
          "name": "text",
          "openIssues": 1,
          "ownerProvider": {
            "asana": {
              "accessToken": "text",
              "workspaceId": "text",
              "workspaceName": "text"
            },
            "azure": {
              "baseUrl": "text",
              "organizationId": "text",
              "organizationName": "text",
              "tenantId": "text"
            },
            "azureEntra": {
              "clientId": "text",
              "clientSecret": "text",
              "tenantId": "text"
            },
            "bitbucket": {
              "appKey": "text",
              "baseUrl": "text",
              "clientKey": "text",
              "ownerId": "text",
              "ownerName": "text",
              "sharedSecret": "text"
            },
            "external": {
              "installationId": "text"
            },
            "github": {
              "baseUrl": "text",
              "executionIdentity": {
                "appID": 1,
                "proof": "text",
                "source": "dedicated_direct"
              },
              "installationId": 1,
              "owner": "text",
              "ownerId": 1,
              "ownerType": "text"
            },
            "gitlab": {
              "baseUrl": "text",
              "groupId": 1,
              "groupName": "text",
              "oauth": true
            },
            "googleWorkspace": {
              "adminEmail": "text",
              "domain": "text",
              "serviceAccountJson": "text"
            },
            "id": "DX",
            "jira": {
              "baseUrl": "text",
              "installationId": "text",
              "ownerId": "text"
            },
            "linear": {
              "accessToken": "text",
              "clientId": "text",
              "clientSecret": "text",
              "urlKey": "text",
              "workspaceId": "text",
              "workspaceName": "text"
            },
            "okta": {
              "apiToken": "text",
              "domain": "text"
            },
            "slack": {
              "teamId": "text"
            },
            "teams": {
              "teamId": "text"
            }
          },
          "provider": {
            "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": "DX"
          },
          "pushedAt": "text",
          "repoSizeBytes": 1,
          "repoSizeGiB": 1,
          "starCount": 1,
          "topics": [
            "text"
          ],
          "updatedAt": "text",
          "visibility": "text"
        }
      ],
      "repositoryIds": [
        "text"
      ],
      "slack": {
        "groupId": "text"
      },
      "slug": "text",
      "source": "dx",
      "sourceRepositoryPropertyName": "text",
      "sourceRepositoryPropertyValue": "text",
      "ticketBoardId": "text",
      "ticketProjectProvider": {
        "asana": {
          "projectGid": "text",
          "projectName": "text",
          "teamGid": "text",
          "workspaceGid": "text"
        },
        "azure": {
          "projectName": "text"
        },
        "bitbucket": {},
        "github": {
          "repositoryId": 1,
          "repositoryName": "text",
          "repositoryNodeId": "text"
        },
        "gitlab": {},
        "id": "DX",
        "jira": {
          "id": "text",
          "projectKey": "text"
        },
        "linear": {
          "projectId": "text",
          "teamId": "text",
          "teamKey": "text"
        }
      }
    }
  ]
}

Get a team

Returns one team by teamID, the id of a team from List teams, with members, leads, repositories and code owner glob patterns filled in. Note the path is /admin/team/{teamID} (singular team). Returns 404 if the team does not exist in your workspace. Requires ConfigRead.

Get Team

get

Retrieve a single team by teamID, with user and repository details populated

Path parameters
teamIDstringRequired
Query parameters
azureOrganizationIdstringOptional

The Azure organization ID

bitbucketWorkspaceIdstringOptional

The Bitbucket workspace ID

githubOwnerIdinteger · int64Optional

The Github owner ID

githubInstallationIdinteger · int64Optional

Operator routes only: the GitHub App installation ID to use alongside githubOwnerId when the tenant's stored record has none. Ignored on customer routes.

gitlabGroupIdinteger · int64Optional

The GitLab group ID

installationIdstringOptional

The Nullify installation ID

azureRepositoryIdstring[]Optional

Filter by Azure repository IDs

githubRepositoryIdinteger · int64[]Optional

Filter by GitHub repository IDs

githubTeamIdinteger · int64Optional

Filter by GitHub team ID

bitbucketRepositoryIdstring[]Optional

Filter by Bitbucket repository IDs

Responses
200

OK

application/json
get/admin/team/{teamID}
GET /admin/team/{teamID} HTTP/1.1
Host: api.<TENANT>.nullify.ai
Accept: */*
{
  "team": {
    "azure": {
      "teamId": "text"
    },
    "codeOwnerships": [
      {
        "dataSource": "dx",
        "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": "DX"
        }
      }
    ],
    "github": {
      "orgLogin": "text",
      "teamId": 1,
      "teamSlug": "text"
    },
    "gitlab": {
      "groupId": 1
    },
    "groundRules": [
      {
        "description": "text",
        "id": "text",
        "title": "text"
      }
    ],
    "id": "text",
    "jira": {
      "teamId": "text"
    },
    "lead": {
      "asana": {
        "id": "text"
      },
      "azure": {
        "id": "text"
      },
      "azureEntra": {
        "id": "text"
      },
      "bitbucket": {
        "id": "text"
      },
      "createdAt": "text",
      "createdBy": "text",
      "deleted": true,
      "displayName": "text",
      "email": "text",
      "github": {
        "id": 1,
        "nodeId": "text"
      },
      "gitlab": {
        "id": 1
      },
      "googleWorkspace": {
        "id": "text"
      },
      "id": "text",
      "isBot": true,
      "isRestricted": true,
      "jira": {
        "id": "text",
        "name": "text"
      },
      "lastUpdatedBy": "text",
      "linear": {
        "id": "text"
      },
      "name": "text",
      "okta": {
        "id": "text"
      },
      "provider": {
        "asana": {
          "id": "text"
        },
        "azure": {
          "id": "text"
        },
        "azureEntra": {
          "id": "text"
        },
        "bitBucket": {
          "id": "text"
        },
        "gitHub": {
          "id": 1,
          "nodeId": "text"
        },
        "gitlab": {
          "id": 1
        },
        "googleWorkspace": {
          "id": "text"
        },
        "id": "DX",
        "jira": {
          "id": "text",
          "name": "text"
        },
        "linear": {
          "id": "text"
        },
        "okta": {
          "id": "text"
        },
        "slack": {
          "id": "text",
          "name": "text"
        },
        "teams": {
          "id": "text",
          "teamIDs": [
            "text"
          ]
        }
      },
      "realName": "text",
      "slack": {
        "id": "text",
        "name": "text"
      },
      "slug": "text",
      "teams": {
        "id": "text",
        "teamIDs": [
          "text"
        ]
      },
      "updatedAt": "text",
      "username": "text"
    },
    "leadId": "text",
    "linear": {
      "teamId": "text"
    },
    "memberIds": [
      "text"
    ],
    "members": [
      {
        "asana": {
          "id": "text"
        },
        "azure": {
          "id": "text"
        },
        "azureEntra": {
          "id": "text"
        },
        "bitbucket": {
          "id": "text"
        },
        "createdAt": "text",
        "createdBy": "text",
        "deleted": true,
        "displayName": "text",
        "email": "text",
        "github": {
          "id": 1,
          "nodeId": "text"
        },
        "gitlab": {
          "id": 1
        },
        "googleWorkspace": {
          "id": "text"
        },
        "id": "text",
        "isBot": true,
        "isRestricted": true,
        "jira": {
          "id": "text",
          "name": "text"
        },
        "lastUpdatedBy": "text",
        "linear": {
          "id": "text"
        },
        "name": "text",
        "okta": {
          "id": "text"
        },
        "provider": {
          "asana": {
            "id": "text"
          },
          "azure": {
            "id": "text"
          },
          "azureEntra": {
            "id": "text"
          },
          "bitBucket": {
            "id": "text"
          },
          "gitHub": {
            "id": 1,
            "nodeId": "text"
          },
          "gitlab": {
            "id": 1
          },
          "googleWorkspace": {
            "id": "text"
          },
          "id": "DX",
          "jira": {
            "id": "text",
            "name": "text"
          },
          "linear": {
            "id": "text"
          },
          "okta": {
            "id": "text"
          },
          "slack": {
            "id": "text",
            "name": "text"
          },
          "teams": {
            "id": "text",
            "teamIDs": [
              "text"
            ]
          }
        },
        "realName": "text",
        "slack": {
          "id": "text",
          "name": "text"
        },
        "slug": "text",
        "teams": {
          "id": "text",
          "teamIDs": [
            "text"
          ]
        },
        "updatedAt": "text",
        "username": "text"
      }
    ],
    "messageChannelProvider": {
      "id": "DX",
      "slack": {
        "id": "text",
        "thread_ts": "text"
      },
      "teams": {
        "channel": "text",
        "id": "text",
        "teamId": "text"
      }
    },
    "messageChannels": [
      {
        "channelProvider": {
          "id": "DX",
          "slack": {
            "id": "text",
            "thread_ts": "text"
          },
          "teams": {
            "channel": "text",
            "id": "text",
            "teamId": "text"
          }
        },
        "description": "text",
        "name": "text",
        "ownerProvider": {
          "asana": {
            "accessToken": "text",
            "workspaceId": "text",
            "workspaceName": "text"
          },
          "azure": {
            "baseUrl": "text",
            "organizationId": "text",
            "organizationName": "text",
            "tenantId": "text"
          },
          "azureEntra": {
            "clientId": "text",
            "clientSecret": "text",
            "tenantId": "text"
          },
          "bitbucket": {
            "appKey": "text",
            "baseUrl": "text",
            "clientKey": "text",
            "ownerId": "text",
            "ownerName": "text",
            "sharedSecret": "text"
          },
          "external": {
            "installationId": "text"
          },
          "github": {
            "baseUrl": "text",
            "executionIdentity": {
              "appID": 1,
              "proof": "text",
              "source": "dedicated_direct"
            },
            "installationId": 1,
            "owner": "text",
            "ownerId": 1,
            "ownerType": "text"
          },
          "gitlab": {
            "baseUrl": "text",
            "groupId": 1,
            "groupName": "text",
            "oauth": true
          },
          "googleWorkspace": {
            "adminEmail": "text",
            "domain": "text",
            "serviceAccountJson": "text"
          },
          "id": "DX",
          "jira": {
            "baseUrl": "text",
            "installationId": "text",
            "ownerId": "text"
          },
          "linear": {
            "accessToken": "text",
            "clientId": "text",
            "clientSecret": "text",
            "urlKey": "text",
            "workspaceId": "text",
            "workspaceName": "text"
          },
          "okta": {
            "apiToken": "text",
            "domain": "text"
          },
          "slack": {
            "teamId": "text"
          },
          "teams": {
            "teamId": "text"
          }
        }
      }
    ],
    "msteams": {
      "channelId": "text",
      "teamId": "text"
    },
    "name": "text",
    "numMembers": 1,
    "okta": {
      "groupId": "text"
    },
    "privacy": "text",
    "provider": "DX",
    "repositories": [
      {
        "cloneURL": "text",
        "createdAt": "text",
        "defaultBranch": "text",
        "description": "text",
        "forksCount": 1,
        "fullName": "text",
        "hasIssues": true,
        "head": "text",
        "htmlURL": "text",
        "id": "text",
        "isArchived": true,
        "isFork": true,
        "isGlobalConfig": true,
        "isInitialized": true,
        "isPublic": true,
        "language": "text",
        "license": "text",
        "name": "text",
        "openIssues": 1,
        "ownerProvider": {
          "asana": {
            "accessToken": "text",
            "workspaceId": "text",
            "workspaceName": "text"
          },
          "azure": {
            "baseUrl": "text",
            "organizationId": "text",
            "organizationName": "text",
            "tenantId": "text"
          },
          "azureEntra": {
            "clientId": "text",
            "clientSecret": "text",
            "tenantId": "text"
          },
          "bitbucket": {
            "appKey": "text",
            "baseUrl": "text",
            "clientKey": "text",
            "ownerId": "text",
            "ownerName": "text",
            "sharedSecret": "text"
          },
          "external": {
            "installationId": "text"
          },
          "github": {
            "baseUrl": "text",
            "executionIdentity": {
              "appID": 1,
              "proof": "text",
              "source": "dedicated_direct"
            },
            "installationId": 1,
            "owner": "text",
            "ownerId": 1,
            "ownerType": "text"
          },
          "gitlab": {
            "baseUrl": "text",
            "groupId": 1,
            "groupName": "text",
            "oauth": true
          },
          "googleWorkspace": {
            "adminEmail": "text",
            "domain": "text",
            "serviceAccountJson": "text"
          },
          "id": "DX",
          "jira": {
            "baseUrl": "text",
            "installationId": "text",
            "ownerId": "text"
          },
          "linear": {
            "accessToken": "text",
            "clientId": "text",
            "clientSecret": "text",
            "urlKey": "text",
            "workspaceId": "text",
            "workspaceName": "text"
          },
          "okta": {
            "apiToken": "text",
            "domain": "text"
          },
          "slack": {
            "teamId": "text"
          },
          "teams": {
            "teamId": "text"
          }
        },
        "provider": {
          "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": "DX"
        },
        "pushedAt": "text",
        "repoSizeBytes": 1,
        "repoSizeGiB": 1,
        "starCount": 1,
        "topics": [
          "text"
        ],
        "updatedAt": "text",
        "visibility": "text"
      }
    ],
    "repositoryIds": [
      "text"
    ],
    "slack": {
      "groupId": "text"
    },
    "slug": "text",
    "source": "dx",
    "sourceRepositoryPropertyName": "text",
    "sourceRepositoryPropertyValue": "text",
    "ticketBoardId": "text",
    "ticketProjectProvider": {
      "asana": {
        "projectGid": "text",
        "projectName": "text",
        "teamGid": "text",
        "workspaceGid": "text"
      },
      "azure": {
        "projectName": "text"
      },
      "bitbucket": {},
      "github": {
        "repositoryId": 1,
        "repositoryName": "text",
        "repositoryNodeId": "text"
      },
      "gitlab": {},
      "id": "DX",
      "jira": {
        "id": "text",
        "projectKey": "text"
      },
      "linear": {
        "projectId": "text",
        "teamId": "text",
        "teamKey": "text"
      }
    }
  }
}

Create a manual team

Creates a team with source manual. name, slug, privacy, messageChannelProvider and ticketProjectProvider are required by the schema and name must be non-empty. A new team id is generated on every call, so repeating the call creates another team. leadId must be a Nullify user id from Users (400 otherwise); memberIds are not checked on create, so set members with Update a team, which validates them. Every codeOwnerships[].dataSource must be manual. groundRules need a non-empty title (up to 200 characters) and a description of up to 2,000 characters. Internal automation (agents) cannot send codeOwnerships and receives 403; a person's token can. Requires TeamManage.

Use "messageChannelProvider":{"id":""} when the team has no message channel.

Post Team

post

Create or update a team under the given providerID (upsert repositories). codeOwnerships make the team the owner of repositories and need a person: internal automation (agents) cannot send them and is refused; its other fields are accepted

Query parameters
azureOrganizationIdstringOptional

The Azure organization ID

bitbucketWorkspaceIdstringOptional

The Bitbucket workspace ID

githubOwnerIdinteger · int64Optional

The Github owner ID

githubInstallationIdinteger · int64Optional

Operator routes only: the GitHub App installation ID to use alongside githubOwnerId when the tenant's stored record has none. Ignored on customer routes.

gitlabGroupIdinteger · int64Optional

The GitLab group ID

installationIdstringOptional

The Nullify installation ID

azureRepositoryIdstring[]Optional

Filter by Azure repository IDs

githubRepositoryIdinteger · int64[]Optional

Filter by GitHub repository IDs

githubTeamIdinteger · int64Optional

Filter by GitHub team ID

bitbucketRepositoryIdstring[]Optional

Filter by Bitbucket repository IDs

Body
leadIdstringOptional
memberIdsstring[]Optional
namestringRequired
privacystring · enumRequiredPossible values:
slugstringRequired
Responses
200

OK

application/json
post/admin/teams
POST /admin/teams HTTP/1.1
Host: api.<TENANT>.nullify.ai
Content-Type: application/json
Accept: */*
Content-Length: 1199

{
  "codeOwnerships": [
    {
      "dataSource": "dx",
      "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": "DX"
      }
    }
  ],
  "github": {
    "orgLogin": "text",
    "teamId": 1,
    "teamSlug": "text"
  },
  "gitlab": {
    "groupId": 1
  },
  "groundRules": [
    {
      "description": "text",
      "id": "text",
      "title": "text"
    }
  ],
  "jira": {
    "teamId": "text"
  },
  "leadId": "text",
  "memberIds": [
    "text"
  ],
  "messageChannelProvider": {
    "id": "DX",
    "slack": {
      "id": "text",
      "thread_ts": "text"
    },
    "teams": {
      "channel": "text",
      "id": "text",
      "teamId": "text"
    }
  },
  "name": "text",
  "privacy": "private",
  "slug": "text",
  "ticketProjectProvider": {
    "asana": {
      "projectGid": "text",
      "projectName": "text",
      "teamGid": "text",
      "workspaceGid": "text"
    },
    "azure": {
      "projectName": "text"
    },
    "bitbucket": {},
    "github": {
      "repositoryId": 1,
      "repositoryName": "text",
      "repositoryNodeId": "text"
    },
    "gitlab": {},
    "id": "DX",
    "jira": {
      "id": "text",
      "projectKey": "text"
    },
    "linear": {
      "projectId": "text",
      "teamId": "text",
      "teamKey": "text"
    }
  }
}
{
  "team": {
    "azure": {
      "teamId": "text"
    },
    "codeOwnerships": [
      {
        "dataSource": "dx",
        "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": "DX"
        }
      }
    ],
    "github": {
      "orgLogin": "text",
      "teamId": 1,
      "teamSlug": "text"
    },
    "gitlab": {
      "groupId": 1
    },
    "groundRules": [
      {
        "description": "text",
        "id": "text",
        "title": "text"
      }
    ],
    "id": "text",
    "jira": {
      "teamId": "text"
    },
    "lead": {
      "asana": {
        "id": "text"
      },
      "azure": {
        "id": "text"
      },
      "azureEntra": {
        "id": "text"
      },
      "bitbucket": {
        "id": "text"
      },
      "createdAt": "text",
      "createdBy": "text",
      "deleted": true,
      "displayName": "text",
      "email": "text",
      "github": {
        "id": 1,
        "nodeId": "text"
      },
      "gitlab": {
        "id": 1
      },
      "googleWorkspace": {
        "id": "text"
      },
      "id": "text",
      "isBot": true,
      "isRestricted": true,
      "jira": {
        "id": "text",
        "name": "text"
      },
      "lastUpdatedBy": "text",
      "linear": {
        "id": "text"
      },
      "name": "text",
      "okta": {
        "id": "text"
      },
      "provider": {
        "asana": {
          "id": "text"
        },
        "azure": {
          "id": "text"
        },
        "azureEntra": {
          "id": "text"
        },
        "bitBucket": {
          "id": "text"
        },
        "gitHub": {
          "id": 1,
          "nodeId": "text"
        },
        "gitlab": {
          "id": 1
        },
        "googleWorkspace": {
          "id": "text"
        },
        "id": "DX",
        "jira": {
          "id": "text",
          "name": "text"
        },
        "linear": {
          "id": "text"
        },
        "okta": {
          "id": "text"
        },
        "slack": {
          "id": "text",
          "name": "text"
        },
        "teams": {
          "id": "text",
          "teamIDs": [
            "text"
          ]
        }
      },
      "realName": "text",
      "slack": {
        "id": "text",
        "name": "text"
      },
      "slug": "text",
      "teams": {
        "id": "text",
        "teamIDs": [
          "text"
        ]
      },
      "updatedAt": "text",
      "username": "text"
    },
    "leadId": "text",
    "linear": {
      "teamId": "text"
    },
    "memberIds": [
      "text"
    ],
    "members": [
      {
        "asana": {
          "id": "text"
        },
        "azure": {
          "id": "text"
        },
        "azureEntra": {
          "id": "text"
        },
        "bitbucket": {
          "id": "text"
        },
        "createdAt": "text",
        "createdBy": "text",
        "deleted": true,
        "displayName": "text",
        "email": "text",
        "github": {
          "id": 1,
          "nodeId": "text"
        },
        "gitlab": {
          "id": 1
        },
        "googleWorkspace": {
          "id": "text"
        },
        "id": "text",
        "isBot": true,
        "isRestricted": true,
        "jira": {
          "id": "text",
          "name": "text"
        },
        "lastUpdatedBy": "text",
        "linear": {
          "id": "text"
        },
        "name": "text",
        "okta": {
          "id": "text"
        },
        "provider": {
          "asana": {
            "id": "text"
          },
          "azure": {
            "id": "text"
          },
          "azureEntra": {
            "id": "text"
          },
          "bitBucket": {
            "id": "text"
          },
          "gitHub": {
            "id": 1,
            "nodeId": "text"
          },
          "gitlab": {
            "id": 1
          },
          "googleWorkspace": {
            "id": "text"
          },
          "id": "DX",
          "jira": {
            "id": "text",
            "name": "text"
          },
          "linear": {
            "id": "text"
          },
          "okta": {
            "id": "text"
          },
          "slack": {
            "id": "text",
            "name": "text"
          },
          "teams": {
            "id": "text",
            "teamIDs": [
              "text"
            ]
          }
        },
        "realName": "text",
        "slack": {
          "id": "text",
          "name": "text"
        },
        "slug": "text",
        "teams": {
          "id": "text",
          "teamIDs": [
            "text"
          ]
        },
        "updatedAt": "text",
        "username": "text"
      }
    ],
    "messageChannelProvider": {
      "id": "DX",
      "slack": {
        "id": "text",
        "thread_ts": "text"
      },
      "teams": {
        "channel": "text",
        "id": "text",
        "teamId": "text"
      }
    },
    "messageChannels": [
      {
        "channelProvider": {
          "id": "DX",
          "slack": {
            "id": "text",
            "thread_ts": "text"
          },
          "teams": {
            "channel": "text",
            "id": "text",
            "teamId": "text"
          }
        },
        "description": "text",
        "name": "text",
        "ownerProvider": {
          "asana": {
            "accessToken": "text",
            "workspaceId": "text",
            "workspaceName": "text"
          },
          "azure": {
            "baseUrl": "text",
            "organizationId": "text",
            "organizationName": "text",
            "tenantId": "text"
          },
          "azureEntra": {
            "clientId": "text",
            "clientSecret": "text",
            "tenantId": "text"
          },
          "bitbucket": {
            "appKey": "text",
            "baseUrl": "text",
            "clientKey": "text",
            "ownerId": "text",
            "ownerName": "text",
            "sharedSecret": "text"
          },
          "external": {
            "installationId": "text"
          },
          "github": {
            "baseUrl": "text",
            "executionIdentity": {
              "appID": 1,
              "proof": "text",
              "source": "dedicated_direct"
            },
            "installationId": 1,
            "owner": "text",
            "ownerId": 1,
            "ownerType": "text"
          },
          "gitlab": {
            "baseUrl": "text",
            "groupId": 1,
            "groupName": "text",
            "oauth": true
          },
          "googleWorkspace": {
            "adminEmail": "text",
            "domain": "text",
            "serviceAccountJson": "text"
          },
          "id": "DX",
          "jira": {
            "baseUrl": "text",
            "installationId": "text",
            "ownerId": "text"
          },
          "linear": {
            "accessToken": "text",
            "clientId": "text",
            "clientSecret": "text",
            "urlKey": "text",
            "workspaceId": "text",
            "workspaceName": "text"
          },
          "okta": {
            "apiToken": "text",
            "domain": "text"
          },
          "slack": {
            "teamId": "text"
          },
          "teams": {
            "teamId": "text"
          }
        }
      }
    ],
    "msteams": {
      "channelId": "text",
      "teamId": "text"
    },
    "name": "text",
    "numMembers": 1,
    "okta": {
      "groupId": "text"
    },
    "privacy": "text",
    "provider": "DX",
    "repositories": [
      {
        "cloneURL": "text",
        "createdAt": "text",
        "defaultBranch": "text",
        "description": "text",
        "forksCount": 1,
        "fullName": "text",
        "hasIssues": true,
        "head": "text",
        "htmlURL": "text",
        "id": "text",
        "isArchived": true,
        "isFork": true,
        "isGlobalConfig": true,
        "isInitialized": true,
        "isPublic": true,
        "language": "text",
        "license": "text",
        "name": "text",
        "openIssues": 1,
        "ownerProvider": {
          "asana": {
            "accessToken": "text",
            "workspaceId": "text",
            "workspaceName": "text"
          },
          "azure": {
            "baseUrl": "text",
            "organizationId": "text",
            "organizationName": "text",
            "tenantId": "text"
          },
          "azureEntra": {
            "clientId": "text",
            "clientSecret": "text",
            "tenantId": "text"
          },
          "bitbucket": {
            "appKey": "text",
            "baseUrl": "text",
            "clientKey": "text",
            "ownerId": "text",
            "ownerName": "text",
            "sharedSecret": "text"
          },
          "external": {
            "installationId": "text"
          },
          "github": {
            "baseUrl": "text",
            "executionIdentity": {
              "appID": 1,
              "proof": "text",
              "source": "dedicated_direct"
            },
            "installationId": 1,
            "owner": "text",
            "ownerId": 1,
            "ownerType": "text"
          },
          "gitlab": {
            "baseUrl": "text",
            "groupId": 1,
            "groupName": "text",
            "oauth": true
          },
          "googleWorkspace": {
            "adminEmail": "text",
            "domain": "text",
            "serviceAccountJson": "text"
          },
          "id": "DX",
          "jira": {
            "baseUrl": "text",
            "installationId": "text",
            "ownerId": "text"
          },
          "linear": {
            "accessToken": "text",
            "clientId": "text",
            "clientSecret": "text",
            "urlKey": "text",
            "workspaceId": "text",
            "workspaceName": "text"
          },
          "okta": {
            "apiToken": "text",
            "domain": "text"
          },
          "slack": {
            "teamId": "text"
          },
          "teams": {
            "teamId": "text"
          }
        },
        "provider": {
          "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": "DX"
        },
        "pushedAt": "text",
        "repoSizeBytes": 1,
        "repoSizeGiB": 1,
        "starCount": 1,
        "topics": [
          "text"
        ],
        "updatedAt": "text",
        "visibility": "text"
      }
    ],
    "repositoryIds": [
      "text"
    ],
    "slack": {
      "groupId": "text"
    },
    "slug": "text",
    "source": "dx",
    "sourceRepositoryPropertyName": "text",
    "sourceRepositoryPropertyValue": "text",
    "ticketBoardId": "text",
    "ticketProjectProvider": {
      "asana": {
        "projectGid": "text",
        "projectName": "text",
        "teamGid": "text",
        "workspaceGid": "text"
      },
      "azure": {
        "projectName": "text"
      },
      "bitbucket": {},
      "github": {
        "repositoryId": 1,
        "repositoryName": "text",
        "repositoryNodeId": "text"
      },
      "gitlab": {},
      "id": "DX",
      "jira": {
        "id": "text",
        "projectKey": "text"
      },
      "linear": {
        "projectId": "text",
        "teamId": "text",
        "teamKey": "text"
      }
    }
  }
}

Update a team

Partially updates a team: only fields you send are changed, and an omitted field keeps its stored value. groundRules replaces the stored list, and an empty array clears it. memberIds is the complete member list: users you add become manual members that the provider sync keeps, users you leave out are removed and the sync does not add them back, an empty list removes everyone, and omitting memberIds leaves membership alone. codeOwnerships entries must have dataSource manual. The github, gitlab and jira objects are merged field by field. leadId and added members must be Nullify user ids (400 otherwise); an unknown teamID returns 404. Internal automation (agents) cannot send memberIds or codeOwnerships and receives 403. Changing members or code ownerships queues a background re-sync of finding-to-team mappings. Member and ownership edits are recorded in the audit log. Requires TeamManage.

Patch Team

patch

Update an existing team with partial data. Only provided fields will be updated. memberIds is the team's complete member list: a user listed who is not a member becomes a manual member the provider sync keeps, and a member left out, whether the provider sync or an earlier edit added them, is removed and recorded as a removal the sync never undoes. Users already in the list are left alone, an empty list removes every member, and repeating the same list changes nothing. Omit memberIds to keep the membership as it is. addMemberIds/removeMemberIds apply atomic membership-only changes; they cannot be combined with metadata or memberIds. Removing the current lead returns 409. Internal automation (agents) cannot send memberIds, addMemberIds, removeMemberIds, clearLead or codeOwnerships and is refused: they change access and need a person; its other fields are accepted

Path parameters
teamIDstringRequired

The ID of the team to update

Query parameters
azureOrganizationIdstringOptional

The Azure organization ID

bitbucketWorkspaceIdstringOptional

The Bitbucket workspace ID

githubOwnerIdinteger · int64Optional

The Github owner ID

githubInstallationIdinteger · int64Optional

Operator routes only: the GitHub App installation ID to use alongside githubOwnerId when the tenant's stored record has none. Ignored on customer routes.

gitlabGroupIdinteger · int64Optional

The GitLab group ID

installationIdstringOptional

The Nullify installation ID

azureRepositoryIdstring[]Optional

Filter by Azure repository IDs

githubRepositoryIdinteger · int64[]Optional

Filter by GitHub repository IDs

githubTeamIdinteger · int64Optional

Filter by GitHub team ID

bitbucketRepositoryIdstring[]Optional

Filter by Bitbucket repository IDs

Body
addMemberIdsstring[]Optional

Members to add atomically; cannot be combined with metadata or memberIds

clearLeadbooleanOptional

Clear the team lead; cannot be combined with a nonempty leadId or member deltas

leadIdstring · nullableOptional
memberIdsstring[]Optional
namestring · nullableOptional
privacystring · enum · nullableOptionalPossible values:
removeMemberIdsstring[]Optional

Members to remove atomically; the current lead cannot be removed

slugstring · nullableOptional
ticketBoardIdstring · nullableOptional

Destination ticket board for this team's findings (free-text provider-native project/team/repo id). Empty value preserves the existing board.

Responses
200

OK

application/json
patch/admin/teams/{teamID}
PATCH /admin/teams/{teamID} HTTP/1.1
Host: api.<TENANT>.nullify.ai
Content-Type: application/json
Accept: */*
Content-Length: 1290

{
  "addMemberIds": [
    "text"
  ],
  "clearLead": true,
  "codeOwnerships": [
    {
      "dataSource": "dx",
      "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": "DX"
      }
    }
  ],
  "github": {
    "orgLogin": "text",
    "teamId": 1,
    "teamSlug": "text"
  },
  "gitlab": {
    "groupId": 1
  },
  "groundRules": [
    {
      "description": "text",
      "id": "text",
      "title": "text"
    }
  ],
  "jira": {
    "teamId": "text"
  },
  "leadId": "text",
  "memberIds": [
    "text"
  ],
  "messageChannelProvider": {
    "id": "DX",
    "slack": {
      "id": "text",
      "thread_ts": "text"
    },
    "teams": {
      "channel": "text",
      "id": "text",
      "teamId": "text"
    }
  },
  "name": "text",
  "privacy": "private",
  "removeMemberIds": [
    "text"
  ],
  "slug": "text",
  "ticketBoardId": "text",
  "ticketProjectProvider": {
    "asana": {
      "projectGid": "text",
      "projectName": "text",
      "teamGid": "text",
      "workspaceGid": "text"
    },
    "azure": {
      "projectName": "text"
    },
    "bitbucket": {},
    "github": {
      "repositoryId": 1,
      "repositoryName": "text",
      "repositoryNodeId": "text"
    },
    "gitlab": {},
    "id": "DX",
    "jira": {
      "id": "text",
      "projectKey": "text"
    },
    "linear": {
      "projectId": "text",
      "teamId": "text",
      "teamKey": "text"
    }
  }
}
{
  "team": {
    "azure": {
      "teamId": "text"
    },
    "codeOwnerships": [
      {
        "dataSource": "dx",
        "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": "DX"
        }
      }
    ],
    "github": {
      "orgLogin": "text",
      "teamId": 1,
      "teamSlug": "text"
    },
    "gitlab": {
      "groupId": 1
    },
    "groundRules": [
      {
        "description": "text",
        "id": "text",
        "title": "text"
      }
    ],
    "id": "text",
    "jira": {
      "teamId": "text"
    },
    "lead": {
      "asana": {
        "id": "text"
      },
      "azure": {
        "id": "text"
      },
      "azureEntra": {
        "id": "text"
      },
      "bitbucket": {
        "id": "text"
      },
      "createdAt": "text",
      "createdBy": "text",
      "deleted": true,
      "displayName": "text",
      "email": "text",
      "github": {
        "id": 1,
        "nodeId": "text"
      },
      "gitlab": {
        "id": 1
      },
      "googleWorkspace": {
        "id": "text"
      },
      "id": "text",
      "isBot": true,
      "isRestricted": true,
      "jira": {
        "id": "text",
        "name": "text"
      },
      "lastUpdatedBy": "text",
      "linear": {
        "id": "text"
      },
      "name": "text",
      "okta": {
        "id": "text"
      },
      "provider": {
        "asana": {
          "id": "text"
        },
        "azure": {
          "id": "text"
        },
        "azureEntra": {
          "id": "text"
        },
        "bitBucket": {
          "id": "text"
        },
        "gitHub": {
          "id": 1,
          "nodeId": "text"
        },
        "gitlab": {
          "id": 1
        },
        "googleWorkspace": {
          "id": "text"
        },
        "id": "DX",
        "jira": {
          "id": "text",
          "name": "text"
        },
        "linear": {
          "id": "text"
        },
        "okta": {
          "id": "text"
        },
        "slack": {
          "id": "text",
          "name": "text"
        },
        "teams": {
          "id": "text",
          "teamIDs": [
            "text"
          ]
        }
      },
      "realName": "text",
      "slack": {
        "id": "text",
        "name": "text"
      },
      "slug": "text",
      "teams": {
        "id": "text",
        "teamIDs": [
          "text"
        ]
      },
      "updatedAt": "text",
      "username": "text"
    },
    "leadId": "text",
    "linear": {
      "teamId": "text"
    },
    "memberIds": [
      "text"
    ],
    "members": [
      {
        "asana": {
          "id": "text"
        },
        "azure": {
          "id": "text"
        },
        "azureEntra": {
          "id": "text"
        },
        "bitbucket": {
          "id": "text"
        },
        "createdAt": "text",
        "createdBy": "text",
        "deleted": true,
        "displayName": "text",
        "email": "text",
        "github": {
          "id": 1,
          "nodeId": "text"
        },
        "gitlab": {
          "id": 1
        },
        "googleWorkspace": {
          "id": "text"
        },
        "id": "text",
        "isBot": true,
        "isRestricted": true,
        "jira": {
          "id": "text",
          "name": "text"
        },
        "lastUpdatedBy": "text",
        "linear": {
          "id": "text"
        },
        "name": "text",
        "okta": {
          "id": "text"
        },
        "provider": {
          "asana": {
            "id": "text"
          },
          "azure": {
            "id": "text"
          },
          "azureEntra": {
            "id": "text"
          },
          "bitBucket": {
            "id": "text"
          },
          "gitHub": {
            "id": 1,
            "nodeId": "text"
          },
          "gitlab": {
            "id": 1
          },
          "googleWorkspace": {
            "id": "text"
          },
          "id": "DX",
          "jira": {
            "id": "text",
            "name": "text"
          },
          "linear": {
            "id": "text"
          },
          "okta": {
            "id": "text"
          },
          "slack": {
            "id": "text",
            "name": "text"
          },
          "teams": {
            "id": "text",
            "teamIDs": [
              "text"
            ]
          }
        },
        "realName": "text",
        "slack": {
          "id": "text",
          "name": "text"
        },
        "slug": "text",
        "teams": {
          "id": "text",
          "teamIDs": [
            "text"
          ]
        },
        "updatedAt": "text",
        "username": "text"
      }
    ],
    "messageChannelProvider": {
      "id": "DX",
      "slack": {
        "id": "text",
        "thread_ts": "text"
      },
      "teams": {
        "channel": "text",
        "id": "text",
        "teamId": "text"
      }
    },
    "messageChannels": [
      {
        "channelProvider": {
          "id": "DX",
          "slack": {
            "id": "text",
            "thread_ts": "text"
          },
          "teams": {
            "channel": "text",
            "id": "text",
            "teamId": "text"
          }
        },
        "description": "text",
        "name": "text",
        "ownerProvider": {
          "asana": {
            "accessToken": "text",
            "workspaceId": "text",
            "workspaceName": "text"
          },
          "azure": {
            "baseUrl": "text",
            "organizationId": "text",
            "organizationName": "text",
            "tenantId": "text"
          },
          "azureEntra": {
            "clientId": "text",
            "clientSecret": "text",
            "tenantId": "text"
          },
          "bitbucket": {
            "appKey": "text",
            "baseUrl": "text",
            "clientKey": "text",
            "ownerId": "text",
            "ownerName": "text",
            "sharedSecret": "text"
          },
          "external": {
            "installationId": "text"
          },
          "github": {
            "baseUrl": "text",
            "executionIdentity": {
              "appID": 1,
              "proof": "text",
              "source": "dedicated_direct"
            },
            "installationId": 1,
            "owner": "text",
            "ownerId": 1,
            "ownerType": "text"
          },
          "gitlab": {
            "baseUrl": "text",
            "groupId": 1,
            "groupName": "text",
            "oauth": true
          },
          "googleWorkspace": {
            "adminEmail": "text",
            "domain": "text",
            "serviceAccountJson": "text"
          },
          "id": "DX",
          "jira": {
            "baseUrl": "text",
            "installationId": "text",
            "ownerId": "text"
          },
          "linear": {
            "accessToken": "text",
            "clientId": "text",
            "clientSecret": "text",
            "urlKey": "text",
            "workspaceId": "text",
            "workspaceName": "text"
          },
          "okta": {
            "apiToken": "text",
            "domain": "text"
          },
          "slack": {
            "teamId": "text"
          },
          "teams": {
            "teamId": "text"
          }
        }
      }
    ],
    "msteams": {
      "channelId": "text",
      "teamId": "text"
    },
    "name": "text",
    "numMembers": 1,
    "okta": {
      "groupId": "text"
    },
    "privacy": "text",
    "provider": "DX",
    "repositories": [
      {
        "cloneURL": "text",
        "createdAt": "text",
        "defaultBranch": "text",
        "description": "text",
        "forksCount": 1,
        "fullName": "text",
        "hasIssues": true,
        "head": "text",
        "htmlURL": "text",
        "id": "text",
        "isArchived": true,
        "isFork": true,
        "isGlobalConfig": true,
        "isInitialized": true,
        "isPublic": true,
        "language": "text",
        "license": "text",
        "name": "text",
        "openIssues": 1,
        "ownerProvider": {
          "asana": {
            "accessToken": "text",
            "workspaceId": "text",
            "workspaceName": "text"
          },
          "azure": {
            "baseUrl": "text",
            "organizationId": "text",
            "organizationName": "text",
            "tenantId": "text"
          },
          "azureEntra": {
            "clientId": "text",
            "clientSecret": "text",
            "tenantId": "text"
          },
          "bitbucket": {
            "appKey": "text",
            "baseUrl": "text",
            "clientKey": "text",
            "ownerId": "text",
            "ownerName": "text",
            "sharedSecret": "text"
          },
          "external": {
            "installationId": "text"
          },
          "github": {
            "baseUrl": "text",
            "executionIdentity": {
              "appID": 1,
              "proof": "text",
              "source": "dedicated_direct"
            },
            "installationId": 1,
            "owner": "text",
            "ownerId": 1,
            "ownerType": "text"
          },
          "gitlab": {
            "baseUrl": "text",
            "groupId": 1,
            "groupName": "text",
            "oauth": true
          },
          "googleWorkspace": {
            "adminEmail": "text",
            "domain": "text",
            "serviceAccountJson": "text"
          },
          "id": "DX",
          "jira": {
            "baseUrl": "text",
            "installationId": "text",
            "ownerId": "text"
          },
          "linear": {
            "accessToken": "text",
            "clientId": "text",
            "clientSecret": "text",
            "urlKey": "text",
            "workspaceId": "text",
            "workspaceName": "text"
          },
          "okta": {
            "apiToken": "text",
            "domain": "text"
          },
          "slack": {
            "teamId": "text"
          },
          "teams": {
            "teamId": "text"
          }
        },
        "provider": {
          "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": "DX"
        },
        "pushedAt": "text",
        "repoSizeBytes": 1,
        "repoSizeGiB": 1,
        "starCount": 1,
        "topics": [
          "text"
        ],
        "updatedAt": "text",
        "visibility": "text"
      }
    ],
    "repositoryIds": [
      "text"
    ],
    "slack": {
      "groupId": "text"
    },
    "slug": "text",
    "source": "dx",
    "sourceRepositoryPropertyName": "text",
    "sourceRepositoryPropertyValue": "text",
    "ticketBoardId": "text",
    "ticketProjectProvider": {
      "asana": {
        "projectGid": "text",
        "projectName": "text",
        "teamGid": "text",
        "workspaceGid": "text"
      },
      "azure": {
        "projectName": "text"
      },
      "bitbucket": {},
      "github": {
        "repositoryId": 1,
        "repositoryName": "text",
        "repositoryNodeId": "text"
      },
      "gitlab": {},
      "id": "DX",
      "jira": {
        "id": "text",
        "projectKey": "text"
      },
      "linear": {
        "projectId": "text",
        "teamId": "text",
        "teamKey": "text"
      }
    }
  }
}

Delete a manual team

Soft-deletes a team whose source is manual. Teams from any other source return 400, because their sync owns them; to stop a synced source, turn it off with Update team source preferences. Deleting a team that is already deleted succeeds. An unknown teamID currently returns 500 rather than 404. Requires TeamManage.

Delete Manual Team

delete

Soft-delete a manually created team. Returns 400 if the team's source is not 'manual' — synced teams are managed by their sync workflow and cannot be removed individually.

Path parameters
teamIDstringRequired

The ID of the manual team to delete

Query parameters
azureOrganizationIdstringOptional

The Azure organization ID

bitbucketWorkspaceIdstringOptional

The Bitbucket workspace ID

githubOwnerIdinteger · int64Optional

The Github owner ID

githubInstallationIdinteger · int64Optional

Operator routes only: the GitHub App installation ID to use alongside githubOwnerId when the tenant's stored record has none. Ignored on customer routes.

gitlabGroupIdinteger · int64Optional

The GitLab group ID

installationIdstringOptional

The Nullify installation ID

azureRepositoryIdstring[]Optional

Filter by Azure repository IDs

githubRepositoryIdinteger · int64[]Optional

Filter by GitHub repository IDs

githubTeamIdinteger · int64Optional

Filter by GitHub team ID

bitbucketRepositoryIdstring[]Optional

Filter by Bitbucket repository IDs

Responses
200

OK

application/json
versionstringOptional
delete/admin/teams/{teamID}
DELETE /admin/teams/{teamID} HTTP/1.1
Host: api.<TENANT>.nullify.ai
Accept: */*
{
  "version": "text"
}

Merge teams

Combines two or more provider teams into one. Send sources (at least two entries, each a providerId and teamId) and, optionally, targetTeamId to merge into an existing team; without it a new manual team is created. Member ids are unioned, code ownerships are appended, ground rules are unioned, and provider ids and message and ticket settings are copied where the target has none. A source that cannot be found is skipped rather than failing the call, and source teams are left in place. The merged team is returned. Requires TeamManage.

Merge Teams

post

Merge multiple provider-specific teams into one unified team

Query parameters
azureOrganizationIdstringOptional

The Azure organization ID

bitbucketWorkspaceIdstringOptional

The Bitbucket workspace ID

githubOwnerIdinteger · int64Optional

The Github owner ID

githubInstallationIdinteger · int64Optional

Operator routes only: the GitHub App installation ID to use alongside githubOwnerId when the tenant's stored record has none. Ignored on customer routes.

gitlabGroupIdinteger · int64Optional

The GitLab group ID

installationIdstringOptional

The Nullify installation ID

azureRepositoryIdstring[]Optional

Filter by Azure repository IDs

githubRepositoryIdinteger · int64[]Optional

Filter by GitHub repository IDs

githubTeamIdinteger · int64Optional

Filter by GitHub team ID

bitbucketRepositoryIdstring[]Optional

Filter by Bitbucket repository IDs

Body
targetTeamIdstringOptional
Responses
200

OK

application/json
post/admin/teams/merge
POST /admin/teams/merge HTTP/1.1
Host: api.<TENANT>.nullify.ai
Content-Type: application/json
Accept: */*
Content-Length: 71

{
  "sources": [
    {
      "providerId": "DX",
      "teamId": "text"
    }
  ],
  "targetTeamId": "text"
}
{
  "team": {
    "azure": {
      "teamId": "text"
    },
    "codeOwnerships": [
      {
        "dataSource": "dx",
        "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": "DX"
        }
      }
    ],
    "github": {
      "orgLogin": "text",
      "teamId": 1,
      "teamSlug": "text"
    },
    "gitlab": {
      "groupId": 1
    },
    "groundRules": [
      {
        "description": "text",
        "id": "text",
        "title": "text"
      }
    ],
    "id": "text",
    "jira": {
      "teamId": "text"
    },
    "lead": {
      "asana": {
        "id": "text"
      },
      "azure": {
        "id": "text"
      },
      "azureEntra": {
        "id": "text"
      },
      "bitbucket": {
        "id": "text"
      },
      "createdAt": "text",
      "createdBy": "text",
      "deleted": true,
      "displayName": "text",
      "email": "text",
      "github": {
        "id": 1,
        "nodeId": "text"
      },
      "gitlab": {
        "id": 1
      },
      "googleWorkspace": {
        "id": "text"
      },
      "id": "text",
      "isBot": true,
      "isRestricted": true,
      "jira": {
        "id": "text",
        "name": "text"
      },
      "lastUpdatedBy": "text",
      "linear": {
        "id": "text"
      },
      "name": "text",
      "okta": {
        "id": "text"
      },
      "provider": {
        "asana": {
          "id": "text"
        },
        "azure": {
          "id": "text"
        },
        "azureEntra": {
          "id": "text"
        },
        "bitBucket": {
          "id": "text"
        },
        "gitHub": {
          "id": 1,
          "nodeId": "text"
        },
        "gitlab": {
          "id": 1
        },
        "googleWorkspace": {
          "id": "text"
        },
        "id": "DX",
        "jira": {
          "id": "text",
          "name": "text"
        },
        "linear": {
          "id": "text"
        },
        "okta": {
          "id": "text"
        },
        "slack": {
          "id": "text",
          "name": "text"
        },
        "teams": {
          "id": "text",
          "teamIDs": [
            "text"
          ]
        }
      },
      "realName": "text",
      "slack": {
        "id": "text",
        "name": "text"
      },
      "slug": "text",
      "teams": {
        "id": "text",
        "teamIDs": [
          "text"
        ]
      },
      "updatedAt": "text",
      "username": "text"
    },
    "leadId": "text",
    "linear": {
      "teamId": "text"
    },
    "memberIds": [
      "text"
    ],
    "members": [
      {
        "asana": {
          "id": "text"
        },
        "azure": {
          "id": "text"
        },
        "azureEntra": {
          "id": "text"
        },
        "bitbucket": {
          "id": "text"
        },
        "createdAt": "text",
        "createdBy": "text",
        "deleted": true,
        "displayName": "text",
        "email": "text",
        "github": {
          "id": 1,
          "nodeId": "text"
        },
        "gitlab": {
          "id": 1
        },
        "googleWorkspace": {
          "id": "text"
        },
        "id": "text",
        "isBot": true,
        "isRestricted": true,
        "jira": {
          "id": "text",
          "name": "text"
        },
        "lastUpdatedBy": "text",
        "linear": {
          "id": "text"
        },
        "name": "text",
        "okta": {
          "id": "text"
        },
        "provider": {
          "asana": {
            "id": "text"
          },
          "azure": {
            "id": "text"
          },
          "azureEntra": {
            "id": "text"
          },
          "bitBucket": {
            "id": "text"
          },
          "gitHub": {
            "id": 1,
            "nodeId": "text"
          },
          "gitlab": {
            "id": 1
          },
          "googleWorkspace": {
            "id": "text"
          },
          "id": "DX",
          "jira": {
            "id": "text",
            "name": "text"
          },
          "linear": {
            "id": "text"
          },
          "okta": {
            "id": "text"
          },
          "slack": {
            "id": "text",
            "name": "text"
          },
          "teams": {
            "id": "text",
            "teamIDs": [
              "text"
            ]
          }
        },
        "realName": "text",
        "slack": {
          "id": "text",
          "name": "text"
        },
        "slug": "text",
        "teams": {
          "id": "text",
          "teamIDs": [
            "text"
          ]
        },
        "updatedAt": "text",
        "username": "text"
      }
    ],
    "messageChannelProvider": {
      "id": "DX",
      "slack": {
        "id": "text",
        "thread_ts": "text"
      },
      "teams": {
        "channel": "text",
        "id": "text",
        "teamId": "text"
      }
    },
    "messageChannels": [
      {
        "channelProvider": {
          "id": "DX",
          "slack": {
            "id": "text",
            "thread_ts": "text"
          },
          "teams": {
            "channel": "text",
            "id": "text",
            "teamId": "text"
          }
        },
        "description": "text",
        "name": "text",
        "ownerProvider": {
          "asana": {
            "accessToken": "text",
            "workspaceId": "text",
            "workspaceName": "text"
          },
          "azure": {
            "baseUrl": "text",
            "organizationId": "text",
            "organizationName": "text",
            "tenantId": "text"
          },
          "azureEntra": {
            "clientId": "text",
            "clientSecret": "text",
            "tenantId": "text"
          },
          "bitbucket": {
            "appKey": "text",
            "baseUrl": "text",
            "clientKey": "text",
            "ownerId": "text",
            "ownerName": "text",
            "sharedSecret": "text"
          },
          "external": {
            "installationId": "text"
          },
          "github": {
            "baseUrl": "text",
            "executionIdentity": {
              "appID": 1,
              "proof": "text",
              "source": "dedicated_direct"
            },
            "installationId": 1,
            "owner": "text",
            "ownerId": 1,
            "ownerType": "text"
          },
          "gitlab": {
            "baseUrl": "text",
            "groupId": 1,
            "groupName": "text",
            "oauth": true
          },
          "googleWorkspace": {
            "adminEmail": "text",
            "domain": "text",
            "serviceAccountJson": "text"
          },
          "id": "DX",
          "jira": {
            "baseUrl": "text",
            "installationId": "text",
            "ownerId": "text"
          },
          "linear": {
            "accessToken": "text",
            "clientId": "text",
            "clientSecret": "text",
            "urlKey": "text",
            "workspaceId": "text",
            "workspaceName": "text"
          },
          "okta": {
            "apiToken": "text",
            "domain": "text"
          },
          "slack": {
            "teamId": "text"
          },
          "teams": {
            "teamId": "text"
          }
        }
      }
    ],
    "msteams": {
      "channelId": "text",
      "teamId": "text"
    },
    "name": "text",
    "numMembers": 1,
    "okta": {
      "groupId": "text"
    },
    "privacy": "text",
    "provider": "DX",
    "repositories": [
      {
        "cloneURL": "text",
        "createdAt": "text",
        "defaultBranch": "text",
        "description": "text",
        "forksCount": 1,
        "fullName": "text",
        "hasIssues": true,
        "head": "text",
        "htmlURL": "text",
        "id": "text",
        "isArchived": true,
        "isFork": true,
        "isGlobalConfig": true,
        "isInitialized": true,
        "isPublic": true,
        "language": "text",
        "license": "text",
        "name": "text",
        "openIssues": 1,
        "ownerProvider": {
          "asana": {
            "accessToken": "text",
            "workspaceId": "text",
            "workspaceName": "text"
          },
          "azure": {
            "baseUrl": "text",
            "organizationId": "text",
            "organizationName": "text",
            "tenantId": "text"
          },
          "azureEntra": {
            "clientId": "text",
            "clientSecret": "text",
            "tenantId": "text"
          },
          "bitbucket": {
            "appKey": "text",
            "baseUrl": "text",
            "clientKey": "text",
            "ownerId": "text",
            "ownerName": "text",
            "sharedSecret": "text"
          },
          "external": {
            "installationId": "text"
          },
          "github": {
            "baseUrl": "text",
            "executionIdentity": {
              "appID": 1,
              "proof": "text",
              "source": "dedicated_direct"
            },
            "installationId": 1,
            "owner": "text",
            "ownerId": 1,
            "ownerType": "text"
          },
          "gitlab": {
            "baseUrl": "text",
            "groupId": 1,
            "groupName": "text",
            "oauth": true
          },
          "googleWorkspace": {
            "adminEmail": "text",
            "domain": "text",
            "serviceAccountJson": "text"
          },
          "id": "DX",
          "jira": {
            "baseUrl": "text",
            "installationId": "text",
            "ownerId": "text"
          },
          "linear": {
            "accessToken": "text",
            "clientId": "text",
            "clientSecret": "text",
            "urlKey": "text",
            "workspaceId": "text",
            "workspaceName": "text"
          },
          "okta": {
            "apiToken": "text",
            "domain": "text"
          },
          "slack": {
            "teamId": "text"
          },
          "teams": {
            "teamId": "text"
          }
        },
        "provider": {
          "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": "DX"
        },
        "pushedAt": "text",
        "repoSizeBytes": 1,
        "repoSizeGiB": 1,
        "starCount": 1,
        "topics": [
          "text"
        ],
        "updatedAt": "text",
        "visibility": "text"
      }
    ],
    "repositoryIds": [
      "text"
    ],
    "slack": {
      "groupId": "text"
    },
    "slug": "text",
    "source": "dx",
    "sourceRepositoryPropertyName": "text",
    "sourceRepositoryPropertyValue": "text",
    "ticketBoardId": "text",
    "ticketProjectProvider": {
      "asana": {
        "projectGid": "text",
        "projectName": "text",
        "teamGid": "text",
        "workspaceGid": "text"
      },
      "azure": {
        "projectName": "text"
      },
      "bitbucket": {},
      "github": {
        "repositoryId": 1,
        "repositoryName": "text",
        "repositoryNodeId": "text"
      },
      "gitlab": {},
      "id": "DX",
      "jira": {
        "id": "text",
        "projectKey": "text"
      },
      "linear": {
        "projectId": "text",
        "teamId": "text",
        "teamKey": "text"
      }
    }
  }
}

Create or update a Compass team

Imports a team from Atlassian Compass. displayName is required, and teamKey (the Compass team key) and providerId are also required even though the schema does not mark them so; missing values return 400. lead and members are stored as users under the Jira provider using the strings you send as their name and username, and repositories accepts owner/repo, owner/repo.git, GitHub tree or blob URLs (the sub-path becomes a glob pattern) and git@host:owner/repo SSH forms. Repositories that are malformed or not installed in your connected GitHub app are skipped. A team with the same name under Jira is updated in place, otherwise teamKey becomes the team id; its Compass code ownerships are replaced with the ones you send. If you send no lead, members or repositories, nothing is created and the call returns 200 with no team. When the call changes the team's code ownerships or members, a background re-sync of finding mappings is started on a best-effort basis; re-sending an unchanged team starts none. Internal automation (agents) cannot send a lead, members or repositories and receives 403. Requires TeamManage.

Post Compass/Atlassian Team

post

Adapt a Compass/Atlassian‐style payload into our in‐house Team model and upsert users and repositories. A lead, members or repositories add team members and make the team the owner of repositories, which need a person: internal automation (agents) cannot send them and is refused

Query parameters
azureOrganizationIdstringOptional

The Azure organization ID

bitbucketWorkspaceIdstringOptional

The Bitbucket workspace ID

githubOwnerIdinteger · int64Optional

The Github owner ID

githubInstallationIdinteger · int64Optional

Operator routes only: the GitHub App installation ID to use alongside githubOwnerId when the tenant's stored record has none. Ignored on customer routes.

gitlabGroupIdinteger · int64Optional

The GitLab group ID

installationIdstringOptional

The Nullify installation ID

azureRepositoryIdstring[]Optional

Filter by Azure repository IDs

githubRepositoryIdinteger · int64[]Optional

Filter by GitHub repository IDs

githubTeamIdinteger · int64Optional

Filter by GitHub team ID

bitbucketRepositoryIdstring[]Optional

Filter by Bitbucket repository IDs

Body
displayNamestringRequired

Team display name

leadstringRequired

Atlassian accountId of the team lead

membersstring[] · nullableRequired

List of Atlassian accountIds for team members

providerIdstring · enumOptionalPossible values:
repositoriesstring[] · nullableRequired

List of repo URLs (owner/repo)

teamKeystringOptional

Compass/Atlassian team key (unique identifier)

Responses
200

OK

application/json
post/admin/teams/compass
POST /admin/teams/compass HTTP/1.1
Host: api.<TENANT>.nullify.ai
Content-Type: application/json
Accept: */*
Content-Length: 114

{
  "displayName": "text",
  "lead": "text",
  "members": [
    "text"
  ],
  "providerId": "DX",
  "repositories": [
    "text"
  ],
  "teamKey": "text"
}
{
  "team": {
    "azure": {
      "teamId": "text"
    },
    "codeOwnerships": [
      {
        "dataSource": "dx",
        "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": "DX"
        }
      }
    ],
    "github": {
      "orgLogin": "text",
      "teamId": 1,
      "teamSlug": "text"
    },
    "gitlab": {
      "groupId": 1
    },
    "groundRules": [
      {
        "description": "text",
        "id": "text",
        "title": "text"
      }
    ],
    "id": "text",
    "jira": {
      "teamId": "text"
    },
    "lead": {
      "asana": {
        "id": "text"
      },
      "azure": {
        "id": "text"
      },
      "azureEntra": {
        "id": "text"
      },
      "bitbucket": {
        "id": "text"
      },
      "createdAt": "text",
      "createdBy": "text",
      "deleted": true,
      "displayName": "text",
      "email": "text",
      "github": {
        "id": 1,
        "nodeId": "text"
      },
      "gitlab": {
        "id": 1
      },
      "googleWorkspace": {
        "id": "text"
      },
      "id": "text",
      "isBot": true,
      "isRestricted": true,
      "jira": {
        "id": "text",
        "name": "text"
      },
      "lastUpdatedBy": "text",
      "linear": {
        "id": "text"
      },
      "name": "text",
      "okta": {
        "id": "text"
      },
      "provider": {
        "asana": {
          "id": "text"
        },
        "azure": {
          "id": "text"
        },
        "azureEntra": {
          "id": "text"
        },
        "bitBucket": {
          "id": "text"
        },
        "gitHub": {
          "id": 1,
          "nodeId": "text"
        },
        "gitlab": {
          "id": 1
        },
        "googleWorkspace": {
          "id": "text"
        },
        "id": "DX",
        "jira": {
          "id": "text",
          "name": "text"
        },
        "linear": {
          "id": "text"
        },
        "okta": {
          "id": "text"
        },
        "slack": {
          "id": "text",
          "name": "text"
        },
        "teams": {
          "id": "text",
          "teamIDs": [
            "text"
          ]
        }
      },
      "realName": "text",
      "slack": {
        "id": "text",
        "name": "text"
      },
      "slug": "text",
      "teams": {
        "id": "text",
        "teamIDs": [
          "text"
        ]
      },
      "updatedAt": "text",
      "username": "text"
    },
    "leadId": "text",
    "linear": {
      "teamId": "text"
    },
    "memberIds": [
      "text"
    ],
    "members": [
      {
        "asana": {
          "id": "text"
        },
        "azure": {
          "id": "text"
        },
        "azureEntra": {
          "id": "text"
        },
        "bitbucket": {
          "id": "text"
        },
        "createdAt": "text",
        "createdBy": "text",
        "deleted": true,
        "displayName": "text",
        "email": "text",
        "github": {
          "id": 1,
          "nodeId": "text"
        },
        "gitlab": {
          "id": 1
        },
        "googleWorkspace": {
          "id": "text"
        },
        "id": "text",
        "isBot": true,
        "isRestricted": true,
        "jira": {
          "id": "text",
          "name": "text"
        },
        "lastUpdatedBy": "text",
        "linear": {
          "id": "text"
        },
        "name": "text",
        "okta": {
          "id": "text"
        },
        "provider": {
          "asana": {
            "id": "text"
          },
          "azure": {
            "id": "text"
          },
          "azureEntra": {
            "id": "text"
          },
          "bitBucket": {
            "id": "text"
          },
          "gitHub": {
            "id": 1,
            "nodeId": "text"
          },
          "gitlab": {
            "id": 1
          },
          "googleWorkspace": {
            "id": "text"
          },
          "id": "DX",
          "jira": {
            "id": "text",
            "name": "text"
          },
          "linear": {
            "id": "text"
          },
          "okta": {
            "id": "text"
          },
          "slack": {
            "id": "text",
            "name": "text"
          },
          "teams": {
            "id": "text",
            "teamIDs": [
              "text"
            ]
          }
        },
        "realName": "text",
        "slack": {
          "id": "text",
          "name": "text"
        },
        "slug": "text",
        "teams": {
          "id": "text",
          "teamIDs": [
            "text"
          ]
        },
        "updatedAt": "text",
        "username": "text"
      }
    ],
    "messageChannelProvider": {
      "id": "DX",
      "slack": {
        "id": "text",
        "thread_ts": "text"
      },
      "teams": {
        "channel": "text",
        "id": "text",
        "teamId": "text"
      }
    },
    "messageChannels": [
      {
        "channelProvider": {
          "id": "DX",
          "slack": {
            "id": "text",
            "thread_ts": "text"
          },
          "teams": {
            "channel": "text",
            "id": "text",
            "teamId": "text"
          }
        },
        "description": "text",
        "name": "text",
        "ownerProvider": {
          "asana": {
            "accessToken": "text",
            "workspaceId": "text",
            "workspaceName": "text"
          },
          "azure": {
            "baseUrl": "text",
            "organizationId": "text",
            "organizationName": "text",
            "tenantId": "text"
          },
          "azureEntra": {
            "clientId": "text",
            "clientSecret": "text",
            "tenantId": "text"
          },
          "bitbucket": {
            "appKey": "text",
            "baseUrl": "text",
            "clientKey": "text",
            "ownerId": "text",
            "ownerName": "text",
            "sharedSecret": "text"
          },
          "external": {
            "installationId": "text"
          },
          "github": {
            "baseUrl": "text",
            "executionIdentity": {
              "appID": 1,
              "proof": "text",
              "source": "dedicated_direct"
            },
            "installationId": 1,
            "owner": "text",
            "ownerId": 1,
            "ownerType": "text"
          },
          "gitlab": {
            "baseUrl": "text",
            "groupId": 1,
            "groupName": "text",
            "oauth": true
          },
          "googleWorkspace": {
            "adminEmail": "text",
            "domain": "text",
            "serviceAccountJson": "text"
          },
          "id": "DX",
          "jira": {
            "baseUrl": "text",
            "installationId": "text",
            "ownerId": "text"
          },
          "linear": {
            "accessToken": "text",
            "clientId": "text",
            "clientSecret": "text",
            "urlKey": "text",
            "workspaceId": "text",
            "workspaceName": "text"
          },
          "okta": {
            "apiToken": "text",
            "domain": "text"
          },
          "slack": {
            "teamId": "text"
          },
          "teams": {
            "teamId": "text"
          }
        }
      }
    ],
    "msteams": {
      "channelId": "text",
      "teamId": "text"
    },
    "name": "text",
    "numMembers": 1,
    "okta": {
      "groupId": "text"
    },
    "privacy": "text",
    "provider": "DX",
    "repositories": [
      {
        "cloneURL": "text",
        "createdAt": "text",
        "defaultBranch": "text",
        "description": "text",
        "forksCount": 1,
        "fullName": "text",
        "hasIssues": true,
        "head": "text",
        "htmlURL": "text",
        "id": "text",
        "isArchived": true,
        "isFork": true,
        "isGlobalConfig": true,
        "isInitialized": true,
        "isPublic": true,
        "language": "text",
        "license": "text",
        "name": "text",
        "openIssues": 1,
        "ownerProvider": {
          "asana": {
            "accessToken": "text",
            "workspaceId": "text",
            "workspaceName": "text"
          },
          "azure": {
            "baseUrl": "text",
            "organizationId": "text",
            "organizationName": "text",
            "tenantId": "text"
          },
          "azureEntra": {
            "clientId": "text",
            "clientSecret": "text",
            "tenantId": "text"
          },
          "bitbucket": {
            "appKey": "text",
            "baseUrl": "text",
            "clientKey": "text",
            "ownerId": "text",
            "ownerName": "text",
            "sharedSecret": "text"
          },
          "external": {
            "installationId": "text"
          },
          "github": {
            "baseUrl": "text",
            "executionIdentity": {
              "appID": 1,
              "proof": "text",
              "source": "dedicated_direct"
            },
            "installationId": 1,
            "owner": "text",
            "ownerId": 1,
            "ownerType": "text"
          },
          "gitlab": {
            "baseUrl": "text",
            "groupId": 1,
            "groupName": "text",
            "oauth": true
          },
          "googleWorkspace": {
            "adminEmail": "text",
            "domain": "text",
            "serviceAccountJson": "text"
          },
          "id": "DX",
          "jira": {
            "baseUrl": "text",
            "installationId": "text",
            "ownerId": "text"
          },
          "linear": {
            "accessToken": "text",
            "clientId": "text",
            "clientSecret": "text",
            "urlKey": "text",
            "workspaceId": "text",
            "workspaceName": "text"
          },
          "okta": {
            "apiToken": "text",
            "domain": "text"
          },
          "slack": {
            "teamId": "text"
          },
          "teams": {
            "teamId": "text"
          }
        },
        "provider": {
          "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": "DX"
        },
        "pushedAt": "text",
        "repoSizeBytes": 1,
        "repoSizeGiB": 1,
        "starCount": 1,
        "topics": [
          "text"
        ],
        "updatedAt": "text",
        "visibility": "text"
      }
    ],
    "repositoryIds": [
      "text"
    ],
    "slack": {
      "groupId": "text"
    },
    "slug": "text",
    "source": "dx",
    "sourceRepositoryPropertyName": "text",
    "sourceRepositoryPropertyValue": "text",
    "ticketBoardId": "text",
    "ticketProjectProvider": {
      "asana": {
        "projectGid": "text",
        "projectName": "text",
        "teamGid": "text",
        "workspaceGid": "text"
      },
      "azure": {
        "projectName": "text"
      },
      "bitbucket": {},
      "github": {
        "repositoryId": 1,
        "repositoryName": "text",
        "repositoryNodeId": "text"
      },
      "gitlab": {},
      "id": "DX",
      "jira": {
        "id": "text",
        "projectKey": "text"
      },
      "linear": {
        "projectId": "text",
        "teamId": "text",
        "teamKey": "text"
      }
    }
  }
}

Make a team the owner of a repository

Makes the team the only manual code owner of an entire repository. Send repositoryId in the body; it is a repository id from Repositories and Code. Other teams' manual ownership of that repository is replaced in one transaction, ownership produced by a provider sync or a code owners file is untouched, and the manual ownership survives later syncs. Returns 404 if the team or repository does not exist in your workspace, and 403 for internal automation, which cannot make this change. A background re-sync of finding-to-team mappings is queued and the change is audit logged. Requires TeamManage.

Make Team The Owner Of A Repository

post

Make the team the only manual code owner of the whole repository. Any other team's manual ownership of the repository is replaced in the same transaction; ownerships the provider sync or a code owners file produced are untouched, and the manual ownership survives every sync. The caller is recorded as the ownership's author. Dashboard users and the operator CLI may; internal automation (agents) is refused

Path parameters
teamIDstringRequired

The team that becomes the repository's manual owner

Query parameters
azureOrganizationIdstringOptional

The Azure organization ID

bitbucketWorkspaceIdstringOptional

The Bitbucket workspace ID

githubOwnerIdinteger · int64Optional

The Github owner ID

githubInstallationIdinteger · int64Optional

Operator routes only: the GitHub App installation ID to use alongside githubOwnerId when the tenant's stored record has none. Ignored on customer routes.

gitlabGroupIdinteger · int64Optional

The GitLab group ID

installationIdstringOptional

The Nullify installation ID

azureRepositoryIdstring[]Optional

Filter by Azure repository IDs

githubRepositoryIdinteger · int64[]Optional

Filter by GitHub repository IDs

githubTeamIdinteger · int64Optional

Filter by GitHub team ID

bitbucketRepositoryIdstring[]Optional

Filter by Bitbucket repository IDs

Body
actorstringOptional

Who an internal service call acted for; ignored on any other call

repositoryIdstringRequired

The repository the team owns

Responses
200

OK

application/json
repositoryIdstringRequired
teamIdstringRequired
versionstringRequired
post/admin/teams/{teamID}/code-ownership
POST /admin/teams/{teamID}/code-ownership HTTP/1.1
Host: api.<TENANT>.nullify.ai
Content-Type: application/json
Accept: */*
Content-Length: 38

{
  "actor": "text",
  "repositoryId": "text"
}
{
  "repositoryId": "text",
  "teamId": "text",
  "version": "text"
}

Download the Microsoft Teams app package

Despite its path, this is not part of team ownership: it builds the Microsoft Teams chat app package (manifest and icons) for your Nullify Teams bot, uploads it, and returns a time-limited presignedUrl for downloading the zip. Use it when installing the Nullify app in Microsoft Teams. Requires TeamManage.

Get Teams App Zip

get

Generate and download a Microsoft Teams app package with manifest and icons

Query parameters
azureOrganizationIdstringOptional

The Azure organization ID

bitbucketWorkspaceIdstringOptional

The Bitbucket workspace ID

githubOwnerIdinteger · int64Optional

The Github owner ID

githubInstallationIdinteger · int64Optional

Operator routes only: the GitHub App installation ID to use alongside githubOwnerId when the tenant's stored record has none. Ignored on customer routes.

gitlabGroupIdinteger · int64Optional

The GitLab group ID

installationIdstringOptional

The Nullify installation ID

azureRepositoryIdstring[]Optional

Filter by Azure repository IDs

githubRepositoryIdinteger · int64[]Optional

Filter by GitHub repository IDs

githubTeamIdinteger · int64Optional

Filter by GitHub team ID

bitbucketRepositoryIdstring[]Optional

Filter by Bitbucket repository IDs

Responses
200

OK

application/json
presignedUrlstringRequired
get/admin/teams/appzip
GET /admin/teams/appzip HTTP/1.1
Host: api.<TENANT>.nullify.ai
Accept: */*
{
  "presignedUrl": "text"
}

Team sources and sync

Teams are created automatically from GitHub Teams and from repository custom properties. These operations switch each source on or off, choose which repository properties define teams, and start or inspect sync runs.

Get team source preferences

Returns whether the github_teams and repository_property sources are enabled. If preferences were never saved, both are enabled. Manual teams are always available and have no toggle. Requires ConfigRead.

Get Team Source Preferences

get

Read the per-tenant on/off state of the auto-sync team sources (GitHub Teams, repository custom properties). Manual teams are always available and have no toggle.

Query parameters
azureOrganizationIdstringOptional

The Azure organization ID

bitbucketWorkspaceIdstringOptional

The Bitbucket workspace ID

githubOwnerIdinteger · int64Optional

The Github owner ID

githubInstallationIdinteger · int64Optional

Operator routes only: the GitHub App installation ID to use alongside githubOwnerId when the tenant's stored record has none. Ignored on customer routes.

gitlabGroupIdinteger · int64Optional

The GitLab group ID

installationIdstringOptional

The Nullify installation ID

azureRepositoryIdstring[]Optional

Filter by Azure repository IDs

githubRepositoryIdinteger · int64[]Optional

Filter by GitHub repository IDs

githubTeamIdinteger · int64Optional

Filter by GitHub team ID

bitbucketRepositoryIdstring[]Optional

Filter by Bitbucket repository IDs

Responses
200

OK

application/json
versionstringOptional
get/admin/team-source-preferences
GET /admin/team-source-preferences HTTP/1.1
Host: api.<TENANT>.nullify.ai
Accept: */*
{
  "preferences": {
    "githubTeamsEnabled": true,
    "repositoryPropertyEnabled": true,
    "tenantId": "text",
    "updatedAt": "2026-01-01T00:00:00.000Z"
  },
  "version": "text"
}

Update team source preferences

Sets githubTeamsEnabled and repositoryPropertyEnabled; both are required, so send the full state. Turning a source off hides every team from that source, and turning it back on restores them and starts a sync for that source. The response includes syncQueued, which is false when a sync was needed but could not be started; the daily sync then catches up. Concurrent updates for a tenant are serialized. Requires TeamManage.

Update Team Source Preferences

put

Enable or disable each auto-sync team source for this tenant. Disabling a source soft-hides every existing team for that source; re-enabling restores them and triggers a teams-only sync so any upstream changes are picked up immediately.

Query parameters
azureOrganizationIdstringOptional

The Azure organization ID

bitbucketWorkspaceIdstringOptional

The Bitbucket workspace ID

githubOwnerIdinteger · int64Optional

The Github owner ID

githubInstallationIdinteger · int64Optional

Operator routes only: the GitHub App installation ID to use alongside githubOwnerId when the tenant's stored record has none. Ignored on customer routes.

gitlabGroupIdinteger · int64Optional

The GitLab group ID

installationIdstringOptional

The Nullify installation ID

azureRepositoryIdstring[]Optional

Filter by Azure repository IDs

githubRepositoryIdinteger · int64[]Optional

Filter by GitHub repository IDs

githubTeamIdinteger · int64Optional

Filter by GitHub team ID

bitbucketRepositoryIdstring[]Optional

Filter by Bitbucket repository IDs

Body
githubTeamsEnabledbooleanRequired
repositoryPropertyEnabledbooleanRequired
Responses
200

OK

application/json
syncQueuedbooleanRequired
versionstringOptional
put/admin/team-source-preferences
PUT /admin/team-source-preferences HTTP/1.1
Host: api.<TENANT>.nullify.ai
Content-Type: application/json
Accept: */*
Content-Length: 60

{
  "githubTeamsEnabled": true,
  "repositoryPropertyEnabled": true
}
{
  "preferences": {
    "githubTeamsEnabled": true,
    "repositoryPropertyEnabled": true,
    "tenantId": "text",
    "updatedAt": "2026-01-01T00:00:00.000Z"
  },
  "syncQueued": true,
  "version": "text"
}

List repository property team keys

Lists the repository custom property names that this tenant uses to derive teams, one team per distinct property value. Requires TeamManage.

List Repository Property Team Keys

get

List the repository property keys this tenant uses to derive teams from repository metadata.

Query parameters
azureOrganizationIdstringOptional

The Azure organization ID

bitbucketWorkspaceIdstringOptional

The Bitbucket workspace ID

githubOwnerIdinteger · int64Optional

The Github owner ID

githubInstallationIdinteger · int64Optional

Operator routes only: the GitHub App installation ID to use alongside githubOwnerId when the tenant's stored record has none. Ignored on customer routes.

gitlabGroupIdinteger · int64Optional

The GitLab group ID

installationIdstringOptional

The Nullify installation ID

azureRepositoryIdstring[]Optional

Filter by Azure repository IDs

githubRepositoryIdinteger · int64[]Optional

Filter by GitHub repository IDs

githubTeamIdinteger · int64Optional

Filter by GitHub team ID

bitbucketRepositoryIdstring[]Optional

Filter by Bitbucket repository IDs

Responses
200

OK

application/json
versionstringOptional
get/admin/repository-property-team-keys
GET /admin/repository-property-team-keys HTTP/1.1
Host: api.<TENANT>.nullify.ai
Accept: */*
{
  "keys": [
    {
      "createdAt": "2026-01-01T00:00:00.000Z",
      "id": "text",
      "propertyKey": "text",
      "providerId": "DX",
      "tenantId": "text",
      "updatedAt": "2026-01-01T00:00:00.000Z"
    }
  ],
  "version": "text"
}

Create a repository property team key

Adds a property name that defines teams. providerId and propertyKey are required (the key is trimmed and at most 256 characters). A key already configured for the provider returns 409. A repository-property sync is started in the background; poll List team sync runs to follow it. Requires TeamManage.

Create Repository Property Team Key

post

Configure a repository property key that should drive team derivation for this tenant. The next sync run will create teams from the distinct values seen for this property.

Query parameters
azureOrganizationIdstringOptional

The Azure organization ID

bitbucketWorkspaceIdstringOptional

The Bitbucket workspace ID

githubOwnerIdinteger · int64Optional

The Github owner ID

githubInstallationIdinteger · int64Optional

Operator routes only: the GitHub App installation ID to use alongside githubOwnerId when the tenant's stored record has none. Ignored on customer routes.

gitlabGroupIdinteger · int64Optional

The GitLab group ID

installationIdstringOptional

The Nullify installation ID

azureRepositoryIdstring[]Optional

Filter by Azure repository IDs

githubRepositoryIdinteger · int64[]Optional

Filter by GitHub repository IDs

githubTeamIdinteger · int64Optional

Filter by GitHub team ID

bitbucketRepositoryIdstring[]Optional

Filter by Bitbucket repository IDs

Body
propertyKeystringRequired
providerIdstring · enumRequiredPossible values:
Responses
200

OK

application/json
versionstringOptional
post/admin/repository-property-team-keys
POST /admin/repository-property-team-keys HTTP/1.1
Host: api.<TENANT>.nullify.ai
Content-Type: application/json
Accept: */*
Content-Length: 40

{
  "propertyKey": "text",
  "providerId": "DX"
}
{
  "key": {
    "createdAt": "2026-01-01T00:00:00.000Z",
    "id": "text",
    "propertyKey": "text",
    "providerId": "DX",
    "tenantId": "text",
    "updatedAt": "2026-01-01T00:00:00.000Z"
  },
  "version": "text"
}

Delete a repository property team key

Removes a property key, identified by the keyId query parameter (the id from List repository property team keys). Returns 404 if it does not exist. Teams derived from that property that no longer own anything are cleaned up by the sync run this call starts. Requires TeamManage.

Delete Repository Property Team Key

delete

Remove a repository property key from the tenant's team-derivation configuration. Property-derived teams without any remaining ownership rows are cleaned up by the next sync run.

Query parameters
keyIdstringOptional

The repository property team key ID

azureOrganizationIdstringOptional

The Azure organization ID

bitbucketWorkspaceIdstringOptional

The Bitbucket workspace ID

githubOwnerIdinteger · int64Optional

The Github owner ID

githubInstallationIdinteger · int64Optional

Operator routes only: the GitHub App installation ID to use alongside githubOwnerId when the tenant's stored record has none. Ignored on customer routes.

gitlabGroupIdinteger · int64Optional

The GitLab group ID

installationIdstringOptional

The Nullify installation ID

azureRepositoryIdstring[]Optional

Filter by Azure repository IDs

githubRepositoryIdinteger · int64[]Optional

Filter by GitHub repository IDs

githubTeamIdinteger · int64Optional

Filter by GitHub team ID

bitbucketRepositoryIdstring[]Optional

Filter by Bitbucket repository IDs

Responses
200

OK

application/json
versionstringOptional
delete/admin/repository-property-team-keys
DELETE /admin/repository-property-team-keys HTTP/1.1
Host: api.<TENANT>.nullify.ai
Accept: */*
{
  "version": "text"
}

List team sync runs

Returns recent team sync runs for your workspace, newest first. Filter with source (github_teams, repository_property, manual, atlassian_compass or identity_provider; anything else returns 400). limit defaults to 10 and is capped at 100. Each run has a status, startedAt, optional completedAt and errorMessage, and triggeredBy. Use it to see whether a sync you started is still running. Requires TeamManage.

List Team Sync Runs

get

Most-recent team-sync workflow runs for this tenant, newest first. The UI polls this to show in-flight / last-sync state on the Configure > Teams page.

Query parameters
sourcestringOptional
limitinteger · int32Optional
azureOrganizationIdstringOptional

The Azure organization ID

bitbucketWorkspaceIdstringOptional

The Bitbucket workspace ID

githubOwnerIdinteger · int64Optional

The Github owner ID

githubInstallationIdinteger · int64Optional

Operator routes only: the GitHub App installation ID to use alongside githubOwnerId when the tenant's stored record has none. Ignored on customer routes.

gitlabGroupIdinteger · int64Optional

The GitLab group ID

installationIdstringOptional

The Nullify installation ID

azureRepositoryIdstring[]Optional

Filter by Azure repository IDs

githubRepositoryIdinteger · int64[]Optional

Filter by GitHub repository IDs

githubTeamIdinteger · int64Optional

Filter by GitHub team ID

bitbucketRepositoryIdstring[]Optional

Filter by Bitbucket repository IDs

Responses
200

OK

application/json
versionstringOptional
get/admin/team-sync-runs
GET /admin/team-sync-runs HTTP/1.1
Host: api.<TENANT>.nullify.ai
Accept: */*
{
  "runs": [
    {
      "completedAt": "2026-01-01T00:00:00.000Z",
      "errorMessage": "text",
      "id": "text",
      "source": "dx",
      "startedAt": "2026-01-01T00:00:00.000Z",
      "status": "text",
      "tenantId": "text",
      "triggeredBy": "text"
    }
  ],
  "version": "text"
}

Trigger a team sync

Asks for a team sync run. Omit source to cover both github_teams and repository_property, or set it to one of those two; other sources return 400 because they cannot be synced on demand. If a run for that source is already pending or running, nothing new starts. The response lists the latest run for each requested source, so a success means a run was requested, not that it finished; poll List team sync runs. Requires TeamManage.

Trigger Team Sync

post

Manually request a team-sync workflow run. Subject to dedup: if a pending or running run already exists for the tenant + source, this is a no-op and the existing run is returned.

Query parameters
azureOrganizationIdstringOptional

The Azure organization ID

bitbucketWorkspaceIdstringOptional

The Bitbucket workspace ID

githubOwnerIdinteger · int64Optional

The Github owner ID

githubInstallationIdinteger · int64Optional

Operator routes only: the GitHub App installation ID to use alongside githubOwnerId when the tenant's stored record has none. Ignored on customer routes.

gitlabGroupIdinteger · int64Optional

The GitLab group ID

installationIdstringOptional

The Nullify installation ID

azureRepositoryIdstring[]Optional

Filter by Azure repository IDs

githubRepositoryIdinteger · int64[]Optional

Filter by GitHub repository IDs

githubTeamIdinteger · int64Optional

Filter by GitHub team ID

bitbucketRepositoryIdstring[]Optional

Filter by Bitbucket repository IDs

Body
sourcestringOptional
Responses
200

OK

application/json
versionstringOptional
post/admin/team-sync-runs
POST /admin/team-sync-runs HTTP/1.1
Host: api.<TENANT>.nullify.ai
Content-Type: application/json
Accept: */*
Content-Length: 17

{
  "source": "text"
}
{
  "runs": [
    {
      "completedAt": "2026-01-01T00:00:00.000Z",
      "errorMessage": "text",
      "id": "text",
      "source": "dx",
      "startedAt": "2026-01-01T00:00:00.000Z",
      "status": "text",
      "tenantId": "text",
      "triggeredBy": "text"
    }
  ],
  "version": "text"
}

Team findings

Findings are mapped to teams by matching repository ownership, code owners files and team membership, or by a manual assignment. Viewers who are limited to their own teams only see mappings and counts for teams they belong to.

List findings mapped to every team

Returns each team with its mapped findings. The response is not paginated: it loads up to 1,000 teams and every mapping for each, so it can be large. Prefer Get findings for a team. Requires FindingRead.

Get All Team Findings mapping

get

Get a list of teams with their mapped findings.

Query parameters
azureOrganizationIdstringOptional

The Azure organization ID

bitbucketWorkspaceIdstringOptional

The Bitbucket workspace ID

githubOwnerIdinteger · int64Optional

The Github owner ID

githubInstallationIdinteger · int64Optional

Operator routes only: the GitHub App installation ID to use alongside githubOwnerId when the tenant's stored record has none. Ignored on customer routes.

gitlabGroupIdinteger · int64Optional

The GitLab group ID

installationIdstringOptional

The Nullify installation ID

azureRepositoryIdstring[]Optional

Filter by Azure repository IDs

githubRepositoryIdinteger · int64[]Optional

Filter by GitHub repository IDs

githubTeamIdinteger · int64Optional

Filter by GitHub team ID

bitbucketRepositoryIdstring[]Optional

Filter by Bitbucket repository IDs

Responses
200

OK

application/json
versionstringOptional
get/admin/teams/findings
GET /admin/teams/findings HTTP/1.1
Host: api.<TENANT>.nullify.ai
Accept: */*
{
  "teamFindings": [
    {
      "findings": [
        {
          "findingType": "Unknown",
          "id": "text",
          "matchSource": "codeowners_team",
          "matchSourceUserID": "text",
          "resolved": true,
          "slaBreached": true,
          "teamID": "text"
        }
      ],
      "team": {
        "azure": {
          "teamId": "text"
        },
        "codeOwnerships": [
          {
            "dataSource": "dx",
            "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": "DX"
            }
          }
        ],
        "github": {
          "orgLogin": "text",
          "teamId": 1,
          "teamSlug": "text"
        },
        "gitlab": {
          "groupId": 1
        },
        "groundRules": [
          {
            "description": "text",
            "id": "text",
            "title": "text"
          }
        ],
        "id": "text",
        "jira": {
          "teamId": "text"
        },
        "lead": {
          "asana": {
            "id": "text"
          },
          "azure": {
            "id": "text"
          },
          "azureEntra": {
            "id": "text"
          },
          "bitbucket": {
            "id": "text"
          },
          "createdAt": "text",
          "createdBy": "text",
          "deleted": true,
          "displayName": "text",
          "email": "text",
          "github": {
            "id": 1,
            "nodeId": "text"
          },
          "gitlab": {
            "id": 1
          },
          "googleWorkspace": {
            "id": "text"
          },
          "id": "text",
          "isBot": true,
          "isRestricted": true,
          "jira": {
            "id": "text",
            "name": "text"
          },
          "lastUpdatedBy": "text",
          "linear": {
            "id": "text"
          },
          "name": "text",
          "okta": {
            "id": "text"
          },
          "provider": {
            "asana": {
              "id": "text"
            },
            "azure": {
              "id": "text"
            },
            "azureEntra": {
              "id": "text"
            },
            "bitBucket": {
              "id": "text"
            },
            "gitHub": {
              "id": 1,
              "nodeId": "text"
            },
            "gitlab": {
              "id": 1
            },
            "googleWorkspace": {
              "id": "text"
            },
            "id": "DX",
            "jira": {
              "id": "text",
              "name": "text"
            },
            "linear": {
              "id": "text"
            },
            "okta": {
              "id": "text"
            },
            "slack": {
              "id": "text",
              "name": "text"
            },
            "teams": {
              "id": "text",
              "teamIDs": [
                "text"
              ]
            }
          },
          "realName": "text",
          "slack": {
            "id": "text",
            "name": "text"
          },
          "slug": "text",
          "teams": {
            "id": "text",
            "teamIDs": [
              "text"
            ]
          },
          "updatedAt": "text",
          "username": "text"
        },
        "leadId": "text",
        "linear": {
          "teamId": "text"
        },
        "memberIds": [
          "text"
        ],
        "members": [
          {
            "asana": {
              "id": "text"
            },
            "azure": {
              "id": "text"
            },
            "azureEntra": {
              "id": "text"
            },
            "bitbucket": {
              "id": "text"
            },
            "createdAt": "text",
            "createdBy": "text",
            "deleted": true,
            "displayName": "text",
            "email": "text",
            "github": {
              "id": 1,
              "nodeId": "text"
            },
            "gitlab": {
              "id": 1
            },
            "googleWorkspace": {
              "id": "text"
            },
            "id": "text",
            "isBot": true,
            "isRestricted": true,
            "jira": {
              "id": "text",
              "name": "text"
            },
            "lastUpdatedBy": "text",
            "linear": {
              "id": "text"
            },
            "name": "text",
            "okta": {
              "id": "text"
            },
            "provider": {
              "asana": {
                "id": "text"
              },
              "azure": {
                "id": "text"
              },
              "azureEntra": {
                "id": "text"
              },
              "bitBucket": {
                "id": "text"
              },
              "gitHub": {
                "id": 1,
                "nodeId": "text"
              },
              "gitlab": {
                "id": 1
              },
              "googleWorkspace": {
                "id": "text"
              },
              "id": "DX",
              "jira": {
                "id": "text",
                "name": "text"
              },
              "linear": {
                "id": "text"
              },
              "okta": {
                "id": "text"
              },
              "slack": {
                "id": "text",
                "name": "text"
              },
              "teams": {
                "id": "text",
                "teamIDs": [
                  "text"
                ]
              }
            },
            "realName": "text",
            "slack": {
              "id": "text",
              "name": "text"
            },
            "slug": "text",
            "teams": {
              "id": "text",
              "teamIDs": [
                "text"
              ]
            },
            "updatedAt": "text",
            "username": "text"
          }
        ],
        "messageChannelProvider": {
          "id": "DX",
          "slack": {
            "id": "text",
            "thread_ts": "text"
          },
          "teams": {
            "channel": "text",
            "id": "text",
            "teamId": "text"
          }
        },
        "messageChannels": [
          {
            "channelProvider": {
              "id": "DX",
              "slack": {
                "id": "text",
                "thread_ts": "text"
              },
              "teams": {
                "channel": "text",
                "id": "text",
                "teamId": "text"
              }
            },
            "description": "text",
            "name": "text",
            "ownerProvider": {
              "asana": {
                "accessToken": "text",
                "workspaceId": "text",
                "workspaceName": "text"
              },
              "azure": {
                "baseUrl": "text",
                "organizationId": "text",
                "organizationName": "text",
                "tenantId": "text"
              },
              "azureEntra": {
                "clientId": "text",
                "clientSecret": "text",
                "tenantId": "text"
              },
              "bitbucket": {
                "appKey": "text",
                "baseUrl": "text",
                "clientKey": "text",
                "ownerId": "text",
                "ownerName": "text",
                "sharedSecret": "text"
              },
              "external": {
                "installationId": "text"
              },
              "github": {
                "baseUrl": "text",
                "executionIdentity": {
                  "appID": 1,
                  "proof": "text",
                  "source": "dedicated_direct"
                },
                "installationId": 1,
                "owner": "text",
                "ownerId": 1,
                "ownerType": "text"
              },
              "gitlab": {
                "baseUrl": "text",
                "groupId": 1,
                "groupName": "text",
                "oauth": true
              },
              "googleWorkspace": {
                "adminEmail": "text",
                "domain": "text",
                "serviceAccountJson": "text"
              },
              "id": "DX",
              "jira": {
                "baseUrl": "text",
                "installationId": "text",
                "ownerId": "text"
              },
              "linear": {
                "accessToken": "text",
                "clientId": "text",
                "clientSecret": "text",
                "urlKey": "text",
                "workspaceId": "text",
                "workspaceName": "text"
              },
              "okta": {
                "apiToken": "text",
                "domain": "text"
              },
              "slack": {
                "teamId": "text"
              },
              "teams": {
                "teamId": "text"
              }
            }
          }
        ],
        "msteams": {
          "channelId": "text",
          "teamId": "text"
        },
        "name": "text",
        "numMembers": 1,
        "okta": {
          "groupId": "text"
        },
        "privacy": "text",
        "provider": "DX",
        "repositories": [
          {
            "cloneURL": "text",
            "createdAt": "text",
            "defaultBranch": "text",
            "description": "text",
            "forksCount": 1,
            "fullName": "text",
            "hasIssues": true,
            "head": "text",
            "htmlURL": "text",
            "id": "text",
            "isArchived": true,
            "isFork": true,
            "isGlobalConfig": true,
            "isInitialized": true,
            "isPublic": true,
            "language": "text",
            "license": "text",
            "name": "text",
            "openIssues": 1,
            "ownerProvider": {
              "asana": {
                "accessToken": "text",
                "workspaceId": "text",
                "workspaceName": "text"
              },
              "azure": {
                "baseUrl": "text",
                "organizationId": "text",
                "organizationName": "text",
                "tenantId": "text"
              },
              "azureEntra": {
                "clientId": "text",
                "clientSecret": "text",
                "tenantId": "text"
              },
              "bitbucket": {
                "appKey": "text",
                "baseUrl": "text",
                "clientKey": "text",
                "ownerId": "text",
                "ownerName": "text",
                "sharedSecret": "text"
              },
              "external": {
                "installationId": "text"
              },
              "github": {
                "baseUrl": "text",
                "executionIdentity": {
                  "appID": 1,
                  "proof": "text",
                  "source": "dedicated_direct"
                },
                "installationId": 1,
                "owner": "text",
                "ownerId": 1,
                "ownerType": "text"
              },
              "gitlab": {
                "baseUrl": "text",
                "groupId": 1,
                "groupName": "text",
                "oauth": true
              },
              "googleWorkspace": {
                "adminEmail": "text",
                "domain": "text",
                "serviceAccountJson": "text"
              },
              "id": "DX",
              "jira": {
                "baseUrl": "text",
                "installationId": "text",
                "ownerId": "text"
              },
              "linear": {
                "accessToken": "text",
                "clientId": "text",
                "clientSecret": "text",
                "urlKey": "text",
                "workspaceId": "text",
                "workspaceName": "text"
              },
              "okta": {
                "apiToken": "text",
                "domain": "text"
              },
              "slack": {
                "teamId": "text"
              },
              "teams": {
                "teamId": "text"
              }
            },
            "provider": {
              "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": "DX"
            },
            "pushedAt": "text",
            "repoSizeBytes": 1,
            "repoSizeGiB": 1,
            "starCount": 1,
            "topics": [
              "text"
            ],
            "updatedAt": "text",
            "visibility": "text"
          }
        ],
        "repositoryIds": [
          "text"
        ],
        "slack": {
          "groupId": "text"
        },
        "slug": "text",
        "source": "dx",
        "sourceRepositoryPropertyName": "text",
        "sourceRepositoryPropertyValue": "text",
        "ticketBoardId": "text",
        "ticketProjectProvider": {
          "asana": {
            "projectGid": "text",
            "projectName": "text",
            "teamGid": "text",
            "workspaceGid": "text"
          },
          "azure": {
            "projectName": "text"
          },
          "bitbucket": {},
          "github": {
            "repositoryId": 1,
            "repositoryName": "text",
            "repositoryNodeId": "text"
          },
          "gitlab": {},
          "id": "DX",
          "jira": {
            "id": "text",
            "projectKey": "text"
          },
          "linear": {
            "projectId": "text",
            "teamId": "text",
            "teamKey": "text"
          }
        }
      }
    }
  ],
  "version": "text"
}

Get findings for a team

Returns one team and every finding mapped to it. For a team a team-scoped viewer does not belong to, you get the team with an empty findings list. An unknown teamID currently returns 500 rather than 404. Requires FindingRead.

Get Team Findings mapping

get

Get a list of findings mapped to a specific team.

Path parameters
teamIDstringRequired
Query parameters
azureOrganizationIdstringOptional

The Azure organization ID

bitbucketWorkspaceIdstringOptional

The Bitbucket workspace ID

githubOwnerIdinteger · int64Optional

The Github owner ID

githubInstallationIdinteger · int64Optional

Operator routes only: the GitHub App installation ID to use alongside githubOwnerId when the tenant's stored record has none. Ignored on customer routes.

gitlabGroupIdinteger · int64Optional

The GitLab group ID

installationIdstringOptional

The Nullify installation ID

azureRepositoryIdstring[]Optional

Filter by Azure repository IDs

githubRepositoryIdinteger · int64[]Optional

Filter by GitHub repository IDs

githubTeamIdinteger · int64Optional

Filter by GitHub team ID

bitbucketRepositoryIdstring[]Optional

Filter by Bitbucket repository IDs

Responses
200

OK

application/json
versionstringOptional
get/admin/teams/{teamID}/findings
GET /admin/teams/{teamID}/findings HTTP/1.1
Host: api.<TENANT>.nullify.ai
Accept: */*
{
  "findings": [
    {
      "findingType": "Unknown",
      "id": "text",
      "matchSource": "codeowners_team",
      "matchSourceUserID": "text",
      "resolved": true,
      "slaBreached": true,
      "teamID": "text"
    }
  ],
  "team": {
    "azure": {
      "teamId": "text"
    },
    "codeOwnerships": [
      {
        "dataSource": "dx",
        "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": "DX"
        }
      }
    ],
    "github": {
      "orgLogin": "text",
      "teamId": 1,
      "teamSlug": "text"
    },
    "gitlab": {
      "groupId": 1
    },
    "groundRules": [
      {
        "description": "text",
        "id": "text",
        "title": "text"
      }
    ],
    "id": "text",
    "jira": {
      "teamId": "text"
    },
    "lead": {
      "asana": {
        "id": "text"
      },
      "azure": {
        "id": "text"
      },
      "azureEntra": {
        "id": "text"
      },
      "bitbucket": {
        "id": "text"
      },
      "createdAt": "text",
      "createdBy": "text",
      "deleted": true,
      "displayName": "text",
      "email": "text",
      "github": {
        "id": 1,
        "nodeId": "text"
      },
      "gitlab": {
        "id": 1
      },
      "googleWorkspace": {
        "id": "text"
      },
      "id": "text",
      "isBot": true,
      "isRestricted": true,
      "jira": {
        "id": "text",
        "name": "text"
      },
      "lastUpdatedBy": "text",
      "linear": {
        "id": "text"
      },
      "name": "text",
      "okta": {
        "id": "text"
      },
      "provider": {
        "asana": {
          "id": "text"
        },
        "azure": {
          "id": "text"
        },
        "azureEntra": {
          "id": "text"
        },
        "bitBucket": {
          "id": "text"
        },
        "gitHub": {
          "id": 1,
          "nodeId": "text"
        },
        "gitlab": {
          "id": 1
        },
        "googleWorkspace": {
          "id": "text"
        },
        "id": "DX",
        "jira": {
          "id": "text",
          "name": "text"
        },
        "linear": {
          "id": "text"
        },
        "okta": {
          "id": "text"
        },
        "slack": {
          "id": "text",
          "name": "text"
        },
        "teams": {
          "id": "text",
          "teamIDs": [
            "text"
          ]
        }
      },
      "realName": "text",
      "slack": {
        "id": "text",
        "name": "text"
      },
      "slug": "text",
      "teams": {
        "id": "text",
        "teamIDs": [
          "text"
        ]
      },
      "updatedAt": "text",
      "username": "text"
    },
    "leadId": "text",
    "linear": {
      "teamId": "text"
    },
    "memberIds": [
      "text"
    ],
    "members": [
      {
        "asana": {
          "id": "text"
        },
        "azure": {
          "id": "text"
        },
        "azureEntra": {
          "id": "text"
        },
        "bitbucket": {
          "id": "text"
        },
        "createdAt": "text",
        "createdBy": "text",
        "deleted": true,
        "displayName": "text",
        "email": "text",
        "github": {
          "id": 1,
          "nodeId": "text"
        },
        "gitlab": {
          "id": 1
        },
        "googleWorkspace": {
          "id": "text"
        },
        "id": "text",
        "isBot": true,
        "isRestricted": true,
        "jira": {
          "id": "text",
          "name": "text"
        },
        "lastUpdatedBy": "text",
        "linear": {
          "id": "text"
        },
        "name": "text",
        "okta": {
          "id": "text"
        },
        "provider": {
          "asana": {
            "id": "text"
          },
          "azure": {
            "id": "text"
          },
          "azureEntra": {
            "id": "text"
          },
          "bitBucket": {
            "id": "text"
          },
          "gitHub": {
            "id": 1,
            "nodeId": "text"
          },
          "gitlab": {
            "id": 1
          },
          "googleWorkspace": {
            "id": "text"
          },
          "id": "DX",
          "jira": {
            "id": "text",
            "name": "text"
          },
          "linear": {
            "id": "text"
          },
          "okta": {
            "id": "text"
          },
          "slack": {
            "id": "text",
            "name": "text"
          },
          "teams": {
            "id": "text",
            "teamIDs": [
              "text"
            ]
          }
        },
        "realName": "text",
        "slack": {
          "id": "text",
          "name": "text"
        },
        "slug": "text",
        "teams": {
          "id": "text",
          "teamIDs": [
            "text"
          ]
        },
        "updatedAt": "text",
        "username": "text"
      }
    ],
    "messageChannelProvider": {
      "id": "DX",
      "slack": {
        "id": "text",
        "thread_ts": "text"
      },
      "teams": {
        "channel": "text",
        "id": "text",
        "teamId": "text"
      }
    },
    "messageChannels": [
      {
        "channelProvider": {
          "id": "DX",
          "slack": {
            "id": "text",
            "thread_ts": "text"
          },
          "teams": {
            "channel": "text",
            "id": "text",
            "teamId": "text"
          }
        },
        "description": "text",
        "name": "text",
        "ownerProvider": {
          "asana": {
            "accessToken": "text",
            "workspaceId": "text",
            "workspaceName": "text"
          },
          "azure": {
            "baseUrl": "text",
            "organizationId": "text",
            "organizationName": "text",
            "tenantId": "text"
          },
          "azureEntra": {
            "clientId": "text",
            "clientSecret": "text",
            "tenantId": "text"
          },
          "bitbucket": {
            "appKey": "text",
            "baseUrl": "text",
            "clientKey": "text",
            "ownerId": "text",
            "ownerName": "text",
            "sharedSecret": "text"
          },
          "external": {
            "installationId": "text"
          },
          "github": {
            "baseUrl": "text",
            "executionIdentity": {
              "appID": 1,
              "proof": "text",
              "source": "dedicated_direct"
            },
            "installationId": 1,
            "owner": "text",
            "ownerId": 1,
            "ownerType": "text"
          },
          "gitlab": {
            "baseUrl": "text",
            "groupId": 1,
            "groupName": "text",
            "oauth": true
          },
          "googleWorkspace": {
            "adminEmail": "text",
            "domain": "text",
            "serviceAccountJson": "text"
          },
          "id": "DX",
          "jira": {
            "baseUrl": "text",
            "installationId": "text",
            "ownerId": "text"
          },
          "linear": {
            "accessToken": "text",
            "clientId": "text",
            "clientSecret": "text",
            "urlKey": "text",
            "workspaceId": "text",
            "workspaceName": "text"
          },
          "okta": {
            "apiToken": "text",
            "domain": "text"
          },
          "slack": {
            "teamId": "text"
          },
          "teams": {
            "teamId": "text"
          }
        }
      }
    ],
    "msteams": {
      "channelId": "text",
      "teamId": "text"
    },
    "name": "text",
    "numMembers": 1,
    "okta": {
      "groupId": "text"
    },
    "privacy": "text",
    "provider": "DX",
    "repositories": [
      {
        "cloneURL": "text",
        "createdAt": "text",
        "defaultBranch": "text",
        "description": "text",
        "forksCount": 1,
        "fullName": "text",
        "hasIssues": true,
        "head": "text",
        "htmlURL": "text",
        "id": "text",
        "isArchived": true,
        "isFork": true,
        "isGlobalConfig": true,
        "isInitialized": true,
        "isPublic": true,
        "language": "text",
        "license": "text",
        "name": "text",
        "openIssues": 1,
        "ownerProvider": {
          "asana": {
            "accessToken": "text",
            "workspaceId": "text",
            "workspaceName": "text"
          },
          "azure": {
            "baseUrl": "text",
            "organizationId": "text",
            "organizationName": "text",
            "tenantId": "text"
          },
          "azureEntra": {
            "clientId": "text",
            "clientSecret": "text",
            "tenantId": "text"
          },
          "bitbucket": {
            "appKey": "text",
            "baseUrl": "text",
            "clientKey": "text",
            "ownerId": "text",
            "ownerName": "text",
            "sharedSecret": "text"
          },
          "external": {
            "installationId": "text"
          },
          "github": {
            "baseUrl": "text",
            "executionIdentity": {
              "appID": 1,
              "proof": "text",
              "source": "dedicated_direct"
            },
            "installationId": 1,
            "owner": "text",
            "ownerId": 1,
            "ownerType": "text"
          },
          "gitlab": {
            "baseUrl": "text",
            "groupId": 1,
            "groupName": "text",
            "oauth": true
          },
          "googleWorkspace": {
            "adminEmail": "text",
            "domain": "text",
            "serviceAccountJson": "text"
          },
          "id": "DX",
          "jira": {
            "baseUrl": "text",
            "installationId": "text",
            "ownerId": "text"
          },
          "linear": {
            "accessToken": "text",
            "clientId": "text",
            "clientSecret": "text",
            "urlKey": "text",
            "workspaceId": "text",
            "workspaceName": "text"
          },
          "okta": {
            "apiToken": "text",
            "domain": "text"
          },
          "slack": {
            "teamId": "text"
          },
          "teams": {
            "teamId": "text"
          }
        },
        "provider": {
          "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": "DX"
        },
        "pushedAt": "text",
        "repoSizeBytes": 1,
        "repoSizeGiB": 1,
        "starCount": 1,
        "topics": [
          "text"
        ],
        "updatedAt": "text",
        "visibility": "text"
      }
    ],
    "repositoryIds": [
      "text"
    ],
    "slack": {
      "groupId": "text"
    },
    "slug": "text",
    "source": "dx",
    "sourceRepositoryPropertyName": "text",
    "sourceRepositoryPropertyValue": "text",
    "ticketBoardId": "text",
    "ticketProjectProvider": {
      "asana": {
        "projectGid": "text",
        "projectName": "text",
        "teamGid": "text",
        "workspaceGid": "text"
      },
      "azure": {
        "projectName": "text"
      },
      "bitbucket": {},
      "github": {
        "repositoryId": 1,
        "repositoryName": "text",
        "repositoryNodeId": "text"
      },
      "gitlab": {},
      "id": "DX",
      "jira": {
        "id": "text",
        "projectKey": "text"
      },
      "linear": {
        "projectId": "text",
        "teamId": "text",
        "teamKey": "text"
      }
    }
  },
  "version": "text"
}

Assign findings to teams manually

Assigns findings to teams by hand. Send mappings, between 1 and 1,000 entries, each with findingId, teamId and findingType. A finding id may appear only once per request, every team must exist in your workspace, and finding types that cannot be assigned to teams are rejected with 400. The response reports upserted. Manual assignments are recorded as manual and audit logged. Requires FindingWrite.

Manual Team Findings Assignment

post

Manually assign findings to teams.

Query parameters
azureOrganizationIdstringOptional

The Azure organization ID

bitbucketWorkspaceIdstringOptional

The Bitbucket workspace ID

githubOwnerIdinteger · int64Optional

The Github owner ID

githubInstallationIdinteger · int64Optional

Operator routes only: the GitHub App installation ID to use alongside githubOwnerId when the tenant's stored record has none. Ignored on customer routes.

gitlabGroupIdinteger · int64Optional

The GitLab group ID

installationIdstringOptional

The Nullify installation ID

azureRepositoryIdstring[]Optional

Filter by Azure repository IDs

githubRepositoryIdinteger · int64[]Optional

Filter by GitHub repository IDs

githubTeamIdinteger · int64Optional

Filter by GitHub team ID

bitbucketRepositoryIdstring[]Optional

Filter by Bitbucket repository IDs

Body
actorstringOptional

Who an internal service call acted for; ignored on any other call

Responses
200

OK

application/json
upsertedintegerOptional

Number of mappings upserted

versionstringRequired
post/admin/teams/findings
POST /admin/teams/findings HTTP/1.1
Host: api.<TENANT>.nullify.ai
Content-Type: application/json
Accept: */*
Content-Length: 90

{
  "actor": "text",
  "mappings": [
    {
      "findingId": "text",
      "findingType": "Unknown",
      "teamId": "text"
    }
  ]
}
{
  "upserted": 1,
  "version": "text"
}

Re-run finding-to-team matching

Runs the matcher that maps findings to teams. With no filters it covers the whole workspace; narrow it with repositoryIds, repositoryNames, findingIds or findingTypes. By default it runs inline and returns matched and unmatched counts; a very large tenant can get a partial result with a message explaining the cutoff. Set async to true to hand it to a background worker: the call returns immediately with async: true and matched and unmatched of -1, and there is no run id to poll, so check results with Get findings for a team. Requires FindingWrite.

Sync Team Findings

post

Run the finding-to-team matcher. Optionally scope by repository IDs, names, or finding IDs. Set async=true to process large tenants in the background.

Query parameters
azureOrganizationIdstringOptional

The Azure organization ID

bitbucketWorkspaceIdstringOptional

The Bitbucket workspace ID

githubOwnerIdinteger · int64Optional

The Github owner ID

githubInstallationIdinteger · int64Optional

Operator routes only: the GitHub App installation ID to use alongside githubOwnerId when the tenant's stored record has none. Ignored on customer routes.

gitlabGroupIdinteger · int64Optional

The GitLab group ID

installationIdstringOptional

The Nullify installation ID

azureRepositoryIdstring[]Optional

Filter by Azure repository IDs

githubRepositoryIdinteger · int64[]Optional

Filter by GitHub repository IDs

githubTeamIdinteger · int64Optional

Filter by GitHub team ID

bitbucketRepositoryIdstring[]Optional

Filter by Bitbucket repository IDs

Body
asyncbooleanOptional
findingIdsstring[]Optional
findingTypesstring[]Optional
repositoryIdsstring[]Optional
repositoryNamesstring[]Optional
Responses
200

OK

application/json
asyncbooleanOptional
matchedintegerOptional
messagestringOptional
unmatchedintegerOptional
versionstringRequired
post/admin/teams/findings/sync
POST /admin/teams/findings/sync HTTP/1.1
Host: api.<TENANT>.nullify.ai
Content-Type: application/json
Accept: */*
Content-Length: 112

{
  "async": true,
  "findingIds": [
    "text"
  ],
  "findingTypes": [
    "text"
  ],
  "repositoryIds": [
    "text"
  ],
  "repositoryNames": [
    "text"
  ]
}
{
  "async": true,
  "matched": 1,
  "message": "text",
  "unmatched": 1,
  "version": "text"
}

Get SLA breakdown by team

Given findingIDs (note the capitalization), returns for each team the number of those findings that are in SLA (inSLA) and out of SLA (outOfSLA). Teams with none of the findings, teams deleted since the mapping, and teams a team-scoped viewer cannot read are omitted; an empty list returns an empty result. This is a read-only operation sent as POST because of the body. Requires FindingRead.

Get Team SLA Breakdown

post

Aggregate per-team in-SLA / out-of-SLA finding counts across the supplied finding IDs.

Query parameters
azureOrganizationIdstringOptional

The Azure organization ID

bitbucketWorkspaceIdstringOptional

The Bitbucket workspace ID

githubOwnerIdinteger · int64Optional

The Github owner ID

githubInstallationIdinteger · int64Optional

Operator routes only: the GitHub App installation ID to use alongside githubOwnerId when the tenant's stored record has none. Ignored on customer routes.

gitlabGroupIdinteger · int64Optional

The GitLab group ID

installationIdstringOptional

The Nullify installation ID

azureRepositoryIdstring[]Optional

Filter by Azure repository IDs

githubRepositoryIdinteger · int64[]Optional

Filter by GitHub repository IDs

githubTeamIdinteger · int64Optional

Filter by GitHub team ID

bitbucketRepositoryIdstring[]Optional

Filter by Bitbucket repository IDs

Body
findingIDsstring[] · nullableRequired
Responses
200

OK

application/json
post/admin/teams/sla-breakdown
POST /admin/teams/sla-breakdown HTTP/1.1
Host: api.<TENANT>.nullify.ai
Content-Type: application/json
Accept: */*
Content-Length: 23

{
  "findingIDs": [
    "text"
  ]
}
{
  "teams": [
    {
      "inSLA": 1,
      "outOfSLA": 1,
      "teamID": "text",
      "teamName": "text",
      "teamSlug": "text"
    }
  ]
}

List events for a team

Returns the unified activity feed for one team. All body fields are optional filters: services, excludeServices, findingIds, eventTypes, excludeEventTypes, autofixId, prCanonicalId, runId and campaignId, plus a time window with beforeTimeUnix and afterTimeUnix. An unknown service name returns 400. limit defaults to 50 and is capped at 200. When hasMore is true the response includes nextCursorTime and nextCursorId for the next request; some internal services and event types are excluded by default. A team-scoped viewer asking for another team gets an empty list. Requires FindingRead.

List Team Unified Events

post

Cross-service unified event feed filtered by team

Path parameters
teamIDstringRequired
Query parameters
azureOrganizationIdstringOptional

The Azure organization ID

bitbucketWorkspaceIdstringOptional

The Bitbucket workspace ID

githubOwnerIdinteger · int64Optional

The Github owner ID

githubInstallationIdinteger · int64Optional

Operator routes only: the GitHub App installation ID to use alongside githubOwnerId when the tenant's stored record has none. Ignored on customer routes.

gitlabGroupIdinteger · int64Optional

The GitLab group ID

installationIdstringOptional

The Nullify installation ID

azureRepositoryIdstring[]Optional

Filter by Azure repository IDs

githubRepositoryIdinteger · int64[]Optional

Filter by GitHub repository IDs

githubTeamIdinteger · int64Optional

Filter by GitHub team ID

bitbucketRepositoryIdstring[]Optional

Filter by Bitbucket repository IDs

Body
afterIdstring · nullableOptional
afterTimeUnixinteger · nullableOptional
autofixIdstring · nullableOptional
beforeTimeUnixinteger · nullableOptional
campaignIdstring · nullableOptional
eventTypesstring[]Optional
excludeEventTypesstring[]Optional
excludeServicesstring[]Optional
findingIdsstring[]Optional
hideNoisebooleanOptional
limitinteger · nullableOptional
prCanonicalIdstring · nullableOptional
querystring · max: 256Optional
queryEventTypesstring[] · max: 512Optional
runIdstring · nullableOptional
servicesstring[]Optional
Responses
200

OK

application/json
hasMorebooleanOptional
nextCursorIdstring · nullableOptional
nextCursorTimeinteger · nullableOptional
versionstringOptional
post/admin/teams/{teamID}/events
POST /admin/teams/{teamID}/events HTTP/1.1
Host: api.<TENANT>.nullify.ai
Content-Type: application/json
Accept: */*
Content-Length: 321

{
  "afterId": "text",
  "afterTimeUnix": 1,
  "autofixId": "text",
  "beforeTimeUnix": 1,
  "campaignId": "text",
  "eventTypes": [
    "text"
  ],
  "excludeEventTypes": [
    "text"
  ],
  "excludeServices": [
    "text"
  ],
  "findingIds": [
    "text"
  ],
  "hideNoise": true,
  "limit": 1,
  "prCanonicalId": "text",
  "query": "text",
  "queryEventTypes": [
    "text"
  ],
  "runId": "text",
  "services": [
    "text"
  ]
}
{
  "events": [
    {
      "autofixId": "text",
      "campaignId": "text",
      "createdAt": "text",
      "data": null,
      "findingId": "text",
      "id": "text",
      "prCanonicalId": "text",
      "repositoryId": "text",
      "runId": "text",
      "service": "sast",
      "tenantId": "text",
      "timestampUnix": 1,
      "type": "repo_context_agent_started"
    }
  ],
  "hasMore": true,
  "nextCursorId": "text",
  "nextCursorTime": 1,
  "version": "text"
}

Last updated