Skip to main content
Documentation

Projects

Actions in the projects namespace of the Nexigon Hub API.

Badges mark actions of the Device API and the Admin API, whose compatibility differs from other actions.

projects_Query

POST/api/v1/actions/invoke/projects_QueryAdmin API

Query the projects of the instance.

Request QueryProjectsAction

No fields. Send an empty JSON object.

Response QueryProjectsOutput

  • projectsarray<object>QueryProjectsItem

    List of projects.

    2 fields
    • projectIdstringProjectId

      ID of the project.

    • namestring

      Name of the project.

Example

curl --fail-with-body \
  -H "Authorization: Bearer $NEXIGON_TOKEN" \
  -H "Content-Type: application/json" \
  -d '{}' \
  $NEXIGON_HUB_URL/api/v1/actions/invoke/projects_Query
{
  "projects": [
    {
      "projectId": "<project-id>",
      "name": "<name>"
    }
  ]
}

projects_GetDetails

POST/api/v1/actions/invoke/projects_GetDetails

Get information about a project.

Request GetProjectDetailsAction

  • projectIdstringProjectId

    ID of the project.

Response GetProjectDetailsOutput

  • projectIdstringProjectId

    ID of the project.

  • namestring

    Name of the project.

  • deviceCountinteger

    Number of devices in the project.

Example

curl --fail-with-body \
  -H "Authorization: Bearer $NEXIGON_TOKEN" \
  -H "Content-Type: application/json" \
  -d '{"projectId":"<project-id>"}' \
  $NEXIGON_HUB_URL/api/v1/actions/invoke/projects_GetDetails
{
  "projectId": "<project-id>",
  "name": "<name>",
  "deviceCount": 1
}

projects_SetName

POST/api/v1/actions/invoke/projects_SetName

Set the name of a project.

Request SetProjectNameAction

  • projectIdstringProjectId

    ID of the project.

  • namestring

    New name of the project.

    • Project name must be between 1 and 128 characters.

Response Empty

No fields. The response is an empty JSON object.

Example

curl --fail-with-body \
  -H "Authorization: Bearer $NEXIGON_TOKEN" \
  -H "Content-Type: application/json" \
  -d '{"projectId":"<project-id>","name":"<name>"}' \
  $NEXIGON_HUB_URL/api/v1/actions/invoke/projects_SetName
{}

projects_Create

POST/api/v1/actions/invoke/projects_Create

Create a new project.

Request CreateProjectAction

  • organizationIdstringOrganizationId

    Organization to create the project in.

  • namestring

    Name of the project.

    • Project name must be between 1 and 128 characters.

Response CreateProjectOutput

One of the following, identified by result:

  • result: "Created"
    • projectIdstringProjectId

      ID of the project.

Example

curl --fail-with-body \
  -H "Authorization: Bearer $NEXIGON_TOKEN" \
  -H "Content-Type: application/json" \
  -d '{"organizationId":"<organization-id>","name":"<name>"}' \
  $NEXIGON_HUB_URL/api/v1/actions/invoke/projects_Create
{
  "result": "Created",
  "projectId": "<project-id>"
}

projects_Delete

POST/api/v1/actions/invoke/projects_Delete

Delete a project.

Request DeleteProjectAction

  • projectIdstringProjectId

    ID of the project.

Response Empty

No fields. The response is an empty JSON object.

Example

curl --fail-with-body \
  -H "Authorization: Bearer $NEXIGON_TOKEN" \
  -H "Content-Type: application/json" \
  -d '{"projectId":"<project-id>"}' \
  $NEXIGON_HUB_URL/api/v1/actions/invoke/projects_Delete
{}

projects_QueryPropertySchemas

POST/api/v1/actions/invoke/projects_QueryPropertySchemas

List project definitions and the read-only built-in definitions.

Request QueryPropertySchemasAction

  • projectIdstringProjectId

    ID of the project.

