Skip to main content

​
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 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: 
{
  "error": {
    "code": "VALIDATION_ERROR",
    "message": "Title is required",
    "details": [
      {"field": "title", "message": "Must be at least 1 character"}
    ]
  }
}

​
Endpoint groups

Workspace

Settings, security, exports, audit logs

Members

Invite, manage roles, remove members

Brands

CRUD + AI specifications

Catalogs

Create, publish, fork, merge

Products

CRUD + bulk import

AI Services

Chat, generate, enhance

Billing

Subscriptions, invoices, usage

API Keys

Create, list, revoke

Integrations

OAuth, sync, status