{"openapi":"3.1.1","info":{"title":"JellyTV Public API","version":"1.0.0","description":"Public, read-only endpoints for discovering JellyTV, its availability, and supported product capabilities. No authentication is required.","contact":{"name":"JellyTV Support","email":"help@jellytv.app","url":"https://www.jellytv.app/en/contact"},"license":{"name":"JellyTV Terms of Use","url":"https://www.jellytv.app/en/terms"}},"externalDocs":{"description":"JellyTV developer documentation, quotas, versioning, and lifecycle policy","url":"https://www.jellytv.app/en/developers#api-lifecycle"},"servers":[{"url":"https://www.jellytv.app","description":"JellyTV production website"}],"tags":[{"name":"Discovery","description":"Read-only information for people, clients, and AI agents."}],"paths":{"/api":{"get":{"operationId":"getJellyTVApiIndex","summary":"Get the public API index","description":"Returns canonical links to JellyTV developer documentation, the OpenAPI description, the MCP endpoint, and public API endpoints.","tags":["Discovery"],"responses":{"200":{"description":"The JellyTV public API index.","headers":{"RateLimit-Policy":{"description":"Quota policy using the IETF RateLimit structured field format.","schema":{"type":"string"},"example":"\"jellytv-public\";q=60;w=60"},"RateLimit":{"description":"Current remaining quota and effective window.","schema":{"type":"string"},"example":"\"jellytv-public\";r=59;t=60"},"RateLimit-Limit":{"description":"Compatibility field containing the request limit.","schema":{"type":"integer"}},"RateLimit-Remaining":{"description":"Compatibility field containing the remaining request count.","schema":{"type":"integer"}},"RateLimit-Reset":{"description":"Compatibility field containing seconds until the quota window resets.","schema":{"type":"integer"}},"X-RateLimit-Limit":{"description":"Legacy compatibility field containing the request limit.","schema":{"type":"integer"}},"X-RateLimit-Remaining":{"description":"Legacy compatibility field containing the remaining request count.","schema":{"type":"integer"}},"X-RateLimit-Reset":{"description":"Legacy compatibility field containing the quota reset time as a Unix timestamp.","schema":{"type":"integer"}}},"content":{"application/json":{"schema":{"type":"object","additionalProperties":false,"required":["data"],"properties":{"data":{"type":"object","additionalProperties":false,"required":["name","version","description","documentation","openapi","mcp","endpoints"],"properties":{"name":{"type":"string"},"version":{"type":"string"},"description":{"type":"string"},"documentation":{"type":"string","format":"uri"},"openapi":{"type":"string","format":"uri"},"mcp":{"type":"string","format":"uri"},"endpoints":{"type":"array","items":{"type":"string","format":"uri"}}}}}}}}},"429":{"description":"The public API quota was exceeded.","headers":{"RateLimit-Policy":{"description":"Quota policy using the IETF RateLimit structured field format.","schema":{"type":"string"},"example":"\"jellytv-public\";q=60;w=60"},"RateLimit":{"description":"Current remaining quota and effective window.","schema":{"type":"string"},"example":"\"jellytv-public\";r=59;t=60"},"RateLimit-Limit":{"description":"Compatibility field containing the request limit.","schema":{"type":"integer"}},"RateLimit-Remaining":{"description":"Compatibility field containing the remaining request count.","schema":{"type":"integer"}},"RateLimit-Reset":{"description":"Compatibility field containing seconds until the quota window resets.","schema":{"type":"integer"}},"X-RateLimit-Limit":{"description":"Legacy compatibility field containing the request limit.","schema":{"type":"integer"}},"X-RateLimit-Remaining":{"description":"Legacy compatibility field containing the remaining request count.","schema":{"type":"integer"}},"X-RateLimit-Reset":{"description":"Legacy compatibility field containing the quota reset time as a Unix timestamp.","schema":{"type":"integer"}},"Retry-After":{"description":"Seconds to wait before retrying the request.","schema":{"type":"integer","minimum":1}}},"content":{"application/json":{"schema":{"type":"object","additionalProperties":false,"required":["error"],"properties":{"error":{"type":"object","additionalProperties":false,"required":["code","message","resolution","documentationUrl"],"properties":{"code":{"type":"string","description":"Stable machine-readable error code."},"message":{"type":"string","description":"Human-readable error summary."},"resolution":{"type":"string","description":"Suggested next action."},"documentationUrl":{"type":"string","format":"uri"}}}}}}}},"default":{"description":"The request could not be completed.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}}}}},"/api/v1/status":{"get":{"operationId":"getJellyTVStatus","summary":"Get JellyTV service status","description":"Returns a lightweight, unauthenticated status record for the JellyTV website and public discovery API.","tags":["Discovery"],"responses":{"200":{"description":"Current public service status.","headers":{"RateLimit-Policy":{"description":"Quota policy using the IETF RateLimit structured field format.","schema":{"type":"string"},"example":"\"jellytv-public\";q=60;w=60"},"RateLimit":{"description":"Current remaining quota and effective window.","schema":{"type":"string"},"example":"\"jellytv-public\";r=59;t=60"},"RateLimit-Limit":{"description":"Compatibility field containing the request limit.","schema":{"type":"integer"}},"RateLimit-Remaining":{"description":"Compatibility field containing the remaining request count.","schema":{"type":"integer"}},"RateLimit-Reset":{"description":"Compatibility field containing seconds until the quota window resets.","schema":{"type":"integer"}},"X-RateLimit-Limit":{"description":"Legacy compatibility field containing the request limit.","schema":{"type":"integer"}},"X-RateLimit-Remaining":{"description":"Legacy compatibility field containing the remaining request count.","schema":{"type":"integer"}},"X-RateLimit-Reset":{"description":"Legacy compatibility field containing the quota reset time as a Unix timestamp.","schema":{"type":"integer"}}},"content":{"application/json":{"schema":{"type":"object","additionalProperties":false,"required":["data"],"properties":{"data":{"type":"object","additionalProperties":false,"required":["service","status","apiVersion","website","generatedAt"],"properties":{"service":{"type":"string","const":"JellyTV"},"status":{"type":"string","enum":["operational"]},"apiVersion":{"type":"string"},"website":{"type":"string","format":"uri"},"generatedAt":{"type":"string","format":"date-time"}}}}}}}},"429":{"description":"The public API quota was exceeded.","headers":{"RateLimit-Policy":{"description":"Quota policy using the IETF RateLimit structured field format.","schema":{"type":"string"},"example":"\"jellytv-public\";q=60;w=60"},"RateLimit":{"description":"Current remaining quota and effective window.","schema":{"type":"string"},"example":"\"jellytv-public\";r=59;t=60"},"RateLimit-Limit":{"description":"Compatibility field containing the request limit.","schema":{"type":"integer"}},"RateLimit-Remaining":{"description":"Compatibility field containing the remaining request count.","schema":{"type":"integer"}},"RateLimit-Reset":{"description":"Compatibility field containing seconds until the quota window resets.","schema":{"type":"integer"}},"X-RateLimit-Limit":{"description":"Legacy compatibility field containing the request limit.","schema":{"type":"integer"}},"X-RateLimit-Remaining":{"description":"Legacy compatibility field containing the remaining request count.","schema":{"type":"integer"}},"X-RateLimit-Reset":{"description":"Legacy compatibility field containing the quota reset time as a Unix timestamp.","schema":{"type":"integer"}},"Retry-After":{"description":"Seconds to wait before retrying the request.","schema":{"type":"integer","minimum":1}}},"content":{"application/json":{"schema":{"type":"object","additionalProperties":false,"required":["error"],"properties":{"error":{"type":"object","additionalProperties":false,"required":["code","message","resolution","documentationUrl"],"properties":{"code":{"type":"string","description":"Stable machine-readable error code."},"message":{"type":"string","description":"Human-readable error summary."},"resolution":{"type":"string","description":"Suggested next action."},"documentationUrl":{"type":"string","format":"uri"}}}}}}}},"default":{"description":"The request could not be completed.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}}}}},"/api/v1/capabilities":{"get":{"operationId":"getJellyTVCapabilities","summary":"Get JellyTV product capabilities","description":"Returns a typed overview of JellyTV platforms, core user-facing features, and agent integration links. It does not inspect a user's Jellyfin server.","tags":["Discovery"],"responses":{"200":{"description":"Public JellyTV capability information.","headers":{"RateLimit-Policy":{"description":"Quota policy using the IETF RateLimit structured field format.","schema":{"type":"string"},"example":"\"jellytv-public\";q=60;w=60"},"RateLimit":{"description":"Current remaining quota and effective window.","schema":{"type":"string"},"example":"\"jellytv-public\";r=59;t=60"},"RateLimit-Limit":{"description":"Compatibility field containing the request limit.","schema":{"type":"integer"}},"RateLimit-Remaining":{"description":"Compatibility field containing the remaining request count.","schema":{"type":"integer"}},"RateLimit-Reset":{"description":"Compatibility field containing seconds until the quota window resets.","schema":{"type":"integer"}},"X-RateLimit-Limit":{"description":"Legacy compatibility field containing the request limit.","schema":{"type":"integer"}},"X-RateLimit-Remaining":{"description":"Legacy compatibility field containing the remaining request count.","schema":{"type":"integer"}},"X-RateLimit-Reset":{"description":"Legacy compatibility field containing the quota reset time as a Unix timestamp.","schema":{"type":"integer"}}},"content":{"application/json":{"schema":{"type":"object","additionalProperties":false,"required":["data"],"properties":{"data":{"type":"object","additionalProperties":false,"required":["product","category","description","platforms","features","integrations"],"properties":{"product":{"type":"string","const":"JellyTV"},"category":{"type":"string"},"description":{"type":"string"},"platforms":{"type":"array","items":{"type":"string"}},"features":{"type":"array","items":{"type":"string"}},"integrations":{"type":"object","additionalProperties":false,"required":["openapi","mcp","llms"],"properties":{"openapi":{"type":"string","format":"uri"},"mcp":{"type":"string","format":"uri"},"llms":{"type":"string","format":"uri"}}}}}}}}}},"429":{"description":"The public API quota was exceeded.","headers":{"RateLimit-Policy":{"description":"Quota policy using the IETF RateLimit structured field format.","schema":{"type":"string"},"example":"\"jellytv-public\";q=60;w=60"},"RateLimit":{"description":"Current remaining quota and effective window.","schema":{"type":"string"},"example":"\"jellytv-public\";r=59;t=60"},"RateLimit-Limit":{"description":"Compatibility field containing the request limit.","schema":{"type":"integer"}},"RateLimit-Remaining":{"description":"Compatibility field containing the remaining request count.","schema":{"type":"integer"}},"RateLimit-Reset":{"description":"Compatibility field containing seconds until the quota window resets.","schema":{"type":"integer"}},"X-RateLimit-Limit":{"description":"Legacy compatibility field containing the request limit.","schema":{"type":"integer"}},"X-RateLimit-Remaining":{"description":"Legacy compatibility field containing the remaining request count.","schema":{"type":"integer"}},"X-RateLimit-Reset":{"description":"Legacy compatibility field containing the quota reset time as a Unix timestamp.","schema":{"type":"integer"}},"Retry-After":{"description":"Seconds to wait before retrying the request.","schema":{"type":"integer","minimum":1}}},"content":{"application/json":{"schema":{"type":"object","additionalProperties":false,"required":["error"],"properties":{"error":{"type":"object","additionalProperties":false,"required":["code","message","resolution","documentationUrl"],"properties":{"code":{"type":"string","description":"Stable machine-readable error code."},"message":{"type":"string","description":"Human-readable error summary."},"resolution":{"type":"string","description":"Suggested next action."},"documentationUrl":{"type":"string","format":"uri"}}}}}}}},"default":{"description":"The request could not be completed.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}}}}}},"components":{"schemas":{"ApiIndexResponse":{"type":"object","additionalProperties":false,"required":["data"],"properties":{"data":{"type":"object","additionalProperties":false,"required":["name","version","description","documentation","openapi","mcp","endpoints"],"properties":{"name":{"type":"string"},"version":{"type":"string"},"description":{"type":"string"},"documentation":{"type":"string","format":"uri"},"openapi":{"type":"string","format":"uri"},"mcp":{"type":"string","format":"uri"},"endpoints":{"type":"array","items":{"type":"string","format":"uri"}}}}}},"StatusResponse":{"type":"object","additionalProperties":false,"required":["data"],"properties":{"data":{"type":"object","additionalProperties":false,"required":["service","status","apiVersion","website","generatedAt"],"properties":{"service":{"type":"string","const":"JellyTV"},"status":{"type":"string","enum":["operational"]},"apiVersion":{"type":"string"},"website":{"type":"string","format":"uri"},"generatedAt":{"type":"string","format":"date-time"}}}}},"CapabilitiesResponse":{"type":"object","additionalProperties":false,"required":["data"],"properties":{"data":{"type":"object","additionalProperties":false,"required":["product","category","description","platforms","features","integrations"],"properties":{"product":{"type":"string","const":"JellyTV"},"category":{"type":"string"},"description":{"type":"string"},"platforms":{"type":"array","items":{"type":"string"}},"features":{"type":"array","items":{"type":"string"}},"integrations":{"type":"object","additionalProperties":false,"required":["openapi","mcp","llms"],"properties":{"openapi":{"type":"string","format":"uri"},"mcp":{"type":"string","format":"uri"},"llms":{"type":"string","format":"uri"}}}}}}},"ErrorResponse":{"type":"object","additionalProperties":false,"required":["error"],"properties":{"error":{"type":"object","additionalProperties":false,"required":["code","message","resolution","documentationUrl"],"properties":{"code":{"type":"string","description":"Stable machine-readable error code."},"message":{"type":"string","description":"Human-readable error summary."},"resolution":{"type":"string","description":"Suggested next action."},"documentationUrl":{"type":"string","format":"uri"}}}}}}}}