Pic-Time API
Agent-ready OpenAPI document · curated by JenticMediaImage Processingbearer9 EndpointsREST
Know of an official OpenAPI document? Contribute it →
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.
Use for: I need to create a new photography project for a client, I want to retrieve all photos from a specific gallery project, Get the top-rated photos from a client gallery, Register a webhook for new photo upload events
Not supported: Does not handle image editing, printing, payment processing, or social media posting - use for photography gallery project management and photo retrieval only.
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.
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.
1
Step 1: Jentic One Host machine
# On the machine that will host your Jentic One instance:
curl -fsSL "https://jentic.com/install.sh?src=apis&api=%2Fapis%2Fpic-time.com%2Fpic-time" | sh2
Step 2: Agent machine
# On the machine where your agent runs (keep this separate from the instance):
curl -fsSL "https://jentic.com/install.sh?src=apis&api=%2Fapis%2Fpic-time.com%2Fpic-time" | sh
jentic register # connects your agent to your Jentic One instanceJentic 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
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
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
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
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
Why Jentic?
What agents get from Jentic-routed access to this vendor.
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 isolation
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.
Intent-based discovery
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
Alternatives and complements available in the Jentic catalogue.
Complementary
Stripe API
Payment processing for custom photography booking and print order payments
Use Stripe alongside Pic-Time for custom payment flows like booking deposits or package upgrades outside Pic-Time's native payment system.
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 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.
GET STARTED