API reference
Photos
Libraries, albums and uploads.
Base URL https://api.pinal.tech/v1
API reference
Libraries, albums and uploads.
Base URL https://api.pinal.tech/v1
/photosLibrary items, newest first, with thumbnails and metadata.
album string Album ID.
taken_after string (date-time) RFC 3339.
limit integer Items per page, 1–100.
cursor string Opaque cursor from a previous page's next_cursor.
curl "https://api.pinal.tech/v1/photos" \
-H "Authorization: Bearer $ACCESS_TOKEN"{
"photos": [
{
"id": "string",
"kind": "photo",
"filename": "string",
"width": 0,
"height": 0,
"taken_at": "2026-11-19T15:20:04Z",
"location": {
"lat": 0,
"lng": 0
},
"thumbnail_url": "https://example.com",
"original_url": "https://example.com"
}
],
"next_cursor": "string"
}/photosUploads an image or video. With only photos.upload, the response omits other library items.
file string (binary) album string curl -X POST "https://api.pinal.tech/v1/photos" \
-H "Authorization: Bearer $ACCESS_TOKEN" \
-F file=@photo.jpg{
"id": "string",
"kind": "photo",
"filename": "string",
"width": 0,
"height": 0,
"taken_at": "2026-11-19T15:20:04Z",
"location": {
"lat": 0,
"lng": 0
},
"thumbnail_url": "https://example.com",
"original_url": "https://example.com"
}curl "https://api.pinal.tech/v1/photos/albums" \
-H "Authorization: Bearer $ACCESS_TOKEN"{
"albums": [
{
"id": "alb_77b0",
"title": "Superstition Mountains",
"count": 148
}
]
}/photos/albumsCreates an album, optionally with items.
title string required photos array of string curl -X POST "https://api.pinal.tech/v1/photos/albums" \
-H "Authorization: Bearer $ACCESS_TOKEN" \
-H "Content-Type: application/json" \
-d '{
"title": "string",
"photos": [
"string"
]
}'{
"id": "string",
"title": "string",
"count": 0,
"cover": "string",
"shared": true
}/photos/albums/{id}/shareCreates a shared album link.
id string requiredAlbum ID.
expires_at string | null (date-time) curl -X POST "https://api.pinal.tech/v1/photos/albums/{id}/share" \
-H "Authorization: Bearer $ACCESS_TOKEN" \
-H "Content-Type: application/json" \
-d '{
"expires_at": "2026-11-19T15:20:04Z"
}'{
"url": "string"
}