{"docsConfig":{"theme":"mint","$schema":"https://mintlify.com/docs.json","name":"Onset Documentation","colors":{"primary":"#3d43eb","light":"#3d43eb","dark":"#3d43eb"},"logo":{"light":"https://www.onset.io/logo-dark.png","dark":"https://www.onset.io/logo.png"},"favicon":"https://app.onset.io/favicon.ico","navbar":{"primary":{"type":"button","label":"Dashboard","href":"https://app.onset.io"}},"footer":{"socials":{"x":"https://x.com/onsetio","github":"https://github.com/onsetio"}},"contextual":{"options":["copy","view","chatgpt","claude","perplexity","mcp","cursor","vscode"],"display":"header"},"styling":{"latex":false},"navigation":{"global":{"anchors":[{"anchor":"Release Notes","icon":"memo","href":"https://releases.onset.io/releases"},{"anchor":"Blog","icon":"newspaper","href":"https://www.onset.io/blog"}]},"pages":[]}},"deployment":{"deploymentMetadataValue":{"subdomain":"onset","hasAudioNarration":false,"actualSubdomain":"onset","customDomains":["docs.onset.io"],"gitSource":{"type":"github","owner":"onsetio","repo":"docs","deployBranch":"main","contentDirectory":"","isPrivate":true,"mountPath":"","label":""},"chroma":{"liveDeploymentHistoryId":"6a7e2e05acfce07b885391a4","collectionId":"e592ba9f-3d31-4090-9bc6-a7250d5d50fc","schemaVersion":"v3","latestBuiltDeploymentHistoryId":"6a7e2e05acfce07b885391a4"},"feedback":{"thumbs":true},"entitlements":{},"buildId":"6a7e2e05acfce07b885391a4:success","clientVersion":"0.0.3966","searchFilterCounts":[{"language":"default","tag":"Developers","count":42},{"language":"default","tag":"API Reference","count":35},{"language":"default","tag":"Releases","count":20},{"language":"default","tag":"Integrations","count":14},{"language":"default","tag":"Page","count":8},{"language":"default","tag":"Import","count":6},{"language":"default","tag":"Getting started","count":5},{"language":"default","tag":"Incoming Webhooks","count":5},{"language":"default","tag":"Subscriber Lists","count":5},{"language":"default","tag":"Subscribers","count":5}]},"assistantConfig":{"enableStarterQuestions":false},"hasChatPermissions":false,"hasWebMcpPermissions":false,"toggles":[{"name":"kill-isr","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"agent-mintlify-slack","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"editor-v7-file-tree","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"agent-integrations-settings","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"automations-pr-grouping","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"custom-prefix","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"analytics-v7","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"user-flows-analytics","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"no-publish-flow","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"workos-onboarding","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"llms-txt-v2","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"pause-universal-search-reconcile","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"snapshot-serving-live","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"stripTemperatureMiddleware","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"per-site-search-delta","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"support-platform-pylon-zendesk","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"snapshot-serving","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"instant-rollback","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"granular-notifications-server","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"granular-notifications","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"editor-private-page-search","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"automations-fable","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"fixed-ai-action-pricing","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"automation-resolve-merge-conflict","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"scoped-publishing","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"mintql","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"page-level-analytics","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"editor-version-history-v2","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"editor-nav-generations","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"billing-page-v2","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"workspace-projects","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"assistant-v5","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"byok-sep-25","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"fork-pr-previews","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"revalidation-jwt","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"vite-origin","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"editor-agent-model-picker","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"billing-updated-9-15","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"hobby-abuse-scan","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"dashboard-inbox","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false}],"isAtlas":false,"googleFontsInlined":false},"customCss":[],"page":{"pagePath":"api-reference/releases/list-releases","slug":"/api-reference/releases/list-releases","pageMetadata":{"title":"List releases","description":"Retrieve a list of releases with optional filtering","deprecated":null,"version":null,"openapi":"https://api.onset.io/v1/openapi.yml get /releases","href":"/api-reference/releases/list-releases","autogeneratedByOpenApi":true},"description":{"compiledSource":"\"use strict\";\nconst {jsx: _jsx} = arguments[0];\nconst {useMDXComponents: _provideComponents} = arguments[0];\nfunction _createMdxContent(props) {\n const _components = {\n p: \"p\",\n ..._provideComponents(),\n ...props.components\n };\n return _jsx(_components.p, {\n children: \"Retrieve a list of releases with optional filtering\"\n });\n}\nfunction MDXContent(props = {}) {\n const {wrapper: MDXLayout} = {\n ..._provideComponents(),\n ...props.components\n };\n return MDXLayout ? _jsx(MDXLayout, {\n ...props,\n children: _jsx(_createMdxContent, {\n ...props\n })\n }) : _createMdxContent(props);\n}\nreturn {\n default: MDXContent\n};\n","frontmatter":{},"scope":{}},"pageType":"default","mdx":{"mdxSource":{"compiledSource":"\"use strict\";const{Fragment:_Fragment,jsx:_jsx}=arguments[0];const{useMDXComponents:_provideComponents}=arguments[0];function _createMdxContent(props){return _jsx(_Fragment,{})}function MDXContent(props={}){const{wrapper:MDXLayout}={..._provideComponents(),...props.components};return MDXLayout?_jsx(MDXLayout,{...props,children:_jsx(_createMdxContent,{...props})}):_createMdxContent(props)}return{default:MDXContent}","frontmatter":{},"scope":{"config":{},"pageMetadata":{"title":"List releases","description":"Retrieve a list of releases with optional filtering","deprecated":null,"version":null,"openapi":"https://api.onset.io/v1/openapi.yml get /releases","href":"/api-reference/releases/list-releases","autogeneratedByOpenApi":true}}},"mdxSourceWithNoJs":null},"mdxExtracts":{"tableOfContents":[],"codeExamples":{}},"jsLinks":[],"openApiReferenceData":{"operation":{"summary":"List releases","description":"Retrieve a list of releases with optional filtering","tags":["Releases"],"parameters":["7871181e-d384-4c71-9f14-3c6b14224b42","01926512-b1a3-4ed9-a9bc-bd1e3206d457","1533b1c8-962f-41fd-a4c5-7bf619fa7e87","af822608-65e5-403e-97c0-91458e98a9c2","963c08d3-35d2-4902-90fb-8b3653f41ffc","ba9ccfad-b1da-490b-a72c-ca12e6bf8f28","d7ab9cce-b66d-4e59-b633-1c8028dc9630"],"responses":{"200":"0b935d6c-a813-48ab-b375-b7a1cc04500c","400":"5f4fb932-5bfc-4c61-a2b7-7e55000af659","401":"b9ecdf34-f496-4ec8-ab7c-e19ffc1c5f4f"},"method":"get","type":"path","servers":["4cb49b15-f66d-4c08-a277-68eb208b0c9b"],"security":["0e68ece1-bc68-4314-bccf-0e7cf0f986d4","0fc2cf18-4606-4ccf-b943-9e47bb52a4ce"],"path":"/releases","baseUrlOptions":["https://api.onset.io/v1"],"title":"List releases","codeSamples":[],"requiredOnlyExamples":false,"requestExampleType":"generated","responseExampleType":"generated"},"dependencies":{"parameters":{"7871181e-d384-4c71-9f14-3c6b14224b42":{"name":"offset","in":"query","description":"Number of items to skip","schema":{"type":"integer","minimum":0,"maximum":1000,"default":0,"description":"Number of items to skip","uniqueKey":"","typeLabel":"integer"}},"01926512-b1a3-4ed9-a9bc-bd1e3206d457":{"name":"limit","in":"query","description":"Maximum number of items to return","schema":{"type":"integer","minimum":1,"maximum":100,"default":10,"description":"Maximum number of items to return","uniqueKey":"","typeLabel":"integer"}},"1533b1c8-962f-41fd-a4c5-7bf619fa7e87":{"name":"slug","in":"query","description":"Filter by release slug","schema":{"type":"string","description":"Filter by release slug","uniqueKey":"","typeLabel":"string"}},"af822608-65e5-403e-97c0-91458e98a9c2":{"name":"is_public","in":"query","description":"Filter by public visibility","schema":{"type":"boolean","description":"Filter by public visibility","uniqueKey":"","typeLabel":"boolean"}},"963c08d3-35d2-4902-90fb-8b3653f41ffc":{"name":"status","in":"query","description":"Filter by release status","schema":{"type":"string","enum":["DRAFT","RELEASED"],"description":"Filter by release status","uniqueKey":"","typeLabel":"enum\u003cstring>"}},"ba9ccfad-b1da-490b-a72c-ca12e6bf8f28":{"name":"project_id","in":"query","description":"Filter by project ID","schema":{"type":"string","description":"Filter by project ID","uniqueKey":"","typeLabel":"string"}},"d7ab9cce-b66d-4e59-b633-1c8028dc9630":{"name":"label_ids","in":"query","description":"Comma-separated label IDs. Returns releases carrying any of the given labels.","schema":{"type":"string","description":"Comma-separated label IDs. Returns releases carrying any of the given labels.","uniqueKey":"","typeLabel":"string"},"example":"clx1abc,clx2def"}},"responses":{"0b935d6c-a813-48ab-b375-b7a1cc04500c":{"description":"List of releases retrieved successfully","content":{"application/json":{"schema":{"type":"array","items":{"type":"object","properties":{"id":{"type":"string","description":"Unique release identifier","uniqueKey":"items.[INDEX].id","typeLabel":"string"},"title":{"type":"string","description":"Release title","uniqueKey":"items.[INDEX].title","typeLabel":"string"},"body":{"type":"string","description":"Release description/body content (HTML formatted)","uniqueKey":"items.[INDEX].body","typeLabel":"string"},"slug":{"type":"string","description":"URL-friendly release identifier","uniqueKey":"items.[INDEX].slug","typeLabel":"string"},"status":{"type":"string","enum":["DRAFT","SCHEDULED","RELEASED"],"description":"Current release status","uniqueKey":"items.[INDEX].status","typeLabel":"enum\u003cstring>"},"version":{"oneOf":[{"type":"string","description":"Release version","uniqueKey":"items.[INDEX].version.oneOf.0","typeLabel":"string"},{"type":"null","description":"Release version","uniqueKey":"items.[INDEX].version.oneOf.1","typeLabel":"null"}],"uniqueKey":"items.[INDEX].version","typeLabel":"string | null"},"is_pinned":{"type":"boolean","description":"Whether release is pinned","uniqueKey":"items.[INDEX].is_pinned","typeLabel":"boolean"},"is_public":{"type":"boolean","description":"Whether release is publicly visible","uniqueKey":"items.[INDEX].is_public","typeLabel":"boolean"},"is_pre_release":{"type":"boolean","description":"Whether this is a pre-release","uniqueKey":"items.[INDEX].is_pre_release","typeLabel":"boolean"},"summary":{"oneOf":[{"type":"string","description":"AI generated summary of the release","uniqueKey":"items.[INDEX].summary.oneOf.0","typeLabel":"string"},{"type":"null","description":"AI generated summary of the release","uniqueKey":"items.[INDEX].summary.oneOf.1","typeLabel":"null"}],"uniqueKey":"items.[INDEX].summary","typeLabel":"string | null"},"hero":{"oneOf":[{"type":"null","description":"Hero image/video for the release","uniqueKey":"items.[INDEX].hero.oneOf.0","typeLabel":"null"},{"type":"object","description":"Hero image/video for the release","properties":{"type":{"type":"string","enum":["image","video"],"uniqueKey":"items.[INDEX].hero.oneOf.1.type","typeLabel":"enum\u003cstring>"},"url":{"type":"string","format":"uri","uniqueKey":"items.[INDEX].hero.oneOf.1.url","typeLabel":"string\u003curi>"}},"uniqueKey":"items.[INDEX].hero.oneOf.1","typeLabel":"object"}],"uniqueKey":"items.[INDEX].hero","typeLabel":"null | object"},"changes":{"type":"array","items":{"type":"object","properties":{"title":{"type":"string","description":"Change type title, e.g. \"Fixed\"","uniqueKey":"items.[INDEX].changes.items.[INDEX].title","typeLabel":"string"},"color":{"type":"string","description":"Badge colour (hex code)","uniqueKey":"items.[INDEX].changes.items.[INDEX].color","typeLabel":"string"},"content":{"oneOf":[{"type":"string","description":"Change content (HTML formatted)","uniqueKey":"items.[INDEX].changes.items.[INDEX].content.oneOf.0","typeLabel":"string"},{"type":"null","description":"Change content (HTML formatted)","uniqueKey":"items.[INDEX].changes.items.[INDEX].content.oneOf.1","typeLabel":"null"}],"uniqueKey":"items.[INDEX].changes.items.[INDEX].content","typeLabel":"string | null"}},"uniqueKey":"items.[INDEX].changes.items.[INDEX]","typeLabel":"object"},"description":"List of changes in this release","uniqueKey":"items.[INDEX].changes","typeLabel":"object[]"},"project":{"type":"object","properties":{"id":{"type":"string","description":"Unique project identifier","uniqueKey":"items.[INDEX].project.id","typeLabel":"string"},"name":{"type":"string","description":"Project name","uniqueKey":"items.[INDEX].project.name","typeLabel":"string"},"slug":{"type":"string","description":"Project slug","uniqueKey":"items.[INDEX].project.slug","typeLabel":"string"}},"uniqueKey":"items.[INDEX].project","typeLabel":"object"},"labels":{"type":"array","items":{"type":"object","properties":{"id":{"type":"string","description":"Unique label identifier","uniqueKey":"items.[INDEX].labels.items.[INDEX].id","typeLabel":"string"},"name":{"type":"string","description":"Label name","uniqueKey":"items.[INDEX].labels.items.[INDEX].name","typeLabel":"string"},"slug":{"type":"string","description":"Label slug","uniqueKey":"items.[INDEX].labels.items.[INDEX].slug","typeLabel":"string"},"color":{"type":"string","description":"Label color (hex code)","uniqueKey":"items.[INDEX].labels.items.[INDEX].color","typeLabel":"string"}},"uniqueKey":"items.[INDEX].labels.items.[INDEX]","typeLabel":"object"},"uniqueKey":"items.[INDEX].labels","typeLabel":"object[]"},"attachments":{"type":"array","items":{"oneOf":[{"type":"object","properties":{"type":{"type":"string","description":"Type of attachment","enum":["FILE"],"uniqueKey":"items.[INDEX].attachments.items.[INDEX].oneOf.0.type","typeLabel":"enum\u003cstring>"},"content":{"type":"object","properties":{"title":{"type":"string","description":"File title","uniqueKey":"items.[INDEX].attachments.items.[INDEX].oneOf.0.content.title","typeLabel":"string"},"url":{"type":"string","description":"File URL path","uniqueKey":"items.[INDEX].attachments.items.[INDEX].oneOf.0.content.url","typeLabel":"string"},"size":{"type":"integer","description":"File size in bytes","uniqueKey":"items.[INDEX].attachments.items.[INDEX].oneOf.0.content.size","typeLabel":"integer"},"type":{"type":"string","description":"MIME type of the file","uniqueKey":"items.[INDEX].attachments.items.[INDEX].oneOf.0.content.type","typeLabel":"string"}},"uniqueKey":"items.[INDEX].attachments.items.[INDEX].oneOf.0.content","typeLabel":"object"},"id":{"type":"string","description":"Unique attachment identifier","uniqueKey":"items.[INDEX].attachments.items.[INDEX].oneOf.0.id","typeLabel":"string"}},"uniqueKey":"items.[INDEX].attachments.items.[INDEX].oneOf.0","typeLabel":"object"},{"type":"object","properties":{"type":{"type":"string","description":"Type of attachment","enum":["LINK"],"uniqueKey":"items.[INDEX].attachments.items.[INDEX].oneOf.1.type","typeLabel":"enum\u003cstring>"},"content":{"type":"object","properties":{"title":{"oneOf":[{"type":"string","description":"Link title","uniqueKey":"items.[INDEX].attachments.items.[INDEX].oneOf.1.content.title.oneOf.0","typeLabel":"string"},{"type":"null","description":"Link title","uniqueKey":"items.[INDEX].attachments.items.[INDEX].oneOf.1.content.title.oneOf.1","typeLabel":"null"}],"uniqueKey":"items.[INDEX].attachments.items.[INDEX].oneOf.1.content.title","typeLabel":"string | null"},"url":{"type":"string","format":"uri","description":"Link URL","uniqueKey":"items.[INDEX].attachments.items.[INDEX].oneOf.1.content.url","typeLabel":"string\u003curi>"}},"uniqueKey":"items.[INDEX].attachments.items.[INDEX].oneOf.1.content","typeLabel":"object"},"id":{"type":"string","description":"Unique attachment identifier","uniqueKey":"items.[INDEX].attachments.items.[INDEX].oneOf.1.id","typeLabel":"string"}},"uniqueKey":"items.[INDEX].attachments.items.[INDEX].oneOf.1","typeLabel":"object"}],"uniqueKey":"items.[INDEX].attachments.items.[INDEX]","typeLabel":"object"},"uniqueKey":"items.[INDEX].attachments","typeLabel":"object[]"},"contributors":{"type":"array","items":{"type":"object","properties":{"id":{"type":"string","description":"Contributor ID","uniqueKey":"items.[INDEX].contributors.items.[INDEX].id","typeLabel":"string"},"name":{"type":"string","description":"Contributor name","uniqueKey":"items.[INDEX].contributors.items.[INDEX].name","typeLabel":"string"},"avatar_url":{"type":"string","format":"uri","description":"Contributor avatar URL","uniqueKey":"items.[INDEX].contributors.items.[INDEX].avatar_url","typeLabel":"string\u003curi>"}},"uniqueKey":"items.[INDEX].contributors.items.[INDEX]","typeLabel":"object"},"description":"List of contributors to this release","uniqueKey":"items.[INDEX].contributors","typeLabel":"object[]"},"scheduled_at":{"oneOf":[{"type":"string","format":"date-time","description":"When the release is scheduled to publish. Only set while status is SCHEDULED.","uniqueKey":"items.[INDEX].scheduled_at.oneOf.0","typeLabel":"string\u003cdate-time>"},{"type":"null","format":"date-time","description":"When the release is scheduled to publish. Only set while status is SCHEDULED.","uniqueKey":"items.[INDEX].scheduled_at.oneOf.1","typeLabel":"null"}],"uniqueKey":"items.[INDEX].scheduled_at","typeLabel":"string\u003cdate-time> | null"},"released_at":{"oneOf":[{"type":"string","format":"date-time","description":"When the release was released","uniqueKey":"items.[INDEX].released_at.oneOf.0","typeLabel":"string\u003cdate-time>"},{"type":"null","format":"date-time","description":"When the release was released","uniqueKey":"items.[INDEX].released_at.oneOf.1","typeLabel":"null"}],"uniqueKey":"items.[INDEX].released_at","typeLabel":"string\u003cdate-time> | null"},"created_at":{"type":"string","format":"date-time","description":"When the release was created","uniqueKey":"items.[INDEX].created_at","typeLabel":"string\u003cdate-time>"},"updated_at":{"type":"string","format":"date-time","description":"When the release was last updated","uniqueKey":"items.[INDEX].updated_at","typeLabel":"string\u003cdate-time>"}},"uniqueKey":"items.[INDEX]","typeLabel":"object"},"uniqueKey":"","typeLabel":"object[]"},"examples":{"Example":{"title":"Example","value":[{"id":"\u003cstring>","title":"\u003cstring>","body":"\u003cstring>","slug":"\u003cstring>","status":"DRAFT","version":"\u003cstring>","is_pinned":true,"is_public":true,"is_pre_release":true,"summary":"\u003cstring>","hero":{"type":"image","url":"\u003cstring>"},"changes":[{"title":"\u003cstring>","color":"\u003cstring>","content":"\u003cstring>"}],"project":{"id":"\u003cstring>","name":"\u003cstring>","slug":"\u003cstring>"},"labels":[{"id":"\u003cstring>","name":"\u003cstring>","slug":"\u003cstring>","color":"\u003cstring>"}],"attachments":[{"type":"FILE","content":{"title":"\u003cstring>","url":"\u003cstring>","size":123,"type":"\u003cstring>"},"id":"\u003cstring>"}],"contributors":[{"id":"\u003cstring>","name":"\u003cstring>","avatar_url":"\u003cstring>"}],"scheduled_at":"2023-11-07T05:31:56Z","released_at":"2023-11-07T05:31:56Z","created_at":"2023-11-07T05:31:56Z","updated_at":"2023-11-07T05:31:56Z"}]}},"exampleType":"generated"}},"exampleType":"generated"},"5f4fb932-5bfc-4c61-a2b7-7e55000af659":{"description":"Bad request - Invalid input parameters","content":{"application/json":{"schema":{"type":"object","properties":{"error":{"type":"string","description":"Error message","isRequired":true,"uniqueKey":"error","typeLabel":"string"},"details":{"type":"object","description":"Additional error details","uniqueKey":"details","typeLabel":"object"}},"required":["error"],"uniqueKey":"","typeLabel":"object"},"examples":{"Example":{"title":"Example","value":{"error":"\u003cstring>","details":{}}}},"exampleType":"generated"}},"exampleType":"generated"},"b9ecdf34-f496-4ec8-ab7c-e19ffc1c5f4f":{"description":"Unauthorized - Invalid or missing authentication","content":{"application/json":{"schema":{"type":"object","properties":{"error":{"type":"string","description":"Error message","isRequired":true,"uniqueKey":"error","typeLabel":"string"},"details":{"type":"object","description":"Additional error details","uniqueKey":"details","typeLabel":"object"}},"required":["error"],"uniqueKey":"","typeLabel":"object"},"examples":{"Example":{"title":"Example","value":{"error":"\u003cstring>","details":{}}}},"exampleType":"generated"}},"exampleType":"generated"}},"security":{"0e68ece1-bc68-4314-bccf-0e7cf0f986d4":{"bearerAuth":{"type":"http","scheme":"bearer","scopes":[]}},"0fc2cf18-4606-4ccf-b943-9e47bb52a4ce":{"basicAuth":{"$ref":"9b650642-e499-445e-86a8-e7c5489e067a","scopes":[]}}},"servers":{"4cb49b15-f66d-4c08-a277-68eb208b0c9b":{"url":"https://api.onset.io/v1","description":"API V1"}},"processedSecurityOptions":[{"schemes":[{"scheme":{"type":"http","scheme":"bearer","scopes":[]},"schema":{"title":"Bearer Auth","type":"string","isRequired":true,"description":"Bearer authentication header of the form `Bearer \u003ctoken>`, where `\u003ctoken>` is your auth token.","format":"bearer","typeLabel":"string\u003cbearer>","deprecated":false},"schemeName":"bearerAuth","name":"Authorization"}],"title":"bearerAuth"}]},"originalFileLocation":"https://api.onset.io/v1/openapi.yml"},"subdomain":"onset","siteName":"Onset Documentation","title":"List releases - Onset Documentation","navMaps":{"firstHrefInVersion":{},"firstHrefInLanguage":{}},"lastModified":"2026-08-13T01:40:08.408Z","originalFileLocation":"api-reference/releases/list-releases.mdx"},"headHtml":"\u003cscript data-mint-head>(function(){var d=document.documentElement,p=null;if(!p){try{p=localStorage.getItem(\"isDarkMode\")}catch(e){}if(p==='true')p='dark';else if(p==='false')p='light';if(p!=='light'\u0026\u0026p!=='dark'\u0026\u0026p!=='system')p=\"system\"}var r=p==='system'?(matchMedia(\"(prefers-color-scheme: dark)\").matches?'dark':'light'):p;d.classList.remove(r==='dark'?'light':'dark');d.classList.add(r);d.setAttribute(\"data-theme-preference\",p)})();\u003c/script>\u003cmeta data-mint-head name=\"description\" content=\"Retrieve a list of releases with optional filtering\">\u003cmeta data-mint-head name=\"application-name\" content=\"Onset Documentation\">\u003cmeta data-mint-head name=\"generator\" content=\"Mintlify\">\u003clink data-mint-head rel=\"apple-touch-icon\" type=\"image/x-icon\" sizes=\"180x180\" href=\"https://app.onset.io/favicon.ico\">\u003clink data-mint-head rel=\"icon\" type=\"image/x-icon\" sizes=\"32x32\" href=\"https://app.onset.io/favicon.ico\">\u003clink data-mint-head rel=\"icon\" type=\"image/x-icon\" sizes=\"16x16\" href=\"https://app.onset.io/favicon.ico\">\u003clink data-mint-head rel=\"shortcut icon\" type=\"image/x-icon\" href=\"https://app.onset.io/favicon.ico\">\u003cmeta data-mint-head property=\"og:title\" content=\"List releases - Onset Documentation\">\u003cmeta data-mint-head property=\"og:description\" content=\"Retrieve a list of releases with optional filtering\">\u003cmeta data-mint-head property=\"og:site_name\" content=\"Onset Documentation\">\u003cmeta data-mint-head property=\"og:url\" content=\"https://docs.onset.io/api-reference/releases/list-releases\">\u003cmeta data-mint-head property=\"og:type\" content=\"website\">\u003cmeta data-mint-head property=\"og:image\" content=\"https://onset.mintlify.app/_mintlify/api/og/v2?division=Releases\u0026amp;title=List+releases\u0026amp;description=Retrieve+a+list+of+releases+with+optional+filtering\u0026amp;theme=f22759ac899d0dae1b7de29d\u0026amp;signature=0970d453318aa2e97feaaa0d94602fbf03f66ff96cb7b6d48f9c752efacfcf81\">\u003cmeta data-mint-head property=\"og:image:width\" content=\"1200\">\u003cmeta data-mint-head property=\"og:image:height\" content=\"630\">\u003cmeta data-mint-head name=\"twitter:card\" content=\"summary_large_image\">\u003cmeta data-mint-head name=\"twitter:title\" content=\"List releases - Onset Documentation\">\u003cmeta data-mint-head name=\"twitter:description\" content=\"Retrieve a list of releases with optional filtering\">\u003cmeta data-mint-head name=\"twitter:image\" content=\"https://onset.mintlify.app/_mintlify/api/og/v2?division=Releases\u0026amp;title=List+releases\u0026amp;description=Retrieve+a+list+of+releases+with+optional+filtering\u0026amp;theme=f22759ac899d0dae1b7de29d\u0026amp;signature=0970d453318aa2e97feaaa0d94602fbf03f66ff96cb7b6d48f9c752efacfcf81\">\u003cmeta data-mint-head name=\"twitter:image:width\" content=\"1200\">\u003cmeta data-mint-head name=\"twitter:image:height\" content=\"630\">\u003cmeta data-mint-head name=\"msapplication-config\" content=\"https://mintlify.s3.us-west-1.amazonaws.com/onset/_generated/favicon/browserconfig.xml?v=3\">\u003cmeta data-mint-head name=\"apple-mobile-web-app-title\" content=\"Onset Documentation\">\u003cmeta data-mint-head name=\"msapplication-TileColor\" content=\"#3d43eb\">\u003clink data-mint-head rel=\"canonical\" href=\"https://docs.onset.io/api-reference/releases/list-releases\">\u003clink data-mint-head rel=\"alternate\" type=\"application/xml\" href=\"/sitemap.xml\">\u003clink data-mint-head rel=\"alternate\" type=\"text/markdown\" href=\"/api-reference/releases/list-releases.md\">\u003cscript data-mint-head type=\"application/ld+json\">{\"@context\":\"https://schema.org\",\"@graph\":[{\"@type\":\"Organization\",\"@id\":\"https://docs.onset.io/#organization\",\"name\":\"Onset Documentation\",\"url\":\"https://docs.onset.io\",\"logo\":{\"@type\":\"ImageObject\",\"url\":\"https://www.onset.io/logo-dark.png\"}},{\"@type\":\"WebSite\",\"@id\":\"https://docs.onset.io#website\",\"name\":\"Onset Documentation\",\"url\":\"https://docs.onset.io\",\"publisher\":{\"@id\":\"https://docs.onset.io/#organization\"}},{\"@type\":\"WebPage\",\"@id\":\"https://docs.onset.io/api-reference/releases/list-releases#webpage\",\"url\":\"https://docs.onset.io/api-reference/releases/list-releases\",\"name\":\"List releases\",\"description\":\"Retrieve a list of releases with optional filtering\",\"dateModified\":\"2026-08-13T01:40:08.408Z\",\"isPartOf\":{\"@id\":\"https://docs.onset.io#website\"},\"breadcrumb\":{\"@id\":\"https://docs.onset.io/api-reference/releases/list-releases#breadcrumb\"}},{\"@type\":\"BreadcrumbList\",\"@id\":\"https://docs.onset.io/api-reference/releases/list-releases#breadcrumb\",\"itemListElement\":[{\"@type\":\"ListItem\",\"position\":1,\"name\":\"Developers\",\"item\":\"https://docs.onset.io/developers/widget/overview\"},{\"@type\":\"ListItem\",\"position\":2,\"name\":\"API Reference\",\"item\":\"https://docs.onset.io/developers/api-reference/introduction\"},{\"@type\":\"ListItem\",\"position\":3,\"name\":\"List releases\",\"item\":\"https://docs.onset.io/api-reference/releases/list-releases\"}]},{\"@type\":[\"TechArticle\",\"APIReference\"],\"@id\":\"https://docs.onset.io/api-reference/releases/list-releases#apireference\",\"headline\":\"List releases\",\"name\":\"List releases\",\"description\":\"Retrieve a list of releases with optional filtering\",\"url\":\"https://docs.onset.io/api-reference/releases/list-releases\",\"mainEntityOfPage\":{\"@id\":\"https://docs.onset.io/api-reference/releases/list-releases#webpage\"},\"dateModified\":\"2026-08-13T01:40:08.408Z\",\"publisher\":{\"@id\":\"https://docs.onset.io/#organization\"},\"isPartOf\":{\"@id\":\"https://docs.onset.io#website\"}}]}\u003c/script>\u003cscript data-mint-head type=\"application/ld+json\">{\"@context\":\"https://schema.org\",\"@type\":\"WebSite\",\"name\":\"Onset Documentation\",\"creator\":{\"@type\":\"Organization\",\"name\":\"Mintlify\",\"url\":\"https://mintlify.com\"}}\u003c/script>","siteName":"Onset Documentation","nav":{"global":{"anchors":[{"anchor":"Release Notes","icon":"memo","href":"https://releases.onset.io/releases"},{"anchor":"Blog","icon":"newspaper","href":"https://www.onset.io/blog"}]},"groups":[{"group":"Getting started","pages":[{"title":"Quickstart","icon":"rocket","href":"/guides/quickstart"},{"title":"Team Members","icon":"users","href":"/guides/team-members"},{"title":"Projects","icon":"folder","href":"/guides/projects"},{"title":"Labels","icon":"tag","href":"/guides/labels"},{"title":"Billing","icon":"credit-card","href":"/guides/billing"}]},{"group":"Releases","pages":[{"title":"Overview","icon":"memo","href":"/guides/releases/overview"},{"title":"Writing Releases","icon":"pen-to-square","href":"/guides/releases/writing"},{"title":"AI Assistant","icon":"sparkles","href":"/guides/releases/ai-assistant"},{"title":"Publishing \u0026 Scheduling","icon":"paper-plane","href":"/guides/releases/publishing"},{"title":"Versioning","icon":"code-branch","href":"/guides/releases/versioning"},{"title":"Visibility \u0026 Sharing","icon":"eye","href":"/guides/releases/visibility"},{"title":"Contributors","icon":"user-group","href":"/guides/releases/contributors"},{"title":"Reactions","icon":"face-smile","href":"/guides/releases/reactions"},{"group":"Import","icon":"file-import","pages":[{"title":"Overview","icon":"file-import","href":"/guides/releases/import/overview"},{"title":"Import from AnnounceKit","icon":"file-import","sidebarTitle":"AnnounceKit","href":"/guides/releases/import/announcekit"},{"title":"Import from Beamer","icon":"file-import","sidebarTitle":"Beamer","href":"/guides/releases/import/beamer"},{"title":"Import from Changelogfy","icon":"file-import","sidebarTitle":"Changelogfy","href":"/guides/releases/import/changelogfy"},{"title":"Import from Noticeable","icon":"file-import","sidebarTitle":"Noticeable","href":"/guides/releases/import/noticeable"},{"title":"Import from ReleaseNotes.io","icon":"file-import","sidebarTitle":"ReleaseNotes.io","href":"/guides/releases/import/releasenotesio"}]}]},{"group":"Audience","pages":[{"title":"Overview","icon":"envelope","href":"/guides/subscribers/overview"},{"title":"Subscriber Lists","icon":"list","href":"/guides/subscribers/lists"},{"title":"Importing Subscribers","icon":"file-import","href":"/guides/subscribers/import"}]},{"group":"Page","pages":[{"title":"Appearance","icon":"palette","href":"/guides/page/appearance"},{"title":"Page Preferences","icon":"sliders","href":"/guides/page/preferences"},{"title":"Feeds","icon":"rss","href":"/guides/page/feeds"},{"title":"Custom Domains","icon":"Globe","href":"/page/custom-domains"},{"group":"Page Privacy","icon":"shield-halved","pages":[{"title":"Email Whitelisted Page","href":"/page/privacy/email-whitelisted-page"},{"title":"Password Protected","href":"/page/privacy/password-protected"}]},{"title":"Custom From Address","icon":"at","href":"/email/custom-from-address"},{"title":"Custom Subject","icon":"input-text","href":"/email/custom-subject"}]},{"group":"Developers","pages":[{"group":"Widget","icon":"window-alt","pages":[{"title":"Overview","href":"/developers/widget/overview"},{"title":"Install","href":"/developers/widget/install"},{"title":"Configuration","href":"/developers/widget/configuration"},{"title":"Methods","href":"/developers/widget/methods"}]},{"title":"MCP Server","icon":"plug","href":"/developers/mcp"},{"title":"Webhooks","icon":"Webhook","href":"/developers/webhooks"},{"title":"Incoming Webhooks","icon":"Link","href":"/developers/incoming-webhook"},{"group":"API Reference","icon":"code-simple","pages":[{"title":"Introduction","href":"/developers/api-reference/introduction"},{"group":"Workspace","pages":[{"title":"Get workspace information","deprecated":null,"version":null,"openapi":"https://api.onset.io/v1/openapi.yml get /workspace","href":"/api-reference/workspace/get-workspace-information"}]},{"group":"Milestones","pages":[{"title":"List milestones","deprecated":null,"version":null,"openapi":"https://api.onset.io/v1/openapi.yml get /milestones","href":"/api-reference/milestones/list-milestones"},{"title":"Get milestone by ID","deprecated":null,"version":null,"openapi":"https://api.onset.io/v1/openapi.yml get /milestones/{id}","href":"/api-reference/milestones/get-milestone-by-id"},{"title":"Delete milestone","deprecated":null,"version":null,"openapi":"https://api.onset.io/v1/openapi.yml delete /milestones/{id}","href":"/api-reference/milestones/delete-milestone"},{"title":"Update milestone","description":"Update an existing milestone","deprecated":null,"version":null,"openapi":"https://api.onset.io/v1/openapi.yml patch /milestones/{id}","href":"/api-reference/milestones/update-milestone"}]},{"group":"Releases","pages":[{"title":"List releases","deprecated":null,"version":null,"openapi":"https://api.onset.io/v1/openapi.yml get /releases","href":"/api-reference/releases/list-releases"},{"title":"Create a new release","description":"Create a new release in the workspace. Releases are always created as drafts — use POST /releases/{id}/publish to publish or schedule one.","deprecated":null,"version":null,"openapi":"https://api.onset.io/v1/openapi.yml post /releases","href":"/api-reference/releases/create-a-new-release"},{"title":"Get release by ID","deprecated":null,"version":null,"openapi":"https://api.onset.io/v1/openapi.yml get /releases/{id}","href":"/api-reference/releases/get-release-by-id"},{"title":"Delete release","deprecated":null,"version":null,"openapi":"https://api.onset.io/v1/openapi.yml delete /releases/{id}","href":"/api-reference/releases/delete-release"},{"title":"Update release","deprecated":null,"version":null,"openapi":"https://api.onset.io/v1/openapi.yml patch /releases/{id}","href":"/api-reference/releases/update-release"},{"title":"Publish release","deprecated":null,"version":null,"openapi":"https://api.onset.io/v1/openapi.yml post /releases/{id}/publish","href":"/api-reference/releases/publish-release"}]},{"group":"Subscribers","pages":[{"title":"List subscribers","deprecated":null,"version":null,"openapi":"https://api.onset.io/v1/openapi.yml get /subscribers","href":"/api-reference/subscribers/list-subscribers"},{"title":"Create a new subscriber","deprecated":null,"version":null,"openapi":"https://api.onset.io/v1/openapi.yml post /subscribers","href":"/api-reference/subscribers/create-a-new-subscriber"},{"title":"Get subscriber by ID","deprecated":null,"version":null,"openapi":"https://api.onset.io/v1/openapi.yml get /subscribers/{id}","href":"/api-reference/subscribers/get-subscriber-by-id"},{"title":"Delete subscriber","deprecated":null,"version":null,"openapi":"https://api.onset.io/v1/openapi.yml delete /subscribers/{id}","href":"/api-reference/subscribers/delete-subscriber"},{"title":"Update subscriber","deprecated":null,"version":null,"openapi":"https://api.onset.io/v1/openapi.yml patch /subscribers/{id}","href":"/api-reference/subscribers/update-subscriber"}]},{"group":"Subscriber Lists","pages":[{"title":"List subscriber lists","deprecated":null,"version":null,"openapi":"https://api.onset.io/v1/openapi.yml get /subscriber-lists","href":"/api-reference/subscriber-lists/list-subscriber-lists"},{"title":"Create a new subscriber list","deprecated":null,"version":null,"openapi":"https://api.onset.io/v1/openapi.yml post /subscriber-lists","href":"/api-reference/subscriber-lists/create-a-new-subscriber-list"},{"title":"Get subscriber list by ID","deprecated":null,"version":null,"openapi":"https://api.onset.io/v1/openapi.yml get /subscriber-lists/{id}","href":"/api-reference/subscriber-lists/get-subscriber-list-by-id"},{"title":"Delete subscriber list","deprecated":null,"version":null,"openapi":"https://api.onset.io/v1/openapi.yml delete /subscriber-lists/{id}","href":"/api-reference/subscriber-lists/delete-subscriber-list"},{"title":"Update subscriber list","deprecated":null,"version":null,"openapi":"https://api.onset.io/v1/openapi.yml patch /subscriber-lists/{id}","href":"/api-reference/subscriber-lists/update-subscriber-list"}]},{"group":"Webhooks","pages":[{"title":"List webhooks","deprecated":null,"version":null,"openapi":"https://api.onset.io/v1/openapi.yml get /webhooks","href":"/api-reference/webhooks/list-webhooks"},{"title":"Create a new webhook","deprecated":null,"version":null,"openapi":"https://api.onset.io/v1/openapi.yml post /webhooks","href":"/api-reference/webhooks/create-a-new-webhook"},{"title":"Get webhook by ID","deprecated":null,"version":null,"openapi":"https://api.onset.io/v1/openapi.yml get /webhooks/{id}","href":"/api-reference/webhooks/get-webhook-by-id"},{"title":"Delete webhook","deprecated":null,"version":null,"openapi":"https://api.onset.io/v1/openapi.yml delete /webhooks/{id}","href":"/api-reference/webhooks/delete-webhook"},{"title":"Update webhook","deprecated":null,"version":null,"openapi":"https://api.onset.io/v1/openapi.yml patch /webhooks/{id}","href":"/api-reference/webhooks/update-webhook"}]},{"group":"Incoming Webhooks","pages":[{"title":"List incoming webhooks","deprecated":null,"version":null,"openapi":"https://api.onset.io/v1/openapi.yml get /incoming-webhooks","href":"/api-reference/incoming-webhooks/list-incoming-webhooks"},{"title":"Create a new incoming webhook","deprecated":null,"version":null,"openapi":"https://api.onset.io/v1/openapi.yml post /incoming-webhooks","href":"/api-reference/incoming-webhooks/create-a-new-incoming-webhook"},{"title":"Get incoming webhook by ID","deprecated":null,"version":null,"openapi":"https://api.onset.io/v1/openapi.yml get /incoming-webhooks/{id}","href":"/api-reference/incoming-webhooks/get-incoming-webhook-by-id"},{"title":"Delete incoming webhook","deprecated":null,"version":null,"openapi":"https://api.onset.io/v1/openapi.yml delete /incoming-webhooks/{id}","href":"/api-reference/incoming-webhooks/delete-incoming-webhook"},{"title":"Update incoming webhook","deprecated":null,"version":null,"openapi":"https://api.onset.io/v1/openapi.yml patch /incoming-webhooks/{id}","href":"/api-reference/incoming-webhooks/update-incoming-webhook"}]},{"group":"Projects","pages":[{"title":"List projects","deprecated":null,"version":null,"openapi":"https://api.onset.io/v1/openapi.yml get /projects","href":"/api-reference/projects/list-projects"}]},{"group":"Labels","pages":[{"title":"List labels","deprecated":null,"version":null,"openapi":"https://api.onset.io/v1/openapi.yml get /labels","href":"/api-reference/labels/list-labels"}]},{"group":"Contributors","pages":[{"title":"List contributors","deprecated":null,"version":null,"openapi":"https://api.onset.io/v1/openapi.yml get /contributors","href":"/api-reference/contributors/list-contributors"}]}]}]},{"group":"Integrations","pages":[{"title":"Google Analytics","icon":"chart-simple","href":"/integrations/google-analytics"},{"title":"Plausible","icon":"chart-simple","href":"/integrations/plausible"},{"title":"Fathom","icon":"chart-simple","href":"/integrations/fathom"},{"title":"Instatus","icon":"signal-stream","href":"/integrations/instatus"},{"title":"Status.io","icon":"signal-stream","href":"/integrations/statusio"},{"title":"Statuspage","icon":"signal-stream","href":"/integrations/statuspage"},{"title":"Statuspal","icon":"signal-stream","href":"/integrations/statuspal"},{"icon":"signal-stream","title":"incident.io","href":"/integrations/incidentio"},{"title":"Discord","icon":"discord","href":"/integrations/discord"},{"title":"Slack","icon":"slack","href":"/integrations/slack"},{"title":"GitHub","icon":"github","href":"/integrations/github"},{"title":"Linear","icon":"circle-check","href":"/integrations/linear"},{"title":"Jira","icon":"circle-check","href":"/integrations/jira"},{"title":"Zapier","icon":"bolt","href":"/integrations/zapier"}]}]},"title":"List releases - Onset Documentation","buildId":"dpl_cadrRc5H9XQiJQbDFN5mcYRs2PAj","deploymentId":"dpl_cadrRc5H9XQiJQbDFN5mcYRs2PAj","dynamics":["c2aa737661","2b790eda92","b0f84f53ff","a9bb46feb3"],"chunks":["OpenApiReferenceProvider-DKJwRUt2.js","utils-CWD_VS3u.js","cloneDeep-izs3Hzxb.js","_Uint8Array-BVIqJ90l.js","isObjectLike-C8vmzPEN.js","isArray-Dcu1dQ5t.js","utils-oFjciODD.js","toString-BX-iyh8G.js","isSymbol-CSH9U2Gm.js","addUniqueKeysToSchema-C76WsxC3.js","snippetPresets-DvPMxpX_.js","style-to-object-BY3JEAdk.js","v4-DIgz8zy6.js","ApiExamples-CuNQfndH.js","isEqual-BfaiBbcl.js","usePlaygroundInputsStore-BVFpVUoF.js","shallow-t59Jg5Kr.js","getApiPlaygroundDisplay-C_JZ4amX.js","CodeSnippet-CLRDnx_h.js","CodeSnippets-C2myU4kc.js","Page-7TwLLapg.js","getPastedJson-B-JaVXw7.js","icon-BA-iDhH3.js","MethodPill-D4qZABFp.js","DuplicateIcon-THIDKO1O.js","createIcon-CYYJwgFd.js","DynamicMarkdown-UGQuxDKp.js","SectionHeading-jYELb23h.js","axios-vUo_bRtp.js","Markdown-DKsLa3wy.js","clsx-CefdjKz2.js","lib--scc4DXi.js","lib-B8HbPgcC.js","html-void-elements-mCSPHezU.js","dist-BaREnp3o.js","katex-YMM-FMeD.js","marked.esm-CZWythHk.js","AssistantPageLink-sgx_0XzF.js"]}