Request for Documentation on Error Object in /teams/v3/conversations API

Question

Hello,

I'm looking for documentation describing the error object returned by /teams/v3/conversations. When making the following request to retrieve a conversation ID, it returns an error if the target user hasn’t installed the app. I understand this is expected behavior, and I’m currently considering how to handle it. Here is the request:

curl -X POST "https://smba.trafficmanager.net/teams/v3/conversations" \
     -H "Authorization: Bearer ACCESS_TOKEN" \
     -H "Content-Type: application/json" \
     -d '{
         "bot": {
           "id": "BOT ID",
           "name": "BOT NAME"
         },
         "members": [
           {
             "id": "USER ID"
           }
         ],
         "channelData": {
           "tenant": {
             "id": "TENANT ID"
           }
         }
     }'

Upon testing, I received the following error as expected:

{
    "error": {
        "code": "BadArgument",
        "message": "Bot is not installed in user's personal scope"
    }
}

I plan to implement error handling based on this object, but I'd prefer to refer to official documentation if it exists. I checked this document but couldn’t find details about this specific error object.

Does documentation for this error object exist? If so, could you please share the link?

Thank you.

Answer 1

@石川 敦己 - Thank you for bringing this issue to our attention.
Currently, there isn't a specific document available for on Error Object in /teams/v3/conversations API.

Thanks, 

Nivedipa 

-------------------------------------------------------------------------------------------------------

If the response is helpful, please click "Accept Answer" and upvote it. You can share your feedback via Microsoft Teams Developer Feedback link. Click here to escalate.