Asset Embeddable Links

Embeddable Links provide a way to get a public (although unguessable) link to an optionally transformed AssetFile of an Asset.

Operations

Update an asset embeddable link

Request

Update an AssetEmbeddableLink resource's status.

Currently only a patch to status: REVOKED is supported. This will update the AssetEmbeddableLink resource's status to REVOKED and fileStatus to DELETED.

Security

bearerToken

Path

idstringrequired

The unique ID of the AssetEmbeddableLink

Bodyapplication/jsonrequired

statusstringrequired

The status of the AssetEmbeddableLink

Value:"REVOKED"

curl -i -X PATCH \
  'https://api-v2.dash.app/embeddable-links/{id}' \
  -H 'Authorization: Bearer <YOUR_JWT_HERE>' \
  -H 'Content-Type: application/json' \
  -d '{
    "status": "REVOKED"
  }'

Responses

Success

Bodyapplication/json

resultobjectrequired

permittedActionsArray of objectsrequired

Response

{
  "result": {
    "id": "02e3b733-57c0-43f1-bee4-687569cf1bfa",
    "accountId": "cfb665ca-ce35-4418-b9d5-70ee815db4bd",
    "assetId": "7af90a8b-7ccd-430f-a85d-e8614015bc47",
    "assetFileId": "7af90a8b-7ccd-430f-a85d-e8614015bc47",
    "transformationDescription": { … },
    "determinedTransformation": { … },
    "status": "ACTIVE",
    "fileStatus": "COPIED",
    "url": "https://link.assetfile.io/3KdYk7kAiPS0kxhOC43krJ/axel-vazquez-5bb6VFLYCCM-unsplash.jpg"
  },
  "permittedActions": [
    { … }
  ]
}