Response QueryPropertySchemasOutput

  • schemasarray<object>PropertySchema

    Available definitions.

    3 fields
    • namestring

      Exact property name.

    • schemaanyJsonValue

      JSON Schema document.

    • builtinboolean

      Whether the definition is built in and cannot be changed or removed.

Example

curl --fail-with-body \
  -H "Authorization: Bearer $NEXIGON_TOKEN" \
  -H "Content-Type: application/json" \
  -d '{"projectId":"<project-id>"}' \
  $NEXIGON_HUB_URL/api/v1/actions/invoke/projects_QueryPropertySchemas
{
  "schemas": [
    {
      "name": "<name>",
      "schema": {},
      "builtin": true
    }
  ]
}

projects_SetPropertySchema

POST/api/v1/actions/invoke/projects_SetPropertySchema

Create or replace a project schema without validating existing property values.

Requires permission to manage project settings. Built-in definitions are read-only. The schema must be a JSON object or boolean. Editors report unsupported or invalid schemas and allow explicit overrides; APIs do not enforce schemas on property writes.

Request SetPropertySchemaAction

  • projectIdstringProjectId

    ID of the project.

  • namestring

    Exact property name.

    • Property name must be between 1 and 256 characters.
    • Property name must start with a letter or digit and contain only letters, digits, dots, underscores, or hyphens.
  • schemaanyJsonValue

    JSON Schema document.

    Nexigon Hub rejects schemas larger than the instance's limit, 64 KiB by default.

Response Empty

No fields. The response is an empty JSON object.

Example

curl --fail-with-body \
  -H "Authorization: Bearer $NEXIGON_TOKEN" \
  -H "Content-Type: application/json" \
  -d '{"projectId":"<project-id>","name":"<name>","schema":{}}' \
  $NEXIGON_HUB_URL/api/v1/actions/invoke/projects_SetPropertySchema
{}

projects_RemovePropertySchema

POST/api/v1/actions/invoke/projects_RemovePropertySchema

Remove a project definition without changing property values.

Requires permission to manage project settings. Built-in definitions are read-only.

Request RemovePropertySchemaAction

  • projectIdstringProjectId

    ID of the project.

  • namestring

    Exact property name.

    • Property name must be between 1 and 256 characters.

Response Empty

No fields. The response is an empty JSON object.

Example

curl --fail-with-body \
  -H "Authorization: Bearer $NEXIGON_TOKEN" \
  -H "Content-Type: application/json" \
  -d '{"projectId":"<project-id>","name":"<name>"}' \
  $NEXIGON_HUB_URL/api/v1/actions/invoke/projects_RemovePropertySchema
{}

projects_QueryDevices

POST/api/v1/actions/invoke/projects_QueryDevices

Query a page of the devices of a project, newest first.

Request QueryProjectDevicesAction

  • projectIdstringProjectId

    ID of the project.

  • filterobjectDeviceFilteroptional

    Only return devices matching this filter.

    4 fields
    • searchstringoptional

      Case-insensitive substring of device name, hostname, or ID.

    • statusstringDeviceStatusoptional

      Current combined health and connection status.

      • "healthy"

        Device is healthy and connected.

      • "warning"

        Device is connected but experiencing degraded performance.

      • "error"

        Device is connected but in an error state.

      • "offline"

        Device is not connected.

    • groupsobjectDeviceGroupSelectoroptional

      Group membership conditions.

      3 fields
      • allarray<string>DeviceGroupIdoptional

        Every listed group must be present. Empty or absent imposes no condition.

      • anyarray<string>DeviceGroupIdoptional

        At least one listed group must be present. Empty matches no devices; absence imposes no condition.

      • nonearray<string>DeviceGroupIdoptional

        Every listed group must be absent. Empty or absent imposes no condition.

    • profilestringDeviceProfileIdoptional
      • Unstable (feature device_profiles)

      Only devices that apply this profile.

  • pageobjectPageRequestoptional

    Page to return. Without this field, the first page is returned.

    2 fields
    • limitintegeroptional

      Maximum number of items. The default depends on the endpoint and the ceiling is configured by the Hub operator (1000 by default).

      • Page limit must be positive.
    • cursorstringPageCursoroptional

      Continue the same endpoint, scope, filters, and ordering.

