How AI is applied across API Evangelist and APIs.io. Read my AI disclosure →
API Evangelist API Evangelist
Discovery
Learnings
Guidance
Toolbox
Alignment
API Evangelist LLC

Webex Flows API

The Flows API from Webex — 11 operation(s) for flows.

Webex Flows API is one of 193 APIs that Webex publishes on the APIs.io network, described by a machine-readable OpenAPI specification.

Tagged areas include Flows. The published artifact set on APIs.io includes an OpenAPI specification.

This API exposes 13 operations across 11 paths, and defines 39 schemas. It is described by OpenAPI 3.2.0, at version 1.0.0.

13 operations 11 paths 39 schemas 1 DELETE5 GET1 PATCH6 POST

Metadata

The identity and technical contract details declared by the specification.

Specification
OpenAPI 3.2.0
API Version
1.0.0
Authentication
OAuth 2.0, HTTP Bearer, HTTP Bearer, HTTP Bearer, HTTP Bearer
Resource Areas
1

Authentication & Security 5

Webex Flows API declares 5 security schemes for authenticating requests. It supports OAuth 2.0 (oauth2) using the authorizationCode flow. It accepts HTTP bearer tokens (JWT) (bearer-key). It accepts HTTP bearer tokens (BEARER_TOKEN_FROM_CI). It accepts HTTP bearer tokens (JWT) (Bearer). It accepts HTTP bearer tokens (JWT) (bearerAuth).

  • bearer-key — e.g. Bearer YOURAUTHORIZATIONTOKEN
  • Bearer — e.g. Bearer YOURAUTHORIZATIONTOKEN
  • bearerAuth — JWT bearer token authentication. Obtain your token from the Webex Developer Portal.

Paths & Operations 13

Across 11 paths, the API surfaces 13 operations — 1 DELETE, 5 GET, 1 PATCH, 6 POST. Each is listed below with its method, path, parameters, and response codes.

Flows 13
GET
/{orgId}/project/{projectId}/flows
List Flows or Subflows
findFlowsUsingGET 10 params → 200400401403404500
GET
/{orgId}/project/{projectId}/flows:search
Search Flows
searchFlows 7 params → 200400401403404500
DELETE
/{orgId}/project/{projectId}/flows/{flowId}
Delete a Flow or Subflow
deleteFlowUsingDELETE 6 params → 200400401403404500
POST
/{orgId}/project/{projectId}/flows/{flowId}:publish
Publish a Flow or Subflow
publishFlowVersionUsingPOST 6 params body → 200201400401403404500
POST
/{orgId}/project/{projectId}/flows/{flowId}:lock
Lock a Flow or Subflow
lockFlowUsingPOST 4 params → 200401403404409429
POST
/{orgId}/project/{projectId}/flows/{flowId}:unlock
Unlock a Flow or Subflow
unlockFlowUsingPOST 4 params → 200401403404429
POST
/{orgId}/project/{projectId}/v2/flows:validate
Validate a Flow
validateFlowV2 2 params body → 200400401403404429
POST
/{orgId}/project/{projectId}/v2/flows:import
Import a Flow
importFlowV2 4 params body → 201400401403404409422429
GET
/{orgId}/project/{projectId}/v2/flows/{flowId}
Get a Flow
getFlowV2 4 params → 200401403404429
POST
/{orgId}/project/{projectId}/v2/flows/{flowId}
Save a Flow Draft
saveFlowV2Draft 5 params body → 200400401403404409422429
PATCH
/{orgId}/project/{projectId}/v2/flows/{flowId}
Patch a Flow Draft
patchFlowV2Draft 5 params body → 200400401403404409422429
GET
/{orgId}/project/{projectId}/v2/flows/{flowId}:validate
Validate an Existing Flow Draft
validateExistingFlowV2 5 params → 200401403404429
GET
/{orgId}/project/{projectId}/v2/flows/{flowId}:export
Export a Flow
exportFlowV2 5 params → 200401403404429

Schemas 39

The contract defines 39 schemas that model the data the API accepts and returns. The most detailed are FlowVersionRes (23 properties), FlowRes (21 properties), BasicFlow (17 properties), FlowVariablesRes (12 properties). Each schema is shown below with its type and property counts.

