Darflen API Documentation

POST /activity

Record User is Online

Sends a ping to the server to indicate active user presence, used for tracking online users.

Request Headers:

Content-Type: multipart/form-data
Authorization: Bearer YOUR_AUTH_TOKEN

Request Body:

csrf_token: string - CSRF token for request validation.

GET /search/autocomplete?q=query

Search Autocomplete

Provides autocomplete suggestions based on the search query.

Query Parameters:

q: string - The search query string.

Request Headers:

None.

Request Body:

None.

GET /search?q=query&p=x

Perform Search

Executes a search for posts based on the query.

Query Parameters:

q: string - The search query string.
p: number - The page number for pagination (e.g., 0 for the first page).

Request Headers:

None.

Request Body:

None.

GET /search/render?q=query&p=x

Render Search Results

Retrieves rendered HTML for search results, suitable for direct insertion into the DOM.

Query Parameters:

q: string - The search query string.
p: number - The page number for pagination.

Request Headers:

None.

Request Body:

None.

POST /auth/login

User Login

Authenticates a user and provides an authentication token for subsequent requests.

Request Headers:

Content-Type: multipart/form-data

Request Body:

email: string - The user's email address.
password: string - The user's password.

POST /auth/register

User Registration

Registers a new user account.

Request Headers:

Content-Type: multipart/form-data

Request Body:

email: string - The user's email address.
username: string - The desired username.
password: string - The user's password.
day: number - Birth day.
month: number - Birth month.
year: number - Birth year.
referral*: string - Optional referral code.

POST /auth/logout

Logout Current Session

Logs out the current authenticated session.

Request Headers:

Content-Type: multipart/form-data
Authorization: Bearer YOUR_AUTH_TOKEN

Request Body:

csrf_token: string - CSRF token.

POST /auth/logout/device

Logout Specific Device Session

Logs out a specific device session associated with the user's account.

Request Headers:

Content-Type: multipart/form-data
Authorization: Bearer YOUR_AUTH_TOKEN

Request Body:

token: string - The session token to invalidate.
password: string - User's current password for verification.
csrf_token: string - CSRF token.

POST /auth/logout/devices

Logout All Device Sessions

Logs out the user from all active device sessions.

Request Headers:

Content-Type: multipart/form-data
Authorization: Bearer YOUR_AUTH_TOKEN

Request Body:

csrf_token: string - CSRF token.

POST /auth/username/change

Change Username

Allows a logged-in user to change their username.

Request Headers:

Content-Type: multipart/form-data
Authorization: Bearer YOUR_AUTH_TOKEN

Request Body:

username: string - The new desired username.
password: string - The user's current password for verification.
csrf_token: string - CSRF token.

POST /auth/password/change

Change Password

Allows a logged-in user to change their password.

Request Headers:

Content-Type: multipart/form-data
Authorization: Bearer YOUR_AUTH_TOKEN

Request Body:

old_password: string - The user's current password.
password: string - The new desired password.
confirm_password: string - Confirmation of the new password.
csrf_token: string - CSRF token.

POST /auth/email/change

Change Email

Allows a logged-in user to change their email address.

Request Headers:

Content-Type: multipart/form-data
Authorization: Bearer YOUR_AUTH_TOKEN

Request Body:

email: string - The new desired email address.
password: string - The user's current password for verification.
csrf_token: string - CSRF token.

POST /auth/email/verify

Verify Email

Sends a verification email to the user's email address.

Request Headers:

Content-Type: multipart/form-data
Authorization: Bearer YOUR_AUTH_TOKEN

Request Body:

csrf_token: string - CSRF token.
verification_code*: string - The verification code received (if completing verification).

POST /auth/password/forgot/start

Initiate Forgot Password

Sends a password reset link or code to the user's email.

Request Headers:

Content-Type: multipart/form-data

Request Body:

email: string - The user's email address.
csrf_token: string - CSRF token.

POST /auth/tokens/TOKEN_ID/discard

Discard Authentication Token

Invalidates a specific authentication token, effectively logging out that session. Can only be used by admins.

Path Parameters:

TOKEN_ID: string - The ID of the token to discard.

Request Headers:

Content-Type: multipart/form-data
Authorization: Bearer YOUR_AUTH_TOKEN

Request Body:

password: string - User's current password for verification.
csrf_token: string - CSRF token.

GET /users/USERNAME

Get User Profile

Retrieves detailed profile information for a specific user.

Path Parameters:

USERNAME: string - The username of the target user.

