Cisco Crosswork Workflow API

The workflow API from Cisco Crosswork — 8 operation(s) for workflow.

Operations 13

GET /workflow List workflows. #
POST /workflow Add a new workflow. #
DELETE /workflow/name/{workflowName}/version/{workflowVersion} Delete a workflow by name and version. #
GET /workflow/name/{workflowName}/version/{workflowVersion} Get a workflow by name and version. #
PUT /workflow/name/{workflowName}/version/{workflowVersion} Update a workflow by name and version. #
POST /workflow/name/{workflowName}/version/{workflowVersion}/validateInputData Validate workflow input data. #
GET /workflow/tags List all workflow tags. #
POST /workflow/validate Validate a workflow. #
DELETE /workflow/{workflowId} Delete a workflow by UUID. #
GET /workflow/{workflowId} Get a workflow by UUID. #
PUT /workflow/{workflowId} Update a workflow by UUID. #
POST /workflowExport Export workflow definitions. #
POST /workflowImport Import workflow definitions. #

Work with this as data

Every API here is available over the APIs.io API and to AI agents over MCP.

MCP server

One button, every client — Claude, Cursor, VS Code and the rest.

https://apis.io/mcp

Tools for apis

7 MCP tools reach this
  • find_apisBrowse and filter every API in the catalog.
  • get_api_artifactsOne API's artifacts, grouped by type.
  • get_openapiThe primary OpenAPI for this API.
  • find_similar_apisAPIs that look like this one.
  • apis_io_searchSTART HERE — APIs, providers and tags for one query, each with its total.
  • resolveTurn a domain, URL or GitHub org into the provider it belongs to.
  • find_cohortsEvery scored population of providers in the catalog.
All 92 tools →

Call it yourself

curl for this page
This API
curl "https://apis.io/api/v1/apis/cisco-crosswork-workflow-api"
All apis
curl "https://apis.io/api/v1/apis?limit=25"

Discovery needs no key. Ratings and market analysis are Pro.

Get an API key

Free tier, no form to fill in. Signing in shares your email address with us — we store it to create your key and to recognise you if you sign in with another provider. See our Privacy Policy and Terms.

A second provider on the same verified email joins the account you already have.

OpenAPI Specification

cisco-crosswork-workflow-api-openapi.yml Raw ↑
openapi: 3.2.0
info:
  title: Cisco Crosswork Manager Workflows Workflow API
  description: Cisco Crosswork Workflow Manager (CWM) 2.1 offers RESTful APIs that enable automation engineers and developers to create, deploy, and manage workflows, adapters, jobs, resources, events, and workers within the Cisco CWM platform.
  version: 2.1.0
  termsOfService: https://www.cisco.com/c/en/us/about/legal/terms-conditions.html
  contact:
    name: API Support
    url: https://www.cisco.com/support
  x-provenance:
    method: harvested
    authored_by: Cisco Crosswork
    harvested_by: API Evangelist
    harvested_on: '2026-08-19'
    first_party: true
    provider_published: true
    note: Refined from Cisco's own Crosswork Workflow Manager 2.1 Swagger 2.0 reference (see openapi/_original/cisco-crosswork-cwm-workflow-manager-openapi.json). Converted to OpenAPI 3.2.0 and split by tag; operationIds absent from Cisco's source were synthesised deterministically from method+path.
  x-evidence:
  - type: source
    url: https://developer.cisco.com/docs/crosswork/workflow-manager/
  - type: raw
    url: https://pubhub.devnetcloud.com/media/crosswork-workflow-manager-api-document/docs/262737b2-b3c2-32cd-b07b-fdbdcd23918f/apis/
