Fluid SDK API Documentation (0.0.6)

OpenAPI documentation for Fluid's SDK API

Download OpenAPI description
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

carts

Operations

checkout

Operations

Record a checkout starting

Request

Bodyapplication/json
cart_tokenstringrequired
metadataobject(RequestMetadata)required
metadata.​fluid_shopstringrequired
Example: "myshop"
metadata.​fluid_sessionstring(/\Afs_[0-9A-Za-z&&[^0OIl]]{22}\z/)required
Example: "fs_szwdDuRbqEe7AV7sXk7vVq"
metadata.​attributionAttributionLookupEmail (object) or AttributionLookupUsername (object) or AttributionLookupSharedGuid (object) or AttributionLookupFluidRepId (object) or AttributionLookupExternalId (object)(AttributionLookup)
Any of:
curl -i -X POST \
  https://docs.fluid.app/_mock/docs/apis/public/api/public/v2025-06/events/checkout/started \
  -H 'Content-Type: application/json' \
  -d '{
    "cart_token": "string",
    "metadata": {
      "fluid_shop": "myshop",
      "fluid_session": "fs_szwdDuRbqEe7AV7sXk7vVq",
      "attribution": {
        "email": "salesrep@example.com"
      }
    }
  }'

Responses

checkout started

Bodyapplication/json
statusnumberrequired
Example: 201
metadataobject(ResponseMetadata)required
Example: {"fluid_shop":"myshop","fluid_session":"fs_szwdDuRbqEe7AV7sXk7vVq","request_uuid":"123e4567-e89b-12d3-a456-426614174000","timestamp":"2025-01-01T00:00:00Z"}
metadata.​fluid_shopstringrequired
Example: "myshop"
metadata.​fluid_sessionstringrequired
Example: "fs_szwdDuRbqEe7AV7sXk7vVq"
metadata.​request_uuidstring(uuid)required
Example: "123e4567-e89b-12d3-a456-426614174000"
metadata.​timestampstringrequired
Example: "2025-01-01T00:00:00Z"
Response
application/json
{ "status": 201, "metadata": { "fluid_shop": "string", "fluid_session": "string", "request_uuid": "a699086b-c336-457e-9191-0c825d6efbc8", "timestamp": "string" } }

events

Operations

lead

Operations

page

Operations

fingerprint

Operations

session

Operations