System Atlas
SystemAtlas

Upload notes

Comments and the operating reality: workarounds, bottlenecks, manual hand-offs. Duplicates are skipped.

POST/api/v1/workspaces/:slug/upload/notesWrite · editor key

Authentication

Authorization: Bearer sa_… from the workspace owner or a member. Counts against the upload rate limit.

Parameters

Path

  • slugstringrequired

    Workspace slug

Body

  • companystringoptional

    Company slug; defaults to the workspace's own company

    min 1 charmax 80 chars
  • notesobject[]required
    min 1 itemmax 200 items
  • notes[].componentstringoptional

    Component id, clientId or label; omit for a company-level note

    min 1 charmax 200 chars
  • notes[].bodystringrequired
    min 1 charmax 4000 chars
  • notes[].kindenumoptionaldefault "comment"

    comment, or the operating reality it records

    commentworkaroundinformal_channelbottleneckdependencytacit_rulemanual_handoff

Request

curl -X POST "https://systematlas.org/api/v1/workspaces/acme-builders/upload/notes" \
  -H "Authorization: Bearer sa_…" \
  -H "content-type: application/json" \
  -d '{"notes":[{"component":"tool/quickbooks","kind":"manual_handoff","body":"Approved budgets are typed in by hand."}]}'

Response

200 with the result in data (abbreviated here). Errors are listed in Errors and limits.

Response
{
  "data": {
    "results": [
      {
        "component": "tool/quickbooks",
        "created": true
      }
    ]
  }
}

Over MCP

The same call as an MCP tool: upload_notes.

PreviousUpload flowsNext Upload a screenshot