Skip to main content
POST
/
api
/
v1
/
images
/
{id}
/
signed-url
curl -X POST https://api.img-src.io/api/v1/images/img_abc123/signed-url \
  -H "Authorization: Bearer imgsrc_YOUR_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{"expires_in": 3600}'
{
  "signed_url": "https://img-src.io/i/username/photo.jpg?sig=abc123&exp=1704070800",
  "expires_at": 1704070800
}
This endpoint requires a Pro plan subscription.
Signed URLs allow temporary access to images without exposing your API key. They’re useful for:
  • Sharing private images with expiring links
  • Embedding images in emails
  • Time-limited access to premium content
curl -X POST https://api.img-src.io/api/v1/images/img_abc123/signed-url \
  -H "Authorization: Bearer imgsrc_YOUR_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{"expires_in": 3600}'
{
  "signed_url": "https://img-src.io/i/username/photo.jpg?sig=abc123&exp=1704070800",
  "expires_at": 1704070800
}

Parameters

NameTypeDescription
expires_inintegerExpiration time in seconds (max 86400 = 24 hours)
transformobjectOptional transformation parameters to include

Example with Transformations

curl -X POST https://api.img-src.io/api/v1/images/img_abc123/signed-url \
  -H "Authorization: Bearer imgsrc_YOUR_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "expires_in": 3600,
    "transform": {
      "w": 800,
      "h": 600,
      "fit": "cover"
    }
  }'