Поделиться через

Powell Teams (Preview)

  • Reference

Powell Teams API endpoints allows you to manage the governance of your teams (creation / update of your teams).

This connector is available in the following products and regions:

Service Class Regions
Logic Apps Standard All Logic Apps regions except the following:
     -   Azure Government regions
     -   Azure China regions
     -   US Department of Defense (DoD)
Power Automate Premium All Power Automate regions except the following:
     -   US Government (GCC)
     -   US Government (GCC High)
     -   China Cloud operated by 21Vianet
     -   US Department of Defense (DoD)
Power Apps Premium All Power Apps regions except the following:
     -   US Government (GCC)
     -   US Government (GCC High)
     -   China Cloud operated by 21Vianet
     -   US Department of Defense (DoD)
Contact
Name Powell Teams Support
URL https://support.powell-software.com/
Email [email protected]
Connector Metadata
Publisher Powell Software
Website https://powell-software.com/
Privacy policy https://powell-software.com/en/powell-teams-privacy/
Categories Productivity;Collaboration

Imagine that Microsoft Teams are automatically created for projects and processes in your departments, saving time and improving collaboration. This is now possible with the powell teams API connector.

This connector contains all Powell Teams APIs and can be coupled with MS products such as flow, power app or logic app

For example, the connector can automatically trigger a team creation upon receipt of an email or through an action triggered in a third-party solution such as a CRM. This automated process means that the right team will be created to make collaboration easier.

The connector allows an infinity of solution for your business use cases

Example: RFP scenario, you will see how Linda, a sales manager, will be able to collaborate instantly with her team in a dedicated model automatically triggered following the creation of her opportunity in the CRM or the receipt of a simple e-mail.

Prerequisites

Have Powell Teams version (license with API).

How to get credentials

We use Microsoft Entra ID Graph authentication.

Getting started with your connector

https://support.powell-software.com/hc/en-us/articles/360020025800

FAQ

  • Is it possible to create teams with the connector? Yes! It’s the main application of this API connector. Create teams based on your templates

  • Is it possible to create templates with the connector? No. The template creation should be done directly on Powell Teams application

Creating a connection

The connector supports the following authentication types:
Default Parameters for creating connection. All regions Not shareable

Default

Applicable: All regions

Parameters for creating connection.

This is not shareable connection. If the power app is shared with another user, another user will be prompted to create new connection explicitly.

Throttling Limits

Name Calls Renewal Period
API calls per connection 100 60 seconds

Actions

Approve or deny a pending approval

Approve or deny a pending approval
Batch methods

Batch methods
Create a team based on a Powell Teams template information

Create a team based on a Powell Teams template information
Get a naming convention by id

Get a naming convention by id
Get Job task status

Get Job task status
Get tags information from tag ids

Get tags information from tag ids
Get teams with external users report

Get teams with external users report
Get teams with missing users' report

Get teams with missing users' report
Get teams without minimum owners report

Get teams without minimum owners report
Get teams without valid naming rule report

Get teams without valid naming rule report
Get template picture

Get template picture
List all approvals

List all approvals
List all Naming conventions

List all Naming conventions
List all of user's templates

List all of user's templates
List all pending approvals of the current user

List all pending approvals of the current user
List all tags

List all tags
List all tags of a team

List all tags of a team
List all user's teams

List all user's teams
Update a team based on a Powell Teams template information

Update a team based on a Powell Teams template information

Approve or deny a pending approval

Operation ID:
postBetaApprovalsApprove

Approve or deny a pending approval

Parameters

Name Key Required Type Description
ApprovalId
 ApprovalId uuid
Status
 Status integer
Comment
 Comment string
Created
 Created date-time

Returns

Body
Powell.Teams.Common.Core.OperationResult_Powell.Teams.API.Models.Approval.ApiApprovalResult_

Batch methods

Operation ID:
postBetabatch

Batch methods

Parameters

Name Key Required Type Description
Id
 Id string
