Fluid Rep APIs (1.0)

The Fluid Rep APIs provide endpoints for authenticated Reps (Users) to access their own data and perform actions on their behalf.

Authentication

These APIs use User tokens for authentication. User tokens are obtained through:

  • Magic link authentication
  • JWT exchange (/api/user_companies/jwt_exchange)
  • Token exchange (/api/user_companies/token_exchange)

Unlike Company APIs which use Company API tokens for administrative access, Rep APIs authenticate the individual user and provide access to their personal data, orders, team, and settings.

For Company-level management APIs, see the Company APIs documentation.

Download OpenAPI description
Overview
E-mail support@fluid.app
License MIT
Languages
Servers
Mock server
https://docs.fluid.app/_mock/docs/apis/rep/
Production server with company subdomain
https://{company}.fluid.app/
Local development server
http://fluid.lvh.me:{port}/

Authentication

Operations

User Profile

Operations

Contacts

Operations

Tasks

Operations

Media

Operations

Libraries

Operations

Orders

Operations

MySite

Operations

Analytics

Operations

Events

Operations

Training

Operations

List trainings

Request

Returns all training content for the current user.

Training includes educational videos, courses, certifications, and skill-building content provided by the company. Users can track their progress through training modules.

Query
categorystring

Filter by training category

completedboolean

Filter by completion status

curl -i -X GET \
  'https://docs.fluid.app/_mock/docs/apis/rep/api/trainings?category=string&completed=true' \
  -H 'Authorization: Bearer <YOUR_TOKEN_HERE>'

Responses

trainings retrieved

Bodyapplication/jsonArray [
object
]
Response
application/json
[ { "id": 201, "title": "Sales Fundamentals - The Michael Scott Method", "description": "Learn the core principles of relationship-based selling from the World's Best Boss.", "category": "sales", "duration_minutes": 45, "image_url": "https://cdn.dundermifflin.com/training/sales-fundamentals.jpg", "progress_percent": 75, "completed": false, "modules": [] }, { "id": 202, "title": "Product Knowledge - Paper Types and Uses", "description": "Become an expert on paper weights, finishes, and applications.", "category": "product", "duration_minutes": 30, "image_url": "https://cdn.dundermifflin.com/training/paper-types.jpg", "progress_percent": 100, "completed": true, "completed_at": "2024-01-10T16:30:00Z" }, { "id": 203, "title": "Safety Training with Dwight Schrute", "description": "Essential workplace safety guidelines and emergency procedures.", "category": "compliance", "duration_minutes": 60, "image_url": "https://cdn.dundermifflin.com/training/safety.jpg", "progress_percent": 0, "completed": false } ]

List announcements

Request

Returns company announcements for the current user.

Announcements are company-wide messages, updates, and notifications. They can include text, images, and videos.

curl -i -X GET \
  https://docs.fluid.app/_mock/docs/apis/rep/api/announcements \
  -H 'Authorization: Bearer <YOUR_TOKEN_HERE>'

Responses

announcements retrieved

Bodyapplication/jsonArray [
object
]
Response
application/json
[ { "id": 501, "title": "Q4 Sales Competition - Win a Dundie!", "description": "The annual sales competition is here! Top performers will receive the prestigious Dundie Award at our ceremony.", "kind": "announcement", "media_type": "text", "image_url": "https://cdn.dundermifflin.com/announcements/dundie-competition.jpg", "active": true, "read": false, "created_at": "2024-01-02T09:00:00Z", "author": {} }, { "id": 502, "title": "New Product Launch: Dunder Mifflin Infinity Paper", "description": "Introducing our most advanced paper yet - now with 20% more whiteness.", "kind": "announcement", "media_type": "video", "video_url": "https://cdn.dundermifflin.com/announcements/infinity-launch.mp4", "active": true, "read": true, "created_at": "2024-01-01T12:00:00Z", "author": {} } ]