Add or Update Descriptions for Existing Attachments

[Jackenmen]

Description

When I try to add/update alt text in call to PATCH /channels/{channel.id}/messages/{message.id}, nothing changes.

Steps to Reproduce

• Request 1:
  POST /channels/{channel.id}/messages

--boundary
Content-Disposition: form-data; name="files[0]"; filename="file.png"
Content-Type: image/png

[image bytes]
--boundary

• Request 2 on message created in previous request (123... in the payload is the actual ID of the attachment from the previous request):
  PATCH /channels/{channel.id}/messages/{message.id}

{
    "attachments": [
        {
            "id": "123...",
            "description": "new alt text"
        }
    ]
}

Expected Behavior

I expected the attachment to have a description added.

Current Behavior

The attachment does not have a description after making the request.

Screenshots/Videos

None

Client and System Information

I'm making raw API requests through Postman in order to later implement this feature into a library.

[IanMitchell]

We don't support this yet, but I think this is something that would be really nice to have - it isn't going to be trivial to add though 😢 . Do you mind if I convert this into a GitHub Discussion to track as a request for adding the feature?

[Jackenmen]

I filed this issue because I thought that the documentation states that this is possible and I observed different behavior while testing it. But looking at the documentation today, it seems like I must have read it wrong because both the documentation of Edit Message endpoint and the Uploading Files section in Reference document say that being able to add description only applies to new attachments so I probably just missed that detail while reading it before.

Since there's no actual issue with the documentation, I certainly don't mind you converting it into a GitHub discussion, thanks!

[IanMitchell]

Converted, I also edited the title accordingly