url
 url string
method
 method string
body
 body object
headers
 headers array of string

Returns

Body
Powell.Teams.Common.Core.OperationResult_System.Collections.Generic.IEnumerable_Powell.Teams.API.Models.Batch.APIBatchResponseModel__

Create a team based on a Powell Teams template information

Operation ID:
postBetaTeams

Create a team based on a Powell Teams template information

Parameters

Name Key Required Type Description
Description
 Description string
Name
 Name string
TeamTemplateId
 TeamTemplateId uuid
Visibility
 Visibility string
AdditionalMembers
 AdditionalMembers array of string
AdditionalGroupOwners
 AdditionalGroupOwners array of string
AdditionalGroupMembers
 AdditionalGroupMembers array of string
AdditionalOwners
 AdditionalOwners array of string
Value
 Value string
TagId
 TagId uuid

Returns

Body
Powell.Teams.Common.Core.OperationResult_System.Guid_

Get a naming convention by id

Operation ID:
getBetaNamingconventionsByNamingId

Get a naming convention by id

Parameters

Name Key Required Type Description
Naming convention id
 namingId True uuid

Naming convention id

Returns

Body
Powell.Teams.Common.Core.OperationResult_Powell.Teams.API.Models.NamingConvention.ApiNamingConventionModel_

Get Job task status

Operation ID:
getBetaJobtasksGetstatusByTaskId

Get Job task status

Parameters

Name Key Required Type Description
Task Id to check
 taskId True uuid

Task Id to check

Returns

Body
Powell.Teams.Common.Core.OperationResult_System.String_

Get tags information from tag ids

Operation ID:
postBetaTagsList

Get tags information from tag ids

Parameters

Name Key Required Type Description
body
 body True array of uuid

Returns

Body
Powell.Teams.Common.Core.OperationResult_System.Collections.Generic.IEnumerable_Powell.Teams.API.Models.Tag.ApiTagSimpleModel__

Get teams with external users report

Operation ID:
getBetaReportsTeamsWithExternalUsers

Get teams with external users report

Returns

response
array of Powell.Teams.API.Models.Report.ApiTeamReport

Get teams with missing users' report

Operation ID:
getBetaReportsTeamsWithMissingUsers

Get teams with missing users' report

Returns

response
array of Powell.Teams.API.Models.Report.ApiTeamReport

Get teams without minimum owners report

Operation ID:
getBetaReportsTeamsWithoutMinimumOwnersByNumberOfMinimumOwners

Get teams without minimum owners report

Parameters

Name Key Required Type Description
Minimum number of owners
 numberOfMinimumOwners True string

Minimum number of owners

Returns

Body
Powell.Teams.Common.Core.OperationResult_System.Collections.Generic.List_Powell.Teams.API.Models.Report.ApiTeamReport__

Get teams without valid naming rule report

Operation ID:
getBetaReportsTeamsWithoutValidNamingRule

Get template picture

Operation ID:
getBetaTemplatesByTemplateIdPicture

Get template picture

Parameters

Name Key Required Type Description
Template Id
 templateId True uuid

Template Id

Returns

response
string

List all approvals

Operation ID:
getBetaApprovals

List all Naming conventions

Operation ID:
getBetaNamingconventions

List all of user's templates

Operation ID:
getBetaTemplates

List all pending approvals of the current user

Operation ID:
getBetaApprovalsPending

List all tags

Operation ID:
getBetaTags

List all tags of a team

Operation ID:
getBetaTeamsByTeamIdTags

List all tags of a team

Parameters

Name Key Required Type Description
Team Id
 teamId True uuid

Team Id

Returns

Body
Powell.Teams.Common.Core.OperationResult_System.Collections.Generic.List_Powell.Teams.API.Models.Tag.ApiTagSettingModel__

List all user's teams

Operation ID:
getBetaTeams

List all user's teams

Parameters

Name Key Required Type Description
Next page indicator
 page uuid

