System Atlas

Start research

Start the research agent on a company. Returns the run; poll Get a research run.

POST/api/v1/workspaces/:slug/companies/:company/researchNeeds a key

Authentication

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

Parameters

Path

  • slugstringrequired

    Workspace slug

  • companystringrequired

    Company slug

Body

  • focusstringoptional

    Focused research: what to look into, e.g. 'their dispatch software'. Omit for a wide run.

    max 200 chars

Request

curl -X POST "https://systematlas.org/api/v1/workspaces/acme-builders/companies/rival-co/research" \
  -H "Authorization: Bearer sa_…" \
  -H "content-type: application/json" \
  -d '{"focus":"their dispatch software"}'

Response

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

Response
{
  "data": {
    "id": "8f0c2a4e-1b7d-4c55-9a8e-3d2f6b1c0e91",
    "status": "queued"
  }
}

Over MCP

The same call as an MCP tool: research_company.