Save an external cart ID for the authenticated user so it can be resumed later.

API ownership

• API family: Auth API
• Best for: Customer identity, session, token, cart, and wishlist flows.
• Do not use from: Merchant admin data syncs or public catalog rendering.
• Guide route: /apis/auth/latest

The OpenAPI contract defines the method, path, parameters, request body, and responses for this operation.

Operation

• Method: POST
• Path: /api/v1/\{app_id\}/carts
• Summary: Save a new cart reference
• Description: Save an external cart ID for the authenticated user so it can be resumed later.
• OpenAPI contract: auth-api
• Operation ID: Not documented in the OpenAPI contract.

Operation key uses API family, method, and path because this OpenAPI contract does not publish an operation ID.

{
  "cart_id": "string",
  "source": "string"
}

{
  "cart_id": "string",
  "created_at": "string",
  "id": "string",
  "source": "string",
  "updated_at": "string"
}

{
  "details": [
    "string"
  ],
  "message": "string",
  "success": false
}

{
  "details": [
    "string"
  ],
  "message": "string",
  "success": false
}

{
  "details": [
    "string"
  ],
  "message": "string",
  "success": false
}

{
  "details": [
    "string"
  ],
  "message": "string",
  "success": false
}

Contract identity

Use these fields to confirm you are implementing the intended endpoint contract.

• API family: Auth API
• Method: POST
• Path: /api/v1/\{app_id\}/carts
• Operation ID: Not documented in the OpenAPI contract.
• OpenAPI tag: Cart
• OpenAPI summary: Save a new cart reference