Next page indicator

Returns

Body
Powell.Teams.Common.Core.OperationResult_Powell.Teams.API.Models.PublicAPIResponses.PaginatedAPIResponseModel_Powell.Teams.API.Models.Team.ApiTeamModel__

Update a team based on a Powell Teams template information

Operation ID:
putBetaTeamsByTeamId

Update a team based on a Powell Teams template information

Parameters

Name Key Required Type Description
Team Id
 teamId True uuid

Team Id of the team to update.
Description
 Description string
Name
 Name string
TeamTemplateId
 TeamTemplateId uuid
Visibility
 Visibility string
AdditionalMembers
 AdditionalMembers array of string
AdditionalGroupOwners
 AdditionalGroupOwners array of string
AdditionalGroupMembers
 AdditionalGroupMembers array of string
AdditionalOwners
 AdditionalOwners array of string
Value
 Value string
TagId
 TagId uuid

Returns

Body
Powell.Teams.Common.Core.OperationResult_System.Guid_

Definitions

Powell.Teams.Common.Core.OperationResult_System.Collections.Generic.List_Powell.Teams.API.Models.Approval.ApiApprovalModel__

Name Path Type Description
CorrelationId
 CorrelationId uuid
ErrorCode
 ErrorCode integer
ErrorMessage
 ErrorMessage string
IsSucceed
 IsSucceed boolean
Result
 Result array of Powell.Teams.API.Models.Approval.ApiApprovalModel

Powell.Teams.API.Models.Approval.ApiApprovalModel

Name Path Type Description
Id
 Id uuid
Histories
 Histories array of Powell.Teams.API.Models.Approval.ApiApprovalHistoryModel
Team
 Team Powell.Teams.API.Models.Team.ApiTeamExtendModel
TenantId
 TenantId uuid
Created
 Created date-time
Approvers
 Approvers array of string

Powell.Teams.API.Models.Approval.ApiApprovalHistoryModel

Name Path Type Description
Id
 Id uuid
Status
 Status integer
Comment
 Comment string
Creator
 Creator Powell.Teams.API.Models.User.ApiUserModel
Created
 Created date-time

Powell.Teams.API.Models.User.ApiUserModel

Name Path Type Description
Id
 Id uuid
Name
 Name string
AzureADId
 AzureADId uuid
Email
 Email string
Role
 Role integer
Language
 Language string
TenantId
 TenantId uuid

Powell.Teams.API.Models.Team.ApiTeamExtendModel

Name Path Type Description
Id
 Id uuid
OfficeGroupId
 OfficeGroupId uuid
TenantId
 TenantId uuid
DisplayName
 DisplayName string
Description
 Description string
OriginalTitle
 OriginalTitle string
OriginalIncrementOfNamingRule
 OriginalIncrementOfNamingRule integer
TeamTemplateId
 TeamTemplateId uuid
Photo
 Photo string
TagSettings
 TagSettings array of Powell.Teams.API.Models.Tag.ApiTagSettingModel
Visibility
 Visibility string
AdditionalMembers
 AdditionalMembers array of string
AdditionalGroupOwners
 AdditionalGroupOwners array of string
AdditionalGroupMembers
 AdditionalGroupMembers array of string
AdditionalOwners
 AdditionalOwners array of string
IsArchived
 IsArchived boolean
Classification
 Classification string
CurrentUserIsOwner
 CurrentUserIsOwner boolean
Created
 Created date-time
ExpirationStart
 ExpirationStart date-time
ExpirationDate
 ExpirationDate date-time
IsFavorite
 IsFavorite boolean
WebUrl
 WebUrl string

Powell.Teams.API.Models.Tag.ApiTagSettingModel

Name Path Type Description
Id
 Id uuid
DefaultValue
 DefaultValue string
ChoiceValue
 ChoiceValue string
Type
 Type string
TagId
 TagId uuid
IsMandatory
 IsMandatory boolean
