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

石川 敦己 255 Reputation points
2025-02-04T09:20:09.5233333+00:00

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.

Microsoft Teams | Development
Microsoft Teams | Development

Building, integrating, or customizing apps and workflows within Microsoft Teams using developer tools and APIs

0 comments No comments

2 answers

Sort by: Oldest
  1. Deleted

    This answer has been deleted due to a violation of our Code of Conduct. The answer was manually reported or identified through automated detection before action was taken. Please refer to our Code of Conduct for more information.

    2 deleted comments

    Comments have been turned off. Learn more

  2. Lotfi Ounis 20 Reputation points
    2025-06-19T09:37:04.12+00:00

    Hello

    We are also interested by a detailed documentation.

    Thanks

    Lotfi

    Was this answer helpful?

    0 comments No comments

Your answer

Answers can be marked as 'Accepted' by the question author and 'Recommended' by moderators, which helps users know the answer solved the author's problem.