Request Headers:

None.

Request Body:

None.

GET /users/USERNAME/followers

Get User Followers

Retrieves a list of users who are following the specified user.

Path Parameters:

USERNAME: string - The username of the target user.

Request Headers:

None.

Request Body:

None.

GET /users/USERNAME/following

Get User Following

Retrieves a list of users that the specified user is following.

Path Parameters:

USERNAME: string - The username of the target user.

Request Headers:

None.

Request Body:

None.

GET /users/USERNAME/posts

Get User Posts

Retrieves a list of posts created by the specified user.

Path Parameters:

USERNAME: string - The username of the target user.

Request Headers:

None.

Request Body:

None.

GET /users/USERNAME/communities

Get User Communities

Retrieves a list of communities the specified user is a member of.

Path Parameters:

USERNAME: string - The username of the target user.

Request Headers:

None.

Request Body:

None.

GET /users/USERNAME/loves

Get User Loves

Retrieves a list of users that have loved the specified user's content.

Path Parameters:

USERNAME: string - The username of the target user.

Request Headers:

None.

Request Body:

None.

POST /users/USERNAME/follow

Follow/Unfollow User

Toggles the follow status for a specified user.

Path Parameters:

USERNAME: string - The username of the user to follow/unfollow.

Request Headers:

Content-Type: multipart/form-data
Authorization: Bearer YOUR_AUTH_TOKEN

Request Body:

csrf_token: string - CSRF token.

POST /users/USERNAME/block

Block/Unblock User

Toggles the block status for a specified user.

Path Parameters:

USERNAME: string - The username of the user to block/unblock.

Request Headers:

Content-Type: multipart/form-data
Authorization: Bearer YOUR_AUTH_TOKEN

Request Body:

csrf_token: string - CSRF token.

POST /users/USER_ID/report

Report User

Submits a report against a specified user.

Path Parameters:

USER_ID: string - The ID of the user being reported.

Request Headers:

Content-Type: multipart/form-data
Authorization: Bearer YOUR_AUTH_TOKEN

Request Body:

textarea: string - A detailed description of the report.
reason: string - The reason for reporting (e.g., "spam", "hate_speech").
csrf_token: string - CSRF token.

POST /posts/create

Create Post

Creates a new post. Can include text, files, and poll options.

Request Headers:

Content-Type: multipart/form-data
Authorization: Bearer YOUR_AUTH_TOKEN

Request Body:

textarea: string - The main text content of the post.
audience: string - Defines who can see the post (e.g., "public", "followers", "private").
files[]*: binary file data - Multiple file uploads (e.g., images, videos).
options[]*: string - Multiple options for a poll. Order matters.
group*: string - The ID of the community/group to post to.
time*: number - For polls, the duration in days the poll will be active.
csrf_token: string - CSRF token.

GET /posts/POST_ID/render

Render Post

Retrieves the rendered HTML content of a specific post.

Path Parameters:

POST_ID: string - The ID of the post.

Request Headers:

None.

Request Body:

None.

GET /posts/POST_ID

Get Post Details

Retrieves detailed information about a specific post.

Path Parameters:

POST_ID: string - The ID of the post.

Request Headers:

None.

Request Body:

None.

POST /posts/POST_ID/edit

Edit Post

Modifies the content and/or media of an existing post.

Path Parameters:

POST_ID: string - The ID of the post to edit.

Request Headers:

Content-Type: multipart/form-data
Authorization: Bearer YOUR_AUTH_TOKEN

Request Body:

textarea: string - The updated text content of the post.
audience: string - The updated audience setting.
files[]*: binary file data - New or updated file uploads.
csrf_token: string - CSRF token.

POST /posts/POST_ID/repost

Repost Content

Reposts a specific post, optionally adding text, files, or associating with a community.

Path Parameters:

POST_ID: string - The ID of the post to repost.

Request Headers:

Content-Type: multipart/form-data
Authorization: Bearer YOUR_AUTH_TOKEN

Request Body:

textarea*: string - Optional text content for the repost.
audience: string - Audience for the repost.
files[]*: binary file data - Optional file uploads for the repost.
group*: string - Optional ID of the community/group to repost to.
csrf_token: string - CSRF token.

POST /posts/POST_ID/report

Report Post

Submits a report against a specified post.

Path Parameters:

POST_ID: string - The ID of the post being reported.

Request Headers:

Content-Type: multipart/form-data
Authorization: Bearer YOUR_AUTH_TOKEN

Request Body:

