widgets

Fluid SDK API Documentation (0.0.6)

OpenAPI documentation for Fluid's SDK API

Download OpenAPI description
public.json
public.yaml
Overview
E-mail support@fluid.app
License MIT
Languages
Servers
Mock server
https://docs.fluid.app/_mock/docs/apis/public/
Production API server
https://api.fluid.app/
Local development server
https://api.fluid.test/

Orders

Operations

affiliate

Operations

carts

Operations

checkout

Operations

events

Operations

lead

Operations

page

Operations

fingerprint

Operations

session

Operations

settings

Operations

widgets

Operations

Retrieve cart widget

Request

Bodyapplication/json
urlstringrequired
Example: "https://example.com/products/123"
metadataobject(RequestMetadata)required
metadata.​fluid_shopstringrequired
Example: "myshop"
metadata.​fluid_sessionstring(/\Afs_[0-9A-Za-z&&[^0OIl]]{22}\z/)required
Example: "fs_szwdDuRbqEe7AV7sXk7vVq"
metadata.​fluid_localestring(/\A[a-z]{2}_[A-Z]{2}\z/)
Example: "en_US"
metadata.​fluid_journeystring
metadata.​attributionAttributionEmail (object) or AttributionUsername (object) or AttributionSharedGuid (object) or AttributionFluidRepId (object) or AttributionExternalId (object)(Attribution)
Any of:
curl -i -X POST \
  https://docs.fluid.app/_mock/docs/apis/public/api/public/v2025-06/widgets/carts \
  -H 'Content-Type: application/json' \
  -d '{
    "url": "https://example.com/products/123",
    "metadata": {
      "fluid_shop": "myshop",
      "fluid_session": "fs_szwdDuRbqEe7AV7sXk7vVq",
      "fluid_locale": "en_US",
      "fluid_journey": "string",
      "attribution": {
        "email": "salesrep@example.com"
      }
    }
  }'

Responses

cart widget found

Bodyapplication/json
statusnumberrequired
Example: 200
cartCartWidget (object) or nullrequired
One of:

A cart widget

cart.​placementstringrequired

Which side of the screen the cart slides out from

Enum"right""left"
cart.​contentobjectrequired
cart.​stylesobjectrequired
cart.​triggerobjectrequired
metadataobject(ResponseMetadata)required
metadata.​fluid_shopstringrequired
metadata.​fluid_sessionstringrequired
metadata.​fluid_localestring or null(/\A[a-z]{2}_[A-Z]{2}\z/)
Example: "en_US"
metadata.​request_uuidstring(uuid)required
metadata.​timestampstringrequired
Response
application/json
{
  "status": 200,
  "cart": {
    "placement": "right",
    "content": {},
    "styles": {},
    "trigger": {}
  },
  "metadata": {
    "fluid_shop": "string",
    "fluid_session": "string",
    "fluid_locale": "en_US",
    "request_uuid": "a699086b-c336-457e-9191-0c825d6efbc8",
    "timestamp": "string"
  }
}

Retrieve chat widget

Request

Bodyapplication/json
urlstringrequired
Example: "https://example.com/products/123"
metadataobject(RequestMetadata)required
metadata.​fluid_shopstringrequired
Example: "myshop"
metadata.​fluid_sessionstring(/\Afs_[0-9A-Za-z&&[^0OIl]]{22}\z/)required
Example: "fs_szwdDuRbqEe7AV7sXk7vVq"
metadata.​fluid_localestring(/\A[a-z]{2}_[A-Z]{2}\z/)
Example: "en_US"
metadata.​fluid_journeystring
metadata.​attributionAttributionEmail (object) or AttributionUsername (object) or AttributionSharedGuid (object) or AttributionFluidRepId (object) or AttributionExternalId (object)(Attribution)
Any of:
curl -i -X POST \
  https://docs.fluid.app/_mock/docs/apis/public/api/public/v2025-06/widgets/chats \
  -H 'Content-Type: application/json' \
  -d '{
    "url": "https://example.com/products/123",
    "metadata": {
      "fluid_shop": "myshop",
      "fluid_session": "fs_szwdDuRbqEe7AV7sXk7vVq",
      "fluid_locale": "en_US",
      "fluid_journey": "string",
      "attribution": {
        "email": "salesrep@example.com"
      }
    }
  }'

Responses

chat widget found

Bodyapplication/json
statusnumberrequired
Example: 200
chatChatWidget (object) or nullrequired
One of:

A chat widget

chat.​contentobjectrequired
chat.​stylesobjectrequired
chat.​triggerobjectrequired
chat.​lead_captureobjectrequired
metadataobject(ResponseMetadata)required
metadata.​fluid_shopstringrequired
metadata.​fluid_sessionstringrequired
metadata.​fluid_localestring or null(/\A[a-z]{2}_[A-Z]{2}\z/)
Example: "en_US"
metadata.​request_uuidstring(uuid)required
metadata.​timestampstringrequired
Response
application/json
{
  "status": 200,
  "chat": {
    "content": {},
    "styles": {},
    "trigger": {},
    "lead_capture": {}
  },
  "metadata": {
    "fluid_shop": "string",
    "fluid_session": "string",
    "fluid_locale": "en_US",
    "request_uuid": "a699086b-c336-457e-9191-0c825d6efbc8",
    "timestamp": "string"
  }
}