---
title: "Overview"
canonical_url: https://support.digitalphotogallery.com/articles/article/a55c3278-6385-471f-a4ea-4d26a80cb9c0
short_url: https://dpg.support/azju
category: "API"
locale: en
updated_at: 2026-07-03T17:22:28Z
source: Digital Photo Gallery Support
---

# Overview

The DPG API lets you do everything you'd normally do with your images in the admin, only from your own code: browse, search, upload, keyword, caption, arrange into sets, publish and download. It's a versioned REST interface that speaks JSON.

The current version is **`/v1`**, and it lives at:

```
https://api.digitalphotogallery.com/v1
```

We publish the whole contract as an OpenAPI 3.1 specification, so you can generate a client straight from it. And because every request is checked as it arrives, a mistake comes back to you as a clear, readable error rather than quietly reaching your data.

> 💡 **Tip:** New to this? The Quickstart takes you from an empty account to your first authenticated call in a few minutes.

### What you can do

- **Images.** Browse and search your whole library; filter by keyword, rating, Exif, capture date and more; read every version and its URL; and edit titles, descriptions, ratings, crops, keywords and metadata.
- **Sets.** Read your set hierarchy, add and remove images, reorder them, and control when a set goes live.
- **Uploads.** Send files to your account's image processor through a short-lived, signed ticket.
- **Downloads and archives.** Get secure, expiring download links and build ZIP archives.

### How it works

A few ideas run through the whole API, so once you've met them everything feels familiar:

- Every object has a stable **`public_uuid`**, and every list paginates the same way.
- Every write takes an **`Idempotency-Key`**, so if a request times out you can safely send it again without doubling up.
- **`GET /v1/me`** tells you exactly what your token is allowed to do.
- Every error comes back in the same shape, with a machine-readable code and the field that caused it.
- And if you're pointing an AI agent at the API, there's a plain-language guide at **`/llms.txt`** and the full contract at **`/llms-full.txt`**.

[Open the OpenAPI specification](https://api.digitalphotogallery.com/openapi.v1.yaml)

### Reads and writes

You authenticate with a bearer token, then read or write JSON:

```
curl https://api.digitalphotogallery.com/v1/images \
  -H "Authorization: Bearer YOUR_TOKEN"
```

Reads hand you the data straight away. Writes work a little differently: they return an **Operation** (a `202` response) that you poll until it's finished. The [Operations](https://support.digitalphotogallery.com/articles/article/2811a89b-e9f5-413a-b05c-7bb20b699313) guide explains it in full.

### Where to go next

These guides are written to be read in order:

1. [Quickstart](https://support.digitalphotogallery.com/articles/article/7ef0919d-76b2-443f-ae48-b44ac65cd678). Turn the API on, make a token, and make your first call.
2. [Authentication](https://support.digitalphotogallery.com/articles/article/1667f446-73dd-43ab-b737-de59974d8845). Service tokens, signing users in, and scopes.
3. [How writes work: Operations](https://support.digitalphotogallery.com/articles/article/2811a89b-e9f5-413a-b05c-7bb20b699313). The asynchronous model, and idempotency.
4. [Working with images](https://support.digitalphotogallery.com/articles/article/a1c55e31-6b9e-49b2-98bb-2bd6ecea5d1f). Browsing, searching and editing.
5. [Sets & galleries](https://support.digitalphotogallery.com/articles/article/67afa745-7507-4e62-98f8-4eaf64e55362). Hierarchy, membership, order and going live.
6. [Keywords, metadata & enrichment](https://support.digitalphotogallery.com/articles/article/d059236a-1d78-47d3-b781-f290133681c8). The editorial side.
7. [Uploading images](https://support.digitalphotogallery.com/articles/article/ed720389-054e-4037-b8d6-98771af4bff9). The signed-ticket flow.
8. [Downloads & archives](https://support.digitalphotogallery.com/articles/article/ceaec2dd-2c1d-4da9-a962-f2d217ecf4e7). Download links and ZIP bundles.
9. [Errors, rate limits & conventions](https://support.digitalphotogallery.com/articles/article/e78e2cca-e45b-4a85-b4c9-ffd0b5ce3e76). The things that apply everywhere.
10. [Building with AI agents](https://support.digitalphotogallery.com/articles/article/f7ab02ff-e7a5-419b-a76c-3f97b3fdc870). Pointing a language model at your gallery.