textarea: string - A detailed description of the report.
reason: string - The reason for reporting (e.g., "spam", "hate_speech").
csrf_token: string - CSRF token.

POST /posts/POST_ID/love

Love/Unlove Post

Toggles the love status for a specified post.

Path Parameters:

POST_ID: string - The ID of the post.

Request Headers:

Content-Type: multipart/form-data
Authorization: Bearer YOUR_AUTH_TOKEN

Request Body:

csrf_token: string - CSRF token.

POST /posts/POST_ID/pin

Pin/Unpin Post

Toggles the pinned status of a post on the logged in user's profile.

Path Parameters:

POST_ID: string - The ID of the post to pin/unpin.

Request Headers:

Content-Type: multipart/form-data
Authorization: Bearer YOUR_AUTH_TOKEN

Request Body:

csrf_token: string - CSRF token.

POST /posts/POST_ID/delete

Delete Post

Deletes a specified post.

Path Parameters:

POST_ID: string - The ID of the post to delete.

Request Headers:

Content-Type: multipart/form-data
Authorization: Bearer YOUR_AUTH_TOKEN

Request Body:

csrf_token: string - CSRF token.

GET /posts/POST_ID/reposts

Get Post Reposts

Retrieves a list of reposts associated with a specific post.

Path Parameters:

POST_ID: string - The ID of the post.

Request Headers:

None.

Request Body:

None.

GET /posts/POST_ID/comments

Get Post Comments

Retrieves a list of comments for a specific post.

Path Parameters:

POST_ID: string - The ID of the post.

Request Headers:

None.

Request Body:

None.

POST /posts/POST_ID/comment

Create Comment on Post

Adds a new comment to a specified post.

Path Parameters:

POST_ID: string - The ID of the post to comment on.

Request Headers:

Content-Type: multipart/form-data
Authorization: Bearer YOUR_AUTH_TOKEN

Request Body:

textarea: string - The text content of the comment.
files[]*: binary file data - Optional file uploads for the comment.
csrf_token: string - CSRF token.

GET /comments/COMMENT_ID/render

Render Comment

Retrieves the rendered HTML content of a specific comment.

Path Parameters:

COMMENT_ID: string - The ID of the comment.

Request Headers:

None.

Request Body:

None.

GET /comments/COMMENT_ID

Get Comment Details

Retrieves detailed information about a specific comment.

Path Parameters:

COMMENT_ID: string - The ID of the comment.

Request Headers:

None.

Request Body:

None.

POST /comments/COMMENT_ID/edit

Edit Comment

Modifies the content and/or media of an existing comment.

Path Parameters:

COMMENT_ID: string - The ID of the comment to edit.

Request Headers:

Content-Type: multipart/form-data
Authorization: Bearer YOUR_AUTH_TOKEN

Request Body:

textarea: string - The updated text content of the comment.
files[]*: binary file data - New or updated file uploads.
csrf_token: string - CSRF token.

POST /comments/COMMENT_ID/report

Report Comment

Submits a report against a specified comment.

Path Parameters:

COMMENT_ID: string - The ID of the comment being reported.

Request Headers:

Content-Type: multipart/form-data
Authorization: Bearer YOUR_AUTH_TOKEN

Request Body:

textarea: string - A detailed description of the report.
reason: string - The reason for reporting.
csrf_token: string - CSRF token.

POST /comments/COMMENT_ID/love

Love/Unlove Comment

Toggles the love status for a specified comment.

Path Parameters:

COMMENT_ID: string - The ID of the comment.

Request Headers:

Content-Type: multipart/form-data
Authorization: Bearer YOUR_AUTH_TOKEN

Request Body:

csrf_token: string - CSRF token.

POST /comments/COMMENT_ID/delete

Delete Comment

Deletes a specified comment.

Path Parameters:

COMMENT_ID: string - The ID of the comment to delete.

Request Headers:

Content-Type: multipart/form-data
Authorization: Bearer YOUR_AUTH_TOKEN

Request Body:

csrf_token: string - CSRF token.

GET /comments/COMMENT_ID/replies

Get Comment Replies

Retrieves a list of replies for a specific comment.

Path Parameters:

COMMENT_ID: string - The ID of the comment.

Request Headers:

None.

Request Body:

None.

POST /comments/COMMENT_ID/reply

Create Reply to Comment

Adds a new reply to a specified comment.

Path Parameters:

COMMENT_ID: string - The ID of the comment to reply to.

Request Headers:

