canonical: https://jentic.com/apis/pic-time.com/pic-time

# Pic-Time API

Jentic publishes the only available OpenAPI specification for Pic-Time API, keeping it validated and agent-ready. Pic-Time provides a photography gallery platform API for professional photographers to manage client projects, photos, webhooks, and OAuth integration. The API enables project creation, photo listing with rating filters, top-rated photo retrieval, promotion validation, and webhook registration across 9 endpoints designed for photography studio workflow automation and e-commerce gallery management.

## For AI agents

Manage photography gallery projects, retrieve photos with rating filters, register webhooks for gallery events, and validate client promotions on the Pic-Time platform.

## Scope

Does not handle image editing, printing, payment processing, or social media posting - use for photography gallery project management and photo retrieval only.

## Capabilities

- Create client photography projects with gallery configuration and delivery settings
- Retrieve photos from projects with rating-based filtering for curation
- Access top-rated photos from a project based on client or photographer favorites
- Register webhooks to receive notifications on gallery events and client actions
- Validate promotional offers and discount codes for client galleries
- Manage OAuth access tokens for secure third-party integrations
- Track external integration events for analytics and workflow triggers

## Use cases

### Photography Gallery Automation

Automate the creation and management of client photography galleries. Pic-Time handles gallery hosting, client access control, and photo delivery. The API enables photography studios to programmatically create projects after booking confirmation, populate galleries from editing software exports, and track client engagement through webhooks.

Example prompt: Create a new project via POST /createProject with client name and event details, then register a webhook at POST /registerWebhook to receive notifications when the client views or downloads photos

### Curated Photo Selection and Delivery

Retrieve client-rated or photographer-selected top photos from project galleries for album design, social media previews, or print orders. The top-rated photo endpoint returns the highest-scored images based on client favorites, enabling automated curation workflows that feed into album design tools or slideshow generators.

Example prompt: Retrieve the top 20 rated photos from a project using GET /projectTopRatedPhotos and export their URLs for album layout preparation

### E-Commerce Promotion Management

Validate promotional discount codes before applying them to gallery print orders or digital download packages. The API checks whether a promotion is valid for a specific user, preventing expired or unauthorized code usage. Photography studios use this to run limited-time offers for returning clients or seasonal campaigns.

Example prompt: Call GET /isPromotionValidForUser with the promotion code 'SPRING25' and user ID to verify the discount is applicable before checkout

### AI Agent Gallery Management via Jentic

AI agents assisting photography studios can create projects, pull top-rated photos, and register webhooks through Jentic without managing OAuth tokens directly. The agent searches for gallery management operations, loads endpoint schemas, and executes with Jentic handling bearer token authentication for the Pic-Time platform.

Example prompt: Search Jentic for 'create a photography gallery project', load the Pic-Time createProject operation, and execute with client name 'Johnson Wedding' and event date

## Key endpoints

| Method | Path | Description |
| --- | --- | --- |
| POST | `/createProject` | Create a new photography gallery project |
| GET | `/projectPhotos` | Retrieve all photos from a project |
| GET | `/projectTopRatedPhotos` | Get top-rated photos from a project |
| GET | `/projectInfo` | Retrieve project metadata and settings |
| POST | `/registerWebhook` | Register a webhook for gallery events |
| POST | `/accessToken` | Obtain an OAuth access token |
| POST | `/revokeAccessToken` | Revoke an OAuth access token |
| GET | `/isPromotionValidForUser` | Validate a promotion code for a user |

## Key resources

- **Projects** — Create and retrieve photography gallery projects with metadata
- **Photos** — List and filter project photos by rating and selection status
- **Webhooks** — Register event notifications for gallery activity
- **Promotions** — Validate discount codes for e-commerce gallery orders
- **OAuth Tokens** — Manage access and revocation of third-party integration tokens

## Why Jentic

- **Setup:** Wiring the Pic-Time API by hand means setting up its bearer token against productionapi.pic-time.com/apiV2, exchanging OAuth codes at its accessToken endpoint, and formatting the project and photo requests yourself. Through Jentic you install once, import the Pic-Time API from the API Directory, store the token once, and your agent calls it.
- **Permission scoping:** Pic-Time carries the project target in the request body or query rather than the URL path, so the honest control is operations-only: you limit the agent to the operations it needs, such as reading project photos or project info. You choose the operations it may call, so writes like creating a project or revoking an access token are not included unless you add them.
- **Credential handling:** Your Pic-Time token is stored once, encrypted, by your own Jentic One instance and injected at execution time. It never enters the agent's prompt, logs, or context.
- **Discovery method:** Agents search Jentic by intent such as 'get the photos in a gallery project', and Jentic returns the matching Pic-Time operation with its input schema so the agent calls the right endpoint without browsing the reference docs.

## Related APIs

- **Cloudinary Upload API** — Image optimization and CDN delivery for embedding gallery photos on external sites
- **Shopify API** — E-commerce platform for selling prints and digital downloads from gallery sessions
- **Stripe API** — Payment processing for custom photography booking and print order payments

## FAQ

### Why is there no official OpenAPI spec for Pic-Time API?

Pic-Time does not publish an OpenAPI specification. Jentic generates and maintains this spec so that AI agents and developers can call Pic-Time API via structured tooling. It is validated against the live API and kept up to date. Get started with Jentic One, the self-hosted execution layer.

### What authentication does the Pic-Time API use?

Pic-Time uses Bearer token authentication provided through their OAuth flow. Obtain a token via POST /accessToken and include it in the Authorization header for subsequent requests. Through Jentic, tokens are managed in your Jentic One instance with automatic handling of the OAuth exchange.

### Can I retrieve only the top-rated photos from a client gallery?

Yes. Use GET /projectTopRatedPhotos to retrieve photos that have been rated highest by the client or photographer. This endpoint returns a curated subset of the gallery suitable for album design, social media previews, or print recommendations.

### How do I receive notifications when a client interacts with their gallery?

Register a webhook using POST /registerWebhook with your callback URL and the event types you want to receive. Pic-Time sends HTTP POST notifications to your URL when clients view, download, favorite, or purchase photos from their gallery.

### How do I create a photography project through Jentic?

Search Jentic for 'create a photography gallery project' to find the POST /createProject operation. Load the schema to see required fields (client name, event type, date), then execute. Jentic handles the Bearer token authentication for the Pic-Time platform automatically.

### Can I limit what my agent is allowed to do with the Pic-Time API?

Yes. Jentic One is self-hosted by you, so your own rules decide which Pic-Time operations and credentials the agent may use. Because Pic-Time carries the project target in the request body or query rather than the URL path, the honest control is operations-only: you can allow read calls like GET /projectPhotos, GET /projectTopRatedPhotos, and GET /projectInfo while leaving writes such as POST /createProject or POST /revokeAccessToken out unless you choose to add them. The stored token is injected only when the agent runs an operation you have permitted.