An AI agent can buy a Framky gallery
The Framky Agent API covers the entire purchase — from the customer's photos to a paid order. Payment is completed by the customer on a Stripe page, so the agent never touches card data.
https://api.framky.com/api/agent/v1/openapi.yaml
What the product is
Framky is a photo gallery wall: a set of MDF frames with the customer's photos, printed and delivered ready to hang. The frames are without glass, so there are no reflections, and they mount with self-adhesive hangers — the whole gallery is on the wall in about 15 minutes.
What an agent can do
Create a customer account
One request returns an agent token. If the e-mail is already registered, the customer receives a 6-digit code to authorise the agent.
Upload photos
Multipart upload or a source URL — the photos become the customer's library for the gallery.
Compose the gallery
The server clones a product layout and automatically assigns photos to frames by resolution and aspect ratio, then renders a visual preview to show the customer.
Order and checkout
Place the order, set the shipping address and receive a Stripe payment link for the customer.
Typical flow
- 1
Create the customer account
POST /accounts - 2
Upload the customer's photos
POST /photos - 3
Browse products and pick a layout
GET /products - 4
Create a composition — the server lays out the photos automatically
POST /compositions - 5
Render a preview and show it to the customer
POST /compositions/{id}/preview - 6
If needed, fine-tune the composition by hand — the API returns an edit link where you can change a photo's cropping or swap it for another
edit_url (from POST /compositions) - 7
Place the order and set the shipping address
POST /orders + PUT /orders/{id}/shipping-address - 8
Get the Stripe payment link and send it to the customer
POST /orders/{id}/checkout - 9
Poll the order until its status is “paid”
GET /orders/{id}
The OpenAPI schema is the single source of truth — all request and response schemas live there. Point your agent framework, GPT Action or MCP client at it.
Designed for safe autonomy
The customer pays on a Stripe-hosted page in their own browser — the API never accepts card data from an agent.
An Idempotency-Key header makes every POST safe to retry: the same key replays the original response for 24 hours.
Every composition returns an edit link that lets the customer fine-tune the gallery themselves in the framky.com configurator.