{"openapi":"3.1.0","info":{"title":"Yukisbox REST API","description":"Comprehensive Markdown description with parameters, headers, rate limits, and response format\n\n**Versioning & Deprecation Policy**\nURI path `/v1/`, `API-Version: 1.0.0` header, 180-day deprecation notice via `Sunset` and `Deprecation` headers per RFC 8594.","version":"1.0.0"},"paths":{"/api/v1/db/{collection}/insert":{"post":{"summary":"Ydb Insert","operationId":"ydb_insert_api_v1_db__collection__insert_post","parameters":[{"name":"collection","in":"path","required":true,"schema":{"type":"string","title":"Collection"}}],"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}}}},"/api/v1/db/{collection}/find":{"post":{"summary":"Ydb Find","operationId":"ydb_find_api_v1_db__collection__find_post","parameters":[{"name":"collection","in":"path","required":true,"schema":{"type":"string","title":"Collection"}}],"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}}}},"/api/v1/db/{collection}/{doc_id}":{"delete":{"summary":"Ydb Delete","operationId":"ydb_delete_api_v1_db__collection___doc_id__delete","parameters":[{"name":"collection","in":"path","required":true,"schema":{"type":"string","title":"Collection"}},{"name":"doc_id","in":"path","required":true,"schema":{"type":"string","title":"Doc Id"}}],"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}}}},"/api/v1/db/collections":{"get":{"summary":"Ydb Collections","operationId":"ydb_collections_api_v1_db_collections_get","responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{}}}}}},"post":{"summary":"Ydb Create Collection Endpoint","operationId":"ydb_create_collection_endpoint_api_v1_db_collections_post","responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{}}}}}}},"/api/v1/db/keys":{"get":{"summary":"Ydb Keys List","operationId":"ydb_keys_list_api_v1_db_keys_get","responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{}}}}}},"post":{"summary":"Ydb Keys Create","operationId":"ydb_keys_create_api_v1_db_keys_post","responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{}}}}}}},"/api/v1/db/keys/{key_id}":{"delete":{"summary":"Ydb Keys Revoke","operationId":"ydb_keys_revoke_api_v1_db_keys__key_id__delete","parameters":[{"name":"key_id","in":"path","required":true,"schema":{"type":"string","title":"Key Id"}}],"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}}}},"/api/server/stats":{"get":{"summary":"Get Server Stats","description":"Returns live server operational status, dynamic runtime uptime, and total indexed files.","operationId":"getServerStats","responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ServerStats"}}}},"400":{"description":"Bad Request","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}},"404":{"description":"Not Found","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}},"429":{"description":"Too Many Requests","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}}}}},"/v1/server/stats":{"get":{"summary":"Get Server Stats (v1)","description":"Returns live server operational status, dynamic runtime uptime, and total indexed files.","operationId":"getServerStatsV1","responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ServerStats"}}}},"400":{"description":"Bad Request","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}},"404":{"description":"Not Found","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}},"429":{"description":"Too Many Requests","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}}}}},"/api/file/{uid}/info":{"get":{"summary":"Get File Info","description":"Comprehensive Markdown description with parameters, headers, rate limits, and response format","operationId":"getFileInfo","parameters":[{"name":"uid","in":"path","required":true,"schema":{"type":"string","title":"Uid"}}],"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{"$ref":"#/components/schemas/FileInfo"}}}},"400":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}},"description":"Bad Request"},"404":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}},"description":"Not Found"},"429":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}},"description":"Too Many Requests"},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}}}},"/v1/file/{uid}/info":{"get":{"summary":"Get File Info (v1)","description":"Comprehensive Markdown description with parameters, headers, rate limits, and response format","operationId":"getFileInfoV1","parameters":[{"name":"uid","in":"path","required":true,"schema":{"type":"string","title":"Uid"}}],"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{"$ref":"#/components/schemas/FileInfo"}}}},"400":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}},"description":"Bad Request"},"404":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}},"description":"Not Found"},"429":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}},"description":"Too Many Requests"},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}}}},"/upload":{"post":{"summary":"Upload File","description":"Comprehensive Markdown description with parameters, headers, rate limits, and response format","operationId":"uploadFile","parameters":[{"name":"source","in":"query","required":false,"schema":{"type":"string","default":"api","title":"Source"}},{"name":"userhash","in":"query","required":false,"schema":{"type":"string","title":"Userhash"}}],"requestBody":{"required":true,"content":{"multipart/form-data":{"schema":{"$ref":"#/components/schemas/Body_uploadFile"}}}},"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{"$ref":"#/components/schemas/UploadResponse"}}}},"400":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}},"description":"Bad Request"},"404":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}},"description":"Not Found"},"429":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}},"description":"Too Many Requests"},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}}}},"/v1/upload":{"post":{"summary":"Upload File (v1)","description":"Comprehensive Markdown description with parameters, headers, rate limits, and response format","operationId":"uploadFileV1","parameters":[{"name":"source","in":"query","required":false,"schema":{"type":"string","default":"api","title":"Source"}},{"name":"userhash","in":"query","required":false,"schema":{"type":"string","title":"Userhash"}}],"requestBody":{"required":true,"content":{"multipart/form-data":{"schema":{"$ref":"#/components/schemas/Body_uploadFileV1"}}}},"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{"$ref":"#/components/schemas/UploadResponse"}}}},"400":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}},"description":"Bad Request"},"404":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}},"description":"Not Found"},"429":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}},"description":"Too Many Requests"},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}}}},"/api/telegram/info":{"post":{"summary":"Inspect Telegram URL","description":"Comprehensive Markdown description with parameters, headers, rate limits, and response format","operationId":"inspectTelegramUrl","requestBody":{"content":{"application/x-www-form-urlencoded":{"schema":{"$ref":"#/components/schemas/Body_inspectTelegramUrl"}}},"required":true},"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{"$ref":"#/components/schemas/TelegramInfoResponse"}}}},"400":{"description":"Bad Request","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}},"404":{"description":"Not Found","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}},"429":{"description":"Too Many Requests","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}}}},"/v1/telegram/info":{"post":{"summary":"Inspect Telegram URL (v1)","description":"Comprehensive Markdown description with parameters, headers, rate limits, and response format","operationId":"inspectTelegramUrlV1","requestBody":{"content":{"application/x-www-form-urlencoded":{"schema":{"$ref":"#/components/schemas/Body_inspectTelegramUrlV1"}}},"required":true},"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{"$ref":"#/components/schemas/TelegramInfoResponse"}}}},"400":{"description":"Bad Request","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}},"404":{"description":"Not Found","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}},"429":{"description":"Too Many Requests","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}}}},"/upload-telegram":{"post":{"summary":"Import Telegram Media","description":"Comprehensive Markdown description with parameters, headers, rate limits, and response format","operationId":"importTelegramMedia","parameters":[{"name":"source","in":"query","required":false,"schema":{"type":"string","default":"api","title":"Source"}},{"name":"userhash","in":"query","required":false,"schema":{"type":"string","title":"Userhash"}}],"requestBody":{"required":true,"content":{"application/x-www-form-urlencoded":{"schema":{"$ref":"#/components/schemas/Body_importTelegramMedia"}}}},"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{"$ref":"#/components/schemas/UploadResponse"}}}},"400":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}},"description":"Bad Request"},"404":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}},"description":"Not Found"},"429":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}},"description":"Too Many Requests"},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}}}},"/v1/upload-telegram":{"post":{"summary":"Import Telegram Media (v1)","description":"Comprehensive Markdown description with parameters, headers, rate limits, and response format","operationId":"importTelegramMediaV1","parameters":[{"name":"source","in":"query","required":false,"schema":{"type":"string","default":"api","title":"Source"}},{"name":"userhash","in":"query","required":false,"schema":{"type":"string","title":"Userhash"}}],"requestBody":{"required":true,"content":{"application/x-www-form-urlencoded":{"schema":{"$ref":"#/components/schemas/Body_importTelegramMediaV1"}}}},"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{"$ref":"#/components/schemas/UploadResponse"}}}},"400":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}},"description":"Bad Request"},"404":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}},"description":"Not Found"},"429":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}},"description":"Too Many Requests"},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}}}},"/upload-url":{"post":{"summary":"Upload from URL","description":"Comprehensive Markdown description with parameters, headers, rate limits, and response format","operationId":"uploadFromUrl","parameters":[{"name":"source","in":"query","required":false,"schema":{"type":"string","default":"api","title":"Source"}},{"name":"userhash","in":"query","required":false,"schema":{"type":"string","title":"Userhash"}}],"requestBody":{"required":true,"content":{"application/x-www-form-urlencoded":{"schema":{"$ref":"#/components/schemas/Body_uploadFromUrl"}}}},"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{"$ref":"#/components/schemas/UploadResponse"}}}},"400":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}},"description":"Bad Request"},"404":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}},"description":"Not Found"},"429":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}},"description":"Too Many Requests"},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}}}},"/v1/upload-url":{"post":{"summary":"Upload from URL (v1)","description":"Comprehensive Markdown description with parameters, headers, rate limits, and response format","operationId":"uploadFromUrlV1","parameters":[{"name":"source","in":"query","required":false,"schema":{"type":"string","default":"api","title":"Source"}},{"name":"userhash","in":"query","required":false,"schema":{"type":"string","title":"Userhash"}}],"requestBody":{"required":true,"content":{"application/x-www-form-urlencoded":{"schema":{"$ref":"#/components/schemas/Body_uploadFromUrlV1"}}}},"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{"$ref":"#/components/schemas/UploadResponse"}}}},"400":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}},"description":"Bad Request"},"404":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}},"description":"Not Found"},"429":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}},"description":"Too Many Requests"},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}}}},"/upload-text":{"post":{"summary":"Upload Text","description":"Comprehensive Markdown description with parameters, headers, rate limits, and response format","operationId":"uploadPaste","parameters":[{"name":"source","in":"query","required":false,"schema":{"type":"string","default":"api","title":"Source"}},{"name":"userhash","in":"query","required":false,"schema":{"type":"string","title":"Userhash"}}],"requestBody":{"content":{"application/x-www-form-urlencoded":{"schema":{"$ref":"#/components/schemas/Body_uploadPaste"}}}},"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{"$ref":"#/components/schemas/UploadResponse"}}}},"400":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}},"description":"Bad Request"},"404":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}},"description":"Not Found"},"429":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}},"description":"Too Many Requests"},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}}}},"/v1/upload-text":{"post":{"summary":"Upload Text (v1)","description":"Comprehensive Markdown description with parameters, headers, rate limits, and response format","operationId":"uploadPasteV1","parameters":[{"name":"source","in":"query","required":false,"schema":{"type":"string","default":"api","title":"Source"}},{"name":"userhash","in":"query","required":false,"schema":{"type":"string","title":"Userhash"}}],"requestBody":{"content":{"application/x-www-form-urlencoded":{"schema":{"$ref":"#/components/schemas/Body_uploadPasteV1"}}}},"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{"$ref":"#/components/schemas/UploadResponse"}}}},"400":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}},"description":"Bad Request"},"404":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}},"description":"Not Found"},"429":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}},"description":"Too Many Requests"},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}}}},"/raw/{uid}":{"get":{"summary":"Get raw file content","description":"Retrieves raw unformatted content for text, paste, or code files with CORS enabled.","operationId":"raw_file_content_raw__uid__get","parameters":[{"name":"uid","in":"path","required":true,"schema":{"type":"string","title":"Uid"}},{"name":"pwd","in":"query","required":false,"schema":{"type":"string","title":"Pwd"}}],"responses":{"200":{"description":"Raw text content","content":{"application/json":{"schema":{}},"text/plain":{}}},"400":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}},"description":"Bad Request"},"404":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}},"description":"Not Found"},"429":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}},"description":"Too Many Requests"},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}}},"head":{"summary":"Get raw file content","description":"Retrieves raw unformatted content for text, paste, or code files with CORS enabled.","operationId":"raw_file_content_raw__uid__get","parameters":[{"name":"uid","in":"path","required":true,"schema":{"type":"string","title":"Uid"}},{"name":"pwd","in":"query","required":false,"schema":{"type":"string","title":"Pwd"}}],"responses":{"200":{"description":"Raw text content","content":{"application/json":{"schema":{}},"text/plain":{}}},"400":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}},"description":"Bad Request"},"404":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}},"description":"Not Found"},"429":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}},"description":"Too Many Requests"},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}}}},"/v1/raw/{uid}":{"get":{"summary":"Get raw file content (v1)","description":"Retrieves raw unformatted content for text, paste, or code files with CORS enabled.","operationId":"raw_file_content_v1_raw__uid__get","parameters":[{"name":"uid","in":"path","required":true,"schema":{"type":"string","title":"Uid"}},{"name":"pwd","in":"query","required":false,"schema":{"type":"string","title":"Pwd"}}],"responses":{"200":{"description":"Raw text content","content":{"application/json":{"schema":{}},"text/plain":{}}},"400":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}},"description":"Bad Request"},"404":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}},"description":"Not Found"},"429":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}},"description":"Too Many Requests"},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}}},"head":{"summary":"Get raw file content (v1)","description":"Retrieves raw unformatted content for text, paste, or code files with CORS enabled.","operationId":"raw_file_content_v1_raw__uid__get","parameters":[{"name":"uid","in":"path","required":true,"schema":{"type":"string","title":"Uid"}},{"name":"pwd","in":"query","required":false,"schema":{"type":"string","title":"Pwd"}}],"responses":{"200":{"description":"Raw text content","content":{"application/json":{"schema":{}},"text/plain":{}}},"400":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}},"description":"Bad Request"},"404":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}},"description":"Not Found"},"429":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}},"description":"Too Many Requests"},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}}}},"/file/{uid}":{"get":{"tags":["Files"],"summary":"Download or Stream File","description":"Streams or downloads an uploaded file by UID with full HTTP 206 Range video/audio seeking support and direct attachment download option via ?dl=1.","operationId":"download_file_file__uid__get","parameters":[{"name":"uid","in":"path","required":true,"schema":{"type":"string","title":"Uid"}},{"name":"pwd","in":"query","required":false,"schema":{"type":"string","title":"Pwd"}},{"name":"dl","in":"query","required":false,"schema":{"type":"integer","default":0,"title":"Dl"}}],"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}}},"head":{"tags":["Files"],"summary":"Download or Stream File","description":"Streams or downloads an uploaded file by UID with full HTTP 206 Range video/audio seeking support and direct attachment download option via ?dl=1.","operationId":"download_file_file__uid__get","parameters":[{"name":"uid","in":"path","required":true,"schema":{"type":"string","title":"Uid"}},{"name":"pwd","in":"query","required":false,"schema":{"type":"string","title":"Pwd"}},{"name":"dl","in":"query","required":false,"schema":{"type":"integer","default":0,"title":"Dl"}}],"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}}}},"/v1/file/{uid}":{"get":{"tags":["Files"],"summary":"Download or Stream File (v1)","description":"Streams or downloads an uploaded file by UID with full HTTP 206 Range video/audio seeking support and direct attachment download option via ?dl=1.","operationId":"download_file_v1_file__uid__get","parameters":[{"name":"uid","in":"path","required":true,"schema":{"type":"string","title":"Uid"}},{"name":"pwd","in":"query","required":false,"schema":{"type":"string","title":"Pwd"}},{"name":"dl","in":"query","required":false,"schema":{"type":"integer","default":0,"title":"Dl"}}],"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}}},"head":{"tags":["Files"],"summary":"Download or Stream File (v1)","description":"Streams or downloads an uploaded file by UID with full HTTP 206 Range video/audio seeking support and direct attachment download option via ?dl=1.","operationId":"download_file_v1_file__uid__get","parameters":[{"name":"uid","in":"path","required":true,"schema":{"type":"string","title":"Uid"}},{"name":"pwd","in":"query","required":false,"schema":{"type":"string","title":"Pwd"}},{"name":"dl","in":"query","required":false,"schema":{"type":"integer","default":0,"title":"Dl"}}],"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}}}},"/api/v1":{"get":{"tags":["Directory"],"summary":"Developer Resources Directory (v1)","description":"Returns a structured directory of all v1 developer resources, OpenAPI specification, and CLI tools.","operationId":"getDeveloperDirectoryV1","responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ApiDirectoryResponse"}}}}}}},"/api":{"get":{"tags":["Directory"],"summary":"Developer Resources Directory","description":"Returns a structured directory of all developer documentation, OpenAPI JSON/YAML specifications, LLM instructions, MCP server manifest, and CLI tool installers.","operationId":"getDeveloperDirectory","responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ApiDirectoryResponse"}}}}}}}},"components":{"schemas":{"ApiDirectoryResponse":{"properties":{"docs":{"type":"string","title":"Docs"},"openapi_json":{"type":"string","title":"Openapi Json"},"openapi_yaml":{"type":"string","title":"Openapi Yaml"},"llms_txt":{"type":"string","title":"Llms Txt"},"mcp":{"type":"string","title":"Mcp"},"cli":{"type":"string","title":"Cli"},"endpoints":{"type":"string","title":"Endpoints"}},"type":"object","required":["docs","openapi_json","openapi_yaml","llms_txt","mcp","cli","endpoints"],"title":"ApiDirectoryResponse"},"Body_importTelegramMedia":{"properties":{"url":{"type":"string","title":"Url"},"password":{"type":"string","title":"Password"},"max_downloads":{"type":"integer","title":"Max Downloads","default":0},"custom_slug":{"type":"string","title":"Custom Slug"},"cf_turnstile_response":{"type":"string","title":"Cf Turnstile Response"},"userhash":{"type":"string","title":"Userhash"}},"type":"object","required":["url"],"title":"Body_importTelegramMedia"},"Body_importTelegramMediaV1":{"properties":{"url":{"type":"string","title":"Url"},"password":{"type":"string","title":"Password"},"max_downloads":{"type":"integer","title":"Max Downloads","default":0},"custom_slug":{"type":"string","title":"Custom Slug"},"cf_turnstile_response":{"type":"string","title":"Cf Turnstile Response"},"userhash":{"type":"string","title":"Userhash"}},"type":"object","required":["url"],"title":"Body_importTelegramMediaV1"},"Body_inspectTelegramUrl":{"properties":{"url":{"type":"string","title":"Url"}},"type":"object","required":["url"],"title":"Body_inspectTelegramUrl"},"Body_inspectTelegramUrlV1":{"properties":{"url":{"type":"string","title":"Url"}},"type":"object","required":["url"],"title":"Body_inspectTelegramUrlV1"},"Body_uploadFile":{"properties":{"file":{"type":"string","contentMediaType":"application/octet-stream","title":"File"},"password":{"type":"string","title":"Password"},"max_downloads":{"type":"integer","title":"Max Downloads","default":0},"custom_slug":{"type":"string","title":"Custom Slug"},"cf_turnstile_response":{"type":"string","title":"Cf Turnstile Response"},"userhash":{"type":"string","title":"Userhash"}},"type":"object","required":["file"],"title":"Body_uploadFile"},"Body_uploadFileV1":{"properties":{"file":{"type":"string","contentMediaType":"application/octet-stream","title":"File"},"password":{"type":"string","title":"Password"},"max_downloads":{"type":"integer","title":"Max Downloads","default":0},"custom_slug":{"type":"string","title":"Custom Slug"},"cf_turnstile_response":{"type":"string","title":"Cf Turnstile Response"},"userhash":{"type":"string","title":"Userhash"}},"type":"object","required":["file"],"title":"Body_uploadFileV1"},"Body_uploadFromUrl":{"properties":{"url":{"type":"string","title":"Url"},"password":{"type":"string","title":"Password"},"max_downloads":{"type":"integer","title":"Max Downloads","default":0},"custom_slug":{"type":"string","title":"Custom Slug"},"cf_turnstile_response":{"type":"string","title":"Cf Turnstile Response"},"userhash":{"type":"string","title":"Userhash"}},"type":"object","required":["url"],"title":"Body_uploadFromUrl"},"Body_uploadFromUrlV1":{"properties":{"url":{"type":"string","title":"Url"},"password":{"type":"string","title":"Password"},"max_downloads":{"type":"integer","title":"Max Downloads","default":0},"custom_slug":{"type":"string","title":"Custom Slug"},"cf_turnstile_response":{"type":"string","title":"Cf Turnstile Response"},"userhash":{"type":"string","title":"Userhash"}},"type":"object","required":["url"],"title":"Body_uploadFromUrlV1"},"Body_uploadPaste":{"properties":{"text":{"type":"string","title":"Text"},"content":{"type":"string","title":"Content"},"title":{"type":"string","title":"Title"},"filename":{"type":"string","title":"Filename"},"syntax":{"type":"string","title":"Syntax"},"extension":{"type":"string","title":"Extension"},"password":{"type":"string","title":"Password"},"max_downloads":{"type":"integer","title":"Max Downloads","default":0},"custom_slug":{"type":"string","title":"Custom Slug"},"cf_turnstile_response":{"type":"string","title":"Cf Turnstile Response"},"userhash":{"type":"string","title":"Userhash"}},"type":"object","title":"Body_uploadPaste"},"Body_uploadPasteV1":{"properties":{"text":{"type":"string","title":"Text"},"content":{"type":"string","title":"Content"},"title":{"type":"string","title":"Title"},"filename":{"type":"string","title":"Filename"},"syntax":{"type":"string","title":"Syntax"},"extension":{"type":"string","title":"Extension"},"password":{"type":"string","title":"Password"},"max_downloads":{"type":"integer","title":"Max Downloads","default":0},"custom_slug":{"type":"string","title":"Custom Slug"},"cf_turnstile_response":{"type":"string","title":"Cf Turnstile Response"},"userhash":{"type":"string","title":"Userhash"}},"type":"object","title":"Body_uploadPasteV1"},"ErrorResponse":{"properties":{"success":{"type":"boolean","title":"Success","default":false},"error":{"type":"string","title":"Error"},"code":{"type":"string","title":"Code"},"message":{"type":"string","title":"Message"},"status_code":{"type":"integer","title":"Status Code"},"hint":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Hint"},"sitemap":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Sitemap"},"docs":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Docs"},"openapi":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Openapi"},"llms_txt":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Llms Txt"}},"type":"object","required":["error","code","message","status_code"],"title":"ErrorResponse"},"FileInfo":{"properties":{"uid":{"type":"string","title":"Uid"},"filename":{"type":"string","title":"Filename"},"size":{"type":"integer","title":"Size"},"mimetype":{"type":"string","title":"Mimetype"},"upload_time":{"type":"string","title":"Upload Time"},"download_count":{"type":"integer","title":"Download Count"},"max_downloads":{"type":"integer","title":"Max Downloads"},"is_password_protected":{"type":"boolean","title":"Is Password Protected"}},"type":"object","required":["uid","filename","size","mimetype","upload_time","download_count","max_downloads","is_password_protected"],"title":"FileInfo"},"HTTPValidationError":{"properties":{"detail":{"items":{"$ref":"#/components/schemas/ValidationError"},"type":"array","title":"Detail"}},"type":"object","title":"HTTPValidationError"},"ServerStats":{"properties":{"status":{"type":"string","title":"Status"},"uptime":{"type":"string","title":"Uptime"},"total_files":{"type":"integer","title":"Total Files"}},"type":"object","required":["status","uptime","total_files"],"title":"ServerStats"},"TelegramInfoResponse":{"properties":{"success":{"type":"boolean","title":"Success"},"type":{"type":"string","title":"Type"},"title":{"type":"string","title":"Title"},"size":{"type":"integer","title":"Size"},"channel":{"type":"string","title":"Channel"}},"type":"object","required":["success","type","title","size","channel"],"title":"TelegramInfoResponse"},"UploadResponse":{"properties":{"success":{"type":"boolean","title":"Success"},"url":{"type":"string","title":"Url"},"uid":{"type":"string","title":"Uid"},"delete_url":{"type":"string","title":"Delete Url"},"admin_url":{"type":"string","title":"Admin Url"},"password_protected":{"type":"boolean","title":"Password Protected"},"message":{"type":"string","title":"Message"}},"type":"object","required":["success","url","uid","delete_url","admin_url","password_protected","message"],"title":"UploadResponse"},"ValidationError":{"properties":{"loc":{"items":{"anyOf":[{"type":"string"},{"type":"integer"}]},"type":"array","title":"Location"},"msg":{"type":"string","title":"Message"},"type":{"type":"string","title":"Error Type"},"input":{"title":"Input"},"ctx":{"type":"object","title":"Context"}},"type":"object","required":["loc","msg","type"],"title":"ValidationError"}}}}