Download a URL onto the server
Has the node fetch url straight into the server's files, without the
bytes passing through you or through us.
Accepted, not finished. The node answers immediately and downloads in
the background; the identifier is a handle to watch with
GET files/pull. A 200 here says the download started.
The URL must be http or https and must not resolve to a private,
loopback, link-local or otherwise internal address — those are refused
before DNS, and again by the node. A node may also have remote downloads
switched off entirely, and each server is capped at three at once; both
come back as a 409.
Authorization
orgApiKey game-servers.files.manageAn organisation API key, prefixed tbk_. Create one under
Organisation to API keys; the plaintext is shown once.
The scopes listed on each operation are the abilities the key must carry. They are not OAuth scopes and are not negotiated per request.
In: header
Scope: game-servers.files.manage
Path Parameters
The server's UUID, as returned by the list endpoint.
uuidRequest Body
application/json
TypeScript Definitions
Use the request body type in TypeScript.
Response Body
application/json
application/json
application/json
application/json
application/json
application/json
application/json
application/json
curl -X POST "https://example.com/game-servers/497f6eca-6276-4993-bfeb-53cbbbba6f08/files/pull" \ -H "Content-Type: application/json" \ -d '{ "url": "http://example.com" }'{ "ok": true, "message": "string", "identifier": "string"}