Create Clarity Artifact Import Upload URL

Create a signed upload URL for importing a Miro export into a Clarity v2 process. Supports SVG, XML, PNG, and JPEG exports. The caller must upload the file to the returned URL, then complete the import.

POST /v2/clarity-v2/processes/{process_id}/artifact-imports/create-upload-url

Create Clarity Artifact Import Upload URL

cURL

curl --request POST \
  --url https://api.duvo.ai/v2/clarity-v2/processes/{process_id}/artifact-imports/create-upload-url \
  --header 'Authorization: Bearer <token>' \
  --header 'Content-Type: application/json' \
  --data '
{
  "file_name": "<string>",
  "extra_capture_request_id": "3c90c3cc-0d44-4b50-8888-8dd25736052a"
}
'

200

{
  "signed_url": "<string>",
  "capture_id": "3c90c3cc-0d44-4b50-8888-8dd25736052a",
  "expires_at": "2023-11-07T05:31:56Z"
}

Authorizations

Authorization · string · header · required

API key authentication. Get your API key from the Duvo dashboard.

Path Parameters

process_id · string<uuid> · required

The clarity process id

Body

application/json

file_name · string · required

Name of the Miro export file. Supported extensions: .svg, .xml, .png, .jpg, .jpeg

Minimum string length: 1

Pattern: ^.*\.(?:[sS][vV][gG]|[xX][mM][lL]|[pP][nN][gG]|[jJ][pP][eE]?[gG])$

content_type · enum<string> · required

MIME type of the Miro export file

Available options: image/svg+xml, application/xml, text/xml, image/png, image/jpeg

extra_capture_request_id · string<uuid>

Optional extra-capture-request id to bind this import to

Response

200

application/json

Default Response

signed_url · string<uri> · required

Signed URL for uploading the artifact

capture_id · string<uuid> · required

Pending capture id to pass to completion

expires_at · string<date-time> · required

ISO 8601 upload URL expiration timestamp