Diagrams

#Get a diagram

Address

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

Requires

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

Path parameters

Response 200

{
  "diagram": null
}

Example request

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

#Save a diagram

Address

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

Requires

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

Path parameters

Request body JSON

Response 200

{
  "ok": true,
  "version": null
}

Example request

// From a page served by Bramble (uses the signed-in session)
const res = await fetch('/atlas/api/diagrams/42', {
  method: 'PUT',
  credentials: 'include',
  headers: { 'Content-Type': 'application/json' },
  body: JSON.stringify({"base_version":12.5,"name":"Example name","description":"string","location_id":7,"pinned":false,"thumb":"…","data":"…","checkpoint":"…"}),
});
const data = await res.json();

#Archive a diagram

Address

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

Requires

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

Path parameters

Response 200

{
  "ok": true
}

Example request

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

#Copy a diagram

Address

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

Requires

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

Path parameters

Request body JSON

Response 200

{
  "diagram": {
    "id": 42
  }
}

Example request

// From a page served by Bramble (uses the signed-in session)
const res = await fetch('/atlas/api/diagrams/42/duplicate', {
  method: 'POST',
  credentials: 'include',
  headers: { 'Content-Type': 'application/json' },
  body: JSON.stringify({"name":"Example name"}),
});
const data = await res.json();

#A diagram's versions

Address

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

Requires

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

Path parameters

Response 200

{
  "versions": [
    {
      "id": 42,
      "version": 1,
      "name": "Example name",
      "saved_name": "Example saved name",
      "saved_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/diagrams/42/versions', {
  method: 'GET',
  credentials: 'include',
});
const data = await res.json();

#Get a diagram version

Address

https://<your-org>.brambleit.cloud/atlas/api/diagrams/:id/versions/:vid

Requires

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

Path parameters

Response 200

{
  "version": {
    "id": 42,
    "diagram_id": 7,
    "version": 1,
    "name": "Example name",
    "data": "string",
    "saved_by": 1,
    "saved_name": "Example saved name",
    "saved_at": "2026-11-12T09:30:00.000Z"
  }
}

Errors

Example request

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

#Restore a diagram version

Address

https://<your-org>.brambleit.cloud/atlas/api/diagrams/:id/versions/:vid/restore

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/diagrams/42/versions/1/restore', {
  method: 'POST',
  credentials: 'include',
});
const data = await res.json();