NUnullplatform
Agent

List agents

Changed on

Lists agents within an organization.

get/controlplane/agent

Request

  • Base URL
    https://api.nullplatform.com
  • URL
    https://api.nullplatform.com/controlplane/agent
  • Auth
    HTTP bearer

Query parameters

organization_idinteger

The ID of the organization.

account_idinteger

The ID of the account.

nrnstring

Filter agents by a specific NRN.

status'active' | 'inactive'

Status of the scope.

tagsstring

Object containing key-value pairs representing tags to be matched for applying the configuration.

Response

The list of agents matching the query.

Example response

{
  "paging": {
    "limit": 200
  },
  "results": [
    {
      "id": "f47ac10b-58cc-4372-a567-0e02b2c3d479",
      "name": "my-agent-name",
      "nrns": [
        "organization=1:account=2",
        "organization=1:account=2:namespace=3"
      ],
      "last_heartbeat": "2021-01-02T00:00:00Z",
      "runtime": "k8s",
      "version": "1.0.0",
      "status": "active",
      "created_at": "2021-01-02T00:00:00Z",
      "updated_at": "2021-01-02T00:00:00Z",
      "capabilities": [
        {
          "id": "commandexecutor1",
          "status": "active",
          "version": "1.0.0",
          "configuration_id": "config1",
          "desired_configuration_id": "desired_config1",
          "is_default_configuration": true,
          "current_configuration_expires_at": "2024-07-12T15:00:00Z",
          "provider": "commandexecutor1",
          "category": "executor1",
          "created_at": "2021-01-02T00:00:00Z",
          "updated_at": "2021-01-02T00:00:00Z"
        }
      ]
    }
  ]
}

Changes

  • 728d4df70ca1Revision changes
    • breaking

      the response property became optional for the status

    • breaking

      the response property became optional for the status

    • breaking

      removed the required property from the response with the status

    • breaking

      removed the required property from the response with the status

    • breaking

      removed the required property from the response with the status

    • breaking

      removed the required property from the response with the status

    • info

      media type application/json was changed to a more specific media type application/problem+json for the response status

    • info

      media type application/json was changed to a more specific media type application/problem+json for the response status

    • info

      added the optional property to the response with the status

    • info

      added the optional property to the response with the status

    • info

      added the optional property to the response with the status

    • info

      added the optional property to the response with the status

    • info

      added the optional property to the response with the status

    • info

      response property message deprecated

    • info

      response property message deprecated

    • info

      added the required property to the response with the status

    • info

      added the required property to the response with the status

    • info

      added the required property to the response with the status

    • info

      added the required property to the response with the status

    • info

      added the required property to the response with the status

    • info

      added the required property to the response with the status