Need help with your APIs? I offer API discovery, governance & evangelism services. Explore services →
API Evangelist API Evangelist
Discovery
Learnings
Guidance
Toolbox
Alignment
API Evangelist LLC

Workato Genies API

AI agents (genies) that can be configured with skills, knowledge bases, and instructions to automate complex workflows.

Workato Genies API is one of 11 APIs that Workato publishes on the APIs.io network, described by a machine-readable OpenAPI specification and an AsyncAPI event-driven specification.

This API exposes 2 JSON Schema definitions.

Tagged areas include Genies. The published artifact set on APIs.io includes an OpenAPI specification, API documentation, authentication docs, an API reference, rate-limit docs, an AsyncAPI specification, and 2 JSON Schemas.

This API exposes 13 operations across 10 paths, and defines 8 schemas. It is described by OpenAPI 3.1.0, at version 1.0.

Requests are made against 5 base URLs: https://www.workato.com, https://app.eu.workato.com, https://app.jp.workato.com, https://app.sg.workato.com, https://app.au.workato.com.

13 operations 10 paths 8 schemas 1 DELETE2 GET9 POST1 PUT

Metadata

The identity and technical contract details declared by the specification.

Specification
OpenAPI 3.1.0
API Version
1.0
Servers
https://www.workato.com
https://app.eu.workato.com
https://app.jp.workato.com
https://app.sg.workato.com
https://app.au.workato.com
Authentication
HTTP Bearer
Terms of Service
Resource Areas
1

Authentication & Security 1

Workato Genies API declares 1 security scheme for authenticating requests. It accepts HTTP bearer tokens (bearerAuth). By default, every request must be authenticated.

  • bearerAuth — API client token obtained from the Workato platform. Include as Authorization: Bearer {token}.

Paths & Operations 13

Across 10 paths, the API surfaces 13 operations — 1 DELETE, 2 GET, 9 POST, 1 PUT. Each is listed below with its method, path, parameters, and response codes.

Genies 13

AI agents (genies) that can be configured with skills, knowledge bases, and instructions to automate complex workflows.

GET
/api/agentic/genies
Workato List Genies
listGenies 5 params → 200401
POST
/api/agentic/genies
Workato Create a Genie
createGenie body → 200400401
GET
/api/agentic/genies/{id}
Workato Get a Genie
getGenie 1 param → 200401404
PUT
/api/agentic/genies/{id}
Workato Update a Genie
updateGenie 1 param body → 200400401404
DELETE
/api/agentic/genies/{id}
Workato Delete a Genie
deleteGenie 1 param → 200401404
POST
/api/agentic/genies/{id}/start
Workato Start a Genie
startGenie 1 param → 200401404
POST
/api/agentic/genies/{id}/stop
Workato Stop a Genie
stopGenie 1 param → 200401404
POST
/api/agentic/genies/{id}/assign_skills
Workato Assign Skills to a Genie
assignSkillsToGenie 1 param body → 200401404
POST
/api/agentic/genies/{id}/remove_skills
Workato Remove Skills from a Genie
removeSkillsFromGenie 1 param body → 200401404
POST
/api/agentic/genies/{id}/assign_knowledge_bases
Workato Assign Knowledge Bases to a Genie
assignKnowledgeBasesToGenie 1 param body → 200401404
POST
/api/agentic/genies/{id}/remove_knowledge_bases
Workato Remove Knowledge Bases from a Genie
removeKnowledgeBasesFromGenie 1 param body → 200401404
POST
/api/agentic/genies/{id}/assign_user_groups
Workato Assign User Groups to a Genie
assignUserGroupsToGenie 1 param body → 200401404
POST
/api/agentic/genies/{id}/remove_user_groups
Workato Remove User Groups from a Genie
removeUserGroupsFromGenie 1 param body → 200401404

Schemas 8

The contract defines 8 schemas that model the data the API accepts and returns. The most detailed are Genie (9 properties), GenieInput (8 properties), KnowledgeBase (8 properties), Skill (7 properties). Each schema is shown below with its type and property counts.

DataSource
object
A data source configuration for a knowledge base.
4 properties
UserGroup
object
An identity provider user group for access control.
2 properties
SuccessResponse
object
Standard success response.
1 property
GenieInput
object
Input schema for creating or updating a genie.
8 properties
Skill
object
A recipe-backed capability that can be assigned to an AI agent as a tool.
7 properties
KnowledgeBase
object
A collection of data sources that provides contextual information to AI agents.
8 properties
ErrorResponse
object
Standard error response.
2 properties
Genie
object
An AI agent configured to handle automated tasks using skills and knowledge bases.
9 properties

Specification

The full machine-readable OpenAPI contract behind this narrative.

Source

workato-genies-api-openapi.yml Raw ↑

Other APIs Workato publishes across the network.

Workato Embedded Partner API
Workato Data Tables API
Workato Knowledge Bases API
Workato MCP Servers API
Workato Messages API
Workato Policies API
Workato Recipes API
Workato Skills API
Workato Tools API
Workato User Groups API