IsShownToUsers
 IsShownToUsers boolean
ChoiceText
 ChoiceText string
Name
 Name string
Value
 Value string
IsMultiValueChoice
 IsMultiValueChoice boolean

Powell.Teams.Common.Core.OperationResult_Powell.Teams.API.Models.Approval.ApiApprovalResult_

Name Path Type Description
CorrelationId
 CorrelationId uuid
ErrorCode
 ErrorCode integer
ErrorMessage
 ErrorMessage string
IsSucceed
 IsSucceed boolean
Result
 Result Powell.Teams.API.Models.Approval.ApiApprovalResult

Powell.Teams.API.Models.Approval.ApiApprovalResult

Name Path Type Description
JobTaskId
 JobTaskId uuid
ApprovalId
 ApprovalId uuid
Status
 Status string

Powell.Teams.Common.Core.OperationResult_System.Collections.Generic.IEnumerable_Powell.Teams.API.Models.Batch.APIBatchResponseModel__

Name Path Type Description
CorrelationId
 CorrelationId uuid
ErrorCode
 ErrorCode integer
ErrorMessage
 ErrorMessage string
IsSucceed
 IsSucceed boolean
Result
 Result array of Powell.Teams.API.Models.Batch.APIBatchResponseModel

Powell.Teams.API.Models.Batch.APIBatchResponseModel

Name Path Type Description
Id
 Id string
status
 status integer
body
 body Powell.Teams.API.Models.Batch.APIBatchResponseBodyModel
headers
 headers array of string

Powell.Teams.API.Models.Batch.APIBatchResponseBodyModel

Name Path Type Description
value
 value object
error
 error Powell.Teams.API.Models.Batch.APIBatchResponseErrorModel

Powell.Teams.API.Models.Batch.APIBatchResponseErrorModel

Name Path Type Description
code
 code string
message
 message string

Powell.Teams.Common.Core.OperationResult_System.String_

Name Path Type Description
CorrelationId
 CorrelationId uuid
ErrorCode
 ErrorCode integer
ErrorMessage
 ErrorMessage string
IsSucceed
 IsSucceed boolean
Result
 Result string

Powell.Teams.Common.Core.OperationResult_Powell.Teams.API.Models.NamingConvention.ApiNamingConventionModel_

Name Path Type Description
CorrelationId
 CorrelationId uuid
ErrorCode
 ErrorCode integer
ErrorMessage
 ErrorMessage string
IsSucceed
 IsSucceed boolean
Result
 Result Powell.Teams.API.Models.NamingConvention.ApiNamingConventionModel

Powell.Teams.API.Models.NamingConvention.ApiNamingConventionModel

Name Path Type Description
Id
 Id uuid
Configuration
 Configuration array of Powell.Teams.API.Models.NamingConvention.ApiNamingConventionConfigurationModel
IsMetaNamingRule
 IsMetaNamingRule boolean
Name
 Name string
NumberIncrement
 NumberIncrement integer

Powell.Teams.API.Models.NamingConvention.ApiNamingConventionConfigurationModel

Name Path Type Description
Type
 Type string
Value
 Value string

Powell.Teams.Common.Core.OperationResult_System.Collections.Generic.List_Powell.Teams.API.Models.NamingConvention.ApiNamingConventionModel__

Name Path Type Description
CorrelationId
 CorrelationId uuid
ErrorCode
 ErrorCode integer
ErrorMessage
 ErrorMessage string
IsSucceed
 IsSucceed boolean
Result
 Result array of Powell.Teams.API.Models.NamingConvention.ApiNamingConventionModel

Powell.Teams.Common.Core.OperationResult_System.Collections.Generic.List_Powell.Teams.API.Models.Report.ApiTeamReport__

Name Path Type Description
CorrelationId
 CorrelationId uuid
ErrorCode
 ErrorCode integer
ErrorMessage
 ErrorMessage string
IsSucceed
 IsSucceed boolean
