POST/photos

Create photo

Create a new photo. Fields `id`, `createdAt`, `updatedAt` are auto-generated. Triggers `photos.created` webhook.

ReturnsPhoto

AcceptsPhotoInput

Bearer token required

Response examples

201Photo created

application/json example derived from schema

{
  "id": 1,
  "albumId": 1,
  "title": "Photo 1",
  "url": "https://picsum.photos/seed/1/800/960",
  "thumbnailUrl": "https://picsum.photos/seed/1/150/150",
  "width": 800,
  "height": 960,
  "size": 4803273,
  "format": "jpeg",
  "createdAt": "2026-07-24T20:47:13.121Z"
}

400400 — invalid input or malformed JSON

application/json

{
  "error": {
    "status": 400,
    "message": "Request body required"
  }
}

413413 — body exceeds 64 KB

application/json

{
  "error": {
    "status": 413,
    "message": "Request body too large",
    "details": {
      "maxSize": "64 KB"
    }
  }
}

429429 — rate limit exceeded (120/60s)

application/json

{
  "error": {
    "status": 429,
    "message": "Too many requests",
    "details": {
      "retryAfter": 45
    }
  }
}

Try ItMock API v2.0.1

Code examples

curl -X POST -H 'Authorization: Bearer <TOKEN>' -H 'Content-Type: application/json' -d '{
  "albumId": 1,
  "title": "Sunset at Vík",
  "url": "https://picsum.photos/1600/1067?random=1",
  "thumbnailUrl": "https://picsum.photos/150/150?random=1",
  "width": 1600,
  "height": 1067,
  "format": "jpeg",
  "size": 284532
}' 'https://api.rodin.dev/mock/photos'

fetch("https://api.rodin.dev/mock/photos", {
  method: "POST",
  headers: {
      "Authorization": "Bearer <TOKEN>",
      "Content-Type": "application/json"
    },
  body: "{\n  \"albumId\": 1,\n  \"title\": \"Sunset at Vík\",\n  \"url\": \"https://picsum.photos/1600/1067?random=1\",\n  \"thumbnailUrl\": \"https://picsum.photos/150/150?random=1\",\n  \"width\": 1600,\n  \"height\": 1067,\n  \"format\": \"jpeg\",\n  \"size\": 284532\n}",
})
  .then((response) => response.json())
  .then((data) => console.log(data))

import requests

url = "https://api.rodin.dev/mock/photos"
headers = {
    "Authorization": "Bearer <TOKEN>",
    "Content-Type": "application/json"
}
data = "{\n  \"albumId\": 1,\n  \"title\": \"Sunset at Vík\",\n  \"url\": \"https://picsum.photos/1600/1067?random=1\",\n  \"thumbnailUrl\": \"https://picsum.photos/150/150?random=1\",\n  \"width\": 1600,\n  \"height\": 1067,\n  \"format\": \"jpeg\",\n  \"size\": 284532\n}"

response = requests.post(url, headers=headers, data=data)
print(response.json())

Authentication

Authentication

Bearer token

Paste cURL

Server:

https://api.rodin.dev/mockhttp://localhost:3002

Body:

{ "albumId": 1, "title": "Sunset at Vík", "url": "https://picsum.photos/1600/1067?random=1", "thumbnailUrl": "https://picsum.photos/150/150?random=1", "width": 1600, "height": 1067, "format": "jpeg", "size": 284532 }