Overview

This node operation removes the assignment of a Teams Voice phone number from a specified user within a tenant. It is useful in scenarios where phone numbers need to be unassigned or reallocated, such as when an employee leaves the organization or changes roles. For example, an admin can use this operation to unassign a phone number from a user to free it up for reassignment.

Use Case Examples

1. Unassign a phone number from a user in a specific tenant to manage phone number allocations.
2. Remove a Teams Voice phone number assignment when an employee leaves the company.

Properties

Output

JSON

• success - Indicates whether the phone number unassignment was successful.
• message - Additional information or status message about the unassignment operation.

Dependencies

• Requires an API key credential for authentication to the CIPP API service.

Troubleshooting

• Ensure the tenant ID or domain name is correct to avoid tenant resolution errors.
• Verify the phone number and user details are accurate to prevent assignment conflicts.
• Check network settings if using a proxy or if SSL certificate validation issues occur.
• Timeout errors may occur if the server is slow to respond; adjust the timeout setting accordingly.

Links

• Microsoft Teams Phone Number Assignment - Official Microsoft documentation on managing phone number assignments in Teams.
• Microsoft Graph API for Teams Voice - API reference for managing Teams Voice phone numbers and assignments.