Hey, human!
HTTP/2 200 OK content-type: text/markdown; charset=utf-8 vary: accept, user-agent x-agent: [ai_agent]
Loading the agent response…
Share a folder of photos as a gallery, free or paid (body: folder_id, title, price, currency, preview_mode, preview_count, watermark, client_name, client_email)
Shares a folder of photos (the JPG, PNG and WebP files directly in it, up to 500) as a gallery at gallery_url (/g/...). Without price it is a free gallery (watermark optional). With price (0.01 to 99999.99, in currency: USD, EUR, GBP, CAD, AUD, CHF, SEK, NOK, DKK, PLN, CZK, NZD, SGD, HKD or MXN; USD by default) it is a paid gallery: visitors see watermarked previews (preview_mode all) or only the first preview_count photos (preview_mode first), pay with PayPal or card, whichever the workspace connected, and download the originals for 30 days. pay_url (/pay/...) opens its checkout directly; after paying the buyer lands on the unlocked gallery and gets a receipt email with their download link. Getting paid needs Pro and PayPal or Stripe connected in Settings > Integrations; otherwise 403 with what to do. Creating it sends no email: client_email is kept for your own use. Needs transfers:create, and the token's creator must be allowed to create transfers.
What you provide
- Folder id: A folder whose JPG, PNG and WebP files (directly in it, up to 500) become the gallery
- Title
- Priceoptional: 0.01 to 99999.99 in the currency's main unit. Omit for a free gallery
- Currencyoptional: The buyer always pays in this currency
- Preview modeoptional: Paid only. all: every photo as a watermarked preview; first: only the first preview_count, the rest blurred
- Preview countoptional
- Watermarkoptional: Free galleries only (a paid gallery is always watermarked until bought)
- Client nameoptional: Shown on the gallery as "For <name>"
- Client emailoptional: Kept for your own use; Tarkle does not email it
Do this with AI
I want to share a folder of photos as a gallery, free or paid (body: folder_id, title, price, currency, preview_mode, preview_count, watermark, client_name, client_email). Use the Tarkle API. Read the reference for this operation and follow it exactly: https://project-03b42162.restlessdocs.com/endpoint/creategallery.md Authenticate with your API key as a Bearer token in the Authorization header. Then make the request for me and tell me what came back.
Paste this into Claude, Cursor, or any AI assistant and it will do it for you.
https://tarkle.com/api/v1/galleriescurl --request POST \
--url https://tarkle.com/api/v1/galleries \
--header 'Authorization: Bearer $API_KEY' \
--header 'Content-Type: application/json' \
--header 'X-Workspace-Key: X-Workspace-Key' \
--data '
{
"folder_id": "3fa85f64-5717-4562-b3fc-2c963f66afa6",
"title": "title",
"price": "price",
"currency": "USD",
"preview_mode": "all",
"preview_count": 3,
"watermark": true,
"client_name": "client_name",
"client_email": "user@example.com"
}
'Query parameters
workspace_keystringThe same key as the X-Workspace-Key header, for clients that cannot set headers. Send one of the two, or both with the same value (different values are 400 conflicting_workspace)
Header parameters
X-Workspace-KeystringrequiredThe 8-character key of the workspace this call acts on; GET /workspaces lists the keys a token can use. A workspace id is refused (400 workspace_key_required)
Idempotency-KeystringMakes a write safe to repeat. Send a random value (a UUID is fine) of up to 255 visible characters. A repeat of the same request gets the first answer again, with the header `Idempotent-Replayed: true`, and does nothing twice. The same key for a different request is 422 `idempotency_key_reused`; the same request while the first one is still running is 409 `idempotency_in_progress`. A 5xx or 429 is not remembered, so retrying it runs the request again. Keys last 24 hours and belong to the account that created the token.
Body
application/jsonrequiredfolder_idstring · uuidrequiredA folder whose JPG, PNG and WebP files (directly in it, up to 500) become the gallery
titlestringrequiredpricestring0.01 to 99999.99 in the currency's main unit. Omit for a free gallery
currencystringThe buyer always pays in this currency
preview_modestringPaid only. all: every photo as a watermarked preview; first: only the first preview_count, the rest blurred
preview_countintegerwatermarkbooleanFree galleries only (a paid gallery is always watermarked until bought)
client_namestringShown on the gallery as "For <name>"
client_emailstring · emailKept for your own use; Tarkle does not email it