{How to} Reassign an copilot agent's owner with Power Platform API

Hello Everyone,

Today I am going to share my thoughts on how to reassign an copilot agent's owner with the Power Platform API.

Let's get started.

Here are the simple steps to reassign a Copilot Agent Owner using the Power Platform API.

This uses Microsoft Copilot Studio agents stored in Microsoft Dataverse.

Shorter version:

• Get API token

• Get botid

• Get systemuserid of new owner

• Send PATCH request to update ownerid

Step 1: Get the Environment URL

Find your Power Platform Environment URL.

Example:

https://yourenvironment.crm.dynamics.com

Step 2: Get an Access Token

Authenticate using Microsoft Entra ID.

You must obtain a Bearer token to call the Power Platform API.

Scope:

https://yourenvironment.crm.dynamics.com/default

Step 3:  Get the Copilot Agent ID

Call the API to list agents.

Get https://yourenvironment.crm.dynamics.com/api/data/v9.2/bots

Response example:

JSON

{

 "botid": "11111111-2222-3333-4444-555555555555",

 "name": "CustomerSupportCopilot"

}

Copy the botid.

Step 4: Get the New Owner User ID

Retrieve the user you want to assign.

GET https://yourenvironment.crm.dynamics.com/api/data/v9.2/systemusers

Find the systemuserid of the new owner.

Step 5: Reassign the Copilot Agent

Send a PATCH request to update the owner.

PATCH https://yourenvironment.crm.dynamics.com/api/data/v9.2/bots(BOT_ID)

Body:

JSON

{

 "ownerid@odata.bind": "/systemusers(NEW_USER_ID)"

}

Example:  

JSON

{

 "ownerid@odata.bind": "/systemusers(99999999-8888-7777-6666-555555555555)"

}

Result:

The Copilot agent is now owned by the new user.

That's it for today.

Until next blog post

Happy Copiloting 

aka @uk365guy.