Files API

Store and organize files and folders, create share links, manage workspaces and receive webhooks. Uses a files key.

Base   https://dev.bodek.us/v1/files
Auth   Authorization: Bearer bf_live_…

Switching from the old endpoint? Replace file.bodeksolutions.com/api/v1 with dev.bodek.us/v1/files — resource paths are identical.

Files

List files

Get a file

Download content

Upload a file

Multipart form upload. Scope files:write.

curl -X POST https://dev.bodek.us/v1/files/files \
  -H "Authorization: Bearer bf_live_XXXX" \
  -F "file=@report.pdf" -F "parent_id=AbCd1234"

Very large uploads can also be sent straight to file.bodeksolutions.com/api/v1/files — the same key works on both.

Rename or move

Delete

Folders

Folders are files with type: "folder". List a folder's contents with the files endpoint and a parent_id; create folders here.

curl -X POST https://dev.bodek.us/v1/files/folders \
  -H "Authorization: Bearer bf_live_XXXX" -H "Content-Type: application/json" \
  -d '{ "name": "Invoices", "parent_id": null }'

Share links

Create or change a share

Make a file public or limited, optionally with a password and expiry. Scope share:write.

{
  "file_id": "AbCd1234",
  "status": "public",
  "password": "optional",
  "expires_at": "2026-12-31T23:59:59Z"
}

Change share status

Read share status

Revoke a share

Workspaces

A key is bound to one workspace; these endpoints read and manage it.

Webhooks

Subscribe to events (file created/updated/deleted, share changed, member events). Deliveries are signed with the webhook secret.

Key info & health

Returns the calling key's service, scopes and owner.

Liveness — no auth required.

Scopes