1
0
mirror of https://github.com/mastodon/documentation synced 2025-04-11 22:56:17 +02:00

64 Commits

Author SHA1 Message Date
Eva Tatarka
d1899d20fb
Add missing array syntax to follow lanagues query param () 2024-08-21 23:30:12 +01:00
Marcin Mikołajczak
f5a1f6bef4
filters API methods: Fix typo () 2024-08-21 23:29:38 +01:00
Claire
1f59ac9fde
Add documentation for /api/v1/notifications/unread_count ()
* Add documentation for `/api/v1/notifications`

* Fix issues following review feedback

* Document unread_count's return type
2024-08-02 15:36:31 +02:00
Marcin Mikołajczak
9b660bb152
featured_tags API methods: Fix typo () 2024-07-31 18:22:41 +01:00
Claire
0e88921543
Fix missing HTTP line for accept-request notification method () 2024-07-25 15:52:50 +02:00
Nik Clayton
61481fb191
Provide more detail about the use of resolve in search queries ()
Provide more detail about the use of `resolve` in search queries
2024-07-23 12:07:05 +01:00
Claire
de8d6ac149
Add documentation for /api/v1/timelines/link ()
* Add documentation for `/api/v1/timelines/link`
* Update content/en/methods/timelines.md
2024-07-15 21:37:01 +01:00
Mahan
0552a6f71c
Add description to polls methods () 2024-07-12 15:35:05 +01:00
David Roetzel
c0353e222b
Remove flag that no longer exists. ()
See https://github.com/mastodon/mastodon/pull/31008
2024-07-12 13:52:53 +02:00
Renaud Chaput
522d9c2ad8
Fix dismiss notification request title () 2024-06-19 11:30:37 +02:00
Claire
878e5836b7
Add documentation for notification policies ()
* Add documentation for GET /api/v1/notifications/policy

* Add documentation for `PATCH /api/v1/notifications/policy`

* Add documentation for `GET /api/v1/notifications/requests`

* Add documentation for `GET /api/v1/notifications/requests/:id`

* Add documentation for accepting and rejecting requests

* Remove redundant HTTP request examples

* Add documentation for the `NotificationPolicy` entity

* Add documentation for the `NotificationRequest` entity
2024-06-13 18:01:35 +02:00
Mahan
61d28de915
Add description to timelines/public () 2024-06-11 11:25:59 +01:00
Mahan
2557e19c63
Add description and type to /emails/confirmations () 2024-06-11 11:24:06 +01:00
Mahan
b903b07128
Add description to /followed_tags () 2024-06-11 11:18:16 +01:00
Mahan
662543d692
Add description to v1/markers () 2024-06-11 11:15:55 +01:00
Emelia Smith
5f0bd3cb77
Update admin/domain_blocks to include conflict response ()
* Update admin/domain_blocks to include conflict response

When creating a domain block, if there is already a domain block rule for the domain, then the existing block is returned. This documents that behavior.

I've also documented the `digest` property which was added in https://github.com/mastodon/mastodon/pull/29092

* Document digest in Admin DomainBlock Entity
2024-05-07 18:54:14 +01:00
Claire
59c5876836
Add documentation for GET /api/v1/accounts and GET /api/v1/statuses ()
* Add documentation for `GET /api/v1/accounts`

See https://github.com/mastodon/mastodon/pull/27871

