Fleepr API

The Fleepr API is the API the Fleepr app itself runs on. Everything the app does, from chats and tables to files, agents and flows, goes through it, so a script, an automation or an outside agent can do the same. AI tools such as Claude, Cursor and n8n can also reach it through Fleepr's MCP server, as the last part of this introduction shows.

• The OpenAPI document (OpenAPI 3.1, JSON)
• The MCP server: https://mcp.fleepr.com/mcp
• Health

Sign-in and sessions

• POST /v0/auth/sign-up Create an account
• POST /v0/auth/verify-email Verify an email
• POST /v0/auth/sign-in Sign in
• POST /v0/auth/google/start Start an OAuth sign-in
• GET /v0/auth/google/callback Complete an OAuth sign-in
• POST /v0/auth/sign-out Sign out
• POST /v0/auth/sessions/revoke Revoke all sessions
• POST /v0/auth/sign-in-code Email a sign-in code
• POST /v0/auth/sign-in-code/confirm Confirm a sign-in code
• POST /v0/auth/password-reset Request a password reset
• POST /v0/auth/password-reset/confirm Reset a password

Your account

• GET /v0/me Get the signed-in user
• PATCH /v0/me Update the signed-in user
• POST /v0/me/email-change Start an email change
• POST /v0/auth/email-change/confirm Confirm an email change

Organizations and members

• POST /v0/orgs Create an organization
• GET /v0/orgs/{orgId} Get an organization
• PATCH /v0/orgs/{orgId} Update an organization
• GET /v0/logos/{token} Get an organization's logo
• POST /v0/orgs/{orgId}/ownership-transfer Transfer organization ownership
• GET /v0/orgs/{orgId}/directory Get the directory
• GET /v0/orgs/{orgId}/members List members
• POST /v0/orgs/{orgId}/invites Invite a member
• POST /v0/invites/{inviteId}/resend Resend an invite
• POST /v0/invites/{inviteId}/revoke Cancel an invite
• POST /v0/invites/preview Preview an invite
• POST /v0/invites/accept Accept an invite
• PATCH /v0/members/{memberId} Update a member
• POST /v0/members/{memberId}/deactivate Deactivate a member
• POST /v0/members/{memberId}/reactivate Reactivate a member

API keys

• GET /v0/orgs/{orgId}/api-keys List API keys
• POST /v0/orgs/{orgId}/api-keys Create an API key
• POST /v0/api-keys/{apiKeyId}/revoke Revoke an API key
• POST /v0/api-keys/{apiKeyId}/resume-deciding Resume API key decisions
• GET /v0/api-key Get the calling API key

Sharing and access

• GET /v0/objects/{objectId}/access Get an object's access
• PATCH /v0/objects/{objectId}/access Update an object's visibility
• POST /v0/objects/{objectId}/members Grant access
• DELETE /v0/objects/{objectId}/members/{actorId} Remove access
• PATCH /v0/objects/{objectId}/members/{actorId} Update an access level
• POST /v0/objects/{objectId}/invites Share by email
• POST /v0/objects/{objectId}/access-requests Request access
• GET /v0/orgs/{orgId}/access-requests List access requests
• GET /v0/access-requests/{accessRequestId} Get an access request
• POST /v0/access-requests/{accessRequestId}/approve Approve an access request
• POST /v0/access-requests/{accessRequestId}/decline Decline an access request
• PUT /v0/objects/{objectId}/owner Transfer ownership

Objects

• GET /v0/objects/{objectId} Get an object
• GET /v0/orgs/{orgId}/objects List objects

What things are about

• GET /v0/objects/{objectId}/about Get what an object is about
• POST /v0/objects/{objectId}/about Link a record
• DELETE /v0/objects/{objectId}/about/{recordId} Unlink a record

Chats

• GET /v0/orgs/{orgId}/chats List chats
• POST /v0/orgs/{orgId}/chats Create a chat
• GET /v0/orgs/{orgId}/chats/pinned List pinned chats
• PUT /v0/chats/{chatId}/pin Pin a chat
• DELETE /v0/chats/{chatId}/pin Unpin a chat
• POST /v0/chats/{chatId}/read Mark a chat read
• GET /v0/chats/{chatId} Get a chat
• DELETE /v0/chats/{chatId} Delete a chat
• PATCH /v0/chats/{chatId} Update a chat
• GET /v0/chats/{chatId}/export Export a chat
• POST /v0/chats/{chatId}/pause-agents Pause agents in a chat
• POST /v0/chats/{chatId}/resume-agents Resume agents in a chat
• GET /v0/chats/{chatId}/messages List messages
• POST /v0/chats/{chatId}/messages Post a message
• GET /v0/messages/{messageId} Get a message
• GET /v0/orgs/{orgId}/mention-suggestions List mention suggestions
• GET /v0/orgs/{orgId}/message-search Search messages
• GET /v0/messages/{messageId}/blocks/{blockId}/preview Get a table card preview
• POST /v0/messages/{messageId}/blocks/{blockId}/answer Answer a choice
• DELETE /v0/messages/{messageId}/blocks/{blockId}/answer Undo a choice answer
• POST /v0/messages/{messageId}/questions/{questionId}/answer Answer a question card
• GET /v0/turns/{turnId} Get a turn
• GET /v0/turns/{turnId}/draft Get a turn's draft
• POST /v0/turns/{turnId}/cancel Cancel a turn
• POST /v0/turns/{turnId}/tool-results Deliver a tool result
• GET /v0/chains/{chainId} Get a chain
• GET /v0/chats/{chatId}/knowledge Get what a chat's agents know

Agent requests

• GET /v0/orgs/{orgId}/requests List requests
• GET /v0/requests/{requestId} Get a request
• POST /v0/requests/{requestId}/approve Approve a request
• POST /v0/requests/{requestId}/decline Decline a request
• POST /v0/requests/{requestId}/undo-decline Undo a decline
• GET /v0/chats/{chatId}/tool-grants List a chat's allowed tools
• DELETE /v0/chats/{chatId}/tool-grants/{grantId} Revoke an allowed tool

Tables

• GET /v0/orgs/{orgId}/tables List tables
• POST /v0/orgs/{orgId}/tables Create a table
• GET /v0/tables/{tableId} Get a table
• DELETE /v0/tables/{tableId} Delete a table
• PATCH /v0/tables/{tableId} Update a table
• POST /v0/tables/{tableId}/columns Create a column
• DELETE /v0/columns/{columnId} Delete a column
• PATCH /v0/columns/{columnId} Update a column
• POST /v0/columns/{columnId}/change-type Change a column type
• GET /v0/tables/{tableId}/records List records
• POST /v0/tables/{tableId}/records Create a record
• GET /v0/records/{recordId} Get a record
• DELETE /v0/records/{recordId} Delete a record
• PATCH /v0/records/{recordId} Update a record
• POST /v0/tables/{tableId}/records/bulk-create Create records
• POST /v0/tables/{tableId}/records/bulk-upsert Create or update records
• POST /v0/tables/{tableId}/records/bulk-delete Delete records
• GET /v0/tables/{tableId}/record-labels List record labels
• GET /v0/tables/{tableId}/export.csv Export a view as CSV
• GET /v0/orgs/{orgId}/record-search Search records
• GET /v0/records/{recordId}/names List a record's learned names
• DELETE /v0/records/{recordId}/names/{nameId} Remove a learned name

Forms

• GET /v0/tables/{tableId}/views List a table's views
• POST /v0/tables/{tableId}/views Create a view
• GET /v0/views/{viewId} Get a view
• DELETE /v0/views/{viewId} Delete a view
• PATCH /v0/views/{viewId} Update a view
• GET /v0/views/{viewId}/links List a form's links
• POST /v0/views/{viewId}/links Create a form link
• POST /v0/views/{viewId}/links/bulk-create Create form links for one person
• GET /v0/form-links/{linkId} Get a form link
• PATCH /v0/form-links/{linkId} Update a form link
• POST /v0/form-links/{linkId}/revoke Revoke a form link
• POST /v0/views/{viewId}/test-response Test a form response

Files and media

• POST /v0/orgs/{orgId}/uploads Start an upload
• POST /v0/uploads/{uploadId}/complete Complete an upload
• DELETE /v0/uploads/{uploadId} Discard an upload
• POST /v0/orgs/{orgId}/docs Create a doc
• GET /v0/files/{fileId}/doc Get a doc
• PUT /v0/files/{fileId}/doc Save a doc
• POST /v0/files/{fileId}/doc/edit Start or keep editing a doc
• DELETE /v0/files/{fileId}/doc/edit/{leaseId} Stop editing a doc
• POST /v0/files/{fileId}/doc/restore Restore a version of a doc
• GET /v0/orgs/{orgId}/files List files
• GET /v0/orgs/{orgId}/storage Get storage usage
• GET /v0/files/{fileId} Get a file
• DELETE /v0/files/{fileId} Delete a file
• PATCH /v0/files/{fileId} Rename a file
• POST /v0/files/{fileId}/versions Add a version
• GET /v0/files/{fileId}/versions/{versionId} Get a version
• POST /v0/files/{fileId}/versions/{versionId}/download Get a download link
• GET /v0/files/{fileId}/versions/{versionId}/annotations List annotations
• POST /v0/files/{fileId}/versions/{versionId}/annotations Create an annotation
• DELETE /v0/files/{fileId}/versions/{versionId}/annotations Clear your annotations
• DELETE /v0/annotations/{annotationId} Delete an annotation
• GET /v0/files/{fileId}/comments List comments
• POST /v0/files/{fileId}/comments Create a comment
• DELETE /v0/files/{fileId}/comments/{messageId} Remove a guest's comment
• PUT /v0/files/{fileId}/comments/{messageId}/resolution Resolve a comment
• GET /v0/files/{fileId}/approval Get a file's approval
• POST /v0/files/{fileId}/approval Request an approval
• GET /v0/approvals/{approvalId} Get an approval
• GET /v0/orgs/{orgId}/approvals List approvals
• POST /v0/files/{fileId}/approval/rounds Send a doc's changes for review
• POST /v0/approvals/{approvalId}/approvers Add approvers
• DELETE /v0/approvals/{approvalId}/approvers/{approverKey} Remove an approver
• POST /v0/approvals/{approvalId}/decisions Approve, or send a sign-off back
• DELETE /v0/approvals/{approvalId}/decisions/mine Undo a decision
• POST /v0/orgs/{orgId}/approvals/decisions Approve in bulk
• POST /v0/approvals/{approvalId}/resume Resume an approval
• GET /v0/orgs/{orgId}/approval-links List approval links
• POST /v0/orgs/{orgId}/approval-links Create an approval link
• POST /v0/approval-links/{linkId}/revoke Revoke an approval link
• GET /v0/files/{fileId}/public-links List a file's public links
• POST /v0/files/{fileId}/public-links Make a public file link
• POST /v0/public-file-links/{linkId}/revoke Turn off a public link
• GET /v0/public/files/{token}/{filename} Download a public file
• GET /v0/orgs/{orgId}/doc-search Search docs

Guest review

• POST /v0/public/review/session Open a review session
• PATCH /v0/public/review/session Set the guest name
• POST /v0/public/review/session/code Send a verification code
• POST /v0/public/review/session/verify Verify a code
• GET /v0/public/review/files/{fileId} Get a file
• POST /v0/public/review/files/{fileId}/comments Create a comment
• POST /v0/public/review/files/{fileId}/annotations Create an annotation
• DELETE /v0/public/review/annotations/{annotationId} Delete an annotation
• POST /v0/public/review/files/{fileId}/decision Approve a file
• PUT /v0/public/review/files/{fileId}/comments/{messageId}/resolution Resolve a comment
• POST /v0/public/review/files/{fileId}/versions/{versionId}/download Get a download link

Form page

• POST /v0/public/forms/open Open a form
• POST /v0/public/forms/uploads Start a form upload
• POST /v0/public/forms/uploads/{uploadId}/complete Complete a form upload
• POST /v0/public/forms/uploads/{uploadId}/discard Discard a form upload
• POST /v0/public/forms/submit Send a form response

Agents

• GET /v0/orgs/{orgId}/agents List agents
• POST /v0/orgs/{orgId}/agents Create an agent
• GET /v0/agents/{agentId} Get an agent
• DELETE /v0/agents/{agentId} Delete an agent
• PATCH /v0/agents/{agentId} Update an agent
• POST /v0/agents/{agentId}/pause Pause an agent
• POST /v0/agents/{agentId}/resume Resume an agent
• GET /v0/agents/{agentId}/template Export an agent
• POST /v0/orgs/{orgId}/agents/import Import an agent
• GET /v0/models List models
• GET /v0/orgs/{orgId}/teams List teams
• POST /v0/orgs/{orgId}/teams Create a team
• DELETE /v0/teams/{teamId} Delete a team
• PATCH /v0/teams/{teamId} Update a team
• GET /v0/orgs/{orgId}/skills List skills
• POST /v0/orgs/{orgId}/skills Create a skill
• GET /v0/skills/{skillId} Get a skill
• DELETE /v0/skills/{skillId} Delete a skill
• PATCH /v0/skills/{skillId} Update a skill
• GET /v0/skills/{skillId}/versions List skill versions
• GET /v0/skill-versions/{skillVersionId} Get a skill version
• GET /v0/orgs/{orgId}/ai-limits Get AI limits
• PUT /v0/orgs/{orgId}/ai-limits Update AI limits
• POST /v0/orgs/{orgId}/pause-agents Pause all agents
• POST /v0/orgs/{orgId}/resume-agents Resume all agents
• GET /v0/orgs/{orgId}/usage Get AI usage
• GET /v0/agents/{agentId}/context Get what shapes an agent
• GET /v0/agents/{agentId}/learning Get what an agent is learning
• GET /v0/agents/{agentId}/failures Get an agent's failed tool calls

Connectors

• GET /v0/orgs/{orgId}/connectors List connectors
• POST /v0/orgs/{orgId}/connections Create a connection
• GET /v0/connections/{connectionId} Get a connection
• DELETE /v0/connections/{connectionId} Delete a connection
• PATCH /v0/connections/{connectionId} Update a connection
• POST /v0/connections/{connectionId}/test Test a connection
• POST /v0/connections/{connectionId}/resume Resume a connection
• POST /v0/connections/{connectionId}/disconnect Disconnect a connection
• PUT /v0/connections/{connectionId}/agents Set a connection's agents
• GET /v0/connections/{connectionId}/tools List a connection's tools
• PUT /v0/connections/{connectionId}/tool-policies Set tool policies
• POST /v0/connections/{connectionId}/sign-in Start an MCP server sign-in
• GET /v0/connectors/sign-in/callback Complete an MCP server sign-in
• GET /v0/connectors/sign-in/client-metadata.json Fleepr's OAuth client metadata
• GET /v0/orgs/{orgId}/webhooks List webhooks
• POST /v0/orgs/{orgId}/webhooks Create a webhook
• GET /v0/webhooks/{webhookId} Get a webhook
• DELETE /v0/webhooks/{webhookId} Delete a webhook
• PATCH /v0/webhooks/{webhookId} Update a webhook
• POST /v0/webhooks/{webhookId}/test Test a webhook
• GET /v0/webhooks/{webhookId}/deliveries List webhook deliveries
• POST /v0/webhook-deliveries/{deliveryId}/redeliver Resend a webhook delivery