servers:
- url: /crosswork/cwm/v2
  description: Relative to the customer-deployed Crosswork Workflow Manager host (https://{cwm-host}:{port})
security:
- Bearer: []
tags:
- name: workflow
paths:
  /workflow:
    get:
      summary: List workflows.
      description: Retrieve a list of workflows from the application's database, optionally filtered by tags.
      operationId: list_workflows
      tags:
      - workflow
      parameters:
      - name: tags
        in: query
        description: Tags to filter workflows.
        required: false
        schema:
          type: array
          items:
            type: string
      responses:
        '200':
          description: Workflows retrieved successfully.
          content:
            application/json:
              schema:
                type: array
                items:
                  $ref: '#/components/schemas/models.Workflow'
        '400':
          description: Bad request.
          content:
            application/json:
              schema:
                type: string
      security:
      - Bearer: []
    post:
      summary: Add a new workflow.
      description: Add a new workflow to the application database.
      operationId: create_workflow
      tags:
      - workflow
      requestBody:
        description: Workflow details to add.
        required: true
        content:
          application/json:
            schema:
              $ref: '#/components/schemas/server.WorkflowAttributes'
      responses:
        '200':
          description: Workflow UUID generated successfully.
          content:
            application/json:
              schema:
                type: string
        '400':
          description: Bad request.
          content:
            application/json:
              schema:
                type: string
      security:
      - Bearer: []
  /workflow/name/{workflowName}/version/{workflowVersion}:
    delete:
      summary: Delete a workflow by name and version.
      description: Delete a specific workflow by its name and version from the application database.
      operationId: delete_workflow_by_name_version
      tags:
      - workflow
      parameters:
      - name: workflowName
        in: path
        description: Workflow name.
        required: true
        schema:
          type: string
      - name: workflowVersion
        in: path
        description: Workflow version.
        required: true
        schema:
          type: string
      responses:
        '200':
          description: Workflow deleted successfully.
          content:
            application/json:
              schema:
                type: string
        '400':
          description: Bad request.
          content:
            application/json:
              schema:
                type: string
      security:
      - Bearer: []
    get:
      summary: Get a workflow by name and version.
      description: Retrieve a specific workflow by its name and version from the application database.
      operationId: get_workflow_by_name_version
      tags:
      - workflow
      parameters:
      - name: workflowName
        in: path
        description: Workflow name.
        required: true
        schema:
          type: string
      - name: workflowVersion
        in: path
        description: Workflow version.
        required: true
        schema:
          type: string
      responses:
        '200':
          description: Workflow retrieved successfully.
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/server.WorkflowGetResponse'
        '400':
          description: Bad request.
          content:
            application/json:
              schema:
                type: string
      security:
      - Bearer: []
    put:
      summary: Update a workflow by name and version.
      description: Update an existing workflow by its name and version in the application database.
      operationId: update_workflow_by_name_version
      tags:
      - workflow
      parameters:
      - name: workflowName
        in: path
        description: Workflow name.
        required: true
        schema:
          type: string
      - name: workflowVersion
        in: path
        description: Workflow version.
        required: true
        schema:
          type: string
      requestBody:
        description: Updated workflow details.
        required: true
        content:
          application/json:
            schema:
              $ref: '#/components/schemas/server.WorkflowAttributes'
      responses:
        '200':
          description: Workflow updated successfully.
          content:
            application/json:
              schema:
                type: string
        '400':
          description: Bad request.
          content:
            application/json:
              schema:
                type: string
      security:
      - Bearer: []
  /workflow/name/{workflowName}/version/{workflowVersion}/validateInputData:
    post:
      summary: Validate workflow input data.
      description: Validate whether the input data provided is valid for the specified workflow.
      operationId: validate_workflow_input
      tags:
      - workflow
      parameters:
      - name: workflowName
        in: path
        description: Workflow name.
        required: true
        schema:
          type: string
      - name: workflowVersion
        in: path
        description: Workflow version.
        required: true
        schema:
          type: string
      requestBody:
        description: Input data to validate.
        required: true
        content:
          application/json:
            schema:
              $ref: '#/components/schemas/server.InputSchemaVadation'
      responses:
        '200':
          description: Input data validation successful.
          content:
            application/json:
              schema:
                type: string
        '400':
          description: Bad request.
          content:
            application/json:
              schema:
                type: string
      security:
      - Bearer: []
  /workflow/tags:
    get:
      summary: List all workflow tags.
      description: Retrieve a list of all workflow tags from the application database.
      operationId: list_workflow_tags
      tags:
      - workflow
      responses:
        '200':
          description: Workflow tags retrieved successfully.
          content:
            application/json:
              schema:
                type: array
                items:
                  type: string
        '400':
          description: Bad request.
          content:
            application/json:
              schema:
                type: string
      security:
      - Bearer: []
  /workflow/validate:
    post:
      summary: Validate a workflow.
      description: Validate whether a workflow definition is valid.
      operationId: validate_workflow
      tags:
      - workflow
      requestBody:
        description: Workflow definition to validate.
        required: true
        content:
          application/json:
            schema:
              $ref: '#/components/schemas/server.WorkflowDefinition'
      responses:
        '200':
          description: Workflow validation successful.
          content:
            application/json:
              schema:
                type: string
        '400':
          description: Bad request.
          content:
            application/json:
              schema:
                type: string
      security:
      - Bearer: []
  /workflow/{workflowId}:
    delete:
      summary: Delete a workflow by UUID.
      description: Delete a workflow from the application database by its UUID.
      operationId: delete_workflow
      tags:
      - workflow
      parameters:
      - name: workflowId
        in: path
        description: Workflow UUID.
        required: true
        schema:
          type: string
      responses:
        '200':
          description: Workflow deleted successfully.
          content:
            application/json:
              schema:
                type: string
        '400':
          description: Bad request.
          content:
            application/json:
              schema:
                type: string
      security:
      - Bearer: []
    get:
      summary: Get a workflow by UUID.
      description: Retrieve a workflow from the application database by its UUID.
      operationId: get_workflow_by_id
      tags:
      - workflow
      parameters:
      - name: workflowId
        in: path
        description: Workflow UUID.
        required: true
        schema:
          type: string
      responses:
        '200':
          description: Workflow retrieved successfully.
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/server.WorkflowGetResponse'
        '400':
          description: Bad request.
          content:
            application/json:
              schema:
                type: string
      security:
      - Bearer: []
    put:
      summary: Update a workflow by UUID.
      description: Update an existing workflow in the application database by its UUID.
      operationId: update_workflow_by_id
      tags:
      - workflow
      parameters:
      - name: workflowId
        in: path
        description: Workflow UUID.
        required: true
        schema:
          type: string
      requestBody:
        description: Updated workflow details.
        required: true
        content:
          application/json:
            schema:
              $ref: '#/components/schemas/server.WorkflowAttributes'
      responses:
        '200':
          description: Workflow updated successfully.
          content:
            application/json:
              schema:
                type: string
        '400':
          description: Bad request.
          content:
            application/json:
              schema:
                type: string
      security:
      - Bearer: []
  /workflowExport:
    post:
      summary: Export workflow definitions.
      description: Export workflow definitions using name and version. An empty request body exports all workflows.
      operationId: export_workflows
      tags:
      - workflow
      requestBody:
        description: Workflow export request details.
        required: true
        content:
          application/json:
            schema:
              type: array
              items:
                $ref: '#/components/schemas/repository.NameVersion'
      responses:
        '200':
          description: Workflows exported successfully.
          content:
            application/json:
              schema:
                type: array
                items:
                  $ref: '#/components/schemas/models.Workflow'
        '400':
          description: Bad request.
          content:
            application/json:
              schema:
                type: string
      security:
      - Bearer: []
  /workflowImport:
    post:
      summary: Import workflow definitions.
      description: Import workflows into the application database.
      operationId: import_workflows
      tags:
      - workflow
      requestBody:
        description: Workflow definitions to import.
        required: true
        content:
          application/json:
            schema:
              type: array
              items:
                $ref: '#/components/schemas/server.WorkflowAttributes'
      responses:
        '200':
          description: Workflows imported successfully.
          content:
            application/json:
              schema:
                type: string
        '400':
          description: Bad request.
          content:
            application/json:
              schema:
                type: string
      security:
      - Bearer: []
components:
  schemas:
    server.WorkflowDefinition:
      type: object
      properties:
        definition:
          type: object
    server.WorkflowAttributes:
      type: object
      properties:
        definition:
          type: object
        formId:
          type: string
        path:
          type: string
        wfTags:
          type: array
          items:
            type: string
    repository.NameVersion:
      type: object
      required:
      - name
      - version
      properties:
        name:
          type: string
        version:
          type: string
    server.WorkflowGetResponse:
      type: object
      properties:
        workflow:
          $ref: '#/components/schemas/models.Workflow'
    models.Workflow:
      type: object
      properties:
        createdAt:
          type: string
          format: date-time
        definition:
          type: object
        description:
          type: string
        formId:
          type: string
        hashSum:
          type: string
        name:
          type: string
        path:
          type: string
        updatedAt:
          type: string
          format: date-time
        version:
          type: string
        wfTags:
          type: array
          items:
            type: string
        workflowId:
          type: string
          format: uuid
    server.InputSchemaVadation:
      type: object
      properties:
        data:
          type: object
  securitySchemes:
    Bearer:
      type: apiKey
      name: Authorization
      in: header
      description: 'JWT Authorization header using the Bearer scheme. Example: "Authorization: Bearer {token}"'