{"openapi":"3.0.0","info":{"description":"Kaggle public API: list competitions and files, download competition data, submit entries and view leaderboards; search/list/download datasets and manage versions and metadata; list/pull/push kernels (notebooks and scripts) with output and status; browse models with instances and versions; blob uploads for files.","version":["v1"]},"servers":[{"description":"Kaggle public API: list competitions and files, download competition data, submit entries and view leaderboards; search/list/download datasets and manage versions and metadata; list/pull/push kernels (notebooks and scripts) with output and status; browse models with instances and versions; blob uploads for files.","url":"https://api.apirails.com/kaggle"}],"paths":{"/competitions/list":{"get":{"tags":["Competitions"],"parameters":[{"name":"category","in":"query","description":"Category filter (e.g. all, featured, research, recruitment, gettingStarted, playground, community).","required":false,"schema":{"type":"string","example":""}},{"name":"group","in":"query","description":"Filter competitions by group: general, entered, inClass (default general).","required":false,"schema":{"type":"string","example":""}},{"name":"page","in":"query","description":"Page number (default 1).","required":false,"schema":{"type":"number","example":""}},{"name":"search","in":"query","description":"Search term.","required":false,"schema":{"type":"string","example":""}},{"name":"sort_by","in":"query","description":"Sort results by: groupDescending, prizeAscending, prizeDescending, recentlyCreated, oldestCreated, deadlineAscending, deadlineDescending (default best).","required":false,"schema":{"type":"string","example":""}}],"responses":{"401":{"description":"Bearer token required (Authorization header)","content":{"application/json":{}}}},"externalDocs":{"api_ref":"https://www.kaggle.com/docs/api","api_endpoint":"https://www.kaggle.com/api/v1/competitions/list"},"summary":"List Competitions","description":"","security":[{"bearerAuth":[]}]}},"/competitions/data/list/{id}":{"get":{"tags":["Competitions"],"parameters":[{"name":"id","in":"path","description":"Competition name (url slug), e.g. 'titanic'.","required":true,"schema":{"type":"string","example":""}},{"name":"page_size","in":"query","description":"Results per page.","required":false,"schema":{"type":"number","example":""}},{"name":"page_token","in":"query","description":"Page token for pagination.","required":false,"schema":{"type":"string","example":""}}],"responses":{"401":{"description":"Bearer token required (Authorization header)","content":{"application/json":{}}}},"externalDocs":{"api_ref":"https://www.kaggle.com/docs/api","api_endpoint":"https://www.kaggle.com/api/v1/competitions/data/list/{id}"},"summary":"List Competition Files","description":"","security":[{"bearerAuth":[]}]}},"/competitions/data/download-all/{id}":{"get":{"tags":["Competitions"],"parameters":[{"name":"id","in":"path","description":"Competition name (url slug).","required":true,"schema":{"type":"string","example":""}}],"responses":{"401":{"description":"Bearer token required (Authorization header)","content":{"application/json":{}}}},"externalDocs":{"api_ref":"https://www.kaggle.com/docs/api","api_endpoint":"https://www.kaggle.com/api/v1/competitions/data/download-all/{id}"},"summary":"Download All Competition Files","description":"","security":[{"bearerAuth":[]}]}},"/competitions/data/download/{id}/{fileName}":{"get":{"tags":["Competitions"],"parameters":[{"name":"fileName","in":"path","description":"Competition file name.","required":true,"schema":{"type":"string","example":""}},{"name":"id","in":"path","description":"Competition name (url slug).","required":true,"schema":{"type":"string","example":""}}],"responses":{"401":{"description":"Bearer token required (Authorization header)","content":{"application/json":{}}}},"externalDocs":{"api_ref":"https://www.kaggle.com/docs/api","api_endpoint":"https://www.kaggle.com/api/v1/competitions/data/download/{id}/{fileName}"},"summary":"Download Competition File","description":"","security":[{"bearerAuth":[]}]}},"/competitions/{id}/leaderboard/view":{"get":{"tags":["Competitions"],"parameters":[{"name":"id","in":"path","description":"Competition name (url slug).","required":true,"schema":{"type":"string","example":""}}],"responses":{"401":{"description":"Bearer token required (Authorization header)","content":{"application/json":{}}}},"externalDocs":{"api_ref":"https://www.kaggle.com/docs/api","api_endpoint":"https://www.kaggle.com/api/v1/competitions/{id}/leaderboard/view"},"summary":"View Competition Leaderboard","description":"","security":[{"bearerAuth":[]}]}},"/competitions/{id}/leaderboard/download":{"get":{"tags":["Competitions"],"parameters":[{"name":"id","in":"path","description":"Competition name (url slug).","required":true,"schema":{"type":"string","example":""}}],"responses":{"401":{"description":"Bearer token required (Authorization header)","content":{"application/json":{}}}},"externalDocs":{"api_ref":"https://www.kaggle.com/docs/api","api_endpoint":"https://www.kaggle.com/api/v1/competitions/{id}/leaderboard/download"},"summary":"Download Competition Leaderboard","description":"","security":[{"bearerAuth":[]}]}},"/competitions/submissions/list/{id}":{"get":{"tags":["Competitions"],"parameters":[{"name":"id","in":"path","description":"Competition name (url slug).","required":true,"schema":{"type":"string","example":""}},{"name":"page","in":"query","description":"Page number (default 1).","required":false,"schema":{"type":"number","example":""}}],"responses":{"401":{"description":"Bearer token required (Authorization header)","content":{"application/json":{}}}},"externalDocs":{"api_ref":"https://www.kaggle.com/docs/api","api_endpoint":"https://www.kaggle.com/api/v1/competitions/submissions/list/{id}"},"summary":"List Competition Submissions","description":"","security":[{"bearerAuth":[]}]}},"/competitions/{id}/submissions/url/{contentLength}/{lastModifiedDateUtc}":{"post":{"tags":["Competitions"],"parameters":[{"name":"contentLength","in":"path","description":"File size in bytes.","required":true,"schema":{"type":"number","example":""}},{"name":"id","in":"path","description":"Competition name (url slug).","required":true,"schema":{"type":"string","example":""}},{"name":"lastModifiedDateUtc","in":"path","description":"Last modified date as epoch milliseconds.","required":true,"schema":{"type":"number","example":""}}],"responses":{"401":{"description":"Bearer token required (Authorization header)","content":{"application/json":{}}}},"externalDocs":{"api_ref":"https://www.kaggle.com/docs/api","api_endpoint":"https://www.kaggle.com/api/v1/competitions/{id}/submissions/url/{contentLength}/{lastModifiedDateUtc}"},"summary":"Get Competition Submission Upload URL","description":"","security":[{"bearerAuth":[]}],"requestBody":{"description":"","required":true,"content":{"application/json":{"schema":{"type":"object","required":[],"properties":{"fileName":{"type":"string","description":"Name of the file to upload.","required":true}}},"example":{"fileName":"submission.csv"}}}}}},"/competitions/submissions/upload/{guid}/{contentLength}/{lastModifiedDateUtc}":{"post":{"tags":["Competitions"],"parameters":[{"name":"contentLength","in":"path","description":"File size in bytes.","required":true,"schema":{"type":"number","example":""}},{"name":"guid","in":"path","description":"GUID from the submission URL call.","required":true,"schema":{"type":"string","example":""}},{"name":"lastModifiedDateUtc","in":"path","description":"Last modified date as epoch milliseconds.","required":true,"schema":{"type":"number","example":""}}],"responses":{"401":{"description":"Bearer token required (Authorization header)","content":{"application/json":{}}}},"externalDocs":{"api_ref":"https://www.kaggle.com/docs/api","api_endpoint":"https://www.kaggle.com/api/v1/competitions/submissions/upload/{guid}/{contentLength}/{lastModifiedDateUtc}"},"summary":"Upload Competition Submission","description":"","security":[{"bearerAuth":[]}],"requestBody":{"description":"","required":false,"content":{"multipart/form-data":{"schema":{"type":"object","required":[],"properties":{"file":{"type":"string","format":"binary","description":"The submission file to upload.","required":true}}},"example":{"file":"value"}}}}}},"/competitions/submissions/submit/{id}":{"post":{"tags":["Competitions"],"parameters":[{"name":"id","in":"path","description":"Competition name (url slug).","required":true,"schema":{"type":"string","example":""}}],"responses":{"401":{"description":"Bearer token required (Authorization header)","content":{"application/json":{}}}},"externalDocs":{"api_ref":"https://www.kaggle.com/docs/api","api_endpoint":"https://www.kaggle.com/api/v1/competitions/submissions/submit/{id}"},"summary":"Submit Competition Entry","description":"","security":[{"bearerAuth":[]}],"requestBody":{"description":"","required":true,"content":{"application/json":{"schema":{"type":"object","required":[],"properties":{"blobFileTokens":{"type":"string","description":"Token identifying the location of the uploaded submission file.","required":true},"submissionDescription":{"type":"string","description":"Description of the submission.","required":true}}},"example":{"blobFileTokens":"value","submissionDescription":"my first entry"}}}}}},"/datasets/list":{"get":{"tags":["Datasets"],"parameters":[{"name":"filetype","in":"query","description":"File type filter: all, csv, sqlite, json, bigQuery (default all).","required":false,"schema":{"type":"string","example":""}},{"name":"group","in":"query","description":"Filter: my datasets vs public (default public).","required":false,"schema":{"type":"string","example":""}},{"name":"license","in":"query","description":"License filter by name (e.g. cc, gpl, odb).","required":false,"schema":{"type":"string","example":""}},{"name":"max_size","in":"query","description":"Max dataset size in bytes.","required":false,"schema":{"type":"number","example":""}},{"name":"min_size","in":"query","description":"Min dataset size in bytes.","required":false,"schema":{"type":"number","example":""}},{"name":"page","in":"query","description":"Page number (deprecated in favor of pageToken).","required":false,"schema":{"type":"number","example":""}},{"name":"search","in":"query","description":"Search term.","required":false,"schema":{"type":"string","example":""}},{"name":"size","in":"query","description":"Size filter: all, small, medium, large, huge, gigantic (default all).","required":false,"schema":{"type":"string","example":""}},{"name":"sort_by","in":"query","description":"Sort: hottest, votes, updated, active (default newest).","required":false,"schema":{"type":"string","example":""}},{"name":"tagids","in":"query","description":"Comma-separated tag ids.","required":false,"schema":{"type":"string","example":""}},{"name":"user","in":"query","description":"Filter by a specific owner's username.","required":false,"schema":{"type":"string","example":""}}],"responses":{"401":{"description":"Bearer token required (Authorization header)","content":{"application/json":{}}}},"externalDocs":{"api_ref":"https://www.kaggle.com/docs/api","api_endpoint":"https://www.kaggle.com/api/v1/datasets/list"},"summary":"List Datasets","description":"","security":[{"bearerAuth":[]}]}},"/datasets/list/{ownerSlug}/{datasetSlug}":{"get":{"tags":["Datasets"],"parameters":[{"name":"datasetSlug","in":"path","description":"Dataset url slug.","required":true,"schema":{"type":"string","example":""}},{"name":"ownerSlug","in":"path","description":"Dataset owner username.","required":true,"schema":{"type":"string","example":""}},{"name":"datasetVersionNumber","in":"query","description":"Dataset version number.","required":false,"schema":{"type":"number","example":""}},{"name":"page_size","in":"query","description":"Results per page.","required":false,"schema":{"type":"number","example":""}},{"name":"page_token","in":"query","description":"Page token for pagination.","required":false,"schema":{"type":"string","example":""}}],"responses":{"401":{"description":"Bearer token required (Authorization header)","content":{"application/json":{}}}},"externalDocs":{"api_ref":"https://www.kaggle.com/docs/api","api_endpoint":"https://www.kaggle.com/api/v1/datasets/list/{ownerSlug}/{datasetSlug}"},"summary":"List Dataset Files","description":"","security":[{"bearerAuth":[]}]}},"/datasets/download/{ownerSlug}/{datasetSlug}":{"get":{"tags":["Datasets"],"parameters":[{"name":"datasetSlug","in":"path","description":"Dataset url slug.","required":true,"schema":{"type":"string","example":""}},{"name":"ownerSlug","in":"path","description":"Dataset owner username.","required":true,"schema":{"type":"string","example":""}},{"name":"datasetVersionNumber","in":"query","description":"Dataset version number.","required":false,"schema":{"type":"number","example":""}}],"responses":{"401":{"description":"Bearer token required (Authorization header)","content":{"application/json":{}}}},"externalDocs":{"api_ref":"https://www.kaggle.com/docs/api","api_endpoint":"https://www.kaggle.com/api/v1/datasets/download/{ownerSlug}/{datasetSlug}"},"summary":"Download Dataset","description":"","security":[{"bearerAuth":[]}]}},"/datasets/download/{ownerSlug}/{datasetSlug}/{fileName}":{"get":{"tags":["Datasets"],"parameters":[{"name":"datasetSlug","in":"path","description":"Dataset url slug.","required":true,"schema":{"type":"string","example":""}},{"name":"fileName","in":"path","description":"File name within the dataset.","required":true,"schema":{"type":"string","example":""}},{"name":"ownerSlug","in":"path","description":"Dataset owner username.","required":true,"schema":{"type":"string","example":""}},{"name":"datasetVersionNumber","in":"query","description":"Dataset version number.","required":false,"schema":{"type":"number","example":""}}],"responses":{"401":{"description":"Bearer token required (Authorization header)","content":{"application/json":{}}}},"externalDocs":{"api_ref":"https://www.kaggle.com/docs/api","api_endpoint":"https://www.kaggle.com/api/v1/datasets/download/{ownerSlug}/{datasetSlug}/{fileName}"},"summary":"Download Dataset File","description":"","security":[{"bearerAuth":[]}]}},"/datasets/status/{ownerSlug}/{datasetSlug}":{"get":{"tags":["Datasets"],"parameters":[{"name":"datasetSlug","in":"path","description":"Dataset url slug.","required":true,"schema":{"type":"string","example":""}},{"name":"ownerSlug","in":"path","description":"Dataset owner username.","required":true,"schema":{"type":"string","example":""}}],"responses":{"401":{"description":"Bearer token required (Authorization header)","content":{"application/json":{}}}},"externalDocs":{"api_ref":"https://www.kaggle.com/docs/api","api_endpoint":"https://www.kaggle.com/api/v1/datasets/status/{ownerSlug}/{datasetSlug}"},"summary":"Dataset Status","description":"","security":[{"bearerAuth":[]}]}},"/datasets/metadata/{ownerSlug}/{datasetSlug}":{"get":{"tags":["Datasets"],"parameters":[{"name":"datasetSlug","in":"path","description":"Dataset url slug.","required":true,"schema":{"type":"string","example":""}},{"name":"ownerSlug","in":"path","description":"Dataset owner username.","required":true,"schema":{"type":"string","example":""}}],"responses":{"401":{"description":"Bearer token required (Authorization header)","content":{"application/json":{}}}},"externalDocs":{"api_ref":"https://www.kaggle.com/docs/api","api_endpoint":"https://www.kaggle.com/api/v1/datasets/metadata/{ownerSlug}/{datasetSlug}"},"summary":"Get Dataset Metadata","description":"","security":[{"bearerAuth":[]}]},"post":{"tags":["Datasets"],"parameters":[{"name":"datasetSlug","in":"path","description":"Dataset url slug.","required":true,"schema":{"type":"string","example":""}},{"name":"ownerSlug","in":"path","description":"Dataset owner username.","required":true,"schema":{"type":"string","example":""}}],"responses":{"401":{"description":"Bearer token required (Authorization header)","content":{"application/json":{}}}},"externalDocs":{"api_ref":"https://www.kaggle.com/docs/api","api_endpoint":"https://www.kaggle.com/api/v1/datasets/metadata/{ownerSlug}/{datasetSlug}"},"summary":"Update Dataset Metadata","description":"","security":[{"bearerAuth":[]}],"requestBody":{"description":"","required":true,"content":{"application/json":{"schema":{"type":"object","required":[],"properties":{"settings":{"type":"string","description":"JSON-serialized DatasetSettings object (title, subtitle, description, isPrivate, licenses, keywords, collaborators, data).","required":true}}},"example":{"settings":"{\"title\":\"My Dataset\"}"}}}}}},"/datasets/create/new":{"post":{"tags":["Datasets"],"parameters":[],"responses":{"401":{"description":"Bearer token required (Authorization header)","content":{"application/json":{}}}},"externalDocs":{"api_ref":"https://www.kaggle.com/docs/api","api_endpoint":"https://www.kaggle.com/api/v1/datasets/create/new"},"summary":"Create Dataset","description":"","security":[{"bearerAuth":[]}],"requestBody":{"description":"","required":true,"content":{"application/json":{"schema":{"type":"object","required":[],"properties":{"categoryIds":{"type":"string","description":"JSON array of category ids."},"convertToCsv":{"type":"boolean","description":"Automatically convert tabular files to CSV."},"description":{"type":"string","description":"Markdown description."},"files":{"type":"string","description":"JSON array of {token, name} file objects (from /blobs/upload)."},"isPrivate":{"type":"boolean","description":"Whether the dataset is private."},"licenseName":{"type":"string","description":"License name (e.g. CC0-1.0)."},"ownerSlug":{"type":"string","description":"Owner username (your own).","required":true},"slug":{"type":"string","description":"Dataset url slug.","required":true},"subtitle":{"type":"string","description":"Subtitle shown under the title."},"title":{"type":"string","description":"Dataset title.","required":true}}},"example":{"categoryIds":"[\"inequality\"]","convertToCsv":true,"description":"value","files":"[{\"token\":\"abc\",\"name\":\"a.csv\"}]","isPrivate":true,"licenseName":"CC0-1.0","ownerSlug":"owner","slug":"my-dataset","subtitle":"value","title":"My Dataset"}}}}}},"/datasets/create/version/{ownerSlug}/{datasetSlug}":{"post":{"tags":["Datasets"],"parameters":[{"name":"datasetSlug","in":"path","description":"Dataset url slug.","required":true,"schema":{"type":"string","example":""}},{"name":"ownerSlug","in":"path","description":"Dataset owner username.","required":true,"schema":{"type":"string","example":""}}],"responses":{"401":{"description":"Bearer token required (Authorization header)","content":{"application/json":{}}}},"externalDocs":{"api_ref":"https://www.kaggle.com/docs/api","api_endpoint":"https://www.kaggle.com/api/v1/datasets/create/version/{ownerSlug}/{datasetSlug}"},"summary":"Create Dataset Version","description":"","security":[{"bearerAuth":[]}],"requestBody":{"description":"","required":true,"content":{"application/json":{"schema":{"type":"object","required":[],"properties":{"categoryIds":{"type":"string","description":"JSON array of category ids."},"convertToCsv":{"type":"boolean","description":"Automatically convert tabular files to CSV."},"deleteOldVersions":{"type":"boolean","description":"Whether to delete old versions."},"description":{"type":"string","description":"Markdown description."},"files":{"type":"string","description":"JSON array of {token, name} file objects."},"subtitle":{"type":"string","description":"New subtitle."},"versionNotes":{"type":"string","description":"Notes describing the new version.","required":true}}},"example":{"categoryIds":"[]","convertToCsv":true,"deleteOldVersions":"","description":"value","files":"[{\"token\":\"abc\",\"name\":\"a.csv\"}]","subtitle":"value","versionNotes":"updated data"}}}}}},"/datasets/create/version/{id}":{"post":{"tags":["Datasets"],"parameters":[{"name":"id","in":"path","description":"Numeric dataset id.","required":true,"schema":{"type":"number","example":""}}],"responses":{"401":{"description":"Bearer token required (Authorization header)","content":{"application/json":{}}}},"externalDocs":{"api_ref":"https://www.kaggle.com/docs/api","api_endpoint":"https://www.kaggle.com/api/v1/datasets/create/version/{id}"},"summary":"Create Dataset Version By Id","description":"","security":[{"bearerAuth":[]}],"requestBody":{"description":"","required":true,"content":{"application/json":{"schema":{"type":"object","required":[],"properties":{"categoryIds":{"type":"string","description":"JSON array of category ids."},"convertToCsv":{"type":"boolean","description":"Automatically convert tabular files to CSV."},"deleteOldVersions":{"type":"boolean","description":"Whether to delete old versions."},"description":{"type":"string","description":"Markdown description."},"files":{"type":"string","description":"JSON array of {token, name} file objects."},"subtitle":{"type":"string","description":"New subtitle."},"versionNotes":{"type":"string","description":"Notes describing the new version.","required":true}}},"example":{"categoryIds":"[]","convertToCsv":true,"deleteOldVersions":"","description":"value","files":"[]","subtitle":"value","versionNotes":"updated data"}}}}}},"/kernels/list":{"get":{"tags":["Kernels"],"parameters":[{"name":"competition","in":"query","description":"Filter by url slug of an attached competition.","required":false,"schema":{"type":"string","example":""}},{"name":"dataset","in":"query","description":"Filter by url slug of an attached dataset.","required":false,"schema":{"type":"string","example":""}},{"name":"group","in":"query","description":"Filter: everyone vs profile (default everyone).","required":false,"schema":{"type":"string","example":""}},{"name":"kernel_type","in":"query","description":"Filter: all, script, notebook (default all).","required":false,"schema":{"type":"string","example":""}},{"name":"language","in":"query","description":"Filter: all, python, r, sqlite, julia (default all).","required":false,"schema":{"type":"string","example":""}},{"name":"output_type","in":"query","description":"Filter: all, visualization (default all).","required":false,"schema":{"type":"string","example":""}},{"name":"page","in":"query","description":"Page number (deprecated).","required":false,"schema":{"type":"number","example":""}},{"name":"page_size","in":"query","description":"Results per page.","required":false,"schema":{"type":"number","example":""}},{"name":"parent_kernel","in":"query","description":"Filter by parent kernel url slug.","required":false,"schema":{"type":"string","example":""}},{"name":"search","in":"query","description":"Search term.","required":false,"schema":{"type":"string","example":""}},{"name":"sort_by","in":"query","description":"Sort: hotness, commentCount, dateCreated, dateRun, relevance, scoreAscending, scoreDescending, viewCount, voteCount (default hotness).","required":false,"schema":{"type":"string","example":""}},{"name":"user","in":"query","description":"Filter by username.","required":false,"schema":{"type":"string","example":""}}],"responses":{"401":{"description":"Bearer token required (Authorization header)","content":{"application/json":{}}}},"externalDocs":{"api_ref":"https://www.kaggle.com/docs/api","api_endpoint":"https://www.kaggle.com/api/v1/kernels/list"},"summary":"List Kernels","description":"","security":[{"bearerAuth":[]}]}},"/kernels/files":{"get":{"tags":["Kernels"],"parameters":[{"name":"kernel_slug","in":"query","description":"Kernel url slug.","required":true,"schema":{"type":"string","example":""}},{"name":"kernel_version_number","in":"query","description":"Kernel version number.","required":false,"schema":{"type":"number","example":""}},{"name":"page_size","in":"query","description":"Results per page.","required":false,"schema":{"type":"number","example":""}},{"name":"page_token","in":"query","description":"Page token for pagination.","required":false,"schema":{"type":"string","example":""}},{"name":"user_name","in":"query","description":"Kernel owner username.","required":true,"schema":{"type":"string","example":""}}],"responses":{"401":{"description":"Bearer token required (Authorization header)","content":{"application/json":{}}}},"externalDocs":{"api_ref":"https://www.kaggle.com/docs/api","api_endpoint":"https://www.kaggle.com/api/v1/kernels/files"},"summary":"List Kernel Files","description":"","security":[{"bearerAuth":[]}]}},"/kernels/output":{"get":{"tags":["Kernels"],"parameters":[{"name":"kernel_slug","in":"query","description":"Kernel url slug.","required":true,"schema":{"type":"string","example":""}},{"name":"user_name","in":"query","description":"Kernel owner username.","required":true,"schema":{"type":"string","example":""}}],"responses":{"401":{"description":"Bearer token required (Authorization header)","content":{"application/json":{}}}},"externalDocs":{"api_ref":"https://www.kaggle.com/docs/api","api_endpoint":"https://www.kaggle.com/api/v1/kernels/output"},"summary":"Get Kernel Output","description":"","security":[{"bearerAuth":[]}]}},"/kernels/pull":{"get":{"tags":["Kernels"],"parameters":[{"name":"kernel_slug","in":"query","description":"Kernel url slug.","required":true,"schema":{"type":"string","example":""}},{"name":"user_name","in":"query","description":"Kernel owner username.","required":true,"schema":{"type":"string","example":""}}],"responses":{"401":{"description":"Bearer token required (Authorization header)","content":{"application/json":{}}}},"externalDocs":{"api_ref":"https://www.kaggle.com/docs/api","api_endpoint":"https://www.kaggle.com/api/v1/kernels/pull"},"summary":"Pull Kernel","description":"","security":[{"bearerAuth":[]}]}},"/kernels/status":{"get":{"tags":["Kernels"],"parameters":[{"name":"kernel_slug","in":"query","description":"Kernel url slug.","required":true,"schema":{"type":"string","example":""}},{"name":"user_name","in":"query","description":"Kernel owner username.","required":true,"schema":{"type":"string","example":""}}],"responses":{"401":{"description":"Bearer token required (Authorization header)","content":{"application/json":{}}}},"externalDocs":{"api_ref":"https://www.kaggle.com/docs/api","api_endpoint":"https://www.kaggle.com/api/v1/kernels/status"},"summary":"Kernel Status","description":"","security":[{"bearerAuth":[]}]}},"/kernels/push":{"post":{"tags":["Kernels"],"parameters":[],"responses":{"401":{"description":"Bearer token required (Authorization header)","content":{"application/json":{}}}},"externalDocs":{"api_ref":"https://www.kaggle.com/docs/api","api_endpoint":"https://www.kaggle.com/api/v1/kernels/push"},"summary":"Push Kernel","description":"","security":[{"bearerAuth":[]}],"requestBody":{"description":"","required":true,"content":{"application/json":{"schema":{"type":"object","required":[],"properties":{"text":{"type":"string","description":"The kernel source code (notebook JSON or script text).","required":true},"categoryIds":{"type":"string","description":"JSON array of category ids."},"competitionDataSources":{"type":"string","description":"JSON array of competition url slugs."},"datasetDataSources":{"type":"string","description":"JSON array of dataset url slugs to attach."},"dockerImagePinningType":{"type":"string","description":"Pin the docker image: original, latest, custom."},"enableGpu":{"type":"boolean","description":"Enable GPU."},"enableInternet":{"type":"boolean","description":"Enable internet access."},"enableTpu":{"type":"boolean","description":"Enable TPU."},"id":{"type":"number","description":"Numeric kernel id for an existing kernel."},"isPrivate":{"type":"boolean","description":"Whether the kernel is private."},"kernelDataSources":{"type":"string","description":"JSON array of kernel url slugs."},"kernelType":{"type":"string","description":"script or notebook.","required":true},"language":{"type":"string","description":"python, r, rmarkdown, sqlite, julia.","required":true},"modelDataSources":{"type":"string","description":"JSON array of model instance slugs."},"newTitle":{"type":"string","description":"Title for a new kernel.","required":true},"slug":{"type":"string","description":"Kernel url slug (title-cased)."}}},"example":{"text":"print('hi')","categoryIds":"[]","competitionDataSources":"[\"titanic\"]","datasetDataSources":"[\"owner/dataset\"]","dockerImagePinningType":"original","enableGpu":"","enableInternet":true,"enableTpu":"","id":1234,"isPrivate":true,"kernelDataSources":"[]","kernelType":"notebook","language":"python","modelDataSources":"[]","newTitle":"My Notebook","slug":"my-notebook"}}}}}},"/models/list":{"get":{"tags":["Models"],"parameters":[{"name":"owner","in":"query","description":"Filter by model owner username.","required":false,"schema":{"type":"string","example":""}},{"name":"page_size","in":"query","description":"Results per page.","required":false,"schema":{"type":"number","example":""}},{"name":"page_token","in":"query","description":"Page token for pagination.","required":false,"schema":{"type":"string","example":""}},{"name":"search","in":"query","description":"Search term.","required":false,"schema":{"type":"string","example":""}},{"name":"sort_by","in":"query","description":"Sort: hotness, downloadCount, voteCount, dateCreated, dateModified (default hotness).","required":false,"schema":{"type":"string","example":""}}],"responses":{"401":{"description":"Bearer token required (Authorization header)","content":{"application/json":{}}}},"externalDocs":{"api_ref":"https://www.kaggle.com/docs/api","api_endpoint":"https://www.kaggle.com/api/v1/models/list"},"summary":"List Models","description":"","security":[{"bearerAuth":[]}]}},"/models/create/new":{"post":{"tags":["Models"],"parameters":[],"responses":{"401":{"description":"Bearer token required (Authorization header)","content":{"application/json":{}}}},"externalDocs":{"api_ref":"https://www.kaggle.com/docs/api","api_endpoint":"https://www.kaggle.com/api/v1/models/create/new"},"summary":"Create Model","description":"","security":[{"bearerAuth":[]}],"requestBody":{"description":"","required":true,"content":{"application/json":{"schema":{"type":"object","required":[],"properties":{"description":{"type":"string","description":"Markdown description."},"isPrivate":{"type":"boolean","description":"Whether the model is private."},"ownerSlug":{"type":"string","description":"Owner username.","required":true},"provenanceSources":{"type":"string","description":"Provenance sources."},"publishTime":{"type":"string","description":"Publish date (YYYY-MM-DD)."},"slug":{"type":"string","description":"Model url slug.","required":true},"subtitle":{"type":"string","description":"Subtitle."},"title":{"type":"string","description":"Model title.","required":true}}},"example":{"description":"value","isPrivate":true,"ownerSlug":"owner","provenanceSources":"value","publishTime":"2026-01-01","slug":"my-model","subtitle":"value","title":"My Model"}}}}}},"/models/{ownerSlug}/{modelSlug}/get":{"get":{"tags":["Models"],"parameters":[{"name":"modelSlug","in":"path","description":"Model url slug.","required":true,"schema":{"type":"string","example":""}},{"name":"ownerSlug","in":"path","description":"Model owner username.","required":true,"schema":{"type":"string","example":""}}],"responses":{"401":{"description":"Bearer token required (Authorization header)","content":{"application/json":{}}}},"externalDocs":{"api_ref":"https://www.kaggle.com/docs/api","api_endpoint":"https://www.kaggle.com/api/v1/models/{ownerSlug}/{modelSlug}/get"},"summary":"Get Model","description":"","security":[{"bearerAuth":[]}]}},"/models/{ownerSlug}/{modelSlug}/update":{"post":{"tags":["Models"],"parameters":[{"name":"modelSlug","in":"path","description":"Model url slug.","required":true,"schema":{"type":"string","example":""}},{"name":"ownerSlug","in":"path","description":"Model owner username.","required":true,"schema":{"type":"string","example":""}}],"responses":{"401":{"description":"Bearer token required (Authorization header)","content":{"application/json":{}}}},"externalDocs":{"api_ref":"https://www.kaggle.com/docs/api","api_endpoint":"https://www.kaggle.com/api/v1/models/{ownerSlug}/{modelSlug}/update"},"summary":"Update Model","description":"","security":[{"bearerAuth":[]}],"requestBody":{"description":"","required":true,"content":{"application/json":{"schema":{"type":"object","required":[],"properties":{"description":{"type":"string","description":"Markdown description."},"isPrivate":{"type":"boolean","description":"Whether the model is private."},"provenanceSources":{"type":"string","description":"Provenance sources."},"publishTime":{"type":"string","description":"Publish date (YYYY-MM-DD)."},"subtitle":{"type":"string","description":"New subtitle."},"title":{"type":"string","description":"New title."},"updateMask":{"type":"string","description":"Comma-separated list of fields to update."}}},"example":{"description":"value","isPrivate":true,"provenanceSources":"value","publishTime":"2026-01-01","subtitle":"value","title":"My Model","updateMask":"title,subtitle"}}}}}},"/models/{ownerSlug}/{modelSlug}/delete":{"post":{"tags":["Models"],"parameters":[{"name":"modelSlug","in":"path","description":"Model url slug.","required":true,"schema":{"type":"string","example":""}},{"name":"ownerSlug","in":"path","description":"Model owner username.","required":true,"schema":{"type":"string","example":""}}],"responses":{"401":{"description":"Bearer token required (Authorization header)","content":{"application/json":{}}}},"externalDocs":{"api_ref":"https://www.kaggle.com/docs/api","api_endpoint":"https://www.kaggle.com/api/v1/models/{ownerSlug}/{modelSlug}/delete"},"summary":"Delete Model","description":"","security":[{"bearerAuth":[]}],"requestBody":{"description":"","required":true,"content":{"application/json":{"schema":{"type":"object","required":[],"properties":{}},"example":{}}}}}},"/models/{ownerSlug}/{modelSlug}/create/instance":{"post":{"tags":["Models"],"parameters":[{"name":"modelSlug","in":"path","description":"Model url slug.","required":true,"schema":{"type":"string","example":""}},{"name":"ownerSlug","in":"path","description":"Model owner username.","required":true,"schema":{"type":"string","example":""}}],"responses":{"401":{"description":"Bearer token required (Authorization header)","content":{"application/json":{}}}},"externalDocs":{"api_ref":"https://www.kaggle.com/docs/api","api_endpoint":"https://www.kaggle.com/api/v1/models/{ownerSlug}/{modelSlug}/create/instance"},"summary":"Create Model Instance","description":"","security":[{"bearerAuth":[]}],"requestBody":{"description":"","required":true,"content":{"application/json":{"schema":{"type":"object","required":[],"properties":{"baseModelInstance":{"type":"string","description":"Base model instance if fine-tuned."},"externalBaseModelUrl":{"type":"string","description":"External base model URL."},"files":{"type":"string","description":"JSON array of {token, name} file objects."},"fineTunable":{"type":"boolean","description":"Whether the model is fine-tunable."},"framework":{"type":"string","description":"Framework: jax, keras, pytorch, tensorflow2, onnx, h2o, lightgbm, xgboost, scikit-learn.","required":true},"instanceSlug":{"type":"string","description":"Model instance url slug.","required":true},"licenseName":{"type":"string","description":"License name (e.g. Apache-2.0)."},"modelInstanceType":{"type":"string","description":"Type slug if from a collection."},"overview":{"type":"string","description":"Markdown overview."},"trainingData":{"type":"string","description":"JSON array of training data references."},"usage":{"type":"string","description":"Markdown usage notes."}}},"example":{"baseModelInstance":"value","externalBaseModelUrl":"value","files":"[]","fineTunable":"","framework":"pytorch","instanceSlug":"pytorch","licenseName":"Apache-2.0","modelInstanceType":"value","overview":"value","trainingData":"[]","usage":"value"}}}}}},"/models/{ownerSlug}/{modelSlug}/{framework}/{instanceSlug}/get":{"get":{"tags":["Models"],"parameters":[{"name":"framework","in":"path","description":"Framework name.","required":true,"schema":{"type":"string","example":""}},{"name":"instanceSlug","in":"path","description":"Model instance url slug.","required":true,"schema":{"type":"string","example":""}},{"name":"modelSlug","in":"path","description":"Model url slug.","required":true,"schema":{"type":"string","example":""}},{"name":"ownerSlug","in":"path","description":"Model owner username.","required":true,"schema":{"type":"string","example":""}}],"responses":{"401":{"description":"Bearer token required (Authorization header)","content":{"application/json":{}}}},"externalDocs":{"api_ref":"https://www.kaggle.com/docs/api","api_endpoint":"https://www.kaggle.com/api/v1/models/{ownerSlug}/{modelSlug}/{framework}/{instanceSlug}/get"},"summary":"Get Model Instance","description":"","security":[{"bearerAuth":[]}]}},"/models/{ownerSlug}/{modelSlug}/{framework}/{instanceSlug}/update":{"post":{"tags":["Models"],"parameters":[{"name":"framework","in":"path","description":"Framework name.","required":true,"schema":{"type":"string","example":""}},{"name":"instanceSlug","in":"path","description":"Model instance url slug.","required":true,"schema":{"type":"string","example":""}},{"name":"modelSlug","in":"path","description":"Model url slug.","required":true,"schema":{"type":"string","example":""}},{"name":"ownerSlug","in":"path","description":"Model owner username.","required":true,"schema":{"type":"string","example":""}}],"responses":{"401":{"description":"Bearer token required (Authorization header)","content":{"application/json":{}}}},"externalDocs":{"api_ref":"https://www.kaggle.com/docs/api","api_endpoint":"https://www.kaggle.com/api/v1/models/{ownerSlug}/{modelSlug}/{framework}/{instanceSlug}/update"},"summary":"Update Model Instance","description":"","security":[{"bearerAuth":[]}],"requestBody":{"description":"","required":true,"content":{"application/json":{"schema":{"type":"object","required":[],"properties":{"baseModelInstance":{"type":"string","description":"Base model instance."},"externalBaseModelUrl":{"type":"string","description":"External base model URL."},"fineTunable":{"type":"boolean","description":"Whether the model is fine-tunable."},"licenseName":{"type":"string","description":"License name."},"modelInstanceType":{"type":"string","description":"Type slug."},"overview":{"type":"string","description":"Markdown overview."},"trainingData":{"type":"string","description":"JSON array of training data references."},"updateMask":{"type":"string","description":"Comma-separated list of fields to update."},"usage":{"type":"string","description":"Markdown usage notes."}}},"example":{"baseModelInstance":"value","externalBaseModelUrl":"value","fineTunable":"","licenseName":"Apache-2.0","modelInstanceType":"value","overview":"value","trainingData":"[]","updateMask":"overview,usage","usage":"value"}}}}}},"/models/{ownerSlug}/{modelSlug}/{framework}/{instanceSlug}/delete":{"post":{"tags":["Models"],"parameters":[{"name":"framework","in":"path","description":"Framework name.","required":true,"schema":{"type":"string","example":""}},{"name":"instanceSlug","in":"path","description":"Model instance url slug.","required":true,"schema":{"type":"string","example":""}},{"name":"modelSlug","in":"path","description":"Model url slug.","required":true,"schema":{"type":"string","example":""}},{"name":"ownerSlug","in":"path","description":"Model owner username.","required":true,"schema":{"type":"string","example":""}}],"responses":{"401":{"description":"Bearer token required (Authorization header)","content":{"application/json":{}}}},"externalDocs":{"api_ref":"https://www.kaggle.com/docs/api","api_endpoint":"https://www.kaggle.com/api/v1/models/{ownerSlug}/{modelSlug}/{framework}/{instanceSlug}/delete"},"summary":"Delete Model Instance","description":"","security":[{"bearerAuth":[]}],"requestBody":{"description":"","required":true,"content":{"application/json":{"schema":{"type":"object","required":[],"properties":{}},"example":{}}}}}},"/models/{ownerSlug}/{modelSlug}/{framework}/{instanceSlug}/files":{"get":{"tags":["Models"],"parameters":[{"name":"framework","in":"path","description":"Framework name.","required":true,"schema":{"type":"string","example":""}},{"name":"instanceSlug","in":"path","description":"Model instance url slug.","required":true,"schema":{"type":"string","example":""}},{"name":"modelSlug","in":"path","description":"Model url slug.","required":true,"schema":{"type":"string","example":""}},{"name":"ownerSlug","in":"path","description":"Model owner username.","required":true,"schema":{"type":"string","example":""}},{"name":"page_size","in":"query","description":"Results per page.","required":false,"schema":{"type":"number","example":""}},{"name":"page_token","in":"query","description":"Page token for pagination.","required":false,"schema":{"type":"string","example":""}}],"responses":{"401":{"description":"Bearer token required (Authorization header)","content":{"application/json":{}}}},"externalDocs":{"api_ref":"https://www.kaggle.com/docs/api","api_endpoint":"https://www.kaggle.com/api/v1/models/{ownerSlug}/{modelSlug}/{framework}/{instanceSlug}/files"},"summary":"List Model Instance Files","description":"","security":[{"bearerAuth":[]}]}},"/models/{ownerSlug}/{modelSlug}/{framework}/{instanceSlug}/create/version":{"post":{"tags":["Models"],"parameters":[{"name":"framework","in":"path","description":"Framework name.","required":true,"schema":{"type":"string","example":""}},{"name":"instanceSlug","in":"path","description":"Model instance url slug.","required":true,"schema":{"type":"string","example":""}},{"name":"modelSlug","in":"path","description":"Model url slug.","required":true,"schema":{"type":"string","example":""}},{"name":"ownerSlug","in":"path","description":"Model owner username.","required":true,"schema":{"type":"string","example":""}}],"responses":{"401":{"description":"Bearer token required (Authorization header)","content":{"application/json":{}}}},"externalDocs":{"api_ref":"https://www.kaggle.com/docs/api","api_endpoint":"https://www.kaggle.com/api/v1/models/{ownerSlug}/{modelSlug}/{framework}/{instanceSlug}/create/version"},"summary":"Create Model Instance Version","description":"","security":[{"bearerAuth":[]}],"requestBody":{"description":"","required":true,"content":{"application/json":{"schema":{"type":"object","required":[],"properties":{"files":{"type":"string","description":"JSON array of {token, name} file objects."},"versionNotes":{"type":"string","description":"Notes describing the version.","required":true}}},"example":{"files":"[]","versionNotes":"v2"}}}}}},"/models/{ownerSlug}/{modelSlug}/{framework}/{instanceSlug}/{versionNumber}/files":{"get":{"tags":["Models"],"parameters":[{"name":"framework","in":"path","description":"Framework name.","required":true,"schema":{"type":"string","example":""}},{"name":"instanceSlug","in":"path","description":"Model instance url slug.","required":true,"schema":{"type":"string","example":""}},{"name":"modelSlug","in":"path","description":"Model url slug.","required":true,"schema":{"type":"string","example":""}},{"name":"ownerSlug","in":"path","description":"Model owner username.","required":true,"schema":{"type":"string","example":""}},{"name":"versionNumber","in":"path","description":"Version number.","required":true,"schema":{"type":"number","example":""}},{"name":"page_size","in":"query","description":"Results per page.","required":false,"schema":{"type":"number","example":""}},{"name":"page_token","in":"query","description":"Page token for pagination.","required":false,"schema":{"type":"string","example":""}}],"responses":{"401":{"description":"Bearer token required (Authorization header)","content":{"application/json":{}}}},"externalDocs":{"api_ref":"https://www.kaggle.com/docs/api","api_endpoint":"https://www.kaggle.com/api/v1/models/{ownerSlug}/{modelSlug}/{framework}/{instanceSlug}/{versionNumber}/files"},"summary":"List Model Instance Version Files","description":"","security":[{"bearerAuth":[]}]}},"/models/{ownerSlug}/{modelSlug}/{framework}/{instanceSlug}/{versionNumber}/download":{"get":{"tags":["Models"],"parameters":[{"name":"framework","in":"path","description":"Framework name.","required":true,"schema":{"type":"string","example":""}},{"name":"instanceSlug","in":"path","description":"Model instance url slug.","required":true,"schema":{"type":"string","example":""}},{"name":"modelSlug","in":"path","description":"Model url slug.","required":true,"schema":{"type":"string","example":""}},{"name":"ownerSlug","in":"path","description":"Model owner username.","required":true,"schema":{"type":"string","example":""}},{"name":"versionNumber","in":"path","description":"Version number.","required":true,"schema":{"type":"number","example":""}}],"responses":{"401":{"description":"Bearer token required (Authorization header)","content":{"application/json":{}}}},"externalDocs":{"api_ref":"https://www.kaggle.com/docs/api","api_endpoint":"https://www.kaggle.com/api/v1/models/{ownerSlug}/{modelSlug}/{framework}/{instanceSlug}/{versionNumber}/download"},"summary":"Download Model Instance Version","description":"","security":[{"bearerAuth":[]}]}},"/models/{ownerSlug}/{modelSlug}/{framework}/{instanceSlug}/{versionNumber}/delete":{"post":{"tags":["Models"],"parameters":[{"name":"framework","in":"path","description":"Framework name.","required":true,"schema":{"type":"string","example":""}},{"name":"instanceSlug","in":"path","description":"Model instance url slug.","required":true,"schema":{"type":"string","example":""}},{"name":"modelSlug","in":"path","description":"Model url slug.","required":true,"schema":{"type":"string","example":""}},{"name":"ownerSlug","in":"path","description":"Model owner username.","required":true,"schema":{"type":"string","example":""}},{"name":"versionNumber","in":"path","description":"Version number.","required":true,"schema":{"type":"number","example":""}}],"responses":{"401":{"description":"Bearer token required (Authorization header)","content":{"application/json":{}}}},"externalDocs":{"api_ref":"https://www.kaggle.com/docs/api","api_endpoint":"https://www.kaggle.com/api/v1/models/{ownerSlug}/{modelSlug}/{framework}/{instanceSlug}/{versionNumber}/delete"},"summary":"Delete Model Instance Version","description":"","security":[{"bearerAuth":[]}],"requestBody":{"description":"","required":true,"content":{"application/json":{"schema":{"type":"object","required":[],"properties":{}},"example":{}}}}}},"/blobs/upload":{"post":{"tags":["Files And Uploads"],"parameters":[],"responses":{"401":{"description":"Bearer token required (Authorization header)","content":{"application/json":{}}}},"externalDocs":{"api_ref":"https://www.kaggle.com/docs/api","api_endpoint":"https://www.kaggle.com/api/v1/blobs/upload"},"summary":"Start Blob Upload","description":"","security":[{"bearerAuth":[]}],"requestBody":{"description":"","required":false,"content":{"multipart/form-data":{"schema":{"type":"object","required":[],"properties":{"type":{"type":"string","description":"Object being uploaded (dataset / kernel / model).","required":true},"contentLength":{"type":"number","description":"File size in bytes.","required":true},"contentType":{"type":"string","description":"File MIME type.","required":true},"lastModifiedEpochSeconds":{"type":"number","description":"Last modified epoch seconds.","required":true},"name":{"type":"string","description":"File name.","required":true}}},"example":{"type":"dataset","contentLength":1024,"contentType":"text/csv","lastModifiedEpochSeconds":1700000000,"name":"data.csv"}}}}}},"/inbox/files/create":{"post":{"tags":["Files And Uploads"],"parameters":[],"responses":{"401":{"description":"Bearer token required (Authorization header)","content":{"application/json":{}}}},"externalDocs":{"api_ref":"https://www.kaggle.com/docs/api","api_endpoint":"https://www.kaggle.com/api/v1/inbox/files/create"},"summary":"Create Inbox File","description":"","security":[{"bearerAuth":[]}],"requestBody":{"description":"","required":true,"content":{"application/json":{"schema":{"type":"object","required":[],"properties":{"blobFileToken":{"type":"string","description":"Upload blob file token from /blobs/upload.","required":true},"virtualDirectory":{"type":"string","description":"Virtual directory path (e.g. inbox/alias/file.csv).","required":true}}},"example":{"blobFileToken":"value","virtualDirectory":"value"}}}}}}},"components":{"securitySchemes":{"bearerAuth":{"type":"http","scheme":"bearer"}}},"security":[{"bearerAuth":[]}]}