skills/list-teams/SKILL.md
# List All Teams Lists all teams in the organization that the authenticated user has access to. Returns a paginated collection of team resources with basic properties. ## API Details - **API**: Microsoft Teams API - **Method**: GET - **Path**: `/teams` - **Operation ID**: `listTeams` - **Tag**: Teams - **OpenAPI**: [microsoft-teams-openapi.yaml](../../openapi/microsoft-teams-openapi.yaml) ## Sandbox Mock server URL: `http://localhost:8080/rest/microsoft-teams-api/1.0.0/teams` ## Required H
npx skillsauth add naftiko/microsoft-teams-sandbox skills/list-teamsInstall this skill globally with one command. Works with Claude Code, Cursor, and Windsurf.
3 of 9 scanners reported clean
Some scanners were skipped, did not run, or reported a non-clean status. Review each row below.
Lists all teams in the organization that the authenticated user has access to. Returns a paginated collection of team resources with basic properties.
/teamslistTeamsMock server URL: http://localhost:8080/rest/microsoft-teams-api/1.0.0/teams
Authorization: Bearer {access-token}Team.ReadBasic.All| Name | In | Type | Required | Description |
|---|---|---|---|---|
| $top | query | integer | No | Number of teams to return per page |
| $skip | query | integer | No | Number of teams to skip |
| $filter | query | string | No | OData filter expression |
| $select | query | string | No | Comma-separated list of properties to include |
curl -s -X GET \
"http://localhost:8080/rest/microsoft-teams-api/1.0.0/teams?%24top=10" \
-H "Authorization: Bearer {access-token}"
{
"@odata.count": 2,
"value": [
{
"id": "e1b3c5a7-9d2f-4b6e-8c1a-3f5d7e9b2a4c",
"displayName": "Engineering Team",
"description": "Main engineering team",
"isArchived": false,
"visibility": "private"
},
{
"id": "f2c4d6b8-0e3a-5c7f-9d2b-4a6e8c1f3d5a",
"displayName": "Marketing Team",
"description": "Marketing and communications",
"isArchived": false,
"visibility": "public"
}
]
}
When the user wants to list, browse, or search for teams in their organization, use this operation. Supports pagination with $top and $skip, filtering with $filter, and selecting specific properties with $select.
development
# Update Workforce Integration Update the properties of an existing workforce integration using the Microsoft Teams API. ## API Details - **API Name**: Microsoft Teams API - **OpenAPI Ref**: `../../openapi/microsoft-teams-openapi.yaml` - **Endpoint**: PATCH /teamwork/workforceIntegrations/{workforceIntegration-id} - **Operation ID**: updateWorkforceIntegration - **Tag**: WorkforceIntegrations ## Sandbox - **Base URL**: `http://localhost:8080/rest/microsoft-teams-api/1.0.0` - **Full URL**: `
development
# Update Team Tag Update the properties of an existing tag in a Microsoft Teams team. ## API Details - **API Name**: Microsoft Teams API - **OpenAPI Ref**: `../../openapi/microsoft-teams-openapi.yaml` - **Endpoint**: PATCH /teams/{team-id}/tags/{tag-id} - **Operation ID**: updateTeamworkTag - **Tag**: Tags ## Sandbox - **Base URL**: `http://localhost:8080/rest/microsoft-teams-api/1.0.0` ## Required Headers - `Authorization: Bearer {access_token}` - `Content-Type: application/json` ## OAu
development
# Update Team Updates the properties of a specific team. Only the properties included in the request body are updated. ## API Details - **API**: Microsoft Teams API - **Method**: PATCH - **Path**: `/teams/{team-id}` - **Operation ID**: `updateTeam` - **Tag**: Teams - **OpenAPI**: [microsoft-teams-openapi.yaml](../../openapi/microsoft-teams-openapi.yaml) ## Sandbox Mock server URL: `http://localhost:8080/rest/microsoft-teams-api/1.0.0/teams/{team-id}` ## Required Headers - `Authorization:
development
# Update Tab Update the properties of a specific tab in a channel within a team using the Microsoft Teams API. ## API Details - **API Name**: Microsoft Teams API - **OpenAPI Ref**: `../../openapi/microsoft-teams-openapi.yaml` - **Endpoint**: `PATCH /teams/{team-id}/channels/{channel-id}/tabs/{tab-id}` - **operationId**: `updateTab` - **Tag**: Tabs ## Sandbox - **Base URL**: `http://localhost:8080/rest/microsoft-teams-api/1.0.0` ## Required Headers - `Authorization: Bearer {access_token}`