Oracle Hospitality Activity API
The Activity REST APIs allow you to view, create, update, and complete an Activity in OPERA Cloud. You are also able to perform more actions such as add attachments.
Operations 23
Each operation below carries the questions people ask an LLM about it and the instructions they give an agent to run it. Generated by API Evangelist overlay
Ask an LLM
“What sales activities are open across all the hotels in my portfolio?”
“Can I pull activities for several properties at once, filtered by owner or date?”
Tell an agent
List activities across hotels {hotelIds} from {startDate} to {endDate}.
Show high-priority activities owned by {ownerCode} across all my hotels.
Ask an LLM
“Can I delete a whole list of activities in one call?”
“What do I need to remove several activities together?”
Tell an agent destructive · confirm first
Delete activities {activityIds}.
Remove every activity in the ID list {activityIds} in one go.
Ask an LLM
“Can I update a batch of activities in one request instead of one by one?”
“Is there a bulk edit for sales activities?”
Tell an agent
Apply bulk update {activitiesBulkUpdate} to the activities I list.
Bulk-edit all the selected activities with the same changes.
Ask an LLM
“How do I close out a batch of finished activities in one request?”
“Can completing activities also update the linked activities?”
Tell an agent
Mark the activities in {activitiesInformation} as completed.
Complete all the activities I list and update their linked activities too.
Ask an LLM
“Which emails from our external mail system are stored against a sales account in OPERA?”
“Can I fetch emails linked to a particular contact with a simple GET?”
Tell an agent
Get stored emails for account {accountIdId}.
List emails filed against contact {contactIdId}.
Ask an LLM
“Is there a POST search for stored emails when my criteria are too long for a query string?”
“Can I submit an email search in a request body and page through results?”
Tell an agent
Run an email search in the request body for account {accountIdId}.
Search stored emails via POST for contact {contactIdId}, {limit} at a time.
Ask an LLM
“Can I look up an activity by its OPERA ID when I don't know which hotel it belongs to?”
“What does a single activity record contain if I fetch it by ID alone?”
Tell an agent
Get activity {activityId} without specifying a hotel.
Fetch activity {activityId} by its OPERA ID only.
DELETE
/activities/{activityId}
Delete an activity by ID without naming a hotel · Delete activity by ID
#
Ask an LLM
“Can I mark an activity deleted using only its ID, no hotel code?”
“What's needed to delete an activity when the hotel isn't known?”
Tell an agent destructive · confirm first
Delete activity {activityId} without a hotel ID.
Mark activity {activityId} as deleted using its OPERA ID alone.
DELETE
/activities/{activityId}/attachments/{attachmentId}
Delete an activity attachment without a hotel ID · Delete an attachment from an Activity
#
Ask an LLM
“Can I remove a file attached to an activity without giving the hotel?”
“What IDs do I need to delete an activity attachment by ID alone?”
Tell an agent destructive · confirm first
Delete attachment {attachmentId} from activity {activityId}, no hotel needed.
Remove file {attachmentId} on activity {activityId} using IDs only.
Ask an LLM
“What activities are on the books for a single property?”
“Can I see only incomplete activities of a certain type at my hotel?”
Tell an agent
List activities at hotel {hotelId}.
Show activities of type {activityType} at {hotelId} between {startDate} and {endDate}.
Ask an LLM
“How do I log a sales appointment or to-do for a hotel in OPERA?”
“Which activity types, like appointments or TODOs, can I create for a property?”
Tell an agent
Create a new activity at hotel {hotelId}.
Add activity {activitiesInformation} to hotel {hotelId}.
GET
/hotels/{hotelId}/activities/statistics
Get activity statistics for a hotel · Get Activity statistics
#
Ask an LLM
“How many activities has each salesperson logged?”
“Can I get activity counts by type starting from a report date?”
Tell an agent
Get activity statistics for hotel {hotelId} from {reportStartDate}.
Show activity stats at {hotelId} for owners {ownerCodeList}.
GET
/hotels/{hotelId}/activities/{activityId}
Get one activity at a specific hotel · Get activity in a hotel by ID
#
Ask an LLM
“What are the details of a specific activity at my hotel?”
“Can I read an activity by ID scoped to a given property?”
Tell an agent
Get activity {activityId} at hotel {hotelId}.
Show the details of hotel {hotelId}'s activity {activityId}.
PUT
/hotels/{hotelId}/activities/{activityId}
Update an activity at a hotel · Update activity in a hotel by ID
#
Ask an LLM
“How do I change the date or notes on an existing activity?”
“Can updating an activity also change its linked activities?”
Tell an agent
Update activity {activityId} at hotel {hotelId}.
Change activity {activityId}'s details to {activitiesInformation}.
DELETE
/hotels/{hotelId}/activities/{activityId}
Delete an activity at a specific hotel · Delete activity in a hotel by ID
#
Ask an LLM
“How do I delete an activity from a particular hotel?”
“Is a deleted activity at a property only marked deleted rather than purged?”
Tell an agent destructive · confirm first
Delete activity {activityId} at hotel {hotelId}.
Mark hotel {hotelId}'s activity {activityId} as deleted.
POST
/hotels/{hotelId}/activities/{activityId}/activityCompletion
Mark one activity as completed · Complete activity in a hotel by ID
#
Ask an LLM
“How do I mark a single appointment as done?”
“Can I complete just one activity at a hotel by its ID?”
Tell an agent
Complete activity {activityId} at hotel {hotelId}.
Mark activity {activityId} as finished.
GET
/hotels/{hotelId}/activities/{activityId}/attachments
List attachments on an activity · Get Activity Attachments
#
Ask an LLM
“What files are attached to this activity?”
“Can I find an activity attachment by its file name?”
Tell an agent
List attachments on activity {activityId} at hotel {hotelId}.
Find the attachment named {attachedFileName} on activity {activityId}.
DELETE
/hotels/{hotelId}/activities/{activityId}/attachments/{attachmentId}
Delete an attachment from an activity at a hotel · Delete an attachment from an Activity
#
Ask an LLM
“How do I remove a wrong file from an activity at my hotel?”
“Can I delete an activity attachment scoped to a property?”
Tell an agent destructive · confirm first
Delete attachment {attachmentId} from activity {activityId} at hotel {hotelId}.
Remove file {attachmentId} from hotel {hotelId}'s activity {activityId}.
POST
/hotels/{hotelId}/activities/{activityId}/linkedActivities
Invite other owners to an activity · Create linked activities in a hotel by ID
#
Ask an LLM
“How do I invite a colleague to an appointment I own?”
“Can one activity be shared with multiple owners?”
Tell an agent
Invite additional owners to activity {activityId} at hotel {hotelId}.
Create linked activities {linkedActivityDetails} for activity {activityId}.
Ask an LLM
“Who changed this activity and when?”
“Can I see the activity change history for a date range or by user?”
Tell an agent
Show the activity change log at hotel {hotelId} from {fromDate} to {toDate}.
Get log entries for activity type {activityType} changed by user {userByIdUserIds}.
GET
/hotels/{hotelId}/recentlyAccessedActivities
List recently opened activities at a hotel · Get recently accessed activities
#
Ask an LLM
“Which activities did I open recently at this property?”
“Can I get a quick list of recently viewed activities for one hotel?”
Tell an agent
Show recently accessed activities at hotel {hotelId}.
List the activities I recently opened for {hotelId}.
GET
/recentlyAccessedActivities
List recently opened activities across hotels · Get recently accessed activities
#
Ask an LLM
“What activities have I looked at recently, regardless of hotel?”
“Is there a recent-activities list that doesn't need a hotel ID?”
Tell an agent
Show my recently accessed activities across all hotels.
List recently viewed activities without a hotel path, logged in at {hotelid}.
Ask an LLM
“Is the OPERA activity service currently up?”
“How can I health-check the activity API?”
Tell an agent
Ping the activity service.
Check activity API health for hotel {hotelid}.
Documentation
📖
Documentation
https://docs.oracle.com/cd/F29336_01/doc.201/f27480/c_oracle_hospitality_distribution_apis.htm
📖
Documentation
https://docs.oracle.com/cd/F29336_01/doc.201/f27480/c_oracle_hospitality_nor1_integrated_upsell_apis.htm
📖
Documentation
https://docs.oracle.com/cd/F29336_01/doc.201/f27480/c_property_apis.htm