System Atlas
SystemAtlas

Create your workspace

Create, or find by company name, your private workspace for your own company. Idempotent.

POST/api/v1/workspacesWrite · editor key

Authentication

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

Parameters

Body

  • namestringrequired

    Your company's name

    min 1 charmax 120 chars
  • websitestringoptional
    max 300 chars
  • descriptionstringoptional

    What the company does, in two or three sentences

    max 2000 chars
  • industrystringoptional

    Your best guess: 'construction', 'B2B SaaS', 'staffing agency'

    max 120 chars
  • businessModelstringoptional

    One of project, service, product, subscription, marketplace, staffing, agency_franchise, distribution, licensing, asset, or your words

    max 60 chars

Request

curl -X POST "https://systematlas.org/api/v1/workspaces" \
  -H "Authorization: Bearer sa_…" \
  -H "content-type: application/json" \
  -d '{"name":"Acme Builders","website":"acmebuilders.example","industry":"construction","businessModel":"project"}'

Response

201 (201 when created, 200 when it already existed) with the result in data (abbreviated here). Errors are listed in Errors and limits.

Response
{
  "data": {
    "created": true,
    "workspace": {
      "slug": "acme-builders",
      "name": "Acme Builders"
    },
    "company": {
      "slug": "client"
    },
    "next": "Call get_mapping_guide with this workspace slug."
  }
}

Over MCP

The same call as an MCP tool: create_my_workspace.

PreviousGet the mapping guideNext Add a competitor