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.

Business capability
Sales Management BC-410

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

GET /activities Search activities across several hotels · Get activities #
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.
DELETE /activities Delete several activities by their IDs · Delete activities #
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.
PUT /activities Bulk update many activities at once · Operation to update multiple activities #
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.
POST /activities/activitiesCompletion Mark several activities as completed · Complete activities #
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.
GET /activities/emails Retrieve stored emails for accounts and contacts · Get Emails #
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}.
POST /activities/emails/searches Search stored emails by posting search criteria · Get Emails #
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.
GET /activities/{activityId} Get an activity by ID without naming a hotel · Get activity by ID #
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.
GET /hotels/{hotelId}/activities List activities for one hotel · Get activities by hotel #
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}.
POST /hotels/{hotelId}/activities Create a new activity at a hotel · Create activities in a hotel #
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}.
GET /hotels/{hotelId}/activityLog View the change log for activities · Get Activity Log #
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}.
GET /services/activity/status Check the activity service health · Operation to get health status #
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}.

Work with this as data

Every API here is available over the APIs.io API and to AI agents over MCP.

MCP server

One button, every client — Claude, Cursor, VS Code and the rest.

https://apis.io/mcp

Tools for apis

7 MCP tools reach this
  • find_apisBrowse and filter every API in the catalog.
  • get_api_artifactsOne API's artifacts, grouped by type.
  • get_openapiThe primary OpenAPI for this API.
  • find_similar_apisAPIs that look like this one.
  • apis_io_searchSTART HERE — APIs, providers and tags for one query, each with its total.
  • resolveTurn a domain, URL or GitHub org into the provider it belongs to.
  • find_cohortsEvery scored population of providers in the catalog.
All 92 tools →

Call it yourself

curl for this page
This API
curl "https://apis.io/api/v1/apis/oracle-hospitality:oracle-hospitality-activity-api"
All apis
curl "https://apis.io/api/v1/apis?limit=25"

Discovery needs no key. Ratings and market analysis are Pro.

Get an API key

Free tier, no form to fill in. Signing in shares your email address with us — we store it to create your key and to recognise you if you sign in with another provider. See our Privacy Policy and Terms.

A second provider on the same verified email joins the account you already have.

OpenAPI Specification

oracle-hospitality-activity-api-openapi.yml Raw ↑
openapi: 3.2.0
info:
  title: OPERA Cloud Activity API
  description: 'APIs to cater for Sales Activity functionality in OPERA Cloud.


    Activities provide you with an account management tool for managing daily tasks such as appointments, sales calls, contact follow-up, and so on.


    Compatible with OPERA Cloud release 26.2.0.0.


    This document and all content within is available under the Universal Permissive License v 1.0 (https://oss.oracle.com/licenses/upl). Copyright (c) 2020, 2026 Oracle and/or its affiliates.'
  version: 26.2.0.0
  termsOfService: https://www.oracle.com/legal/terms.html
  contact:
    email: hospitality_apis_ww_grp@oracle.com
  license:
    name: UPL
    url: https://opensource.org/licenses/upl
servers:
- url: /act/v1
tags:


# --- truncated at 32 KB (163 KB total) ---
# Full source: https://raw.githubusercontent.com/api-evangelist/oracle-hospitality/refs/heads/main/openapi/oracle-hospitality-activity-api-openapi.yml