Embedded API resources
API clients
| Type | Resource | Description |
|---|---|---|
| GET | /api/v2/managed_users/:id/developer_api_clients | List all Developer API clients in a customer workspace. |
| POST | /api/v2/managed_users/:id/developer_api_clients | Create a new Developer API client in a customer workspace. |
| GET | /api/v2/managed_users/:id/developer_api_clients/:id | Retrieve details of a Developer API client by ID in a customer workspace. |
| PUT | /api/v2/managed_users/:id/developer_api_clients/:id | Update an existing Developer API client in a customer workspace. |
| DELETE | /api/v2/managed_users/:id/developer_api_clients/:id | Delete an existing Developer API client in a customer workspace. |
| POST | /api/v2/managed_users/:id/developer_api_clients/:id/regenerate | Regenerate the token for a Developer API client in a customer workspace. |
| GET | /api/v2/managed_users/:managed_user_id/developer_api_client_roles | List Developer API client roles in a customer workspace. |
| POST | /api/v2/managed_users/:managed_user_id/developer_api_client_roles/:id/copy | Copy a Developer API client role in a customer workspace. |
API platform
| Type | Resource | Description |
|---|---|---|
| GET | /api/managed_users/:id/api_collections | List API collections in a customer workspace. |
| POST | /api/managed_users/:id/api_collections | Create API collection in a customer workspace. |
| GET | /api/managed_users/:id/api_endpoints | List API endpoints in a collection. |
| PUT | /api/managed_users/:id/api_endpoints/:id/enable | Enable an API endpoint in a collection. |
| PUT | /api/managed_users/:id/api_endpoints/:id/disable | Disable an API endpoint in a collection. |
| GET | /api/managed_users/:id/api_clients | List API clients in a customer workspace. We recommend that you migrate to the List API clients (v2) endpoint to prepare for future deprecation. |
| GET | /api/v2/managed_users/:id/api_clients | List all API clients in a customer workspace. Workato includes the project_id of the project to which the API client belongs in the response. |
| POST | /api/managed_users/:id/api_clients | Create API client in a customer workspace. We recommend that you migrate to the Create API client (v2) endpoint to prepare for future deprecation. |
| POST | /api/v2/managed_users/:id/api_clients | Create a new API client in a customer workspace within a project you specify. |
| GET | /api/v2/managed_users/:id/api_clients/:api_client_id | Retrieve details of an API client by ID in a customer workspace. |
| PUT | /api/v2/managed_users/:id/api_clients/:api_client_id | Update an existing API client within a project you specify in a customer workspace. |
| DELETE | /api/v2/managed_users/:id/api_clients/:api_client_id | Delete an existing API client in a customer workspace. |
| GET | /api/managed_users/:id/api_access_profiles | List access profiles belonging to an API client in a customer workspace. We recommend that you migrate to the List API keys endpoint to prepare for future deprecation. |
| GET | /api/v2/managed_users/:id/api_clients/:api_client_id/api_keys | List API keys for an API client in a customer workspace. |
| POST | /api/managed_users/:id/api_access_profiles | Create an access profile belonging to an API client in a customer workspace. We recommend that you migrate to the Create API key endpoint to prepare for future deprecation. |
| POST | /api/v2/managed_users/:id/api_clients/:api_client_id/api_keys | Create an API key for an API client in a customer workspace. |
| PUT | /api/managed_users/:id/api_access_profiles | Update an access profile belonging to an API client in a customer workspace. We recommend that you migrate to the Update API key endpoint to prepare for future deprecation. |
| PUT | /api/v2/managed_users/:id/api_clients/:api_client_id/api_keys/:api_key_id | Update an API key for an API client in a customer workspace. |
| PUT | /api/managed_users/:id/api_access_profiles/:api_access_profile_id/enable | Enable an access profile belonging to an API client in a customer workspace. We recommend that you migrate to the Enable API key endpoint to prepare for future deprecation. |
| PUT | /api/v2/managed_users/:id/api_clients/:api_client_id/api_keys/:api_key_id/enable | Enable an API key for an API client in a customer workspace. |
| PUT | /api/managed_users/:id/api_access_profiles | Disable an access profile belonging to an API client in a customer workspace. We recommend that you migrate to the Disable API key endpoint to prepare for future deprecation. |
| PUT | /api/v2/managed_users/:id/api_clients/:api_client_id/api_keys/:api_key_id/disable | Disable an API key for an API client in a customer workspace. |
| PUT | /api/managed_users/:id/api_access_profiles/:id/refresh_secret | Refreshes an access profile token or secret. We recommend that you migrate to the Refresh API key secret endpoint to prepare for future deprecation. |
| POST | /api/v2/managed_users/:id/api_clients/:api_client_id/api_keys/:api_key_id/refresh_secret | Refresh the authentication token or OAuth 2.0 client secret for an API key in a customer workspace. |
| DELETE | /api/v2/managed_users/:id/api_clients/:api_client_id/api_keys/:api_key_id | Delete an existing API key in a customer workspace. |
| GET | /api/v2/managed_users/:id/api_portals | List all API portals associated with API clients in a customer workspace. |
Collaborator groups
| Type | Resource | Description |
|---|---|---|
| GET | /api/managed_users/:managed_user_id/user_groups | List customer workspace collaborator groups. |
| GET | /api/managed_users/:managed_user_id/user_groups/:id | Get customer workspace collaborator group details. |
| POST | /api/managed_users/:managed_user_id/user_groups | Create a customer workspace collaborator group. |
| PUT | /api/managed_users/:managed_user_id/user_groups/:id | Update a customer workspace collaborator group. |
| DELETE | /api/managed_users/:managed_user_id/user_groups/:id | Delete a customer workspace collaborator group. |
| GET | /api/managed_users/:managed_user_id/user_groups/:id/members | List collaborator group members in a customer workspace. |
| POST | /api/managed_users/:managed_user_id/user_groups/:id/members | Add members to a customer workspace collaborator group. |
| DELETE | /api/managed_users/:managed_user_id/user_groups/:id/members | Remove members from a customer workspace collaborator group. |
| GET | /api/managed_users/:managed_user_id/user_groups/:id/project_grants | List a customer workspace collaborator group's project grants. |
Connections
| Type | Resource | Description |
|---|---|---|
| GET | /api/managed_users/:managed_user_id/connections/:adapter_name/input_schema | Returns input schema based on a connection's input. |
| GET | /api/managed_users/:managed_user_id/connections | Returns a list of connections in a customer workspace. |
| POST | /api/managed_users/:managed_user_id/connections | Allows the Embedded vendor to add a shell connection in a customer workspace. |
| PUT | /api/managed_users/:managed_user_id/connections/:connection_id | Updates a connection in a customer workspace. |
| POST | /api/managed_users/:managed_user_id/connections/:connection_id/disconnect | Disconnects a connection in a customer workspace. |
| DELETE | /api/managed_users/:managed_user_id/connections/:connection_id | Deletes a connection in a customer workspace. |
Connectors
| Type | Resource | Description |
|---|---|---|
| GET | /api/v2/managed_users/:managed_user_id/connectors/:connector_name/input_schema | Returns the base input schema. The schemas are static and don't take specific connection input into consideration. |
| GET | /api/integrations | Query connector metadata. |
| GET | /api/integrations/all | Returns a paginated list of all connectors and associated metadata in an Embedded partner's account. The response includes standard and custom connectors. |
Custom connectors
| Type | Resource | Description |
|---|---|---|
| GET | /api/custom_connectors | Get custom connectors. |
| GET | /api/custom_connectors/:id | Get custom connector by ID |
| POST | /api/custom_connectors/:id/oem_share/:version | Create or update a shared connector |
| POST | api/managed_users/:managed_user_id/recipes/:recipe_id/share | Share a recipe containing a custom connector with Embedded partners. |
| DELETE | /api/custom_connectors/:id/suppress_oem_version | Remove a shared connector |
Custom OAuth profiles
| Type | Resource | Description |
|---|---|---|
| POST | /api/managed_users/:managed_user_id/custom_oauth_profiles/:id/assign | Assign a Custom OAuth profile to customer workspace |
| DELETE | /api/managed_users/:managed_user_id/custom_oauth_profiles/:id/unassign | Unassigns a Custom OAuth profile to a customer workspace. |
Customer managers
| Type | Resource | Description |
|---|---|---|
| GET | /api/customer_managers | List all customer managers. |
| PUT | /api/customer_managers/:id | Update a customer manager. |
| POST | /api/customer_managers | Create a new customer manager. |
| DELETE | /api/customer_managers/:id | Delete a customer manager. |
Customer workspace collaborators
| Type | Resource | Description |
|---|---|---|
| POST | /api/managed_users/:id/member_invitation | Invites a collaborator to a managed customer workspace. |
Data retention
| Type | Resource | Description |
|---|---|---|
| PUT | /api/managed_users/:managed_user_id/update_data_retention | Update a customer workspace's data retention period. |
Data tables
Table management APIs
Base URL: https://www.workato.com
| Type | Resource | Description |
|---|---|---|
| GET | /api/v2/managed_users/:managed_user_id/data_tables | List all data tables. |
| GET | /api/v2/managed_users/:managed_user_id/data_tables/:data_table_id | Get data table by ID. |
| POST | /api/v2/managed_users/:managed_user_id/data_tables | Creates a data table. |
| PUT | /api/v2/managed_users/:managed_user_id/data_tables/:data_table_id | Updates a data table. |
| DELETE | /api/v2/managed_users/:managed_user_id/data_tables/:data_table_id | Deletes a data table. |
| POST | /api/v2/managed_users/:managed_user_id/data_tables/:data_table_id/truncate | Truncates a data table. |
Record manipulation APIs
Base URL: https://data-tables.workato.com
| Type | Resource | Description |
|---|---|---|
| POST | /api/v1/managed_users/:managed_user_id/tables/:data_table_id/query | Queries records using filters you specify. |
| POST | /api/v1/managed_users/:managed_user_id/tables/:data_table_id/records | Creates a new record. |
| PUT | /api/v1/managed_users/:managed_user_id/tables/:data_table_id/records/:record_id | Updates an existing record. |
| DELETE | /api/v1/managed_users/:managed_user_id/tables/:data_table_id/records/:record_id | Deletes a record you specify. |
| POST | /api/v1/managed_users/:managed_user_id/tables/:data_table_id/fields/:field_id/file | Generates a link to upload a file. |
| GET | /api/v1/managed_users/:managed_user_id/tables/:data_table_id/records/:record_id/fields/:field_id/file | Generates a link to download a file. |
Record import APIs
Base URL: https://data-tables.workato.com, except Upload file, which uses https://file-storage.workato.com.
| Type | Resource | Description |
|---|---|---|
| POST | /api/v1/managed_users/:managed_user_id/tables/:data_table_id/records/import/file/upload_link | Creates a link to upload a file. |
| POST | /sharing/files | Uploads the file to the signed link. |
| DELETE | /api/v1/managed_users/:managed_user_id/tables/:data_table_id/records/import/file | Deletes the uploaded file. |
| GET | /api/v1/managed_users/:managed_user_id/tables/:data_table_id/records/import/file | Describes the uploaded file. |
| POST | /api/v1/managed_users/:managed_user_id/tables/:data_table_id/records/import/start | Starts importing records from the uploaded file. |
| DELETE | /api/v1/managed_users/:managed_user_id/tables/:data_table_id/records/import | Dismisses or cancels the import. |
Dynamic field mapping
| Type | Resource | Description |
|---|---|---|
| GET | /api/v2/managed_users/:managed_user_id /recipes/:recipe_id/field_map_introspections | List all field map introspections in a specific recipe. |
| GET | /api/v2/managed_users/:managed_user_id /recipes/:recipe_id/field_map_introspections/:id | List the field map introspections for a specific field map schema. |
| PUT | /api/v2/managed_users/:managed_user_id /recipes/:recipe_id/field_map_introspections/:id | Update field mapping for a specific field map schema. |
| POST | /api/v2/managed_users/:managed_user_id /recipes/:recipe_id/field_map_introspections/:id /refresh_schema | Refresh a recipe’s schema to update field map introspections. |
| POST | /api/v2/managed_users/:managed_user_id /recipes/:recipe_id/field_map_introspections/:id/pick_list | Retrieve picklist values for specific fields within a field map introspection of a recipe. |
Environment management
| Type | Resource | Description |
|---|---|---|
| GET | /api/managed_users/:id/activity_logs | Retrieves activity audit log records in a customer workspace. |
| GET | /api/v2/managed_users/:id/tags | Retrieves a list of tags in a customer workspace. |
| POST | /api/v2/managed_users/:id/tags | Creates a tag in a customer workspace. |
| PUT | /api/v2/managed_users/:id/tags/:handle | Updates a tag in a customer workspace. |
| DELETE | /api/v2/managed_users/:id/tags/:handle | Deletes a tag in a customer workspace. |
Environment properties
| Type | Resource | Description |
|---|---|---|
| GET | /api/managed_users/:managed_user_id/properties | Returns a list of environment properties belonging to a customer workspace that matches a prefix. |
| POST | /api/managed_users/:managed_user_id/properties | Upserts environment properties to a customer workspace. |
Environment roles
| Type | Resource | Description |
|---|---|---|
| GET | /api/managed_users/:managed_user_id/environment_roles | List environment roles in a customer workspace. |
| GET | /api/managed_users/:managed_user_id/environment_roles/:id | Get an environment role from a customer workspace. |
| POST | /api/managed_users/:managed_user_id/environment_roles | Create an environment role in a customer workspace. |
| PUT | /api/managed_users/:managed_user_id/environment_roles/:id | Update an environment role in a customer workspace. |
| DELETE | /api/managed_users/:managed_user_id/environment_roles/:id | Delete an environment role in a customer workspace. |
Environments
| Type | Resource | Description |
|---|---|---|
| POST | /api/managed_users/:id/environments | Provision Environments for an existing customer. Any existing assets in the customer workspace are placed in the Development environment after provisioning. |
| POST | /api/v2/managed_users/:managed_user_id/environments | Provision Environments V2 for an existing customer. Any existing assets in the customer workspace are placed in the Production environment after provisioning. |
| GET | /api/v2/managed_users/environments_provision_tasks/:id | Get the status of asynchronous environment provisioning. |
Folders
| Type | Resource | Description |
|---|---|---|
| GET | /api/managed_users/:managed_user_id/folders | List folders in a customer workspace. |
| POST | /api/managed_users/:managed_user_id/folders | Create a folder in a customer workspace. |
| PUT | /api/managed_users/:managed_user_id/folders/:folder_id | Update a folder in a customer workspace. |
| DELETE | /api/managed_users/:managed_user_id/folders/:folder_id | Delete a folder in a customer workspace. |
Jobs
| Type | Resource | Description |
|---|---|---|
| GET | /api/managed_users/:id/recipes/:recipe_id/jobs | List jobs for a recipe. |
| GET | /api/managed_users/:id/recipes/:recipe_id/jobs/:job_id | Get job details. |
| POST | /api/managed_users/:managed_user_id/recipes/:recipe_id/repeat_jobs | Repeats jobs you specify in a customer workspace. |
JWT direct link configurations
| Type | Resource | Description |
|---|---|---|
| PUT | /api/account/signature_verification_key | Update JWT signature verification key. |
Legacy roles
| Type | Resource | Description |
|---|---|---|
| GET | /api/managed_users/:id/roles | List custom roles in a customer workspace. |
| POST | /api/managed_users/:id/roles/:role_id/copy | Makes a copy of a custom role. |
Lookup tables
| Type | Resource | Description |
|---|---|---|
| GET | /api/managed_users/:managed_user_id/lookup_tables | List tables. |
| GET | /api/managed_users/:managed_user_id/lookup_tables/:lookup_table_id/lookup | Look up rows. |
| GET | /api/managed_users/:managed_user_id/lookup_tables/:lookup_table_id/rows | List rows. |
| GET | /api/managed_users/:managed_user_id/lookup_tables/:lookup_table_id/rows/:row_id | List rows in a lookup table. |
| POST | /api/managed_users/:managed_user_id/lookup_tables/:lookup_table_id/rows | Add a row to a lookup table. |
| POST | /api/managed_users/:managed_user_id/lookup_tables | Create a new lookup table. |
| POST | /api/managed_users/:managed_user_id/lookup_tables/batch_delete | Delete lookup tables in batch. |
| PUT | /api/managed_users/:managed_user_id/lookup_tables/:lookup_table_id/rows/:row_id | Update a row in a lookup table. |
| DELETE | /api/managed_users/:managed_user_id/lookup_tables/:lookup_table_id/rows/:row_id | Delete a row in a lookup table. |
Manage customers
| Type | Resource | Description |
|---|---|---|
| POST | /api/managed_users | Create a customer. |
| PUT | /api/managed_users/:id | Update a customer. |
| DELETE | /api/managed_users/:id | Delete a customer. |
| GET | /api/managed_users/:id | Get a customer. |
| GET | /api/managed_users | List all customers. |
| GET | /api/managed_users/:id/members | Get a list of collaborators in a customer workspace. |
| GET | /api/managed_users/:id/members/:member_id | Get customer workspace collaborator details. |
| POST | /api/managed_users/:id/members | Add collaborator to customer workspace. |
| PUT | /api/managed_users/:id/members/:member_id | Update a customer workspace collaborator. |
| DELETE | /api/managed_users/:id/members/:member_id | Remove collaborator from customer workspace. |
| GET | /api/managed_users/:id/members/:member_id/project_grants | List a customer workspace collaborator's project grants. |
| GET | /api/managed_users/:id/connections | List connections in a customer workspace. |
| GET | /api/managed_users/:id/members/:member_id/privileges | Get privileges from a customer workspace collaborator. |
| GET | /api/managed_users/:managed_user_id/members/:id/projects_privileges | Get projects privileges from a customer workspace collaborator. |
| POST | /api/v2/managed_users/statistics/usage | Retrieve usage metrics for customer workspaces with enhanced data granularity. |
| POST | /api/v2/managed_users/statistics/connection_usage | Retrieve connection-based usage metrics for specified customer workspaces. |
| GET | /api/managed_users/usage | Get task usage of all customers by month. |
| POST | /api/managed_users/:id/environments | Provision Environments for an existing customer. |
| GET | /api/v2/managed_users/customer_categories | List customer categories in an Embedded partner's workspace. |
| POST | /api/v2/managed_users/customer_categories | Create a customer category. |
| PUT | /api/v2/managed_users/customer_categories/:id | Update a customer category. |
| DELETE | /api/v2/managed_users/customer_categories/:id | Delete a customer category. |
| POST | /api/v2/managed_users/customer_categories/:id/assign | Batch assign a customer category to workspaces. |
| POST | /api/v2/managed_users/customer_categories/:id/unassign | Batch unassign a customer category from workspaces. |
MCP servers
On-prem
| Type | Resource | Description |
|---|---|---|
| GET | /api/v2/managed_users/:id/on_prem_groups | List on-prem groups in a customer workspace. |
| GET | /api/v2/managed_users/:id/on_prem_agents | List on-prem agents in a customer workspace. |
| GET | /api/v2/managed_users/:id/on_prem_agents/:agent_id | Retrieve the details of a specific on-prem agent in a customer workspace using its ID. |
Picklists
| Type | Resource | Description |
|---|---|---|
| POST | /api/managed_users/:id/connections/:connection_id/pick_list | Obtains a list of picklist values for a specified connection in an Embedded customer workspace. |
Project grants
| Type | Resource | Description |
|---|---|---|
| GET | /api/managed_users/:managed_user_id/project_grants/:id | Get a customer workspace project grant. |
| PUT | /api/managed_users/:managed_user_id/project_grants/:id | Update a customer workspace project grant. |
| DELETE | /api/managed_users/:managed_user_id/project_grants/:id | Delete a customer workspace project grant. |
| GET | /api/managed_users/:managed_user_id/:id/project_grants | List grants from a specific project in a customer workspace. |
| PUT | /api/managed_users/:managed_user_id/projects/:id/project_grants | Add or update customer workspace project grants. |
Project roles
| Type | Resource | Description |
|---|---|---|
| GET | /api/managed_users/:managed_user_id/project_roles | List project roles in a customer workspace. |
| GET | /api/managed_users/:managed_user_id/project_roles/:id | Get a project role from a customer workspace. |
| POST | /api/managed_users/:managed_user_id/project_roles | Create a project role in a customer workspace. |
| PUT | /api/managed_users/:managed_user_id/project_roles/:id | Update a project role in a customer workspace. |
| DELETE | /api/managed_users/:managed_user_id/project_roles/:id | Delete a project role from a customer workspace. |
Projects
| Type | Resource | Description |
|---|---|---|
| GET | /api/managed_users/:managed_user_id/projects | List projects in a customer workspace. |
| POST | /api/managed_users/:managed_user_id/folders | Create a project in a customer workspace. |
| PUT | /api/managed_users/:managed_user_id/projects/:project_id | Update a project in a customer workspace. |
| DELETE | /api/managed_users/:managed_user_id/projects/:project_id | Delete a project in a customer workspace. |
| GET | /api/managed_users/:managed_user_id/properties | List project-level properties by prefix and project ID. |
| POST | /api/managed_users/:managed_user_id/properties | Upsert project-level properties. |
| GET | /api/managed_users/:managed_user_id/deployments | Retrieve a list of deployments in a customer workspace. |
| GET | /api/managed_users/:managed_user_id/deployments/:id | Retrieve a single deployment in a customer workspace. |
| GET | /api/managed_users/:managed_user_id/api/project_builds/:id | Retrieve a downloaded package in a customer workspace. |
| POST | /api/managed_users/:managed_user_id/projects/:id/build | Build a project in a customer workspace. |
| POST | /api/managed_users/:managed_user_id/project_builds/:id/deploy | Deploy a downloaded package in a customer workspace. |
| POST | /api/managed_users/:managed_user_id/projects/:project_id/deploy | Deploy a project in a customer workspace. |
| GET | /api/managed_users/:managed_user_id/deployments/:id/eligible_reviewers | Retrieve a list of eligible reviewers that can be assigned to review a deployment in a customer workspace. |
| POST | /api/managed_users/:managed_user_id/deployments/:id/assign_reviewers | Assign reviewers to a deployment in a customer workspace. |
| POST | /api/managed_users/:managed_user_id/deployments/:id/submit_for_review | Submit a deployment for review in a customer workspace. |
| POST | /api/managed_users/:managed_user_id/deployments/:id/deploy | Deploy an approved deployment in a customer workspace. |
Recipes
Recipe lifecycle management
Looking for APIs to export packages? Refer to the Workato API docs.
WHO CAN USE THESE ENDPOINTS?
The endpoints in this guide are Embedded Partner APIs. Contact your Workato representative for more info.
| Type | Resource | Description |
|---|---|---|
| GET | /api/managed_users/:managed_user_id/export_manifests/folder_assets | View assets in a folder. |
| POST | /api/managed_users/:managed_user_id/export_manifests | Create an export manifest. |
| PUT | /api/managed_users/:managed_user_id/export_manifests/:id | Update an export manifest. |
| GET | /api/managed_users/:managed_user_id/export_manifests/:id | View an export manifest. |
| DELETE | /api/managed_users/:managed_user_id/export_manifests/:id | Delete an export manifest. |
| POST | /api/managed_users/:managed_user_id/imports | Import a package into a folder located in a customer workspace. |
| GET | /api/managed_users/:managed_user_id/recipes | Get status of an imported package. |
| POST | /api/managed_users/:managed_user_id/exports/:manifest_id | Export package based on the manifest ID. Requires an Embedded workspace. |
| GET | /api/managed_users/:managed_user_id/exports/:package_id | Returns the status of a package export. Requires an Embedded workspace. |
Role migration
| Type | Resource | Description |
|---|---|---|
| POST | /api/managed_users/:managed_user_id/roles_migration/system_roles | Migrate system roles from a customer workspace. |
| POST | /api/managed_users/:managed_user_id/roles_migration/custom_role | Migrate a custom role from a customer workspace. |
Tag assignments
| Type | Resource | Description |
|---|---|---|
| POST | /api/v2/managed_users/:id/tags_assignments | Apply or remove asset tags in a customer workspace. |
Test Automation
| Type | Resource | Description |
|---|---|---|
| POST | /api/managed_users/:managed_user_id/test_cases/run_requests | Run test cases in a customer workspace. |
| GET | /api/managed_users/:managed_user_id/recipes/:recipe_id/test_cases | List test cases for a specific recipe in a customer workspace. |
| GET | /api/managed_users/:managed_user_id/test_cases/run_requests/:test_id | Get the current state of a test case run request in a customer workspace. |
Last updated: