Skip to main content

ACP API Endpoints

ACP exposes endpoints for synchronous, async, and batch order submission.

Endpoints

MethodEndpointDescription
POST/v1/tenants/{tenant_id}/acp/ordersProcess order synchronously
POST/v1/tenants/{tenant_id}/acp/orders/asyncProcess order in background
POST/v1/tenants/{tenant_id}/acp/orders/batchProcess multiple orders

Authentication

Use either header for API key authentication:
Authorization: Bearer your-api-key-here
X-API-Key: your-api-key-here

Example: Basic Order Submission

curl -X POST https://your-server.com/v1/tenants/{tenant_id}/acp/orders \
  -H "Authorization: Bearer YOUR_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "orderId": "agent-order-001",
    "orderNumber": "ORD-1001",
    "customer": {
      "email": "[email protected]",
      "firstName": "John",
      "lastName": "Doe"
    },
    "shippingAddress": {
      "name": "John Doe",
      "address1": "123 Main Street",
      "city": "San Francisco",
      "state": "CA",
      "postalCode": "94102",
      "countryCode": "US"
    },
    "lineItems": [
      {
        "sku": "WIDGET-001",
        "title": "Blue Widget",
        "quantity": 2,
        "price": 29.99
      }
    ]
  }'