Result
 Result array of Powell.Teams.API.Models.Report.ApiTeamReport

Powell.Teams.API.Models.Report.ApiTeamReport

Name Path Type Description
GroupId
 GroupId uuid
CreationDate
 CreationDate date-time
LastUpdateDate
 LastUpdateDate date-time
Title
 Title string
Description
 Description string
Photo
 Photo string
IsArchived
 IsArchived boolean
IsInactive
 IsInactive boolean
Link
 Link string
PowellTemplateId
 PowellTemplateId uuid
PowellTemplateName
 PowellTemplateName string
OwnersIds
 OwnersIds array of string
NbOwners
 NbOwners integer
MembersIds
 MembersIds array of string
NbMembers
 NbMembers integer
ExternalUsersIds
 ExternalUsersIds array of string
NbExternals
 NbExternals integer
LastChatActivity
 LastChatActivity date-time
NbChatMessages
 NbChatMessages integer
NbChatReplies
 NbChatReplies integer
ChatMessageDeltaParameters
 ChatMessageDeltaParameters array of Powell.Teams.Model.Unmapped.ChatMessageDeltaParameters
LastDocActivity
 LastDocActivity date-time
NbDocuments
 NbDocuments integer
DriveItemDeltaParameters
 DriveItemDeltaParameters Powell.Teams.Model.Unmapped.DriveItemDeltaParameters
MinimumNumberOfOwners
 MinimumNumberOfOwners integer
MinimumNumberOfMembers
 MinimumNumberOfMembers integer
Visibility
 Visibility string
ExpirationDate
 ExpirationDate date-time
ExpirationStart
 ExpirationStart date-time

Powell.Teams.Model.Unmapped.ChatMessageDeltaParameters

Name Path Type Description
TeamId
 TeamId string
ChannelId
 ChannelId string
DeltaLink
 DeltaLink string

Powell.Teams.Model.Unmapped.DriveItemDeltaParameters

Name Path Type Description
GroupId
 GroupId string
DeltaLink
 DeltaLink string

Powell.Teams.Common.Core.OperationResult_System.Collections.Generic.IEnumerable_Powell.Teams.API.Models.Tag.ApiTagSimpleModel__

Name Path Type Description
CorrelationId
 CorrelationId uuid
ErrorCode
 ErrorCode integer
ErrorMessage
 ErrorMessage string
IsSucceed
 IsSucceed boolean
Result
 Result array of Powell.Teams.API.Models.Tag.ApiTagSimpleModel

Powell.Teams.API.Models.Tag.ApiTagSimpleModel

Name Path Type Description
Id
 Id uuid
Name
 Name string
Type
 Type string
IsMultiValueChoice
 IsMultiValueChoice boolean
Choices
 Choices array of Powell.Teams.API.Models.Tag.ApiTagChoiceModel

Powell.Teams.API.Models.Tag.ApiTagChoiceModel

Name Path Type Description
Id
 Id uuid
Value
 Value string

Powell.Teams.Common.Core.OperationResult_System.Collections.Generic.List_Powell.Teams.API.Models.Tag.ApiTagModel__

Name Path Type Description
CorrelationId
 CorrelationId uuid
ErrorCode
 ErrorCode integer
ErrorMessage
 ErrorMessage string
IsSucceed
 IsSucceed boolean
Result
 Result array of Powell.Teams.API.Models.Tag.ApiTagModel

Powell.Teams.API.Models.Tag.ApiTagModel

Name Path Type Description
ChoicesJson
 ChoicesJson string
Id
 Id uuid
IsRefiner
 IsRefiner boolean
Name
 Name string
Type
 Type string

Powell.Teams.Common.Core.OperationResult_System.Guid_

Name Path Type Description
CorrelationId
 CorrelationId uuid
ErrorCode
 ErrorCode integer
ErrorMessage
 ErrorMessage string
IsSucceed
 IsSucceed boolean
Result
 Result uuid

