Embedded APIResources

API platform

The API platform APIs allow users to programmatically create and manage API platform assets like endpoints, collections, clients, and access profiles.

All endpoints listed here are Embedded Vendor APIs and require the oem_vendor privilege. The API platform feature is also a feature add-on that should be enabled in the partner admin and customer workspaces. Talk to your Workato representative to enable both privileges.

RATE LIMIT

API platform endpoints allow up to 10 requests per second.

For Embedded partners looking to enable API platform for their customers, use this guide for more information.

DEPRECATION NOTICE

The following endpoints are scheduled for deprecation on December 1, 2025:

Migrate to the following endpoints before this date to avoid service interruptions:

Quick reference

TypeResourceDescription
GET/api/managed_users/:managed_user_id/api_collectionsList API collections
POST/api/managed_users/:managed_user_id/api_collectionsCreate an API collection
GET/api/managed_users/:managed_user_id/api_endpointsList API endpoints
PUT/api/managed_users/:managed_user_id/api_endpoints/:api_endpoint_id/disableDisable an API endpoint
PUT/api/managed_users/:managed_user_id/api_endpoints/:api_endpoint_id/enableEnable an API endpoint
GET/api/managed_users/:managed_user_id/api_clientsList API clients
GET/api/v2/managed_users/:managed_user_id/api_clientsList API clients
POST/api/managed_users/:managed_user_id/api_clientsCreate an API client
POST/api/v2/managed_users/:managed_user_id/api_clientsCreate an API client
GET/api/v2/managed_users/:managed_user_id/api_clients/:api_client_idRetrieve details of an API client in a customer workspace using its ID.
PUT/api/v2/managed_users/:managed_user_id/api_clients/:api_client_idUpdate an existing API client within a project you specify in a customer workspace.
GET/api/managed_users/:managed_user_id/api_access_profilesList access profiles belonging to an API client
POST/api/managed_users/:managed_user_id/api_access_profilesCreate an access profile belonging to an API client
PUT/api/managed_users/:managed_user_id/api_access_profiles/:api_access_profile_idUpdate an access profile belonging to an API client
PUT/api/managed_users/:managed_user_id/api_access_profiles/:api_access_profile_id/disableDisable an access profile
PUT/api/managed_users/:managed_user_id/api_access_profiles/:api_access_profile_id/enableEnable an access profile
PUT/api/managed_users/:managed_user_id/api_access_profiles/:api_access_profile_id/refresh_secretRefresh token secret or OAuth client secret
GET/api/v2/managed_users/:id/api_clients/:api_client_id/api_keysRetrieves all API keys for an API client.
POST/api/v2/managed_users/:id/api_clients/:api_client_id/api_keysCreates a new API key for an API client.
PUT/api/v2/managed_users/:id/api_clients/:api_client_id/api_keys/:api_key_idUpdates an existing API key for an API client.
PUT/api/v2/managed_users/:id/api_clients/:api_client_id/api_keys/:api_key_id/enableEnables an API key for an API client, allowing it to make authenticated requests.
PUT/api/v2/managed_users/:id/api_clients/:api_client_id/api_keys/:api_key_id/disableDisables an API key for an API client, preventing it from making API requests.
PUT/api/v2/managed_users/:id/api_clients/:api_client_id/api_keys/:api_key_id/refresh_secretRefreshes the authentication token or OAuth 2.0 client secret for an API key.
GET/api/v2/managed_users/:id/api_portalsRetrieves a list of all API portals associated with API clients in your workspace.
GET/api/managed_users/:id/cert_bundlesList all certificate bundles.
POST/api/managed_users/:id/cert_bundlesCreate a new certificate bundle.
PUT/api/managed_users/:id/cert_bundles/:certificate_bundle_idUpdate a certificate bundle.
DELETE/api/managed_users/:id/cert_bundles/:certificate_bundle_idDelete a certificate bundle.
GET/api/managed_users/:id/cert_bundles/
:certificate_bundle_id/download		Download the certificate bundle PEM file.