API

The workspace, over HTTP.

Read and write tasks, wiki pages, goals and chat over REST with scoped tokens. Agent tokens are open on every plan; general API tokens need Starter.

Request
curl -H "X-Api-Key: $ITHURA_TOKEN" \
  https://api.ithura.com/v1/workspaces/acme/issues/
Every reply carries

X-RateLimit-Remaining
X-RateLimit-Reset

The rules
  • Scoped tokens

    A token carries your permissions, narrowed to the scopes you grant. A call that needs one it lacks is refused and names the scope.

  • Sixty a minute

    A sliding window per token, not per address. Back off until X-RateLimit-Reset when you see 429.

  • One token surface

    /v1/workspaces/{workspace}/... is the surface to build against. DMs, huddles and reminders are deliberately not on it.

Issues
issues:read / write / delete
Projects
projects:read / write
Wiki pages
pages:read / write
Chat
chat:read / write
Goals
goals:read / write
Agent runs
agent runs, scoped to the agent