* Add documentation for `GET /api/v1/statuses`
2024-05-07 11:43:48 +02:00
Matt Jankowski
1005443460
Add max_pinned_statuses property to instances.accounts () 2024-04-02 22:28:17 +02:00
Andy Piper
a610154747
Removed unused (not implemented) query parameter. ()
Signed-off-by: Andy Piper <andypiper@users.noreply.github.com>
2024-03-29 11:18:40 +01:00
Dale Price
fa868c3a9b
Add documentation for legal report category ()
This category was was added in 
2024-03-27 08:49:49 +00:00
sgtatham
07b3bd95fc
Fix token type in account creation. () 2024-01-13 22:27:13 +00:00
a
92f25458d5
Remove "required" label from no-longer-required methods () 2024-01-07 22:21:15 +00:00
Wesley Moore
c185e7dec0
Clarify that apps verify_credentials requires app token + read () 2023-12-10 18:47:29 +00:00
Christian Schmidt
0ca2155229
New translations attributes () 2023-12-10 18:44:53 +00:00
Manish Roy
b87c68c120
Fix notification query param LIMIT doc ()
* Fix notification query param LIMIT doc

The notification query param LIMIT should return 40 notifications as default & Maximum notifications depends on the LIMIT param as evident from the code in api/v1/notifications_controller

* LIMIT param default & max notifications updated

* limit param doc updated
2023-12-08 21:25:44 +00:00
Christian Schmidt
5bed9cfe82
Document /api/v1/instance/translation_languages () 2023-12-08 21:23:03 +00:00
Claire
70f4386efd
Update documentation for /api/v1/accounts/update_credentials ()
This was missing `source[language]` as well as `hide_collections` and the upcoming `indexable`.
2023-12-08 15:30:02 +00:00
Emelia Smith
e3d00bd75e
Remove the admin/ prefix on Admin APIs for consistency () 2023-12-07 18:58:05 +00:00
cucmberium
c2d93f344f
Added missing parameter information in Filter () 2023-12-07 13:36:38 +00:00
JakePaustian
f2b3dfb70a
An important parameter is missing from the API doc on editing a post ()
* Update content/en/methods/statuses.md
2023-12-06 11:57:15 +00:00
Mahan
66612d0084
Add missing type of id. () 2023-12-05 22:47:25 +01:00
Mahan
3c7c5caed1
update return empty return types to Empty () 2023-12-05 18:20:37 +00:00
Emelia Smith
9b534bb024
Add documentation for VAPID public key in instance metadata ()
* Add documentation for VAPID public key in instance metadata

* Mark Application#vapid_key as deprecated
2023-11-28 19:25:04 +01:00
Levi Bard
cbe1295e15
Add exclusive parameter to list update documentation () 2023-11-13 18:21:51 +01:00
Ludovic HOCHET
02a694869a
Update the end point url on emails.md ()
/api/v1/emails/confirmation should be /api/v1/emails/confirmations (with an ending s) otherwise a 404 is returned
2023-11-10 13:29:32 +01:00
Claire
10ee12b62a
Add documentation for with_suspended params ()
Add documentation for https://github.com/mastodon/mastodon/pull/27667
2023-11-09 15:50:30 +01:00
Claire
b6c62a040d
Document exclusive lists () 2023-09-28 11:49:54 +02:00
Lennart Hengstmengel
e4e88f0fb7
Fixed some consistency issues in the documentation ()
* fixed invalid json examples

* correct type: integer for a count, not number

* correct type: array of string, not string

* add square brackets around entity return type

* added missing path parameter definition

* spacing fix

* PR comment: add link
2023-09-20 10:32:44 +02:00
Daniel M Brasil
1d15e379a4
Document DELETE /api/v1/profile/avatar and /api/v1/profile/header ()
* document DELETE /api/v1/accounts/picture/:picture

* update documentation

* add mastodon version

* move page to new profile.md file
2023-09-09 23:13:35 +01:00
Claire
7974696ed0
Mention followed hashtags in /api/v1/timelines/home ()
* Mention followed hashtags in /api/v1/timelines/home

* Update timelines.md
2023-08-31 18:18:04 +02:00
trwnh
5377ff0edf
Clarify since_id vs min_id ()
* Clarify since_id vs min_id

* forgot to update the template
2023-08-21 15:40:12 +01:00
Cassidy James Blaede
fa0d546592
Update Status method docs to include unauthenticated limits ()
* Update Status method docs to include unauthenticated limits