Content-Type: multipart/form-data
Authorization: Bearer YOUR_AUTH_TOKEN

Request Body:

textarea: string - The text content of the reply.
files[]*: binary file data - Optional file uploads for the reply.
csrf_token: string - CSRF token.

GET /replies/REPLY_ID/render

Render Reply

Retrieves the rendered HTML content of a specific reply.

Path Parameters:

REPLY_ID: string - The ID of the reply.

Request Headers:

None.

Request Body:

None.

GET /replies/REPLY_ID

Get Reply Details

Retrieves detailed information about a specific reply.

Path Parameters:

REPLY_ID: string - The ID of the reply.

Request Headers:

None.

Request Body:

None.

POST /replies/REPLY_ID/edit

Edit Reply

Modifies the content and/or media of an existing reply.

Path Parameters:

REPLY_ID: string - The ID of the reply to edit.

Request Headers:

Content-Type: multipart/form-data
Authorization: Bearer YOUR_AUTH_TOKEN

Request Body:

textarea: string - The updated text content of the reply.
files[]*: binary file data - New or updated file uploads.
csrf_token: string - CSRF token.

POST /replies/REPLY_ID/report

Report Reply

Submits a report against a specified reply.

Path Parameters:

REPLY_ID: string - The ID of the reply being reported.

Request Headers:

Content-Type: multipart/form-data
Authorization: Bearer YOUR_AUTH_TOKEN

Request Body:

textarea: string - A detailed description of the report.
reason: string - The reason for reporting.
csrf_token: string - CSRF token.

POST /replies/REPLY_ID/love

Love/Unlove Reply

Toggles the love status for a specified reply.

Path Parameters:

REPLY_ID: string - The ID of the reply.

Request Headers:

Content-Type: multipart/form-data
Authorization: Bearer YOUR_AUTH_TOKEN

Request Body:

csrf_token: string - CSRF token.

POST /replies/REPLY_ID/delete

Delete Reply

Deletes a specified reply.

Path Parameters:

REPLY_ID: string - The ID of the reply to delete.

Request Headers:

Content-Type: multipart/form-data
Authorization: Bearer YOUR_AUTH_TOKEN

Request Body:

csrf_token: string - CSRF token.

POST /communities/create

Create Community

Creates a new community.

Request Headers:

Content-Type: multipart/form-data
Authorization: Bearer YOUR_AUTH_TOKEN

Request Body:

name: string - The unique name for the community (e.g., "tech-enthusiasts").
display-name: string - The display name of the community (e.g., "Tech Enthusiasts").
textarea: string - A description of the community.
audience: string - The visibility setting for the community (e.g., "public", "private").
csrf_token: string - CSRF token.

GET /communities/COMMUNITY

Get Community Profile

Retrieves detailed profile information for a specific community.

Path Parameters:

COMMUNITY: string - The unique name or ID of the community.

Request Headers:

None.

Request Body:

None.

GET /communities/COMMUNITY/posts

Get Community Posts

Retrieves a list of posts published within a specific community.

Path Parameters:

COMMUNITY: string - The unique name or ID of the community.

Request Headers:

None.

Request Body:

None.

GET /communities/COMMUNITY/loves

Get Community Loves

Retrieves a list of users that have loved posts within a community.

Path Parameters:

COMMUNITY: string - The unique name or ID of the community.

Request Headers:

None.

Request Body:

None.

GET /communities/COMMUNITY/members

Get Community Members

Retrieves a list of members of a specific community.

Path Parameters:

COMMUNITY: string - The unique name or ID of the community.

Request Headers:

None.

Request Body:

None.

POST /communities/COMMUNITY/join

Join/Leave Community

Toggles the membership status for the specified community.

Path Parameters:

COMMUNITY: string - The unique name or ID of the community.

Request Headers:

Content-Type: multipart/form-data
Authorization: Bearer YOUR_AUTH_TOKEN

Request Body:

csrf_token: string - CSRF token.

POST /communities/COMMUNITY/report

Report Community

Submits a report against a specified community.

Path Parameters:

COMMUNITY: string - The unique name or ID of the community being reported.

Request Headers:

Content-Type: multipart/form-data
Authorization: Bearer YOUR_AUTH_TOKEN

Request Body:

textarea: string - A detailed description of the report.
reason: string - The reason for reporting.
csrf_token: string - CSRF token.

POST /communities/COMMUNITY/settings/customization

Update Community Customization Settings

Updates the icon, banner, description, and display name of a community.

Path Parameters:

COMMUNITY: string - The unique name or ID of the community.

