Need help with your APIs? I offer API discovery, governance & evangelism services. Explore services →
API Evangelist API Evangelist
Discovery
Learnings
Guidance
Toolbox
Alignment
API Evangelist LLC

Widen Assets API

Create, retrieve, update, delete, and search digital assets.

Widen Assets API is one of 17 APIs that Widen publishes on the APIs.io network, described by a machine-readable OpenAPI specification.

Tagged areas include Assets. The published artifact set on APIs.io includes an OpenAPI specification and API documentation.

This API exposes 19 operations across 15 paths, and defines 19 schemas. It is described by OpenAPI 3.0.3, at version 2.0.

Requests are made against 2 base URLs: https://api.widencollective.com/v2, https://api.widencollective.com/v1.

19 operations 15 paths 19 schemas 2 DELETE8 GET5 POST4 PUT

Metadata

The identity and technical contract details declared by the specification.

Specification
OpenAPI 3.0.3
API Version
2.0
Base URL
https://api.widencollective.com/v2
Authentication
HTTP Bearer
License
Proprietary
Resource Areas
1

Authentication & Security 1

Widen Assets API declares 1 security scheme for authenticating requests. It accepts HTTP bearer tokens (JWT) (bearerAuth). By default, every request must be authenticated.

  • bearerAuth — OAuth2 Bearer token obtained from Acquia DAM.

Paths & Operations 19

Across 15 paths, the API surfaces 19 operations — 2 DELETE, 8 GET, 5 POST, 4 PUT. Each is listed below with its method, path, parameters, and response codes.

Assets 19

Create, retrieve, update, delete, and search digital assets.

GET
/assets/search
Search for assets
assetListBySearchQuery 11 params → 200
GET
/assets/{id}
Retrieve an asset by ID
assetRetrieveById 2 params → 200
DELETE
/assets/{id}
Delete an asset (send to Pending Delete queue)
assetDelete 1 param → 204
GET
/assets/{id}/versions/{version_id}
Retrieve a specific version of an asset
assetRetrieveByIdAndVersion 3 params → 200
GET
/assets/{id}/metadata
Retrieve asset metadata
assetMetadataRetrieve 1 param → 200
PUT
/assets/{id}/metadata
Update asset metadata fields
assetMetadataUpdate 2 params body → 204
GET
/assets/{id}/security
Retrieve asset security settings
assetRetrieveSecurity 1 param → 200
PUT
/assets/{id}/security
Update asset security settings
assetUpdateSecurity 2 params body → 204
PUT
/assets/{id}/filename
Rename an asset
assetRename 1 param body → 204
POST
/assets/{id}/alternatepreview
Upload an alternate preview for an asset
alternatePreviewUpload 1 param body → 204
DELETE
/assets/{id}/alternatepreview
Remove alternate preview from an asset
alternatePreviewDelete 1 param → 204
GET
/assets/assetgroups
List asset groups
assetGroupsGet → 200
POST
/uploads
Create a new asset
uploadAsset body → 201
GET
/uploads/profiles
List upload profiles
uploadAssetProfilesList → 200
POST
/uploads/chunks/start
Start a chunked upload session
uploadChunk0 → 200
POST
/uploads/chunks/upload
Upload a file chunk
uploadChunk1 body → 200
POST
/uploads/chunks/complete
Complete a chunked upload session
uploadChunk3 body → 200
GET
/asset/uuid/{id}/assetversions
List asset versions (v1)
getAssetVersions 1 param → 200
PUT
/asset/changemetadatatype/asset/{id}/type/{metadata_type_uuid}
Change an asset's metadata type (v1)
updateMetadataType 2 params → 204

Schemas 19

The contract defines 19 schemas that model the data the API accepts and returns. The most detailed are GetAssetResult (19 properties), SearchAssetsResult (15 properties), FilePropertiesExpand (6 properties), CategoryFacet (5 properties). Each schema is shown below with its type and property counts.

CreateAssetResult
object
2 properties
MetadataExpand
object
1 property
GetAssetResult
object
19 properties
FileTypeFacet
object
3 properties
FilePropertiesExpand
object
6 properties
Thumbnail
object
2 properties
MetadataFacet
object
3 properties
UploadChunkResult
object
1 property
ListAssetGroupsResult
object
3 properties
SearchAssetsResult
object
15 properties
CategoryFacet
object
5 properties
StatusExpand
object
1 property
AssetPropertiesExpand
object
3 properties
CompleteChunkedUploadResult
object
1 property
StartChunkedUploadResult
object
1 property
SecurityExpand
object
3 properties
ListUploadProfilesResult
array
ThumbnailsExpand
object
5 properties
ListVersionsResult
object
3 properties

Specification

The full machine-readable OpenAPI contract behind this narrative.

Source

widen-assets-api-openapi.yml Raw ↑

Other APIs Widen publishes across the network.

Widen Acquia-DAM-Webhooks API
Widen Analytics API
Widen Attributes API
Widen Categories API
Widen Channels API
Widen Collections API
Widen File-Formats API
Widen Integration-Links API
Widen Metadata API
Widen Orders API
Widen Products API
Widen Search-Connector API