SaaS App and Device Management APIs

APIs to monitor and manager integrations

Fetch Github repositories

get

Returns a list of repositories Nightfall has access to.

Authorizations
Query parameters
limitinteger · min: 1 · max: 100Optional

The maximum number of records to be returned in the response

Default: 100
pageTokenstringOptional

Cursor for getting the next page of results

Responses
200

Successful response

application/json
get
/github/repositories
GET /apps/v1/github/repositories HTTP/1.1
Host: api.nightfall.ai
Authorization: Bearer YOUR_SECRET_TOKEN
Accept: */*

{
  "repositories": [
    {
      "repositoryID": 1,
      "repositoryName": "text",
      "isRepoPrivate": true,
      "repoLink": "text",
      "scannedAt": 1,
      "isMonitored": true,
      "githubUsername": "text"
    }
  ],
  "nextPageToken": "text"
}

List endpoint devices

get

Returns a list of endpoint devices where the Nightfall agent is installed across the organization.

Authorizations
Query parameters
limitinteger · min: 1 · max: 500Optional

The maximum number of agents to be returned in the response

Default: 500
pageTokenstringOptional

Cursor for getting the next page of results

Responses
200

Successful response

application/json
get
/endpoint/devices
GET /apps/v1/endpoint/devices HTTP/1.1
Host: api.nightfall.ai
Authorization: Bearer YOUR_SECRET_TOKEN
Accept: */*

{
  "agents": [
    {
      "os": "MAC_OS",
      "deviceName": "text",
      "deviceId": "text",
      "macAddresses": [
        "text"
      ],
      "connectionStatus": "CONNECTED",
      "lastConnection": "2025-10-23T06:44:18.444Z",
      "agentVersion": "text",
      "osVersion": "text"
    }
  ],
  "totalAgents": 1,
  "nextPageToken": "text"
}
PreviousPosture Management APIsNextOverview

Last updated

Was this helpful?