LogoLogo
What's New?Connect Agent ReleasesBook a DemoPricing
  • Documentation
  • Developers
  • Administration
  • API Reference
    • Connect API Reference
      • Devices
      • Deployments
      • Device Files
      • Port Tunneling
      • API Reference v1 (Legacy)
        • Device state
        • Bulk devices state
        • Get devices details
        • Change devices details
        • Deploy Update
        • Update Trigger
        • Tags
        • Apps
    • Create Access Token
  • GitHub Action
    • Deploy Device Update
Powered by GitBook
On this page

Was this helpful?

Export as PDF
  1. API Reference
  2. Connect API Reference

Devices

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

Last updated 9 days ago

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
group_namestringOptional

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
OK
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-30T04:57:33.800Z",
    "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-30T04:57:33.800Z",
    "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
OK
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_name": "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"
    }
  ]
}
  • GETGet List of Devices
  • GETGet Device
  • PATCHUpdate Device
  • POSTMove Device

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 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

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.

Header parameters
Content-TypestringRequiredExample: application/json-patch+json
Body
Responses
200
OK
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 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

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.

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
OK
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"
}
RFC 6902
Move Device between Projects