naftiko: 1.0.0-alpha2
info:
  label: Workato Agent Studio API — Genies
  description: 'Workato Agent Studio API — Genies. 13 operations. Lead operation: Workato List Genies. Self-contained Naftiko
    capability covering one Workato business surface.'
  tags:
  - Workato
  - Genies
  created: '2026-05-19'
  modified: '2026-05-19'
binds:
- namespace: env
  keys:
    WORKATO_API_KEY: WORKATO_API_KEY
capability:
  consumes:
  - type: http
    namespace: agent-studio-genies
    baseUri: https://www.workato.com
    description: Workato Agent Studio API — Genies business capability. Self-contained, no shared references.
    resources:
    - name: api-agentic-genies
      path: /api/agentic/genies
      operations:
      - name: listgenies
        method: GET
        description: Workato List Genies
        outputRawFormat: json
        outputParameters:
        - name: result
          type: object
          value: $.
        inputParameters:
        - name: state
          in: query
          type: string
          description: Filter genies by their current state.
      - name: creategenie
        method: POST
        description: Workato Create a Genie
        outputRawFormat: json
        outputParameters:
        - name: result
          type: object
          value: $.
        inputParameters:
        - name: body
          in: body
          type: object
          description: Request body (JSON).
          required: true
    - name: api-agentic-genies-id
      path: /api/agentic/genies/{id}
      operations:
      - name: getgenie
        method: GET
        description: Workato Get a Genie
        outputRawFormat: json
        outputParameters:
        - name: result
          type: object
          value: $.
      - name: updategenie
        method: PUT
        description: Workato Update a Genie
        outputRawFormat: json
        outputParameters:
        - name: result
          type: object
          value: $.
        inputParameters:
        - name: body
          in: body
          type: object
          description: Request body (JSON).
          required: true
      - name: deletegenie
        method: DELETE
        description: Workato Delete a Genie
        outputRawFormat: json
        outputParameters:
        - name: result
          type: object
          value: $.
    - name: api-agentic-genies-id-assign_knowledge_bases
      path: /api/agentic/genies/{id}/assign_knowledge_bases
      operations:
      - name: assignknowledgebasestogenie
        method: POST
        description: Workato Assign Knowledge Bases to a Genie
        outputRawFormat: json
        outputParameters:
        - name: result
          type: object
          value: $.
        inputParameters:
        - name: body
          in: body
          type: object
          description: Request body (JSON).
          required: true
    - name: api-agentic-genies-id-assign_skills
      path: /api/agentic/genies/{id}/assign_skills
      operations:
      - name: assignskillstogenie
        method: POST
        description: Workato Assign Skills to a Genie
        outputRawFormat: json
        outputParameters:
        - name: result
          type: object
          value: $.
        inputParameters:
        - name: body
          in: body
          type: object
          description: Request body (JSON).
          required: true
    - name: api-agentic-genies-id-assign_user_groups
      path: /api/agentic/genies/{id}/assign_user_groups
      operations:
      - name: assignusergroupstogenie
        method: POST
        description: Workato Assign User Groups to a Genie
        outputRawFormat: json
        outputParameters:
        - name: result
          type: object
          value: $.
        inputParameters:
        - name: body
          in: body
          type: object
          description: Request body (JSON).
          required: true
    - name: api-agentic-genies-id-remove_knowledge_bases
      path: /api/agentic/genies/{id}/remove_knowledge_bases
      operations:
      - name: removeknowledgebasesfromgenie
        method: POST
        description: Workato Remove Knowledge Bases from a Genie
        outputRawFormat: json
        outputParameters:
        - name: result
          type: object
          value: $.
        inputParameters:
        - name: body
          in: body
          type: object
          description: Request body (JSON).
          required: true
    - name: api-agentic-genies-id-remove_skills
      path: /api/agentic/genies/{id}/remove_skills
      operations:
      - name: removeskillsfromgenie
        method: POST
        description: Workato Remove Skills from a Genie
        outputRawFormat: json
        outputParameters:
        - name: result
          type: object
          value: $.
        inputParameters:
        - name: body
          in: body
          type: object
          description: Request body (JSON).
          required: true
    - name: api-agentic-genies-id-remove_user_groups
      path: /api/agentic/genies/{id}/remove_user_groups
      operations:
      - name: removeusergroupsfromgenie
        method: POST
        description: Workato Remove User Groups from a Genie
        outputRawFormat: json
        outputParameters:
        - name: result
          type: object
          value: $.
        inputParameters:
        - name: body
          in: body
          type: object
          description: Request body (JSON).
          required: true
    - name: api-agentic-genies-id-start
      path: /api/agentic/genies/{id}/start
      operations:
      - name: startgenie
        method: POST
        description: Workato Start a Genie
        outputRawFormat: json
        outputParameters:
        - name: result
          type: object
          value: $.
    - name: api-agentic-genies-id-stop
      path: /api/agentic/genies/{id}/stop
      operations:
      - name: stopgenie
        method: POST
        description: Workato Stop a Genie
        outputRawFormat: json
        outputParameters:
        - name: result
          type: object
          value: $.
    authentication:
      type: bearer
      token: '{{env.WORKATO_API_KEY}}'
  exposes:
  - type: rest
    namespace: agent-studio-genies-rest
    port: 8080
    description: REST adapter for Workato Agent Studio API — Genies. One Spectral-compliant resource per consumed operation,
      prefixed with /v1.
    resources:
    - path: /v1/api/agentic/genies
      name: api-agentic-genies
      description: REST surface for api-agentic-genies.
      operations:
      - method: GET
        name: listgenies
        description: Workato List Genies
        call: agent-studio-genies.listgenies
        with:
          state: rest.state
        outputParameters:
        - type: object
          mapping: $.
      - method: POST
        name: creategenie
        description: Workato Create a Genie
        call: agent-studio-genies.creategenie
        with:
          body: rest.body
        outputParameters:
        - type: object
          mapping: $.
    - path: /v1/api/agentic/genies/{id}
      name: api-agentic-genies-id
      description: REST surface for api-agentic-genies-id.
      operations:
      - method: GET
        name: getgenie
        description: Workato Get a Genie
        call: agent-studio-genies.getgenie
        outputParameters:
        - type: object
          mapping: $.
      - method: PUT
        name: updategenie
        description: Workato Update a Genie
        call: agent-studio-genies.updategenie
        with:
          body: rest.body
        outputParameters:
        - type: object
          mapping: $.
      - method: DELETE
        name: deletegenie
        description: Workato Delete a Genie
        call: agent-studio-genies.deletegenie
        outputParameters:
        - type: object
          mapping: $.
    - path: /v1/api/agentic/genies/{id}/assign-knowledge-bases
      name: api-agentic-genies-id-assign-knowledge-bases
      description: REST surface for api-agentic-genies-id-assign_knowledge_bases.
      operations:
      - method: POST
        name: assignknowledgebasestogenie
        description: Workato Assign Knowledge Bases to a Genie
        call: agent-studio-genies.assignknowledgebasestogenie
        with:
          body: rest.body
        outputParameters:
        - type: object
          mapping: $.
    - path: /v1/api/agentic/genies/{id}/assign-skills
      name: api-agentic-genies-id-assign-skills
      description: REST surface for api-agentic-genies-id-assign_skills.
      operations:
      - method: POST
        name: assignskillstogenie
        description: Workato Assign Skills to a Genie
        call: agent-studio-genies.assignskillstogenie
        with:
          body: rest.body
        outputParameters:
        - type: object
          mapping: $.
    - path: /v1/api/agentic/genies/{id}/assign-user-groups
      name: api-agentic-genies-id-assign-user-groups
      description: REST surface for api-agentic-genies-id-assign_user_groups.
      operations:
      - method: POST
        name: assignusergroupstogenie
        description: Workato Assign User Groups to a Genie
        call: agent-studio-genies.assignusergroupstogenie
        with:
          body: rest.body
        outputParameters:
        - type: object
          mapping: $.
    - path: /v1/api/agentic/genies/{id}/remove-knowledge-bases
      name: api-agentic-genies-id-remove-knowledge-bases
      description: REST surface for api-agentic-genies-id-remove_knowledge_bases.
      operations:
      - method: POST
        name: removeknowledgebasesfromgenie
        description: Workato Remove Knowledge Bases from a Genie
        call: agent-studio-genies.removeknowledgebasesfromgenie
        with:
          body: rest.body
        outputParameters:
        - type: object
          mapping: $.
    - path: /v1/api/agentic/genies/{id}/remove-skills
      name: api-agentic-genies-id-remove-skills
      description: REST surface for api-agentic-genies-id-remove_skills.
      operations:
      - method: POST
        name: removeskillsfromgenie
        description: Workato Remove Skills from a Genie
        call: agent-studio-genies.removeskillsfromgenie
        with:
          body: rest.body
        outputParameters:
        - type: object
          mapping: $.
    - path: /v1/api/agentic/genies/{id}/remove-user-groups
      name: api-agentic-genies-id-remove-user-groups
      description: REST surface for api-agentic-genies-id-remove_user_groups.
      operations:
      - method: POST
        name: removeusergroupsfromgenie
        description: Workato Remove User Groups from a Genie
        call: agent-studio-genies.removeusergroupsfromgenie
        with:
          body: rest.body
        outputParameters:
        - type: object
          mapping: $.
    - path: /v1/api/agentic/genies/{id}/start
      name: api-agentic-genies-id-start
      description: REST surface for api-agentic-genies-id-start.
      operations:
      - method: POST
        name: startgenie
        description: Workato Start a Genie
        call: agent-studio-genies.startgenie
        outputParameters:
        - type: object
          mapping: $.
    - path: /v1/api/agentic/genies/{id}/stop
      name: api-agentic-genies-id-stop
      description: REST surface for api-agentic-genies-id-stop.
      operations:
      - method: POST
        name: stopgenie
        description: Workato Stop a Genie
        call: agent-studio-genies.stopgenie
        outputParameters:
        - type: object
          mapping: $.
  - type: mcp
    namespace: agent-studio-genies-mcp
    port: 9090
    transport: http
    description: MCP adapter for Workato Agent Studio API — Genies. One tool per consumed operation, routed inline through
      this capability's consumes block.
    tools:
    - name: workato-list-genies
      description: Workato List Genies
      hints:
        readOnly: true
        destructive: false
        idempotent: true
      call: agent-studio-genies.listgenies
      with:
        state: tools.state
      outputParameters:
      - type: object
        mapping: $.
    - name: workato-create-genie
      description: Workato Create a Genie
      hints:
        readOnly: false
        destructive: false
        idempotent: false
      call: agent-studio-genies.creategenie
      with:
        body: tools.body
      outputParameters:
      - type: object
        mapping: $.
    - name: workato-get-genie
      description: Workato Get a Genie
      hints:
        readOnly: true
        destructive: false
        idempotent: true
      call: agent-studio-genies.getgenie
      outputParameters:
      - type: object
        mapping: $.
    - name: workato-update-genie
      description: Workato Update a Genie
      hints:
        readOnly: false
        destructive: false
        idempotent: true
      call: agent-studio-genies.updategenie
      with:
        body: tools.body
      outputParameters:
      - type: object
        mapping: $.
    - name: workato-delete-genie
      description: Workato Delete a Genie
      hints:
        readOnly: false
        destructive: true
        idempotent: true
      call: agent-studio-genies.deletegenie
      outputParameters:
      - type: object
        mapping: $.
    - name: workato-assign-knowledge-bases-genie
      description: Workato Assign Knowledge Bases to a Genie
      hints:
        readOnly: false
        destructive: false
        idempotent: false
      call: agent-studio-genies.assignknowledgebasestogenie
      with:
        body: tools.body
      outputParameters:
      - type: object
        mapping: $.
    - name: workato-assign-skills-genie
      description: Workato Assign Skills to a Genie
      hints:
        readOnly: false
        destructive: false
        idempotent: false
      call: agent-studio-genies.assignskillstogenie
      with:
        body: tools.body
      outputParameters:
      - type: object
        mapping: $.
    - name: workato-assign-user-groups-genie
      description: Workato Assign User Groups to a Genie
      hints:
        readOnly: false
        destructive: false
        idempotent: false
      call: agent-studio-genies.assignusergroupstogenie
      with:
        body: tools.body
      outputParameters:
      - type: object
        mapping: $.
    - name: workato-remove-knowledge-bases-genie
      description: Workato Remove Knowledge Bases from a Genie
      hints:
        readOnly: false
        destructive: false
        idempotent: false
      call: agent-studio-genies.removeknowledgebasesfromgenie
      with:
        body: tools.body
      outputParameters:
      - type: object
        mapping: $.
    - name: workato-remove-skills-genie
      description: Workato Remove Skills from a Genie
      hints:
        readOnly: false
        destructive: false
        idempotent: false
      call: agent-studio-genies.removeskillsfromgenie
      with:
        body: tools.body
      outputParameters:
      - type: object
        mapping: $.
    - name: workato-remove-user-groups-genie
      description: Workato Remove User Groups from a Genie
      hints:
        readOnly: false
        destructive: false
        idempotent: false
      call: agent-studio-genies.removeusergroupsfromgenie
      with:
        body: tools.body
      outputParameters:
      - type: object
        mapping: $.
    - name: workato-start-genie
      description: Workato Start a Genie
      hints:
        readOnly: false
        destructive: false
        idempotent: false
      call: agent-studio-genies.startgenie
      outputParameters:
      - type: object
        mapping: $.
    - name: workato-stop-genie
      description: Workato Stop a Genie
      hints:
        readOnly: false
        destructive: false
        idempotent: false
      call: agent-studio-genies.stopgenie
      outputParameters:
      - type: object
        mapping: $.