What is the correct way to mention a user in a comment?

[vihan-agarwal]

I checked the documentation but it doesn't mention how to handle this case. The UI in JIRA Cloud autocompletes so I can't determine if its using the email or name of account or something else. Here is what I have, but I have seen from multiple threads that you need to use ~ instead of @?

user = first.last@org.com
comment = f"@{user} some text \n some text \n more text"

jira.add_comment('TKT-123', comment)

edit: tried all the following and they all show up as @User in the ticket.

• comment = f"[~first.last] some text \n some text \n more text"
• comment = f"[~first.last@org.com] some text \n some text \n more text"
• comment = f"[~first last] some text \n some text \n more text"

Adding how to do this in the docs would be huge!

[vihan-agarwal]

I was able to achieve this using comment = f"[~accountId:{user.accountId}] some text \n ...". Would be nice to have in the documentation somewhere.