bot EntityType

Represents a Power Virtual Agents Chatbot.

Entity Set Path
[organization URI]/api/data/v9.0/bots
Base Type
Display Name
Primary Key
Primary Key Attribute
Operations Supported


Properties represent fields of data stored in the entity.Some properties are read-only.

Name Type Details
accesscontrolpolicy Edm.Int32

Defines which users may interact with the bot.

Display Name: Access Control Policy

Default Options
Value Label
0 Any
1 Chatbot readers
2 Group membership
applicationmanifestinformation Edm.String

Stores information with application manifest data such as Teams application information.

Display Name: Application Manifest Information

authenticationmode Edm.Int32

Defines how the bot should be authenticated to the user.

Display Name: Authentication Mode

Default Options
Value Label
0 Unspecified
1 None
2 Integrated
3 Custom Azure Active Directory
4 Generic OAuth2
authenticationtrigger Edm.Int32

Defines at which point authentication for the bot should be triggered. Security can be enforced at the bot entry point, removing the need for explicit authentication nodes in the dialog flow.

Display Name: Authentication trigger

Default Options
Value Label
0 As Needed
1 Always
authorizedsecuritygroupids Edm.String

Contains a comma-delimited list of up to 20 Azure Active Directory Group IDs that are allowed to interact with the bot. This field is ignored if Access Control Policy is not set to Group membership.

Display Name: Authorized Security Groups

botid Edm.Guid

Unique identifier of the Chatbot.

Display Name: Bot

componentidunique Edm.Guid

For internal use only.

Display Name: Row id unique

Read Only
componentstate Edm.Int32

For internal use only.

Display Name: Component State

Read Only
Default Options
Value Label
0 Published
1 Unpublished
2 Deleted
3 Deleted Unpublished
configuration Edm.String

Used to store content of bot configuration data.

Display Name: Configuration

createdon Edm.DateTimeOffset

Date and time when the record was created.

Display Name: Created On

Read Only
iconbase64 Edm.String

Used to visually identify your bot in channels and services. Represented in a base64 encoded string. Must be in PNG format, and no larger than 30K in size. This value can be changed at any time.

Display Name: Icon (Base64)

importsequencenumber Edm.Int32

Sequence number of the import that created this record.

Display Name: Import Sequence Number

iscustomizable BooleanManagedProperty

For internal use only.

Display Name: Is Customizable

ismanaged Edm.Boolean

Indicates whether the solution component is part of a managed solution.

Display Name: Is Managed

Read Only
Default Options
Value Label
1 Managed
0 Unmanaged
language Edm.Int32

The language identifier (LCID) of this Chatbot.

Display Name: Language

Default Options
Value Label
1033 English
1034 Spanish
1046 Portuguese (Brazilian)
1036 French
1043 Dutch
1044 Norwegian
1030 Danish
1053 Swedish
1040 Italian
1031 German
2052 Chinese (Simplified)
1028 Chinese (Traditional)
1025 Arabic
1041 Japanese
1042 Korean
1081 Hindi
1057 Indonesian
1049 Russian
1045 Polish
1055 Turkish
1054 Thai
1035 Finnish
1032 Greek
1029 Czech
modifiedon Edm.DateTimeOffset

Date and time when the record was modified.

Display Name: Modified On

Read Only
name Edm.String

The display name of the Chatbot.

Display Name: Name

overriddencreatedon Edm.DateTimeOffset

Date and time that the record was migrated.

Display Name: Record Created On

overwritetime Edm.DateTimeOffset

For internal use only.

Display Name: Record Overwrite Time

Read Only
publishedon Edm.DateTimeOffset

Date and time when the Chatbot was last published

Display Name: Published On

schemaname Edm.String

Unique name identifying the Chatbot.

Display Name: SchemaName

solutionid Edm.Guid

Unique identifier of the associated solution.

Display Name: Solution

Read Only
statecode Edm.Int32

Status of the Chatbot

