Bonsi

Developer API

Bonsi API

Script against your own projects and tasks with a REST API. Authenticate with an API key — it acts as you, with full access to your data.

Base URL

https://bonsi.com.co/api

Authentication

Create an API key in Settings → API keys (the secret is shown once). Send it as a Bearer token on every request:

Authorization: Bearer ak_...

Keep your key secret — anyone with it has full access to your account's data. Revoke a leaked key anytime from Settings.

curl -H "Authorization: Bearer ak_..." \
  https://bonsi.com.co/api/projects

Endpoints

All paths are relative to the base URL. Request and response shapes mirror what the app uses.

Projects

  • GET/projectsList your projects
  • POST/projectsCreate a project
  • GET/projects/:idGet one project
  • PATCH/projects/:idUpdate a project
  • DELETE/projects/:idDelete a project
  • GET/projects/:id/graphFull graph: project + nodes + dependencies

Nodes

  • POST/nodesCreate a task node
  • PATCH/nodes/:idUpdate a node (name, status, parent, position…)
  • DELETE/nodes/:id?mode=delete|hardRemove a node (children re-parent to its parent)
  • GET/nodes/:id/filesList a node's files
  • POST/nodes/:id/files/signMint a presigned upload URL
  • POST/nodes/:id/filesRecord an uploaded file
  • POST/nodes/:id/tagsAttach a tag
  • DELETE/nodes/:id/tags/:tagIdDetach a tag

Dependencies

  • POST/dependenciesAdd a "depends on" link (blocker → blocked)
  • DELETE/dependencies/:idRemove a dependency

Tags

  • GET/tagsList your tags
  • POST/tagsCreate (or reuse) a tag
  • DELETE/tags/:idDelete a tag

Files

  • GET/files/:id/linkShort-lived signed download link
  • DELETE/files/:idDelete a file