Response QueryProjectDevicesOutput

  • devicesarray<object>QueryProjectDevicesItem

    Devices on this page.

    10 fields
    • groupsarray<object>DeviceGroup

      Groups currently assigned to this device.

      5 fields
      • groupIdstringDeviceGroupId
      • projectIdstringProjectId
      • namestring

        Unique within the project, ignoring case and surrounding whitespace.

      • colorstringDeviceGroupColoroptional
        • Group color must be a six-digit hexadecimal color, such as #3b82f6.
      • descriptionstringoptional
    • deviceIdstringDeviceId

      ID of the device.

    • namestringoptional

      Name of the device.

    • hostnamestringoptional

      Hostname reported by the device (from dev.nexigon.system.info).

    • firstSeenstring (date-time)Timestamp

      Timestamp when the device was first seen.

    • statusstringDeviceStatus

      Combined device status (connection + health).

      • "healthy"

        Device is healthy and connected.

      • "warning"

        Device is connected but experiencing degraded performance.

      • "error"

        Device is connected but in an error state.

      • "offline"

        Device is not connected.

    • isConnectedboolean

      Indicates whether the device is online.

    • pendingCertificatesCountinteger

      Pending device certificates.

    • lastConnectedAtstring (date-time)Timestampoptional

      Timestamp when the device was last connected (current or most recent connection).

    • currentConnectionDurationSecsintegeroptional

      Duration of the current connection in seconds (null if not connected).

  • pageobjectPageInfo

    Continuation of the traversal.

    1 field
    • nextCursorstringPageCursoroptional

      Cursor for the next page; absent when no more matching rows were visible.

Example

curl --fail-with-body \
  -H "Authorization: Bearer $NEXIGON_TOKEN" \
  -H "Content-Type: application/json" \
  -d '{"projectId":"<project-id>"}' \
  $NEXIGON_HUB_URL/api/v1/actions/invoke/projects_QueryDevices
{
  "devices": [
    {
      "groups": [
        {
          "groupId": "<device-group-id>",
          "projectId": "<project-id>",
          "name": "<name>"
        }
      ],
      "deviceId": "<device-id>",
      "firstSeen": "2026-01-01T12:00:00Z",
      "status": "healthy",
      "isConnected": true,
      "pendingCertificatesCount": 1
    }
  ],
  "page": {}
}

projects_CountDevices

POST/api/v1/actions/invoke/projects_CountDevices

Count the devices of a project.

Request CountProjectDevicesAction

  • projectIdstringProjectId

    ID of the project.

  • filterobjectDeviceFilteroptional

    Only count devices matching this filter in matching.

    4 fields
    • searchstringoptional

      Case-insensitive substring of device name, hostname, or ID.

    • statusstringDeviceStatusoptional

      Current combined health and connection status.

      • "healthy"

        Device is healthy and connected.

      • "warning"

        Device is connected but experiencing degraded performance.

      • "error"

        Device is connected but in an error state.

      • "offline"

        Device is not connected.

    • groupsobjectDeviceGroupSelectoroptional

      Group membership conditions.

      3 fields
      • allarray<string>DeviceGroupIdoptional

        Every listed group must be present. Empty or absent imposes no condition.

      • anyarray<string>DeviceGroupIdoptional

        At least one listed group must be present. Empty matches no devices; absence imposes no condition.

      • nonearray<string>DeviceGroupIdoptional

        Every listed group must be absent. Empty or absent imposes no condition.

    • profilestringDeviceProfileIdoptional
      • Unstable (feature device_profiles)

      Only devices that apply this profile.

