ReferenceWiKi API

Images

Images used in articles, spaces and collections.

Method	Path	Summary
GET	`/v1/app/kb/images/:id`	Serve image by ID (no auth required so <img> tags work)
POST	`/v1/app/kb/images`	Upload an image (multipart/form-data, field name: "image")

#Serve image by ID (no auth required so <img> tags work)

GET/v1/app/kb/images/:id

Serve image by ID (no auth required so <img> tags work). Registered before the license gate below so it's resolved directly and never reaches it — every other route in this file is defined after the gate and stays covered by it regardless.

Address: https://<your-org>.brambleit.cloud/api/v1/app/kb/images/:id
Requires: None: public, or protected by a token in the address or body.

Path parameters

Name	Type	Description
`id`required	integer

Response

A body.

Example request

Bash

curl -X GET 'https://<your-org>.brambleit.cloud/api/v1/app/kb/images/42' \
  -H "X-API-Key: $BRAMBLE_KEY"

JavaScript

const res = await fetch('https://<your-org>.brambleit.cloud/api/v1/app/kb/images/42', {
  method: 'GET',
  headers: { 'X-API-Key': process.env.BRAMBLE_KEY },
});
const data = await res.json();

Python

import os, requests

r = requests.get(
    "https://<your-org>.brambleit.cloud/api/v1/app/kb/images/42",
    headers={"X-API-Key": os.environ["BRAMBLE_KEY"]},
)
r.raise_for_status()
data = r.json()

PowerShell

$headers = @{ 'X-API-Key' = $env:BRAMBLE_KEY }
Invoke-RestMethod -Method GET -Uri 'https://<your-org>.brambleit.cloud/api/v1/app/kb/images/42' -Headers $headers

#Upload an image (multipart/form-data, field name: "image")

POST/v1/app/kb/images

Address: https://<your-org>.brambleit.cloud/api/v1/app/kb/images
Requires: Signed-in session, X-API-Key, or a Bramble app access token (Authorization: Bearer).
Licence: WiKi.

Request body

multipart/form-data with the file.

Response 201

Field	Type	Description
`id`	integer
`url`	string

Example response

JSON

{
  "id": 42,
  "url": "https://example.com/…"
}

Errors

Status	Message
400	No image file provided
404	User not found