Device Files

JFrog Connect API request to retrieve files and folders (such as logs) from devices.

Fetch Files

post

Triggers Connect to fetch files from the device you specify. For example, you can use this command to fetch logs from a device. The files are fetched from the device path you specify in the request body using the files_path attribute. You can specify a folder or a specific file.

The request returns a URL. You can use the Artifactory UI, API, or CLI to download the files from this URL. The files are not available immediately at the URL. They become available when the device uploads them and if the upload is successful.

Authorizations

bearerAuth

AuthorizationstringRequired

You will need to get an access token from the Connect web UI to use the Connect API v2. The v1 token will not work for v2.

Important: For security reasons, the new token generated by Connect will not be stored. Ensure that you copy the token and save it in a safe place.

Path parameters

project_keystringRequired

The fleet key of the relevant fleet in the account. An account can have multiple fleets (formerly called projects). If you don't know the fleet key, you can find it in the Fleet Settings of the web UI.

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

application/json

files_pathstringOptional

The path where the requested files are on the device.

Responses

200

OK

application/json

401

UNAUTHORIZED

application/json

404

NOT FOUND

application/json

post

/api/v2/{project_key}/devices/{device_uuid}/logs

HTTPcURLJavaScriptPython

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

{
  "files_path": "/home/path/to/file"
}

{
  "download_url": "https://example.jfrog.io/artifactory/connect-default-generic/upswift-general/devices/d-672a-f5e4/files/user_requested/logs_application/33835"
}