FlowSearchResponse
object
Paginated list of flows matching the search criteria.
2 properties
FlowVersionRes
object
Represents a specific version of a flow or subflow, including diagram, process, variables, and validation details.
23 properties
FlowV2ValidationError
object
A single validation error against a flow document.
7 properties
FlowV2Summary
object
Server-side metadata for a persisted flow document.
11 properties
VariableOrderRes
object
2 properties
FlowProgressionRes
object
3 properties
EventFlowRes
object
6 properties
ProcRes
object
Represents the executable process graph for a flow version, including activities and links.
2 properties
FlowV2EventFlow
object
An event-handler subflow bound to a specific event. The subflow runs when its bound event fires.
3 properties
FlowV2Variable
object
A flow variable.
8 properties
FlowV2Metadata
object
Result envelope returned for a flow on import, save draft, and patch draft. The persisted flow document is returned under flow (the server-assigned flow ID is…
3 properties
BasicFlow
object
17 properties
AssociatedChannelRes
object
Represents a channel associated with a flow version.
3 properties
FlowV2DraftValidationEntry
object
A single result entry returned when validating a stored flow draft.
6 properties
DiagramRes
object
Represents the visual graph metadata for a flow, including widgets and additional diagram properties.
2 properties
FlowV2Preference
object
A flow-level preference.
3 properties
FlowPreferenceRes
object
3 properties
FlowV2ValidationWarning
object
A single non-blocking validation warning or recommendation against a flow document.
3 properties
PublishParameters
object
Metadata for the published version.
2 properties
FlowRes
object
21 properties
FlowV2Node
object
A node in a flow process graph. Each node represents one activity instance.
5 properties
EventDiagramRes
object
Represents event-specific flow diagrams and global event mappings for a flow version.
2 properties
FlowLockResponse
string
Lock/unlock acknowledgement. Returns the literal JSON string "OK" on success. Locks auto-expire after 15 minutes of inactivity.
FlowSearchResult
object
Summary information for a flow returned by the search API.
5 properties
Widget
object
4 properties
LinkRes
object
5 properties
FlowTagRes
object
Represents a tag
5 properties
ActivityRes
object
4 properties
UiRuntimeVariableRes
object
9 properties
FlowV2ValidationResult
object
Result of validating a flow document.
4 properties
FlowVariablesRes
object
12 properties
FlowV2Edge
object
An edge connecting two flow nodes. Edge condition aliases are normalized server-side: done is rewritten to out, NewPhoneContact is rewritten to out, and defaul…
5 properties
FlowV2DraftValidationResult
object
Result of validating a stored flow draft. Issues are returned under results.
2 properties
ValidationResultRes
object
6 properties
FlowSearchPageInfo
object
Pagination metadata for a flow search response.
4 properties
FlowV2ErrorResponse
object
Standard error envelope returned by flow endpoints. For 400 (bad request) and 422 (validation failure), details[] carries field-level error information.
3 properties
FlowV2
object
Flow JSON document (formerly Flow IR / FDL 2.0). Describes a flow as top-level metadata plus arrays of nodes, edges, variables, event flows, and preferences.
11 properties
FlowVersionSettingRes
object
4 properties
PatchDraftContract
object
Structured patch applied to a flow draft. Server-side merge, idempotent, and re-validated after the merge — the patch is rejected if the merged document fails…
4 properties

Specification

The full machine-readable OpenAPI contract behind this narrative.

Source

webex-flows-api-openapi.yml Raw ↑

Other APIs Webex publishes across the network.

Webex Address Book API
Webex Admin Audit Events API
Webex Agent Personal Greeting Files API
Webex Agent Summaries API
Webex Agent Wellbeing API
Webex Agents API
Webex AI Feature API
Webex API - Domain Management API
Webex Archive Users API
Webex Attachment Actions API
Webex Audio Files API
Webex Authorizations API
Where this information came from

This is an independent, third-party profile of Webex Flows API, published by API Evangelist. We do not operate, host, resell, or support these APIs, and we are not affiliated with or endorsed by the company unless stated above. Everything here is built from publicly available information — the company's own site, developer portal, documentation, public repositories, and the specifications it publishes for public use. Nothing is obtained by breaching a system, defeating an access control, or using credentials.

The Kin Score and Agent Readiness rating are independently calculated assessments of a company's public API artifacts, scored against a published rubric. They are not certifications, endorsements, security assessments, or audits.

Corrections, re-scores, and removal are free — no partnership or purchase required, and you do not need to justify the request. A removed company is recorded as unrated, never scored zero for having asked. Acknowledgement within one business day; removal within two.

info@apievangelist.com · Read the full data-sourcing policy →
On a security or compliance team? Put security in the subject line and you will get a person, not a form — we will tell you exactly which public URLs this profile was built from.