Request Headers:

Content-Type: multipart/form-data
Authorization: Bearer YOUR_AUTH_TOKEN

Request Body:

icon*: binary file data - New community icon.
banner*: binary file data - New community banner image.
description*: string - Updated community description.
display-name*: string - Updated community display name.
csrf_token: string - CSRF token.

POST /communities/COMMUNITY/settings/members/USER/role

Update Community Member Role

Changes the role of a specific member within a community (e.g., from member to moderator).

Path Parameters:

COMMUNITY: string - The unique name or ID of the community.
USER: string - The username or ID of the member whose role is being changed.

Request Headers:

Content-Type: multipart/form-data
Authorization: Bearer YOUR_AUTH_TOKEN

Request Body:

role: string - The new role for the user (e.g., "member", "moderator", "admin").
csrf_token: string - CSRF token.

POST /communities/COMMUNITY/settings/visiblility

Update Community Visibility

Changes the visibility setting of a community (e.g., public or private).

Path Parameters:

COMMUNITY: string - The unique name or ID of the community.

Request Headers:

Content-Type: multipart/form-data
Authorization: Bearer YOUR_AUTH_TOKEN

Request Body:

visibility: string - The new visibility status (e.g., "public", "private").
csrf_token: string - CSRF token.

POST /communities/COMMUNITY/settings/members/USER/kick

Kick Community Member

Removes a user from the community.

Path Parameters:

COMMUNITY: string - The unique name or ID of the community.
USER: string - The username or ID of the member to kick.

Request Headers:

Content-Type: multipart/form-data
Authorization: Bearer YOUR_AUTH_TOKEN

Request Body:

password: string - Moderator's password for verification.
csrf_token: string - CSRF token.

POST /communities/COMMUNITY/settings/members/USER/ban

Ban Community Member

Bans a user from the community, preventing them from rejoining.

Path Parameters:

COMMUNITY: string - The unique name or ID of the community.
USER: string - The username or ID of the member to ban.

Request Headers:

Content-Type: multipart/form-data
Authorization: Bearer YOUR_AUTH_TOKEN

Request Body:

password: string - Moderator's password for verification.
reason: string - The reason for the ban.
csrf_token: string - CSRF token.

POST /communities/COMMUNITY/settings/members/USER/unban

Unban Community Member

Unbans a user from the community, allowing them to rejoin.

Path Parameters:

COMMUNITY: string - The unique name or ID of the community.
USER: string - The username or ID of the member to unban.

Request Headers:

Content-Type: multipart/form-data
Authorization: Bearer YOUR_AUTH_TOKEN

Request Body:

password: string - Moderator's password for verification.
csrf_token: string - CSRF token.

POST /communities/COMMUNITY/settings/pinned

Set Pinned Post in Community

Sets a specific post as the pinned post for the community.

Path Parameters:

COMMUNITY: string - The unique name or ID of the community.

Request Headers:

Content-Type: multipart/form-data
Authorization: Bearer YOUR_AUTH_TOKEN

Request Body:

pinned-post: string - The ID of the post to pin.
csrf_token: string - CSRF token.

POST /communities/COMMUNITY/settings/invite

Invite User to Community

Sends an invitation to a user to join the community.

Path Parameters:

COMMUNITY: string - The unique name or ID of the community.

Request Headers:

Content-Type: multipart/form-data
Authorization: Bearer YOUR_AUTH_TOKEN

Request Body:

username: string - The username of the user to invite.
csrf_token: string - CSRF token.

POST /communities/COMMUNITY/settings/transfer

Transfer Community Ownership

Transfers the ownership of the community to another user.

Path Parameters:

COMMUNITY: string - The unique name or ID of the community.

Request Headers:

Content-Type: multipart/form-data
Authorization: Bearer YOUR_AUTH_TOKEN

Request Body:

username: string - The username of the new owner.
password: string - Current owner's password for verification.
csrf_token: string - CSRF token.

POST /communities/COMMUNITY/settings/links

Update Community External Links

Updates the links associated with a specific community.

Path Parameters:

COMMUNITY: string - The unique name or ID of the community.

Request Headers:

Content-Type: multipart/form-data
Authorization: Bearer YOUR_AUTH_TOKEN

Request Body:

title[]*: string - Multiple titles for external links.
link[]*: string - Multiple URLs for external links.
csrf_token: string - CSRF token.

GET /explore/recent/render/PAGE

Render Recent Explore Content

Retrieves rendered HTML for recent content in the explore section, paginated.

