OPAQUE

OPAQUE Workflows API

The workflows API from OPAQUE — 9 operation(s) for workflows.

GitHub OpenAPI

Operations 11

POST /{version}/workspace/{workspace-uuid}/workflow Create workflow #
GET /{version}/workflow/{workflow-uuid} Get workflow #
PATCH /{version}/workflow/{workflow-uuid} Update workflow #
DELETE /{version}/workflow/{workflow-uuid} Delete workflow #
POST /{version}/workflow/{workflow-uuid}/request-review Request workflow review #
POST /{version}/workflow/{workflow-uuid}/cancel-review Canel workflow review #
POST /{version}/workflow/{workflow-uuid}/review Review workflow #
GET /{version}/workflow/{workflow-uuid}/reviews Get workflow reviews #
POST /{version}/workflow/{workflow-uuid}/launch-workflow Launch workflow #
POST /{version}/workflow/{workflow-uuid}/stop-workflow Stop or shutdown workflow #
GET /{version}/workspace/{workspace-uuid}/workflows Get workspace workflows #

Documentation

📖
Documentation
https://docs.opaque.co/en/latest/public_guide/developers/rest_api/
📖
APIReference
https://docs.opaque.co/en/latest/api_reference/rest_api/
📖
Authentication
https://artifacts.apis.io/opaque/authentication/opaque-authentication.yml

Specifications

⚙
OpenAPI
https://artifacts.apis.io/opaque/openapi/opaque-workflows-api-openapi.yml

Other Resources

🔗
Conventions
https://artifacts.apis.io/opaque/conventions/opaque-conventions.yml
🔗
ErrorCatalog
https://artifacts.apis.io/opaque/errors/opaque-problem-types.yml
🔗
DataModel
https://artifacts.apis.io/opaque/data-model/opaque-data-model.yml

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/opaque:opaque-workflows-api"
All apis 
curl "https://apis.io/api/v1/apis?limit=25"

Calls without X-API-Key need no key. Calls with it need a paid plan — get a key.

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.

GitHub Google LinkedIn

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

OpenAPI Specification

opaque-workflows-api-openapi.yml Raw ↑ 
openapi: 3.2.0
info:
  title: Opaque UI Workflows API
  version: '2.5'
  description: This documentation details the REST API endpoints that the client exposes.
  contact:
    name: Opaque Systems
    email: hello@opaque.co
servers:
- url: http://localhost:5001/
  description: Local Server
security:
- sessionToken: []
  refreshTokenCookie: []