Display Name: Status

Default Options
Value Label
0 Active
1 Inactive
statuscode Edm.Int32

Reason for the status of the Chatbot

Display Name: Status Reason

Default Options
Value Label
1 Provisioned
2 Deprovisioned
3 Provisioning
4 ProvisionFailed
5 MissingLicense
synchronizationstatus Edm.String

Used to store information about the synchronization operations of the bot

Display Name: SynchronizationStatus

template Edm.String

Used to identify the template and version used for the bot default content

Display Name: Template

timezoneruleversionnumber Edm.Int32

For internal use only.

Display Name: Time Zone Rule Version Number

utcconversiontimezonecode Edm.Int32

Time zone code that was in use when the record was created.

Display Name: UTC Conversion Time Zone Code

versionnumber Edm.Int64

Version Number

Display Name: Version Number

Read Only

Lookup Properties

Lookup properties are read-only, computed properties which contain entity primary key Edm.Guid data for one or more corresponding single-valued navigation properties. More information: Lookup properties and Retrieve data about lookup properties.

Name Single-valued navigation property Description
_createdby_value createdby

Unique identifier of the user who created the record.

_createdonbehalfby_value createdonbehalfby

Unique identifier of the delegate user who created the record.

_modifiedby_value modifiedby

Unique identifier of the user who modified the record.

_modifiedonbehalfby_value modifiedonbehalfby

Unique identifier of the delegate user who modified the record.

_ownerid_value ownerid

Owner Id

_owningbusinessunit_value owningbusinessunit

Unique identifier for the business unit that owns the record

_owningteam_value owningteam

Unique identifier for the team that owns the record.

_owninguser_value owninguser

Unique identifier for the user that owns the record.

_publishedby_value publishedby

Unique identifier of the user who last published the bot.

Single-valued navigation properties

Single-valued navigation properties represent lookup fields where a single entity can be referenced. Each single-valued navigation property has a corresponding partner collection-valued navigation property on the related entity.

Name Type Partner
createdby systemuser lk_bot_createdby
createdonbehalfby systemuser lk_bot_createdonbehalfby
modifiedby systemuser lk_bot_modifiedby
modifiedonbehalfby systemuser lk_bot_modifiedonbehalfby
ownerid principal owner_bot
owningbusinessunit businessunit business_unit_bot
owningteam team team_bot
owninguser systemuser user_bot
publishedby systemuser systemuser_bot_publishedby

Collection-valued navigation properties

Collection-valued navigation properties represent collections of entities which may represent either a one-to-many (1:N) or many-to-many (N:N) relationship between the entities.

Name Type Partner
bot_AsyncOperations asyncoperation regardingobjectid_bot
bot_botcomponent botcomponent bot_botcomponent
bot_BulkDeleteFailures bulkdeletefailure regardingobjectid_bot
bot_conversationtranscript conversationtranscript bot_conversationtranscriptId
bot_environmentvariabledefinition environmentvariabledefinition bot_environmentvariabledefinition
bot_MailboxTrackingFolders mailboxtrackingfolder regardingobjectid_bot
bot_PrincipalObjectAttributeAccesses principalobjectattributeaccess objectid_bot
bot_ProcessSession processsession regardingobjectid_bot
bot_SyncErrors syncerror regardingobjectid_bot


The following operations can be used with the bot entity type.

Name Binding
GrantAccess Not Bound
IsValidStateTransition Not Bound
ModifyAccess Not Bound
PvaAuthorize Entity
PvaCreateBotComponents Entity
PvaCreateContentSnapshot Entity
PvaDeleteBot Entity
PvaGetDirectLineEndpoint Entity
PvaPublish Entity
RetrievePrincipalAccess Not Bound
RetrieveSharedPrincipalsAndAccess Not Bound
RevokeAccess Not Bound


The following solutions include the bot entity type.

Name Description
Power Virtual Agents For internal use, by the Power Virtual Agents services only.

See also