# Workato API Resources
# API clients
| Type | Resource | Description |
|---|---|---|
| GET | /api/developer_api_clients | List Developer API Clients. |
| POST | /api/developer_api_clients | Create a Developer API Client. |
| GET | /api/developer_api_clients/:id | Get a Developer API Client by ID. |
| PUT | /api/developer_api_clients/:id | Update a Developer API Clients. |
| DELETE | /api/developer_api_clients/:id | Delete a Developer API Client. |
| POST | /api/developer_api_clients/:id/regenerate | Regenerate a Developer API Client token. |
| GET | /api/developer_api_client_roles | List Developer API Client roles. |
# API Platform
| Type | Resource | Description |
|---|---|---|
| GET | /api/api_collections | List API collections. |
| POST | /api/api_collections | Create an API collection. |
| GET | /api/api_endpoints | List API endpoints in a collection. |
| PUT | /api/api_endpoints/:id/enable | Enable an API endpoint in a collection. |
| PUT | /api/api_endpoints/:id/disable | Disable an API endpoint in a collection. |
| GET | /api/api_clients | List API clients. |
| POST | /api/api_clients | Create an API client. |
| GET | /api/api_access_profiles | List access profiles belonging to an API client. |
| POST | /api/api_access_profiles | Create an access profile belonging to an API client. |
| PUT | /api/api_access_profiles | Update an access profile belonging to an API client. |
| PUT | /api_access_profiles | Enable an access profile belonging to an API client. |
| PUT | /api_access_profiles | Disable an access profile belonging to an API client. |
| PUT | /api/api_access_profiles/:id/refresh_secret | Refreshes access profile token or secret. |
# Connections
| Type | Resource | Description |
|---|---|---|
| GET | /api/connections | List connections belonging to user. |
# Custom connectors
| Type | Resource | Description |
|---|---|---|
| GET | /api/custom_connectors | Get custom connectors. |
| POST | /api/sdk/generate_schema/json | Generates Workato schema from a stringified JSON sample. |
| POST | /api/sdk/generate_schema/csv | Generates Workato schema from a stringified CSV sample. |
# Custom OAuth profiles
| Type | Resource | Description |
|---|---|---|
| GET | /api/custom_oauth_profiles | List Custom OAuth profiles |
| GET | /api/custom_oauth_profiles/:id | Get Custom OAuth profile by ID |
| POST | /api/custom_oauth_profiles | Create Custom OAuth profile |
| PUT | /api/custom_oauth_profiles/:id | Update Custom OAuth profile |
| DELETE | /api/custom_oauth_profiles/:id | Delete Custom OAuth profile |
# Environment properties
| Type | Resource | Description |
|---|---|---|
| GET | /api/properties | Lists environment properties that matches a prefix. |
| POST | /api/properties | Upserts environment properties. |
# Folders
| Type | Resource | Description |
|---|---|---|
| GET | /api/folders | List folders. |
| GET | /api/projects | List projects. |
| POST | /api/folders | Create a folder. |
# Jobs
| Type | Resource | Description |
|---|---|---|
| GET | /api/recipes/:recipe_id/jobs | List jobs belonging to recipe. |
| GET | /api/recipes/:recipe_id/jobs/:job_handle | Returns a single job's metadata. |
# Lookup tables
| Type | Resource | Description |
|---|---|---|
| GET | /api/lookup_tables | List tables. |
| GET | /api/lookup_tables/:lookup_table_id/lookup | Look up a row |
| GET | /api/lookup_tables/:lookup_table_id/rows | List rows. |
| GET | /api/lookup_tables/:lookup_table_id/rows/:row_id | Get a row. |
| POST | /api/lookup_tables/:lookup_table_id/rows | Add a row. |
| POST | /api/lookup_tables | Create a new lookup table. |
| POST | /api/lookup_tables/batch_delete | Delete lookup tables in batch. |
| PUT | /api/lookup_tables/:lookup_table_id/rows/:row_id | Update a row. |
| DELETE | /api/lookup_tables/:lookup_table_id/rows/:row_id | Delete a row. |
# Projects
| Type | Resource | Description |
|---|---|---|
| POST | /api/projects/:id/build | Builds a project. Use the Deploy a project build endpoint to deploy the project to an environment. |
| GET | /api/project_builds/:id | Retrieves a project build by its unique ID. |
| POST | /api/project_builds/:id/deploy?environment_type=:environment_type | Deploys a project build to an environment. Use the Build a project endpoint to build the project first. |
| POST | /api/projects/:id/deploy?environment_type=:environment_type | Builds and deploys a project to an environment. |
| GET | /api/deployments/:id | Retrieves a single deployment by its unique ID. |
| GET | /api/deployments | Retrieves a list of deployments. Query parameters may be used to filter results to a specific project, folder, date range, etc. |
# Project properties
| Type | Resource | Description |
|---|---|---|
| GET | /api/properties | List project-level properties that match a prefix and project ID. |
| POST | /api/properties | Upsert project-level properties. |
# PubSub
| Type | Resource | Description |
|---|---|---|
| POST | event-streams.workato.com/api/v1/topics/:topic_id/consume | Consume messages from a topic. |
| POST | event-streams.workato.com/api/v1/topics/:topic_id/publish | Publish a message to a topic. |
| POST | event-streams.workato.com/api/v1/batch/topics/:topic_id/publish | Publish a batch of messages to a topic. |
# Recipes
| Type | Resource | Description |
|---|---|---|
| GET | /api/recipes/:id | Get recipe details. |
| POST | /api/recipes | Create recipe. |
| POST | /api/recipes | Copy recipe. |
| PUT | /api/recipes/:id | Update recipe. |
| GET | /api/recipes | List recipes belonging to user. |
| PUT | /api/recipes/:id/start | Start recipe. |
| PUT | /api/recipes/:id/stop | Stop recipe. |
| DELETE | /api/recipes/:id | Delete recipe. |
# Recipe Lifecycle Management
| Type | Resource | Description |
|---|---|---|
| POST | api/export_manifests | Create an export manifest. |
| PUT | api/export_manifests/:id | Update an export manifest. |
| GET | api/export_manifests/:id | View an export manifest. |
| POST | /api/packages/export/:manifest_id | Export package based on a manifest. |
| POST | /api/packages/import/:folder_id | Import package into a folder. |
| GET | /api/packages/:id | Get package by ID. |
| GET | /api/packages/:id/download | Download package. |
# Roles
| Type | Resource | Description |
|---|---|---|
| GET | /api/roles | List custom roles. |
| POST | /api/roles/:role_id/copy | Makes a copy of a custom role. |
# Secrets management
| Type | Resource | Description |
|---|---|---|
| POST | /api/secrets_management/clear_cache | Clears the secrets management cache. |
# Team collaborators
| Type | Resource | Description |
|---|---|---|
| POST | /api/member_invitations | Invites a collaborator to your team. |
# Test Automation
| Type | Resource | Description |
|---|---|---|
| POST | /api/test_cases/run_requests | Run test cases. |
| GET | /api/test_cases/run_requests/{id} | Get the current state of a test case run request. |
| GET | /api/recipes/{recipe_id}/test_cases | Get test cases. |
# Users
| Type | Resource | Description |
|---|---|---|
| GET | /api/users/me | Get details of authenticated user. |
Last updated: 11/17/2023, 3:05:45 PM