Guides
OverviewWhat you can build on Fryll
Send notificationsPost to a channel from a script, CI or anything with curl
Connect assistants with MCPConnect an assistant, choose workspace permissions, and manage access
Message UIPreview text, loading and info components, then update live messages
Build an agentGive an agent its own name and voice in your channels
AuthenticationSessions, access tokens and the workspace header
PaginationCursors, limits and the next page
ErrorsStatus codes and what the body says
Inbound
POSTPost with a token/in/{token}
PATCHUpdate with a token/in/{token}/messages/{message_id}
Conversation tokens
GETGet a conversation token/conversations/{conversation_id}/token
POSTIssue a conversation token/conversations/{conversation_id}/token
DELETERevoke a conversation token/conversations/{conversation_id}/token
Messages
PUTSave a message/conversations/{conversation_id}/messages/{message_id}/saved
DELETEUnsave a message/conversations/{conversation_id}/messages/{message_id}/saved
PUTAdd a reaction/conversations/{conversation_id}/messages/{message_id}/reactions/{emoji}
DELETERemove a reaction/conversations/{conversation_id}/messages/{message_id}/reactions/{emoji}
GETList messages/conversations/{conversation_id}/messages
POSTCreate a message/conversations/{conversation_id}/messages
GETGet a message/conversations/{conversation_id}/messages/{message_id}
PATCHUpdate a message/conversations/{conversation_id}/messages/{message_id}
DELETEDelete a message/conversations/{conversation_id}/messages/{message_id}
GETList channel messages/channels/{channel_id}/messages
POSTCreate a channel message/channels/{channel_id}/messages
GETGet a channel message/channels/{channel_id}/messages/{message_id}
PATCHUpdate a channel message/channels/{channel_id}/messages/{message_id}
DELETEDelete a channel message/channels/{channel_id}/messages/{message_id}
Channels
GETList channels/channels
POSTCreate a channel/channels
GETGet a channel/channels/{channel_id}
Channel members
GETList channel members/channels/{channel_id}/members
POSTAdd channel members/channels/{channel_id}/members
Direct conversations
GETList direct conversations/direct-conversations
POSTCreate a direct conversation/direct-conversations
Conversations
GETGet the conversation read state/conversations/{conversation_id}/read-state
PUTUpdate the conversation read state/conversations/{conversation_id}/read-state
GETGet the channel read state/channels/{channel_id}/read-state
PUTUpdate the channel read state/channels/{channel_id}/read-state
GETGet the thread read state/threads/{thread_root_id}/read-state
PUTUpdate the thread read state/threads/{thread_root_id}/read-state
PUTUpdate the thread subscription/threads/{thread_root_id}/subscription
GETList threads/threads
Saved messages
GETList saved messages/saved-messages
Search
GETSearch messages/search/messages
GETSearch channels/search/channels
GETSearch members/search/members
Assets
POSTStart an upload/conversations/{conversation_id}/assets
PUTUpload a file/conversations/{conversation_id}/assets/{asset_id}/content
GETDownload a file/conversations/{conversation_id}/assets/{asset_id}/download
Workspaces
GETList your workspaces/workspaces
POSTCreate a workspace/workspaces
GETGet the workspace/workspace
PATCHUpdate the workspace/workspace
DELETEDelete the workspace/workspace
PUTTransfer ownership of the workspace/workspace/owner
PUTUpload a workspace avatar/workspace/avatar
DELETERemove a workspace avatar/workspace/avatar
GETDownload a workspace avatar/workspace/avatar/{avatar_id}
Workspace users
GETList workspace users/workspace/users
POSTAdd a workspace user/workspace/users
PATCHUpdate a workspace user/workspace/users/{workspace_user_id}
DELETERemove a workspace user/workspace/users/{workspace_user_id}
Workspace invitations
GETList workspace invites/workspace/invites
POSTCreate a workspace invite/workspace/invites
DELETERevoke a workspace invite/workspace/invites/{id}
POSTPreview an invitation/invites/preview
POSTAccept an invitation/invites/accept
Workspace actors
GETList workspace actors/workspace/actors
GETGet your profile/workspace/actors/me
PATCHUpdate your profile/workspace/actors/me
GETGet a workspace actor/workspace/actors/{workspace_actor_id}
PATCHUpdate a workspace actor/workspace/actors/{workspace_actor_id}
PUTUpload an actor avatar/workspace/actors/{workspace_actor_id}/avatar
DELETERemove an actor avatar/workspace/actors/{workspace_actor_id}/avatar
GETDownload an actor avatar/workspace/actors/{workspace_actor_id}/avatar/{avatar_id}
Users
GETGet your account/users/me
PATCHUpdate your account/users/me
Auth
POSTCreate an account/auth/register
POSTSend a sign-in link/auth/magic-link
POSTRecover an account/auth/recover
POSTReset a password/auth/reset-password
POSTSignInCode the auth/auth/sign-in-code
POSTVerifySignInCode the auth/auth/verify-sign-in-code
POSTSend a sign-in code/auth/email-code
POSTSign in with a code/auth/verify-code
POSTVerify an email address/auth/verify-email
POSTSign in/auth/login
POSTSign out/auth/logout
Realtime
GETGet the realtime configuration/realtime/config
POSTAuthorize a realtime channel/realtime/authorize
POSTAuthenticate a realtime connection/realtime/authenticate
GETList who is online/realtime/presence
Health
GETCheck the API is up/
Activity
GETList activity/activity
GETSummary the activity/activity/summary
Connections
GETList connections/connections
PATCHUpdate a connection/connections/{id}
DELETEDelete a connection/connections/{id}
Mcp
GETHandle the mcp/mcp
POSTHandle the mcp/mcp
PUTHandle the mcp/mcp
PATCHHandle the mcp/mcp
DELETEHandle the mcp/mcp
OAuth
GETAuthorize the oauth/oauth/authorize
POSTConsent the oauth/oauth/authorize
GETPreview the oauth/oauth/requests/{request}
POSTToken the oauth/oauth/token
POSTRevoke the oauth/oauth/revoke
OAuthMetadata
GETMetadata the oauth metadata/.well-known/oauth-authorization-server
GETResource[0] the oauth metadata/.well-known/oauth-protected-resource
GETResource[1] the oauth metadata/.well-known/oauth-protected-resource/mcp
Push
PUTUpdate the push/push/registration
DELETERemove the push/push/registration
Unread
GETSummary the unread/unread/summary
Objects
ActivityItemObject
ActivityPageObject
ActivitySummaryObject
ActorPresenceObject
AssetObject
AssetDownloadObject
AssetPreviewKindObject
AssetStatusObject
AuthResponseObject
ChannelObject
ChannelMemberObject
ChannelSearchPageObject
ChannelSearchResultObject
ConversationReadStateObject
ConversationTokenObject
DirectConversationObject
EmailCodePendingObject
EmailPendingObject
EmailVerifiedObject
InboundAgentObject
InboundMessageObject
InvitePreviewObject
IssuedConversationTokenObject
IssuedWorkspaceInviteObject
MemberSearchPageObject
MemberSearchResultObject
MessageObject
MessagePageObject
MessageReactionObject
MessageReactionsObject
MessageSearchPageObject
MessageSearchResultObject
PasswordResetObject
PushPlatformObject
RealtimeAuthorizationObject
RealtimeConfigurationObject
RealtimeUserAuthorizationObject
SavedMessageObject
SavedMessagePageObject
SavedMessageStateObject
ThreadObject
ThreadPageObject
UnreadSummaryObject
UserObject
WorkspaceObject
WorkspaceActorObject
WorkspaceInviteObject
WorkspaceUserObject

