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
Table type: 
Standard
Display name: 
Queue Item
Primary key: 
queueitemid
Primary name column: 
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
10310 Invite Redemption
9953 Knowledge Article
4202 Email
4210 Phone Call
4201 Appointment
10311 Portal Comment
4216 Social Activity
10201 Knowledge Article Template
4251 Recurring Appointment
4207 Letter
4212 Task
4200 Activity
10185 Teams chat
4204 Fax
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