Create base

Create a base: a set of related tables, such as Orders and Customers, that belongs to one project.

POST/v1/w/{workspace}/bases

Send an Idempotency-Key. This may answer 202 while it waits for approval.

Path parameters

workspacestringrequired

Your workspace’s address name.

Headers

Idempotency-Keystring

8–100 characters. Repeat the same key and body to get the first outcome back instead of writing twice.

Body

namestringrequired

What people see in Olamma, like “Sales”.

projectstring

The project it belongs to, from List projects. Leave out for General.

Response

baseobjectrequired

Details

Create a Tables base in a visible project.

Since 2026-12. Errors are listed in Errors.

cURL

curl -X POST "https://api.olamma.sh/v1/w/your-workspace/bases" \
  -H "Authorization: Bearer $OLAMMA_KEY" \
  -H "Idempotency-Key: <unique key>" \
  -H "content-type: application/json" \
  -d '{
    "name": "Sales",
    "project": "general"
  }'

Response 201

{
  "base": {
    "id": "<string>",
    "name": "<string>",
    "projectId": "<string>",
    "tables": [
      {
        "id": "<string>",
        "name": "<string>",
        "rowCount": 123
      }
    ]
  }
}