Files

#Files on a record

Address

https://<your-org>.brambleit.cloud/atlas/api/files

Requires

Signed-in browser session (the sso_session / session_id cookies from Bramble sign-in).
Licence: Atlas.

Query parameters

Response 200

{
  "files": [
    {
      "id": 42,
      "filename": "Example filename",
      "mime": "string",
      "size": 1,
      "uploaded_name": "Example uploaded name",
      "created_at": "2026-11-12T09:30:00.000Z"
    }
  ]
}

Example request

// From a page served by Bramble (uses the signed-in session)
const res = await fetch('/atlas/api/files', {
  method: 'GET',
  credentials: 'include',
});
const data = await res.json();

#Attach a file

Address

https://<your-org>.brambleit.cloud/atlas/api/files

Requires

Signed-in browser session (the sso_session / session_id cookies from Bramble sign-in).
Licence: Atlas.

Query parameters

Response 200

{
  "file": {
    "id": 42,
    "filename": "Example filename",
    "mime": null,
    "size": 1,
    "url": "https://example.com/…"
  }
}

Errors

Example request

// From a page served by Bramble (uses the signed-in session)
const res = await fetch('/atlas/api/files', {
  method: 'POST',
  credentials: 'include',
});
const data = await res.json();

#Download a file

Address

https://<your-org>.brambleit.cloud/atlas/api/files/:id

Requires

Signed-in browser session (the sso_session / session_id cookies from Bramble sign-in).
Licence: Atlas.

Path parameters

Query parameters

Errors

Example request

// From a page served by Bramble (uses the signed-in session)
const res = await fetch('/atlas/api/files/42', {
  method: 'GET',
  credentials: 'include',
});
const data = await res.json();

#Delete a file

Address

https://<your-org>.brambleit.cloud/atlas/api/files/:id

Requires

Signed-in browser session (the sso_session / session_id cookies from Bramble sign-in).
Licence: Atlas.

Path parameters

Response 200

{
  "ok": true
}

Errors

Example request

// From a page served by Bramble (uses the signed-in session)
const res = await fetch('/atlas/api/files/42', {
  method: 'DELETE',
  credentials: 'include',
});
const data = await res.json();