System Atlas
SystemAtlas

Pull from Optimal Engine

Import the connected cloud engine's facts about a company as private drafts.

POST/api/v1/workspaces/:slug/optimal-engine/pullWrite · 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; omit for every company (send, export) or the client (pull, import). For pull and import a domain adds the company once.

    max 200 chars
  • namestringoptional

    Name for a company added by domain

    max 120 chars
  • include_pendingbooleanoptional

Request

curl -X POST "https://systematlas.org/api/v1/workspaces/acme-builders/optimal-engine/pull" \
  -H "Authorization: Bearer sa_…" \
  -H "content-type: application/json" \
  -d '{}'

Response

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

Response
{
  "data": {
    "imported": 1,
    "skipped": 43
  }
}

Over MCP

The same call as an MCP tool: optimal_engine_pull.

PreviousSend to Optimal EngineNext Export for a local Optimal Engine