What's New?Connect Agent Releases Book a Demo Pricing

Devices

JFrog Connect API requests that act on the edge device or retrieve information from one or more devices.

Was this helpful?

Get List of Devices

get

Returns a list of devices according to the filter options that you specify and information about each device.

Authorizations

Path parameters

project_keystringRequired

The project key of the relevant project in the account. An account can have multiple projects. If you don't know the project key, you can find it in the Settings of the web UI in the Projects tab.

Query parameters

groupstringOptional

The name of the group the device belongs to. If you do not specify a group name, then all the devices in the project will be specified.

tagsstring[]Optional

Returns devices having this tag. To search for multiple tags, for example, records having tag-a, or tag-b, or tag-c, enter a separate key and value for each tag to include. (For example, a new row in the Query Params table for each tag.)

afterstringOptional

Returns the next set (i.e., next cursor) of records. This is applicable whenever the number of devices to be returned is greater than the limit. For example, if the first cursor returned the limit of 100 records, this parameter is required to receive the next 100 records. The value of the input string can be found at the end of the output of the current cursor.

limitinteger · min: 1 · max: 1000Optional

The number of devices to show in each cursor of data returned. Default is 100, and maximum is 1000. Must be positive integer.

Default: 100

Responses

200

application/json

403

Forbidden

application/json

get

GET /api/v2/{project_key}/devices HTTP/1.1
Host: api.connect.jfrog.io
Authorization: Bearer JWT
Accept: */*

[
  {
    "device_name": "text",
    "last_keepalive": "2025-05-06T09:41:15.941Z",
    "agent_version": "text",
    "device_ip": "text",
    "cpu_usage": 1,
    "ram_usage": 1,
    "current_disk_usage": 1,
    "disk_size": 1,
    "address": "text",
    "lat": 1,
    "lng": 1,
    "is_update_trigger_set": true,
    "description": "text",
    "registered_date": "2025-05-06T09:41:15.941Z",
    "device_uuid": "text",
    "device_status": "text",
    "project": "text"
  }
]

Get Device

get

Returns the details about a single device.

Path parameters

project_keystringRequired

The project key of the relevant project in the account. An account can have multiple projects. If you don't know the project key, you can find it in the Settings of the web UI in the Projects tab.

device_uuidstringRequired

The UUID of the device you are acting on. This is the unique identifier of the device in Connect, for example, d-4cfe-4e51. You can find the UUID in the ID column of the Devices table in the Devices page of the web UI.

Query parameters

enrich_infobooleanOptional

Returns additional information about the device, including app_name, version, mac_addresses, tags, and updates. Updates includes the last five updates to the device. Default is False.

Responses

200

application/json

404

Not Found

application/json

get

GET /api/v2/{project_key}/devices/{device_uuid} HTTP/1.1
Host: api.connect.jfrog.io
Accept: */*

{
  "address": "270 E Caribbean Dr, Sunnyvale, CA 94089, USA",
  "agent_version": "6.0",
  "apps": [
    {
      "app_name": "app name",
      "version": "1.0"
    }
  ],
  "cpu_usage": 1,
  "current_disk_usage": 3282,
  "description": "",
  "device_ip": "18.209.245.178",
  "device_name": "zzzzz",
  "device_status": "offline",
  "device_uuid": "d-abfa-d82b",
  "disk_size": 214735,
  "group": "Tel-Aviv",
  "is_update_trigger_set": false,
  "last_keepalive": "2022-11-29 14:23:44",
  "lat": 37.4157324,
  "lng": -122.0138817,
  "mac_address": [
    "02:1f:fa:3c:7b:11",
    "02:42:81:09:b2:42"
  ],
  "project": "demo",
  "ram_usage": 11,
  "registered_date": "2022-11-03 12:48:23",
  "tags": [
    "tag1",
    "tag2",
    "tag3"
  ],
  "updates": [
    {
      "apps_updated": [],
      "comment": "",
      "deployment_finish_time": "",
      "deployment_schedule_time": "2024-06-25 15:05:17",
      "deployment_start_time": "",
      "deployment_status": "pending",
      "deployment_type": "manual",
      "flow_name": "conan-flow"
    },
    {
      "apps_updated": [],
      "comment": "",
      "deployment_finish_time": "",
      "deployment_schedule_time": "2024-06-20 15:33:58",
      "deployment_start_time": "",
      "deployment_status": "pending",
      "deployment_type": "manual",
      "flow_name": "my echo"
    },
    {
      "apps_updated": [],
      "comment": "",
      "deployment_finish_time": "",
      "deployment_schedule_time": "2024-05-30 09:43:57",
      "deployment_start_time": "",
      "deployment_status": "pending",
      "deployment_type": "manual",
      "flow_name": "update with file"
    },
    {
      "apps_updated": [],
      "comment": "",
      "deployment_finish_time": "",
      "deployment_schedule_time": "2024-05-02 15:41:22",
      "deployment_start_time": "",
      "deployment_status": "pending",
      "deployment_type": "manual",
      "flow_name": "Try Verification v2"
    },
    {
      "apps_updated": [],
      "comment": "",
      "deployment_finish_time": "",
      "deployment_schedule_time": "2024-05-02 08:44:21",
      "deployment_start_time": "",
      "deployment_status": "pending",
      "deployment_type": "manual",
      "flow_name": "Try Verification v2"
    }
  ]
}

