What's New

Learn about new and changed endpoints for the Oracle AI Data Platform Workbench REST API.

Note:

APIs marked as Preview are design, specification, and implementation complete but might change before general release. Preview APIs are intended for evaluation and training purposes. Preview APIs aren't recommended for production use or business-critical scenarios.

July 2026

REST API Category	Changes in REST API
New endpoints	New endpoints: Agent Copy an agent: POST /20260430/aiDataPlatforms/{aiDataPlatformId}/workspaces/{workspaceKey}/agents/{agentKey}/actions/copy Create an agent: POST /20260430/aiDataPlatforms/{aiDataPlatformId}/workspaces/{workspaceKey}/agents Delete an agent: DELETE /20260430/aiDataPlatforms/{aiDataPlatformId}/workspaces/{workspaceKey}/agents/{agentKey} Delete an agent deployment: DELETE /20260430/aiDataPlatforms/{aiDataPlatformId}/workspaces/{workspaceKey}/agents/{agentKey}/deployments/{agentDeploymentKey} Delete an agent session: DELETE /20260430/aiDataPlatforms/{aiDataPlatformId}/workspaces/{workspaceKey}/agents/{agentKey}/sessions/{sessionId} Deploy an agent: POST /20260430/aiDataPlatforms/{aiDataPlatformId}/workspaces/{workspaceKey}/agents/{agentKey}/deployments/actions/deploy Get agent deployment details: GET /20260430/aiDataPlatforms/{aiDataPlatformId}/workspaces/{workspaceKey}/agents/{agentKey}/deployments/{agentDeploymentKey} Get agent details: GET /20260430/aiDataPlatforms/{aiDataPlatformId}/workspaces/{workspaceKey}/agents/{agentKey} Get agent permissions: GET /20260430/aiDataPlatforms/{aiDataPlatformId}/workspaces/{workspaceKey}/agents/{agentKey}/permissions Get agent session chat messages: GET /20260430/aiDataPlatforms/{aiDataPlatformId}/workspaces/{workspaceKey}/agents/{agentKey}/sessions/{sessionId}/chatHistory Get agent session details: GET /20260430/aiDataPlatforms/{aiDataPlatformId}/workspaces/{workspaceKey}/agents/{agentKey}/sessions/{sessionId} Get agent session trace for a given message key: GET /20260430/aiDataPlatforms/{aiDataPlatformId}/workspaces/{workspaceKey}/agents/{agentKey}/sessions/{sessionId}/traces/{traceKey} Get agents in schema: GET /20260430/aiDataPlatforms/{aiDataPlatformId}/workspaces/{workspaceKey}/agents List all deployments of an agent: GET /20260430/aiDataPlatforms/{aiDataPlatformId}/workspaces/{workspaceKey}/agents/{agentKey}/deployments List all test sessions of an agent: GET /20260430/aiDataPlatforms/{aiDataPlatformId}/workspaces/{workspaceKey}/agents/{agentKey}/sessions Preview agent card: POST /20260430/aiDataPlatforms/{aiDataPlatformId}/workspaces/{workspaceKey}/agents/actions/previewAgentCard Redeploy an agent: POST /20260430/aiDataPlatforms/{aiDataPlatformId}/workspaces/{workspaceKey}/agents/{agentKey}/deployments/actions/redeploy Update agent card details: PUT /20260430/aiDataPlatforms/{aiDataPlatformId}/workspaces/{workspaceKey}/agents/{agentKey}/actions/updateDeploymentMetadata Update agent permissions: POST /20260430/aiDataPlatforms/{aiDataPlatformId}/workspaces/{workspaceKey}/agents/{agentKey}/actions/managePermission Update an agent: PUT /20260430/aiDataPlatforms/{aiDataPlatformId}/workspaces/{workspaceKey}/agents/{agentKey} Validate agent diagram: POST /20260430/aiDataPlatforms/{aiDataPlatformId}/workspaces/{workspaceKey}/agents/{agentKey}/actions/validate Bundles Create a bundle: POST /20260430/aiDataPlatforms/{aiDataPlatformId}/workspaces/{workspaceKey}/actions/createBundle Deploy all bundle resources: POST /20260430/aiDataPlatforms/{aiDataPlatformId}/workspaces/{workspaceKey}/actions/deployBundle Destroy all deployed bundle resources: POST /20260430/aiDataPlatforms/{aiDataPlatformId}/workspaces/{workspaceKey}/actions/purgeBundle Returns the latest known deployment summary for a bundle: POST /20260430/aiDataPlatforms/{aiDataPlatformId}/workspaces/{workspaceKey}/actions/getBundleDeploymentStatus Sync bundle artifacts and descriptors: POST /20260430/aiDataPlatforms/{aiDataPlatformId}/workspaces/{workspaceKey}/actions/syncBundle
Deprecated endpoints	The following endpoints are deprecated, but still usable for the next 12 months. Please migrate to the new endpoints before these are disabled. Bundles POST /20260430/aiDataPlatforms/{aiDataPlatformId}/workspaces/{workspaceKey}/bundles POST /20260430/aiDataPlatforms/{aiDataPlatformId}/workspaces/{workspaceKey}/bundles/actions/deploy POST /20260430/aiDataPlatforms/{aiDataPlatformId}/workspaces/{workspaceKey}/bundles/actions/purge POST /20260430/aiDataPlatforms/{aiDataPlatformId}/workspaces/{workspaceKey}/bundles/actions/getDeploymentStatus POST /20260430/aiDataPlatforms/{aiDataPlatformId}/workspaces/{workspaceKey}/bundles/actions/sync

June 2026

REST API Category	Changes in REST API
SDK and CLI	Added links to SDK and CLI resources. See SDK and CLI.

May 2026

REST API Category	Changes in REST API
All	First release of REST API documentation for Oracle AI Data Platform Workbench.