Response CountProjectDevicesOutput

  • totalinteger

    Number of devices in the project.

  • matchinginteger

    Number of devices matching the filter.

Example

curl --fail-with-body \
  -H "Authorization: Bearer $NEXIGON_TOKEN" \
  -H "Content-Type: application/json" \
  -d '{"projectId":"<project-id>"}' \
  $NEXIGON_HUB_URL/api/v1/actions/invoke/projects_CountDevices
{
  "total": 1,
  "matching": 1
}

projects_QueryDeploymentTokens

POST/api/v1/actions/invoke/projects_QueryDeploymentTokens

Query the deployment tokens of a project.

Request QueryProjectDeploymentTokensAction

  • projectIdstringProjectId

    ID of the project.

Response QueryProjectDeploymentTokensOutput

  • tokensarray<object>QueryProjectDeploymentTokensItem

    List of deployment tokens.

    5 fields
    • tokenIdstringDeploymentTokenId

      ID of the token.

    • deviceIdstringDeviceIdoptional

      Device this deployment token is bound to, if any.

    • createdAtstring (date-time)Timestamp

      Creation date of the token.

    • namestringoptional

      Name of the token.

    • flagsobjectDeploymentTokenFlags

      Flags.

      1 field
      • autoAcceptbooleanoptional

        Whether to automatically accept new devices.

Example

curl --fail-with-body \
  -H "Authorization: Bearer $NEXIGON_TOKEN" \
  -H "Content-Type: application/json" \
  -d '{"projectId":"<project-id>"}' \
  $NEXIGON_HUB_URL/api/v1/actions/invoke/projects_QueryDeploymentTokens
{
  "tokens": [
    {
      "tokenId": "<deployment-token-id>",
      "createdAt": "2026-01-01T12:00:00Z",
      "flags": {}
    }
  ]
}

projects_QueryLinkedRepositories

POST/api/v1/actions/invoke/projects_QueryLinkedRepositories

Query repositories of a project.

Request QueryProjectRepositoriesAction

  • projectIdstringProjectId

    ID of the project.

Response QueryProjectRepositoriesOutput

  • repositoriesarray<object>QueryProjectRepositoriesItem

    List of repositories.

    5 fields
    • repositoryIdstringRepositoryId

      ID of the repository.

    • displayNamestring

      Display name of the repository.

    • pathNamestringoptional

      Path name of the repository, unique within its organization.

      Absent on older Hub versions.

    • slugstringoptional

      Slug of the repository, unique on the instance, if one has been set.

    • publicNamestring
      • Deprecated β€” removed in 2029.2 β€” Use slug, which is absent when no slug is set.

      Public name of the repository.

      Falls back to the repository ID when no slug is set.

Example

curl --fail-with-body \
  -H "Authorization: Bearer $NEXIGON_TOKEN" \
  -H "Content-Type: application/json" \
  -d '{"projectId":"<project-id>"}' \
  $NEXIGON_HUB_URL/api/v1/actions/invoke/projects_QueryLinkedRepositories
{
  "repositories": [
    {
      "repositoryId": "<repository-id>",
      "displayName": "<display-name>",
      "publicName": "<public-name>"
    }
  ]
}

projects_CreateDeploymentToken

POST/api/v1/actions/invoke/projects_CreateDeploymentToken

Create a deployment token.

Request CreateDeploymentTokenAction

  • projectIdstringProjectId

    ID of the project.

  • namestring

    Name of the token.

    • Token name must be between 1 and 128 characters.
  • flagsobjectDeploymentTokenFlagsoptional

    Flags.

    1 field
    • autoAcceptbooleanoptional

      Whether to automatically accept new devices.

Response CreateDeploymentTokenOutput

  • tokenIdstringDeploymentTokenId

    ID of the token.

  • tokenstringDeploymentToken

    Token.

Example

