Instance & discovery surface: v2 instance, trends, tags, conversations, markers, scheduled statuses, announcements

[milmazz]

A broad set of instance-level and discovery endpoints Hunter has no coverage for. Grouped here because each subarea is small (1–4 endpoints); they can land as independent PRs against this issue.

Part of the Mastodon 4.6 API parity effort. Depends on #119 for the corresponding entities.

Instance (v2 migration tracked in #118)

• GET /api/v2/instance (4.0)
• GET /api/v1/instance/peers (2.1.2)
• GET /api/v1/instance/activity (2.1.2)
• GET /api/v1/instance/rules (3.4)
• GET /api/v1/instance/domain_blocks (4.0)
• GET /api/v1/instance/extended_description (4.0)
• GET /api/v1/instance/privacy_policy (4.0)
• GET /api/v1/instance/terms_of_service and .../:date (4.4)
• GET /api/v1/instance/translation_languages (4.2)

Trends (3.0–3.5)

• GET /api/v1/trends/tags
• GET /api/v1/trends/statuses
• GET /api/v1/trends/links
• GET /api/v1/timelines/link?url=:url — timeline of posts sharing a trending link (4.3)

Directory & suggestions

• GET /api/v1/directory (3.0)
• GET /api/v2/suggestions (3.4)
• DELETE /api/v1/suggestions/:account_id (2.4.3)

Hashtags

• GET /api/v1/tags/:id (4.0)
• POST /api/v1/tags/:id/follow / unfollow (4.0)
• POST /api/v1/tags/:id/feature / unfeature (4.4)
• GET /api/v1/followed_tags (4.0)
• GET /api/v1/featured_tags + POST + DELETE /:id + GET /suggestions (3.0)

Conversations (DMs, 2.6)

• GET /api/v1/conversations
• DELETE /api/v1/conversations/:id
• POST /api/v1/conversations/:id/read

Markers (3.0)

• GET /api/v1/markers
• POST /api/v1/markers

Scheduled statuses (2.7)

• GET /api/v1/scheduled_statuses
• GET /api/v1/scheduled_statuses/:id
• PUT /api/v1/scheduled_statuses/:id
• DELETE /api/v1/scheduled_statuses/:id

Announcements (3.1)

• GET /api/v1/announcements
• POST /api/v1/announcements/:id/dismiss
• PUT /api/v1/announcements/:id/reactions/:name
• DELETE /api/v1/announcements/:id/reactions/:name

Misc

• GET /api/v1/custom_emojis (2.0)
• GET /api/v1/preferences (2.8)
• POST /api/v1/emails/confirmations (3.4)

References

• https://docs.joinmastodon.org/methods/instance/
• https://docs.joinmastodon.org/methods/trends/
• https://docs.joinmastodon.org/methods/tags/
• https://docs.joinmastodon.org/methods/conversations/