Path Parameters:

PAGE: number - The page number for pagination.

Request Headers:

None.

Request Body:

None.

GET /explore/recent/get/PAGE

Get Recent Explore Content Data

Retrieves structured JSON data for recent content in the explore section, paginated.

Path Parameters:

PAGE: number - The page number for pagination.

Request Headers:

None.

Request Body:

None.

GET /explore/trending/render/PAGE

Render Trending Explore Content

Retrieves rendered HTML for trending content in the explore section, paginated.

Path Parameters:

PAGE: number - The page number for pagination.

Request Headers:

None.

Request Body:

None.

GET /explore/trending/get/PAGE

Get Trending Explore Content Data

Retrieves structured JSON data for trending content in the explore section, paginated.

Path Parameters:

PAGE: number - The page number for pagination.

Request Headers:

None.

Request Body:

None.

GET /explore/loved/render/PAGE

Render Loved Explore Content

Retrieves rendered HTML for most loved content in the explore section, paginated.

Path Parameters:

PAGE: number - The page number for pagination.

Request Headers:

None.

Request Body:

None.

GET /explore/loved/get/PAGE

Get Loved Explore Content Data

Retrieves structured JSON data for most loved content in the explore section, paginated.

Path Parameters:

PAGE: number - The page number for pagination.

Request Headers:

None.

Request Body:

None.

GET /explore/popular/render/PAGE

Render Popular Explore Content

Retrieves rendered HTML for popular content in the explore section, paginated.

Path Parameters:

PAGE: number - The page number for pagination.

Request Headers:

None.

Request Body:

None.

GET /explore/popular/get/PAGE

Get Popular Explore Content Data

Retrieves structured JSON data for popular content in the explore section, paginated.

Path Parameters:

PAGE: number - The page number for pagination.

Request Headers:

None.

Request Body:

None.

GET /feed/render?page=x

Render User Feed

Retrieves rendered HTML for the authenticated user's feed, paginated.

Query Parameters:

page: number - The page number for pagination.

Request Headers:

Authorization: Bearer YOUR_AUTH_TOKEN

Request Body:

None.

GET /explore/communities/recent/render/PAGE

Render Recent Communities in Explore

Retrieves rendered HTML for recently created communities in the explore section, paginated.

Path Parameters:

PAGE: number - The page number for pagination.

Request Headers:

None.

Request Body:

None.

GET /explore/communities/activity/render/PAGE

Render Active Communities in Explore

Retrieves rendered HTML for communities with recent activity in the explore section, paginated.

Path Parameters:

PAGE: number - The page number for pagination.

Request Headers:

None.

Request Body:

None.

GET /notification

Get Notification Count

Retrieves the number of unread notifications for the current user.

Request Headers:

Authorization: Bearer YOUR_AUTH_TOKEN

Request Body:

None.

GET /notifications/render/PAGE

Render Notifications

Retrieves a paginated list of rendered notifications for the current user.

Path Parameters:

PAGE: number - The page number for pagination.

Request Headers:

Authorization: Bearer YOUR_AUTH_TOKEN

Request Body:

None.

GET /notifications/get/PAGE

Get Notifications Data

Retrieves structured JSON data for a paginated list of notifications for the current user.

Path Parameters:

PAGE: number - The page number for pagination.

Request Headers:

Authorization: Bearer YOUR_AUTH_TOKEN

Request Body:

None.

POST /settings/customization

Update User Customization Settings

Updates the display name, description, profile icon, and banner for the authenticated user.

Request Headers:

Content-Type: multipart/form-data
Authorization: Bearer YOUR_AUTH_TOKEN

Request Body:

display-name*: string - The user's new display name.
description*: string - The user's new biography/description.
icon*: binary file data - New profile icon.
banner*: binary file data - New banner image.
csrf_token: string - CSRF token.

POST /settings/theme

Update User Theme

Changes the user's preferred theme.

Request Headers:

Content-Type: multipart/form-data
Authorization: Bearer YOUR_AUTH_TOKEN

Request Body:

theme: string - The new theme preference (e.g., "light", "dark").
csrf_token: string - CSRF token.

POST /settings/language

Update User Language

Changes the user's preferred language.

Request Headers:

Content-Type: multipart/form-data
Authorization: Bearer YOUR_AUTH_TOKEN

Request Body:

language: string - The new language code (e.g., "en", "es").
csrf_token: string - CSRF token.

POST /settings/notifications/loves

Toggle Love Notifications