Powell.Teams.Common.Core.OperationResult_Powell.Teams.API.Models.PublicAPIResponses.PaginatedAPIResponseModel_Powell.Teams.API.Models.Team.ApiTeamModel__

Name Path Type Description
CorrelationId
 CorrelationId uuid
ErrorCode
 ErrorCode integer
ErrorMessage
 ErrorMessage string
IsSucceed
 IsSucceed boolean
Result
 Result Powell.Teams.API.Models.PublicAPIResponses.PaginatedAPIResponseModel_Powell.Teams.API.Models.Team.ApiTeamModel_

Powell.Teams.API.Models.PublicAPIResponses.PaginatedAPIResponseModel_Powell.Teams.API.Models.Team.ApiTeamModel_

Name Path Type Description
Items
 Items array of Powell.Teams.API.Models.Team.ApiTeamModel
NextPage
 NextPage string

Powell.Teams.API.Models.Team.ApiTeamModel

Name Path Type Description
Id
 Id uuid
OfficeGroupId
 OfficeGroupId uuid
TenantId
 TenantId uuid
DisplayName
 DisplayName string
Description
 Description string
OriginalTitle
 OriginalTitle string
OriginalIncrementOfNamingRule
 OriginalIncrementOfNamingRule integer
TeamTemplateId
 TeamTemplateId uuid
TagSettings
 TagSettings array of Powell.Teams.API.Models.Tag.ApiTagSettingModel
Visibility
 Visibility string
AdditionalMembers
 AdditionalMembers array of string
AdditionalGroupOwners
 AdditionalGroupOwners array of string
AdditionalGroupMembers
 AdditionalGroupMembers array of string
AdditionalOwners
 AdditionalOwners array of string
IsArchived
 IsArchived boolean
Classification
 Classification string
CurrentUserIsOwner
 CurrentUserIsOwner boolean
Created
 Created date-time
ExpirationStart
 ExpirationStart date-time
ExpirationDate
 ExpirationDate date-time
IsFavorite
 IsFavorite boolean
WebUrl
 WebUrl string

Powell.Teams.Common.Core.OperationResult_System.Collections.Generic.List_Powell.Teams.API.Models.Tag.ApiTagSettingModel__

Name Path Type Description
CorrelationId
 CorrelationId uuid
ErrorCode
 ErrorCode integer
ErrorMessage
 ErrorMessage string
IsSucceed
 IsSucceed boolean
Result
 Result array of Powell.Teams.API.Models.Tag.ApiTagSettingModel

Powell.Teams.Common.Core.OperationResult_System.Collections.Generic.List_Powell.Teams.API.Models.TeamTemplate.ApiTeamTemplateSimpleModel__

Name Path Type Description
CorrelationId
 CorrelationId uuid
ErrorCode
 ErrorCode integer
ErrorMessage
 ErrorMessage string
IsSucceed
 IsSucceed boolean
Result
 Result array of Powell.Teams.API.Models.TeamTemplate.ApiTeamTemplateSimpleModel

Powell.Teams.API.Models.TeamTemplate.ApiTeamTemplateSimpleModel

Name Path Type Description
Id
 Id uuid
AdditionalMembers
 AdditionalMembers array of string
AdditionalOwners
 AdditionalOwners array of string
Approvers
 Approvers array of string
Categories
 Categories array of uuid
Description
 Description string
DisplayName
 DisplayName string
IsPublished
 IsPublished boolean
LastSchemaSynchronisation
 LastSchemaSynchronisation string
MinimumMembers
 MinimumMembers integer
MinimumOwners
 MinimumOwners integer
NamingConventionId
 NamingConventionId uuid
TagSettings
 TagSettings array of Powell.Teams.API.Models.Tag.ApiTagSettingModel
TeamIdToClone
 TeamIdToClone uuid
TeamsCount
 TeamsCount integer
Visibility
 Visibility string

string

This is the basic data type 'string'.