Files

Change permissions

POST
/game-servers/{slice}/files/chmod

Sets the mode of each named entry.

mode is a string of octal digits, not a number. The node parses it base-8: a JSON number is rejected outright, and "420" — which looks decimal — is read as octal 420 and silently sets permissions you did not ask for. Send "0644", "0755", and quote it.

An entry that does not exist is skipped rather than failing the batch, so a 200 does not prove every path in it was real.

Authorization

orgApiKey game-servers.files.manage
AuthorizationBearer <token>

An 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

slice*string

The server's UUID, as returned by the list endpoint.

Formatuuid

Request 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

curl -X POST "https://example.com/game-servers/497f6eca-6276-4993-bfeb-53cbbbba6f08/files/chmod" \  -H "Content-Type: application/json" \  -d '{    "files": [      {        "file": "string",        "mode": "0644"      }    ]  }'
{  "ok": true,  "message": "string"}