When are user keys used in mentions and how to resolve them

Confluence Development Confluence Cloud
, , , ,
5

Hi,

Thanks for the information.

Unfortunately the search user endpoint doesn’t let me search for users either by account ID or user key, even though both user.accountid and user.userkey are mentioned in the documentation.

GET /wiki/rest/api/search/user?cql=user%2Eaccountid%3D123456%3A12345678-90ab-cdef-1234-567890abcdef
{
    "statusCode": 400,
    "data": {
        "authorized": true,
        "valid": true,
        "errors": [],
        "successful": true
    },
    "message": "com.atlassian.confluence.api.service.exceptions.BadRequestException: Could not parse cql : "
}

GET /wiki/rest/api/search/user?cql=user%2Euserkey%3D1234567890abcdef1234567890abcdef
{
    "statusCode": 400,
    "data": {
        "authorized": true,
        "valid": true,
        "errors": [],
        "successful": true
    },
    "message": "com.atlassian.confluence.api.service.exceptions.BadRequestException: No field exists with the name: 'user.userkey' Did you mean one of : user.fullname, user.accountid, user"
}

Maybe I’m doing something wrong?

By the way, getting a user by account ID through the /wiki/rest/api/user endpoint works fine.

Regards,
Maximilian