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

List tasks

Request

Returns all tasks for the current user.

Tasks can be associated with contacts, orders, or general follow-ups. They help track action items and deadlines for the user's workflow.

Query
statusstring

Filter by status: pending, completed, overdue

contact_idinteger

Filter tasks by contact ID

curl -i -X GET \
  'https://docs.fluid.app/_mock/docs/apis/rep/api/tasks?contact_id=0&status=string' \
  -H 'Authorization: Bearer <YOUR_TOKEN_HERE>'

Responses

tasks retrieved

Bodyapplication/jsonArray [
object
]
Response
application/json
[ { "id": 891, "title": "Follow up with Michael about paper order", "description": "He needs 50 reams of premium copy paper for the holiday party invitations.", "status": "pending", "priority": "high", "due_date": "2024-01-20", "contact": {}, "created_at": "2024-01-15T09:30:00Z" }, { "id": 892, "title": "Send product catalog to Pam", "description": "She's interested in our new recycled paper line.", "status": "pending", "priority": "medium", "due_date": "2024-01-22", "contact": {}, "created_at": "2024-01-16T11:00:00Z" }, { "id": 893, "title": "Call Jim about the Stamford account", "description": null, "status": "completed", "priority": "low", "due_date": "2024-01-18", "completed_at": "2024-01-18T15:45:00Z", "contact": {}, "created_at": "2024-01-14T08:00:00Z" } ]

Media

Operations

Libraries

Operations

Orders

Operations

MySite

Operations

Analytics

Operations

Events

Operations

Training

Operations