Skip to main content
POST
/
v2
/
clarity-v2
/
processes
/
{process_id}
/
artifact-imports
/
create-upload-url
Create Clarity Artifact Import Upload URL
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"
}
'
{
  "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

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