> ## Documentation Index
> Fetch the complete documentation index at: https://docs.alana.shopping/llms.txt
> Use this file to discover all available pages before exploring further.

# API Overview

> REST API with 90+ endpoints for programmatic access to Alana Shopping B2B.

## Base URL

```
https://app.alana.shopping/api
```

## Authentication

All API requests require authentication via Bearer token. Include your API key in the `Authorization` header:

```
Authorization: Bearer sk_live_your_api_key_here
```

See [Authentication](/authentication) for details on creating and managing API keys.

## Workspace context

Most endpoints are scoped to a workspace:

```
/api/workspace/{workspaceId}/...
```

Your API key must have access to the specified workspace.

## Request format

* **Content-Type**: `application/json` for all request bodies
* **Accept**: `application/json` for all responses
* **File uploads**: `multipart/form-data` for import endpoints

## Response format

All responses follow a consistent JSON structure. Successful responses return the resource directly. Errors return:

```json theme={null}
{
  "error": {
    "code": "VALIDATION_ERROR",
    "message": "Title is required",
    "details": [
      {"field": "title", "message": "Must be at least 1 character"}
    ]
  }
}
```

## Endpoint groups

<CardGroup cols={3}>
  <Card title="Workspace" icon="building" href="/api-reference/workspace/get-settings">
    Settings, security, exports, audit logs
  </Card>

  <Card title="Members" icon="users" href="/api-reference/members/list-members">
    Invite, manage roles, remove members
  </Card>

  <Card title="Brands" icon="tag" href="/api-reference/brands/list-brands">
    CRUD + AI specifications
  </Card>

  <Card title="Catalogs" icon="folder-open" href="/api-reference/catalogs/list-catalogs">
    Create, publish, fork, merge
  </Card>

  <Card title="Products" icon="box" href="/api-reference/products/list-products">
    CRUD + bulk import
  </Card>

  <Card title="AI Services" icon="sparkles" href="/api-reference/ai/chat">
    Chat, generate, enhance
  </Card>

  <Card title="Billing" icon="credit-card" href="/api-reference/billing/get-billing">
    Subscriptions, invoices, usage
  </Card>

  <Card title="API Keys" icon="key" href="/api-reference/api-keys/list-keys">
    Create, list, revoke
  </Card>

  <Card title="Integrations" icon="plug" href="/api-reference/integrations/authorize">
    OAuth, sync, status
  </Card>
</CardGroup>