Mastodon 4.4–4.6 surface: quotes, interaction policies, collections, profile API, annual reports

[milmazz]

The newest slice of the API surface (Mastodon 4.4–4.6). Lower priority than the older gaps — server adoption of 4.5/4.6 is still rolling out — but this is what full 4.6 parity means.

Part of the Mastodon 4.6 API parity effort. Depends on #119 (Quote, Collection, AnnualReport).

Quotes & interaction policies (4.5)

• GET /api/v1/statuses/:id/quotes — statuses quoting a status
• POST /api/v1/statuses/:id/quotes/:quoting_status_id/revoke — revoke a quote authorization
• PUT /api/v1/statuses/:id/interaction_policy

Collections (4.6, API v10)

• POST /api/v1/collections
• GET /api/v1/collections/:id
• PATCH /api/v1/collections/:id
• DELETE /api/v1/collections/:id
• POST /api/v1/collections/:collection_id/items
• DELETE /api/v1/collections/:collection_id/items/:id
• POST /api/v1/collections/:collection_id/items/:id/revoke
• Get an account's collections / collections featuring an account (docs currently show GET /api/v1/:account_id/collections and .../in_collections; verify actual paths against the implementation)

Profile API

• GET /api/v1/profile + PATCH /api/v1/profile (4.6, API v8)
• DELETE /api/v1/profile/avatar + DELETE /api/v1/profile/header (4.2)

Annual reports (4.3–4.6)

• GET /api/v1/annual_reports
• GET /api/v1/annual_reports/:year (4.4)
• GET /api/v1/annual_reports/:year/state (4.6)
• POST /api/v1/annual_reports/:year/generate (4.6)
• POST /api/v1/annual_reports/:year/read

Async refreshes (4.4, experimental)

• GET /api/v1_alpha/async_refreshes/:id — note the v1_alpha prefix; API may change

References

• https://docs.joinmastodon.org/methods/collections/
• https://docs.joinmastodon.org/methods/profile/
• https://docs.joinmastodon.org/methods/annual_reports/
• https://docs.joinmastodon.org/methods/async_refreshes/