tags:
- name: Workflows
paths:
  /{version}/workspace/{workspace-uuid}/workflow:
    parameters:
    - schema:
        type: string
      name: workspace-uuid
      in: path
      required: true
      description: Workspace UUID
    - $ref: '#/components/parameters/version'
    post:
      summary: Create workflow
      tags:
      - Workflows
      requestBody:
        content:
          application/json:
            schema:
              type: object
              properties:
                name:
                  type: string
                description:
                  type: string
                endpointPrefix:
                  type: string
                  description: Prefix for the workflow endpoint
                workflowGraph:
                  type: object
                  description: JSON object that stores the structure and configuration of the workflow
                  x-python-type: Dict[str, object]
                  additionalProperties: true
                uiDefinition:
                  type: object
                  description: JSON object that can be used to store UI-specific information about the workflow
                  x-python-type: Dict[str, object]
                  additionalProperties: true
              required:
              - name
              - workflowGraph
              - uiDefinition
      responses:
        '200':
          description: OK
          content:
            application/json:
              schema:
                $ref: ../models/Workflow.yaml
      operationId: create_workflow
      description: Create a new workflow
  /{version}/workflow/{workflow-uuid}:
    parameters:
    - schema:
        type: string
      name: workflow-uuid
      in: path
      required: true
      description: Workflow UUID
    - $ref: '#/components/parameters/version'
    get:
      summary: Get workflow
      tags:
      - Workflows
      responses:
        '200':
          description: OK
          content:
            application/json:
              schema:
                $ref: ../models/Workflow.yaml
      operationId: get_workflow
      description: Get a workflow by UUID
    patch:
      summary: Update workflow
      operationId: update_workflow
      responses:
        '200':
          description: OK
          content:
            application/json:
              schema:
                $ref: ../models/Workflow.yaml
        '400':
          description: 'Bad Request

            - Invalid workflow status

            - Invalid body parameter'
          content:
            application/json:
              schema:
                $ref: ../models/Error.yaml
      tags:
      - Workflows
      description: 'Update the workflow with one or more of the provided values.

        Can only be called by the workflow''s creator or an admin.'
      requestBody:
        content:
          application/json:
            schema:
              type: object
              properties:
                name:
                  type: string
                  description: New name for the workflow
                description:
                  type: string
                  description: New description for the workflow
                endpointPrefix:
                  type: string
                  description: New prefix for the workflow endpoint
                workflowGraph:
                  type: object
                  description: New JSON object that stores the structure and configuration of the workflow. Required if status is "under review".
                  x-python-type: Dict[str, object]
                  additionalProperties: true
                uiDefinition:
                  type: object
                  description: New JSON object that can be used to store UI-specific information about the workflow
                  x-python-type: Dict[str, object]
                  additionalProperties: true
    delete:
      summary: Delete workflow
      operationId: delete_workflow
      responses:
        '204':
          description: No Content
        '400':
          description: 'Bad Request

            - Workflow cannot be deleted (not in DRAFT status)'
          content:
            application/json:
              schema:
                $ref: ../models/Error.yaml
      tags:
      - Workflows
      description: Delete a workflow by UUID. Only works if the workflow is in the DRAFT state.
  /{version}/workflow/{workflow-uuid}/request-review:
    parameters:
    - schema:
        type: string
      name: workflow-uuid
      in: path
      required: true
      description: Workflow UUID
    - $ref: '#/components/parameters/version'
    post:
      summary: Request workflow review
      operationId: request_workflow_review
      responses:
        '200':
          description: OK
          content:
            application/json:
              schema:
                $ref: ../models/Workflow.yaml
        '400':
          description: 'Bad Request

            - Invalid workflow graph'
          content:
            application/json:
              schema:
                $ref: ../models/Error.yaml
      description: Request a review for a workflow. A workflow graph must also be provided to be compared against the existing workflow graph for security purposes.
      tags:
      - Workflows
      requestBody:
        content:
          application/json:
            schema:
              type: object
              properties:
                workflowGraph:
                  type: object
                  description: JSON object that stores the structure and configuration of the workflow to be reviewed. Will be compared against the existing workflow graph and an error will be thrown if they do not match.
                  x-python-type: Dict[str, object]
                  additionalProperties: true
              required:
              - workflowGraph
      security:
      - sessionToken: []
        refreshTokenCookie: []
        userIdentitySecret: []
  /{version}/workflow/{workflow-uuid}/cancel-review:
    parameters:
    - schema:
        type: string
      name: workflow-uuid
      in: path
      required: true
      description: Workflow UUID
    - $ref: '#/components/parameters/version'
    post:
      summary: Canel workflow review
      operationId: cancel_workflow_review
      responses:
        '200':
          description: OK
          content:
            application/json:
              schema:
                $ref: ../models/Workflow.yaml
      description: Cancel workflow reivew and set back the status to draft.
      tags:
      - Workflows
  /{version}/workflow/{workflow-uuid}/review:
    parameters:
    - schema:
        type: string
      name: workflow-uuid
      in: path
      required: true
      description: Workflow UUID
    - $ref: '#/components/parameters/version'
    post:
      summary: Review workflow
      operationId: review_workflow
      responses:
        '200':
          description: OK
          content:
            application/json:
              schema:
                $ref: ../models/WorkflowReview.yaml
        '400':
          description: 'Bad Request

            - Workflow status must be **under review**'
          content:
            application/json:
              schema:
                $ref: ../models/Error.yaml
      description: Review a workflow.
      tags:
      - Workflows
      requestBody:
        content:
          application/json:
            schema:
              type: object
              properties:
                decision:
                  type: string
                  enum:
                  - accepted
                  - rejected
                comment:
                  type: string
                workflowGraph:
                  type: object
                  description: New JSON object that stores the structure and configuration of the workflow. Required if status is "under review".
                  x-python-type: Dict[str, object]
                  additionalProperties: true
              required:
              - decision
              - workflowGraph
      security:
      - userIdentitySecret: []
        sessionToken: []
        refreshTokenCookie: []
  /{version}/workflow/{workflow-uuid}/reviews:
    parameters:
    - schema:
        type: string
      name: workflow-uuid
      in: path
      required: true
      description: Workflow UUID
    - $ref: '#/components/parameters/version'
    get:
      summary: Get workflow reviews
      responses:
        '200':
          description: OK
          content:
            application/json:
              schema:
                type: array
                items:
                  $ref: ../models/WorkflowReview.yaml
      operationId: get_workflow_reviews
      description: Returns all the reviews for a workflow, ordered by creation descending.
      tags:
      - Workflows
  /{version}/workflow/{workflow-uuid}/launch-workflow:
    parameters:
    - schema:
        type: string
      name: workflow-uuid
      in: path
      required: true
      description: Workflow UUID
    - $ref: '#/components/parameters/version'
    post:
      summary: Launch workflow
      tags:
      - Workflows
      responses:
        '200':
          description: OK
          content:
            application/json:
              schema:
                $ref: ../models/Workflow.yaml
      operationId: launch_workflow
      description: launch a workflow by UUID
  /{version}/workflow/{workflow-uuid}/stop-workflow:
    parameters:
    - schema:
        type: string
      name: workflow-uuid
      in: path
      required: true
      description: Workflow UUID
    - $ref: '#/components/parameters/version'
    post:
      summary: Stop or shutdown workflow
      tags:
      - Workflows
      responses:
        '200':
          description: OK
          content:
            application/json:
              schema:
                $ref: ../models/Workflow.yaml
      operationId: shutdown_workflow
      description: stop or shutdown a workflow by UUID
  /{version}/workspace/{workspace-uuid}/workflows:
    parameters:
    - schema:
        type: string
      name: workspace-uuid
      in: path
      required: true
      description: Workspace UUID
    - $ref: '#/components/parameters/version'
    get:
      summary: Get workspace workflows
      tags:
      - Workflows
      responses:
        '200':
          description: OK
          content:
            application/json:
              schema:
                type: array
                items:
                  $ref: ../models/SimpleWorkflow.yaml
      operationId: get_workspace_workflows
      description: Get all metadata about all workflows associated with a workspace
components:
  parameters:
    version:
      in: path
      name: version
      schema:
        type: string
        default: v1.2
        example: v1.2
      description: Version of the API to call
      required: true
  securitySchemes:
    sessionToken:
      type: http
      scheme: bearer
      description: The bearer token is obtained from the `/login` and `/register` endpoints.
    userIdentitySecret:
      name: userIdentitySecret
      type: apiKey
      in: cookie
      description: A binary blob derived from a user's passkey. It can be obtained from the `/login` and `/register` endpoints.
    sessionTokenCookie:
      name: sessionTokenCookie
      type: apiKey
      in: cookie
    refreshTokenCookie:
      name: refreshTokenCookie
      type: apiKey
      in: cookie
x-origin: origin
x-extension-with: x-extension-with