Developer Documentation

Everything you need to integrate DVP DAM into your applications

Getting Started

DVP DAM provides a REST API for programmatic access to your digital assets. With the API, you can:

Base URL

All API requests are made to:

https://api.dvpdam.com/v1

Quick Example

Here's a simple example of uploading an asset using cURL:

# Upload an asset curl -X POST https://api.dvpdam.com/v1/assets \ -H "Authorization: Bearer YOUR_API_KEY" \ -F "file=@/path/to/image.jpg" \ -F "folder_id=folder_abc123" \ -F "tags=product,hero"

Authentication

All API requests require authentication using an API key. Include your API key in the Authorization header:

Authorization: Bearer YOUR_API_KEY

Obtaining API Keys

API keys can be generated from your DVP DAM dashboard under Settings > API Keys. You can create multiple keys with different permissions for different use cases.

Key Permissions

API Reference

The DVP DAM API follows REST conventions. Responses are returned in JSON format.

Assets

GET /assets

List all assets with optional filtering and pagination.

GET /assets/{id}

Retrieve a specific asset by ID.

POST /assets

Upload a new asset.

PUT /assets/{id}

Update asset metadata.

DELETE /assets/{id}

Delete an asset.

Search

POST /search

Search assets by text, tags, metadata, or visual similarity.

Folders

GET /folders

List all folders.

POST /folders

Create a new folder.

Transformations

GET /assets/{id}/transform

Get a transformed version of an asset (resize, crop, format conversion).

Full API Documentation Coming Soon

Detailed endpoint documentation with request/response examples will be available when DVP DAM launches.

Webhooks

Webhooks allow you to receive real-time notifications when events occur in your DVP DAM account.

Available Events

Webhook Payload

{ "event": "asset.created", "timestamp": "2025-01-17T12:00:00Z", "data": { "asset_id": "ast_abc123", "name": "hero-image.jpg", "folder_id": "fld_xyz789", "uploaded_by": "user_123" } }

SDKs & Libraries

Official client libraries make it easy to integrate DVP DAM into your application.

JavaScript / TypeScript

npm install @dvpdam/sdk
import { DVPDam } from '@dvpdam/sdk'; const dam = new DVPDam('YOUR_API_KEY'); // Upload an asset const asset = await dam.assets.upload({ file: fileBuffer, name: 'product-photo.jpg', folder: 'products', tags: ['product', 'electronics'] }); // Search for assets const results = await dam.assets.search({ query: 'logo', type: 'image', tags: ['brand'] });

Python

pip install dvpdam
from dvpdam import DVPDam dam = DVPDam('YOUR_API_KEY') # Upload an asset asset = dam.assets.upload( file='/path/to/image.jpg', folder='marketing', tags=['campaign', 'q1-2025'] ) # Get asset URL with transformations url = asset.get_url(width=800, format='webp')

More SDKs Coming

PHP, Ruby, Go, and Java SDKs are planned for release after launch.