curl --fail-with-body \
  -H "Authorization: Bearer $NEXIGON_TOKEN" \
  -H "Content-Type: application/json" \
  -d '{"projectId":"<project-id>","name":"<name>"}' \
  $NEXIGON_HUB_URL/api/v1/actions/invoke/projects_CreateDeploymentToken
{
  "tokenId": "<deployment-token-id>",
  "token": "<deployment-token>"
}

projects_DeleteDeploymentToken

POST/api/v1/actions/invoke/projects_DeleteDeploymentToken

Delete a deployment token.

Request DeleteDeploymentTokenAction

  • tokenIdstringDeploymentTokenId

    ID of the token.

Response Empty

No fields. The response is an empty JSON object.

Example

curl --fail-with-body \
  -H "Authorization: Bearer $NEXIGON_TOKEN" \
  -H "Content-Type: application/json" \
  -d '{"tokenId":"<deployment-token-id>"}' \
  $NEXIGON_HUB_URL/api/v1/actions/invoke/projects_DeleteDeploymentToken
{}

projects_SetDeploymentTokenFlags

POST/api/v1/actions/invoke/projects_SetDeploymentTokenFlags

Set the flags of a deployment token.

Request SetDeploymentTokenFlagsAction

  • tokenIdstringDeploymentTokenId

    ID of the token.

  • flagsobjectDeploymentTokenFlags

    Flags.

    1 field
    • autoAcceptbooleanoptional

      Whether to automatically accept new devices.

Response Empty

No fields. The response is an empty JSON object.

Example

curl --fail-with-body \
  -H "Authorization: Bearer $NEXIGON_TOKEN" \
  -H "Content-Type: application/json" \
  -d '{"tokenId":"<deployment-token-id>","flags":{}}' \
  $NEXIGON_HUB_URL/api/v1/actions/invoke/projects_SetDeploymentTokenFlags
{}

projects_QueryDevicePairingKeys

POST/api/v1/actions/invoke/projects_QueryDevicePairingKeys

Query the device pairing keys of a project.

Request QueryDevicePairingKeysAction

  • projectIdstringProjectId

    ID of the project.

Response QueryDevicePairingKeysOutput

  • pairingKeysarray<object>QueryDevicePairingKeysItem

    List of device pairing keys.

    9 fields
    • pairingKeyIdstringDevicePairingKeyId

      ID of the pairing key.

    • selectorstring

      Public lookup selector (first six normalized characters of the key).

    • createdAtstring (date-time)Timestamp

      Creation date of the pairing key.

    • expiresAtstring (date-time)Timestamp

      Expiration date of the pairing key.

    • usedAtstring (date-time)Timestampoptional

      Timestamp when the pairing key was redeemed.

    • revokedAtstring (date-time)Timestampoptional

      Timestamp when the pairing key was revoked.

    • namestringoptional

      Name of the pairing key.

    • deviceIdstringDeviceIdoptional

      Device created or associated when the pairing key was redeemed.

    • tokenIdstringDeploymentTokenIdoptional

      Deployment token issued when the pairing key was redeemed.

Example

curl --fail-with-body \
  -H "Authorization: Bearer $NEXIGON_TOKEN" \
  -H "Content-Type: application/json" \
  -d '{"projectId":"<project-id>"}' \
  $NEXIGON_HUB_URL/api/v1/actions/invoke/projects_QueryDevicePairingKeys
{
  "pairingKeys": [
    {
      "pairingKeyId": "<device-pairing-key-id>",
      "selector": "<selector>",
      "createdAt": "2026-01-01T12:00:00Z",
      "expiresAt": "2026-01-01T12:00:00Z"
    }
  ]
}

projects_CreateDevicePairingKey

POST/api/v1/actions/invoke/projects_CreateDevicePairingKey

Create a device pairing key.

