Skip to main content
GET
Get link import status

Authorizations

Authorization
string
header
required

API key passed as Bearer token

Headers

X-External-User-ID
string
required

Identifier of the acting user in the calling system (e.g. a Workfront user id). Recorded against every audited action this request performs.

X-External-User-Email
string<email>

Acting user email. Only meaningful on keys with act-on-behalf enabled, where it is resolved to the matching Adclear user and is mandatory on writes. Ignored on ordinary keys.

Path Parameters

uploadId
string<uuid>
required

Upload ID returned by POST /v1/links

Query Parameters

source
enum<string>

Which upstream to poll. Supplied by the statusUrl returned from POST /v1/links — omit it only for screenshot and Figma links, where it is not needed.

Available options:
screenshot,
figma,
gdrive
Example:

"gdrive"

Response

Link import status

uploadId
string<uuid>
required
status
enum<string>
required

Import status. Poll every few seconds while "processing".

Available options:
processing,
completed,
failed
correlationId
string<uuid>
required

Correlation ID for request tracing. Include in support requests.

finalUploadId
string<uuid>

Present when status is "completed" — the upload ID to pass in uploadIds when creating a promotion or version. May differ from the polled uploadId.

errorMessage
string

Present when status is "failed"