MAPI Documentation

The Meta API (MAPI) lets you create dynamic data structures (entities) and manage records programmatically. Think of it as a runtime database builder — define your schema via API, and MAPI creates the tables and CRUD endpoints automatically.

Authentication

MAPI uses Bearer token authentication. Entity management operations (creating, updating, deleting entities) also require an X-Project-ID header. Record operations include the project ID in the URL path instead.

# Entity management (meta operations)
Authorization: Bearer {your_api_token}
X-Project-ID: {your_project_id}

# Record operations (project ID in URL)
Authorization: Bearer {your_api_token}

Base URL

https://api.websitepublisher.ai/mapi

All MAPI endpoints use the /mapi prefix. The full API gateway also provides:

Entities

Entities are like database tables. You define the structure, MAPI creates the table and all CRUD routes automatically.

{
    "name": "blogpost",
    "plural": "blogposts",
    "description": "Blog articles with publish status",
    "public_read": false,
    "properties": [
        {"name": "title", "type": "varchar", "length": 200, "required": true},
        {"name": "content", "type": "text", "required": true},
        {"name": "published", "type": "tinyint", "default": 0},
        {"name": "published_at", "type": "datetime"}
    ]
}

Update Entity

Update entity metadata such as the plural name, description, or public_read access flag.

{
    "public_read": true,
    "description": "Portfolio showcase items visible to the public"
}

{
    "success": true,
    "data": {
        "name": "showcase",
        "plural": "showcases",
        "public_read": true,
        "properties": [...]
    }
}

Properties

Properties define the fields (columns) of your entity. You can add properties at entity creation or afterwards.

{
    "name": "author",
    "type": "varchar",
    "length": 100
}

Property Types

Each property has a type that determines how data is stored and validated.

Property Definition Fields

Naming Rules

Entity Names

Entity names must match the following pattern:

/^[a-zA-Z_][a-zA-Z0-9_]*$/

Property Names

Property names follow the same rules as entity names, but the following names are reserved and cannot be used:

Records (CRUD)

Once you've created an entity, you can create, read, update, and delete records. The project ID is part of the URL path for all record operations.

{
    "title": "My First Blog Post",
    "content": "This is the content...",
    "published": 1,
    "published_at": "2026-01-13 10:00:00"
}

{
    "published": 1,
    "published_at": "2026-05-01 12:00:00"
}

Pagination

Use query parameters on the list records endpoint to control pagination and sorting:

# Get records 11-20
GET /mapi/project/{id}/{entity}?limit=10&offset=10

Search & Filter

{
    "filters": {
        "published": 1,
        "author": "Jane"
    }
}

Bulk Operations

Perform multiple create, update, or delete operations in a single request for better performance.

{
    "records": [
        {"title": "Post One", "published": 1},
        {"title": "Post Two", "published": 0},
        {"title": "Post Three", "published": 1}
    ]
}

{
    "records": [
        {"id": 1, "published": 1},
        {"id": 2, "published": 1}
    ]
}

{
    "ids": [1, 2, 3]
}

Public Read Access

Entities with public_read enabled expose read-only endpoints that require no authentication. This is useful for loading data directly from client-side JavaScript — for example, displaying a portfolio, product catalog, or blog on your website.

{
    "success": true,
    "data": [
        {"id": 1, "title": "Project Alpha", "created_at": "..."},
        {"id": 2, "title": "Project Beta", "created_at": "..."}
    ],
    "pagination": {
        "limit": 50,
        "offset": 0,
        "total": 2
    }
}

Client-side JavaScript Example

// Fetch public data directly from the browser — no API key needed
const response = await fetch(
    'https://api.websitepublisher.ai/mapi/public/project/22254/showcase'
);
const { data } = await response.json();

data.forEach(item => {
    console.log(item.title, item.description);
});

Complete Example

Building a product catalog with public access:

# 1. Create the product entity with public read enabled
curl -X POST "https://api.websitepublisher.ai/mapi/entities" \
  -H "Authorization: Bearer YOUR_TOKEN" \
  -H "X-Project-ID: {project_id}" \
  -H "Content-Type: application/json" \
  -d '{
    "name": "product",
    "plural": "products",
    "public_read": true,
    "properties": [
      {"name": "title", "type": "varchar", "length": 200, "required": true},
      {"name": "slug", "type": "varchar", "length": 100, "required": true},
      {"name": "description", "type": "text"},
      {"name": "price", "type": "int"},
      {"name": "in_stock", "type": "tinyint", "default": 1}
    ]
  }'

# 2. Add a product
curl -X POST "https://api.websitepublisher.ai/mapi/project/{project_id}/product" \
  -H "Authorization: Bearer YOUR_TOKEN" \
  -H "Content-Type: application/json" \
  -d '{
    "title": "Wireless Keyboard",
    "slug": "wireless-keyboard",
    "description": "Ergonomic wireless keyboard with backlight",
    "price": 4999,
    "in_stock": 1
  }'

# 3. Add more products in bulk
curl -X POST "https://api.websitepublisher.ai/mapi/project/{project_id}/product/bulk" \
  -H "Authorization: Bearer YOUR_TOKEN" \
  -H "Content-Type: application/json" \
  -d '{
    "records": [
      {"title": "USB-C Hub", "slug": "usb-c-hub", "price": 2999, "in_stock": 1},
      {"title": "Monitor Stand", "slug": "monitor-stand", "price": 3499, "in_stock": 0}
    ]
  }'

# 4. List in-stock products (authenticated)
curl -X POST "https://api.websitepublisher.ai/mapi/project/{project_id}/product/search" \
  -H "Authorization: Bearer YOUR_TOKEN" \
  -H "Content-Type: application/json" \
  -d '{"filters": {"in_stock": 1}}'

# 5. Fetch products publicly (no auth needed — public_read is on)
curl "https://api.websitepublisher.ai/mapi/public/project/{project_id}/product?limit=10"