Update Device

patch

Updates information on a device. You can make updates using the Add, Replace, and Remove operations, and you can replace values of multiple parameters in a single API request. This request is based on the RFC 6902 specification.

For the "tags" value, spaces are allowed in the tag name. You can add multiple tag values, with each value separated by a comma.

Path parameters

project_keystringRequired

The project key of the relevant project in the account. An account can have multiple projects. If you don't know the project key, you can find it in the Settings of the web UI in the Projects tab.

device_uuidstringRequired

Header parameters

Content-TypestringRequiredExample: application/json-patch+json

Body

Responses

200

application/json

400

Bad Request

application/json

401

Unauthorized

application/json

404

Not Found

application/json

patch

PATCH /api/v2/{project_key}/devices/{device_uuid} HTTP/1.1
Host: api.connect.jfrog.io
Content-Type: application/json
Accept: */*
Content-Length: 67

{
  "operations": [
    {
      "op": "add",
      "path": "tags",
      "value": [
        "tag1",
        "tag2"
      ]
    }
  ]
}

{
  "address": "44091 Ashburn Shopping Plz, Ashburn, VA 20147, USA",
  "apps": [],
  "cpu_usage": 1,
  "current_disk_usage": 1124,
  "description": "",
  "device_ip": "54.145.235.216",
  "device_name": "New Device",
  "device_status": "online",
  "device_uuid": "d-c06c-a10f",
  "disk_size": 8218,
  "group_name": "Production",
  "is_update_trigger_set": false,
  "last_keepalive": "2024-05-02 07:12:57",
  "lat": 39.0432152,
  "lng": -77.4745442,
  "mac_address": [
    "0e:fb:e1:d0:69:09"
  ],
  "project": "demo",
  "ram_usage": 7,
  "registered_date": "2024-05-01 08:41:16",
  "tags": [
    "arnold the king",
    "john_tag_test",
    "jeff the king",
    "mike_tag_test"
  ],
  "updates": [],
  "agent_version": "6.2"
}

Move Device

post

Moves a device from one project to another. You need to specify both the destination project and a destination group in that project. For more information about the data that is transferred with the device, see Move Device between Projects in the web UI user documentation.

Authorizations

Path parameters

project_keystringRequired

The project key of the relevant project in the account. An account can have multiple projects. If you don't know the project key, you can find it in the Settings of the web UI in the Projects tab.

device_uuidstringRequired

Body

destination_project_keystringOptional

The project key to which the device is transferred.

destination_group_namestringOptional

The group name in the destination project to which the device is transferred.

Responses

200

application/json

Responsestring

400

Bad Request

application/json

404

Not Found

application/json

post

POST /api/v2/{project_key}/devices/{device_uuid}/move HTTP/1.1
Host: api.connect.jfrog.io
Authorization: Bearer JWT
Content-Type: application/json
Accept: */*
Content-Length: 79

{
  "destination_project_key": "project_key",
  "destination_group_name": "group_name"
}

{
  "message": "Device moved successfully"
}