Request CreateDevicePairingKeyAction

  • projectIdstringProjectId

    ID of the project.

  • namestringoptional

    Name of the pairing key.

    • Pairing key name must be between 1 and 128 characters.
  • validForSecsintegeroptional

    Pairing key validity duration in seconds.

    Defaults to 5 minutes. The maximum is 10 minutes.

    • Pairing key validity must be between 1 second and 10 minutes.

Response CreateDevicePairingKeyOutput

  • pairingKeyIdstringDevicePairingKeyId

    ID of the pairing key.

  • pairingKeystring

    Pairing key. This is only returned once.

  • selectorstring

    Public lookup selector (first six normalized characters of the key).

  • createdAtstring (date-time)Timestamp

    Creation date of the pairing key.

  • expiresAtstring (date-time)Timestamp

    Expiration date of the pairing key.

Example

curl --fail-with-body \
  -H "Authorization: Bearer $NEXIGON_TOKEN" \
  -H "Content-Type: application/json" \
  -d '{"projectId":"<project-id>"}' \
  $NEXIGON_HUB_URL/api/v1/actions/invoke/projects_CreateDevicePairingKey
{
  "pairingKeyId": "<device-pairing-key-id>",
  "pairingKey": "<pairing-key>",
  "selector": "<selector>",
  "createdAt": "2026-01-01T12:00:00Z",
  "expiresAt": "2026-01-01T12:00:00Z"
}

projects_RevokeDevicePairingKey

POST/api/v1/actions/invoke/projects_RevokeDevicePairingKey

Revoke an unused device pairing key.

Request RevokeDevicePairingKeyAction

  • pairingKeyIdstringDevicePairingKeyId

    ID of the pairing key.

Response Empty

No fields. The response is an empty JSON object.

Example

curl --fail-with-body \
  -H "Authorization: Bearer $NEXIGON_TOKEN" \
  -H "Content-Type: application/json" \
  -d '{"pairingKeyId":"<device-pairing-key-id>"}' \
  $NEXIGON_HUB_URL/api/v1/actions/invoke/projects_RevokeDevicePairingKey
{}

projects_RedeemDevicePairingKey

POST/api/v1/actions/invoke/projects_RedeemDevicePairingKeyDevice API

Redeem a device pairing key.

Creates a device in the pairing key's project and issues a deployment token bound to it. The device uses the token to connect to Nexigon Hub. This action does not require authentication; the pairing key authorizes it.

Request RedeemDevicePairingKeyAction

  • pairingKeystring

    Pairing key as shown to the user.

    • Pairing key must be 10 characters, optionally formatted with one dash.
  • fingerprintstringDeviceFingerprint

    Fingerprint generated by the device.

  • deviceNamestringoptional

    Optional display name for the device.

    • Device name must be between 1 and 128 characters.

Response RedeemDevicePairingKeyOutput

  • projectIdstringProjectId

    Project the device was created in.

  • deviceIdstringDeviceId

    Device created for this pairing key.

  • tokenIdstringDeploymentTokenId

    ID of the issued device-bound deployment token.

  • tokenstringDeploymentToken

    Device-bound deployment token. This is only returned once.

Example

curl --fail-with-body \
  -H "Authorization: Bearer $NEXIGON_TOKEN" \
  -H "Content-Type: application/json" \
  -d '{
    "pairingKey": "<pairing-key>",
    "fingerprint": "<device-fingerprint>"
  }' \
  $NEXIGON_HUB_URL/api/v1/actions/invoke/projects_RedeemDevicePairingKey
{
  "projectId": "<project-id>",
  "deviceId": "<device-id>",
  "tokenId": "<deployment-token-id>",
  "token": "<deployment-token>"
}

projects_QueryAuditLog

POST/api/v1/actions/invoke/projects_QueryAuditLog

Query the audit log of the project.

Request QueryAuditLogEventsAction

  • pageobjectPageRequestoptional

    Opt into cursor pagination. Without this field, the existing limit applies.

    2 fields
    • limitintegeroptional

      Maximum number of items. The default depends on the endpoint and the ceiling is configured by the Hub operator (1000 by default).

      • Page limit must be positive.
    • cursorstringPageCursoroptional

      Continue the same endpoint, scope, filters, and ordering.

  • projectIdstringProjectId

    ID of the project.