Enables or disables notifications for when content is loved.

Request Headers:

Content-Type: multipart/form-data
Authorization: Bearer YOUR_AUTH_TOKEN

Request Body:

value: boolean - true to enable, false to disable.
csrf_token: string - CSRF token.

POST /settings/notifications/posts

Toggle Post Notifications

Enables or disables notifications when users you follow make posts.

Request Headers:

Content-Type: multipart/form-data
Authorization: Bearer YOUR_AUTH_TOKEN

Request Body:

value: boolean - true to enable, false to disable.
csrf_token: string - CSRF token.

POST /settings/notifications/pings

Toggle Ping Notifications

Enables or disables notifications when the user is pinged.

Request Headers:

Content-Type: multipart/form-data
Authorization: Bearer YOUR_AUTH_TOKEN

Request Body:

value: boolean - true to enable, false to disable.
csrf_token: string - CSRF token.

POST /settings/notifications/followers

Toggle Follower Notifications

Enables or disables notifications for new followers.

Request Headers:

Content-Type: multipart/form-data
Authorization: Bearer YOUR_AUTH_TOKEN

Request Body:

value: boolean - true to enable, false to disable.
csrf_token: string - CSRF token.

POST /settings/preferences/horizontal_content_scrolling

Toggle Horizontal Content Scrolling Preference

Sets the user's preference for horizontal content scrolling in the UI.

Request Headers:

Content-Type: multipart/form-data
Authorization: Bearer YOUR_AUTH_TOKEN

Request Body:

value: boolean - true to enable, false to disable.
csrf_token: string - CSRF token.

POST /settings/preferences/events_ui

Toggle Events UI Preference

Sets the user's preference for displaying special events in the UI.

Request Headers:

Content-Type: multipart/form-data
Authorization: Bearer YOUR_AUTH_TOKEN

Request Body:

value: boolean - true to enable, false to disable.
csrf_token: string - CSRF token.

GET /settings/referrals/generate

Generate New Referral Link

Generates a new referral link for the authenticated user.

Request Headers:

Authorization: Bearer YOUR_AUTH_TOKEN

Request Body:

None.

POST /settings/links

Update User External Links

Updates external links associated with the user's profile.

Request Headers:

Content-Type: multipart/form-data
Authorization: Bearer YOUR_AUTH_TOKEN

Request Body:

title[]*: string - Multiple titles for external links.
link[]*: string - Multiple URLs for external links.
csrf_token: string - CSRF token.

POST /bans/USER_ID/ban

Ban User (Internal)

Bans a usee. Requires admin authentication.

Path Parameters:

USER_ID: string - The ID of the user to ban.

Request Headers:

Content-Type: multipart/form-data
Authorization: Bearer YOUR_MODERATOR_AUTH_TOKEN

Request Body:

reason: string - The reason for the ban.
password: string - Moderator's password for verification.
csrf_token: string - CSRF token.

POST /bans/USER_ID/unban

Unban User (Internal)

Unbans a user. Requires admin authentication.

Path Parameters:

USER_ID: string - The ID of the user to unban.

Request Headers:

Content-Type: multipart/form-data
Authorization: Bearer YOUR_MODERATOR_AUTH_TOKEN

Request Body:

password: string - Moderator's password for verification.
csrf_token: string - CSRF token.

POST /bans/USER_ID/edit

Edit User Ban Reason (Internal)

Modifies the reason for an existing user ban. Requires admin authentication.

Path Parameters:

USER_ID: string - The ID of the banned user.

Request Headers:

Content-Type: multipart/form-data
Authorization: Bearer YOUR_MODERATOR_AUTH_TOKEN

Request Body:

reason: string - The new reason for the ban.
password: string - Moderator's password for verification.
csrf_token: string - CSRF token.

POST /reports/REPORT_ID/discard

Discard Report (Internal)

Discards a specific report, marking it as resolved or irrelevant. Requires moderator authentication.

Path Parameters:

REPORT_ID: string - The ID of the report to discard.

Request Headers:

Content-Type: multipart/form-data
Authorization: Bearer YOUR_MODERATOR_AUTH_TOKEN

Request Body:

password: string - Moderator's password for verification.
csrf_token: string - CSRF token.

POST /settings/internal/USER_ID/customization

Update User Internal Customization (Internal)

Allows internal administrators to modify user flags (e.g., administrator status, verified status, bug hunter status).

Path Parameters:

USER_ID: string - The ID of the user to customize.

Request Headers:

