{"command":{"effect":"write","timeoutSeconds":30,"inputSchema":{"type":"object","description":"Invites users to a team with the requested role. This endpoint is available only to private OAuth apps associated with an Enterprise plan, and the team must belong to that plan. The authenticated user must be allowed to grant the requested role on the team.\n\nEach email address is processed independently. Per-address failures are returned in `errors` with HTTP 200, even if `invites` is empty. Always check `errors` to determine which addresses could not be invited.\n\nExisting team members keep their current role when it is higher than the requested role.","properties":{"path":{"type":"object","properties":{"team_id":{"type":"string","description":"The ID of the team to invite users to."}},"required":["team_id"],"additionalProperties":false},"body":{"$ref":"#/definitions/InviteTeamMembersRequest"}},"required":["path","body"],"additionalProperties":false,"definitions":{"InviteTeamMembersRequest":{"type":"object","description":"Members to invite to a team and the role to assign them.","properties":{"emails":{"type":"array","minItems":1,"maxItems":99,"items":{"type":"string","format":"email"},"description":"The email addresses to invite."},"role":{"type":"string","enum":["viewer","editor","admin"],"description":"The role to grant each invited member. Existing roles are never downgraded."}},"required":["emails","role"],"additionalProperties":false}}},"name":"Invite users to a team","id":"figma.postteaminvites","example":{"path":{"team_id":"example"},"body":{"emails":["developer@example.com"],"role":"viewer"}},"maxRequests":1,"summary":false}}