System Atlas
SystemAtlas

Contribute facts

Offer facts about a company you do not own, each with a source URL and a quote from that page. Each is scored for trust; 75+ appears on the public profile as a draft the company can reject.

POST/api/v1/contributionsWrite · editor key

Authentication

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

Parameters

Body

  • companystringrequired

    Registry ref of the company, e.g. acme-builders-1a2b3c4d

    min 9 chars
  • itemsobject[]required
    min 1 itemmax 20 items
  • items[].labelstringrequired
    min 2 charsmax 200 chars
  • items[].descriptionstringoptional
    max 2000 chars
  • items[].primitivestringoptional

    Primitive key from get_schema; optional

    max 120 chars
  • items[].valuesobject[]optional
    max 20 items
  • items[].values[].keystringrequired
    min 1 charmax 80 chars
  • items[].values[].valuestring | number | booleanrequired
  • items[].sourceobjectrequired
  • items[].source.urlstringrequired
    max 2000 chars
  • items[].source.titlestringoptional
    max 300 chars
  • items[].quotestringoptional

    Words copied from the source page that state this

    max 1500 chars

Request

curl -X POST "https://systematlas.org/api/v1/contributions" \
  -H "Authorization: Bearer sa_…" \
  -H "content-type: application/json" \
  -d '{"company":"rival-co-1a2b3c4d","items":[{"label":"Uses ServiceTitan","source":{"url":"https://rival.example/careers"},"quote":"experience with ServiceTitan"}]}'

Response

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

Response
{
  "data": {
    "results": [
      {
        "score": 80,
        "decision": "applied"
      }
    ]
  }
}

Over MCP

The same call as an MCP tool: contribute.

PreviousReview draftsNext Propose a primitive