// Layer 3 raw HTTP: any endpoint not yet covered by a flow or resource verb.
Manage Droploft documents (drops): upload, list, get, content, share, publish, delete.
Lofts: types, switching, listing, member operations.
Droploft v2 CLI: authentication, configuration, profiles, and patterns shared across all domains.
Background task runs — list, inspect, retry. Use this to debug async failures from doc +upload, publish, etc.
Workspaces: switching, listing, members, navigation tree.
| name | droploft-api |
| version | 0.2.0 |
| description | Layer 3 raw HTTP: any endpoint not yet covered by a flow or resource verb. |
| metadata | {"requires":{"bins":["droploft"],"skills":["droploft-shared"]},"cliHelp":"droploft api --help"} |
Use this when the higher-level layers don't cover what you need. The CLI takes care of authentication and the /v1 prefix; you supply the method, path, and body.
droploft api GET /v1/auth/me
droploft api GET /v1/documents
droploft api GET /v1/lofts/<id>/documents
droploft api POST /v1/documents --data '{"title":"x","content_hash":"...","original_bytes":12,"kind":"markdown"}'
droploft api PATCH /v1/documents/<id>/share-link --data '{"share_enabled":false}'
droploft api DELETE /v1/documents/<id>
Body forms:
--data '{"k":"v"}'--data @./payload.jsonBefore writing a --data body, look up the schema:
droploft schema search workspace
droploft schema get workspaces.create
droploft api GET /v1/documents --jq '.[].id'
droploft api GET /v1/me/navigation --jq '.workspaces[].name'
droploft --verbose api GET /v1/lofts
# stderr shows method, URL, status, headers
If a flow or resource verb already covers the operation, prefer it — those layers carry retries, polling, and human-friendly errors that raw api skips.