Not sure if this follows the correct style or is precisely where these limits should be noted, but the intent is to save others time by documenting these hardcoded limits:

99be47f8b9/app/controllers/api/v1/statuses_controller.rb (L21-L24)

Related: https://github.com/mastodon/mastodon/issues/25892

* statuses: mention limits in version history
2023-07-11 15:19:33 +02:00
josephrocca
f1de8ba240
More explicit wording for pinned param default ()
* More explicit wording for `pinned` param default

* Clarify pinned status ordering in returned results
2023-07-11 10:11:40 +02:00
nightpool
d9f99fa667
Clarify WebPush documentation and it's relationship to proprietry services ()
based on conversation in https://github.com/mastodon/mastodon/issues/25729
2023-07-10 18:31:13 +02:00
Shadowfacts
3630f2de3b
Fix instance entity links ()
The v2 endpoint incorrectly said it returned a v1 instance (though it linked to the correct entity) and the v1 endpoint incorrectly linked to the v2 entity (the text correctly said v1)
2023-04-26 14:20:05 +02:00
Tuur Martens
f7f21c8726
whole_word is a boolean, not a string () 2023-04-11 10:02:30 +02:00
Chee Aun
4ee33a54b5
Fix typo s/statuses/accounts () 2023-04-07 09:01:21 +02:00
Vyr Cossont
5e82c71542
Remove references to nonexistent Mastodon 3.6 in filter docs () 2023-03-08 17:39:05 +01:00
trwnh
b458498d25
Miscellaneous fixes ()
* Fix typos in method examples

* Fix broken link to sanitize_config ()

* Add SIDEKIQ_CONCURRENCY

* Fix relref to FilterResult ()

* Fix status_ids and rule_ids description ()

* fix typo ()

* clarify confusing example ()

* fix formatting on linked headings ()

* fix placeholder entity names ()

* better wording

* fix scheduledstatus#params.visibility

* fix missing: tootctl accounts modify --remove-role

* add: status/translate

* add deprecation/removal warning to microformats page

* clarify further how link verification works

* clarify mastodon requirements for webfinger

* fix: push param policy -> data[policy]
2023-02-07 02:14:07 +01:00
trwnh
ffbe66a389
Update content for 4.0, part 2 ()
* fix relrefs around trends and related entities

* revert moving caption-links to middle of page

* hide empty menu in table of contents

* clarify edit notifs are only for boosted statuses

* following/followers no longer need auth

* fix typo

* specify cooldown period for account Move

* use the correct cooldown

* add missing parameters to accounts/id/statuses

* link to account_statuses_filter.rb

* fix typo ()

* fix typo ()

* fix link to http sig spec ()

* simply HTTP request examples in api methods docs

* add missing client_secret to oauth/token ()

* Add any, all, none to hashtag timeline

* minor formatting changes

* Update signature requirements and advice

* fix public key -> private key

* clarify use of RSA with SHA256

* Add note about saving your profile after adding rel-me link

* v2 filters api

* comment out params that shouldn't be used in v2 filter api

* admin trends

* remove old todo

* canonical email blocks + scheduled statuses

* remove under-construction warnings from finished pages

* verify api method params with source code

* fix typo ()

* fix broken caption-links ()

* fix formatting of entities ()

* Remove keybase section from user guide ()

* fix typos ()

* Verify limits are accurate ()

* add mention of iframe limitation ()

* Add CORS header to WEB_DOMAIN example ()

* Fix typo ()

* pin http sigs spec at draft 8

* Revert "pin http sigs spec at draft 8"

This reverts commit 9fd5f7032b69b29e77599dd62adfe8d2f5cd4f20.

* add case sensitivity warning to 4.0 roles

* Add url length note to bio ()

* remove follow scope from examples ()

* clarify usage of update_credentials to update profile fields

* add noindex to Account entitity

* remove required hint from technically not required property
2022-12-14 22:55:30 +01:00