Duvo Ai Clarity Export API
The Clarity Export API from Duvo Ai — 3 operation(s) for clarity export.
The Clarity Export API from Duvo Ai — 3 operation(s) for clarity export.
Every API here is available over the APIs.io API and to AI agents over MCP.
One button, every client — Claude, Cursor, VS Code and the rest.
https://apis.io/mcp
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.curl "https://apis.io/api/v1/apis/duvo-ai:duvo-ai-clarity-export-api"
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.
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: 3.2.0
info:
title: Duvo Public Clarity Export API
description: 'Public API for programmatic access to Duvo. Authenticate with API keys created in the Duvo dashboard.
## Rate limits
Requests are counted per API key. Every response advertises the quota with the IETF RateLimit fields, so a client can self-throttle without waiting for a rejection:
- `RateLimit-Policy: "default";q=;w=` — the policy in force: `q` requests per `w` seconds.
- `RateLimit: "default";r=;t=` — the live state: `r` requests left, quota resetting in `t` seconds.
- Read the quota from the headers rather than hard-coding it; it differs per environment.
- The same numbers are also sent as `ratelimit-limit`, `ratelimit-remaining` and `ratelimit-reset`.
Once the quota is exhausted the API answers `429 Too Many Requests` with `Retry-After` set to the seconds to wait; honor it instead of retrying immediately.'
version: 1.0.0
servers:
- url: https://api.duvo.ai
description: Production server
tags:
- name: Clarity Export
paths:
/v2/clarity-export/{id}:
get:
operationId: getClarityExport
tags:
- Clarity Export
description: Get a Clarity export run by ID
parameters:
- schema:
type: string
format: uuid
in: path
name: id
required: true
security:
- bearerAuth: []
responses:
'200':
description: Default Response
content:
application/json:
schema:
type: object
properties:
id:
type: string
format: uuid
target:
type: string
status:
type: string
enum:
- queued
- running
- succeeded
- failed
processId:
type: string
format: uuid
teamId:
type: string
format: uuid
userId:
type: string
format: uuid
connectionInstanceId:
type: string
format: uuid
sandboxId:
type:
- string
- 'null'
result:
type:
- object
- 'null'
properties:
diagramId:
type: string
diagramName:
type: string
folderId:
type: string
additionalProperties: false
error:
type:
- string
- 'null'
createdAt:
type: string
updatedAt:
type: string
required:
- id
- target
- status
- processId
- teamId
- userId
- connectionInstanceId
- sandboxId
- result
- error
- createdAt
- updatedAt
additionalProperties: false
'401':
description: Default Response
content:
application/json:
schema:
type: object
properties:
error:
type: string
message:
type: string
code:
type: string
required:
- error
additionalProperties: false
'403':
description: Default Response
content:
application/json:
schema:
type: object
properties:
error:
type: string
message:
type: string
code:
type: string
required:
- error
additionalProperties: false
'404':
description: Default Response
content:
application/json:
schema:
type: object
properties:
error:
type: string
message:
type: string
code:
type: string
required:
- error
additionalProperties: false
'500':
description: Default Response
content:
application/json:
schema:
type: object
properties:
error:
type: string
message:
type: string
code:
type: string
required:
- error
additionalProperties: false
summary: Get Clarity Export
/v2/teams/{teamId}/clarity-export/active:
get:
operationId: listActiveClarityExports
tags:
- Clarity Export
description: List active (queued or running) Clarity export jobs for the current user
security:
- bearerAuth: []
parameters:
- schema:
type: string
in: path
name: teamId
required: true
responses:
'200':
description: Default Response
content:
application/json:
schema:
type: array
items:
type: object
properties:
exportRunId:
type: string
format: uuid
processId:
type: string
format: uuid
processName:
type: string
status:
type: string
enum:
- queued
- running
- succeeded
- failed
required:
- exportRunId
- processId
- processName
- status
additionalProperties: false
'401':
description: Default Response
content:
application/json:
schema:
type: object
properties:
error:
type: string
message:
type: string
code:
type: string
required:
- error
additionalProperties: false
'403':
description: Default Response
content:
application/json:
schema:
type: object
properties:
error:
type: string
message:
type: string
code:
type: string
required:
- error
additionalProperties: false
'500':
description: Default Response
content:
application/json:
schema:
type: object
properties:
error:
type: string
message:
type: string
code:
type: string
required:
- error
additionalProperties: false
summary: List Active Clarity Exports
/v2/teams/{teamId}/clarity-export:
post:
operationId: startClarityExport
tags:
- Clarity Export
description: Start a Clarity → SAP Signavio export job
requestBody:
required: true
content:
application/json:
schema:
type: object
properties:
processId:
type: string
format: uuid
connectionInstanceId:
type: string
format: uuid
bpmnXml:
type: string
minLength: 1
maxLength: 5000000
processOwnerRef:
type: string
pattern: ^\/glossary\/[0-9a-zA-Z_-]+$
processApproverRef:
type: string
pattern: ^\/glossary\/[0-9a-zA-Z_-]+$
required:
- processId
- connectionInstanceId
- bpmnXml
security:
- bearerAuth: []
parameters:
- schema:
type: string
in: path
name: teamId
required: true
responses:
'202':
description: Default Response
content:
application/json:
schema:
type: object
properties:
id:
type: string
format: uuid
status:
type: string
enum:
- queued
required:
- id
- status
additionalProperties: false
'400':
description: Default Response
content:
application/json:
schema:
type: object
properties:
error:
type: string
message:
type: string
code:
type: string
required:
- error
additionalProperties: false
'401':
description: Default Response
content:
application/json:
schema:
type: object
properties:
error:
type: string
message:
type: string
code:
type: string
required:
- error
additionalProperties: false
'403':
description: Default Response
content:
application/json:
schema:
type: object
properties:
error:
type: string
message:
type: string
code:
type: string
required:
- error
additionalProperties: false
'404':
description: Default Response
content:
application/json:
schema:
type: object
properties:
error:
type: string
message:
type: string
code:
type: string
required:
- error
additionalProperties: false
'500':
description: Default Response
content:
application/json:
schema:
type: object
properties:
error:
type: string
message:
type: string
code:
type: string
required:
- error
additionalProperties: false
summary: Start Clarity Export
components:
securitySchemes:
bearerAuth:
type: http
scheme: bearer
description: API key authentication. Get your API key from the Duvo dashboard.