Content-Type: multipart/form-data
Authorization: Bearer YOUR_ADMIN_AUTH_TOKEN

Request Body:

administrator: boolean - true or false to set/unset administrator status.
user-verified: boolean - true or false to set/unset user verified status.
user-bug-hunter: boolean - true or false to set/unset bug hunter status.
csrf_token: string - CSRF token.

POST /communities/COMMUNITY/settings/internal/customization

Update Community Internal Customization (Internal)

Allows internal administrators to modify community flags (e.g., verified status, disabled status).

Path Parameters:

COMMUNITY: string - The unique name or ID of the community.

Request Headers:

Content-Type: multipart/form-data
Authorization: Bearer YOUR_ADMIN_AUTH_TOKEN

Request Body:

group-verified: boolean - true or false to set/unset community verified status.
group-disabled: boolean - true or false to enable/disable the community.
csrf_token: string - CSRF token.

POST /interactions/internal/INTERACTION_ID/edit

Edit Interaction Internally (Internal)

Allows internal administrators to edit the content of any post, comment, or reply.

Path Parameters:

INTERACTION_ID: string - The ID of the interaction (post, comment, or reply).

Request Headers:

Content-Type: multipart/form-data
Authorization: Bearer YOUR_ADMIN_AUTH_TOKEN

Request Body:

textarea: string - The updated text content of the interaction.
audience*: string - Optional: The updated audience setting for posts.
files[]*: binary file data - Optional: New or updated file uploads.
csrf_token: string - CSRF token.

GET /statistics/interactions

Get Global Interaction Statistics

Retrieves global data for interaction statistics (posts, comments, replies) over time.

Request Headers:

None.

Request Body:

None.

GET /statistics/engagements

Get Global Engagement Statistics

Retrieves global data for user engagement (e.g., loves, votes etc) over time.

Request Headers:

None.

Request Body:

None.

GET /statistics/interactions?user=USERNAME

Get User Interaction Statistics

Retrieves interaction statistics (posts, comments, replies) for a specific user over time.

Query Parameters:

user: string - The username of the target user.

Request Headers:

None.

Request Body:

None.

GET /statistics/engagements?user=USERNAME

Get User Engagement Statistics

Retrieves engagement statistics (e.g., content loved, votes cast etc) for a specific user over time.

Query Parameters:

user: string - The username of the target user.

Request Headers:

None.

Request Body:

None.

GET /statistics/biggest_lovers

Get Biggest Lovers

Retrieves a list of users who have loved the most content.

Request Headers:

None.

Request Body:

None.

GET /statistics/biggest_posters

Get Biggest Posters

Retrieves a list of users who have created the most posts.

Request Parameters:

None.

Request Body:

None.

POST /polls/POST_ID/vote

Vote on Poll

Casts a vote on a specific poll.

Path Parameters:

POST_ID: string - The ID of the post containing the poll.

Request Headers:

Content-Type: multipart/form-data
Authorization: Bearer YOUR_AUTH_TOKEN

Request Body:

option: number - The index of the chosen poll option (0-indexed).
csrf_token: string - CSRF token.

Darflen API Documentation

Base URL

General Endpoints

Record User is Online

Request Headers:

Request Body:

Search Autocomplete

Query Parameters:

Request Headers:

Request Body:

Perform Search

Query Parameters:

Request Headers:

Request Body:

Render Search Results

Query Parameters:

Request Headers:

Request Body:

Authentication & User Endpoints

User Login

Request Headers:

Request Body:

User Registration

Request Headers:

Request Body:

Logout Current Session

Request Headers:

Request Body:

Logout Specific Device Session

Request Headers:

Request Body:

Logout All Device Sessions

Request Headers:

Request Body:

Change Username

Request Headers:

Request Body:

Change Password

Request Headers:

Request Body:

Change Email

Request Headers:

Request Body:

Verify Email

Request Headers:

Request Body:

Initiate Forgot Password

Request Headers:

Request Body:

Discard Authentication Token

Path Parameters:

Request Headers:

Request Body:

User Endpoints

Get User Profile

Path Parameters:

Request Headers:

Request Body:

Get User Followers

Path Parameters:

Request Headers:

Request Body:

Get User Following

Path Parameters:

Request Headers:

Request Body:

Get User Posts

Path Parameters:

Request Headers:

Request Body:

Get User Communities

Path Parameters:

Request Headers:

Request Body:

Get User Loves

Path Parameters:

Request Headers:

Request Body:

Follow/Unfollow User

Path Parameters: