From b7246518bfc9953b2c507c2da0580d375bdfbc88 Mon Sep 17 00:00:00 2001
From: Claire <claire.github-309c@sitedethib.com>
Date: Mon, 16 Mar 2026 15:04:25 +0100
Subject: [PATCH] Add `avatar_description` and `header_description` parameters
 to `PATCH /api/v1/profile` (#38221)

---
 app/controllers/api/v1/profiles_controller.rb | 2 ++
 lib/mastodon/version.rb                       | 2 +-
 spec/requests/api/v1/profiles_spec.rb         | 2 ++
 3 files changed, 5 insertions(+), 1 deletion(-)

diff --git a/app/controllers/api/v1/profiles_controller.rb b/app/controllers/api/v1/profiles_controller.rb
index 196d0ef3a70..02907f4fb44 100644
--- a/app/controllers/api/v1/profiles_controller.rb
+++ b/app/controllers/api/v1/profiles_controller.rb
@@ -25,7 +25,9 @@ class Api::V1::ProfilesController < Api::BaseController
       :display_name,
       :note,
       :avatar,
+      :avatar_description,
       :header,
+      :header_description,
       :locked,
       :bot,
       :discoverable,
diff --git a/lib/mastodon/version.rb b/lib/mastodon/version.rb
index 76c849e8f6d..e71f4d2d725 100644
--- a/lib/mastodon/version.rb
+++ b/lib/mastodon/version.rb
@@ -45,7 +45,7 @@ module Mastodon
 
     def api_versions
       {
-        mastodon: 8,
+        mastodon: 9,
       }
     end
 
diff --git a/spec/requests/api/v1/profiles_spec.rb b/spec/requests/api/v1/profiles_spec.rb
index b2c74b01919..7d0d1a36224 100644
--- a/spec/requests/api/v1/profiles_spec.rb
+++ b/spec/requests/api/v1/profiles_spec.rb
@@ -62,6 +62,7 @@ RSpec.describe 'Profile API' do
     let(:params) do
       {
         avatar: fixture_file_upload('avatar.gif', 'image/gif'),
+        avatar_description: 'animated walking round cat',
         discoverable: true,
         display_name: "Alice Isn't Dead",
         header: fixture_file_upload('attachment.jpg', 'image/jpeg'),
@@ -110,6 +111,7 @@ RSpec.describe 'Profile API' do
           display_name: eq("Alice Isn't Dead"),
           note: 'Hello!',
           avatar: exist,
+          avatar_description: 'animated walking round cat',
           header: exist,
           attribution_domains: ['example.com'],
           fields: contain_exactly(