skills.rest
naftiko
naftikoOFFICIAL
Explore all skills by this author →
WebsiteGitHub

Update Workforce Integration

Update workforce integration properties in Microsoft Teams via the Teams API.

Updated Feb 19, 2026
Search Tags:#configuration#api update#microsoft teams#workforce integration#patch request
One-click install
npx skills add https://github.com/naftiko/microsoft-teams-sandbox --skill update-workforce-integration
Or copy as Structured Prompt for Agent▼
Please help me install this Agent Skill.
Skill: Update Workforce Integration
Source: https://github.com/naftiko/microsoft-teams-sandbox/tree/main/skills/update-workforce-integration
Command: npx skills add https://github.com/naftiko/microsoft-teams-sandbox --skill update-workforce-integration

SYSTEM DOCUMENTATION & REQUIREMENTS

What problem does it solve?

This Skill allows for the modification of existing workforce integration configurations within Microsoft Teams, enabling dynamic adjustments to integration properties.

Core Features & Use Cases

  • Update Display Name: Change the user-facing name of the integration.
  • Modify API Version: Adjust the API version the integration uses.
  • Toggle Active Status: Enable or disable the workforce integration.
  • Update Endpoint URL: Change the URL for the integration's backend service.
  • Adjust Supported Entities: Modify the list of entities the integration supports.
  • Use Case: An administrator needs to update the display name and activate a workforce integration after a service migration.

Quick Start

Update the workforce integration with ID 'wfi-001' to have the display name 'New Integration Name' and set its active status to true.

Frequently Asked Questions about Update Workforce Integration

High-intent search queries and answers about installing and using this skill.

FAQPage Schema
How do I update an existing workforce integration in Microsoft Teams?▼

To update a Microsoft Teams workforce integration, you send a PATCH request to the Teams API. This modifies properties like display name, API version, active status, endpoint URL, and supported entities for the integration.

What permissions are required to modify workforce integration settings in Teams?▼

Modifying workforce integration settings requires a valid access token with the WorkforceIntegration.ReadWrite.All scope. You must also provide the specific workforceIntegration-id as a path parameter in your request.

Can I change the endpoint URL and supported entities for a Teams workforce integration?▼

Yes, you can change the endpoint URL and adjust the list of supported entities for a Teams workforce integration. These properties are updated by sending a PATCH request to the Teams API.

How do I activate or deactivate a workforce integration via the API?▼

You activate or deactivate a workforce integration by sending a PATCH request to the Teams API. This request updates the active status property to either enable or disable the integration.

What is the best way to change the display name of a workforce integration after a service migration?▼

The best way to change a workforce integration display name after migration is a Teams API PATCH request. This updates the user-facing name and other properties like API version to reflect the new service configuration.

Why does my workforce integration PATCH request fail in Microsoft Teams?▼

A workforce integration PATCH request fails if the access token lacks the WorkforceIntegration.ReadWrite.All scope. It also fails if the correct workforceIntegration-id is not provided as a path parameter.

Related Skills

Explore More Software Engineering Skills→
naftikonaftiko

Delete Workforce Integration

Delete a Microsoft Teams workforce integration by its unique identifier.

Official
Basic
naftikonaftiko

Create Workforce Integration

Create Microsoft Teams workforce integrations with API endpoints and entity definitions.

Official
Intermediate
naftikonaftiko

List Workforce Integrations

Retrieve workforce integrations from the Microsoft Teams API.

Official
Basic
bennoloefflerbennoloeffler
2

bel-move-mail-to-archive

Move a single Microsoft 365 email message to the Archive folder.

Community
Intermediate