Add a competitor

Authentication#

Authorization: Bearer sa_… (any valid key; reads also accept a signed-in browser session).

Parameters#

Path

• slugstringrequired

  Workspace slug

Body

• namestringrequired

  The competitor's name

  min 1 charmax 200 chars
• websitestringoptional

  Its website; research reads it

  max 300 chars
• regionstringoptional
  max 120 chars

Request#

curl -X POST "https://systematlas.org/api/v1/workspaces/acme-builders/companies" \
  -H "Authorization: Bearer sa_…" \
  -H "content-type: application/json" \
  -d '{"name":"Rival Co","website":"https://rival.example"}'

Response#

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

{
  "data": {
    "slug": "rival-co",
    "name": "Rival Co",
    "website": "https://rival.example"
  }
}

Over MCP#

The same call as an MCP tool: add_company.