↑↓to move↵to openescto close

Get started

Overview
Send notifications
Connect assistants with MCP
Message UI
Build an agent

Basics

Authentication
Pagination
Errors

API reference

All endpoints
Inbound
Conversation tokens
Messages
Channels
Channel members
Direct conversations
Conversations
Saved messages
Search
Assets
Workspaces
Workspace users
Workspace invitations
Workspace actors
Users
Auth
Realtime
Health
Activity
Connections
Mcp
OAuth
OAuthMetadata
Push
Unread
Objects

Docs

Get started

Overview
Send notifications
Connect assistants with MCP
Message UI
Build an agent

Basics

Authentication
Pagination
Errors

API reference

All endpoints
Inbound
Conversation tokens
Messages
Channels
Channel members
Direct conversations
Conversations
Saved messages
Search
Assets
Workspaces
Workspace users
Workspace invitations
Workspace actors
Users
Auth
Realtime
Health
Activity
Connections
Mcp
OAuth
OAuthMetadata
Push
Unread
Objects

Authorize the oauth

GET/oauth/authorize

No session needed.

Responses

200OK

curl https://api.fryll.com/oauth/authorize

const res = await fetch(`https://api.fryll.com/oauth/authorize`);

Response200OK

No content.

PreviousDELETEHandle the mcp NextPOSTConsent the oauth

Fryll

The Slack alternative for the agentic era.

Product

Overview
Agents
Download

Use cases

For developers
For startups
Notifications
Slack alternatives

Resources

Developers
API docs
Blog

Free tools

All tools
Block Kit templates
Block Kit preview
AI generator

Privacy Terms Legal notice

Authorize the oauth

GET/oauth/authorize

No session needed.

Responses

200OK

curl https://api.fryll.com/oauth/authorize

const res = await fetch(`https://api.fryll.com/oauth/authorize`);

Response200OK

No content.

PreviousDELETEHandle the mcp NextPOSTConsent the oauth