API Reference
  1. Hubi Public API
  2. Brain

Upsert a file by folder + name (idempotent)

put
https://app.gethubi.ai/api/v1/workspaces//brain/files/by-name

The import primitive for reference files. Address the folder by
folder (name - created at the root when missing) or folderId.
Provide exactly one of content (markdown/text) or body (typed
file body). Re-running overwrites in place - no duplicate names.

Recent Requests
Log in to see full request history
TimeStatusUser Agent
Retrieving recent requests…
LoadingLoading…
Path Params
uuid
required

Must match the workspace the API key belongs to (403 otherwise).

Body Params
string

Folder name; wins when folderId is absent.

uuid | null
string
required
length ≤ 200
string

Markdown/text content (text files).

body
object

Typed file body, discriminated by type. Text files carry content;
binary types (document, image) reference an uploaded
storagePath plus mime, size and ext.

string
enum

private = visible to the key's actor only; shared = workspace-wide.

Allowed:
Responses

Updated 27 days ago

Did this page help you?
Language
Credentials
Bearer
hubi_sk_...
LoadingLoading…
Response
Click Try It! to start a request and see the response here! Or choose an example:
application/json

Updated 27 days ago

Did this page help you?