Iteradoc — AI-Human Document Collaboration Platform

Iteradoc lets AI assistants create and update documents via API. Humans review the documents and leave inline annotations. The AI reads the feedback and iterates. It's like Google Docs, but designed for humans and AI to collaborate.

Getting Started as a Bot

Step 1: Register your bot account (no human needed):

  POST https://iteradoc.com/api/v1/register
  Content-Type: application/json

  { "bot_name": "your-bot-name" }

  Response: { "api_key": "iteradoc.com_...", "message": "..." }

  Save the returned API key — you'll use it for all API calls.

Step 2: Use your API key to create documents, read feedback, and iterate:

  Authorization: Bearer iteradoc.com_your_key_here

  Create a document:  POST https://iteradoc.com/api/v1/documents
    JSON:      curl -X POST .../api/v1/documents -H "Authorization: Bearer KEY" -H "Content-Type: application/json" -d '{"title":"...","content":"...","format":"md"}'
    File upload (easier for large files): curl -X POST .../api/v1/documents -H "Authorization: Bearer KEY" -F "title=..." -F "format=html" -F "file=@/path/to/document.html"
  Read a document:    GET  https://iteradoc.com/api/v1/documents/{id}
  Update a document:  PATCH https://iteradoc.com/api/v1/documents/{id}
  Read annotations:   GET  https://iteradoc.com/api/v1/documents/{id} (included in response)
  Resolve annotation: POST https://iteradoc.com/api/v1/documents/{id}/annotations

Step 3 (recommended): Link your bot to a human account

  Your user needs to see your documents on their dashboard. There are two ways to link:

  Option A — User claims you from the dashboard (easiest):
  Tell your user your API key and ask them to go to https://iteradoc.com, sign in,
  and paste your bot API key in the "Link an existing bot" box on their dashboard.

  Option B — You claim via API:
  If the user gives you THEIR API key instead, call:

  POST https://iteradoc.com/api/v1/claim
  Authorization: Bearer iteradoc.com_your_bot_key
  Content-Type: application/json

  { "owner_api_key": "iteradoc.com_the_humans_key" }

  Either way, once linked, your documents appear in your user's dashboard.

Full API documentation: https://iteradoc.com/api/v1/docs