# Sales Layer DAM REST API

The Sales Layer DAM REST API lets external systems work with image assets managed by Sales Layer.

Use this reference when you need to list and filter images, retrieve individual image records by reference, or remove assets that are no longer required by your catalog workflows.

DAM operations are designed for integrations that keep media libraries, product imagery, commerce platforms, supplier portals, and other business systems aligned with Sales Layer. For implementation guidance, review the authentication, pagination, rate limiting, and error handling guides before calling the endpoints below.

Version: 2.0.0

## Servers

Sales Layer DAM API
```
https://api2.saleslayer.com/dam
```

## Download OpenAPI description

[Sales Layer DAM REST API](https://docs.api.saleslayer.com/_bundle/apis/dam-v2.0.yaml)

## Images

### Filter Images

- [GET /images](https://docs.api.saleslayer.com/apis/dam-v2.0/images/paths/~1images/get.md): Returns a paginated collection of the tenant's images, filtered and sorted using OData query options ($filter, $orderby, $top, $skip).

## Authentication

Requires a valid API key in the X-API-KEY header.

## Status field values

- Vd - Void (not yet started processing)
- Up - Updating (being uploaded/updated)
- Ok - Processed correctly (ready to use)
- Re - Reprocessing
- Er - Error (processing failed)

## Examples

GET /images?$filter=fileType eq 'jpg'
GET /images?$filter=status eq 'Ok'
GET /images?$filter=fileType eq 'png' and status eq 'Ok'
GET /images?$filter=status in ('Ok', 'Re')
GET /images?$filter=contains(reference, 'product')
GET /images?$orderby=createdOn desc
GET /images?$filter=fileType ne 'gif'&$orderby=numLinks desc&$skip=0&$top=50

## Error Responses

- 400 Bad Request: Invalid filter syntax, unsupported orderby field, invalid pagination parameters, or invalid API key
- 401 Unauthorized: Missing API key

### Get Image

- [GET /images({reference})](https://docs.api.saleslayer.com/apis/dam-v2.0/images/paths/~1images(%7Breference%7D)/get.md): In DAM, images are identified by their filename (reference), which is unique per tenant.
Use this endpoint to retrieve a specific image when you already know its filename.

## Authentication

Requires a valid API key in the X-API-KEY header.

## Example

GET /images(product-main-front.jpg)
X-API-KEY: your-api-key-here

## Response (200 OK)

```json
{
  "id": 42,
  "reference": "product-main-front.jpg",
  "numLinks": 3,
  "status": "Ok",
  "modifiedOn": "2024-04-05T08:44:33",
  "fileType": "png",
  "createdOn": "2024-04-05T08:44:33",
  "tags": ["animales", "mascotas"],
  "originalUrl": "https://cdn.example.com/product-main-front.jpg",
  "thumbnailUrl": "https://cdn.example.com/perrito-simpatico_TH.png",
  "thumbnailMediumUrl": "https://cdn.example.com/perrito-simpatico_THM.png",
  "thumbnailPreviewUrl": "https://cdn.example.com/perrito-simpatico_THP.png",
  "width": 800,
  "height": 600,
  "sizeInBytes": 102400
}
```

## Error Responses

- 400 Bad Request: Invalid API key
- 401 Unauthorized: Missing API key
- 404 Not Found: No image with the given reference exists for this tenant

### Delete Image

- [DELETE /images({reference})](https://docs.api.saleslayer.com/apis/dam-v2.0/images/paths/~1images(%7Breference%7D)/delete.md): Deletes an image by its filename (reference), which is unique per tenant.

## Authentication

Requires a valid API key in the X-API-KEY header.

## Example

DELETE /images(product-main-front.jpg)
X-API-KEY: your-api-key-here

## Error Responses

- 400 Bad Request: Invalid API key
- 401 Unauthorized: Missing API key
- 404 Not Found: No image with the given reference exists for this tenant
- 409 Conflict: Image is currently being processed and cannot be deleted