Assign and list group AI agent assignments
Wellesley Platform API (1.0)
Download OpenAPI description
Languages
Servers
Mock server
https://docs.wellesley.social/_mock/openapi/
Simple setup, all in one. Digital Ocean
https://dust.allroads.social/
Simple setup, db is separate. Digital Ocean
https://meteor.allroads.social/
Admin Domain Blocks
Administrative APIs for managing domain blocks. Provides endpoints to block specific domains with different severity levels (SUSPEND, LIMIT, NOOP), update existing blocks, unblock domains, and list currently blocked domains. Domain blocks prevent or limit federation with specified domains.
Operations
Group Channels
API endpoints for managing channels within groups. Channels are specialized accounts that enable organized content distribution within groups. They support hierarchical organization with main and default channels, privacy controls inherited from parent groups, and both scoped (group-specific) and global usernames for discovery. Group administrators manage channels while members can follow them.
Operations
Group Members
API endpoints for managing group membership. Provides functionality to add, update, and remove members from groups, as well as retrieve membership information. Supports both local and federated groups through ActivityPub protocol. Access control is enforced based on group privacy settings and user permissions.
Operations
Group Questions
API endpoints for managing group entry questions. Groups can require prospective members to answer questions before joining. Questions support multiple types (text, single choice, multiple choice) and are used to screen members when the group's join mode is set to QUESTIONS. Answers are validated and generate a token that can be used during the join process.
Operations
Group Rules
API endpoints for managing community rules within groups. Rules define the expected conduct and content policies that members must follow. Each rule consists of text (the rule itself), a hint (explanation or context), and an ordering value for display sequence. Rules are scoped to specific groups and can be managed by users with appropriate permissions.
Operations
Platform Data
Endpoints for managing platform-wide and group-specific data storage. Unlike application data, this provides direct data management not tied to specific applications. Supports flexible ownership models including platform-level, group-level, and user-level data with appropriate access controls.
Operations
RBAC
Endpoints for retrieving Role-Based Access Control (RBAC) configurations and managing roles, resources, permissions and role-to-user assignments. Scoped Role Definition (RBACRole):
- Represents roles within the RBAC system.
- Each role has a unique
roleId, aname, an optionaldescription, and ascope. - The
scopedefines the domain or area in which the role is valid. - The
scopecan be Global (hardcoded), currently the only one is "System" - The
scopealso can be dynamic, currently we use Group Ids, like "gr_05hxcvk1hjexere4pvtrj0hggt" - Roles come with assigned permissions (
RBACPermissions) that define what actions the role can perform on system resources. - Metadata such as
createdAtandupdatedAttimestamps track the role's lifecycle events.
Permissions** (RBACPermissions):
- Encapsulates resource-specific access controls.
- Each permission object specifies the
resource(e.g., "user", "document") and an associated list of allowedRBACAccesstypes. RBACAccessenumerates the supported actions:Read,Add,Modify,Delete.
Role Assignments to Actors (RBACActorRole):
- Maps actors (e.g., users, services) to specific roles.
- Tracks the association through
actorId(representing the unique entity being assigned) androleId(specific role ID). - Includes timestamps to record when the assignment was created or updated.
Operations
Query
Actor Type, one of Person, Group, Service. Default is Person
Enum"Application""Group""Organization""Person""Service"
Only include specific types of results. Like posts, users, tags
Enum"users""posts""tags""events""groups"
following/follower status. Default ACCEPTED
Default "ACCEPTED"
Enum"PENDING""ACCEPTED""REJECTED"
Get older records (records with IDs less than this value) Alias maxId/max_id
Example: lastId=?lastId=${data.last().id}
Get newer records (records with IDs greater than this value) Alias minId/min_id
Example: untilId=?untilId=${data.first().id}
- Mock serverhttps://docs.wellesley.social/_mock/openapi/api/v1/search
- Simple setup, all in one. Digital Oceanhttps://dust.allroads.social/api/v1/search
- Simple setup, db is separate. Digital Oceanhttps://meteor.allroads.social/api/v1/search
- curl
- JavaScript
- Node.js
- Python
- Java
- C#
- PHP
- Go
- Ruby
- R
- Payload
curl -i -X GET \
'https://docs.wellesley.social/_mock/openapi/api/v1/search?actorType=Application&fasp=true&faspHydrated=true&filter=users&followStatus=ACCEPTED&followers=true&following=true&groupId=us_01hxcvk1hjexere4pvtrj0ymqq&lastId=%3FlastId%3D%24{data.last%28%29.id}&limit=0&offset=0&ownerId=us_01hxcvk1hjexere4pvtrj0ymqq&ownerType=USER&q=string&resolve=true&sortBy=string&sortOrder=string&untilId=%3FuntilId%3D%24{data.first%28%29.id}&withComments=true&withParent=true'Search result
User's summary or bio
Example: "Pixels are my paint, code is my canvas, creativity is my brush."
User stats
users[].​stats.​followingHiddenbooleanrequired
privacy setting to hide followings
User fields
Registration mode:
- REGULAR - just regular state
- SENSITIVE - all media attachments are flagged as sensitive, i.e. all user's posts should be marked as sensitive, old posts and all future ones.
- LIMITED - all user's old and future posts should be set maximum to followers only unless user set it to direct himself. non-followers should not be notified, i.e. if user mentions non-follower we do not create notification.
- SUSPENDED - User can login, but cannot do anything in his account except to read, cannot change anything, cannot create new posts or comments etc. All his posts are marked as deleted, but we do not delete them just yet. User is scheduled to be deleted in one month. During this month it is possible to restore it via admin.
Enum"REGULAR""SENSITIVE""LIMITED""SUSPENDED"
Software platform type (wellesley, mastodon, threads.net)
Example: "wellesley"
- PUBLIC - Channel is visible to everyone and can be followed by anyone.
- PRIVATE - Channel is visible only to group members and can only be followed by group members.
Enum"PUBLIC""PRIVATE"
Types that an Actor can be assigned. Coincide with ActivityPub Actor types:
- APPLICATION: Apps will have this type
- GROUP: Interest Groups and Generic Groups wil have this type
- ORGANIZATION: Formal Organizations such as Companies, Institutions, etc. will have this type
- PERSON: Individual people will have this type
- SERVICE: Bots, Services, and other automated tools which are not also Apps will have this type
Enum"Application""Group""Organization""Person""Service"
replies path
Example: ["us_01hxcvk1hjexere4pvtrj0ymqq"]
Privacy levels for posts:
- PUBLIC - post is visible to anyone, including people who are not logged in and those who do not follow the user. It appears in the public timelines (home, local, and federated).
- UNLISTED - post is visible to anyone who visits the user's profile, but it does not appear in public timelines. Only followers and those who visit the user's profile directly can see it.
- PRIVATE - post is only visible to the user's followers. It does not appear in public timelines or on the user's profile for non-followers.
- DIRECT - post is visible only to the mentioned users. It functions like a direct message and is not visible on public timelines, the user's profile, or to followers.
- FOLLOW_POST - comment only. Follow parent post visibility
Enum"PUBLIC""UNLISTED""PRIVATE""DIRECT""FOLLOW_POST"
Example: "PUBLIC"
id of a post this one was reposted from
Example: "us_01hxcvk1hjexere4pvtrj0ymqq"
UUID with type prefix
Example: "us_01hxcvk1hjexere4pvtrj0ymqq"
Owner types for posts:
- USER - user’s channel (personal or group channel)
- EVENT - event (personal or group)
- CATEGORY - forum category
** POST OWNER: **
- Personal channel
- userId = author
- ownerId = userId (Type.USER)
- ownerType = USER
- groupId = null
- Forum post
- userId = author
- ownerId = categoryId (Type.CATEGORY)
- ownerType = CATEGORY
- groupId = forum’s groupId
- Personal event
- userId = author
- ownerId = eventId (Type.EVENT)
- ownerType = EVENT
- groupId = null
- Group channel
- userId = author
- ownerId = channel userId (Type.USER)
- ownerType = USER
- groupId = groupId
- Group event
- userId = author
- ownerId = eventId (Type.EVENT)
- ownerType = EVENT
- groupId = groupId
Enum"USER""EVENT""CATEGORY"
Subject or summary line, below which post content is collapsed until expanded.
Stats
Settings
Post media type. Default for Note is text/plain, for Article text/markdown
Enum"TEXT_PLAIN""MARKDOWN"
One of account's users. Can be multiple per account
internal id of this user
Example: "us_01hxcvk1hjexere4pvtrj0ymqq"
user's domain, remote only, empty for local
Example: "wlsly1.net"
URI of this user
Example: "https://wlsly1.net/users/john_smith"
Registration mode:
- REGULAR - just regular state
- SENSITIVE - all media attachments are flagged as sensitive, i.e. all user's posts should be marked as sensitive, old posts and all future ones.
- LIMITED - all user's old and future posts should be set maximum to followers only unless user set it to direct himself. non-followers should not be notified, i.e. if user mentions non-follower we do not create notification.
- SUSPENDED - User can login, but cannot do anything in his account except to read, cannot change anything, cannot create new posts or comments etc. All his posts are marked as deleted, but we do not delete them just yet. User is scheduled to be deleted in one month. During this month it is possible to restore it via admin.
Enum"REGULAR""SENSITIVE""LIMITED""SUSPENDED"
UUID with type prefix
Example: "us_01hxcvk1hjexere4pvtrj0ymqq"
- PUBLIC - Channel is visible to everyone and can be followed by anyone.
- PRIVATE - Channel is visible only to group members and can only be followed by group members.
Enum"PUBLIC""PRIVATE"
Types that an Actor can be assigned. Coincide with ActivityPub Actor types:
- APPLICATION: Apps will have this type
- GROUP: Interest Groups and Generic Groups wil have this type
- ORGANIZATION: Formal Organizations such as Companies, Institutions, etc. will have this type
- PERSON: Individual people will have this type
- SERVICE: Bots, Services, and other automated tools which are not also Apps will have this type
Enum"Application""Group""Organization""Person""Service"
User id this upload belongs to
Example: "us_01hxcvk1hjexere4pvtrj0ymqq"
Type of the upload
Enum"VIDEO""IMAGE""AUDIO""DOCUMENT""OTHER"
Example: "video"
Meta data
List of all the files this upload has
File id
Example: "us_01hxcvk1hjexere4pvtrj0ymqq"
true if this file is original, false if it is a derivative
File metadata. Contains optional values for width, height etc.
Example: "2022-03-10T16:15:50Z"
Example: "2022-03-10T16:15:50Z"
List of tags attached to upload
Items Enum"Post""Avatar""Header""Album""Emoji""Event"
Example: ["$post"]
Original of repost/quote. In WS context or /replies API could also be parent of a comment
Stats
Event attendee statuses
- INVITED - a user has been invited to an event (for private events only).
- JOINED - a user has joined and thus attending an event.
- JOINED_TENTATIVELY - a user has tentatively joined / show an interest in an event.
- REJECTED - a user has rejected an event invitation, and won't attend an event (for private events only).
Enum"INVITED""JOINED""JOINED_TENTATIVELY""REJECTED"
Example: "INVITED"
Privacy levels for posts:
- PUBLIC - post is visible to anyone, including people who are not logged in and those who do not follow the user. It appears in the public timelines (home, local, and federated).
- UNLISTED - post is visible to anyone who visits the user's profile, but it does not appear in public timelines. Only followers and those who visit the user's profile directly can see it.
- PRIVATE - post is only visible to the user's followers. It does not appear in public timelines or on the user's profile for non-followers.
- DIRECT - post is visible only to the mentioned users. It functions like a direct message and is not visible on public timelines, the user's profile, or to followers.
- FOLLOW_POST - comment only. Follow parent post visibility
Enum"PUBLIC""UNLISTED""PRIVATE""DIRECT""FOLLOW_POST"
One of account's users. Can be multiple per account
internal id of this user
Example: "us_01hxcvk1hjexere4pvtrj0ymqq"
user's domain, remote only, empty for local
Example: "wlsly1.net"
URI of this user
Example: "https://wlsly1.net/users/john_smith"
Example: "2022-03-10T16:15:50Z"
Registration mode:
- REGULAR - just regular state
- SENSITIVE - all media attachments are flagged as sensitive, i.e. all user's posts should be marked as sensitive, old posts and all future ones.
- LIMITED - all user's old and future posts should be set maximum to followers only unless user set it to direct himself. non-followers should not be notified, i.e. if user mentions non-follower we do not create notification.
- SUSPENDED - User can login, but cannot do anything in his account except to read, cannot change anything, cannot create new posts or comments etc. All his posts are marked as deleted, but we do not delete them just yet. User is scheduled to be deleted in one month. During this month it is possible to restore it via admin.
Enum"REGULAR""SENSITIVE""LIMITED""SUSPENDED"
UUID with type prefix
Example: "us_01hxcvk1hjexere4pvtrj0ymqq"
- PUBLIC - Channel is visible to everyone and can be followed by anyone.
- PRIVATE - Channel is visible only to group members and can only be followed by group members.
Enum"PUBLIC""PRIVATE"
Types that an Actor can be assigned. Coincide with ActivityPub Actor types:
- APPLICATION: Apps will have this type
- GROUP: Interest Groups and Generic Groups wil have this type
- ORGANIZATION: Formal Organizations such as Companies, Institutions, etc. will have this type
- PERSON: Individual people will have this type
- SERVICE: Bots, Services, and other automated tools which are not also Apps will have this type
Enum"Application""Group""Organization""Person""Service"
group metadata including color
- PUBLIC - Open Content. Content and membership are viewable by anyone.
- PRIVATE - Members-Only Content. Outsiders cannot see posts or members unless they join.
Enum"PUBLIC""PRIVATE"
- VISIBLE - The group is listed openly. It shows up in search results or directory listings.
- UNLISTED - The group does not appear in public lists but is accessible via direct link.
- HIDDEN - The group is completely hidden and invite-only. Shared links will return 404 for non-members.
Enum"VISIBLE""UNLISTED""HIDDEN"
- OPEN - Anyone can join the group immediately without approval.
- APPROVAL - User requests must be approved by a group admin or moderator.
- INVITE_ONLY - Only users with an invitation from a member can join.
Enum"OPEN""APPROVAL""INVITE_ONLY"
ID of the forum associated with this group
Example: "us_01hxcvk1hjexere4pvtrj0ymqq"
Group statistics
Custom fields for the group
Group deletion timestamp
Example: "2022-03-10T16:15:50Z"
Group's creation timestamp
Example: "2022-03-10T16:15:50Z"
Group's last update timestamp
Example: "2022-03-10T16:15:50Z"
Response
application/json
{ "users": [ { … } ], "posts": [ { … } ], "tags": [ "string" ], "events": [ { … } ], "groups": [ { … } ] }