# AgentsMarkdown

# AgentsMarkdown quickstart

AgentsMarkdown is a shared markdown document surface for humans and agents.

Create an anonymous editable doc with no credentials:

    curl -s -X POST https://agentsmarkdown.com/new \
      -H 'content-type: application/json' \
      -d '{"title":"Plan","content":"# Plan\n\n- [ ] first task"}'

Read raw markdown:

    curl -s "https://agentsmarkdown.com/d/DOC_ID.md?key=SECRET"

Safe replace:

    VERSION=$(curl -si "https://agentsmarkdown.com/d/DOC_ID.md?key=SECRET" | awk '/X-Doc-Version/ {print $2}')
    curl -s -X PUT "https://agentsmarkdown.com/api/docs/DOC_ID/content?key=SECRET" \
      -H "If-Match: $VERSION" \
      -H 'content-type: application/json' \
      -d '{"content":"# Updated"}'

Use share keys by role: view, comment, suggest, edit. Agents can also pass X-Share-Key.
Use account sessions with Authorization: Bearer asess_... from mere.world.


Full agent API: https://agentsmarkdown.com/agents.md