GET /files
Download a file
Parameters
Agentbox-Sandbox-Id·string· header · requiredIdentifier of the sandbox that receives the request.
Agentbox-Sandbox-Port·integer· header · requiredInternal envd HTTP port exposed through the sandbox proxy.
Default:
49983path·string· query · optionalPath to the file, URL encoded. Can be relative to the user's home directory (e.g. "file.txt" resolves to ~/file.txt).
username·string· query · optionalUser for setting file ownership and resolving relative paths. Defaults to the sandbox's default user.
signature·string· query · optionalSignature used for file access permission verification.
signature_expiration·integer· query · optionalUnix timestamp (seconds) after which the signature expires. Only used with the signature parameter.
Responses
200
Entire file downloaded successfully.
Content-Type: application/octet-stream
Schema: string
The raw file content
Format: binary
400
Invalid path
Content-Type: application/json
Schema: Error
message·string· requiredError message
code·integer· requiredError code
401
Invalid user
Content-Type: application/json
Schema: Error
message·string· requiredError message
code·integer· requiredError code
404
File not found
Content-Type: application/json
Schema: Error
message·string· requiredError message
code·integer· requiredError code
406
Requested encoding is not supported
Content-Type: application/json
Schema: Error
message·string· requiredError message
code·integer· requiredError code
500
Internal server error
Content-Type: application/json
Schema: Error
message·string· requiredError message
code·integer· requiredError code