Response QueryAuditLogEventsOutput

  • pageobjectPageInfooptional

    Present when cursor pagination was requested.

    1 field
    • nextCursorstringPageCursoroptional

      Cursor for the next page; absent when no more matching rows were visible.

  • eventsarray<object>AuditLogEvent

    List of audit log events.

    7 fields
    • eventIdstringAuditLogEventId

      ID of the audit log event.

    • actorobjectActor

      Actor causing the event.

      7 variants

      One of the following, identified by actor:

      • actor: "Anonymous"

        An anonymous, unauthenticated actor.

      • actor: "System"

        The system itself, typically used for internal actions.

      • actor: "Device"

        A device authenticated via a specific deployment token.

        • deviceIdstringDeviceId

          ID of the device.

        • tokenIdstringDeploymentTokenId

          ID of the deployment token used for authentication.

      • actor: "User"

        A user typically authenticated via a user session.

        • userIdstringUserId

          ID of the user.

      • actor: "UserToken"

        A user authenticated via a specific token.

        • userIdstringUserId

          ID of the user.

        • tokenIdstringUserTokenId

          ID of the user token used for authentication.

      • actor: "ClusterNode"

        A cluster node.

        • nodeIdstringClusterNodeId

          ID of the cluster node.

      • actor: "OrganizationApiToken"

        An organization API token.

        • organizationIdstringOrganizationId

          ID of the organization.

        • tokenIdstringOrganizationApiTokenId

          ID of the API token.

    • eventstring

      Type of the event that was recorded.

    • dataanyJsonValue

      Additional audit data associated with the event.

    • createdAtstring (date-time)Timestamp

      Timestamp indicating when the audit log event was recorded.

    • actionobjectAuditLogEventActionoptional

      Action the event has been caused by (if any).

      1 field
      • actionIdstringAuditLogActionId

        ID of the action.

    • jobobjectAuditLogEventJoboptional

      Job the event has been caused by (if any).

      1 field
      • jobIdstringJobId

        ID of the job.

  • referencesobjectAuditLogReferencesoptional

    Names of the actors of the returned events.

    Absent in responses of Nexigon Hub 2026.3 and earlier.

    3 fields
    • usersarray<object>AuditLogUserReference

      Users acting directly or through a user token.

      3 fields
      • userIdstringUserId

        ID of the user.

      • displayNamestringoptional

        Name of the user.

      • emailstring

        Email of the user.

    • devicesarray<object>AuditLogDeviceReference

      Devices.

      2 fields
      • deviceIdstringDeviceId

        ID of the device.

      • namestring

        Name of the device.

    • organizationApiTokensarray<object>AuditLogOrganizationApiTokenReference

      Organization API tokens.

      2 fields
      • tokenIdstringOrganizationApiTokenId

        ID of the API token.

      • namestring

        Name of the API token.

Example

curl --fail-with-body \
  -H "Authorization: Bearer $NEXIGON_TOKEN" \
  -H "Content-Type: application/json" \
  -d '{"projectId":"<project-id>"}' \
  $NEXIGON_HUB_URL/api/v1/actions/invoke/projects_QueryAuditLog
{
  "events": [
    {
      "eventId": "<audit-log-event-id>",
      "actor": {
        "actor": "Device",
        "deviceId": "<device-id>",
        "tokenId": "<deployment-token-id>"
      },
      "event": "<event>",
      "data": {},
      "createdAt": "2026-01-01T12:00:00Z"
    }
  ]
}

projects_LinkRepository

POST/api/v1/actions/invoke/projects_LinkRepository

Add a repository to the project.

The repository must belong to the project's organization.

