Workflows

Update a workflow

Changed on Nov 12, 2026

Partial update — only the fields you provide change. Updating a published workflow creates a new draft; publish again to make the changes live.

patch/hub/workflows/{collection_topic}/{flow_topic}

Request

Base URL
https://api.quiva.ai
Auth
- HTTP bearer
- or API key in header x-api-key
TypeScript
https://skmtc.dev/quivaworks/apis/quiva-ai-gateway-3/docs/hub/workflows/:collection_topic/:flow_topic/patch.ts
A function with typed inputs. Its response is checked against the schema.

Request body

namestring

descriptionstring

archivedboolean

Archived workflows cannot be executed

secretsstring[]

Response

Workflow updated successfully

subjectstring

Subject identifier for the workflow

namestring

Name of the workflow

descriptionstring

Description of the workflow

modifiedinteger

Timestamp of last modification

Changes

Nov 12, 20268730377687f9 Revision changes
- breaking
  added the new required request property ///
- breaking
  the request property /// became required
- breaking
  the request property /// became required
- breaking
  the /// request property type changed from object to no type
- breaking
  added to the /// response property oneOf list for the response status
- breaking
  the /// response's property type changed from object to no type for status
- warning
  removed the request property ///
- warning
  removed the request property ///
- warning
  removed the request property ////
- warning
  removed the request property ////
- warning
  removed the request property ////
- warning
  removed the request property ////
- warning
  removed the request property ////
- warning
  removed the request property ////
- warning
  removed the request property ////
- warning
  removed the request property ////
- warning
  removed the request property ////
- warning
  removed the request property ///
- warning
  removed the optional property /// from the response with the status
- warning
  removed the optional property /// from the response with the status
- warning
  removed the optional property //// from the response with the status
- warning
  removed the optional property //// from the response with the status
- warning
  removed the optional property //// from the response with the status
- warning
  removed the optional property //// from the response with the status
- warning
  removed the optional property //// from the response with the status
- warning
  removed the optional property //// from the response with the status
- warning
  removed the optional property //// from the response with the status
- warning
  removed the optional property //// from the response with the status
- warning
  removed the optional property //// from the response with the status
- warning
  removed the optional property /// from the response with the status
- warning
  added the new normal enum value to the // response property for the response status
- info
  added the new optional request property
- info
  added discriminator to /// request property
- info
  added the new normal enum value to the request property //
- info
  added to the /// request property oneOf list
- info
  the response property /// became required for the status
- info
  the response property /// became required for the status
- info
  added discriminator to /// response property for the response status
- info
  added the required property /// to the response with the status
Jul 9, 2025945cf8329cbe Revision changes
- breaking
  the //// request property type changed from object to no type
- breaking
  the //// request property type changed from object to no type
- breaking
  the //// response's property type changed from object to no type for status
- breaking
  the //// response's property type changed from object to no type for status
- info
  added the new optional request property /////
- info
  added the new optional request property /////
- info
  added the new optional request property /////
- info
  added the new optional request property /////
- info
  added the new optional request property /////
- info
  added the optional property ///// to the response with the status
- info
  added the optional property ///// to the response with the status
- info
  added the optional property ///// to the response with the status
- info
  added the optional property ///// to the response with the status
- info
  added the optional property ///// to the response with the status

Operation history (3 revisions)

Update a workflow

Request

Request body

Response 200OK

Changes

Response