Robot Resources

APIs for listing files associated with a robot and downloading them.

---

List Robot Resources

Cloud

Returns all resource files (recordings, logs, uploads) associated with a robot.

Endpoint

GET /robots/{robotId}/resources

Request Headers

{
  "authorization": "bearer <access_token>"
}

Path Parameters

• robotId (string): The unique identifier of the robot.

Response Fields

Field	Type	Description
resourceId	string	Unique identifier of the resource file
name	string	File name
type	string	MIME type (e.g., video/mp4)
size	long	File size in bytes
createdAt	datetime	Upload timestamp (UTC)

Response Example

{
  "resources": [
    {
      "resourceId": "67a71b1e-f035-45b3-805e-4f1b62f3c54b",
      "name": "rtsp_2026-07-05__10-47-23.mp4",
      "type": "video/mp4",
      "size": 3258387,
      "createdAt": "2026-07-06T10:13:33.291Z"
    },
    {
      "resourceId": "eec7c89d-0afd-4ee7-8b0b-74f4c945fd90",
      "name": "video0_device_2026-07-06__13-12-38.mp4",
      "type": "video/mp4",
      "size": 22518592,
      "createdAt": "2026-07-06T10:14:44.511Z"
    }
  ]
}

Local

Returns local DataLog resources for the selected robot. Requests for configured local-fleet members are proxied to the member agent. Results are sorted newest first, capped at 5000 per request, and do not include thumbnails.

Endpoint

GET /robots/{robotId}/resources

Request Headers

{
  "authorization": "bearer <local-api-gateway-token>"
}

Response Example

{
  "resources": [
    {
      "resourceId": "resource-1",
      "name": "clip.mp4",
      "type": "video",
      "size": 1024,
      "createdAt": "2026-05-25T12:00:00Z"
    }
  ]
}

Known local resource types: video, csv, image, text, bag, unknown.

---

Get Resource Download URL

Cloud

Generates a pre-signed URL to download a specific resource file.

Endpoint

GET /robots/{robotId}/resource/{resourceId}/download

Request Headers

{
  "authorization": "bearer <access_token>"
}

Path Parameters

• robotId (string): The unique identifier of the robot.
• resourceId (string): The unique identifier of the resource. Use the resourceId from List Robot Resources.

Response Example

{
  "url": "https://objectstorage.eu-frankfurt-1.oraclecloud.com/p/<token>/n/<namespace>/b/<bucket>/o/<resourceId>?httpResponseContentDisposition=attachment%3B+filename%3D<filename>"
}

Error Responses

Status	Description
404 Not Found	The resource was not found or a download URL could not be generated.

Local

Returns the local DataLog file route for a resource.

Endpoint

GET /robots/{robotId}/resource/{resourceId}/download

Request Headers

{
  "authorization": "bearer <local-api-gateway-token>"
}

Path Parameters

• robotId (string): The ID of the local robot or a configured local-fleet member.
• resourceId (string): The unique identifier of the resource. Use the resourceId from List Robot Resources.

Response Example

{
  "url": "api/datalog/files/clip.mp4"
}

Common Errors

• 401: bearer token is missing or invalid.
• 404: robot id or resource id was not found, or the resource has no local download URL.