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
Request
Retrieves emojis by exact shortcodes and/or by exact categories from cache. Multiple values can be requested in a single call using comma separation. If both parameters are provided, the union of results is returned. Returns paginated response with items (current page results), total (count matching filter), and totalItems (total emojis in system).
- Mock serverhttps://docs.wellesley.social/_mock/openapi/api/v1/custom_emojis
- Simple setup, all in one. Digital Oceanhttps://dust.allroads.social/api/v1/custom_emojis
- Simple setup, db is separate. Digital Oceanhttps://meteor.allroads.social/api/v1/custom_emojis
- curl
- JavaScript
- Node.js
- Python
- Java
- C#
- PHP
- Go
- Ruby
- R
- Payload
curl -i -X GET \
'https://docs.wellesley.social/_mock/openapi/api/v1/custom_emojis?category=Cats%2CDogs&lastId=%3FlastId%3D%24{data.last%28%29.id}&limit=0&offset=0&shortcode=aaaa%2CAAAAAA&sortBy=string&sortOrder=string&untilId=%3FuntilId%3D%24{data.first%28%29.id}'Response
application/json
{ "items": [ { … }, { … } ], "total": 2, "totalItems": 100 }
- Mock serverhttps://docs.wellesley.social/_mock/openapi/api/v1/custom_emojis
- Simple setup, all in one. Digital Oceanhttps://dust.allroads.social/api/v1/custom_emojis
- Simple setup, db is separate. Digital Oceanhttps://meteor.allroads.social/api/v1/custom_emojis
- curl
- JavaScript
- Node.js
- Python
- Java
- C#
- PHP
- Go
- Ruby
- R
- Payload
curl -i -X DELETE \
'https://docs.wellesley.social/_mock/openapi/api/v1/custom_emojis?category=%3Fcategory%3DCats%2CDogs&shortcode=%3Fshortcode%3Daaa%2CAAA'Request
Creates a custom emoji by downloading from provided URLs. The emoji file is downloaded, processed, and stored locally. Supports overwriting existing emojis with the same shortcode. Can specify category, visibility, and domain for federated emojis. Requires Emojis.Manage permission (admin only).
RBAC: requires Emojis.Manage
Json object with the emoji data: shortcode, category, url, staticUrl, visibleInPicker
- Mock serverhttps://docs.wellesley.social/_mock/openapi/api/v1/custom_emojis
- Simple setup, all in one. Digital Oceanhttps://dust.allroads.social/api/v1/custom_emojis
- Simple setup, db is separate. Digital Oceanhttps://meteor.allroads.social/api/v1/custom_emojis
- curl
- JavaScript
- Node.js
- Python
- Java
- C#
- PHP
- Go
- Ruby
- R
- Payload
curl -i -X POST \
'https://docs.wellesley.social/_mock/openapi/api/v1/custom_emojis?overwrite=true' \
-H 'Content-Type: application/json' \
-d '{
"shortcode": "string",
"category": "string",
"url": "http://example.com",
"staticUrl": "string",
"visibleInPicker": true
}'Response
application/json
"\n {\n \"shortcode\": \"aaaa\",\n \"url\": \"https://files.mastodon.social/custom_emojis/images/000/007/118/original/aaaa.png\",\n \"static_url\": \"https://files.mastodon.social/custom_emojis/images/000/007/118/static/aaaa.png\",\n \"visibleInPicker\": true\n \"category\": \"Cats\",\n \"domain\": \"mastodon.social\"\n }\n ]\n "
- Mock serverhttps://docs.wellesley.social/_mock/openapi/api/v1/custom_emojis/categories
- Simple setup, all in one. Digital Oceanhttps://dust.allroads.social/api/v1/custom_emojis/categories
- Simple setup, db is separate. Digital Oceanhttps://meteor.allroads.social/api/v1/custom_emojis/categories
- curl
- JavaScript
- Node.js
- Python
- Java
- C#
- PHP
- Go
- Ruby
- R
- Payload
curl -i -X GET \
'https://docs.wellesley.social/_mock/openapi/api/v1/custom_emojis/categories?lastId=%3FlastId%3D%24{data.last%28%29.id}&limit=0&offset=0&q=string&sortBy=string&sortOrder=string&untilId=%3FuntilId%3D%24{data.first%28%29.id}'- Mock serverhttps://docs.wellesley.social/_mock/openapi/api/v1/custom_emojis/export
- Simple setup, all in one. Digital Oceanhttps://dust.allroads.social/api/v1/custom_emojis/export
- Simple setup, db is separate. Digital Oceanhttps://meteor.allroads.social/api/v1/custom_emojis/export
- curl
- JavaScript
- Node.js
- Python
- Java
- C#
- PHP
- Go
- Ruby
- R
- Payload
curl -i -X GET \
'https://docs.wellesley.social/_mock/openapi/api/v1/custom_emojis/export?category=string'Request
Imports multiple emojis from a ZIP archive. Filenames (without extension) become emoji shortcodes. All imported emojis share the same category and visibility settings. Images are automatically resized to 128x128 if larger. Animated GIFs are preserved with static versions generated. Supports batch overwriting of existing emojis. Requires Emojis.Manage permission (admin only).
RBAC: requires Emojis.Manage
Zip file with the emojis.
- Mock serverhttps://docs.wellesley.social/_mock/openapi/api/v1/custom_emojis/import
- Simple setup, all in one. Digital Oceanhttps://dust.allroads.social/api/v1/custom_emojis/import
- Simple setup, db is separate. Digital Oceanhttps://meteor.allroads.social/api/v1/custom_emojis/import
- curl
- JavaScript
- Node.js
- Python
- Java
- C#
- PHP
- Go
- Ruby
- R
- Payload
curl -i -X POST \
'https://docs.wellesley.social/_mock/openapi/api/v1/custom_emojis/import?category=string&domain=string&overwrite=true&visible=true' \
-H 'Content-Type: multipart/form-data' \
-F file=stringResponse
application/json
[ { "shortcode": "aaaa", "url": "https://files.mastodon.social/custom_emojis/images/000/007/118/original/aaaa.png", "static_url": "https://files.mastodon.social/custom_emojis/images/000/007/118/static/aaaa.png", "visibleInPicker": true, "category": "Cats" }, { "shortcode": "AAAAAA", "url": "https://files.mastodon.social/custom_emojis/images/000/071/387/original/AAAAAA.png", "static_url": "https://files.mastodon.social/custom_emojis/images/000/071/387/static/AAAAAA.png", "visibleInPicker": true, "category": "Blobs" } ]
Request
Imports multiple emojis from a ZIP archive that was previously uploaded via /uploads. Filenames (without extension) become emoji shortcodes. All imported emojis share the same category and visibility settings. Images are automatically resized to 128x128 if larger. Animated GIFs are preserved with static versions generated. Supports batch overwriting of existing emojis.
RBAC: requires Emojis.Manage
- Mock serverhttps://docs.wellesley.social/_mock/openapi/api/v1/custom_emojis/import/upload
- Simple setup, all in one. Digital Oceanhttps://dust.allroads.social/api/v1/custom_emojis/import/upload
- Simple setup, db is separate. Digital Oceanhttps://meteor.allroads.social/api/v1/custom_emojis/import/upload
- curl
- JavaScript
- Node.js
- Python
- Java
- C#
- PHP
- Go
- Ruby
- R
- Payload
curl -i -X POST \
'https://docs.wellesley.social/_mock/openapi/api/v1/custom_emojis/import/upload?category=string&domain=string&overwrite=true&uploadId=us_01hxcvk1hjexere4pvtrj0ymqq&visible=true'Response
application/json
[ { "shortcode": "string", "category": "string", "url": "http://example.com", "staticUrl": "string", "visibleInPicker": true } ]
Request
Searches for emojis whose shortcodes or categories contain provided substrings. Useful for autocomplete functionality. Multiple searches can be performed in one request by passing comma-separated values. If no parameters provided, returns all emojis from cache. Returns paginated response with items (current page results), total (count matching filter), and totalItems (total emojis in system).
- Mock serverhttps://docs.wellesley.social/_mock/openapi/api/v1/custom_emojis/search
- Simple setup, all in one. Digital Oceanhttps://dust.allroads.social/api/v1/custom_emojis/search
- Simple setup, db is separate. Digital Oceanhttps://meteor.allroads.social/api/v1/custom_emojis/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/custom_emojis/search?category=Cat%2CBlob&lastId=%3FlastId%3D%24{data.last%28%29.id}&limit=0&offset=0&shortcode=aaa%2CAAA&sortBy=string&sortOrder=string&untilId=%3FuntilId%3D%24{data.first%28%29.id}'Response
application/json
{ "items": [ { … }, { … } ], "total": 15, "totalItems": 100 }
- Mock serverhttps://docs.wellesley.social/_mock/openapi/api/v1/custom_emojis/upload
- Simple setup, all in one. Digital Oceanhttps://dust.allroads.social/api/v1/custom_emojis/upload
- Simple setup, db is separate. Digital Oceanhttps://meteor.allroads.social/api/v1/custom_emojis/upload
- curl
- JavaScript
- Node.js
- Python
- Java
- C#
- PHP
- Go
- Ruby
- R
- Payload
curl -i -X POST \
'https://docs.wellesley.social/_mock/openapi/api/v1/custom_emojis/upload?category=string&domain=string&overwrite=true&shortcode=string&uploadId=us_01hxcvk1hjexere4pvtrj0ymqq&visible=true'Response
application/json
{ "shortcode": "string", "category": "string", "url": "http://example.com", "staticUrl": "string", "visibleInPicker": true }
- Mock serverhttps://docs.wellesley.social/_mock/openapi/api/v1/custom_emojis/{shortcode}
- Simple setup, all in one. Digital Oceanhttps://dust.allroads.social/api/v1/custom_emojis/{shortcode}
- Simple setup, db is separate. Digital Oceanhttps://meteor.allroads.social/api/v1/custom_emojis/{shortcode}
- curl
- JavaScript
- Node.js
- Python
- Java
- C#
- PHP
- Go
- Ruby
- R
- Payload
curl -i -X PATCH \
'https://docs.wellesley.social/_mock/openapi/api/v1/custom_emojis/{shortcode}' \
-H 'Content-Type: application/json' \
-d '{
"category": "string",
"visibleInPicker": true,
"domain": "string"
}'Response
application/json
{ "shortcode": "string", "category": "string", "url": "http://example.com", "staticUrl": "string", "visibleInPicker": true }
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