Request AddProjectRepositoryAction

  • projectIdstringProjectId

    ID of the project.

  • repositoryIdstringRepositoryId

    ID of the repository.

Response Empty

No fields. The response is an empty JSON object.

Example

curl --fail-with-body \
  -H "Authorization: Bearer $NEXIGON_TOKEN" \
  -H "Content-Type: application/json" \
  -d '{
    "projectId": "<project-id>",
    "repositoryId": "<repository-id>"
  }' \
  $NEXIGON_HUB_URL/api/v1/actions/invoke/projects_LinkRepository
{}

projects_UnlinkRepository

POST/api/v1/actions/invoke/projects_UnlinkRepository

Remove a repository from the project.

Request RemoveProjectRepositoryAction

  • projectIdstringProjectId

    ID of the project.

  • repositoryIdstringRepositoryId

    ID of the repository.

Response Empty

No fields. The response is an empty JSON object.

Example

curl --fail-with-body \
  -H "Authorization: Bearer $NEXIGON_TOKEN" \
  -H "Content-Type: application/json" \
  -d '{
    "projectId": "<project-id>",
    "repositoryId": "<repository-id>"
  }' \
  $NEXIGON_HUB_URL/api/v1/actions/invoke/projects_UnlinkRepository
{}

projects_GetOtlpConfig

POST/api/v1/actions/invoke/projects_GetOtlpConfig

  • Unstable (feature otlp_export)

Get the OTLP event forwarding configuration for a project.

Request GetProjectOtlpConfigAction

  • projectIdstringProjectId

    ID of the project.

Response GetProjectOtlpConfigOutput

  • configobjectProjectOtlpConfig

    OTLP configuration.

    3 fields
    • enabledboolean

      Whether OTLP forwarding is enabled.

    • endpointstringoptional

      OTLP endpoint URL (e.g., https://otel-collector.example.com/v1/logs).

      • OTLP endpoint must be between 1 and 2048 characters.
      • OTLP endpoint must be an HTTP(S) URL.
    • headersmap<string, string>

      HTTP headers to include with OTLP requests (e.g., for authentication). Values are masked when read back. Setting a header to its masked value keeps the stored value, provided that the endpoint stays the same.

Example

curl --fail-with-body \
  -H "Authorization: Bearer $NEXIGON_TOKEN" \
  -H "Content-Type: application/json" \
  -d '{"projectId":"<project-id>"}' \
  $NEXIGON_HUB_URL/api/v1/actions/invoke/projects_GetOtlpConfig
{
  "config": {
    "enabled": true,
    "headers": {
      "<key>": "<string>"
    }
  }
}

projects_SetOtlpConfig

POST/api/v1/actions/invoke/projects_SetOtlpConfig

  • Unstable (feature otlp_export)

Set the OTLP event forwarding configuration for a project.

Request SetProjectOtlpConfigAction

  • projectIdstringProjectId

    ID of the project.

  • configobjectProjectOtlpConfig

    OTLP configuration.

    3 fields
    • enabledboolean

      Whether OTLP forwarding is enabled.

    • endpointstringoptional

      OTLP endpoint URL (e.g., https://otel-collector.example.com/v1/logs).

      • OTLP endpoint must be between 1 and 2048 characters.
      • OTLP endpoint must be an HTTP(S) URL.
    • headersmap<string, string>

      HTTP headers to include with OTLP requests (e.g., for authentication). Values are masked when read back. Setting a header to its masked value keeps the stored value, provided that the endpoint stays the same.

Response Empty

No fields. The response is an empty JSON object.

Example

curl --fail-with-body \
  -H "Authorization: Bearer $NEXIGON_TOKEN" \
  -H "Content-Type: application/json" \
  -d '{
    "projectId": "<project-id>",
    "config": {
      "enabled": true,
      "headers": {
        "<key>": "<string>"
      }
    }
  }' \
  $NEXIGON_HUB_URL/api/v1/actions/invoke/projects_SetOtlpConfig
{}