Flows

• GET /v0/orgs/{orgId}/flows List flows
• POST /v0/orgs/{orgId}/flows Create a flow
• GET /v0/flows/{flowId} Get a flow
• PUT /v0/flows/{flowId} Update a flow
• DELETE /v0/flows/{flowId} Delete a flow
• PATCH /v0/flows/{flowId} Rename a flow
• POST /v0/flows/{flowId}/pause Pause a flow
• POST /v0/flows/{flowId}/activate Activate a flow
• GET /v0/orgs/{orgId}/flow-trigger-events List trigger events
• GET /v0/flows/{flowId}/versions List flow versions
• GET /v0/flow-versions/{flowVersionId} Get a flow version
• GET /v0/flows/{flowId}/runs List runs
• POST /v0/flows/{flowId}/runs Start a run
• GET /v0/flow-runs/{flowRunId} Get a run
• POST /v0/flow-runs/{flowRunId}/cancel Cancel a run

Logs and notifications

• PATCH /v0/me/preferences Update preferences
• GET /v0/orgs/{orgId}/logs List log entries
• GET /v0/orgs/{orgId}/logs/{eventId} Get a log entry
• GET /v0/orgs/{orgId}/logs/export.csv Export logs as CSV
• GET /v0/orgs/{orgId}/notifications List notifications
• POST /v0/orgs/{orgId}/notifications/read Mark notifications as read
• GET /v0/orgs/{orgId}/waiting List pending decisions

Health

• GET /v0/orgs/{orgId}/health Get the Health summary
• GET /v0/orgs/{orgId}/health/issues List Health issues
• GET /v0/health/issues/{issueId} Get a Health issue
• POST /v0/health/issues/{issueId}/resolve Resolve a Health issue
• POST /v0/health/issues/{issueId}/reopen Reopen a Health issue
• POST /v0/health/issues/{issueId}/request-fix Send a Health fix to Approvals
• POST /v0/health/issues/{issueId}/apply-fix Approve a Health fix
• POST /v0/health/issues/{issueId}/withdraw-fix Withdraw a Health fix
• GET /v0/orgs/{orgId}/health/tables List table profiles
• PATCH /v0/health/tables/{tableId} Update a table profile
• GET /v0/orgs/{orgId}/health/targets List targets
• POST /v0/orgs/{orgId}/health/targets Add a target
• GET /v0/health/targets/{targetId} Get a target
• DELETE /v0/health/targets/{targetId} Delete a target
• PATCH /v0/health/targets/{targetId} Edit a target
• GET /v0/orgs/{orgId}/health/target-suggestions List target suggestions
• POST /v0/health/target-suggestions/{suggestionId}/decide Accept or dismiss a target suggestion

Memory

• GET /v0/orgs/{orgId}/memories List memories
• POST /v0/orgs/{orgId}/memories Add a memory
• GET /v0/orgs/{orgId}/memories/counts Count memories
• GET /v0/memories/{memoryId} Get a memory
• PATCH /v0/memories/{memoryId} Edit a memory
• GET /v0/memories/{memoryId}/turns List a memory's recent turns
• POST /v0/memories/{memoryId}/decide Decide on a memory
• GET /v0/memories/{memoryId}/versions List a memory’s versions
• POST /v0/memories/{memoryId}/versions/{number}/restore Restore a memory’s version
• POST /v0/memories/{memoryId}/subject Change a suggestion’s subject

System

• GET /health Check health

Streams

• GET /v0/orgs/{orgId}/stream Open the organization stream
• GET /v0/chats/{chatId}/stream Open a chat stream
• GET /v0/files/{fileId}/stream Open a file stream
• GET /v0/public/review/stream Open the review stream