Update a Lightbox presentation session
patch
/crmRestApi/resources/11.13.18.05/presentationSessions/{PresentationSessionId}
Request
Path Parameters
-
PresentationSessionId(required): string
The unique identifier of the Lightbox presentation session.
Header Parameters
-
Metadata-Context:
If the REST API supports runtime customizations, the shape of the service may change during runtime. The REST client may isolate itself from these changes or choose to interact with the latest version of the API by specifying this header. For example: Metadata-Context:sandbox="TrackEmployeeFeature".
-
REST-Framework-Version:
The protocol version between a REST client and service. If the client does not specify this header in the request the server will pick a default version for the API.
Supported Media Types
- application/json
Root Schema : schema
Type:
Show Source
object
-
AccountId: integer
(int64)
Title:
Account ID
The unique identifier of the account for which the presentation session was conducted. The default value is obtained from Activity unless specified during create. -
AccountName: string
Title:
Account
Maximum Length:360
The name of the account for which the presentation session was conducted. -
sessionAttendanceEvents: array
Presentation Session Attendance Events
Title:
Presentation Session Attendance Events
The presentation session attendance events resource is used to view and create the event attendance. Presentation session events attendance is used to keep track of the audience who attended a session when a Lightbox document was displayed. -
sessionDisplayEvents: array
Presentation Session Display Events
Title:
Presentation Session Display Events
The presentation session display events resource is used to view and create the display events. Display events log the start and stop times during which a Lightbox document page was displayed during a presentation session.
Nested Schema : Presentation Session Attendance Events
Type:
array
Title:
Presentation Session Attendance Events
The presentation session attendance events resource is used to view and create the event attendance. Presentation session events attendance is used to keep track of the audience who attended a session when a Lightbox document was displayed.
Show Source
Nested Schema : Presentation Session Display Events
Type:
array
Title:
Presentation Session Display Events
The presentation session display events resource is used to view and create the display events. Display events log the start and stop times during which a Lightbox document page was displayed during a presentation session.
Show Source
Nested Schema : presentationSessions-sessionAttendanceEvents-item-patch-request
Type:
Show Source
object
Nested Schema : presentationSessions-sessionDisplayEvents-item-patch-request
Type:
Show Source
object
Response
Supported Media Types
- application/json
Default Response
The following table describes the default response for this task.
Headers
-
Metadata-Context:
If the REST API supports runtime customizations, the shape of the service may change during runtime. The REST client may isolate itself from these changes or choose to interact with the latest version of the API by specifying this header. For example: Metadata-Context:sandbox="TrackEmployeeFeature".
-
REST-Framework-Version:
The protocol version between a REST client and service. If the client does not specify this header in the request the server will pick a default version for the API.
Root Schema : presentationSessions-item-response
Type:
Show Source
object
-
AccountId: integer
(int64)
Title:
Account ID
The unique identifier of the account for which the presentation session was conducted. The default value is obtained from Activity unless specified during create. -
AccountName: string
Title:
Account
Maximum Length:360
The name of the account for which the presentation session was conducted. -
AccountPartyNumber: string
Title:
Registry ID
Read Only:true
Maximum Length:30
The registry identifier for the account for which the presentation session was conducted. -
ActivityAccountId: integer
(int64)
Title:
Activity Account ID
Read Only:true
The unique identifier of the activity account. This attribute is not available for ad-hoc presentation sessions. -
ActivityAccountName: string
Title:
Activity Account
Read Only:true
Maximum Length:900
The name of the activity account for the presentation session. This attribute is not available for ad-hoc presentation sessions. -
ActivityAccountPartyNumber: string
Title:
Activity Registry ID
Read Only:true
Maximum Length:30
The registry identifier for the activity account for the presentation session. This attribute is not available for ad-hoc presentation sessions. -
ActivityId: integer
(int64)
Title:
Activity ID
The unique identifier of the activity for the presentation session. -
ActivityNumber: string
Title:
Activity Number
Read Only:true
Maximum Length:64
The activity number for the presentation session. -
ActivitySubject: string
Title:
Subject
Read Only:true
Maximum Length:500
The subject of the activity for the presentation session. -
CreatedBy: string
Title:
Created By
Read Only:true
Maximum Length:64
The user who created the record. -
CreationDate: string
(date-time)
Title:
Creation Date
Read Only:true
The date when the record was created. -
DeleteFlag: boolean
Read Only:
true
Indicates whether the record can be deleted. The default value is true. -
LastUpdateDate: string
(date-time)
Title:
Last Updated Date
Read Only:true
The date when the record was last updated. -
LastUpdatedBy: string
Title:
Last Updated By
Read Only:true
Maximum Length:64
The user who last updated the record. -
LastUpdateLogin: string
Title:
Last Update Login
Read Only:true
Maximum Length:32
The login of the user who last updated the record. -
links: array
Links
Title:
Links
The link relations associated with the resource instance. -
PresentationSessionId: integer
(int64)
Title:
Session ID
The unique identifier of the Lightbox presentation session. -
sessionAttendanceEvents: array
Presentation Session Attendance Events
Title:
Presentation Session Attendance Events
The presentation session attendance events resource is used to view and create the event attendance. Presentation session events attendance is used to keep track of the audience who attended a session when a Lightbox document was displayed. -
SessionDate: string
(date-time)
Title:
Session Date
The date and time when the Lightbox presentation session was conducted. The default value is obtained from Activity unless specified during create. -
sessionDisplayEvents: array
Presentation Session Display Events
Title:
Presentation Session Display Events
The presentation session display events resource is used to view and create the display events. Display events log the start and stop times during which a Lightbox document page was displayed during a presentation session. -
SessionOwnerEmailAddress: string
Title:
Owner Primary Email
Read Only:true
Maximum Length:320
The e-mail address of the owner of the presentation session. -
SessionOwnerId: integer
(int64)
Title:
Session Owner ID
The unique identifier of the owner of the presentation session. This person is the primary presenter of Lightbox documents. The default value is obtained from the user's PartyId unless specified during create. -
SessionOwnerName: string
Title:
Owner Name
Read Only:true
Maximum Length:360
The name of the owner of the presentation session. -
SessionOwnerTitle: string
Title:
Owner Title
Read Only:true
Maximum Length:60
The title of the owner of the presentation session. -
TotalSessionDisplayDuration: number
Title:
Total Session Display Duration
Read Only:true
Default Value:1
The summed duration of all presentation session display events of all Lightbox document pages presented during the presentation session. The value is in seconds. -
UpdateFlag: boolean
Read Only:
true
Indicates whether the record can be updated. The default value is true.
Nested Schema : Links
Type:
array
Title:
Links
The link relations associated with the resource instance.
Show Source
Nested Schema : Presentation Session Attendance Events
Type:
array
Title:
Presentation Session Attendance Events
The presentation session attendance events resource is used to view and create the event attendance. Presentation session events attendance is used to keep track of the audience who attended a session when a Lightbox document was displayed.
Show Source
Nested Schema : Presentation Session Display Events
Type:
array
Title:
Presentation Session Display Events
The presentation session display events resource is used to view and create the display events. Display events log the start and stop times during which a Lightbox document page was displayed during a presentation session.
Show Source
Nested Schema : link
Type:
Show Source
object
-
href: string
Title:
hyperlink reference
The URI to the related resource. -
kind: string
Title:
kind
Allowed Values:[ "collection", "item", "describe", "other" ]
The kind of the related resource. -
name: string
Title:
name
The name of the link to the related resource. -
properties: object
properties
-
rel: string
Title:
relation
Allowed Values:[ "self", "lov", "parent", "canonical", "child", "enclosure", "action", "custom" ]
The name of the relation to the resource instance. Example: self.
Nested Schema : properties
Type:
Show Source
object
-
changeIndicator: string
Change indicator or the ETag value of the resource instance.
Nested Schema : presentationSessions-sessionAttendanceEvents-item-response
Type:
Show Source
object
-
AttendanceEventId: integer
(int64)
Title:
Attendance Event ID
The unique identifier of the attendance event. -
AttendanceEventStartTime: string
(date-time)
Title:
Attendance Event Start Time
The start time for the attendance event. -
AttendanceEventStopTime: string
(date-time)
Title:
Attendance Event Stop Time
The stop time for the attendance event. -
AttendeeId: integer
(int64)
Title:
Attendee ID
The unique identifier of the attendee. -
ContactId: integer
Title:
Contact ID
The unique identifier of the contact. -
ContactName: string
Title:
Contact
Read Only:true
Maximum Length:450
The name of the contact for the attendance event. -
ContactPartyNumber: string
Title:
Party Number
Read Only:true
Maximum Length:30
The party number of the contact. -
CreatedBy: string
Title:
Created By
Read Only:true
Maximum Length:64
The user who created the record. -
CreationDate: string
(date-time)
Title:
Creation Date
Read Only:true
The date when the record was created. -
LastUpdateDate: string
(date-time)
Title:
Last Updated Date
Read Only:true
The date when the record was last updated. -
LastUpdatedBy: string
Title:
Last Updated By
Read Only:true
Maximum Length:64
The user who last updated the record. -
LastUpdateLogin: string
Title:
Last Update Login
Read Only:true
Maximum Length:32
The login of the user who last updated the record. -
LightboxDocumentId: string
Title:
Document ID
Maximum Length:64
The unique identifier of the Lightbox document. -
LightboxDocumentPageId: string
Title:
Document Page ID
The unique identifier of the Lightbox document page. The value is obtained from LightboxDocumentId, DocumentVersion and PageSequenceNumber unless specified during create. -
LightboxDocumentVersion: string
Title:
Version
Maximum Length:64
The version of the Lightbox document. -
links: array
Links
Title:
Links
The link relations associated with the resource instance. -
PageSequenceNumber: integer
(int32)
Title:
Page Sequence Number
The page sequence number of the Lightbox document page. -
PresentationSessionId: string
Title:
Session ID
Maximum Length:1000
The unique identifier of the presentation session.
Nested Schema : Links
Type:
array
Title:
Links
The link relations associated with the resource instance.
Show Source
Nested Schema : presentationSessions-sessionDisplayEvents-item-response
Type:
Show Source
object
-
CreatedBy: string
Title:
Created By
Read Only:true
Maximum Length:64
The user who created the record. -
CreationDate: string
(date-time)
Title:
Creation Date
Read Only:true
The date when the record was created. -
DisplayEventId: integer
(int64)
Title:
Display Event ID
The unique identifier of the presentation session display event. -
DisplayEventStartTime: string
(date-time)
Title:
Display Event Start Time
The start time for the display event. -
DisplayEventStopTime: string
(date-time)
Title:
Display Event Stop Time
The stop time for the display event. -
LastUpdateDate: string
(date-time)
Title:
Last Updated Date
Read Only:true
The date when the record was last updated. -
LastUpdatedBy: string
Title:
Last Updated By
Read Only:true
Maximum Length:64
The user who last updated the record. -
LastUpdateLogin: string
Title:
Last Update Login
Read Only:true
Maximum Length:32
The login of the user who last updated the record. -
LightboxDocumentId: string
Title:
Document ID
Maximum Length:64
The unique identifier of the Lightbox document. -
LightboxDocumentPageId: string
Title:
Document Page ID
The unique identifier of the Lightbox document page. The value is obtained from LightboxDocumentId, DocumentVersion and PageSequenceNumber unless specified during create. -
LightboxDocumentVersion: string
Title:
Version
Maximum Length:64
The version of the Lightbox document. -
links: array
Links
Title:
Links
The link relations associated with the resource instance. -
PageSequenceNumber: integer
(int32)
Title:
Page Sequence Number
The page sequence number of the Lightbox document page. -
PresentationSessionId: string
Title:
Session ID
Maximum Length:1000
The unique identifier of the presentation session.
Nested Schema : Links
Type:
array
Title:
Links
The link relations associated with the resource instance.
Show Source
Links
- AccountListVA
-
Operation: /crmRestApi/resources/11.13.18.05/accountsAn account for a customer or prospect. This object is an aggregation of primary account profile, and contact information, and references a single primary address.
- ActivityVA
-
Operation: /crmRestApi/resources/11.13.18.05/activitiesParameters:
- finder:
OpenActivities
The activities resource is used to view, create, update, and delete activity data. Activities keep track of things you plan to do, like a task or an appointment, or things that you have already completed, like logging a customer call. - finder:
- ResourceVA
-
Operation: /crmRestApi/resources/11.13.18.05/resourcesA front office person. For example, sales persons or partner members can be tagged as resources.
- sessionAttendanceEvents
-
Parameters:
- PresentationSessionId:
$request.path.PresentationSessionId
The presentation session attendance events resource is used to view and create the event attendance. Presentation session events attendance is used to keep track of the audience who attended a session when a Lightbox document was displayed. - PresentationSessionId:
- sessionDisplayEvents
-
Parameters:
- PresentationSessionId:
$request.path.PresentationSessionId
The presentation session display events resource is used to view and create the display events. Display events log the start and stop times during which a Lightbox document page was displayed during a presentation session. - PresentationSessionId:
Examples
The following example shows how to update a Lightbox presentation session by submitting a PATCH request on the REST resource using cURL.
cURL Command
curl -u <username:password> \ -X PATCH -d
@example_request_payload.json https://servername.fa.us2.oraclecloud.com/crmRestApi/resources/11.13.18.05/presentationSessions/300100090087004
Example of Request Body
The following shows an example of the request body in JSON format.
{ "AccountId": null }
Example of Response Body
The following example shows the contents of the response body in JSON format.
{ "PresentationSessionId": 300100090087004, "SessionDate": "2017-03-05T18:47:00+00:00", "ActivityId": null, "ActivitySubject": null, "ActivityNumber": null, "AccountId": null, "AccountName": null, "AccountPartyNumber": null, "ActivityAccountId": null, "ActivityAccountName": null, "ActivityAccountPartyNumber": null, "SessionOwnerId": 100010032752947, "SessionOwnerName": "Ryan,Katy", "SessionOwnerEmailAddress": "katy.ryan@us2.oraclecloud.com", "SessionOwnerTitle": null, "CreatedBy": "KRyan", "CreationDate": "2017-03-06T11:12:45+00:00", "LastUpdateDate": "2017-03-07T04:35:46+00:00", "LastUpdateLogin": "4A0CFB9DCAA07384E0533DD7F00AD358", "LastUpdatedBy": "KRyan", "TotalSessionDisplayDuration": null, "DeleteFlag": true, "UpdateFlag": true, "links": ... }