Meta tags:
description= Manage collections of accounts to be recommended to others.;
Headings (most frequently used words):
request, response, headers, 200, ok, collection, 401, unauthorized, parameters, 403, forbidden, account, collections, get, form, data, 422, unprocessable, entity, all, from, in, query, api, methods, create, single, given, the, current, is, featured, update, delete, add, an, to, remove, revoke, inclusion, see, also, sponsored, by,
Text of the page (most frequently used words):
#collections (56), the (49), #collection (48), api (43), this (39), accounts (33), error (24), example (24), user (23), account (22), with (21), 116131056935959117 (20), request (20), name (20), mastodon (19), access (18), http (18), version (18), header (17), items (17), token (16), and (16), authorization (15), description (15), https (15), com (15), nice (14), authorized (13), oauth (13), for (13), true (13), admin (13), 2026 (12), invalid (12), response (12), returns (12), account_id (12), string (12), 25t11 (11), 394z (11), sensitive (11), language (11), get (11), url (10), discoverable (10), 113668893442515793 (10), results (10), from (9), 200 (9), provide (9), gain (9), method (9), bearer (9), user_token (9), headers (9), added (9), history (9), will (9), your (9), see (8), not (8), delete (8), characters (8), missing (7), required (7), object (7), false (7), these (7), are (7), very (7), single (7), remove (6), 401 (6), unauthorized (6), post (6), write (6), when (6), add (6), json (6), 422 (6), created_at (6), list (6), maximum (6), tags (6), tag (6), max (6), making (6), page (5), action (5), allowed (5), trying (5), that (5), include (5), 403 (5), forbidden (5), was (5), different (5), owned (5), validation (5), parameters (5), updated_at (5), item_count (5), local (5), uri (5), search (5), more (5), all (5), profile (5), current (4), revoke (4), status (4), returned (4), errors (4), given (4), state (4), data (4), content (4), application (4), codes (4), too (4), long (4), details (4), update (4), boolean (4), whether (4), should (4), other (4), tag_name (4), one (4), plus (4), there (4), integer (4), defaults (4), new (4), instance (4), using (4), app (3), 116151066915353115 (3), empty (3), collection_id (3), case (3), includes (3), general (3), messages (3), unprocessable (3), entity (3), 112658193342215767 (3), form (3), type (3), tailored (3), read (3), requesting (3), public (3), means (3), create (3), methods (3), preferences (3), apps (3), reports (3), setting (3), server (3), source (2), controllers (2), also (2), item (2), removed (2), inclusion (2), accepted (2), register (2), err_too_long (2), failed (2), per (2), attribute (2), appear (2), discovery (2), mechanisms (2), marked (2), hashtag (2), describes (2), supported (2), two (2), letter (2), iso (2), 639 (2), exceptions (2), longer (2), 100 (2), patch (2), wrappedcollection (2), than (2), included (2), references (2), next (2), previous (2), information (2), paginating (2), through (2), responses (2), link (2), above (2), detailed (2), skip (2), first (2), offset (2), number (2), limit (2), query (2), featured (2), only (2), set (2), collectionwithaccounts (2), account_ids (2), taken (2), which (2), currently (2), special (2), handling (2), urls (2), hashtags (2), support (2), custom (2), emoji (2), others (2), notificationpolicy (2), filter (2), report (2), quote (2), domainblock (2), notifications (2), trends (2), domain_blocks (2), tokens (2), security (2), environment (2), implementing (2), posts (2), machine (2), installing (2), features (2), configuring (2), running (2), imprint, view, blog, join, sponsored, last, updated, july, improve, collection_items_controller, collections_controller, does, created, parameter, possible, unknown, collection_item, wrappedcollectionitem, deleted, existing, in_collections, result, where, unless, anonymous, requests, blocked, pending, actual, objects, owner, array, ids, feature, 117628196343117789, manage, recommended, webpushsubscription, translation, termsofservice, suggestion, statussource, statusedit, shallowtag, shallowquote, scheduledstatus, rule, role, relationshipseveranceevent, relationship, reaction, quoteapproval, privacypolicy, previewcardauthor, previewcard, poll, notificationrequest, notificationfallback, notification, mediaattachment, marker, identityproof, filterstatus, filterresult, filterkeyword, featuredtag, featureapproval, familiarfollowers, extendeddescription, customemoji, conversation, context, collectionitem, asyncrefresh, appeal, annualreport, announcement, measure, ipblock, emaildomainblock, domainallow, dimension, cohort, canonicalemailblock, accountwarning, entities, streaming, markers, lists, conversations, timelines, scheduled_statuses, polls, media, statuses, proofs, oembed, push, directory, custom_emojis, announcements, health, grouped, async_refreshes, emails, annual, retention, measures, ip_blocks, email_domain_blocks, domain_allows, dimensions, canonical_email_blocks, suggestions, mutes, followed_tags, follow_requests, filters, featured_tags, favourites, endorsements, bookmarks, blocks, rate, limits, scopes, guidelines, best, practices, datetime, formats, rest, bearcaps, microformats, webfinger, activitypub, spec, compliance, design, reference, creating, themes, css, styling, management, components, frontend, guide, issues, responsible, disclosure, routes, code, structure, dev, technical, overview, contributing, libraries, implementations, logging, obtaining, client, playing, getting, started, developing, roles, webhooks, database, index, corruption, troubleshooting, moderation, actions, scaling, migrating, backing, upgrading, release, cli, sign, captcha, onion, services, storage, optional, full, text, preparing, own, official, ios, android, moving, leaving, externally, settings, promoting, yourself, dealing, unwanted, quoting, network, posting, signing, what, documentation,
Text of the page (random words):
th unwanted content promoting yourself and others set your preferences more settings using mastodon externally moving or leaving accounts official ios and android apps running your own server running mastodon preparing your machine installing from source configuring your environment configuring full text search installing optional features object storage onion services captcha single sign on setting up your new instance using the admin cli upgrading to a new release backing up your server migrating to a new machine scaling up your server moderation actions troubleshooting errors database index corruption webhooks roles developing mastodon apps getting started with the api playing with public data obtaining client app access logging in with an account libraries and implementations implementing quote posts implementing collections contributing to mastodon technical overview setting up a dev environment code structure routes security issues and responsible disclosure frontend guide components state management css and styling creating themes design tokens reference spec compliance activitypub webfinger security microformats oauth bearcaps rest api datetime formats guidelines and best practices oauth tokens oauth scopes rate limits api methods accounts blocks bookmarks domain_blocks endorsements favourites featured_tags filters follow_requests followed_tags mutes preferences reports suggestions tags admin accounts canonical_email_blocks dimensions domain_allows domain_blocks email_domain_blocks ip_blocks measures reports retention trends annual reports apps emails oauth async_refreshes collections grouped notifications health instance announcements custom_emojis directory trends notifications push oembed profile proofs search statuses media polls scheduled_statuses timelines conversations lists markers streaming api entities account accountwarning admin account admin canonicalemailblock admin cohort admin dimension admin domainallow admin domainblock admin emaildomainblock admin ip admin ipblock admin measure admin report announcement annualreport appeal application asyncrefresh collection collectionitem collectionwithaccounts context conversation customemoji domainblock error extendeddescription familiarfollowers featureapproval featuredtag filter filterkeyword filterresult filterstatus identityproof instance list marker mediaattachment notification notificationfallback notificationpolicy notificationrequest poll preferences previewcard previewcardauthor privacypolicy profile quote quoteapproval reaction relationship relationshipseveranceevent report role rule scheduledstatus search shallowquote shallowtag status statusedit statussource suggestion tag termsofservice token translation v1 filter v1 instance v1 notificationpolicy webpushsubscription collections api methods manage collections of accounts to be recommended to others create a collection get a single collection get all collections from a given account get all collections the current account is featured in update a collection delete a collection add an account to a collection remove account from a collection revoke inclusion in a collection see also create a collection post api v1 collections http 1 1 create a new collection returns wrappedcollection oauth user token write collections version history 4 6 0 mastodon api version 10 added request example request post api v1 collections http 1 1 content type application json name nice accounts description these accounts are very nice language en tag_name accounts sensitive false discoverable true account_ids 112658193342215767 117628196343117789 headers authorization required provide this header with bearer user_token to gain authorized access to this api method form data parameters name required string a name for this collection max 40 characters string is taken as is which means there is currently no special handling of urls and hashtags and no support for custom emoji description string a longer description of this collection max 100 characters string is taken as is which means there is currently no special handling of urls a nd hashtags and no support for custom emoji language string one of mastodon s supported language codes two letter iso 639 1 plus exceptions tag_name string a single hashtag that describes the collection sensitive boolean whether this collection should be marked as sensitive discoverable boolean whether this collection should appear on the user s profile in search results and other discovery mechanisms account_ids array of string ids of the accounts to feature in this collection response 200 ok collection id 116131056935959117 account_id 113668893442515793 uri https example com ap 113668893442515793 collections 116131056935959117 url https example com collections 116131056935959117 name nice accounts description these accounts are very nice language en local true sensitive false discoverable true tag name accounts url https example com tags accounts item_count 2 items created_at 2026 02 25t11 35 01 394z updated_at 2026 02 25t11 35 01 394z 401 unauthorized invalid or missing authorization header error the access token is invalid 422 unprocessable entity http status 422 is returned in case of validation errors the response includes a json object with a general error messages and per attribute details example error error validation failed name is too long maximum is 40 characters details name error err_too_long description is too long maximum is 40 characters see register an account for a list of error codes get a single collection get api v1 collections id http 1 1 returns collectionwithaccounts oauth public or user token read collections for authorized access version history 4 6 0 mastodon api version 10 added request headers authorization provide this header with bearer user_token to gain authorized access to this api method response 200 ok this returns an object with the actual collection plus a list of account objects that include all accounts in the collection plus the owner when making an authorized request the items in the collection will be tailored to user making the request this means it will not include items blocked by that user and when requesting a collection owned by this user it will include items in the pending state when requesting other user s collections or when making anonymous requests only items in the accepted state will be returned accounts collection id 116131056935959117 account_id 113668893442515793 uri https example com ap 113668893442515793 collections 116131056935959117 url https example com collections 116131056935959117 name nice accounts description these accounts are very nice language en local true sensitive false discoverable true tag name accounts url https example com tags accounts item_count 2 items created_at 2026 02 25t11 35 01 394z updated_at 2026 02 25t11 35 01 394z get all collections from a given account get api v1 account_id collections http 1 1 returns collections oauth public or user token read collections for authorized access version history 4 6 0 mastodon api version 10 added request headers authorization provide this header with bearer user_token to gain authorized access to this api method query parameters limit integer maximum number of results defaults to 40 collections max 80 collections offset integer skip the first n results defaults to 0 response 200 ok this returns an object with a list of collections the result will only include collections where discoverable is set to true unless account_id is the id of the requesting account when making an authorized request the items in the collections will be tailored to the user making the request see get a single collection above for a detailed description if there is more than one page of results a link header will be included with references to the next and or previous page of results see paginating through api responses for more information collections id 116131056935959117 account_id 113668893442515793 uri https example com ap 113668893442515793 collections 116131056935959117 url https example com collections 116131056935959117 name nice accounts description these accounts are very nice language en local true sensitive false discoverable true tag name accounts url https example com tags accounts item_count 2 items created_at 2026 02 25t11 35 01 394z updated_at 2026 02 25t11 35 01 394z get all collections the current account is featured in get api v1 account_id in_collections http 1 1 returns collections oauth user token read collections version history 4 6 0 mastodon api version 10 added request headers authorization provide this header with bearer user_token to gain authorized access to this api method query parameters limit integer maximum number of results defaults to 40 collections max 80 collections offset integer skip the first n results defaults to 0 response 200 ok this returns an object with a list of collections the items in the collections will be tailored to the user making the request see get a single collection above for a detailed description if there is more than one page of results a link header will be included with references to the next and or previous page of results see paginating through api responses for more information collections id 116131056935959117 account_id 113668893442515793 uri https example com ap 113668893442515793 collections 116131056935959117 url https example com collections 116131056935959117 name nice accounts description these accounts are very nice language en local true sensitive false discoverable true tag name accounts url https example com tags accounts item_count 2 items created_at 2026 02 25t11 35 01 394z updated_at 2026 02 25t11 35 01 394z update a collection patch api v1 collections id http 1 1 update an existing collection returns wrappedcollection oauth user token write collections version history 4 6 0 mastodon api version 10 added request example request patch api v1 collections 116131056935959117 http 1 1 content type application json name nice accounts description these accounts are very nice language en tag_name accounts sensitive false discoverable true headers authorization required provide this header with bearer user_token to gain authorized access to this api method form data parameters name string a name for this collection max 40 characters description string a longer description of this collection max 100 characters language string one of mastodon s supported language codes two letter iso 639 1 plus exceptions tag_name string a single hashtag that describes the collection sensitive boolean whether this collection should be marked as sensitive discoverable boolean whether this collection should appear in search results and other discovery mechanisms response 200 ok collection id 116131056935959117 account_id 113668893442515793 uri https example com ap 113668893442515793 collections 116131056935959117 url https example com collections 116131056935959117 name nice accounts description these accounts are very nice language en local true sensitive false discoverable true tag name accounts url https example com tags accounts item_count 2 items created_at 2026 02 25t11 35 01 394z updated_at 2026 02 25t11 35 01 394z 401 unauthorized invalid or missing authorization header error the access token is invalid 403 forbidden trying to update a collection owned by a different user error this action is not allowed 422 unprocessable entity http status 422 is returned in case of validation errors the response includes a json object with a general error messages and per attribute details example error error validation failed name is too long maximum is 40 characters details name error err_too_long description is too long maximum is 40 characters see register an account for a list of error codes delete a collection delete api v1 collections id http 1 1 delete a collection returns empty oauth user token write collections version history 4 6 0 mastodon api version 10 added request example request delete api v1 collections 116131056935959117 http 1 1 headers authorization required provide this header with bearer user_token to gain authorized access to this api method response 200 ok the collection was deleted 401 unauthorized invalid or missing authorization header error the access token is invalid 403 forbidden trying to delete a collection owned by a different user error this action is not allowed add an account to a collection post api v1 collections collection_id items http 1 1 add an account to a collection returns wrappedcollectionitem oauth user token write collections version history 4 6 0 mastodon api version 10 added request example request post api v1 collections 116131056935959117 items http 1 1 content type application json account_id 112658193342215767 headers authorization required provide this header with bearer user_token to gain authorized access to this api method form data parameters account_id string id of the account to add to this collection response 200 ok collection_item id 116151066915353115 account_id 112658193342215767 state accepted created_at 2026 02 25t11 35 01 394z 401 unauthorized invalid or missing authorization header error the access token is invalid 403 forbidden trying to add to a collection owned by a different user error this action is not allowed 422 unprocessable entity http status 422 is returned in case of validation errors i e when it was not possible to add the given account or the given id was unknown the response includes a json object with a general error messages example error account_id parameter is missing remove account from a collection delete api v1 collections collection_id items id http 1 1 remove an account from a collection returns empty oauth user token write collections version history 4 6 0 mastodon api version 10 added request example request delete api v1 collections 116131056935959117 items 116151066915353115 http 1 1 headers authorization required provide this header with bearer user_token to gain authorized access to this api method response 200 ok the account was removed 401 unauthorized invalid or missing authorization header error the access token is invalid 403 forbidden trying to remove an item from a collection owned by a different user error this action is not allowed revoke inclusion in a collection post api v1 collections collection_id items id revoke http 1 1 remove the current user from a collection created by a different user returns empty oauth user token write collections version history 4 6 0 mastodon api version 10 added request example request post api v1 collections 116131056935959117 items 116151066915353115 revoke http 1 1 headers authorization required provide this header with bearer user_token to gain authorized access to this api method response 200 ok the account was removed 401 unauthorized invalid or missing authorization header error the access token is invalid 403 forbidden trying to remove an item from a collection that does not include the curren...
|
