XenForo for 2.X versions

[cadox8]

This issue will keep the progress until the framework is released

Docs progress will not appear on this issue

Alerts

• GET alerts - Gets the API user's list of alerts
• POST alerts - Sends an alert to the specified user. Only available to super user keys.
• POST alerts/mark-all - Marks all of the API user's alerts as read or viewed. Must specify "read" or "viewed" parameters.
• GET alerts/{id} - Gets information about the specified alert
• POST alerts/{id}/mark - Marks the alert as viewed/read/unread. (Marking as unviewed is not supported.)

Attachments

• GET attachments - Gets the attachments associated with the provided API attachment key. Only returns attachments that have not been associated with content.
• POST attachments - Uploads an attachment. An API attachment key must be created first. Must be submitted using multipart/form-data encoding.
• POST attachments/new-key - Creates a new attachment key, allowing attachments to be uploaded separately from the related content.
• GET attachments/{id} - Gets information about the specified attachment.
• DELETE attachments/{id} - Delete's the specified attachment.
• GET attachments/{id}/data - Gets the data that makes up the specified attachment. The output is the raw binary data.
• GET attachments/{id}/thumbnail - Gets the URL to the attachment's thumbnail, if it has one. URL returned via a 301 redirect.

Auth

• POST auth - Tests a login and password for validity. Only available to super user keys. We strongly recommend the login and password parameters are passed into the request body rather than the query string.
• POST auth/from-session - Looks up the active XenForo user based on session ID or remember cookie value. This can be used to help with seamless SSO with XF, assuming the session or remember cookies are available to your page. At least one of session_id and remember_cookie must be provided. Only available to super user keys.
• POST auth/login-token - Generates a token that can automatically log into a specific XenForo user when the login URL is visited. If the visitor is already logged into a XenForo account, they will not be logged into the specified account. Only available to super user keys.

Conversations

• POST conversation-messages - Replies to a conversation
• GET conversation-messages/{id} - Gets the specified conversation message.
• POST conversation-messages/{id} - Updates the specified conversation message.
• POST conversation-messages/{id}/react - Reacts to the specified conversation message
• GET conversations - Gets the API user's list of conversations.
• POST conversations - Creates a conversation
• GET conversations/{id} - Gets information about the specified conversation.
• POST conversations/{id} - Updates the specified conversation
• DELETE conversations/{id} - Deletes the specified conversation from the API user's list. Does not `DELETE the conversation for other receivers.
• POST conversations/{id}/invite - Invites the specified users to this conversation.
• POST conversations/{id}/mark-read - Marks the conversation as read up until the specified time. This cannot move the
• POST conversations/{id}/mark-unread - Marks a conversation as unread. This will mark all messages in the conversation as unread.
• GET conversations/{id}/messages - Gets a page of messages in the specified conversation.
• POST conversations/{id}/star - Sets the star status of the specified conversation

Forums

• GET forums/{id} - Gets information about the specified forum
• POST forums/{id}/mark-read - Marks the forum as read up until the specified time. This cannot mark a forum as unread or
• GET forums/{id}/threads - Gets a page of threads from the specified forum.

Index

• GET index - Gets general information about the site and the API

Me

• GET me - Gets information about the current API user
• POST me - Updates information about the current user
• POST me/avatar - Updates the current user's avatar
• DELETE me/avatar - Deletes the current user's avatar
• POST me/email - Updates the current user's email address
• POST me/password - Updates the current user's password

Nodes

• GET nodes - Gets the node tree.
• POST nodes - Creates a new node
• GET nodes/flattened - Gets a flattened node tree. Traversing this will return a list of nodes in the expected order.
• GET nodes/{id} - Gets information about the specified node
• POST nodes/{id} - Updates the specified node
• DELETE nodes/{id} - Deletes the specified node

Posts

• POST posts - Adds a new reply to a thread.
• GET posts/{id} - Gets information about the specified post
• POST posts/{id} - Updates the specified post
• DELETE posts/{id} - Deletes the specified post. Default to soft deletion.
• POST posts/{id}/mark-solution - Toggle the specified post as the solution to its containing thread. If a post is marked as a solution when another is already marked, the existing solution will be unmarked.
• POST posts/{id}/react - Reacts to the specified post
• POST posts/{id}/vote - Votes on the specified post (if applicable)

Profile Posts

• POST profile-posts-comments - Creates a new profile post comment.
• GET profile-post-comments/{id} - Gets information about the specified profile post comment.
• POST profile-post-comments/{id} - Updates the specified profile post comment.
• DELETE profile-post-comments/{id} - Deletes the specified profile post comment. Default to soft deletion.
• POST profile-post-comments/{id}/react - Reacts to the specified profile post comment
• POST profile-posts - Creates a new profile post.
• GET profile-posts/{id} - Gets information about the specified profile post.
• POST profile-posts/{id} - Updates the specified profile post.
• DELETE profile-posts/{id} - Deletes the specified profile post. Default to soft deletion.
• GET profile-posts/{id}/comments Gets a page of comments on the specified profile post.
• POST profile-posts/{id}/react - Reacts to the specified profile post

Search Forums

• POST search - Creates a new search
• POST search/member - Retrieves search results for a specific member
• GET search/{id} - Retrieves search results for a given search
• POST search/{id}/older - Retrieves older search results for a given search
• GET search-forums/{id} - Gets information about the specified search forum
• GET search-forums/{id}/threads - Gets a page of threads from the specified search forum.

Stats

• GET stats - Gets site statistics and general activity information

Threads

• GET threads - Gets a list of threads
• POST threads - Creates a thread. Thread type data can be set using additional input specific to the tar`GET thread type.
• GET threads/{id} - Gets information about the specified thread.
• POST threads/{id} - Updates the specified thread
• DELETE threads/{id} - Deletes the specified thread. Default to soft deletion.
• POST threads/{id}/change-type - Converts a thread to the specified type. Additional thread type data can be set using input specific to the new thread type.
• POST threads/{id}/mark-read - Marks the thread as read up until the specified time. This cannot mark a thread as unread or
• POST threads/{id}/move - Moves the specified thread to a different forum. Only simple title/prefix updates are supported at the same time
• GET threads/{id}/posts - Gets a page of posts in the specified conversation.
• POST threads/{id}/vote - Votes on the specified thread (if applicable)

Users

• GET users - Gets a list of users (alphabetically)
• POST users - Creates a user.
• GET users/find-email - Finds users by their email. Only available to admin users (or when bypassing permissions).
• GET users/find-name - Finds users by a prefix of their user name.
• GET users/{id} - Gets information about the specified user.
• POST users/{id} - Updates an existing user.
• DELETE users/{id} - Deletes the specified user
• POST users/{id}/avatar - Updates the specified user's avatar
• DELETE users/{id}/avatar - Deletes the specified user's avatar
• GET users/{id}/profile-posts - Gets a page of profile posts on the specified user's profile.

OAuth2

• POST oauth2/revoke - Revokes an access token or refresh token.
• GET oauth2/token - [Incomplete documentation]
• POST oauth2/token - [Incomplete documentation]

OEmbed

• GET oembed - [Incomplete documentation]

[cadox8]

20251025 - Released v2.0.0.7-SNAPSHOT

[cadox8]

20251027 - Released 2.0.0-9-SNAPSHOT
2.0.0-9-SNAPSHOT Javadocs