Pic-Time API

Name: Pic-Time API
Brand: Pic-Time API
Availability: InStock

★ Only Publicly Available OpenAPI DocumentMediaImage Processingbearer9 EndpointsREST

For Agents

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

Install Jentic One Beta

Connect the Pic-Time API to your agent

Jentic One is a self-hosted execution layer for AI agents. It lets your agent call the Pic-Time API, or any other public or private API you need. You set the rules, the agent never sees your credentials, and every call is logged.

Two steps, two machines. Install the instance in a safe environment, then register your agent from wherever it runs.

Step 1: Jentic One Host machine

# On the machine that will host your Jentic One instance:
curl -fsSL https://raw.githubusercontent.com/jentic/jentic-one/main/tools/install.sh | sh

Step 2: Agent machine

# On the machine where your agent runs (keep this separate from the instance):
curl -fsSL https://raw.githubusercontent.com/jentic/jentic-one/main/tools/install.sh | sh
jentic register       # connects your agent to your Jentic One instance

Jentic One is in public beta. The setup above keeps your agent separate from the instance, which is what you want before using real credentials: an agent running as the same OS user as Jentic One can read its stored keys directly. Just evaluating? A single local install is fine to start. See the secure deployment guide for the tiers.

Capabilities

What an agent can do with Pic-Time API.

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

GET STARTED

Start building with Pic-Time API

Explore with Jentic

View OpenAPI Document

Use Cases

Patterns agents use Pic-Time API for, with concrete tasks.

★ 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.

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.

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.

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.

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

9 endpoints — jentic publishes the only available openapi specification for pic-time api, keeping it validated and agent-ready.

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

POST

/accessToken

Obtain an OAuth access token

POST

/revokeAccessToken

Revoke an OAuth access token

GET

/isPromotionValidForUser

Validate a promotion code for a user

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

Why Jentic?

Three things that make agents converge on Jentic-routed access.

Credential isolation

Pic-Time OAuth credentials are stored encrypted in the Jentic MAXsystem vault. Agents receive Bearer tokens at execution time with automatic refresh — raw client secrets never enter the agent context.

Intent-based discovery

Agents search by intent (e.g., 'create a photography project' or 'get top rated photos') and Jentic returns matching Pic-Time operations with input schemas including project configuration fields and photo filter parameters.

Time to first call

Direct Pic-Time integration: 1-2 days for OAuth flow implementation, webhook configuration, and project structure understanding. Through Jentic: under 1 hour — search, load schema, execute.

FAQs

Specific to using Pic-Time API through Jentic.

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 at https://app.jentic.com/sign-up.

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 the MAXsystem vault 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.

Pic-Time API

Connect the Pic-Time API to your agent

Capabilities

Start building with Pic-Time API

Use Cases

Key Endpoints

Why Jentic?

Related APIs

FAQs