API Reference

Complete reference for the Castiz API. All endpoints use the base URL https://api.castiz.com

Authentication

All requests require an API key

Include your API key in the X-API-Key header:

curl -X GET "https://api.castiz.com/videos" \
  -H "X-API-Key: sk_live_your_key_here"

Get your API key from Settings → API Keys

Manage your video library

Organize videos into folders

Upload videos to your library

Status	Description
`400`	Bad Request - Invalid parameters
`401`	Unauthorized - Invalid or missing API key
`403`	Forbidden - Insufficient permissions (check scopes)
`404`	Not Found - Resource does not exist
`429`	Too Many Requests - Rate limit exceeded
`500`	Server Error - Something went wrong on our end

API requests are limited to 100 requests per minute per API key. Rate limit headers are included in every response: