queueitem EntityType

A specific item in a queue, such as a case record or an activity record.

Entity Set Path
[organization URI]/api/data/v9.2/queueitems
Base Type
crmbaseentity
Display Name
Queue Item
Primary Key
queueitemid
Primary Key Attribute
title
Operations Supported
POST GET PATCH DELETE

Properties

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

Name Type Details
createdon Edm.DateTimeOffset

Shows the date and time when the record was created. The date and time are displayed in the time zone selected in Microsoft Dynamics 365 options.

Display Name: Created On

Read Only
enteredon Edm.DateTimeOffset

Shows the date the record was assigned to the queue.

Display Name: Entered Queue

Read Only
exchangerate Edm.Decimal

Shows the conversion rate of the record's currency. The exchange rate is used to convert all money fields in the record from the local currency to the system's default currency.

Display Name: Exchange Rate

Read Only
importsequencenumber Edm.Int32

Unique identifier of the data import or data migration that created this record.

Display Name: Import Sequence Number

modifiedon Edm.DateTimeOffset

Shows the date and time when the record was last updated. The date and time are displayed in the time zone selected in Microsoft Dynamics 365 options.

Display Name: Modified On

Read Only
objecttypecode Edm.Int32

Select the type of the queue item, such as activity, case, or appointment.

Display Name: Type

Read Only
Default Options
Values Label
4202 Email
4212 Task
4210 Phone Call
10120 Teams chat
10258 Portal Comment
10257 Invite Redemption
10136 Knowledge Article Template
4216 Social Activity
4201 Appointment
4204 Fax
9953 Knowledge Article
4251 Recurring Appointment
4200 Activity
4207 Letter
overriddencreatedon Edm.DateTimeOffset

Date and time that the record was migrated.

Display Name: Record Created On

queueitemid Edm.Guid

Unique identifier of the queue item.

Display Name: Queue Item

statecode Edm.Int32

Shows whether the queue record is active or inactive. Inactive queue records are read-only and can't be edited unless they are reactivated.

Display Name: Status

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

Select the item's status.

Display Name: Status Reason

Default Options
Values Label
2 Inactive
1 Active
timezoneruleversionnumber Edm.Int32

For internal use only.

Display Name: Time Zone Rule Version Number

title Edm.String

Shows the title or name that describes the queue record. This value is copied from the record that was assigned to the queue.

Display Name: Title

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 of the queue item.

Display Name: Version Number

Read Only
workeridmodifiedon Edm.DateTimeOffset

Shows the date and time when the queue item was last assigned to a user.

Display Name: Worked On

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 Lookup property data.

Name Single-valued navigation property Description
_createdby_value createdby

Shows who created the record.

_createdonbehalfby_value createdonbehalfby

Shows who created the record on behalf of another user.

_modifiedby_value modifiedby

Shows who last updated the record.

_modifiedonbehalfby_value modifiedonbehalfby

Unique identifier of the delegate user who last modified the queueitem.

_objectid_value objectid_activitypointer
objectid_knowledgearticle
objectid_msdyn_knowledgearticletemplate

Choose the activity, case, or article assigned to the queue.

_organizationid_value organizationid

Unique identifier of the organization with which the queue item is associated.

_queueid_value queueid

Choose the queue that the item is assigned to.

_transactioncurrencyid_value transactioncurrencyid

Choose the local currency for the record to make sure budgets are reported in the correct currency.

_workerid_value workerid_systemuser
workerid_team

Shows who is working on the queue item.

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_queueitembase_createdby
createdonbehalfby systemuser lk_queueitem_createdonbehalfby
modifiedby systemuser lk_queueitembase_modifiedby
modifiedonbehalfby systemuser lk_queueitem_modifiedonbehalfby
objectid_activitypointer activitypointer ActivityPointer_QueueItem
objectid_adx_inviteredemption adx_inviteredemption adx_inviteredemption_QueueItems
objectid_adx_portalcomment adx_portalcomment adx_portalcomment_QueueItems
objectid_appointment appointment Appointment_QueueItem
objectid_chat chat chat_QueueItems
objectid_email email Email_QueueItem
objectid_fax fax Fax_QueueItem
objectid_knowledgearticle knowledgearticle knowledgearticle_QueueItems
objectid_letter letter Letter_QueueItem
objectid_msdyn_knowledgearticletemplate msdyn_knowledgearticletemplate msdyn_knowledgearticletemplate_QueueItems
objectid_phonecall phonecall PhoneCall_QueueItem
objectid_recurringappointmentmaster recurringappointmentmaster RecurringAppointmentMaster_QueueItem
objectid_socialactivity socialactivity SocialActivity_QueueItem
objectid_task task Task_QueueItem
organizationid organization organization_queueitems
queueid queue queue_entries
transactioncurrencyid transactioncurrency TransactionCurrency_QueueItem
workerid_systemuser systemuser lk_queueitembase_workerid
workerid_team team team_queueitembase_workerid

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
QueueItem_AsyncOperations asyncoperation regardingobjectid_queueitem
QueueItem_BulkDeleteFailures bulkdeletefailure regardingobjectid_queueitem
queueitem_principalobjectattributeaccess principalobjectattributeaccess objectid_queueitem
QueueItem_ProcessSessions processsession regardingobjectid_queueitem
QueueItem_SyncErrors syncerror regardingobjectid_queueitem_syncerror

Operations

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

Name Binding
AddToQueue Not Bound
PickFromQueue Bound to Entity
ReleaseToQueue Bound to Entity
RemoveFromQueue Bound to Entity
RouteTo Not Bound

See also