<!DOCTYPE html><html lang="en" dir="ltr" data-theme="dark" data-has-sidebar class="astro-i35jzdbg"> <head><meta charset="utf-8"/><meta name="viewport" content="width=device-width, initial-scale=1"/><title>API Overview | OpenAI API Reference</title><link rel="canonical" href="https://developers.openai.com/api/reference/overview/"/><link rel="sitemap" href="/sitemap-index.xml"/><script>
        function setupNavLinksInitial(){
          let mode = localStorage.getItem("stl-nav-links-mode");
          // initial guess
          if(mode === null){
            mode = window.innerWidth < 1000 ? "mobile" : "desktop";
          }
          document.documentElement.classList.add("stl-nav-links-mode-" + mode)
        }
        setupNavLinksInitial();
      </script><link rel="shortcut icon" href="/favicon.svg" type="image/svg+xml"/><meta name="generator" content="Astro v6.0.4"/><meta name="generator" content="Starlight v0.38.3"/><meta property="og:title" content="API Overview"/><meta property="og:type" content="article"/><meta property="og:url" content="https://developers.openai.com/api/reference/overview/"/><meta property="og:locale" content="en"/><meta property="og:site_name" content="OpenAI API Reference"/><meta name="twitter:card" content="summary_large_image"/><meta property="og:image" content="https://developers.openai.com/og/api/reference/overview.png"/><meta name="twitter:site" content="@OpenAIDevs"/><meta name="twitter:title" content="API Overview"/><meta name="twitter:image" content="https://developers.openai.com/og/api/reference/overview.png"/><meta name="twitter:image:alt" content="API Overview"/> <style>@font-face{font-family:Geist-5f5286da3bd2e78c;src:url("/_astro/fonts/44a9c3b35dc3cd39.woff2?dpl=dpl_CMgqm3WirAshw8hESrV8DVtxLzNZ") format("woff2");font-display:swap;unicode-range:U+0000-00FF,U+0131,U+0152-0153,U+02BB-02BC,U+02C6,U+02DA,U+02DC,U+0304,U+0308,U+0329,U+2000-206F,U+20AC,U+2122,U+2191,U+2193,U+2212,U+2215,U+FEFF,U+FFFD;font-weight:100 900;font-style:normal;font-feature-settings:'ss01' on, 'ss03' on, 'ss04' on, 'ss06' on, 'ss08' on;}@font-face{font-family:Geist-5f5286da3bd2e78c;src:url("/_astro/fonts/ba3f5082392556dd.woff2?dpl=dpl_CMgqm3WirAshw8hESrV8DVtxLzNZ") format("woff2");font-display:swap;unicode-range:U+0000-00FF,U+0131,U+0152-0153,U+02BB-02BC,U+02C6,U+02DA,U+02DC,U+0304,U+0308,U+0329,U+2000-206F,U+20AC,U+2122,U+2191,U+2193,U+2212,U+2215,U+FEFF,U+FFFD;font-weight:100 900;font-style:italic;font-feature-settings:'ss01' on, 'ss03' on, 'ss04' on, 'ss06' on, 'ss08' on;}@font-face{font-family:"Geist-5f5286da3bd2e78c fallback: Arial";src:local("Arial");font-display:swap;font-weight:100 900;font-style:normal;size-adjust:104.7553%;ascent-override:95.9379%;descent-override:28.1609%;line-gap-override:0%;}@font-face{font-family:"Geist-5f5286da3bd2e78c fallback: Arial";src:local("Arial");font-display:swap;font-weight:100 900;font-style:italic;size-adjust:104.7553%;ascent-override:95.9379%;descent-override:28.1609%;line-gap-override:0%;}:root{--stl-typography-font:Geist-5f5286da3bd2e78c,"Geist-5f5286da3bd2e78c fallback: Arial",sans-serif;}</style><link rel="preload" href="/_astro/fonts/44a9c3b35dc3cd39.woff2?dpl=dpl_CMgqm3WirAshw8hESrV8DVtxLzNZ" as="font" type="font/woff2" crossorigin><style>@font-face{font-family:"Geist Mono-1014d9fb64fdb22f";src:url("/_astro/fonts/71befe3b7149fc15.woff2?dpl=dpl_CMgqm3WirAshw8hESrV8DVtxLzNZ") format("woff2");font-display:swap;unicode-range:U+0000-00FF,U+0131,U+0152-0153,U+02BB-02BC,U+02C6,U+02DA,U+02DC,U+0304,U+0308,U+0329,U+2000-206F,U+20AC,U+2122,U+2191,U+2193,U+2212,U+2215,U+FEFF,U+FFFD;font-weight:100 900;font-style:normal;}@font-face{font-family:"Geist Mono-1014d9fb64fdb22f";src:url("/_astro/fonts/1370bbcc22110c42.woff2?dpl=dpl_CMgqm3WirAshw8hESrV8DVtxLzNZ") format("woff2");font-display:swap;unicode-range:U+0000-00FF,U+0131,U+0152-0153,U+02BB-02BC,U+02C6,U+02DA,U+02DC,U+0304,U+0308,U+0329,U+2000-206F,U+20AC,U+2122,U+2191,U+2193,U+2212,U+2215,U+FEFF,U+FFFD;font-weight:100 900;font-style:italic;}@font-face{font-family:"Geist Mono-1014d9fb64fdb22f fallback: Arial";src:local("Arial");font-display:swap;font-weight:100 900;font-style:normal;size-adjust:134.5893%;ascent-override:74.6716%;descent-override:21.9185%;line-gap-override:0%;}@font-face{font-family:"Geist Mono-1014d9fb64fdb22f fallback: Arial";src:local("Arial");font-display:swap;font-weight:100 900;font-style:italic;size-adjust:134.5893%;ascent-override:74.6716%;descent-override:21.9185%;line-gap-override:0%;}:root{--stl-typography-font-mono:"Geist Mono-1014d9fb64fdb22f","Geist Mono-1014d9fb64fdb22f fallback: Arial",sans-serif;}</style><link rel="preload" href="/_astro/fonts/71befe3b7149fc15.woff2?dpl=dpl_CMgqm3WirAshw8hESrV8DVtxLzNZ" as="font" type="font/woff2" crossorigin> <link rel="alternate" type="text/markdown" href="/api/reference/overview/index.md"> <script type="module" src="/_astro/Head.astro_astro_type_script_index_0_lang.CWfk7Bko.js"></script><script>
  window.didInitThemePickers = window.didInitThemePickers ?? false;

  // Only run once.
  if (!window.didInitThemePickers) {
    window.didInitThemePickers = true;

    // The stored theme will be either 'auto', 'light', 'dark' or null.
    const storedTheme = typeof localStorage !== 'undefined' && localStorage.getItem('starlight-theme');

    // This theme is either 'light' or 'dark'. It's used for setting the data-theme attribute.
    const theme =
      !storedTheme || storedTheme === 'auto'
        ? window.matchMedia('(prefers-color-scheme: light)').matches
          ? 'light'
          : 'dark'
        : storedTheme;

    document.documentElement.dataset.theme = theme === 'light' ? 'light' : 'dark';

    const themeSelects = document.querySelectorAll('[data-theme-select]');
    const selectedThemeValue = storedTheme || 'auto';

    themeSelects.forEach((select) => {
      const tmpl = select.querySelector(`[data-value="${selectedThemeValue}"] template`);
      const selectedSlot = select.querySelector('[data-part="trigger-selected"]');

      selectedSlot.innerHTML = '';
      if (tmpl) {
        selectedSlot.appendChild(tmpl.content.cloneNode(true));
        return;
      }
    });
  }
</script><link rel="stylesheet" href="/_astro/print.BOqcyqY-.css" media="print"><link rel="stylesheet" href="/_astro/Page.DMpijrWD.css">
<style>.stl-content-breadcrumbs{display:none!important;height:0!important;margin:0!important;padding:0!important}
</style>
<link rel="stylesheet" href="/_astro/platform-docs.C8tKlvDz.css">
<link rel="stylesheet" href="/_astro/AgentDocsDirective.DEiRrpNI.css">
<link rel="stylesheet" href="/_astro/changelog@_@astro.C-gtdg_7.css">
<link rel="stylesheet" href="/_astro/PageLayout.D8pYrHWP.css">
<style>@layer base{.syntax-highlighter{background:transparent;color:var(--color-text);overflow-x:auto}.syntax-highlighter>code{border:none;box-shadow:none;font-family:var(--monospace)}.syntax-highlighter>code[data-wrap-long-lines=true]{overflow-wrap:anywhere;white-space:pre-wrap;word-break:break-word}.syntax-highlighter .syntax-highlighter-line-numbers{float:left;padding-right:16px}.syntax-highlighter .syntax-highlighter-line-number{color:var(--color-text-disabled);line-height:20px;opacity:.5;text-align:right;-webkit-user-select:none;-moz-user-select:none;user-select:none}.syntax-highlighter .shiki-token{color:var(--shiki-light, inherit)}.syntax-highlighter [data-highlighted-row=true]{display:block;width:150%;margin-left:-25%;background-color:var(--pill-success-bg)}.syntax-highlighter [data-highlighted-row-subtle=true]{background-color:rgba(var(--sh-fg),.08)}.dark .syntax-highlighter .shiki-token,.syntax-highlighter.dark-mode .shiki-token{color:var(--shiki-dark, var(--shiki-light, inherit))}}
.prompt-scroll:where(.astro-blfj6jyd){--prompt-scroll-gutter-x: 14px;--prompt-scroll-gutter-y: 16px;padding:0 calc(4.5rem + var(--prompt-scroll-gutter-x)) 0 1.5rem;scrollbar-gutter:stable;scrollbar-width:thin;scrollbar-color:rgb(15 23 42 / 28%) transparent}.prompt-scroll--header-actions:where(.astro-blfj6jyd){padding-right:1.5rem}.prompt-scroll-frame:where(.astro-blfj6jyd){position:relative;background:inherit}.prompt-scroll__content:where(.astro-blfj6jyd){margin-right:calc(-1 * var(--prompt-scroll-gutter-x))}.prompt-scroll--header-actions:where(.astro-blfj6jyd) .prompt-scroll__content:where(.astro-blfj6jyd){margin-right:0}.prompt-scroll-frame:where(.astro-blfj6jyd):before,.prompt-scroll-frame:where(.astro-blfj6jyd):after{content:"";position:absolute;right:0;width:calc(1.5rem + var(--prompt-scroll-gutter-x) + 8px);height:var(--prompt-scroll-gutter-y);background:inherit;pointer-events:none;z-index:1}.prompt-scroll-frame:where(.astro-blfj6jyd):before{top:0}.prompt-scroll-frame:where(.astro-blfj6jyd):after{bottom:0}.prompt-actions:where(.astro-blfj6jyd){z-index:2}.prompt-scroll:where(.astro-blfj6jyd)::-webkit-scrollbar{width:8px;height:8px}.prompt-scroll:where(.astro-blfj6jyd)::-webkit-scrollbar-track{background:transparent;margin-block:var(--prompt-scroll-gutter-y)}.prompt-scroll:where(.astro-blfj6jyd)::-webkit-scrollbar-thumb{background-color:#0f172a47;border:2px solid transparent;border-radius:9999px;background-clip:padding-box}html.dark .prompt-scroll:where(.astro-blfj6jyd),[data-theme=dark] .prompt-scroll:where(.astro-blfj6jyd){scrollbar-color:rgb(255 255 255 / 28%) transparent}html.dark .prompt-scroll:where(.astro-blfj6jyd)::-webkit-scrollbar-thumb,[data-theme=dark] .prompt-scroll:where(.astro-blfj6jyd)::-webkit-scrollbar-thumb{background-color:#ffffff47}
.page-copy-action:where(.astro-y3m22efp){display:inline-flex;min-height:26px;align-items:center;justify-content:center;gap:6px;border:1px solid var(--border-primary-outline, rgb(209 213 219));border-radius:8px;background:var(--surface-primary, #fff);padding:5px 10px;color:var(--text-primary, #202123);font-size:12px;font-weight:500;line-height:1;white-space:nowrap;transition:border-color .12s ease,background-color .12s ease,color .12s ease,opacity .12s ease}.page-copy-action:where(.astro-y3m22efp):hover:not(:disabled){background:var(--surface-primary-hover, #f7f7f8)}.page-copy-action:where(.astro-y3m22efp):focus-visible{outline:2px solid var(--border-primary, #111);outline-offset:2px}.page-copy-action:where(.astro-y3m22efp):disabled{cursor:progress;opacity:.7}.page-copy-action--cta:where(.astro-y3m22efp){min-height:42px;gap:8px;border-radius:9999px;padding:10px 18px;font-size:14px}.page-copy-action__icon:where(.astro-y3m22efp){display:inline-flex;width:14px;height:14px;align-items:center;justify-content:center}.page-copy-action__icon:where(.astro-y3m22efp) svg{width:14px;height:14px}.page-copy-action__icon--check:where(.astro-y3m22efp),.page-copy-action:where(.astro-y3m22efp)[data-copied=true] .page-copy-action__icon--copy:where(.astro-y3m22efp){display:none}.page-copy-action:where(.astro-y3m22efp)[data-copied=true] .page-copy-action__icon--check:where(.astro-y3m22efp){display:inline-flex}
@layer components.base{._root_1x2h7_2{position:relative;display:flex;flex-direction:column;margin:20px 0;border:.5px solid var(--color-border-primary-surface);border-radius:8px;background:var(--code-snippet-bg)}._root_1x2h7_2+._root_1x2h7_2{margin-top:1em}._flush_1x2h7_16{width:100%;border:0;background:transparent;background-color:transparent;color:var(--color-text-emphasis);line-height:20px}._flush_1x2h7_16 code>code{padding-right:20px!important}._flush_1x2h7_16 .syntax-highlighter{background:transparent;font-size:13px;letter-spacing:var(--font-tracking-wide)}._flush_1x2h7_16 ._header_1x2h7_34{position:relative;z-index:1;justify-content:space-between;padding-left:8px;border-bottom:none;background:transparent}._flush_1x2h7_16 ._header_1x2h7_34 ._title_1x2h7_42{display:none}._flush_1x2h7_16 ._header_1x2h7_34 .code-sample-select-val{font-size:12px;letter-spacing:var(--font-tracking-wide)}._flush_1x2h7_16 ._header_1x2h7_34 .code-sample-select-wrap{margin-bottom:4px;margin-left:12px;font-size:12px;letter-spacing:var(--font-tracking-wide)}._flush_1x2h7_16 ._body_1x2h7_59{background:transparent}._flush_1x2h7_16 ._body_1x2h7_59 ._pre_1x2h7_62{padding-top:0}._root_1x2h7_2 .python-upgrade-banner{display:flex;padding:2px;background:var(--card-gradient);color:#fff;font-size:.8em;font-weight:var(--font-weight-bold);text-align:center}._root_1x2h7_2 .python-upgrade-banner svg{margin-top:6px;margin-right:8px;margin-left:8px}._root_1x2h7_2 .python-upgrade-banner path{stroke:#fff}._header_1x2h7_34{overflow:auto;display:flex;align-items:center;gap:4px;flex-shrink:0;padding:4px 8px 4px 14px;border-bottom:.5px solid var(--color-border-primary-surface);border-top-left-radius:8px;border-top-right-radius:8px}._title_1x2h7_42{overflow:hidden;flex:1 1 auto;margin-right:12px;color:var(--color-text);font-family:var(--monospace);font-size:12px;font-weight:var(--font-weight-normal);letter-spacing:var(--font-tracking-wide);text-overflow:ellipsis;white-space:nowrap}._sep_1x2h7_113{flex:0 0 auto;min-width:1px;height:22px;padding-left:8px;border-left:1px solid var(--color-background-primary-soft);margin-left:8px}._body_1x2h7_59{position:relative;flex-grow:1;flex-shrink:0}._body_1x2h7_59 ._pre_1x2h7_62{height:100%;min-height:44px;padding:12px 16px;border-radius:8px;margin:0;font-size:14px;line-height:20px;white-space:pre;background:var(--code-snippet-bg)}._body_1x2h7_59._bodyWithHeader_1x2h7_139 ._pre_1x2h7_62{border-top-left-radius:0;border-top-right-radius:0}._bodyWithCopyFloat_1x2h7_145 ._pre_1x2h7_62{padding-right:56px}._copyFloat_1x2h7_157{position:absolute;top:6px;right:6px}._oneliner_1x2h7_162 ._copyFloat_1x2h7_157{top:50%;transform:translateY(-50%)}._copyButton_1x2h7_168{height:1.75rem;padding:0 .5rem;border-radius:.375rem}}
@layer components{._Arrow_t2o77_1{--arrow-size: 6px;position:absolute;width:0;height:0}._Arrow_t2o77_1[data-side=top]{bottom:0;left:50%;border-top:var(--arrow-size) solid var(--gray-700);border-right:var(--arrow-size) solid transparent;border-left:var(--arrow-size) solid transparent;margin-right:-8px;transform:translate(-50%) translateY(100%)}._Arrow_t2o77_1[data-side=bottom]{top:0;left:50%;border-right:var(--arrow-size) solid transparent;border-bottom:var(--arrow-size) solid var(--gray-700);border-left:var(--arrow-size) solid transparent;margin-left:-8px;transform:translate(-50%) translateY(-100%)}._Arrow_t2o77_1[data-side=left]{top:50%;right:0;border-top:var(--arrow-size) solid transparent;border-bottom:var(--arrow-size) solid transparent;border-left:var(--arrow-size) solid var(--gray-700);margin-right:-8px;transform:translate(100%) translateY(-50%)}._Arrow_t2o77_1[data-side=right]{top:50%;left:0;border-top:var(--arrow-size) solid transparent;border-right:var(--arrow-size) solid var(--gray-700);border-bottom:var(--arrow-size) solid transparent;margin-left:-8px;transform:translate(-100%) translateY(-50%)}}@layer components{._surfaceOption_spfw2_1>div>div>div:first-child{display:none}._surfaceOption_spfw2_1>div>div{align-items:center}[data-radix-popper-content-wrapper]:has(.codex-surface-option){z-index:40!important}[role=listbox]:has(.codex-surface-option){outline:none}}
.language-blocks:where(.astro-e5cudjd6){display:flex;flex-wrap:wrap;gap:1rem;margin-top:2rem}.language-blocks:where(.astro-e5cudjd6)>:where(.astro-e5cudjd6){width:0;flex:1 1 350px}.api-overview:where(.astro-e5cudjd6) .stldocs-resource-content:where(.astro-e5cudjd6){padding:0!important}
</style>
<link rel="stylesheet" href="/_astro/_..Lx_bktJG.css">
<style>@layer components{._ModelsTitle_163e7_1{font-size:30px;font-weight:var(--font-weight-semibold);letter-spacing:var(--font-tracking-tight);line-height:1.3}}@layer components{._SectionContent_1tiej_1>*{border-top:1px solid var(--color-background-primary-soft)}}
.blog-prose-content :where(h2):not(:where([class~=not-prose],[class~=not-prose] *)){font-size:var(--font-heading-xl-size);font-weight:var(--font-heading-xl-weight);letter-spacing:var(--font-heading-xl-tracking);line-height:var(--font-heading-xl-line-height)}.blog-prose-content :where(h3):not(:where([class~=not-prose],[class~=not-prose] *)){font-size:var(--font-heading-lg-size);font-weight:var(--font-heading-lg-weight);letter-spacing:var(--font-heading-lg-tracking);line-height:var(--font-heading-lg-line-height)}
.request-builder-container form{display:grid;grid-template-columns:max-content max-content max-content 1fr;font-family:var(--stl-typography-font);font-size:var(--stl-typography-text-body-sm);color:var(--stl-color-foreground)}.request-builder-container form>*{padding-inline-start:12px;padding-inline-end:8px}.request-builder-container form>h4{grid-column:1 / -1;text-transform:capitalize;font-size:var(--stl-typography-scale-sm);margin-top:0;margin-bottom:.25em;color:var(--stl-color-foreground-muted);padding-top:.75rem}.request-builder-container form>h4:not(:first-child){border-top:1px solid var(--stl-color-border)}.request-builder-container form .request-builder-param{grid-column:1 / -1;display:grid;grid-template-columns:subgrid;align-items:center;-moz-column-gap:.5rem;column-gap:.5rem;padding-block:.35rem}.request-builder-container form .request-builder-param .request-builder-param-info-button{color:var(--stl-color-foreground-muted);margin-inline:-4px;padding:0}.request-builder-container form .request-builder-param .request-builder-param-label{font-family:var(--stl-typography-font-mono)}.request-builder-container form .request-builder-param .request-builder-param-colon{font-family:var(--stl-typography-font-mono);color:var(--stl-color-foreground-muted)}.request-builder-container form .request-builder-param .request-builder-param-value input{margin:6px 8px;font-size:inherit}.request-builder-container form .request-builder-param:has(+h4),.request-builder-container form .request-builder-param:last-child{padding-bottom:.75rem}.request-builder-footer .stl-ui-button--ghost .stl-ui-button__icon{color:var(--stl-color-foreground);opacity:var(--stl-opacity-level-040)}
</style>
<link rel="stylesheet" href="/_astro/changelog@_@astro.lvKJJgPj.css">
<style>.codex-collection-icon-tile:where(.astro-ajgvnpvy){background-color:rgb(var(--codex-collection-accent-rgb) / .1);background-image:linear-gradient(135deg,#fff0 12%,#ffffff24 34%,#ffffff7a,#ffffff24 66%,#fff0 88%),linear-gradient(145deg,#ffffff2e,#ffffff0a 48%,#ffffff24),linear-gradient(145deg,rgb(var(--codex-collection-accent-rgb) / .2),rgb(var(--codex-collection-gradient-rgb) / .1) 48%,rgb(var(--codex-collection-accent-rgb) / .16)),linear-gradient(35deg,rgb(var(--codex-collection-gradient-rgb) / .16),rgb(var(--codex-collection-accent-rgb) / .06) 42%,rgb(var(--codex-collection-gradient-rgb) / .14));box-shadow:inset 0 0 0 1px rgb(var(--codex-collection-accent-rgb) / .1)}html.dark .codex-collection-icon-tile:where(.astro-ajgvnpvy){background-color:rgb(var(--codex-collection-accent-rgb) / .28);background-image:linear-gradient(135deg,#0000 12%,#00000029 34%,#0000006b,#00000029 66%,#0000 88%),linear-gradient(145deg,rgb(var(--codex-collection-accent-rgb) / .58),rgb(var(--codex-collection-gradient-rgb) / .34) 48%,rgb(var(--codex-collection-accent-rgb) / .46)),linear-gradient(35deg,#ffffff14,#fff0 42%,#ffffff0f);box-shadow:inset 0 0 0 1px #ffffff14,inset 0 0 18px rgb(var(--codex-collection-accent-rgb) / .1)}.codex-collection-grid:where(.astro-nszkyfvx){display:grid;grid-template-columns:minmax(0,1fr);gap:1.5rem}@media(min-width:870px){.codex-collection-grid--two-column:where(.astro-nszkyfvx){grid-template-columns:repeat(2,minmax(0,1fr));-moz-column-gap:4rem;column-gap:4rem;row-gap:2rem}}
.workflow-steps:where(.astro-4drqtmie)>ol{counter-reset:workflow-step;list-style:none;padding-left:0;margin:1.5rem 0}.workflow-steps:where(.astro-4drqtmie)>ol>li{counter-increment:workflow-step;position:relative;padding-left:2.75rem;margin:0}.workflow-steps:where(.astro-4drqtmie)>ol>li:not(:last-child){padding-bottom:.75rem}.workflow-steps:where(.astro-4drqtmie)>ol>li:before{content:counter(workflow-step);position:absolute;left:0;top:0;height:27px;min-width:27px;padding:0 6px;display:inline-flex;align-items:center;justify-content:center;border-radius:9999px;background:var(--color-gray-100);color:var(--color-gray-700);font-size:12px;font-weight:600;line-height:1;font-variant-numeric:tabular-nums;box-sizing:border-box}.workflow-steps--headings:where(.astro-4drqtmie)>ol>li>p:first-child{font-weight:600}.workflow-steps--headings:where(.astro-4drqtmie)>ol>li>h3:first-child{margin:0;font-size:inherit;line-height:inherit;font-weight:600}
[data-feed-field-layout=cards] table.feed-field-table-responsive{display:none!important}[data-feed-field-layout=cards] .feed-field-card-list{display:block!important;margin-top:.75rem}[data-feed-field-layout=table] .feed-field-card-list,[data-feed-field-layout=table] .feed-field-section-controls{display:none!important}.feed-field-section-controls{margin-top:.25rem;margin-bottom:.45rem;display:flex;flex-wrap:wrap;gap:.4rem}.feed-field-section-control-btn{display:inline-flex;align-items:center;border:1px solid var(--color-border-default);border-radius:.375rem;padding:.25rem .5rem;font-size:.7rem;font-weight:600;color:var(--color-text-secondary);background:transparent;transition:background .12s ease,color .12s ease}.feed-field-section-control-btn:hover{background:var(--color-surface);color:var(--color-text-primary)}.feed-field-card{margin-bottom:.875rem;border:1px solid var(--color-border-default, #d1d5db);border-radius:.75rem;background:var(--color-surface);padding:.75rem .875rem}.feed-field-card-header{display:flex;align-items:flex-start;justify-content:space-between;gap:.75rem;margin-bottom:.25rem}.feed-field-card-attribute{min-width:0}.feed-field-card-attribute-label{color:#2563eb;font-size:.72rem;font-weight:700;letter-spacing:.01em;text-transform:uppercase;margin-bottom:.125rem}.feed-field-card-attribute-value{color:var(--color-text-primary);font-weight:650;line-height:1.35;word-break:break-word}.feed-field-card-requirement-badge{display:inline-flex;align-items:center;border-radius:9999px;padding:.2rem .55rem;font-size:.7rem;font-weight:700;letter-spacing:.01em;white-space:nowrap}.feed-field-card-requirement-badge.is-required{background:#fee2e2;color:#b91c1c}.feed-field-card-requirement-badge.is-conditional{background:#fef9c3;color:#a16207}.feed-field-card-requirement-badge.is-recommended{background:#dbeafe;color:#1d4ed8}.feed-field-card-requirement-badge.is-optional,.feed-field-card-requirement-badge.is-neutral{background:#f3f4f6;color:#6b7280}.feed-field-card-toggle{width:-moz-fit-content;width:fit-content;margin-left:auto;margin-right:auto;display:flex;justify-content:center;align-items:center;gap:.35rem;margin-top:.375rem;border:0;background:transparent;padding:.22rem .38rem;min-height:2rem;cursor:pointer;border-radius:.375rem;transition:background-color .12s ease}.feed-field-card-toggle:hover{background:#f3f4f6}.feed-field-card-toggle-icon{display:inline-block;width:16px;height:10px;color:var(--color-text-secondary);transform:rotate(0);transition:transform .16s ease}.feed-field-card-toggle-text{color:var(--color-text-secondary);font-size:.72rem;font-weight:600;line-height:1}.feed-field-card-toggle[aria-expanded=true] .feed-field-card-toggle-icon{transform:rotate(180deg)}.feed-field-card-row{display:grid;grid-template-columns:minmax(110px,24%) 1fr;gap:.4rem;padding:.3rem 0;border-bottom:1px solid color-mix(in srgb,var(--color-border-default) 60%,transparent)}.feed-field-card-row:last-child{border-bottom:0}.feed-field-card-key{color:var(--color-text-secondary);font-size:.72rem;font-weight:700;letter-spacing:.01em;text-transform:uppercase;word-break:break-word}.feed-field-card-value{color:var(--color-text-primary);font-size:.875rem;line-height:1.5;word-break:break-word}.feed-field-card-value code{font-size:.82rem}
</style>
<link rel="stylesheet" href="/_astro/_slug_@_@astro.Dv-H81Hr.css">
<style>#plugins-changelog li:target button[data-anchor-id]{opacity:1}
</style><script type="module" src="/_astro/page.BLsl0KIt.js"></script><style>@layer components{._Notice_wyxfv_1{margin-top:24px;margin-bottom:24px}._Notice_wyxfv_1 p,._Notice_wyxfv_1 code{margin:0!important;line-height:18px!important}._Notice_wyxfv_1 p code{font-size:.875em}}
</style><link rel="stylesheet" href="/_astro/Alert.Dl332ZUE.css"></head> <body class="astro-i35jzdbg"> <a href="#_top" class="astro-d5zligwr">Skip to content</a> <div class="agent-docs-directive astro-e454tk5z" data-agent-docs-directive>
For the complete documentation index, see <a href="/llms.txt" tabindex="-1" class="astro-e454tk5z">llms.txt</a>. Markdown versions of documentation pages are available by appending
<code class="astro-e454tk5z">.md</code> to the page URL.
</div> <div class="page"> <header> <script type="module" src="/_astro/Header.astro_astro_type_script_index_0_lang.CZqP2L81.js"></script> <header id="header" class="fixed top-0 w-full h-16 z-50 bg-white dark:bg-black border-b border-primary-surface astro-3ef6ksr2"> <div class="flex items-center h-full px-4 md:px-8 lg:grid lg:grid-cols-[minmax(0,1fr)_auto_minmax(0,1fr)] lg:gap-6 astro-3ef6ksr2"> <!-- Logo --> <a href="/" class="flex items-center font-semibold ml-0 lg:-ml-2 lg:justify-self-start astro-3ef6ksr2"> <img src="/OpenAI_Developers.svg" alt="OpenAI Developers" class="h-6 w-48 md:h-6 dark:invert astro-3ef6ksr2" data-site-visibility-exclude="chatgpt-docs"> <span class="flex items-center text-default astro-3ef6ksr2" data-site-visibility-include="chatgpt-docs">  <svg xmlns="http://www.w3.org/2000/svg" width="100" height="100" fill="currentColor" viewBox="0 0 100 100" class="h-6 w-6 astro-3ef6ksr2 " aria-hidden="true" ><path color="currentColor" d="M38.355 36.52v-9.415c0-.793.297-1.388.99-1.784l18.93-10.902c2.578-1.486 5.65-2.18 8.82-2.18 11.894 0 19.426 9.218 19.426 19.029 0 .694 0 1.486-.1 2.28L66.799 22.05c-1.189-.694-2.379-.694-3.568 0L38.355 36.52Zm44.202 36.67V50.694c0-1.388-.596-2.38-1.785-3.073L55.897 33.15l8.126-4.658c.694-.396 1.289-.396 1.982 0l18.93 10.902c5.452 3.172 9.118 9.91 9.118 16.452 0 7.531-4.46 14.47-11.496 17.344Zm-50.05-19.82-8.127-4.757c-.693-.396-.99-.99-.99-1.784V25.025c0-10.605 8.126-18.633 19.127-18.633 4.163 0 8.028 1.388 11.3 3.865l-19.525 11.3c-1.189.693-1.784 1.684-1.784 3.072v28.74ZM50 63.478l-11.645-6.541V43.062L50 36.522l11.645 6.54v13.875L50 63.477Zm7.483 30.129c-4.163 0-8.028-1.388-11.3-3.865l19.525-11.3c1.189-.693 1.784-1.684 1.784-3.071V46.629l8.226 4.757c.694.396.991.991.991 1.784v21.803c0 10.605-8.226 18.633-19.226 18.633v.001Zm-23.49-22.101-18.93-10.902c-5.45-3.172-9.117-9.91-9.117-16.451 0-7.632 4.559-14.47 11.595-17.344v22.596c0 1.388.595 2.379 1.784 3.072l24.777 14.37-8.126 4.659c-.694.396-1.289.396-1.982 0ZM32.905 87.76c-11.2 0-19.425-8.425-19.425-18.83 0-.794.1-1.587.198-2.38L33.2 77.85c1.189.693 2.379.693 3.568 0l24.876-14.37v9.415c0 .793-.298 1.388-.992 1.784L41.724 85.58c-2.576 1.486-5.649 2.18-8.82 2.18h.001Zm24.579 11.793c11.992 0 22.001-8.523 24.281-19.822C92.864 76.857 100 66.451 100 55.846c0-6.937-2.973-13.676-8.325-18.533.496-2.081.793-4.163.793-6.243 0-14.172-11.496-24.777-24.777-24.777-2.676 0-5.253.396-7.83 1.288C55.401 3.221 49.257.445 42.517.445c-11.992 0-22.001 8.523-24.281 19.822C7.136 23.14 0 33.547 0 44.152c0 6.938 2.973 13.676 8.325 18.533-.496 2.081-.793 4.163-.793 6.243 0 14.172 11.497 24.778 24.777 24.778 2.676 0 5.253-.397 7.83-1.289 4.459 4.36 10.604 7.136 17.344 7.136Z"></path></svg> <span class="sr-only astro-3ef6ksr2">ChatGPT</span>  </span> </a> <!-- Links --> <nav class="hidden lg:flex items-center justify-center gap-1 astro-3ef6ksr2"> <div class="relative group astro-3ef6ksr2"> <a href="/" class="flex items-center gap-1 text-sm px-2.5 py-1 rounded-md text-primary-soft hover:text-default hover:bg-primary-soft-alpha astro-3ef6ksr2"> Home  </a>  </div><div class="relative group astro-3ef6ksr2" data-site-visibility-exclude="chatgpt-docs"> <a href="/api/docs" class="flex items-center gap-1 text-sm px-2.5 py-1 rounded-md text-default bg-primary-soft astro-3ef6ksr2"> API  </a>  </div><div class="relative group astro-3ef6ksr2" data-site-visibility-exclude="chatgpt-docs"> <a href="https://learn.chatgpt.com/docs" target="_blank" rel="noopener noreferrer" class="flex items-center gap-1 text-sm px-2.5 py-1 rounded-md text-primary-soft hover:text-default hover:bg-primary-soft-alpha astro-3ef6ksr2" aria-haspopup="menu"> Codex <svg viewBox="0 0 24 24" fill="none" xmlns="http://www.w3.org/2000/svg" class="h-3.5 w-3.5 text-tertiary astro-3ef6ksr2 " ><path d="M11.2929 16.2929C11.6834 16.6834 12.3166 16.6834 12.7071 16.2929L18.7071 10.2929C19.0976 9.90237 19.0976 9.26921 18.7071 8.87868C18.3166 8.48816 17.6834 8.48816 17.2929 8.87868L12 14.1716L6.70711 8.87868C6.31658 8.48816 5.68342 8.48816 5.29289 8.87868C4.90237 9.26921 4.90237 9.90237 5.29289 10.2929L11.2929 16.2929Z" fill="currentColor"></path></svg> </a> <div class="invisible opacity-0 absolute left-0 top-full z-50 mt-2 min-w-full w-max transition-opacity duration-150 group-hover:visible group-hover:opacity-100 group-focus-within:visible group-focus-within:opacity-100 before:content-[''] before:absolute before:-top-2 before:left-0 before:right-0 before:h-2 astro-3ef6ksr2" role="menu"> <div class="overflow-hidden rounded-md border border-primary-surface bg-surface shadow-md ring-1 ring-black/5 dark:ring-white/10 astro-3ef6ksr2"> <div class="astro-3ef6ksr2"> <a role="menuitem" href="https://learn.chatgpt.com/docs" target="_blank" rel="noopener noreferrer" class="block px-4 py-3 text-sm text-default transition-colors hover:bg-primary-soft-alpha dark:hover:bg-alpha-10 hover:text-default astro-3ef6ksr2"> <div class="flex flex-col gap-1 astro-3ef6ksr2"> <div class="font-medium astro-3ef6ksr2">Docs</div> <div class="text-sm text-secondary astro-3ef6ksr2"> Guides, concepts, and product docs for Codex </div> </div> </a><a role="menuitem" href="https://learn.chatgpt.com/use-cases" target="_blank" rel="noopener noreferrer" class="block px-4 py-3 text-sm text-default transition-colors hover:bg-primary-soft-alpha dark:hover:bg-alpha-10 hover:text-default astro-3ef6ksr2"> <div class="flex flex-col gap-1 astro-3ef6ksr2"> <div class="font-medium astro-3ef6ksr2">Use cases</div> <div class="text-sm text-secondary astro-3ef6ksr2"> Example workflows and tasks teams can take on with ChatGPT or Codex </div> </div> </a> </div> </div> </div> </div><div class="relative group astro-3ef6ksr2" data-site-visibility-include="chatgpt-docs"> <a href="/codex" class="flex items-center gap-1 text-sm px-2.5 py-1 rounded-md text-primary-soft hover:text-default hover:bg-primary-soft-alpha astro-3ef6ksr2"> Docs  </a>  </div><div class="relative group astro-3ef6ksr2" data-site-visibility-include="chatgpt-docs"> <a href="/codex/use-cases" class="flex items-center gap-1 text-sm px-2.5 py-1 rounded-md text-primary-soft hover:text-default hover:bg-primary-soft-alpha astro-3ef6ksr2"> Use cases  </a>  </div><div class="relative group astro-3ef6ksr2" data-site-visibility-include="chatgpt-docs"> <a href="/codex/resources" class="flex items-center gap-1 text-sm px-2.5 py-1 rounded-md text-primary-soft hover:text-default hover:bg-primary-soft-alpha astro-3ef6ksr2"> Resources  </a>  </div><div class="relative group astro-3ef6ksr2" data-site-visibility-exclude="chatgpt-docs"> <a href="/chatgpt" class="flex items-center gap-1 text-sm px-2.5 py-1 rounded-md text-primary-soft hover:text-default hover:bg-primary-soft-alpha astro-3ef6ksr2" aria-haspopup="menu"> ChatGPT <svg viewBox="0 0 24 24" fill="none" xmlns="http://www.w3.org/2000/svg" class="h-3.5 w-3.5 text-tertiary astro-3ef6ksr2 " ><path d="M11.2929 16.2929C11.6834 16.6834 12.3166 16.6834 12.7071 16.2929L18.7071 10.2929C19.0976 9.90237 19.0976 9.26921 18.7071 8.87868C18.3166 8.48816 17.6834 8.48816 17.2929 8.87868L12 14.1716L6.70711 8.87868C6.31658 8.48816 5.68342 8.48816 5.29289 8.87868C4.90237 9.26921 4.90237 9.90237 5.29289 10.2929L11.2929 16.2929Z" fill="currentColor"></path></svg> </a> <div class="invisible opacity-0 absolute left-0 top-full z-50 mt-2 min-w-full w-max transition-opacity duration-150 group-hover:visible group-hover:opacity-100 group-focus-within:visible group-focus-within:opacity-100 before:content-[''] before:absolute before:-top-2 before:left-0 before:right-0 before:h-2 astro-3ef6ksr2" role="menu"> <div class="overflow-hidden rounded-md border border-primary-surface bg-surface shadow-md ring-1 ring-black/5 dark:ring-white/10 astro-3ef6ksr2"> <div class="astro-3ef6ksr2"> <a role="menuitem" href="/plugins" class="block px-4 py-3 text-sm text-default transition-colors hover:bg-primary-soft-alpha dark:hover:bg-alpha-10 hover:text-default astro-3ef6ksr2"> <div class="flex flex-col gap-1 astro-3ef6ksr2"> <div class="font-medium astro-3ef6ksr2">Plugins</div> <div class="text-sm text-secondary astro-3ef6ksr2"> Extend ChatGPT and Codex </div> </div> </a><a role="menuitem" href="/workspace-agents" class="block px-4 py-3 text-sm text-default transition-colors hover:bg-primary-soft-alpha dark:hover:bg-alpha-10 hover:text-default astro-3ef6ksr2"> <div class="flex flex-col gap-1 astro-3ef6ksr2"> <div class="font-medium astro-3ef6ksr2">Workspace Agents</div> <div class="text-sm text-secondary astro-3ef6ksr2"> Trigger published ChatGPT workspace agents </div> </div> </a><a role="menuitem" href="/commerce" class="block px-4 py-3 text-sm text-default transition-colors hover:bg-primary-soft-alpha dark:hover:bg-alpha-10 hover:text-default astro-3ef6ksr2"> <div class="flex flex-col gap-1 astro-3ef6ksr2"> <div class="font-medium astro-3ef6ksr2">Commerce</div> <div class="text-sm text-secondary astro-3ef6ksr2"> Build commerce flows in ChatGPT </div> </div> </a><a role="menuitem" href="/ads" class="block px-4 py-3 text-sm text-default transition-colors hover:bg-primary-soft-alpha dark:hover:bg-alpha-10 hover:text-default astro-3ef6ksr2"> <div class="flex flex-col gap-1 astro-3ef6ksr2"> <div class="font-medium astro-3ef6ksr2">Ads</div> <div class="text-sm text-secondary astro-3ef6ksr2"> Publish and measure ads in ChatGPT </div> </div> </a> </div> </div> </div> </div><div class="relative group astro-3ef6ksr2" data-site-visibility-exclude="chatgpt-docs"> <a href="/learn" class="flex items-center gap-1 text-sm px-2.5 py-1 rounded-md text-primary-soft hover:text-default hover:bg-primary-soft-alpha astro-3ef6ksr2" aria-haspopup="menu"> Resources <svg viewBox="0 0 24 24" fill="none" xmlns="http://www.w3.org/2000/svg" class="h-3.5 w-3.5 text-tertiary astro-3ef6ksr2 " ><path d="M11.2929 16.2929C11.6834 16.6834 12.3166 16.6834 12.7071 16.2929L18.7071 10.2929C19.0976 9.90237 19.0976 9.26921 18.7071 8.87868C18.3166 8.48816 17.6834 8.48816 17.2929 8.87868L12 14.1716L6.70711 8.87868C6.31658 8.48816 5.68342 8.48816 5.29289 8.87868C4.90237 9.26921 4.90237 9.90237 5.29289 10.2929L11.2929 16.2929Z" fill="currentColor"></path></svg> </a> <div class="invisible opacity-0 absolute left-0 top-full z-50 mt-2 min-w-full w-max transition-opacity duration-150 group-hover:visible group-hover:opacity-100 group-focus-within:visible group-focus-within:opacity-100 before:content-[''] before:absolute before:-top-2 before:left-0 before:right-0 before:h-2 astro-3ef6ksr2" role="menu"> <div class="overflow-hidden rounded-md border border-primary-surface bg-surface shadow-md ring-1 ring-black/5 dark:ring-white/10 astro-3ef6ksr2"> <div class="astro-3ef6ksr2"> <a role="menuitem" href="/showcase" class="block px-4 py-3 text-sm text-default transition-colors hover:bg-primary-soft-alpha dark:hover:bg-alpha-10 hover:text-default astro-3ef6ksr2"> <div class="flex flex-col gap-1 astro-3ef6ksr2"> <div class="font-medium astro-3ef6ksr2">Showcase</div> <div class="text-sm text-secondary astro-3ef6ksr2"> Demo apps to get inspired </div> </div> </a><a role="menuitem" href="/blog" class="block px-4 py-3 text-sm text-default transition-colors hover:bg-primary-soft-alpha dark:hover:bg-alpha-10 hover:text-default astro-3ef6ksr2"> <div class="flex flex-col gap-1 astro-3ef6ksr2"> <div class="font-medium astro-3ef6ksr2">Blog</div> <div class="text-sm text-secondary astro-3ef6ksr2"> Learnings and experiences from developers </div> </div> </a><a role="menuitem" href="/cookbook" class="block px-4 py-3 text-sm text-default transition-colors hover:bg-primary-soft-alpha dark:hover:bg-alpha-10 hover:text-default astro-3ef6ksr2"> <div class="flex flex-col gap-1 astro-3ef6ksr2"> <div class="font-medium astro-3ef6ksr2">Cookbook</div> <div class="text-sm text-secondary astro-3ef6ksr2"> Notebook examples for building with OpenAI models </div> </div> </a><a role="menuitem" href="/learn" class="block px-4 py-3 text-sm text-default transition-colors hover:bg-primary-soft-alpha dark:hover:bg-alpha-10 hover:text-default astro-3ef6ksr2"> <div class="flex flex-col gap-1 astro-3ef6ksr2"> <div class="font-medium astro-3ef6ksr2">Learn</div> <div class="text-sm text-secondary astro-3ef6ksr2"> Docs, videos, and demo apps for building with OpenAI </div> </div> </a><a role="menuitem" href="/community" class="block px-4 py-3 text-sm text-default transition-colors hover:bg-primary-soft-alpha dark:hover:bg-alpha-10 hover:text-default astro-3ef6ksr2"> <div class="flex flex-col gap-1 astro-3ef6ksr2"> <div class="font-medium astro-3ef6ksr2">Community</div> <div class="text-sm text-secondary astro-3ef6ksr2"> Programs, meetups, and support for builders </div> </div> </a> </div> </div> </div> </div>  </nav> <!-- Theme Toggle, Mobile Menu --> <div class="ml-auto flex items-center gap-4 lg:gap-5 lg:ml-0 lg:justify-end lg:justify-self-end astro-3ef6ksr2"> <button type="button" data-header-search-button aria-controls="header-search-overlay" aria-expanded="false" class="hidden min-w-52 items-center justify-between gap-3 rounded-full border border-primary-surface bg-surface px-4 py-2 text-sm text-secondary transition-colors hover:bg-primary-soft-alpha hover:text-default xl:flex astro-3ef6ksr2"> <span class="truncate astro-3ef6ksr2">Start searching</span> <svg xmlns="http://www.w3.org/2000/svg" viewBox="0 0 24 24" fill="none" stroke="currentColor" stroke-width="2" stroke-linecap="round" stroke-linejoin="round" class="h-4 w-4 shrink-0 astro-3ef6ksr2 " ><circle cx="11" cy="11" r="8"></circle><line x1="21" y1="21" x2="16.65" y2="16.65"></line></svg> </button> <div class="hidden lg:flex astro-3ef6ksr2"> <div data-site-visibility-exclude="chatgpt-docs" class="astro-3ef6ksr2"> <div class="flex items-center gap-2"><a target="_blank" rel="noopener noreferrer" href="https://platform.openai.com/login" class="_Button_6dmow_1 not-prose !h-9 !w-9 justify-center !px-0 min-[1000px]:!w-auto min-[1000px]:!px-4" data-color="primary" data-variant="solid" data-pill="" data-size="md"><span class="_ButtonInner_6dmow_4"><span class="sr-only min-[1000px]:not-sr-only">API Dashboard</span><svg width="1em" height="1em" viewBox="0 0 24 24" fill="currentColor" data-external-link-indicator="persistent" class="shrink-0"><path fill-rule="evenodd" d="M16.243 6.757a1 1 0 0 1 1 1v7.072a1 1 0 0 1-2 0v-4.657L8.464 16.95a1 1 0 0 1-1.414-1.414l6.778-6.779H9.172a1 1 0 0 1 0-2h7.07Z" clip-rule="evenodd"></path></svg></span></a></div> </div><div data-site-visibility-include="chatgpt-docs" class="astro-3ef6ksr2"> <div class="flex items-center gap-2"><a target="_blank" rel="noopener noreferrer" href="https://chatgpt.com/" class="_Button_6dmow_1 not-prose  !w-9 justify-center !px-0 min-[1000px]:!w-auto min-[1000px]:!px-4" data-color="primary" data-variant="solid" data-pill="" data-size="lg"><span class="_ButtonInner_6dmow_4"><span class="sr-only min-[1000px]:not-sr-only">Try ChatGPT</span><svg width="1em" height="1em" viewBox="0 0 24 24" fill="currentColor" data-external-link-indicator="persistent" class="shrink-0"><path fill-rule="evenodd" d="M16.243 6.757a1 1 0 0 1 1 1v7.072a1 1 0 0 1-2 0v-4.657L8.464 16.95a1 1 0 0 1-1.414-1.414l6.778-6.779H9.172a1 1 0 0 1 0-2h7.07Z" clip-rule="evenodd"></path></svg></span></a></div> </div> </div> <button id="header-theme-button" aria-label="Toggle light and dark theme" class="hidden lg:flex text-secondary hover:text-default transition-colors astro-3ef6ksr2"> <svg width="22" height="22" viewBox="0 0 22 22" fill="none" xmlns="http://www.w3.org/2000/svg" class="block dark:hidden w-4 h-4 astro-3ef6ksr2 " ><path fill-rule="evenodd" clip-rule="evenodd" d="M11 0C11.5523 0 12 0.447715 12 1V3C12 3.55228 11.5523 4 11 4C10.4477 4 10 3.55228 10 3V1C10 0.447715 10.4477 0 11 0ZM3.22183 3.22183C3.61235 2.8313 4.24551 2.8313 4.63604 3.22183L6.05025 4.63604C6.44078 5.02656 6.44078 5.65973 6.05025 6.05025C5.65973 6.44078 5.02656 6.44078 4.63604 6.05025L3.22183 4.63604C2.8313 4.24551 2.8313 3.61235 3.22183 3.22183ZM18.7782 3.22183C19.1687 3.61235 19.1687 4.24551 18.7782 4.63604L17.364 6.05025C16.9734 6.44078 16.3403 6.44078 15.9497 6.05025C15.5592 5.65973 15.5592 5.02656 15.9497 4.63604L17.364 3.22183C17.7545 2.8313 18.3876 2.8313 18.7782 3.22183ZM11 8C9.34315 8 8 9.34315 8 11C8 12.6569 9.34315 14 11 14C12.6569 14 14 12.6569 14 11C14 9.34315 12.6569 8 11 8ZM6 11C6 8.23858 8.23858 6 11 6C13.7614 6 16 8.23858 16 11C16 13.7614 13.7614 16 11 16C8.23858 16 6 13.7614 6 11ZM0 11C0 10.4477 0.447715 10 1 10H3C3.55228 10 4 10.4477 4 11C4 11.5523 3.55228 12 3 12H1C0.447715 12 0 11.5523 0 11ZM18 11C18 10.4477 18.4477 10 19 10H21C21.5523 10 22 10.4477 22 11C22 11.5523 21.5523 12 21 12H19C18.4477 12 18 11.5523 18 11ZM6.05025 15.9497C6.44078 16.3403 6.44078 16.9734 6.05025 17.364L4.63604 18.7782C4.24551 19.1687 3.61235 19.1687 3.22183 18.7782C2.8313 18.3876 2.8313 17.7545 3.22183 17.364L4.63604 15.9497C5.02656 15.5592 5.65973 15.5592 6.05025 15.9497ZM15.9497 15.9497C16.3403 15.5592 16.9734 15.5592 17.364 15.9497L18.7782 17.364C19.1687 17.7545 19.1687 18.3876 18.7782 18.7782C18.3877 19.1687 17.7545 19.1687 17.364 18.7782L15.9497 17.364C15.5592 16.9734 15.5592 16.3403 15.9497 15.9497ZM11 18C11.5523 18 12 18.4477 12 19V21C12 21.5523 11.5523 22 11 22C10.4477 22 10 21.5523 10 21V19C10 18.4477 10.4477 18 11 18Z" fill="currentColor"></path></svg> <svg width="20" height="20" viewBox="0 0 20 20" fill="none" xmlns="http://www.w3.org/2000/svg" class="hidden dark:block w-4 h-4 astro-3ef6ksr2 " ><path d="M10.7836 0.470481C10.9676 0.765118 10.9855 1.13415 10.8309 1.44525C10.2994 2.51497 10 3.7211 10 5.00001C10 9.41829 13.5817 13 18 13L18.0575 12.9998C18.4049 12.9974 18.7287 13.1754 18.9127 13.47C19.0968 13.7647 19.1147 14.1337 18.9601 14.4448C17.325 17.7352 13.9279 20 10 20C4.47715 20 0 15.5229 0 10C0 4.50107 4.43841 0.038857 9.92838 0.000268937C10.2758 -0.00217271 10.5995 0.175844 10.7836 0.470481ZM8.40989 2.15803C4.75344 2.8954 2 6.12619 2 10C2 14.4183 5.58172 18 10 18C12.587 18 14.8886 16.7721 16.3516 14.8648C11.6131 14.0789 8 9.96139 8 5.00001C8 4.01361 8.1431 3.05953 8.40989 2.15803Z" fill="currentColor"></path></svg> </button> <button type="button" data-header-search-button aria-label="Search the API docs" aria-controls="header-search-overlay" aria-expanded="false" class="text-secondary hover:text-default transition-colors md:inline-flex xl:hidden astro-3ef6ksr2"> <svg xmlns="http://www.w3.org/2000/svg" viewBox="0 0 24 24" fill="none" stroke="currentColor" stroke-width="2" stroke-linecap="round" stroke-linejoin="round" class="w-4 h-4 text-secondary hover:text-default transition-colors astro-3ef6ksr2 " ><circle cx="11" cy="11" r="8"></circle><line x1="21" y1="21" x2="16.65" y2="16.65"></line></svg> </button> <!-- Mobile Menu Button --> <button id="header-drawer-button" type="button" aria-label="Toggle menu" aria-controls="drawer" aria-expanded="false" class="lg:hidden relative right-1 text-secondary hover:text-default transition-colors astro-3ef6ksr2"> <svg width="18" height="10" viewBox="0 0 18 10" fill="none" xmlns="http://www.w3.org/2000/svg" class="w-4 h-4 text-secondary hover:text-default transition-colors astro-3ef6ksr2 " ><path d="M0 1C0 0.447715 0.447715 0 1 0H17C17.5523 0 18 0.447715 18 1C18 1.55228 17.5523 2 17 2H1C0.447715 2 0 1.55228 0 1ZM0 9C0 8.44772 0.447715 8 1 8H11C11.5523 8 12 8.44772 12 9C12 9.55229 11.5523 10 11 10H1C0.447715 10 0 9.55229 0 9Z" fill="currentColor"></path></svg> </button> </div> </div> </header> <div class="fixed inset-x-0 top-16 z-40 hidden h-12 border-b border-primary-surface bg-gray-75 dark:bg-black lg:block astro-s3vzaxny" data-context-subnav data-site-visibility-exclude="chatgpt-docs"> <nav aria-label="API sections" class="flex h-full items-stretch gap-1 overflow-x-auto px-6 whitespace-nowrap lg:justify-center lg:px-8 astro-s3vzaxny"> <a href="/api/docs" class="group relative flex shrink-0 items-center text-sm font-medium transition-colors focus-visible:outline focus-visible:outline-2 focus-visible:outline-offset-[-4px] focus-visible:outline-primary-surface text-secondary hover:text-default astro-s3vzaxny"> <span class="px-2.5 py-1 astro-s3vzaxny">Overview</span>  </a><a href="/api/docs/models" class="group relative flex shrink-0 items-center text-sm font-medium transition-colors focus-visible:outline focus-visible:outline-2 focus-visible:outline-offset-[-4px] focus-visible:outline-primary-surface text-secondary hover:text-default astro-s3vzaxny"> <span class="px-2.5 py-1 astro-s3vzaxny">Models</span>  </a><a href="/api/docs/guides/agents" class="group relative flex shrink-0 items-center text-sm font-medium transition-colors focus-visible:outline focus-visible:outline-2 focus-visible:outline-offset-[-4px] focus-visible:outline-primary-surface text-secondary hover:text-default astro-s3vzaxny"> <span class="px-2.5 py-1 astro-s3vzaxny">Agents</span>  </a><a href="/api/docs/guides/tools" class="group relative flex shrink-0 items-center text-sm font-medium transition-colors focus-visible:outline focus-visible:outline-2 focus-visible:outline-offset-[-4px] focus-visible:outline-primary-surface text-secondary hover:text-default astro-s3vzaxny"> <span class="px-2.5 py-1 astro-s3vzaxny">Tools</span>  </a><a href="/api/docs/guides/realtime" class="group relative flex shrink-0 items-center text-sm font-medium transition-colors focus-visible:outline focus-visible:outline-2 focus-visible:outline-offset-[-4px] focus-visible:outline-primary-surface text-secondary hover:text-default astro-s3vzaxny"> <span class="px-2.5 py-1 astro-s3vzaxny">Voice &amp; Audio</span>  </a><a href="/api/docs/guides/production-best-practices" class="group relative flex shrink-0 items-center text-sm font-medium transition-colors focus-visible:outline focus-visible:outline-2 focus-visible:outline-offset-[-4px] focus-visible:outline-primary-surface text-secondary hover:text-default astro-s3vzaxny"> <span class="px-2.5 py-1 astro-s3vzaxny">Production</span>  </a><a href="/api/reference/overview" aria-current="true" class="group relative flex shrink-0 items-center text-sm font-medium transition-colors focus-visible:outline focus-visible:outline-2 focus-visible:outline-offset-[-4px] focus-visible:outline-primary-surface text-default astro-s3vzaxny"> <span class="px-2.5 py-1 astro-s3vzaxny">API reference</span> <span class="absolute inset-x-2.5 bottom-0 h-0.5 rounded-t bg-primary-solid astro-s3vzaxny" aria-hidden="true"></span> </a> </nav> </div> <div id="header-search-overlay" role="dialog" aria-modal="true" aria-labelledby="header-search-title" aria-hidden="true" data-open="false" class="fixed inset-0 z-[60] hidden items-start justify-center px-4 pt-20 pb-10 md:px-6 md:pt-24 astro-3ef6ksr2"> <div class="absolute inset-0 bg-black/35 backdrop-blur-xs transition-opacity dark:bg-black/70 astro-3ef6ksr2" data-header-search-dismiss></div> <div class="relative z-10 w-full max-w-4xl overflow-hidden rounded-[28px] bg-surface shadow-[0_36px_120px_-48px_rgba(15,23,42,0.55)] ring-1 ring-black/10 dark:ring-white/10 astro-3ef6ksr2" data-header-search-panel> <div data-header-search-body class="p-0 astro-3ef6ksr2"> <h2 id="header-search-title" class="sr-only astro-3ef6ksr2"> Search the API docs </h2> <div class="relative flex min-h-0 flex-1 flex-col astro-3ef6ksr2"> <button type="button" data-header-search-close aria-label="Close search" class="absolute right-5 top-7 z-20 inline-flex h-8 w-8 shrink-0 appearance-none items-center justify-center rounded-md border-0 bg-transparent p-0 leading-none text-tertiary shadow-none transition-colors hover:text-default focus-visible:outline-none focus-visible:ring-0 md:right-7 astro-3ef6ksr2"> <svg xmlns="http://www.w3.org/2000/svg" width="24" height="24" viewBox="0 0 24 24" fill="none" stroke="currentColor" stroke-width="2" stroke-linecap="round" stroke-linejoin="round" class="h-[18px] w-[18px] shrink-0 astro-3ef6ksr2 " ><path d="M18 6 6 18"></path><path d="m6 6 12 12"></path></svg> </button> <style>astro-island,astro-slot,astro-static-slot{display:contents}</style><script>(()=>{var e=async t=>{await(await t())()};(self.Astro||(self.Astro={})).load=e;window.dispatchEvent(new Event("astro:load"));})();</script><script>(()=>{var A=Object.defineProperty;var g=(i,o,a)=>o in i?A(i,o,{enumerable:!0,configurable:!0,writable:!0,value:a}):i[o]=a;var d=(i,o,a)=>g(i,typeof o!="symbol"?o+"":o,a);{let i={0:t=>m(t),1:t=>a(t),2:t=>new RegExp(t),3:t=>new Date(t),4:t=>new Map(a(t)),5:t=>new Set(a(t)),6:t=>BigInt(t),7:t=>new URL(t),8:t=>new Uint8Array(t),9:t=>new Uint16Array(t),10:t=>new Uint32Array(t),11:t=>Number.POSITIVE_INFINITY*t},o=t=>{let[l,e]=t;return l in i?i[l](e):void 0},a=t=>t.map(o),m=t=>typeof t!="object"||t===null?t:Object.fromEntries(Object.entries(t).map(([l,e])=>[l,o(e)]));class y extends HTMLElement{constructor(){super(...arguments);d(this,"Component");d(this,"hydrator");d(this,"hydrate",async()=>{var b;if(!this.hydrator||!this.isConnected)return;let e=(b=this.parentElement)==null?void 0:b.closest("astro-island[ssr]");if(e){e.addEventListener("astro:hydrate",this.hydrate,{once:!0});return}let c=this.querySelectorAll("astro-slot"),n={},h=this.querySelectorAll("template[data-astro-template]");for(let r of h){let s=r.closest(this.tagName);s!=null&&s.isSameNode(this)&&(n[r.getAttribute("data-astro-template")||"default"]=r.innerHTML,r.remove())}for(let r of c){let s=r.closest(this.tagName);s!=null&&s.isSameNode(this)&&(n[r.getAttribute("name")||"default"]=r.innerHTML)}let p;try{p=this.hasAttribute("props")?m(JSON.parse(this.getAttribute("props"))):{}}catch(r){let s=this.getAttribute("component-url")||"<unknown>",v=this.getAttribute("component-export");throw v&&(s+=` (export ${v})`),console.error(`[hydrate] Error parsing props for component ${s}`,this.getAttribute("props"),r),r}let u;await this.hydrator(this)(this.Component,p,n,{client:this.getAttribute("client")}),this.removeAttribute("ssr"),this.dispatchEvent(new CustomEvent("astro:hydrate"))});d(this,"unmount",()=>{this.isConnected||this.dispatchEvent(new CustomEvent("astro:unmount"))})}disconnectedCallback(){document.removeEventListener("astro:after-swap",this.unmount),document.addEventListener("astro:after-swap",this.unmount,{once:!0})}connectedCallback(){if(!this.hasAttribute("await-children")||document.readyState==="interactive"||document.readyState==="complete")this.childrenConnectedCallback();else{let e=()=>{document.removeEventListener("DOMContentLoaded",e),c.disconnect(),this.childrenConnectedCallback()},c=new MutationObserver(()=>{var n;((n=this.lastChild)==null?void 0:n.nodeType)===Node.COMMENT_NODE&&this.lastChild.nodeValue==="astro:end"&&(this.lastChild.remove(),e())});c.observe(this,{childList:!0}),document.addEventListener("DOMContentLoaded",e)}}async childrenConnectedCallback(){let e=this.getAttribute("before-hydration-url");e&&await import(e),this.start()}async start(){let e=JSON.parse(this.getAttribute("opts")),c=this.getAttribute("client");if(Astro[c]===void 0){window.addEventListener(`astro:${c}`,()=>this.start(),{once:!0});return}try{await Astro[c](async()=>{let n=this.getAttribute("renderer-url"),[h,{default:p}]=await Promise.all([import(this.getAttribute("component-url")),n?import(n):()=>()=>{}]),u=this.getAttribute("component-export")||"default";if(!u.includes("."))this.Component=h[u];else{this.Component=h;for(let f of u.split("."))this.Component=this.Component[f]}return this.hydrator=p,this.hydrate},e,this)}catch(n){console.error(`[astro-island] Error hydrating ${this.getAttribute("component-url")}`,n)}}attributeChangedCallback(){this.hydrate()}}d(y,"observedAttributes",["props"]),customElements.get("astro-island")||customElements.define("astro-island",y)}})();</script><astro-island uid="11cB0u" prefix="r38" component-url="/_astro/AlgoliaSearch.react.DPByk_tV.js" component-export="default" renderer-url="/_astro/client.C28dYYSg.js" props="{&quot;id&quot;:[0,&quot;header-site-search&quot;],&quot;className&quot;:[0,&quot;pagefind-header-ui pagefind-desktop-ui oai-site-search-overlay astro-3ef6ksr2&quot;],&quot;query&quot;:[0,&quot;&quot;],&quot;scope&quot;:[0,&quot;api&quot;],&quot;uiOptions&quot;:[0,{&quot;showImages&quot;:[0,false],&quot;showSubResults&quot;:[0,false],&quot;translations&quot;:[0,{&quot;placeholder&quot;:[0,&quot;Start searching&quot;],&quot;zeroResults&quot;:[0,&quot;No matches yet. Try a different keyword.&quot;]}]}]}" ssr client="load" opts="{&quot;name&quot;:&quot;AlgoliaSearchReact&quot;,&quot;value&quot;:true}" await-children><div id="header-site-search" class="pagefind-header-ui pagefind-desktop-ui oai-site-search-overlay astro-3ef6ksr2 _root_1wztd_1" data-site-search-root="true" data-site-search-provider="algolia" data-site-search-variant="overlay" data-query="" data-scope="api"><div class="flex h-full min-h-0 flex-col gap-0"><div class="shrink-0 border-b border-primary-surface px-4 py-4 md:px-6 md:py-5"><label class="sr-only" for="header-site-search-input">Search docs</label><input id="header-site-search-input" type="text" placeholder="Start searching" autoComplete="off" spellCheck="false" data-site-search-input="true" class="w-full outline-none transition-colors rounded-none border-0 bg-transparent py-0 pl-0 pr-14 text-[18px] leading-tight text-default placeholder:text-tertiary focus:ring-0 md:text-[18px]" value=""/></div><div class="flex min-h-0 flex-1 flex-col gap-4 px-4 py-4 md:px-6 md:py-5"><div data-site-search-empty-state="true" class="flex flex-col gap-4"><section class="_emptySection_1wztd_68" data-site-search-suggestions="true"><h3 class="_emptyHeading_1wztd_74">Suggested</h3><div class="flex flex-wrap gap-2"><button type="button" class="_emptyChip_1wztd_81" data-search-query-button="true" data-search-query="responses create">responses create</button><button type="button" class="_emptyChip_1wztd_81" data-search-query-button="true" data-search-query="reasoning_effort">reasoning_effort</button><button type="button" class="_emptyChip_1wztd_81" data-search-query-button="true" data-search-query="realtime">realtime</button><button type="button" class="_emptyChip_1wztd_81" data-search-query-button="true" data-search-query="prompt caching">prompt caching</button></div></section></div></div></div></div><!--astro:end--></astro-island> </div> </div> </div> </div> <div id="drawer" data-default-tab-id="mobile-nav-tab-1" data-default-search-placeholder="Start searching" data-default-search-scope="api" class="fixed inset-0 z-40 flex flex-col bg-surface transform translate-x-full transition-transform duration-300 lg:hidden astro-3ef6ksr2"> <div class="flex flex-col h-full w-full astro-3ef6ksr2"> <div class="px-6 pt-6 w-full mt-16 astro-3ef6ksr2"> <span id="mobile-nav-primary-label" class="sr-only astro-3ef6ksr2">Primary navigation</span> <div class="flex items-center gap-2 astro-3ef6ksr2"> <nav class="min-w-0 flex-1 flex items-center gap-2 overflow-x-auto pb-2 -mx-1 px-1 astro-3ef6ksr2" role="tablist" aria-labelledby="mobile-nav-primary-label"> <button type="button" role="tab" data-mobile-nav-tab data-tab-id="mobile-nav-tab-1" data-has-nav="true" data-href="/api/docs" data-label="API" data-search-placeholder="Start searching" data-search-scope="api" data-is-active="true" data-selected="true" aria-selected="true" class="shrink-0 rounded-full border border-primary-surface px-3.5 py-1.5 text-sm text-secondary transition-colors duration-150 data-[selected=true]:bg-primary-soft data-[selected=true]:text-default hover:bg-primary-soft-alpha hover:text-default focus-visible:outline focus-visible:outline-2 focus-visible:outline-offset-2 focus-visible:outline-primary-surface astro-3ef6ksr2" data-site-visibility-exclude="chatgpt-docs"> API </button><button type="button" role="tab" data-mobile-nav-tab data-tab-id="mobile-nav-tab-2" data-has-nav="true" data-href="https://learn.chatgpt.com/docs" data-label="Codex" data-search-placeholder="Start searching" data-search-scope data-is-active="false" data-selected="false" aria-selected="false" class="shrink-0 rounded-full border border-primary-surface px-3.5 py-1.5 text-sm text-secondary transition-colors duration-150 data-[selected=true]:bg-primary-soft data-[selected=true]:text-default hover:bg-primary-soft-alpha hover:text-default focus-visible:outline focus-visible:outline-2 focus-visible:outline-offset-2 focus-visible:outline-primary-surface astro-3ef6ksr2" data-site-visibility-exclude="chatgpt-docs"> Codex </button><button type="button" role="tab" data-mobile-nav-tab data-tab-id="mobile-nav-tab-6" data-has-nav="true" data-href="/chatgpt" data-label="ChatGPT" data-search-placeholder="Start searching" data-search-scope="chatgpt" data-is-active="false" data-selected="false" aria-selected="false" class="shrink-0 rounded-full border border-primary-surface px-3.5 py-1.5 text-sm text-secondary transition-colors duration-150 data-[selected=true]:bg-primary-soft data-[selected=true]:text-default hover:bg-primary-soft-alpha hover:text-default focus-visible:outline focus-visible:outline-2 focus-visible:outline-offset-2 focus-visible:outline-primary-surface astro-3ef6ksr2" data-site-visibility-exclude="chatgpt-docs"> ChatGPT </button><button type="button" role="tab" data-mobile-nav-tab data-tab-id="mobile-nav-tab-3" data-has-nav="false" data-href="/codex" data-label="Docs" data-search-placeholder="Start searching" data-search-scope="codex" data-is-active="false" data-selected="false" aria-selected="false" class="shrink-0 rounded-full border border-primary-surface px-3.5 py-1.5 text-sm text-secondary transition-colors duration-150 data-[selected=true]:bg-primary-soft data-[selected=true]:text-default hover:bg-primary-soft-alpha hover:text-default focus-visible:outline focus-visible:outline-2 focus-visible:outline-offset-2 focus-visible:outline-primary-surface astro-3ef6ksr2" data-site-visibility-include="chatgpt-docs"> Docs </button><button type="button" role="tab" data-mobile-nav-tab data-tab-id="mobile-nav-tab-4" data-has-nav="false" data-href="/codex/use-cases" data-label="Use cases" data-search-placeholder="Start searching" data-search-scope="codex" data-is-active="false" data-selected="false" aria-selected="false" class="shrink-0 rounded-full border border-primary-surface px-3.5 py-1.5 text-sm text-secondary transition-colors duration-150 data-[selected=true]:bg-primary-soft data-[selected=true]:text-default hover:bg-primary-soft-alpha hover:text-default focus-visible:outline focus-visible:outline-2 focus-visible:outline-offset-2 focus-visible:outline-primary-surface astro-3ef6ksr2" data-site-visibility-include="chatgpt-docs"> Use cases </button><button type="button" role="tab" data-mobile-nav-tab data-tab-id="mobile-nav-tab-5" data-has-nav="false" data-href="/codex/resources" data-label="Resources" data-search-placeholder="Start searching" data-search-scope="codex" data-is-active="false" data-selected="false" aria-selected="false" class="shrink-0 rounded-full border border-primary-surface px-3.5 py-1.5 text-sm text-secondary transition-colors duration-150 data-[selected=true]:bg-primary-soft data-[selected=true]:text-default hover:bg-primary-soft-alpha hover:text-default focus-visible:outline focus-visible:outline-2 focus-visible:outline-offset-2 focus-visible:outline-primary-surface astro-3ef6ksr2" data-site-visibility-include="chatgpt-docs"> Resources </button><button type="button" role="tab" data-mobile-nav-tab data-tab-id="mobile-nav-tab-7" data-has-nav="true" data-href="/learn" data-label="Resources" data-search-placeholder="Start searching" data-search-scope="learn" data-is-active="false" data-selected="false" aria-selected="false" class="shrink-0 rounded-full border border-primary-surface px-3.5 py-1.5 text-sm text-secondary transition-colors duration-150 data-[selected=true]:bg-primary-soft data-[selected=true]:text-default hover:bg-primary-soft-alpha hover:text-default focus-visible:outline focus-visible:outline-2 focus-visible:outline-offset-2 focus-visible:outline-primary-surface astro-3ef6ksr2" data-site-visibility-exclude="chatgpt-docs"> Resources </button> </nav> <button id="drawer-theme-button" type="button" aria-label="Toggle light and dark theme" class="shrink-0 mb-2 rounded-full border border-primary-surface p-2 text-secondary transition-colors hover:text-default astro-3ef6ksr2"> <svg width="22" height="22" viewBox="0 0 22 22" fill="none" xmlns="http://www.w3.org/2000/svg" class="block dark:hidden w-5 h-5 astro-3ef6ksr2 " ><path fill-rule="evenodd" clip-rule="evenodd" d="M11 0C11.5523 0 12 0.447715 12 1V3C12 3.55228 11.5523 4 11 4C10.4477 4 10 3.55228 10 3V1C10 0.447715 10.4477 0 11 0ZM3.22183 3.22183C3.61235 2.8313 4.24551 2.8313 4.63604 3.22183L6.05025 4.63604C6.44078 5.02656 6.44078 5.65973 6.05025 6.05025C5.65973 6.44078 5.02656 6.44078 4.63604 6.05025L3.22183 4.63604C2.8313 4.24551 2.8313 3.61235 3.22183 3.22183ZM18.7782 3.22183C19.1687 3.61235 19.1687 4.24551 18.7782 4.63604L17.364 6.05025C16.9734 6.44078 16.3403 6.44078 15.9497 6.05025C15.5592 5.65973 15.5592 5.02656 15.9497 4.63604L17.364 3.22183C17.7545 2.8313 18.3876 2.8313 18.7782 3.22183ZM11 8C9.34315 8 8 9.34315 8 11C8 12.6569 9.34315 14 11 14C12.6569 14 14 12.6569 14 11C14 9.34315 12.6569 8 11 8ZM6 11C6 8.23858 8.23858 6 11 6C13.7614 6 16 8.23858 16 11C16 13.7614 13.7614 16 11 16C8.23858 16 6 13.7614 6 11ZM0 11C0 10.4477 0.447715 10 1 10H3C3.55228 10 4 10.4477 4 11C4 11.5523 3.55228 12 3 12H1C0.447715 12 0 11.5523 0 11ZM18 11C18 10.4477 18.4477 10 19 10H21C21.5523 10 22 10.4477 22 11C22 11.5523 21.5523 12 21 12H19C18.4477 12 18 11.5523 18 11ZM6.05025 15.9497C6.44078 16.3403 6.44078 16.9734 6.05025 17.364L4.63604 18.7782C4.24551 19.1687 3.61235 19.1687 3.22183 18.7782C2.8313 18.3876 2.8313 17.7545 3.22183 17.364L4.63604 15.9497C5.02656 15.5592 5.65973 15.5592 6.05025 15.9497ZM15.9497 15.9497C16.3403 15.5592 16.9734 15.5592 17.364 15.9497L18.7782 17.364C19.1687 17.7545 19.1687 18.3876 18.7782 18.7782C18.3877 19.1687 17.7545 19.1687 17.364 18.7782L15.9497 17.364C15.5592 16.9734 15.5592 16.3403 15.9497 15.9497ZM11 18C11.5523 18 12 18.4477 12 19V21C12 21.5523 11.5523 22 11 22C10.4477 22 10 21.5523 10 21V19C10 18.4477 10.4477 18 11 18Z" fill="currentColor"></path></svg> <svg width="20" height="20" viewBox="0 0 20 20" fill="none" xmlns="http://www.w3.org/2000/svg" class="hidden dark:block w-5 h-5 astro-3ef6ksr2 " ><path d="M10.7836 0.470481C10.9676 0.765118 10.9855 1.13415 10.8309 1.44525C10.2994 2.51497 10 3.7211 10 5.00001C10 9.41829 13.5817 13 18 13L18.0575 12.9998C18.4049 12.9974 18.7287 13.1754 18.9127 13.47C19.0968 13.7647 19.1147 14.1337 18.9601 14.4448C17.325 17.7352 13.9279 20 10 20C4.47715 20 0 15.5229 0 10C0 4.50107 4.43841 0.038857 9.92838 0.000268937C10.2758 -0.00217271 10.5995 0.175844 10.7836 0.470481ZM8.40989 2.15803C4.75344 2.8954 2 6.12619 2 10C2 14.4183 5.58172 18 10 18C12.587 18 14.8886 16.7721 16.3516 14.8648C11.6131 14.0789 8 9.96139 8 5.00001C8 4.01361 8.1431 3.05953 8.40989 2.15803Z" fill="currentColor"></path></svg> </button> </div> </div> <div class="flex-1 w-full overflow-y-auto px-6 py-4 flex flex-col gap-6 astro-3ef6ksr2" data-mobile-nav-panels> <div data-mobile-search class="astro-3ef6ksr2"> <astro-island uid="2cRGvw" prefix="r39" component-url="/_astro/AlgoliaSearch.react.DPByk_tV.js" component-export="default" renderer-url="/_astro/client.C28dYYSg.js" props="{&quot;id&quot;:[0,&quot;header-mobile-search&quot;],&quot;className&quot;:[0,&quot;pagefind-header-ui pagefind-mobile-ui astro-3ef6ksr2&quot;],&quot;query&quot;:[0,&quot;&quot;],&quot;scope&quot;:[0,&quot;api&quot;],&quot;uiOptions&quot;:[0,{&quot;showImages&quot;:[0,false],&quot;showSubResults&quot;:[0,false],&quot;translations&quot;:[0,{&quot;placeholder&quot;:[0,&quot;Start searching&quot;],&quot;zeroResults&quot;:[0,&quot;No matches yet. Try a different keyword.&quot;]}]}]}" ssr client="load" opts="{&quot;name&quot;:&quot;AlgoliaSearchReact&quot;,&quot;value&quot;:true}" await-children><div id="header-mobile-search" class="pagefind-header-ui pagefind-mobile-ui astro-3ef6ksr2 _root_1wztd_1" data-site-search-root="true" data-site-search-provider="algolia" data-site-search-variant="default" data-query="" data-scope="api"><div class="flex h-full min-h-0 flex-col gap-4"><div class=""><label class="sr-only" for="header-mobile-search-input">Search docs</label><input id="header-mobile-search-input" type="text" placeholder="Start searching" autoComplete="off" spellCheck="false" data-site-search-input="true" class="w-full outline-none transition-colors rounded-[18px] border border-transparent bg-primary-soft-alpha py-4 pl-6 pr-14 text-[18px] leading-tight text-default placeholder:text-tertiary focus:border-transparent focus:ring-0" value=""/></div><div class="flex min-h-0 flex-1 flex-col gap-4"><div data-site-search-empty-state="true" class="flex flex-col gap-4"><section class="_emptySection_1wztd_68" data-site-search-suggestions="true"><h3 class="_emptyHeading_1wztd_74">Suggested</h3><div class="flex flex-wrap gap-2"><button type="button" class="_emptyChip_1wztd_81" data-search-query-button="true" data-search-query="responses create">responses create</button><button type="button" class="_emptyChip_1wztd_81" data-search-query-button="true" data-search-query="reasoning_effort">reasoning_effort</button><button type="button" class="_emptyChip_1wztd_81" data-search-query-button="true" data-search-query="realtime">realtime</button><button type="button" class="_emptyChip_1wztd_81" data-search-query-button="true" data-search-query="prompt caching">prompt caching</button></div></section></div></div></div></div><!--astro:end--></astro-island> </div> <div id="mobile-nav-panel-1" data-mobile-nav-content data-tab-id="mobile-nav-tab-1" data-href="/api/docs" data-default-variant-id="mobile-nav-tab-1-variant-6" class="flex flex-col gap-4 pb-8 astro-3ef6ksr2">  <div class="group flex flex-col gap-1 astro-3ef6ksr2" data-mobile-context-options data-context-active="false" data-site-visibility-exclude="chatgpt-docs"> <a href="/api/docs" class="w-full rounded-lg px-3 py-2 text-left text-sm font-normal text-secondary transition-colors hover:bg-primary-ghost-hover hover:text-default astro-3ef6ksr2" data-mobile-nav-link> Overview </a><a href="/api/docs/models" class="w-full rounded-lg px-3 py-2 text-left text-sm font-normal text-secondary transition-colors hover:bg-primary-ghost-hover hover:text-default astro-3ef6ksr2" data-mobile-nav-link> Models </a><a href="/api/docs/guides/agents" class="w-full rounded-lg px-3 py-2 text-left text-sm font-normal text-secondary transition-colors hover:bg-primary-ghost-hover hover:text-default astro-3ef6ksr2" data-mobile-nav-link> Agents </a><a href="/api/docs/guides/tools" class="w-full rounded-lg px-3 py-2 text-left text-sm font-normal text-secondary transition-colors hover:bg-primary-ghost-hover hover:text-default astro-3ef6ksr2" data-mobile-nav-link> Tools </a><a href="/api/docs/guides/realtime" class="w-full rounded-lg px-3 py-2 text-left text-sm font-normal text-secondary transition-colors hover:bg-primary-ghost-hover hover:text-default astro-3ef6ksr2" data-mobile-nav-link> Voice &amp; Audio </a><a href="/api/docs/guides/production-best-practices" class="w-full rounded-lg px-3 py-2 text-left text-sm font-normal text-secondary transition-colors hover:bg-primary-ghost-hover hover:text-default astro-3ef6ksr2" data-mobile-nav-link> Production </a><a href="/api/reference/overview" class="w-full rounded-lg px-3 py-2 text-left text-sm font-normal text-secondary transition-colors hover:bg-primary-ghost-hover hover:text-default astro-3ef6ksr2" data-mobile-nav-link> API reference </a> </div> <div id="mobile-nav-tab-1-context-select" data-mobile-context-select data-value="mobile-nav-tab-1-variant-6" data-site-visibility-include="chatgpt-docs" class="astro-3ef6ksr2"> <astro-island uid="ZEnRLw" prefix="r32" component-url="/_astro/MobileContextDropdown.react.CEsomyJv.js" component-export="default" renderer-url="/_astro/client.C28dYYSg.js" props="{&quot;rootId&quot;:[0,&quot;mobile-nav-tab-1-context-select&quot;],&quot;initialValue&quot;:[0,&quot;mobile-nav-tab-1-variant-6&quot;],&quot;options&quot;:[1,[[0,{&quot;value&quot;:[0,&quot;mobile-nav-tab-1-variant-0&quot;],&quot;label&quot;:[0,&quot;Overview&quot;]}],[0,{&quot;value&quot;:[0,&quot;mobile-nav-tab-1-variant-1&quot;],&quot;label&quot;:[0,&quot;Models&quot;]}],[0,{&quot;value&quot;:[0,&quot;mobile-nav-tab-1-variant-2&quot;],&quot;label&quot;:[0,&quot;Agents&quot;]}],[0,{&quot;value&quot;:[0,&quot;mobile-nav-tab-1-variant-3&quot;],&quot;label&quot;:[0,&quot;Tools&quot;]}],[0,{&quot;value&quot;:[0,&quot;mobile-nav-tab-1-variant-4&quot;],&quot;label&quot;:[0,&quot;Voice &amp; Audio&quot;]}],[0,{&quot;value&quot;:[0,&quot;mobile-nav-tab-1-variant-5&quot;],&quot;label&quot;:[0,&quot;Production&quot;]}],[0,{&quot;value&quot;:[0,&quot;mobile-nav-tab-1-variant-6&quot;],&quot;label&quot;:[0,&quot;API reference&quot;]}]]]}" ssr client="load" opts="{&quot;name&quot;:&quot;MobileContextDropdown&quot;,&quot;value&quot;:true}" await-children><div class="flex min-w-0"><div class="relative max-w-full w-full"><select aria-label="Docs section" class="_NativeSelect_10bwq_299" data-native-selectcontrol=""><option value="mobile-nav-tab-1-variant-0">Overview</option><option value="mobile-nav-tab-1-variant-1">Models</option><option value="mobile-nav-tab-1-variant-2">Agents</option><option value="mobile-nav-tab-1-variant-3">Tools</option><option value="mobile-nav-tab-1-variant-4">Voice &amp; Audio</option><option value="mobile-nav-tab-1-variant-5">Production</option><option value="mobile-nav-tab-1-variant-6" selected="">API reference</option></select><span class="_SelectControl_x887o_1" role="button" tabindex="-1" data-variant="outline" data-block="" data-size="3xl" data-selected="true" aria-disabled="false" id="select-trigger-_r32R_0_" aria-labelledby="_r32R_5H1_ _r32R_5_" aria-hidden="true"><span class="_TriggerText_x887o_510"><span id="_r32R_5H1_" class="sr-only w-full h-0 left-0 bottom-0 pointer-events-none">Docs section</span><span id="_r32R_5_">API reference</span></span><div class="_IndicatorWrapper_x887o_520"><svg width="1em" height="1em" viewBox="0 0 16 9" fill="currentColor" class="_DropdownIcon_x887o_475 _DropdownIconChevron_x887o_586"><path fill-rule="evenodd" clip-rule="evenodd" d="M0.292893 0.292893C0.683418 -0.0976311 1.31658 -0.0976311 1.70711 0.292893L8 6.58579L14.2929 0.292894C14.6834 -0.0976305 15.3166 -0.0976304 15.7071 0.292894C16.0976 0.683418 16.0976 1.31658 15.7071 1.70711L8.70711 8.70711C8.31658 9.09763 7.68342 9.09763 7.29289 8.70711L0.292893 1.70711C-0.0976311 1.31658 -0.0976311 0.683417 0.292893 0.292893Z"></path></svg></div></span></div></div><!--astro:end--></astro-island> </div>  <div data-mobile-nav-variant-content data-variant-id="mobile-nav-tab-1-variant-0" hidden class="flex flex-col gap-6 astro-3ef6ksr2">  </div><div data-mobile-nav-variant-content data-variant-id="mobile-nav-tab-1-variant-1" hidden class="flex flex-col gap-6 astro-3ef6ksr2">  </div><div data-mobile-nav-variant-content data-variant-id="mobile-nav-tab-1-variant-2" hidden class="flex flex-col gap-6 astro-3ef6ksr2">  </div><div data-mobile-nav-variant-content data-variant-id="mobile-nav-tab-1-variant-3" hidden class="flex flex-col gap-6 astro-3ef6ksr2">  </div><div data-mobile-nav-variant-content data-variant-id="mobile-nav-tab-1-variant-4" hidden class="flex flex-col gap-6 astro-3ef6ksr2">  </div><div data-mobile-nav-variant-content data-variant-id="mobile-nav-tab-1-variant-5" hidden class="flex flex-col gap-6 astro-3ef6ksr2">  </div><div data-mobile-nav-variant-content data-variant-id="mobile-nav-tab-1-variant-6" class="flex flex-col gap-6 astro-3ef6ksr2">  </div> </div><div id="mobile-nav-panel-2" data-mobile-nav-content data-tab-id="mobile-nav-tab-2" data-href="https://learn.chatgpt.com/docs" data-default-variant-id="mobile-nav-tab-2-variant-0" hidden class="flex flex-col gap-4 pb-8 astro-3ef6ksr2">  <div class="group flex flex-col gap-1 astro-3ef6ksr2" data-mobile-context-options data-context-active="false" data-site-visibility-exclude="chatgpt-docs"> <a href="https://learn.chatgpt.com/docs" target="_blank" rel="noopener noreferrer" class="w-full rounded-lg px-3 py-2 text-left text-sm font-normal text-secondary transition-colors hover:bg-primary-ghost-hover hover:text-default astro-3ef6ksr2" data-mobile-nav-link> Docs </a><a href="https://learn.chatgpt.com/use-cases" target="_blank" rel="noopener noreferrer" class="w-full rounded-lg px-3 py-2 text-left text-sm font-normal text-secondary transition-colors hover:bg-primary-ghost-hover hover:text-default astro-3ef6ksr2" data-mobile-nav-link> Use cases </a> </div> <div id="mobile-nav-tab-2-context-select" data-mobile-context-select data-value="mobile-nav-tab-2-variant-0" data-site-visibility-include="chatgpt-docs" class="astro-3ef6ksr2"> <astro-island uid="26FV5w" prefix="r33" component-url="/_astro/MobileContextDropdown.react.CEsomyJv.js" component-export="default" renderer-url="/_astro/client.C28dYYSg.js" props="{&quot;rootId&quot;:[0,&quot;mobile-nav-tab-2-context-select&quot;],&quot;initialValue&quot;:[0,&quot;mobile-nav-tab-2-variant-0&quot;],&quot;options&quot;:[1,[[0,{&quot;value&quot;:[0,&quot;mobile-nav-tab-2-variant-0&quot;],&quot;label&quot;:[0,&quot;Docs&quot;]}],[0,{&quot;value&quot;:[0,&quot;mobile-nav-tab-2-variant-1&quot;],&quot;label&quot;:[0,&quot;Use cases&quot;]}]]]}" ssr client="load" opts="{&quot;name&quot;:&quot;MobileContextDropdown&quot;,&quot;value&quot;:true}" await-children><div class="flex min-w-0"><div class="relative max-w-full w-full"><select aria-label="Docs section" class="_NativeSelect_10bwq_299" data-native-selectcontrol=""><option value="mobile-nav-tab-2-variant-0" selected="">Docs</option><option value="mobile-nav-tab-2-variant-1">Use cases</option></select><span class="_SelectControl_x887o_1" role="button" tabindex="-1" data-variant="outline" data-block="" data-size="3xl" data-selected="true" aria-disabled="false" id="select-trigger-_r33R_0_" aria-labelledby="_r33R_5H1_ _r33R_5_" aria-hidden="true"><span class="_TriggerText_x887o_510"><span id="_r33R_5H1_" class="sr-only w-full h-0 left-0 bottom-0 pointer-events-none">Docs section</span><span id="_r33R_5_">Docs</span></span><div class="_IndicatorWrapper_x887o_520"><svg width="1em" height="1em" viewBox="0 0 16 9" fill="currentColor" class="_DropdownIcon_x887o_475 _DropdownIconChevron_x887o_586"><path fill-rule="evenodd" clip-rule="evenodd" d="M0.292893 0.292893C0.683418 -0.0976311 1.31658 -0.0976311 1.70711 0.292893L8 6.58579L14.2929 0.292894C14.6834 -0.0976305 15.3166 -0.0976304 15.7071 0.292894C16.0976 0.683418 16.0976 1.31658 15.7071 1.70711L8.70711 8.70711C8.31658 9.09763 7.68342 9.09763 7.29289 8.70711L0.292893 1.70711C-0.0976311 1.31658 -0.0976311 0.683417 0.292893 0.292893Z"></path></svg></div></span></div></div><!--astro:end--></astro-island> </div>  <div data-mobile-nav-variant-content data-variant-id="mobile-nav-tab-2-variant-0" class="flex flex-col gap-6 astro-3ef6ksr2">  </div><div data-mobile-nav-variant-content data-variant-id="mobile-nav-tab-2-variant-1" hidden class="flex flex-col gap-6 astro-3ef6ksr2">  </div> </div><div id="mobile-nav-panel-6" data-mobile-nav-content data-tab-id="mobile-nav-tab-6" data-href="/chatgpt" data-default-variant-id="mobile-nav-tab-6-variant-0" hidden class="flex flex-col gap-4 pb-8 astro-3ef6ksr2">  <div class="group flex flex-col gap-1 astro-3ef6ksr2" data-mobile-context-options data-context-active="false" data-site-visibility-exclude="chatgpt-docs"> <a href="/plugins" class="w-full rounded-lg px-3 py-2 text-left text-sm font-normal text-secondary transition-colors hover:bg-primary-ghost-hover hover:text-default astro-3ef6ksr2" data-mobile-nav-link> Plugins </a><a href="/workspace-agents" class="w-full rounded-lg px-3 py-2 text-left text-sm font-normal text-secondary transition-colors hover:bg-primary-ghost-hover hover:text-default astro-3ef6ksr2" data-mobile-nav-link> Workspace Agents </a><a href="/commerce" class="w-full rounded-lg px-3 py-2 text-left text-sm font-normal text-secondary transition-colors hover:bg-primary-ghost-hover hover:text-default astro-3ef6ksr2" data-mobile-nav-link> Commerce </a><a href="/ads" class="w-full rounded-lg px-3 py-2 text-left text-sm font-normal text-secondary transition-colors hover:bg-primary-ghost-hover hover:text-default astro-3ef6ksr2" data-mobile-nav-link> Ads </a> </div> <div id="mobile-nav-tab-6-context-select" data-mobile-context-select data-value="mobile-nav-tab-6-variant-0" data-site-visibility-include="chatgpt-docs" class="astro-3ef6ksr2"> <astro-island uid="ZE0fSc" prefix="r34" component-url="/_astro/MobileContextDropdown.react.CEsomyJv.js" component-export="default" renderer-url="/_astro/client.C28dYYSg.js" props="{&quot;rootId&quot;:[0,&quot;mobile-nav-tab-6-context-select&quot;],&quot;initialValue&quot;:[0,&quot;mobile-nav-tab-6-variant-0&quot;],&quot;options&quot;:[1,[[0,{&quot;value&quot;:[0,&quot;mobile-nav-tab-6-variant-1&quot;],&quot;label&quot;:[0,&quot;Plugins&quot;]}],[0,{&quot;value&quot;:[0,&quot;mobile-nav-tab-6-variant-2&quot;],&quot;label&quot;:[0,&quot;Workspace Agents&quot;]}],[0,{&quot;value&quot;:[0,&quot;mobile-nav-tab-6-variant-3&quot;],&quot;label&quot;:[0,&quot;Commerce&quot;]}],[0,{&quot;value&quot;:[0,&quot;mobile-nav-tab-6-variant-4&quot;],&quot;label&quot;:[0,&quot;Ads&quot;]}]]]}" ssr client="load" opts="{&quot;name&quot;:&quot;MobileContextDropdown&quot;,&quot;value&quot;:true}" await-children><div class="flex min-w-0"><div class="relative max-w-full w-full"><select aria-label="Docs section" class="_NativeSelect_10bwq_299" data-native-selectcontrol=""><option value="mobile-nav-tab-6-variant-1">Plugins</option><option value="mobile-nav-tab-6-variant-2">Workspace Agents</option><option value="mobile-nav-tab-6-variant-3">Commerce</option><option value="mobile-nav-tab-6-variant-4">Ads</option></select><span class="_SelectControl_x887o_1" role="button" tabindex="-1" data-variant="outline" data-block="" data-size="3xl" data-selected="true" aria-disabled="false" id="select-trigger-_r34R_0_" aria-labelledby="_r34R_5H1_ _r34R_5_" aria-hidden="true"><span class="_TriggerText_x887o_510"><span id="_r34R_5H1_" class="sr-only w-full h-0 left-0 bottom-0 pointer-events-none">Docs section</span><span id="_r34R_5_">Select...</span></span><div class="_IndicatorWrapper_x887o_520"><svg width="1em" height="1em" viewBox="0 0 16 9" fill="currentColor" class="_DropdownIcon_x887o_475 _DropdownIconChevron_x887o_586"><path fill-rule="evenodd" clip-rule="evenodd" d="M0.292893 0.292893C0.683418 -0.0976311 1.31658 -0.0976311 1.70711 0.292893L8 6.58579L14.2929 0.292894C14.6834 -0.0976305 15.3166 -0.0976304 15.7071 0.292894C16.0976 0.683418 16.0976 1.31658 15.7071 1.70711L8.70711 8.70711C8.31658 9.09763 7.68342 9.09763 7.29289 8.70711L0.292893 1.70711C-0.0976311 1.31658 -0.0976311 0.683417 0.292893 0.292893Z"></path></svg></div></span></div></div><!--astro:end--></astro-island> </div>  <div data-mobile-nav-variant-content data-variant-id="mobile-nav-tab-6-variant-0" class="flex flex-col gap-6 astro-3ef6ksr2">  </div><div data-mobile-nav-variant-content data-variant-id="mobile-nav-tab-6-variant-1" hidden class="flex flex-col gap-6 astro-3ef6ksr2">  </div><div data-mobile-nav-variant-content data-variant-id="mobile-nav-tab-6-variant-2" hidden class="flex flex-col gap-6 astro-3ef6ksr2">  </div><div data-mobile-nav-variant-content data-variant-id="mobile-nav-tab-6-variant-3" hidden class="flex flex-col gap-6 astro-3ef6ksr2">  </div><div data-mobile-nav-variant-content data-variant-id="mobile-nav-tab-6-variant-4" hidden class="flex flex-col gap-6 astro-3ef6ksr2">  </div> </div><div id="mobile-nav-panel-7" data-mobile-nav-content data-tab-id="mobile-nav-tab-7" data-href="/learn" data-default-variant-id="mobile-nav-tab-7-variant-0" hidden class="flex flex-col gap-4 pb-8 astro-3ef6ksr2">  <div class="group flex flex-col gap-1 astro-3ef6ksr2" data-mobile-context-options data-context-active="false" data-site-visibility-exclude="chatgpt-docs"> <a href="/showcase" class="w-full rounded-lg px-3 py-2 text-left text-sm font-normal text-secondary transition-colors hover:bg-primary-ghost-hover hover:text-default astro-3ef6ksr2" data-mobile-nav-link> Showcase </a><a href="/blog" class="w-full rounded-lg px-3 py-2 text-left text-sm font-normal text-secondary transition-colors hover:bg-primary-ghost-hover hover:text-default astro-3ef6ksr2" data-mobile-nav-link> Blog </a><a href="/cookbook" class="w-full rounded-lg px-3 py-2 text-left text-sm font-normal text-secondary transition-colors hover:bg-primary-ghost-hover hover:text-default astro-3ef6ksr2" data-mobile-nav-link> Cookbook </a><a href="/learn" class="w-full rounded-lg px-3 py-2 text-left text-sm font-normal text-secondary transition-colors hover:bg-primary-ghost-hover hover:text-default astro-3ef6ksr2" data-mobile-nav-link> Learn </a><a href="/community" class="w-full rounded-lg px-3 py-2 text-left text-sm font-normal text-secondary transition-colors hover:bg-primary-ghost-hover hover:text-default astro-3ef6ksr2" data-mobile-nav-link> Community </a> </div> <div id="mobile-nav-tab-7-context-select" data-mobile-context-select data-value="mobile-nav-tab-7-variant-0" data-site-visibility-include="chatgpt-docs" class="astro-3ef6ksr2"> <astro-island uid="Z1DxwnA" prefix="r35" component-url="/_astro/MobileContextDropdown.react.CEsomyJv.js" component-export="default" renderer-url="/_astro/client.C28dYYSg.js" props="{&quot;rootId&quot;:[0,&quot;mobile-nav-tab-7-context-select&quot;],&quot;initialValue&quot;:[0,&quot;mobile-nav-tab-7-variant-0&quot;],&quot;options&quot;:[1,[[0,{&quot;value&quot;:[0,&quot;mobile-nav-tab-7-variant-1&quot;],&quot;label&quot;:[0,&quot;Showcase&quot;]}],[0,{&quot;value&quot;:[0,&quot;mobile-nav-tab-7-variant-2&quot;],&quot;label&quot;:[0,&quot;Blog&quot;]}],[0,{&quot;value&quot;:[0,&quot;mobile-nav-tab-7-variant-3&quot;],&quot;label&quot;:[0,&quot;Cookbook&quot;]}],[0,{&quot;value&quot;:[0,&quot;mobile-nav-tab-7-variant-4&quot;],&quot;label&quot;:[0,&quot;Learn&quot;]}],[0,{&quot;value&quot;:[0,&quot;mobile-nav-tab-7-variant-5&quot;],&quot;label&quot;:[0,&quot;Community&quot;]}]]]}" ssr client="load" opts="{&quot;name&quot;:&quot;MobileContextDropdown&quot;,&quot;value&quot;:true}" await-children><div class="flex min-w-0"><div class="relative max-w-full w-full"><select aria-label="Docs section" class="_NativeSelect_10bwq_299" data-native-selectcontrol=""><option value="mobile-nav-tab-7-variant-1">Showcase</option><option value="mobile-nav-tab-7-variant-2">Blog</option><option value="mobile-nav-tab-7-variant-3">Cookbook</option><option value="mobile-nav-tab-7-variant-4">Learn</option><option value="mobile-nav-tab-7-variant-5">Community</option></select><span class="_SelectControl_x887o_1" role="button" tabindex="-1" data-variant="outline" data-block="" data-size="3xl" data-selected="true" aria-disabled="false" id="select-trigger-_r35R_0_" aria-labelledby="_r35R_5H1_ _r35R_5_" aria-hidden="true"><span class="_TriggerText_x887o_510"><span id="_r35R_5H1_" class="sr-only w-full h-0 left-0 bottom-0 pointer-events-none">Docs section</span><span id="_r35R_5_">Select...</span></span><div class="_IndicatorWrapper_x887o_520"><svg width="1em" height="1em" viewBox="0 0 16 9" fill="currentColor" class="_DropdownIcon_x887o_475 _DropdownIconChevron_x887o_586"><path fill-rule="evenodd" clip-rule="evenodd" d="M0.292893 0.292893C0.683418 -0.0976311 1.31658 -0.0976311 1.70711 0.292893L8 6.58579L14.2929 0.292894C14.6834 -0.0976305 15.3166 -0.0976304 15.7071 0.292894C16.0976 0.683418 16.0976 1.31658 15.7071 1.70711L8.70711 8.70711C8.31658 9.09763 7.68342 9.09763 7.29289 8.70711L0.292893 1.70711C-0.0976311 1.31658 -0.0976311 0.683417 0.292893 0.292893Z"></path></svg></div></span></div></div><!--astro:end--></astro-island> </div>  <div data-mobile-nav-variant-content data-variant-id="mobile-nav-tab-7-variant-0" class="flex flex-col gap-6 astro-3ef6ksr2">  </div><div data-mobile-nav-variant-content data-variant-id="mobile-nav-tab-7-variant-1" hidden class="flex flex-col gap-6 astro-3ef6ksr2">  </div><div data-mobile-nav-variant-content data-variant-id="mobile-nav-tab-7-variant-2" hidden class="flex flex-col gap-6 astro-3ef6ksr2">  </div><div data-mobile-nav-variant-content data-variant-id="mobile-nav-tab-7-variant-3" hidden class="flex flex-col gap-6 astro-3ef6ksr2">  </div><div data-mobile-nav-variant-content data-variant-id="mobile-nav-tab-7-variant-4" hidden class="flex flex-col gap-6 astro-3ef6ksr2">  </div><div data-mobile-nav-variant-content data-variant-id="mobile-nav-tab-7-variant-5" hidden class="flex flex-col gap-6 astro-3ef6ksr2">  </div> </div> </div> <div class="w-full px-6 py-6 border-t border-primary-surface astro-3ef6ksr2" data-mobile-nav-footer> <div class="flex flex-col gap-5 astro-3ef6ksr2"> <div data-site-visibility-exclude="chatgpt-docs" class="astro-3ef6ksr2"> <div class="flex items-center gap-2 w-full gap-3 astro-3ef6ksr2"><a target="_blank" rel="noopener noreferrer" href="https://platform.openai.com/login" class="_Button_6dmow_1 not-prose flex-1 justify-center" data-color="primary" data-variant="solid" data-pill="" data-size="md"><span class="_ButtonInner_6dmow_4"><span class="">API Dashboard</span><svg width="1em" height="1em" viewBox="0 0 24 24" fill="currentColor" data-external-link-indicator="persistent" class="shrink-0"><path fill-rule="evenodd" d="M16.243 6.757a1 1 0 0 1 1 1v7.072a1 1 0 0 1-2 0v-4.657L8.464 16.95a1 1 0 0 1-1.414-1.414l6.778-6.779H9.172a1 1 0 0 1 0-2h7.07Z" clip-rule="evenodd"></path></svg></span></a></div> </div><div data-site-visibility-include="chatgpt-docs" class="astro-3ef6ksr2"> <div class="flex items-center gap-2 w-full gap-3 astro-3ef6ksr2"><a target="_blank" rel="noopener noreferrer" href="https://chatgpt.com/" class="_Button_6dmow_1 not-prose flex-1 justify-center" data-color="primary" data-variant="solid" data-pill="" data-size="lg"><span class="_ButtonInner_6dmow_4"><span class="">Try ChatGPT</span><svg width="1em" height="1em" viewBox="0 0 24 24" fill="currentColor" data-external-link-indicator="persistent" class="shrink-0"><path fill-rule="evenodd" d="M16.243 6.757a1 1 0 0 1 1 1v7.072a1 1 0 0 1-2 0v-4.657L8.464 16.95a1 1 0 0 1-1.414-1.414l6.778-6.779H9.172a1 1 0 0 1 0-2h7.07Z" clip-rule="evenodd"></path></svg></span></a></div> </div> <div class="flex flex-wrap items-center gap-4 text-sm text-gray-700 dark:text-gray-300 astro-3ef6ksr2">  </div> </div> </div> </div> </div> <script>
  document.dispatchEvent(new CustomEvent("site-variant:apply"));
</script>  <script>
  const MOBILE_NAV_PERSIST_KEY = "mobile-nav:restore-open";

  const readPersistedMobileNavOpen = () => {
    try {
      return sessionStorage.getItem(MOBILE_NAV_PERSIST_KEY) === "true";
    } catch {
      return false;
    }
  };

  const setPersistedMobileNavOpen = (isOpen) => {
    try {
      if (isOpen) {
        sessionStorage.setItem(MOBILE_NAV_PERSIST_KEY, "true");
      } else {
        sessionStorage.removeItem(MOBILE_NAV_PERSIST_KEY);
      }
    } catch {}
  };

  function initializeMobileNavigation() {
    document.dispatchEvent(new CustomEvent("site-variant:apply"));

    const drawer = document.getElementById("drawer");
    const drawerButton = document.getElementById("header-drawer-button");

    if (
      !drawer ||
      !drawerButton ||
      drawer.dataset.mobileNavInitialized === "true"
    ) {
      return;
    }

    const navTabElements = Array.from(
      drawer.querySelectorAll("[data-mobile-nav-tab]")
    );
    const visibleNavTabElements = navTabElements.filter((tab) => !tab.hidden);
    const defaultSearchPlaceholder =
      drawer.dataset.defaultSearchPlaceholder || "Search the site";
    const defaultSearchScope = drawer.dataset.defaultSearchScope || "";
    const headerSearchOverlay = document.getElementById(
      "header-search-overlay"
    );
    const navLinkElements = Array.from(
      drawer.querySelectorAll("[data-mobile-nav-link]")
    );
    const tabPanels = Array.from(
      drawer.querySelectorAll("[data-mobile-nav-content]")
    );
    const isStarlightApiReferenceRoute =
      window.location.pathname === "/api/reference" ||
      window.location.pathname.startsWith("/api/reference/");
    const shouldRestoreDrawerOpen =
      matchMedia("(max-width: 63.999rem)").matches &&
      !isStarlightApiReferenceRoute &&
      readPersistedMobileNavOpen();

    const configuredDefaultTab = navTabElements.find(
      (tab) => tab.dataset.tabId === drawer.dataset.defaultTabId
    );
    let activeTabId =
      visibleNavTabElements.find((tab) => tab.dataset.isActive === "true")
        ?.dataset.tabId ||
      (!configuredDefaultTab?.hidden
        ? configuredDefaultTab?.dataset.tabId
        : undefined) ||
      visibleNavTabElements[0]?.dataset.tabId ||
      null;

    const updateSelectedOption = (tabId) => {
      let selectedLabel = "";
      let selectedPlaceholder = "";
      let selectedScope = "";

      navTabElements.forEach((tab) => {
        const isSelected = tab.dataset.tabId === tabId;
        tab.dataset.selected = isSelected ? "true" : "false";
        tab.setAttribute("aria-selected", isSelected ? "true" : "false");

        if (isSelected && !selectedLabel) {
          selectedLabel = tab.dataset.label || tab.textContent?.trim() || "";
        }

        if (isSelected && !selectedPlaceholder) {
          selectedPlaceholder = tab.dataset.searchPlaceholder || "";
        }

        if (isSelected && !selectedScope) {
          selectedScope = tab.dataset.searchScope || "";
        }
      });

      if (!selectedLabel && visibleNavTabElements[0]) {
        selectedLabel =
          visibleNavTabElements[0].dataset.label ||
          visibleNavTabElements[0].textContent?.trim() ||
          "";
      }

      if (!selectedPlaceholder && visibleNavTabElements[0]) {
        selectedPlaceholder =
          visibleNavTabElements[0].dataset.searchPlaceholder || "";
      }

      if (!selectedScope && visibleNavTabElements[0]) {
        selectedScope = visibleNavTabElements[0].dataset.searchScope || "";
      }

      const nextPlaceholder = selectedPlaceholder || defaultSearchPlaceholder;
      const nextScope = selectedScope || defaultSearchScope;
      const updatePlaceholder = (container) => {
        if (!container) return;
        const input = container.querySelector("[data-site-search-input]");
        if (input instanceof HTMLInputElement) {
          input.placeholder = nextPlaceholder;
        }
      };
      const updateScope = (container) => {
        if (!container) return;
        const target = container.querySelector("[data-site-search-root]");
        if (!target) return;
        target.setAttribute("data-scope", nextScope);
        target.dispatchEvent(new CustomEvent("site-search:update"));
      };
      updatePlaceholder(drawer);
      updatePlaceholder(headerSearchOverlay);
      updateScope(drawer);
      updateScope(headerSearchOverlay);
    };

    const activeVariantByTabId = new Map();

    const getTabLabel = (tabId) => {
      return (
        navTabElements.find((tab) => tab.dataset.tabId === tabId)?.dataset
          .label || ""
      );
    };

    const updatePanelBreadcrumb = (panel, tabId, contextLabel) => {
      const breadcrumb = panel.querySelector("[data-mobile-breadcrumb]");
      const parent = panel.querySelector("[data-mobile-breadcrumb-parent]");
      const childWrapper = panel.querySelector(
        "[data-mobile-breadcrumb-child-wrapper]"
      );
      const child = panel.querySelector("[data-mobile-breadcrumb-child]");
      const contextOptions = panel.querySelector(
        "[data-mobile-context-options]"
      );

      if (contextOptions) {
        contextOptions.dataset.contextActive = contextLabel ? "true" : "false";
      }

      if (!breadcrumb || !parent || !childWrapper || !child) {
        return;
      }

      const tabLabel = getTabLabel(tabId);
      parent.textContent = tabLabel;

      if (!contextLabel) {
        breadcrumb.setAttribute("hidden", "true");
        childWrapper.setAttribute("hidden", "true");
        child.textContent = "";
        return;
      }

      breadcrumb.removeAttribute("hidden");
      childWrapper.removeAttribute("hidden");
      child.textContent = contextLabel;
    };

    const selectVariantForPanel = (panel, tabId, variantId) => {
      if (!variantId) {
        updatePanelBreadcrumb(panel, tabId, "");
        return;
      }

      const contextOptions = Array.from(
        panel.querySelectorAll("[data-mobile-context-option]")
      );
      const contextSelects = Array.from(
        panel.querySelectorAll("[data-mobile-context-select]")
      );
      let selectedContextLabel = "";

      contextOptions.forEach((option) => {
        const isSelected = option.dataset.contextId === variantId;
        option.dataset.selected = isSelected ? "true" : "false";
        if (isSelected) {
          selectedContextLabel = option.dataset.contextLabel || "";
        }
      });

      contextSelects.forEach((select) => {
        select.dataset.value = variantId;
        select.dispatchEvent(
          new CustomEvent("mobile-context-select-sync", {
            detail: { value: variantId },
          })
        );
      });

      const variantSections = Array.from(
        panel.querySelectorAll("[data-mobile-nav-variant-content]")
      );
      variantSections.forEach((section) => {
        const isSelected = section.dataset.variantId === variantId;
        if (isSelected) {
          section.removeAttribute("hidden");
        } else {
          section.setAttribute("hidden", "true");
        }
      });

      updatePanelBreadcrumb(panel, tabId, selectedContextLabel);
      activeVariantByTabId.set(tabId, variantId);
    };

    const activateTab = (tabId) => {
      if (!tabId) return;
      activeTabId = tabId;
      updateSelectedOption(tabId);

      tabPanels.forEach((panel) => {
        const panelTabId = panel.getAttribute("data-tab-id");
        const isActive = panelTabId === tabId;
        if (isActive) {
          panel.removeAttribute("hidden");
          const defaultVariantId = panel.getAttribute(
            "data-default-variant-id"
          );
          const nextVariantId =
            activeVariantByTabId.get(tabId) ||
            defaultVariantId ||
            panel.querySelector("[data-mobile-nav-variant-content]")?.dataset
              .variantId ||
            "";
          selectVariantForPanel(panel, tabId, nextVariantId);
        } else {
          panel.setAttribute("hidden", "true");
        }
      });
    };

    const closeDrawer = () => {
      drawer.classList.remove("open");
      drawerButton.classList.remove("open");
      drawerButton.setAttribute("aria-expanded", "false");
      setPersistedMobileNavOpen(false);
    };

    const openDrawer = () => {
      drawer.classList.add("open");
      drawerButton.classList.add("open");
      drawerButton.setAttribute("aria-expanded", "true");
      if (activeTabId) {
        activateTab(activeTabId);
      }
    };

    const toggleDrawer = () => {
      if (drawer.classList.contains("open")) {
        closeDrawer();
      } else {
        openDrawer();
      }
    };

    const handleTabSelection = (tab) => {
      const hasNav = tab.dataset.hasNav === "true";
      const href = tab.dataset.href;
      const tabId = tab.dataset.tabId;

      if (!tabId) {
        return;
      }

      if (!hasNav && href) {
        setPersistedMobileNavOpen(true);
        window.location.href = href;
        return;
      }

      activateTab(tabId);
    };

    drawerButton.addEventListener("click", toggleDrawer);

    navTabElements.forEach((tab) => {
      tab.addEventListener("click", () => {
        handleTabSelection(tab);
      });

      tab.addEventListener("keydown", (event) => {
        if (!visibleNavTabElements.length) return;

        const currentIndex = visibleNavTabElements.indexOf(tab);

        if (event.key === "ArrowRight") {
          event.preventDefault();
          const nextIndex = (currentIndex + 1) % visibleNavTabElements.length;
          visibleNavTabElements[nextIndex]?.focus();
        } else if (event.key === "ArrowLeft") {
          event.preventDefault();
          const prevIndex =
            (currentIndex - 1 + visibleNavTabElements.length) %
            visibleNavTabElements.length;
          visibleNavTabElements[prevIndex]?.focus();
        } else if (event.key === "Home") {
          event.preventDefault();
          visibleNavTabElements[0]?.focus();
        } else if (event.key === "End") {
          event.preventDefault();
          visibleNavTabElements[visibleNavTabElements.length - 1]?.focus();
        } else if (
          event.key === "Enter" ||
          event.key === " " ||
          event.key === "Space" ||
          event.key === "Spacebar"
        ) {
          event.preventDefault();
          handleTabSelection(tab);
        } else if (event.key === "Escape") {
          event.preventDefault();
          closeDrawer();
          drawerButton.focus();
        }
      });
    });

    tabPanels.forEach((panel) => {
      const tabId = panel.getAttribute("data-tab-id") || "";
      const contextOptions = Array.from(
        panel.querySelectorAll("[data-mobile-context-option]")
      );

      contextOptions.forEach((option) => {
        option.addEventListener("click", () => {
          const contextHref = option.dataset.contextHref;
          if (
            contextHref &&
            contextHref.startsWith("/api/reference") &&
            tabId
          ) {
            closeDrawer();
            window.location.href = contextHref;
            return;
          }

          const variantId = option.dataset.contextId;
          if (!variantId || !tabId) {
            return;
          }

          selectVariantForPanel(panel, tabId, variantId);
        });
      });

      const contextSelects = Array.from(
        panel.querySelectorAll("[data-mobile-context-select]")
      );
      contextSelects.forEach((select) => {
        select.addEventListener("mobile-context-select-change", (event) => {
          if (!(event instanceof CustomEvent) || !tabId) {
            return;
          }

          const variantId = event.detail?.value;
          if (typeof variantId !== "string") {
            return;
          }

          selectVariantForPanel(panel, tabId, variantId);
        });
      });
    });

    navLinkElements.forEach((link) => {
      link.addEventListener("click", () => {
        closeDrawer();
      });
    });

    const mobileSearch = drawer.querySelector("[data-mobile-search]");
    mobileSearch?.addEventListener("click", (event) => {
      const target = event.target;
      if (target instanceof Element) {
        const anchor = target.closest("a[href]");
        if (anchor) {
          closeDrawer();
        }
      }
    });

    mobileSearch?.addEventListener("focusin", (event) => {
      const target = event.target;
      if (!(target instanceof HTMLInputElement) || target.type !== "text") {
        return;
      }
      closeDrawer();
      window.requestAnimationFrame(() => {
        if (document.activeElement === target) {
          target.blur();
        }
        document.dispatchEvent(
          new CustomEvent("header:open-search", {
            detail: {
              trigger: target,
              variant: "mobile",
            },
          })
        );
      });
    });

    drawer.addEventListener("keydown", (event) => {
      if (event.key === "Escape") {
        closeDrawer();
        drawerButton.focus();
      }
    });

    drawer.dataset.mobileNavInitialized = "true";
    if (activeTabId) {
      activateTab(activeTabId);
    }

    if (shouldRestoreDrawerOpen) {
      openDrawer();
      setPersistedMobileNavOpen(false);
    }
  }

  function initializeHeaderSearch() {
    const overlay = document.getElementById("header-search-overlay");
    if (!overlay) {
      return;
    }

    const getSearchButtons = () =>
      Array.from(document.querySelectorAll("[data-header-search-button]"));

    const closeButtons = overlay.querySelectorAll("[data-header-search-close]");
    const dismissTarget = overlay.querySelector("[data-header-search-dismiss]");
    const panel = overlay.querySelector("[data-header-search-panel]");
    const overlayMobileClass = "header-search-overlay--mobile";
    const panelMobileClass = "header-search-panel--mobile";
    let lastTrigger = null;
    let lastVariant = null;

    const setExpandedState = (isOpen) => {
      const expanded = isOpen ? "true" : "false";
      getSearchButtons().forEach((button) => {
        button.setAttribute("aria-expanded", expanded);
        button.setAttribute("data-active", expanded);
      });
      overlay.dataset.open = expanded;
      overlay.setAttribute("aria-hidden", isOpen ? "false" : "true");
    };

    const focusSearchInput = () => {
      window.requestAnimationFrame(() => {
        const input = overlay.querySelector("[data-site-search-input]");
        if (input) {
          input.focus();
          input.select();
        }
      });
    };

    const openOverlay = (trigger, options = {}) => {
      lastTrigger = trigger ?? document.activeElement;
      const variant = options.variant ?? null;
      lastVariant = typeof variant === "string" ? variant : null;
      overlay.classList.remove("hidden");
      overlay.classList.add("flex");
      const isMobileVariant = lastVariant === "mobile";
      if (isMobileVariant) {
        overlay.dataset.variant = "mobile";
      } else {
        delete overlay.dataset.variant;
      }
      overlay.classList.toggle(overlayMobileClass, isMobileVariant);
      panel?.classList.toggle(panelMobileClass, isMobileVariant);
      document.documentElement.classList.add("has-header-search-open");
      setExpandedState(true);
      focusSearchInput();
    };

    const closeOverlay = () => {
      overlay.classList.add("hidden");
      overlay.classList.remove("flex");
      document.documentElement.classList.remove("has-header-search-open");
      overlay.classList.remove(overlayMobileClass);
      panel?.classList.remove(panelMobileClass);
      delete overlay.dataset.variant;
      setExpandedState(false);
      if (lastTrigger instanceof HTMLElement) {
        if (
          lastVariant === "mobile" &&
          typeof lastTrigger.blur === "function"
        ) {
          lastTrigger.blur();
        } else if (lastVariant !== "mobile") {
          lastTrigger.focus();
        }
      }
      lastTrigger = null;
      lastVariant = null;
    };

    const bindSearchButtons = () => {
      getSearchButtons().forEach((button) => {
        if (button.dataset.searchButtonInitialized === "true") {
          return;
        }

        button.addEventListener("click", (event) => {
          event.preventDefault();
          openOverlay(button);
        });

        button.dataset.searchButtonInitialized = "true";
      });
    };

    if (overlay.dataset.searchInitialized !== "true") {
      closeButtons.forEach((button) => {
        button.addEventListener("click", () => {
          closeOverlay();
        });
      });

      overlay.addEventListener("click", (event) => {
        if (event.target === overlay) {
          closeOverlay();
        }
      });

      dismissTarget?.addEventListener("click", closeOverlay);

      const handleKeydown = (event) => {
        const key = "key" in event ? event.key : undefined;
        const isShortcut =
          !!key &&
          key.toLowerCase() === "k" &&
          (event.metaKey || event.ctrlKey);

        if (isShortcut) {
          event.preventDefault();
          const buttons = getSearchButtons();
          openOverlay(buttons[0] ?? null);
          return;
        }

        if (key === "Escape" && overlay.dataset.open === "true") {
          event.preventDefault();
          closeOverlay();
        }
      };

      document.addEventListener("keydown", handleKeydown);

      document.addEventListener("header:open-search", (event) => {
        const detail =
          event instanceof CustomEvent && typeof event.detail === "object"
            ? event.detail
            : {};
        const trigger =
          detail && detail.trigger instanceof HTMLElement
            ? detail.trigger
            : null;
        openOverlay(trigger, detail);
      });

      document.addEventListener("astro:before-swap", () => {
        if (overlay.dataset.open === "true") {
          closeOverlay();
        }
      });

      overlay.dataset.searchInitialized = "true";
    }

    bindSearchButtons();
  }

  const handleAfterSwap = () => {
    initializeMobileNavigation();
    window.requestAnimationFrame(() => {
      initializeHeaderSearch();
    });
  };

  document.addEventListener("astro:after-swap", handleAfterSwap);
  if (document.readyState === "loading") {
    document.addEventListener("DOMContentLoaded", handleAfterSwap, {
      once: true,
    });
  } else {
    handleAfterSwap();
  }
</script> <script>(()=>{var e=async t=>{await(await t())()};(self.Astro||(self.Astro={})).only=e;window.dispatchEvent(new Event("astro:only"));})();</script><astro-island uid="DQ4jb" component-url="/_astro/Analytics.BkQu9XS9.js" component-export="default" renderer-url="/_astro/client.CNnMPaG9.js" props="{}" ssr client="only" opts="{&quot;name&quot;:&quot;VercelAnalyticsClient&quot;,&quot;value&quot;:&quot;solid-js&quot;}"></astro-island> <vercel-speed-insights data-props="{}" data-params="{&#34;slug&#34;:&#34;overview&#34;}" data-pathname="/api/reference/overview/"></vercel-speed-insights> <script type="module">var o="@vercel/speed-insights",u="1.3.1",f=()=>{window.si||(window.si=function(...r){(window.siq=window.siq||[]).push(r)})};function l(){return typeof window<"u"}function h(){try{const e="production"}catch{}return"production"}function d(){return h()==="development"}function v(e,r){if(!e||!r)return e;let n=e;try{const t=Object.entries(r);for(const[s,i]of t)if(!Array.isArray(i)){const a=c(i);a.test(n)&&(n=n.replace(a,`/[${s}]`))}for(const[s,i]of t)if(Array.isArray(i)){const a=c(i.join("/"));a.test(n)&&(n=n.replace(a,`/[...${s}]`))}return n}catch{return e}}function c(e){return new RegExp(`/${g(e)}(?=[/?#]|$)`)}function g(e){return e.replace(/[.*+?^${}()|[\]\\]/g,"\\$&")}function m(e){return e.scriptSrc?e.scriptSrc:d()?"https://va.vercel-scripts.com/v1/speed-insights/script.debug.js":e.dsn?"https://va.vercel-scripts.com/v1/speed-insights/script.js":e.basePath?`${e.basePath}/speed-insights/script.js`:"/_vercel/speed-insights/script.js"}function w(e={}){var r;if(!l()||e.route===null)return null;f();const n=m(e);if(document.head.querySelector(`script[src*="${n}"]`))return null;e.beforeSend&&((r=window.si)==null||r.call(window,"beforeSend",e.beforeSend));const t=document.createElement("script");return t.src=n,t.defer=!0,t.dataset.sdkn=o+(e.framework?`/${e.framework}`:""),t.dataset.sdkv=u,e.sampleRate&&(t.dataset.sampleRate=e.sampleRate.toString()),e.route&&(t.dataset.route=e.route),e.endpoint?t.dataset.endpoint=e.endpoint:e.basePath&&(t.dataset.endpoint=`${e.basePath}/speed-insights/vitals`),e.dsn&&(t.dataset.dsn=e.dsn),d()&&e.debug===!1&&(t.dataset.debug="false"),t.onerror=()=>{console.log(`[Vercel Speed Insights] Failed to load script from ${n}. Please check if any content blockers are enabled and try again.`)},document.head.appendChild(t),{setRoute:s=>{t.dataset.route=s??void 0}}}function p(){try{return}catch{}}customElements.define("vercel-speed-insights",class extends HTMLElement{constructor(){super();try{const r=JSON.parse(this.dataset.props??"{}"),n=JSON.parse(this.dataset.params??"{}"),t=v(this.dataset.pathname??"",n);w({route:t,...r,framework:"astro",basePath:p(),beforeSend:window.speedInsightsBeforeSend})}catch(r){throw new Error(`Failed to parse SpeedInsights properties: ${r}`)}}});</script> <div id="starlight-mobile-primary-tabs" class="fixed left-0 right-0 top-16 z-40 bg-surface px-6 pt-6 pb-2"> <div class="flex items-center gap-2"> <nav class="min-w-0 -mx-1 flex flex-1 items-center gap-2 overflow-x-auto px-1 whitespace-nowrap" aria-label="Primary navigation"> <a href="/api/docs" class="shrink-0 rounded-full border px-3.5 py-1.5 text-sm transition-colors focus-visible:outline focus-visible:outline-2 focus-visible:outline-offset-2 focus-visible:outline-primary-surface border-primary-surface bg-primary-soft text-default" aria-current="true" data-site-visibility-exclude="chatgpt-docs"> API </a><a href="https://learn.chatgpt.com/docs" target="_blank" rel="noopener noreferrer" class="shrink-0 rounded-full border px-3.5 py-1.5 text-sm transition-colors focus-visible:outline focus-visible:outline-2 focus-visible:outline-offset-2 focus-visible:outline-primary-surface border-primary-surface text-secondary hover:bg-primary-soft-alpha hover:text-default" data-site-visibility-exclude="chatgpt-docs"> Codex </a><a href="/chatgpt" class="shrink-0 rounded-full border px-3.5 py-1.5 text-sm transition-colors focus-visible:outline focus-visible:outline-2 focus-visible:outline-offset-2 focus-visible:outline-primary-surface border-primary-surface text-secondary hover:bg-primary-soft-alpha hover:text-default" data-site-visibility-exclude="chatgpt-docs"> ChatGPT </a><a href="/codex" class="shrink-0 rounded-full border px-3.5 py-1.5 text-sm transition-colors focus-visible:outline focus-visible:outline-2 focus-visible:outline-offset-2 focus-visible:outline-primary-surface border-primary-surface text-secondary hover:bg-primary-soft-alpha hover:text-default" data-site-visibility-include="chatgpt-docs"> Docs </a><a href="/codex/use-cases" class="shrink-0 rounded-full border px-3.5 py-1.5 text-sm transition-colors focus-visible:outline focus-visible:outline-2 focus-visible:outline-offset-2 focus-visible:outline-primary-surface border-primary-surface text-secondary hover:bg-primary-soft-alpha hover:text-default" data-site-visibility-include="chatgpt-docs"> Use cases </a><a href="/resources" class="shrink-0 rounded-full border px-3.5 py-1.5 text-sm transition-colors focus-visible:outline focus-visible:outline-2 focus-visible:outline-offset-2 focus-visible:outline-primary-surface border-primary-surface text-secondary hover:bg-primary-soft-alpha hover:text-default" data-site-visibility-include="chatgpt-docs"> Resources </a><a href="/learn" class="shrink-0 rounded-full border px-3.5 py-1.5 text-sm transition-colors focus-visible:outline focus-visible:outline-2 focus-visible:outline-offset-2 focus-visible:outline-primary-surface border-primary-surface text-secondary hover:bg-primary-soft-alpha hover:text-default" data-site-visibility-exclude="chatgpt-docs"> Resources </a> </nav> <button id="starlight-mobile-theme-button" type="button" aria-label="Toggle light and dark theme" class="shrink-0 appearance-none rounded-full border border-primary-surface bg-transparent p-2 text-secondary shadow-none transition-colors hover:text-default"> <svg width="22" height="22" viewBox="0 0 22 22" fill="none" xmlns="http://www.w3.org/2000/svg" class="block h-5 w-5 dark:hidden " ><path fill-rule="evenodd" clip-rule="evenodd" d="M11 0C11.5523 0 12 0.447715 12 1V3C12 3.55228 11.5523 4 11 4C10.4477 4 10 3.55228 10 3V1C10 0.447715 10.4477 0 11 0ZM3.22183 3.22183C3.61235 2.8313 4.24551 2.8313 4.63604 3.22183L6.05025 4.63604C6.44078 5.02656 6.44078 5.65973 6.05025 6.05025C5.65973 6.44078 5.02656 6.44078 4.63604 6.05025L3.22183 4.63604C2.8313 4.24551 2.8313 3.61235 3.22183 3.22183ZM18.7782 3.22183C19.1687 3.61235 19.1687 4.24551 18.7782 4.63604L17.364 6.05025C16.9734 6.44078 16.3403 6.44078 15.9497 6.05025C15.5592 5.65973 15.5592 5.02656 15.9497 4.63604L17.364 3.22183C17.7545 2.8313 18.3876 2.8313 18.7782 3.22183ZM11 8C9.34315 8 8 9.34315 8 11C8 12.6569 9.34315 14 11 14C12.6569 14 14 12.6569 14 11C14 9.34315 12.6569 8 11 8ZM6 11C6 8.23858 8.23858 6 11 6C13.7614 6 16 8.23858 16 11C16 13.7614 13.7614 16 11 16C8.23858 16 6 13.7614 6 11ZM0 11C0 10.4477 0.447715 10 1 10H3C3.55228 10 4 10.4477 4 11C4 11.5523 3.55228 12 3 12H1C0.447715 12 0 11.5523 0 11ZM18 11C18 10.4477 18.4477 10 19 10H21C21.5523 10 22 10.4477 22 11C22 11.5523 21.5523 12 21 12H19C18.4477 12 18 11.5523 18 11ZM6.05025 15.9497C6.44078 16.3403 6.44078 16.9734 6.05025 17.364L4.63604 18.7782C4.24551 19.1687 3.61235 19.1687 3.22183 18.7782C2.8313 18.3876 2.8313 17.7545 3.22183 17.364L4.63604 15.9497C5.02656 15.5592 5.65973 15.5592 6.05025 15.9497ZM15.9497 15.9497C16.3403 15.5592 16.9734 15.5592 17.364 15.9497L18.7782 17.364C19.1687 17.7545 19.1687 18.3876 18.7782 18.7782C18.3877 19.1687 17.7545 19.1687 17.364 18.7782L15.9497 17.364C15.5592 16.9734 15.5592 16.3403 15.9497 15.9497ZM11 18C11.5523 18 12 18.4477 12 19V21C12 21.5523 11.5523 22 11 22C10.4477 22 10 21.5523 10 21V19C10 18.4477 10.4477 18 11 18Z" fill="currentColor"></path></svg> <svg width="20" height="20" viewBox="0 0 20 20" fill="none" xmlns="http://www.w3.org/2000/svg" class="hidden h-5 w-5 dark:block " ><path d="M10.7836 0.470481C10.9676 0.765118 10.9855 1.13415 10.8309 1.44525C10.2994 2.51497 10 3.7211 10 5.00001C10 9.41829 13.5817 13 18 13L18.0575 12.9998C18.4049 12.9974 18.7287 13.1754 18.9127 13.47C19.0968 13.7647 19.1147 14.1337 18.9601 14.4448C17.325 17.7352 13.9279 20 10 20C4.47715 20 0 15.5229 0 10C0 4.50107 4.43841 0.038857 9.92838 0.000268937C10.2758 -0.00217271 10.5995 0.175844 10.7836 0.470481ZM8.40989 2.15803C4.75344 2.8954 2 6.12619 2 10C2 14.4183 5.58172 18 10 18C12.587 18 14.8886 16.7721 16.3516 14.8648C11.6131 14.0789 8 9.96139 8 5.00001C8 4.01361 8.1431 3.05953 8.40989 2.15803Z" fill="currentColor"></path></svg> </button> </div> <nav class="mt-2 -mx-1 flex items-center gap-2 overflow-x-auto px-1 whitespace-nowrap" aria-label="API sections"> <a href="/api/docs" class="shrink-0 rounded-full border px-3.5 py-1.5 text-sm transition-colors focus-visible:outline focus-visible:outline-2 focus-visible:outline-offset-2 focus-visible:outline-primary-surface border-primary-surface text-secondary hover:bg-primary-soft-alpha hover:text-default" data-site-visibility-exclude="chatgpt-docs"> Overview </a><a href="/api/docs/models" class="shrink-0 rounded-full border px-3.5 py-1.5 text-sm transition-colors focus-visible:outline focus-visible:outline-2 focus-visible:outline-offset-2 focus-visible:outline-primary-surface border-primary-surface text-secondary hover:bg-primary-soft-alpha hover:text-default" data-site-visibility-exclude="chatgpt-docs"> Models </a><a href="/api/docs/guides/agents" class="shrink-0 rounded-full border px-3.5 py-1.5 text-sm transition-colors focus-visible:outline focus-visible:outline-2 focus-visible:outline-offset-2 focus-visible:outline-primary-surface border-primary-surface text-secondary hover:bg-primary-soft-alpha hover:text-default" data-site-visibility-exclude="chatgpt-docs"> Agents </a><a href="/api/docs/guides/tools" class="shrink-0 rounded-full border px-3.5 py-1.5 text-sm transition-colors focus-visible:outline focus-visible:outline-2 focus-visible:outline-offset-2 focus-visible:outline-primary-surface border-primary-surface text-secondary hover:bg-primary-soft-alpha hover:text-default" data-site-visibility-exclude="chatgpt-docs"> Tools </a><a href="/api/docs/guides/realtime" class="shrink-0 rounded-full border px-3.5 py-1.5 text-sm transition-colors focus-visible:outline focus-visible:outline-2 focus-visible:outline-offset-2 focus-visible:outline-primary-surface border-primary-surface text-secondary hover:bg-primary-soft-alpha hover:text-default" data-site-visibility-exclude="chatgpt-docs"> Voice &amp; Audio </a><a href="/api/docs/guides/production-best-practices" class="shrink-0 rounded-full border px-3.5 py-1.5 text-sm transition-colors focus-visible:outline focus-visible:outline-2 focus-visible:outline-offset-2 focus-visible:outline-primary-surface border-primary-surface text-secondary hover:bg-primary-soft-alpha hover:text-default" data-site-visibility-exclude="chatgpt-docs"> Production </a><a href="/api/reference/overview" class="shrink-0 rounded-full border px-3.5 py-1.5 text-sm transition-colors focus-visible:outline focus-visible:outline-2 focus-visible:outline-offset-2 focus-visible:outline-primary-surface border-primary-surface bg-primary-soft text-default" aria-current="true" data-site-visibility-exclude="chatgpt-docs"> API reference </a> </nav> </div> <script src="/js/theme.js"></script> <script type="module" src="/_astro/StarlightHeader.astro_astro_type_script_index_0_lang.BAYPrJlt.js"></script> <script>
  const STARLIGHT_MOBILE_NAV_PERSIST_KEY = "mobile-nav:restore-open";
  const STARLIGHT_MENU_TOGGLE_SELECTOR = "starlight-menu-button";
  const STARLIGHT_PRIMARY_TAB_SELECTOR =
    "#starlight-mobile-primary-tabs a[href]";
  const STARLIGHT_API_SECTION_NAV_SELECTOR =
    '#starlight-mobile-primary-tabs nav[aria-label="API sections"]';
  const AI_DROPDOWN_SELECTOR = '[data-dropdown-id="ai-dropdown-button"]';
  const DISABLED_AI_OPTIONS = ["open-in-claude", "open-in-cursor"];
  const STARLIGHT_THEME_BUTTON_ID = "starlight-mobile-theme-button";

  const readStarlightPersistedMobileNavOpen = () => {
    try {
      return (
        sessionStorage.getItem(STARLIGHT_MOBILE_NAV_PERSIST_KEY) === "true"
      );
    } catch {
      return false;
    }
  };

  const setStarlightPersistedMobileNavOpen = (isOpen) => {
    try {
      if (isOpen) {
        sessionStorage.setItem(STARLIGHT_MOBILE_NAV_PERSIST_KEY, "true");
      } else {
        sessionStorage.removeItem(STARLIGHT_MOBILE_NAV_PERSIST_KEY);
      }
    } catch {}
  };

  const revealActiveMobileApiSection = () => {
    const nav = document.querySelector(STARLIGHT_API_SECTION_NAV_SELECTOR);
    if (!(nav instanceof HTMLElement)) return;

    const activeLink = nav.querySelector('[aria-current="true"]');
    if (!(activeLink instanceof HTMLElement)) return;

    nav.scrollLeft = Math.max(
      0,
      activeLink.offsetLeft - (nav.clientWidth - activeLink.clientWidth) / 2
    );
  };

  const removeDisabledAIDropdownOptions = () => {
    const dropdowns = document.querySelectorAll(AI_DROPDOWN_SELECTOR);
    if (!dropdowns.length) return;

    dropdowns.forEach((dropdown) => {
      DISABLED_AI_OPTIONS.forEach((id) => {
        const option = dropdown.querySelector(`[data-value="${id}"]`);
        option?.remove();
      });
    });
  };

  const wireAIDropdownOptionCleanup = () => {
    removeDisabledAIDropdownOptions();
    // The Stainless dropdown wiring can re-render items on navigation/hydration.
    window.setTimeout(removeDisabledAIDropdownOptions, 0);
  };

  const openStarlightMobileMenu = () => {
    const menuToggle = document.querySelector(STARLIGHT_MENU_TOGGLE_SELECTOR);
    if (!(menuToggle instanceof HTMLElement)) return false;
    menuToggle.setAttribute("aria-expanded", "true");
    document.body.toggleAttribute("data-mobile-menu-expanded", true);
    window.requestAnimationFrame(revealActiveMobileApiSection);
    return true;
  };

  const wireActiveMobileApiSection = () => {
    const menuToggle = document.querySelector(STARLIGHT_MENU_TOGGLE_SELECTOR);
    if (!(menuToggle instanceof HTMLElement)) return;
    if (menuToggle.dataset.apiSectionScrollBound === "true") return;

    menuToggle.addEventListener("click", () => {
      window.requestAnimationFrame(revealActiveMobileApiSection);
    });
    menuToggle.dataset.apiSectionScrollBound = "true";
  };

  const restoreStarlightMobileMenu = (attempt = 0) => {
    if (openStarlightMobileMenu()) {
      setStarlightPersistedMobileNavOpen(false);
      return;
    }
    if (attempt >= 12) {
      setStarlightPersistedMobileNavOpen(false);
      return;
    }
    window.requestAnimationFrame(() => {
      restoreStarlightMobileMenu(attempt + 1);
    });
  };

  const wireMobileNavPersistence = () => {
    const tabLinks = document.querySelectorAll(STARLIGHT_PRIMARY_TAB_SELECTOR);
    tabLinks.forEach((link) => {
      if (!(link instanceof HTMLAnchorElement)) return;
      if (link.dataset.mobileNavPersistBound === "true") return;
      link.addEventListener("click", () => {
        setStarlightPersistedMobileNavOpen(true);
      });
      link.dataset.mobileNavPersistBound = "true";
    });

    if (!matchMedia("(max-width: 50rem)").matches) return;
    if (!readStarlightPersistedMobileNavOpen()) return;
    restoreStarlightMobileMenu();
  };

  const wireStarlightThemeButton = () => {
    const themeButton = document.getElementById(STARLIGHT_THEME_BUTTON_ID);
    if (!(themeButton instanceof HTMLButtonElement)) return;
    if (themeButton.dataset.themeBound === "true") return;

    themeButton.addEventListener("click", () => {
      if (typeof changeTheme === "function") {
        changeTheme();
      }
    });
    themeButton.dataset.themeBound = "true";
  };

  const wireStarlightHeaderEnhancements = () => {
    document.dispatchEvent(new CustomEvent("site-variant:apply"));
    wireAIDropdownOptionCleanup();
    wireMobileNavPersistence();
    wireActiveMobileApiSection();
    wireStarlightThemeButton();
  };

  document.addEventListener(
    "DOMContentLoaded",
    wireStarlightHeaderEnhancements
  );
  document.addEventListener("astro:page-load", wireStarlightHeaderEnhancements);
  document.addEventListener(
    "astro:after-swap",
    wireStarlightHeaderEnhancements
  );

  wireStarlightHeaderEnhancements();
</script> </header> <nav class="sidebar" aria-label="Main"> <starlight-menu-button class="print:hidden astro-rsw2s5wp"> <button aria-expanded="false" aria-label="Menu" aria-controls="starlight__sidebar" class="sl-flex md:sl-hidden astro-rsw2s5wp"> <svg aria-hidden="true" class="open-menu astro-rsw2s5wp astro-axfkelf7" width="16" height="16" viewBox="0 0 24 24" fill="currentColor" style="--sl-icon-size: 1em;"><path d="M3 8h18a1 1 0 1 0 0-2H3a1 1 0 0 0 0 2Zm18 8H3a1 1 0 0 0 0 2h18a1 1 0 0 0 0-2Zm0-5H3a1 1 0 0 0 0 2h18a1 1 0 0 0 0-2Z"/></svg> <svg aria-hidden="true" class="close-menu astro-rsw2s5wp astro-axfkelf7" width="16" height="16" viewBox="0 0 24 24" fill="currentColor" style="--sl-icon-size: 1em;"><path d="m13.41 12 6.3-6.29a1.004 1.004 0 1 0-1.42-1.42L12 10.59l-6.29-6.3a1.004 1.004 0 0 0-1.42 1.42l6.3 6.29-6.3 6.29a1 1 0 0 0 0 1.42.998.998 0 0 0 1.42 0l6.29-6.3 6.29 6.3a.999.999 0 0 0 1.42 0 1 1 0 0 0 0-1.42L13.41 12Z"/></svg> </button> </starlight-menu-button> <script type="module">class s extends HTMLElement{constructor(){super(),this.btn=this.querySelector("button"),this.btn.addEventListener("click",()=>this.toggleExpanded());const t=this.closest("nav");t&&t.addEventListener("keyup",e=>this.closeOnEscape(e))}setExpanded(t){this.setAttribute("aria-expanded",String(t)),document.body.toggleAttribute("data-mobile-menu-expanded",t)}toggleExpanded(){this.setExpanded(this.getAttribute("aria-expanded")!=="true")}closeOnEscape(t){t.code==="Escape"&&(this.setExpanded(!1),this.btn.focus())}}customElements.define("starlight-menu-button",s);</script>  <div id="starlight__sidebar" class="sidebar-pane"> <div class="stl-sidebar-header-links">  </div> <div class="stl-sidebar-search-gap" aria-hidden="true"></div> <div class="stldocs-root stldocs-sidebar"><ul class="stldocs-sidebar-list"><li class="stldocs-sidebar-entry stldocs-sidebar-entry-link"><a href="/api/reference" class="stl-mobile-only-sidebar-item stl-mobile-only-sidebar-item-last">API Reference</a></li><li class="stldocs-sidebar-entry stldocs-sidebar-entry-group"><div class="stldocs-sidebar-expander"><div class="stldocs-expander-summary"><span>API Reference</span></div><ul class="stldocs-sidebar-list"><li class="stldocs-sidebar-entry stldocs-sidebar-entry-link"><a href="/api/reference/overview" aria-current="page">Introduction</a></li><li class="stldocs-sidebar-entry stldocs-sidebar-entry-link"><a href="/api/reference/overview#authentication">Authentication</a></li><li class="stldocs-sidebar-entry stldocs-sidebar-entry-link"><a href="/api/reference/workload-identity-federation">Workload identity tokens</a></li><li class="stldocs-sidebar-entry stldocs-sidebar-entry-link"><a href="/api/reference/overview#debugging-requests">Debugging requests</a></li><li class="stldocs-sidebar-entry stldocs-sidebar-entry-link"><a href="/api/reference/overview#backwards-compatibility">Backwards compatibility</a></li></ul></div></li><li class="stldocs-sidebar-entry stldocs-sidebar-entry-group"><div class="stldocs-sidebar-expander"><div class="stldocs-expander-summary"><span>Responses API</span></div><ul class="stldocs-sidebar-list"><li class="stldocs-sidebar-entry stldocs-sidebar-entry-link"><a href="/api/reference/responses/overview">Overview</a></li><li class="stldocs-sidebar-entry stldocs-sidebar-entry-group"><details class="stldocs-sidebar-expander"><summary class="stldocs-expander-summary"><span>Responses</span><svg xmlns="http://www.w3.org/2000/svg" width="16" height="16" viewBox="0 0 24 24" fill="none" stroke="currentColor" stroke-width="1" stroke-linecap="round" stroke-linejoin="round" class="lucide lucide-chevron-right stldocs-icon stldocs-expander-summary-icon" aria-hidden="true"><path d="m9 18 6-6-6-6"></path></svg></summary><ul class="stldocs-sidebar-list"><li class="stldocs-sidebar-entry stldocs-sidebar-entry-link"><a href="/api/reference/resources/responses/methods/create" data-stldocs-method="post"><span class="stl-ui-badge stl-ui-badge--size-sm stl-sidebar-icon stl-ui-badge--http stl-ui-badge--http-post" role="img" aria-label="POST"></span>Create a response</a></li><li class="stldocs-sidebar-entry stldocs-sidebar-entry-link"><a href="/api/reference/resources/responses/methods/retrieve" data-stldocs-method="get"><span class="stl-ui-badge stl-ui-badge--size-sm stl-sidebar-icon stl-ui-badge--http stl-ui-badge--http-get" role="img" aria-label="GET"></span>Retrieve a response</a></li><li class="stldocs-sidebar-entry stldocs-sidebar-entry-link"><a href="/api/reference/resources/responses/methods/delete" data-stldocs-method="delete"><span class="stl-ui-badge stl-ui-badge--size-sm stl-sidebar-icon stl-ui-badge--http stl-ui-badge--http-delete" role="img" aria-label="DELETE"></span>Delete a response</a></li><li class="stldocs-sidebar-entry stldocs-sidebar-entry-link"><a href="/api/reference/resources/responses/subresources/input_items/methods/list" data-stldocs-method="get"><span class="stl-ui-badge stl-ui-badge--size-sm stl-sidebar-icon stl-ui-badge--http stl-ui-badge--http-get" role="img" aria-label="GET"></span>List input items</a></li><li class="stldocs-sidebar-entry stldocs-sidebar-entry-link"><a href="/api/reference/resources/responses/subresources/input_tokens/methods/count" data-stldocs-method="post"><span class="stl-ui-badge stl-ui-badge--size-sm stl-sidebar-icon stl-ui-badge--http stl-ui-badge--http-post" role="img" aria-label="POST"></span>Count input tokens</a></li><li class="stldocs-sidebar-entry stldocs-sidebar-entry-link"><a href="/api/reference/resources/responses/methods/cancel" data-stldocs-method="post"><span class="stl-ui-badge stl-ui-badge--size-sm stl-sidebar-icon stl-ui-badge--http stl-ui-badge--http-post" role="img" aria-label="POST"></span>Cancel a response</a></li><li class="stldocs-sidebar-entry stldocs-sidebar-entry-link"><a href="/api/reference/resources/responses/methods/compact" data-stldocs-method="post"><span class="stl-ui-badge stl-ui-badge--size-sm stl-sidebar-icon stl-ui-badge--http stl-ui-badge--http-post" role="img" aria-label="POST"></span>Compact a response</a></li></ul></details></li><li class="stldocs-sidebar-entry stldocs-sidebar-entry-group"><details class="stldocs-sidebar-expander"><summary class="stldocs-expander-summary"><span>Conversations</span><svg xmlns="http://www.w3.org/2000/svg" width="16" height="16" viewBox="0 0 24 24" fill="none" stroke="currentColor" stroke-width="1" stroke-linecap="round" stroke-linejoin="round" class="lucide lucide-chevron-right stldocs-icon stldocs-expander-summary-icon" aria-hidden="true"><path d="m9 18 6-6-6-6"></path></svg></summary><ul class="stldocs-sidebar-list"><li class="stldocs-sidebar-entry stldocs-sidebar-entry-link"><a href="/api/reference/resources/conversations/methods/create" data-stldocs-method="post"><span class="stl-ui-badge stl-ui-badge--size-sm stl-sidebar-icon stl-ui-badge--http stl-ui-badge--http-post" role="img" aria-label="POST"></span>Create a conversation</a></li><li class="stldocs-sidebar-entry stldocs-sidebar-entry-link"><a href="/api/reference/resources/conversations/methods/retrieve" data-stldocs-method="get"><span class="stl-ui-badge stl-ui-badge--size-sm stl-sidebar-icon stl-ui-badge--http stl-ui-badge--http-get" role="img" aria-label="GET"></span>Retrieve a conversation</a></li><li class="stldocs-sidebar-entry stldocs-sidebar-entry-link"><a href="/api/reference/resources/conversations/methods/update" data-stldocs-method="post"><span class="stl-ui-badge stl-ui-badge--size-sm stl-sidebar-icon stl-ui-badge--http stl-ui-badge--http-post" role="img" aria-label="POST"></span>Update a conversation</a></li><li class="stldocs-sidebar-entry stldocs-sidebar-entry-link"><a href="/api/reference/resources/conversations/methods/delete" data-stldocs-method="delete"><span class="stl-ui-badge stl-ui-badge--size-sm stl-sidebar-icon stl-ui-badge--http stl-ui-badge--http-delete" role="img" aria-label="DELETE"></span>Delete a conversation</a></li><li class="stldocs-sidebar-entry stldocs-sidebar-entry-group"><details class="stldocs-sidebar-expander"><summary class="stldocs-expander-summary"><span>Items</span><svg xmlns="http://www.w3.org/2000/svg" width="16" height="16" viewBox="0 0 24 24" fill="none" stroke="currentColor" stroke-width="1" stroke-linecap="round" stroke-linejoin="round" class="lucide lucide-chevron-right stldocs-icon stldocs-expander-summary-icon" aria-hidden="true"><path d="m9 18 6-6-6-6"></path></svg></summary><ul class="stldocs-sidebar-list"><li class="stldocs-sidebar-entry stldocs-sidebar-entry-link"><a href="/api/reference/resources/conversations/subresources/items/methods/create" data-stldocs-method="post"><span class="stl-ui-badge stl-ui-badge--size-sm stl-sidebar-icon stl-ui-badge--http stl-ui-badge--http-post" role="img" aria-label="POST"></span>Create an item</a></li><li class="stldocs-sidebar-entry stldocs-sidebar-entry-link"><a href="/api/reference/resources/conversations/subresources/items/methods/retrieve" data-stldocs-method="get"><span class="stl-ui-badge stl-ui-badge--size-sm stl-sidebar-icon stl-ui-badge--http stl-ui-badge--http-get" role="img" aria-label="GET"></span>Retrieve an item</a></li><li class="stldocs-sidebar-entry stldocs-sidebar-entry-link"><a href="/api/reference/resources/conversations/subresources/items/methods/delete" data-stldocs-method="delete"><span class="stl-ui-badge stl-ui-badge--size-sm stl-sidebar-icon stl-ui-badge--http stl-ui-badge--http-delete" role="img" aria-label="DELETE"></span>Delete an item</a></li><li class="stldocs-sidebar-entry stldocs-sidebar-entry-link"><a href="/api/reference/resources/conversations/subresources/items/methods/list" data-stldocs-method="get"><span class="stl-ui-badge stl-ui-badge--size-sm stl-sidebar-icon stl-ui-badge--http stl-ui-badge--http-get" role="img" aria-label="GET"></span>List items</a></li></ul></details></li></ul></details></li><li class="stldocs-sidebar-entry stldocs-sidebar-entry-link"><a href="/api/reference/resources/responses/streaming-events">Streaming events</a></li><li class="stldocs-sidebar-entry stldocs-sidebar-entry-link"><a href="/api/reference/resources/responses/websocket-events">WebSocket events</a></li></ul></div></li><li class="stldocs-sidebar-entry stldocs-sidebar-entry-group"><div class="stldocs-sidebar-expander"><div class="stldocs-expander-summary"><span>Beta APIs</span></div><ul class="stldocs-sidebar-list"><li class="stldocs-sidebar-entry stldocs-sidebar-entry-group"><details class="stldocs-sidebar-expander"><summary class="stldocs-expander-summary"><span>Responses (Multi-agent)</span><svg xmlns="http://www.w3.org/2000/svg" width="16" height="16" viewBox="0 0 24 24" fill="none" stroke="currentColor" stroke-width="1" stroke-linecap="round" stroke-linejoin="round" class="lucide lucide-chevron-right stldocs-icon stldocs-expander-summary-icon" aria-hidden="true"><path d="m9 18 6-6-6-6"></path></svg></summary><ul class="stldocs-sidebar-list"><li class="stldocs-sidebar-entry stldocs-sidebar-entry-link"><a href="/api/reference/resources/beta/subresources/responses/methods/create" data-stldocs-method="post"><span class="stl-ui-badge stl-ui-badge--size-sm stl-sidebar-icon stl-ui-badge--http stl-ui-badge--http-post" role="img" aria-label="POST"></span>Create a responses (multi-agent)</a></li><li class="stldocs-sidebar-entry stldocs-sidebar-entry-link"><a href="/api/reference/resources/beta/subresources/responses/methods/retrieve" data-stldocs-method="get"><span class="stl-ui-badge stl-ui-badge--size-sm stl-sidebar-icon stl-ui-badge--http stl-ui-badge--http-get" role="img" aria-label="GET"></span>Retrieve a responses (multi-agent)</a></li><li class="stldocs-sidebar-entry stldocs-sidebar-entry-link"><a href="/api/reference/resources/beta/subresources/responses/methods/delete" data-stldocs-method="delete"><span class="stl-ui-badge stl-ui-badge--size-sm stl-sidebar-icon stl-ui-badge--http stl-ui-badge--http-delete" role="img" aria-label="DELETE"></span>Delete a responses (multi-agent)</a></li><li class="stldocs-sidebar-entry stldocs-sidebar-entry-link"><a href="/api/reference/resources/beta/subresources/responses/methods/cancel" data-stldocs-method="post"><span class="stl-ui-badge stl-ui-badge--size-sm stl-sidebar-icon stl-ui-badge--http stl-ui-badge--http-post" role="img" aria-label="POST"></span>Cancel a responses (multi-agent)</a></li><li class="stldocs-sidebar-entry stldocs-sidebar-entry-link"><a href="/api/reference/resources/beta/subresources/responses/methods/compact" data-stldocs-method="post"><span class="stl-ui-badge stl-ui-badge--size-sm stl-sidebar-icon stl-ui-badge--http stl-ui-badge--http-post" role="img" aria-label="POST"></span>Compact a responses (multi-agent)</a></li><li class="stldocs-sidebar-entry stldocs-sidebar-entry-group"><details class="stldocs-sidebar-expander"><summary class="stldocs-expander-summary"><span>Input Items</span><svg xmlns="http://www.w3.org/2000/svg" width="16" height="16" viewBox="0 0 24 24" fill="none" stroke="currentColor" stroke-width="1" stroke-linecap="round" stroke-linejoin="round" class="lucide lucide-chevron-right stldocs-icon stldocs-expander-summary-icon" aria-hidden="true"><path d="m9 18 6-6-6-6"></path></svg></summary><ul class="stldocs-sidebar-list"><li class="stldocs-sidebar-entry stldocs-sidebar-entry-link"><a href="/api/reference/resources/beta/subresources/responses/subresources/input_items/methods/list" data-stldocs-method="get"><span class="stl-ui-badge stl-ui-badge--size-sm stl-sidebar-icon stl-ui-badge--http stl-ui-badge--http-get" role="img" aria-label="GET"></span>List input items</a></li></ul></details></li><li class="stldocs-sidebar-entry stldocs-sidebar-entry-group"><details class="stldocs-sidebar-expander"><summary class="stldocs-expander-summary"><span>Input Tokens</span><svg xmlns="http://www.w3.org/2000/svg" width="16" height="16" viewBox="0 0 24 24" fill="none" stroke="currentColor" stroke-width="1" stroke-linecap="round" stroke-linejoin="round" class="lucide lucide-chevron-right stldocs-icon stldocs-expander-summary-icon" aria-hidden="true"><path d="m9 18 6-6-6-6"></path></svg></summary><ul class="stldocs-sidebar-list"><li class="stldocs-sidebar-entry stldocs-sidebar-entry-link"><a href="/api/reference/resources/beta/subresources/responses/subresources/input_tokens/methods/count" data-stldocs-method="post"><span class="stl-ui-badge stl-ui-badge--size-sm stl-sidebar-icon stl-ui-badge--http stl-ui-badge--http-post" role="img" aria-label="POST"></span>Count input tokens</a></li></ul></details></li></ul></details></li><li class="stldocs-sidebar-entry stldocs-sidebar-entry-link"><a href="/api/reference/resources/beta/subresources/responses/streaming-events">Streaming events</a></li><li class="stldocs-sidebar-entry stldocs-sidebar-entry-link"><a href="/api/reference/resources/beta/subresources/responses/websocket-events">WebSocket events</a></li></ul></div></li><li class="stldocs-sidebar-entry stldocs-sidebar-entry-group"><div class="stldocs-sidebar-expander"><div class="stldocs-expander-summary"><span>Webhooks</span></div><ul class="stldocs-sidebar-list"><li class="stldocs-sidebar-entry stldocs-sidebar-entry-link"><a href="/api/reference/resources/webhooks">Events</a></li></ul></div></li><li class="stldocs-sidebar-entry stldocs-sidebar-entry-group"><div class="stldocs-sidebar-expander"><div class="stldocs-expander-summary"><span>Platform APIs</span></div><ul class="stldocs-sidebar-list"><li class="stldocs-sidebar-entry stldocs-sidebar-entry-group"><details class="stldocs-sidebar-expander"><summary class="stldocs-expander-summary"><span>Audio</span><svg xmlns="http://www.w3.org/2000/svg" width="16" height="16" viewBox="0 0 24 24" fill="none" stroke="currentColor" stroke-width="1" stroke-linecap="round" stroke-linejoin="round" class="lucide lucide-chevron-right stldocs-icon stldocs-expander-summary-icon" aria-hidden="true"><path d="m9 18 6-6-6-6"></path></svg></summary><ul class="stldocs-sidebar-list"><li class="stldocs-sidebar-entry stldocs-sidebar-entry-link"><a href="/api/reference/resources/audio/subresources/speech/methods/create" data-stldocs-method="post"><span class="stl-ui-badge stl-ui-badge--size-sm stl-sidebar-icon stl-ui-badge--http stl-ui-badge--http-post" role="img" aria-label="POST"></span>Create a speech</a></li><li class="stldocs-sidebar-entry stldocs-sidebar-entry-link"><a href="/api/reference/resources/audio/subresources/transcriptions/methods/create" data-stldocs-method="post"><span class="stl-ui-badge stl-ui-badge--size-sm stl-sidebar-icon stl-ui-badge--http stl-ui-badge--http-post" role="img" aria-label="POST"></span>Create a transcription</a></li><li class="stldocs-sidebar-entry stldocs-sidebar-entry-link"><a href="/api/reference/resources/audio/subresources/translations/methods/create" data-stldocs-method="post"><span class="stl-ui-badge stl-ui-badge--size-sm stl-sidebar-icon stl-ui-badge--http stl-ui-badge--http-post" role="img" aria-label="POST"></span>Create a translation</a></li><li class="stldocs-sidebar-entry stldocs-sidebar-entry-group"><details class="stldocs-sidebar-expander"><summary class="stldocs-expander-summary"><span>Voice Consents</span><svg xmlns="http://www.w3.org/2000/svg" width="16" height="16" viewBox="0 0 24 24" fill="none" stroke="currentColor" stroke-width="1" stroke-linecap="round" stroke-linejoin="round" class="lucide lucide-chevron-right stldocs-icon stldocs-expander-summary-icon" aria-hidden="true"><path d="m9 18 6-6-6-6"></path></svg></summary><ul class="stldocs-sidebar-list"><li class="stldocs-sidebar-entry stldocs-sidebar-entry-link"><a href="/api/reference/resources/audio/subresources/voice_consents/methods/create" data-stldocs-method="post"><span class="stl-ui-badge stl-ui-badge--size-sm stl-sidebar-icon stl-ui-badge--http stl-ui-badge--http-post" role="img" aria-label="POST"></span>Create a voice consent</a></li><li class="stldocs-sidebar-entry stldocs-sidebar-entry-link"><a href="/api/reference/resources/audio/subresources/voice_consents/methods/retrieve" data-stldocs-method="get"><span class="stl-ui-badge stl-ui-badge--size-sm stl-sidebar-icon stl-ui-badge--http stl-ui-badge--http-get" role="img" aria-label="GET"></span>Retrieve a voice consent</a></li><li class="stldocs-sidebar-entry stldocs-sidebar-entry-link"><a href="/api/reference/resources/audio/subresources/voice_consents/methods/update" data-stldocs-method="post"><span class="stl-ui-badge stl-ui-badge--size-sm stl-sidebar-icon stl-ui-badge--http stl-ui-badge--http-post" role="img" aria-label="POST"></span>Update a voice consent</a></li><li class="stldocs-sidebar-entry stldocs-sidebar-entry-link"><a href="/api/reference/resources/audio/subresources/voice_consents/methods/delete" data-stldocs-method="delete"><span class="stl-ui-badge stl-ui-badge--size-sm stl-sidebar-icon stl-ui-badge--http stl-ui-badge--http-delete" role="img" aria-label="DELETE"></span>Delete a voice consent</a></li><li class="stldocs-sidebar-entry stldocs-sidebar-entry-link"><a href="/api/reference/resources/audio/subresources/voice_consents/methods/list" data-stldocs-method="get"><span class="stl-ui-badge stl-ui-badge--size-sm stl-sidebar-icon stl-ui-badge--http stl-ui-badge--http-get" role="img" aria-label="GET"></span>List voice consents</a></li></ul></details></li><li class="stldocs-sidebar-entry stldocs-sidebar-entry-link"><a href="/api/reference/resources/audio/subresources/voices/methods/create" data-stldocs-method="post"><span class="stl-ui-badge stl-ui-badge--size-sm stl-sidebar-icon stl-ui-badge--http stl-ui-badge--http-post" role="img" aria-label="POST"></span>Create a voice</a></li></ul></details></li><li class="stldocs-sidebar-entry stldocs-sidebar-entry-group"><details class="stldocs-sidebar-expander"><summary class="stldocs-expander-summary"><span>Videos</span><svg xmlns="http://www.w3.org/2000/svg" width="16" height="16" viewBox="0 0 24 24" fill="none" stroke="currentColor" stroke-width="1" stroke-linecap="round" stroke-linejoin="round" class="lucide lucide-chevron-right stldocs-icon stldocs-expander-summary-icon" aria-hidden="true"><path d="m9 18 6-6-6-6"></path></svg></summary><ul class="stldocs-sidebar-list"><li class="stldocs-sidebar-entry stldocs-sidebar-entry-link"><a href="/api/reference/resources/videos/methods/create" data-stldocs-method="post"><span class="stl-ui-badge stl-ui-badge--size-sm stl-sidebar-icon stl-ui-badge--http stl-ui-badge--http-post" role="img" aria-label="POST"></span>Create a video</a></li><li class="stldocs-sidebar-entry stldocs-sidebar-entry-link"><a href="/api/reference/resources/videos/methods/create_character" data-stldocs-method="post"><span class="stl-ui-badge stl-ui-badge--size-sm stl-sidebar-icon stl-ui-badge--http stl-ui-badge--http-post" role="img" aria-label="POST"></span>Create Character</a></li><li class="stldocs-sidebar-entry stldocs-sidebar-entry-link"><a href="/api/reference/resources/videos/methods/get_character" data-stldocs-method="get"><span class="stl-ui-badge stl-ui-badge--size-sm stl-sidebar-icon stl-ui-badge--http stl-ui-badge--http-get" role="img" aria-label="GET"></span>Get Character</a></li><li class="stldocs-sidebar-entry stldocs-sidebar-entry-link"><a href="/api/reference/resources/videos/methods/retrieve" data-stldocs-method="get"><span class="stl-ui-badge stl-ui-badge--size-sm stl-sidebar-icon stl-ui-badge--http stl-ui-badge--http-get" role="img" aria-label="GET"></span>Retrieve a video</a></li><li class="stldocs-sidebar-entry stldocs-sidebar-entry-link"><a href="/api/reference/resources/videos/methods/delete" data-stldocs-method="delete"><span class="stl-ui-badge stl-ui-badge--size-sm stl-sidebar-icon stl-ui-badge--http stl-ui-badge--http-delete" role="img" aria-label="DELETE"></span>Delete a video</a></li><li class="stldocs-sidebar-entry stldocs-sidebar-entry-link"><a href="/api/reference/resources/videos/methods/list" data-stldocs-method="get"><span class="stl-ui-badge stl-ui-badge--size-sm stl-sidebar-icon stl-ui-badge--http stl-ui-badge--http-get" role="img" aria-label="GET"></span>List videos</a></li><li class="stldocs-sidebar-entry stldocs-sidebar-entry-link"><a href="/api/reference/resources/videos/methods/download_content" data-stldocs-method="get"><span class="stl-ui-badge stl-ui-badge--size-sm stl-sidebar-icon stl-ui-badge--http stl-ui-badge--http-get" role="img" aria-label="GET"></span>Download Content</a></li><li class="stldocs-sidebar-entry stldocs-sidebar-entry-link"><a href="/api/reference/resources/videos/methods/edit" data-stldocs-method="post"><span class="stl-ui-badge stl-ui-badge--size-sm stl-sidebar-icon stl-ui-badge--http stl-ui-badge--http-post" role="img" aria-label="POST"></span>Edit</a></li><li class="stldocs-sidebar-entry stldocs-sidebar-entry-link"><a href="/api/reference/resources/videos/methods/extend" data-stldocs-method="post"><span class="stl-ui-badge stl-ui-badge--size-sm stl-sidebar-icon stl-ui-badge--http stl-ui-badge--http-post" role="img" aria-label="POST"></span>Extend</a></li><li class="stldocs-sidebar-entry stldocs-sidebar-entry-link"><a href="/api/reference/resources/videos/methods/remix" data-stldocs-method="post"><span class="stl-ui-badge stl-ui-badge--size-sm stl-sidebar-icon stl-ui-badge--http stl-ui-badge--http-post" role="img" aria-label="POST"></span>Remix</a></li></ul></details></li><li class="stldocs-sidebar-entry stldocs-sidebar-entry-group"><details class="stldocs-sidebar-expander"><summary class="stldocs-expander-summary"><span>Images</span><svg xmlns="http://www.w3.org/2000/svg" width="16" height="16" viewBox="0 0 24 24" fill="none" stroke="currentColor" stroke-width="1" stroke-linecap="round" stroke-linejoin="round" class="lucide lucide-chevron-right stldocs-icon stldocs-expander-summary-icon" aria-hidden="true"><path d="m9 18 6-6-6-6"></path></svg></summary><ul class="stldocs-sidebar-list"><li class="stldocs-sidebar-entry stldocs-sidebar-entry-link"><a href="/api/reference/resources/images/methods/generate" data-stldocs-method="post"><span class="stl-ui-badge stl-ui-badge--size-sm stl-sidebar-icon stl-ui-badge--http stl-ui-badge--http-post" role="img" aria-label="POST"></span>Generate an Image</a></li><li class="stldocs-sidebar-entry stldocs-sidebar-entry-link"><a href="/api/reference/resources/images/methods/edit" data-stldocs-method="post"><span class="stl-ui-badge stl-ui-badge--size-sm stl-sidebar-icon stl-ui-badge--http stl-ui-badge--http-post" role="img" aria-label="POST"></span>Edit an Image</a></li><li class="stldocs-sidebar-entry stldocs-sidebar-entry-link"><a href="/api/reference/resources/images/methods/create_variation" data-stldocs-method="post"><span class="stl-ui-badge stl-ui-badge--size-sm stl-sidebar-icon stl-ui-badge--http stl-ui-badge--http-post" role="img" aria-label="POST"></span>Create Variation</a></li><li class="stldocs-sidebar-entry stldocs-sidebar-entry-link"><a href="/api/reference/resources/images/generation-streaming-events">Image generation streaming events</a></li><li class="stldocs-sidebar-entry stldocs-sidebar-entry-link"><a href="/api/reference/resources/images/edit-streaming-events">Image edit streaming events</a></li></ul></details></li><li class="stldocs-sidebar-entry stldocs-sidebar-entry-group"><details class="stldocs-sidebar-expander"><summary class="stldocs-expander-summary"><span>Embeddings</span><svg xmlns="http://www.w3.org/2000/svg" width="16" height="16" viewBox="0 0 24 24" fill="none" stroke="currentColor" stroke-width="1" stroke-linecap="round" stroke-linejoin="round" class="lucide lucide-chevron-right stldocs-icon stldocs-expander-summary-icon" aria-hidden="true"><path d="m9 18 6-6-6-6"></path></svg></summary><ul class="stldocs-sidebar-list"><li class="stldocs-sidebar-entry stldocs-sidebar-entry-link"><a href="/api/reference/resources/embeddings/methods/create" data-stldocs-method="post"><span class="stl-ui-badge stl-ui-badge--size-sm stl-sidebar-icon stl-ui-badge--http stl-ui-badge--http-post" role="img" aria-label="POST"></span>Create an embedding</a></li></ul></details></li><li class="stldocs-sidebar-entry stldocs-sidebar-entry-group"><details class="stldocs-sidebar-expander"><summary class="stldocs-expander-summary"><span>Evals</span><svg xmlns="http://www.w3.org/2000/svg" width="16" height="16" viewBox="0 0 24 24" fill="none" stroke="currentColor" stroke-width="1" stroke-linecap="round" stroke-linejoin="round" class="lucide lucide-chevron-right stldocs-icon stldocs-expander-summary-icon" aria-hidden="true"><path d="m9 18 6-6-6-6"></path></svg></summary><ul class="stldocs-sidebar-list"><li class="stldocs-sidebar-entry stldocs-sidebar-entry-link"><a href="/api/reference/resources/evals/methods/create" data-stldocs-method="post"><span class="stl-ui-badge stl-ui-badge--size-sm stl-sidebar-icon stl-ui-badge--http stl-ui-badge--http-post" role="img" aria-label="POST"></span>Create an eval</a></li><li class="stldocs-sidebar-entry stldocs-sidebar-entry-link"><a href="/api/reference/resources/evals/methods/retrieve" data-stldocs-method="get"><span class="stl-ui-badge stl-ui-badge--size-sm stl-sidebar-icon stl-ui-badge--http stl-ui-badge--http-get" role="img" aria-label="GET"></span>Retrieve an eval</a></li><li class="stldocs-sidebar-entry stldocs-sidebar-entry-link"><a href="/api/reference/resources/evals/methods/update" data-stldocs-method="post"><span class="stl-ui-badge stl-ui-badge--size-sm stl-sidebar-icon stl-ui-badge--http stl-ui-badge--http-post" role="img" aria-label="POST"></span>Update an eval</a></li><li class="stldocs-sidebar-entry stldocs-sidebar-entry-link"><a href="/api/reference/resources/evals/methods/delete" data-stldocs-method="delete"><span class="stl-ui-badge stl-ui-badge--size-sm stl-sidebar-icon stl-ui-badge--http stl-ui-badge--http-delete" role="img" aria-label="DELETE"></span>Delete an eval</a></li><li class="stldocs-sidebar-entry stldocs-sidebar-entry-link"><a href="/api/reference/resources/evals/methods/list" data-stldocs-method="get"><span class="stl-ui-badge stl-ui-badge--size-sm stl-sidebar-icon stl-ui-badge--http stl-ui-badge--http-get" role="img" aria-label="GET"></span>List evals</a></li><li class="stldocs-sidebar-entry stldocs-sidebar-entry-group"><details class="stldocs-sidebar-expander"><summary class="stldocs-expander-summary"><span>Runs</span><svg xmlns="http://www.w3.org/2000/svg" width="16" height="16" viewBox="0 0 24 24" fill="none" stroke="currentColor" stroke-width="1" stroke-linecap="round" stroke-linejoin="round" class="lucide lucide-chevron-right stldocs-icon stldocs-expander-summary-icon" aria-hidden="true"><path d="m9 18 6-6-6-6"></path></svg></summary><ul class="stldocs-sidebar-list"><li class="stldocs-sidebar-entry stldocs-sidebar-entry-link"><a href="/api/reference/resources/evals/subresources/runs/methods/create" data-stldocs-method="post"><span class="stl-ui-badge stl-ui-badge--size-sm stl-sidebar-icon stl-ui-badge--http stl-ui-badge--http-post" role="img" aria-label="POST"></span>Create a run</a></li><li class="stldocs-sidebar-entry stldocs-sidebar-entry-link"><a href="/api/reference/resources/evals/subresources/runs/methods/retrieve" data-stldocs-method="get"><span class="stl-ui-badge stl-ui-badge--size-sm stl-sidebar-icon stl-ui-badge--http stl-ui-badge--http-get" role="img" aria-label="GET"></span>Retrieve a run</a></li><li class="stldocs-sidebar-entry stldocs-sidebar-entry-link"><a href="/api/reference/resources/evals/subresources/runs/methods/delete" data-stldocs-method="delete"><span class="stl-ui-badge stl-ui-badge--size-sm stl-sidebar-icon stl-ui-badge--http stl-ui-badge--http-delete" role="img" aria-label="DELETE"></span>Delete a run</a></li><li class="stldocs-sidebar-entry stldocs-sidebar-entry-link"><a href="/api/reference/resources/evals/subresources/runs/methods/list" data-stldocs-method="get"><span class="stl-ui-badge stl-ui-badge--size-sm stl-sidebar-icon stl-ui-badge--http stl-ui-badge--http-get" role="img" aria-label="GET"></span>List runs</a></li><li class="stldocs-sidebar-entry stldocs-sidebar-entry-link"><a href="/api/reference/resources/evals/subresources/runs/methods/cancel" data-stldocs-method="post"><span class="stl-ui-badge stl-ui-badge--size-sm stl-sidebar-icon stl-ui-badge--http stl-ui-badge--http-post" role="img" aria-label="POST"></span>Cancel a run</a></li><li class="stldocs-sidebar-entry stldocs-sidebar-entry-group"><details class="stldocs-sidebar-expander"><summary class="stldocs-expander-summary"><span>Output Items</span><svg xmlns="http://www.w3.org/2000/svg" width="16" height="16" viewBox="0 0 24 24" fill="none" stroke="currentColor" stroke-width="1" stroke-linecap="round" stroke-linejoin="round" class="lucide lucide-chevron-right stldocs-icon stldocs-expander-summary-icon" aria-hidden="true"><path d="m9 18 6-6-6-6"></path></svg></summary><ul class="stldocs-sidebar-list"><li class="stldocs-sidebar-entry stldocs-sidebar-entry-link"><a href="/api/reference/resources/evals/subresources/runs/subresources/output_items/methods/retrieve" data-stldocs-method="get"><span class="stl-ui-badge stl-ui-badge--size-sm stl-sidebar-icon stl-ui-badge--http stl-ui-badge--http-get" role="img" aria-label="GET"></span>Retrieve an output item</a></li><li class="stldocs-sidebar-entry stldocs-sidebar-entry-link"><a href="/api/reference/resources/evals/subresources/runs/subresources/output_items/methods/list" data-stldocs-method="get"><span class="stl-ui-badge stl-ui-badge--size-sm stl-sidebar-icon stl-ui-badge--http stl-ui-badge--http-get" role="img" aria-label="GET"></span>List output items</a></li></ul></details></li></ul></details></li></ul></details></li><li class="stldocs-sidebar-entry stldocs-sidebar-entry-group"><details class="stldocs-sidebar-expander"><summary class="stldocs-expander-summary"><span>Fine Tuning</span><svg xmlns="http://www.w3.org/2000/svg" width="16" height="16" viewBox="0 0 24 24" fill="none" stroke="currentColor" stroke-width="1" stroke-linecap="round" stroke-linejoin="round" class="lucide lucide-chevron-right stldocs-icon stldocs-expander-summary-icon" aria-hidden="true"><path d="m9 18 6-6-6-6"></path></svg></summary><ul class="stldocs-sidebar-list"><li class="stldocs-sidebar-entry stldocs-sidebar-entry-group"><details class="stldocs-sidebar-expander"><summary class="stldocs-expander-summary"><span>Alpha</span><svg xmlns="http://www.w3.org/2000/svg" width="16" height="16" viewBox="0 0 24 24" fill="none" stroke="currentColor" stroke-width="1" stroke-linecap="round" stroke-linejoin="round" class="lucide lucide-chevron-right stldocs-icon stldocs-expander-summary-icon" aria-hidden="true"><path d="m9 18 6-6-6-6"></path></svg></summary><ul class="stldocs-sidebar-list"><li class="stldocs-sidebar-entry stldocs-sidebar-entry-group"><details class="stldocs-sidebar-expander"><summary class="stldocs-expander-summary"><span>Graders</span><svg xmlns="http://www.w3.org/2000/svg" width="16" height="16" viewBox="0 0 24 24" fill="none" stroke="currentColor" stroke-width="1" stroke-linecap="round" stroke-linejoin="round" class="lucide lucide-chevron-right stldocs-icon stldocs-expander-summary-icon" aria-hidden="true"><path d="m9 18 6-6-6-6"></path></svg></summary><ul class="stldocs-sidebar-list"><li class="stldocs-sidebar-entry stldocs-sidebar-entry-link"><a href="/api/reference/resources/fine_tuning/subresources/alpha/subresources/graders/methods/run" data-stldocs-method="post"><span class="stl-ui-badge stl-ui-badge--size-sm stl-sidebar-icon stl-ui-badge--http stl-ui-badge--http-post" role="img" aria-label="POST"></span>Run</a></li><li class="stldocs-sidebar-entry stldocs-sidebar-entry-link"><a href="/api/reference/resources/fine_tuning/subresources/alpha/subresources/graders/methods/validate" data-stldocs-method="post"><span class="stl-ui-badge stl-ui-badge--size-sm stl-sidebar-icon stl-ui-badge--http stl-ui-badge--http-post" role="img" aria-label="POST"></span>Validate</a></li></ul></details></li></ul></details></li><li class="stldocs-sidebar-entry stldocs-sidebar-entry-group"><details class="stldocs-sidebar-expander"><summary class="stldocs-expander-summary"><span>Checkpoints</span><svg xmlns="http://www.w3.org/2000/svg" width="16" height="16" viewBox="0 0 24 24" fill="none" stroke="currentColor" stroke-width="1" stroke-linecap="round" stroke-linejoin="round" class="lucide lucide-chevron-right stldocs-icon stldocs-expander-summary-icon" aria-hidden="true"><path d="m9 18 6-6-6-6"></path></svg></summary><ul class="stldocs-sidebar-list"><li class="stldocs-sidebar-entry stldocs-sidebar-entry-group"><details class="stldocs-sidebar-expander"><summary class="stldocs-expander-summary"><span>Permissions</span><svg xmlns="http://www.w3.org/2000/svg" width="16" height="16" viewBox="0 0 24 24" fill="none" stroke="currentColor" stroke-width="1" stroke-linecap="round" stroke-linejoin="round" class="lucide lucide-chevron-right stldocs-icon stldocs-expander-summary-icon" aria-hidden="true"><path d="m9 18 6-6-6-6"></path></svg></summary><ul class="stldocs-sidebar-list"><li class="stldocs-sidebar-entry stldocs-sidebar-entry-link"><a href="/api/reference/resources/fine_tuning/subresources/checkpoints/subresources/permissions/methods/create" data-stldocs-method="post"><span class="stl-ui-badge stl-ui-badge--size-sm stl-sidebar-icon stl-ui-badge--http stl-ui-badge--http-post" role="img" aria-label="POST"></span>Create a permission</a></li><li class="stldocs-sidebar-entry stldocs-sidebar-entry-link"><a href="/api/reference/resources/fine_tuning/subresources/checkpoints/subresources/permissions/methods/list" data-stldocs-method="get"><span class="stl-ui-badge stl-ui-badge--size-sm stl-sidebar-icon stl-ui-badge--http stl-ui-badge--http-get" role="img" aria-label="GET"></span>Retrieve a permission</a></li><li class="stldocs-sidebar-entry stldocs-sidebar-entry-link"><a href="/api/reference/resources/fine_tuning/subresources/checkpoints/subresources/permissions/methods/delete" data-stldocs-method="delete"><span class="stl-ui-badge stl-ui-badge--size-sm stl-sidebar-icon stl-ui-badge--http stl-ui-badge--http-delete" role="img" aria-label="DELETE"></span>Delete a permission</a></li><li class="stldocs-sidebar-entry stldocs-sidebar-entry-link"><a href="/api/reference/resources/fine_tuning/subresources/checkpoints/subresources/permissions/methods/list" data-stldocs-method="get"><span class="stl-ui-badge stl-ui-badge--size-sm stl-sidebar-icon stl-ui-badge--http stl-ui-badge--http-get" role="img" aria-label="GET"></span>List permissions</a></li></ul></details></li></ul></details></li><li class="stldocs-sidebar-entry stldocs-sidebar-entry-group"><details class="stldocs-sidebar-expander"><summary class="stldocs-expander-summary"><span>Jobs</span><svg xmlns="http://www.w3.org/2000/svg" width="16" height="16" viewBox="0 0 24 24" fill="none" stroke="currentColor" stroke-width="1" stroke-linecap="round" stroke-linejoin="round" class="lucide lucide-chevron-right stldocs-icon stldocs-expander-summary-icon" aria-hidden="true"><path d="m9 18 6-6-6-6"></path></svg></summary><ul class="stldocs-sidebar-list"><li class="stldocs-sidebar-entry stldocs-sidebar-entry-link"><a href="/api/reference/resources/fine_tuning/subresources/jobs/methods/create" data-stldocs-method="post"><span class="stl-ui-badge stl-ui-badge--size-sm stl-sidebar-icon stl-ui-badge--http stl-ui-badge--http-post" role="img" aria-label="POST"></span>Create a job</a></li><li class="stldocs-sidebar-entry stldocs-sidebar-entry-link"><a href="/api/reference/resources/fine_tuning/subresources/jobs/methods/retrieve" data-stldocs-method="get"><span class="stl-ui-badge stl-ui-badge--size-sm stl-sidebar-icon stl-ui-badge--http stl-ui-badge--http-get" role="img" aria-label="GET"></span>Retrieve a job</a></li><li class="stldocs-sidebar-entry stldocs-sidebar-entry-link"><a href="/api/reference/resources/fine_tuning/subresources/jobs/methods/list" data-stldocs-method="get"><span class="stl-ui-badge stl-ui-badge--size-sm stl-sidebar-icon stl-ui-badge--http stl-ui-badge--http-get" role="img" aria-label="GET"></span>List jobs</a></li><li class="stldocs-sidebar-entry stldocs-sidebar-entry-link"><a href="/api/reference/resources/fine_tuning/subresources/jobs/methods/list_events" data-stldocs-method="get"><span class="stl-ui-badge stl-ui-badge--size-sm stl-sidebar-icon stl-ui-badge--http stl-ui-badge--http-get" role="img" aria-label="GET"></span>List Events</a></li><li class="stldocs-sidebar-entry stldocs-sidebar-entry-link"><a href="/api/reference/resources/fine_tuning/subresources/jobs/methods/cancel" data-stldocs-method="post"><span class="stl-ui-badge stl-ui-badge--size-sm stl-sidebar-icon stl-ui-badge--http stl-ui-badge--http-post" role="img" aria-label="POST"></span>Cancel a job</a></li><li class="stldocs-sidebar-entry stldocs-sidebar-entry-link"><a href="/api/reference/resources/fine_tuning/subresources/jobs/methods/pause" data-stldocs-method="post"><span class="stl-ui-badge stl-ui-badge--size-sm stl-sidebar-icon stl-ui-badge--http stl-ui-badge--http-post" role="img" aria-label="POST"></span>Pause</a></li><li class="stldocs-sidebar-entry stldocs-sidebar-entry-link"><a href="/api/reference/resources/fine_tuning/subresources/jobs/methods/resume" data-stldocs-method="post"><span class="stl-ui-badge stl-ui-badge--size-sm stl-sidebar-icon stl-ui-badge--http stl-ui-badge--http-post" role="img" aria-label="POST"></span>Resume</a></li><li class="stldocs-sidebar-entry stldocs-sidebar-entry-group"><details class="stldocs-sidebar-expander"><summary class="stldocs-expander-summary"><span>Checkpoints</span><svg xmlns="http://www.w3.org/2000/svg" width="16" height="16" viewBox="0 0 24 24" fill="none" stroke="currentColor" stroke-width="1" stroke-linecap="round" stroke-linejoin="round" class="lucide lucide-chevron-right stldocs-icon stldocs-expander-summary-icon" aria-hidden="true"><path d="m9 18 6-6-6-6"></path></svg></summary><ul class="stldocs-sidebar-list"><li class="stldocs-sidebar-entry stldocs-sidebar-entry-link"><a href="/api/reference/resources/fine_tuning/subresources/jobs/subresources/checkpoints/methods/list" data-stldocs-method="get"><span class="stl-ui-badge stl-ui-badge--size-sm stl-sidebar-icon stl-ui-badge--http stl-ui-badge--http-get" role="img" aria-label="GET"></span>List checkpoints</a></li></ul></details></li></ul></details></li></ul></details></li><li class="stldocs-sidebar-entry stldocs-sidebar-entry-group"><details class="stldocs-sidebar-expander"><summary class="stldocs-expander-summary"><span>Batches</span><svg xmlns="http://www.w3.org/2000/svg" width="16" height="16" viewBox="0 0 24 24" fill="none" stroke="currentColor" stroke-width="1" stroke-linecap="round" stroke-linejoin="round" class="lucide lucide-chevron-right stldocs-icon stldocs-expander-summary-icon" aria-hidden="true"><path d="m9 18 6-6-6-6"></path></svg></summary><ul class="stldocs-sidebar-list"><li class="stldocs-sidebar-entry stldocs-sidebar-entry-link"><a href="/api/reference/resources/batches/methods/create" data-stldocs-method="post"><span class="stl-ui-badge stl-ui-badge--size-sm stl-sidebar-icon stl-ui-badge--http stl-ui-badge--http-post" role="img" aria-label="POST"></span>Create a batch</a></li><li class="stldocs-sidebar-entry stldocs-sidebar-entry-link"><a href="/api/reference/resources/batches/methods/retrieve" data-stldocs-method="get"><span class="stl-ui-badge stl-ui-badge--size-sm stl-sidebar-icon stl-ui-badge--http stl-ui-badge--http-get" role="img" aria-label="GET"></span>Retrieve a batch</a></li><li class="stldocs-sidebar-entry stldocs-sidebar-entry-link"><a href="/api/reference/resources/batches/methods/list" data-stldocs-method="get"><span class="stl-ui-badge stl-ui-badge--size-sm stl-sidebar-icon stl-ui-badge--http stl-ui-badge--http-get" role="img" aria-label="GET"></span>List batches</a></li><li class="stldocs-sidebar-entry stldocs-sidebar-entry-link"><a href="/api/reference/resources/batches/methods/cancel" data-stldocs-method="post"><span class="stl-ui-badge stl-ui-badge--size-sm stl-sidebar-icon stl-ui-badge--http stl-ui-badge--http-post" role="img" aria-label="POST"></span>Cancel a batch</a></li></ul></details></li><li class="stldocs-sidebar-entry stldocs-sidebar-entry-group"><details class="stldocs-sidebar-expander"><summary class="stldocs-expander-summary"><span>Files</span><svg xmlns="http://www.w3.org/2000/svg" width="16" height="16" viewBox="0 0 24 24" fill="none" stroke="currentColor" stroke-width="1" stroke-linecap="round" stroke-linejoin="round" class="lucide lucide-chevron-right stldocs-icon stldocs-expander-summary-icon" aria-hidden="true"><path d="m9 18 6-6-6-6"></path></svg></summary><ul class="stldocs-sidebar-list"><li class="stldocs-sidebar-entry stldocs-sidebar-entry-link"><a href="/api/reference/resources/files/methods/list" data-stldocs-method="get"><span class="stl-ui-badge stl-ui-badge--size-sm stl-sidebar-icon stl-ui-badge--http stl-ui-badge--http-get" role="img" aria-label="GET"></span>List files</a></li><li class="stldocs-sidebar-entry stldocs-sidebar-entry-link"><a href="/api/reference/resources/files/methods/create" data-stldocs-method="post"><span class="stl-ui-badge stl-ui-badge--size-sm stl-sidebar-icon stl-ui-badge--http stl-ui-badge--http-post" role="img" aria-label="POST"></span>Create a file</a></li><li class="stldocs-sidebar-entry stldocs-sidebar-entry-link"><a href="/api/reference/resources/files/methods/retrieve" data-stldocs-method="get"><span class="stl-ui-badge stl-ui-badge--size-sm stl-sidebar-icon stl-ui-badge--http stl-ui-badge--http-get" role="img" aria-label="GET"></span>Retrieve a file</a></li><li class="stldocs-sidebar-entry stldocs-sidebar-entry-link"><a href="/api/reference/resources/files/methods/delete" data-stldocs-method="delete"><span class="stl-ui-badge stl-ui-badge--size-sm stl-sidebar-icon stl-ui-badge--http stl-ui-badge--http-delete" role="img" aria-label="DELETE"></span>Delete a file</a></li><li class="stldocs-sidebar-entry stldocs-sidebar-entry-link"><a href="/api/reference/resources/files/methods/content" data-stldocs-method="get"><span class="stl-ui-badge stl-ui-badge--size-sm stl-sidebar-icon stl-ui-badge--http stl-ui-badge--http-get" role="img" aria-label="GET"></span>Retrieve file content</a></li></ul></details></li><li class="stldocs-sidebar-entry stldocs-sidebar-entry-group"><details class="stldocs-sidebar-expander"><summary class="stldocs-expander-summary"><span>Uploads</span><svg xmlns="http://www.w3.org/2000/svg" width="16" height="16" viewBox="0 0 24 24" fill="none" stroke="currentColor" stroke-width="1" stroke-linecap="round" stroke-linejoin="round" class="lucide lucide-chevron-right stldocs-icon stldocs-expander-summary-icon" aria-hidden="true"><path d="m9 18 6-6-6-6"></path></svg></summary><ul class="stldocs-sidebar-list"><li class="stldocs-sidebar-entry stldocs-sidebar-entry-link"><a href="/api/reference/resources/uploads/methods/create" data-stldocs-method="post"><span class="stl-ui-badge stl-ui-badge--size-sm stl-sidebar-icon stl-ui-badge--http stl-ui-badge--http-post" role="img" aria-label="POST"></span>Create an upload</a></li><li class="stldocs-sidebar-entry stldocs-sidebar-entry-link"><a href="/api/reference/resources/uploads/methods/cancel" data-stldocs-method="post"><span class="stl-ui-badge stl-ui-badge--size-sm stl-sidebar-icon stl-ui-badge--http stl-ui-badge--http-post" role="img" aria-label="POST"></span>Cancel an upload</a></li><li class="stldocs-sidebar-entry stldocs-sidebar-entry-link"><a href="/api/reference/resources/uploads/methods/complete" data-stldocs-method="post"><span class="stl-ui-badge stl-ui-badge--size-sm stl-sidebar-icon stl-ui-badge--http stl-ui-badge--http-post" role="img" aria-label="POST"></span>Complete</a></li><li class="stldocs-sidebar-entry stldocs-sidebar-entry-group"><details class="stldocs-sidebar-expander"><summary class="stldocs-expander-summary"><span>Parts</span><svg xmlns="http://www.w3.org/2000/svg" width="16" height="16" viewBox="0 0 24 24" fill="none" stroke="currentColor" stroke-width="1" stroke-linecap="round" stroke-linejoin="round" class="lucide lucide-chevron-right stldocs-icon stldocs-expander-summary-icon" aria-hidden="true"><path d="m9 18 6-6-6-6"></path></svg></summary><ul class="stldocs-sidebar-list"><li class="stldocs-sidebar-entry stldocs-sidebar-entry-link"><a href="/api/reference/resources/uploads/subresources/parts/methods/create" data-stldocs-method="post"><span class="stl-ui-badge stl-ui-badge--size-sm stl-sidebar-icon stl-ui-badge--http stl-ui-badge--http-post" role="img" aria-label="POST"></span>Create a part</a></li></ul></details></li></ul></details></li><li class="stldocs-sidebar-entry stldocs-sidebar-entry-group"><details class="stldocs-sidebar-expander"><summary class="stldocs-expander-summary"><span>Models</span><svg xmlns="http://www.w3.org/2000/svg" width="16" height="16" viewBox="0 0 24 24" fill="none" stroke="currentColor" stroke-width="1" stroke-linecap="round" stroke-linejoin="round" class="lucide lucide-chevron-right stldocs-icon stldocs-expander-summary-icon" aria-hidden="true"><path d="m9 18 6-6-6-6"></path></svg></summary><ul class="stldocs-sidebar-list"><li class="stldocs-sidebar-entry stldocs-sidebar-entry-link"><a href="/api/reference/resources/models/methods/retrieve" data-stldocs-method="get"><span class="stl-ui-badge stl-ui-badge--size-sm stl-sidebar-icon stl-ui-badge--http stl-ui-badge--http-get" role="img" aria-label="GET"></span>Retrieve a model</a></li><li class="stldocs-sidebar-entry stldocs-sidebar-entry-link"><a href="/api/reference/resources/models/methods/delete" data-stldocs-method="delete"><span class="stl-ui-badge stl-ui-badge--size-sm stl-sidebar-icon stl-ui-badge--http stl-ui-badge--http-delete" role="img" aria-label="DELETE"></span>Delete a model</a></li><li class="stldocs-sidebar-entry stldocs-sidebar-entry-link"><a href="/api/reference/resources/models/methods/list" data-stldocs-method="get"><span class="stl-ui-badge stl-ui-badge--size-sm stl-sidebar-icon stl-ui-badge--http stl-ui-badge--http-get" role="img" aria-label="GET"></span>List models</a></li></ul></details></li><li class="stldocs-sidebar-entry stldocs-sidebar-entry-group"><details class="stldocs-sidebar-expander"><summary class="stldocs-expander-summary"><span>Moderations</span><svg xmlns="http://www.w3.org/2000/svg" width="16" height="16" viewBox="0 0 24 24" fill="none" stroke="currentColor" stroke-width="1" stroke-linecap="round" stroke-linejoin="round" class="lucide lucide-chevron-right stldocs-icon stldocs-expander-summary-icon" aria-hidden="true"><path d="m9 18 6-6-6-6"></path></svg></summary><ul class="stldocs-sidebar-list"><li class="stldocs-sidebar-entry stldocs-sidebar-entry-link"><a href="/api/reference/resources/moderations/methods/create" data-stldocs-method="post"><span class="stl-ui-badge stl-ui-badge--size-sm stl-sidebar-icon stl-ui-badge--http stl-ui-badge--http-post" role="img" aria-label="POST"></span>Create a moderation</a></li></ul></details></li><li class="stldocs-sidebar-entry stldocs-sidebar-entry-group"><details class="stldocs-sidebar-expander"><summary class="stldocs-expander-summary"><span>Content Provenance Checks</span><svg xmlns="http://www.w3.org/2000/svg" width="16" height="16" viewBox="0 0 24 24" fill="none" stroke="currentColor" stroke-width="1" stroke-linecap="round" stroke-linejoin="round" class="lucide lucide-chevron-right stldocs-icon stldocs-expander-summary-icon" aria-hidden="true"><path d="m9 18 6-6-6-6"></path></svg></summary><ul class="stldocs-sidebar-list"><li class="stldocs-sidebar-entry stldocs-sidebar-entry-link"><a href="/api/reference/resources/content_provenance_checks/methods/create" data-stldocs-method="post"><span class="stl-ui-badge stl-ui-badge--size-sm stl-sidebar-icon stl-ui-badge--http stl-ui-badge--http-post" role="img" aria-label="POST"></span>Create a content provenance check</a></li></ul></details></li></ul></div></li><li class="stldocs-sidebar-entry stldocs-sidebar-entry-group"><div class="stldocs-sidebar-expander"><div class="stldocs-expander-summary"><span>Vector Stores</span></div><ul class="stldocs-sidebar-list"><li class="stldocs-sidebar-entry stldocs-sidebar-entry-group"><details class="stldocs-sidebar-expander"><summary class="stldocs-expander-summary"><span>Vector Stores</span><svg xmlns="http://www.w3.org/2000/svg" width="16" height="16" viewBox="0 0 24 24" fill="none" stroke="currentColor" stroke-width="1" stroke-linecap="round" stroke-linejoin="round" class="lucide lucide-chevron-right stldocs-icon stldocs-expander-summary-icon" aria-hidden="true"><path d="m9 18 6-6-6-6"></path></svg></summary><ul class="stldocs-sidebar-list"><li class="stldocs-sidebar-entry stldocs-sidebar-entry-link"><a href="/api/reference/resources/vector_stores/methods/create" data-stldocs-method="post"><span class="stl-ui-badge stl-ui-badge--size-sm stl-sidebar-icon stl-ui-badge--http stl-ui-badge--http-post" role="img" aria-label="POST"></span>Create a vector store</a></li><li class="stldocs-sidebar-entry stldocs-sidebar-entry-link"><a href="/api/reference/resources/vector_stores/methods/retrieve" data-stldocs-method="get"><span class="stl-ui-badge stl-ui-badge--size-sm stl-sidebar-icon stl-ui-badge--http stl-ui-badge--http-get" role="img" aria-label="GET"></span>Retrieve a vector store</a></li><li class="stldocs-sidebar-entry stldocs-sidebar-entry-link"><a href="/api/reference/resources/vector_stores/methods/update" data-stldocs-method="post"><span class="stl-ui-badge stl-ui-badge--size-sm stl-sidebar-icon stl-ui-badge--http stl-ui-badge--http-post" role="img" aria-label="POST"></span>Update a vector store</a></li><li class="stldocs-sidebar-entry stldocs-sidebar-entry-link"><a href="/api/reference/resources/vector_stores/methods/delete" data-stldocs-method="delete"><span class="stl-ui-badge stl-ui-badge--size-sm stl-sidebar-icon stl-ui-badge--http stl-ui-badge--http-delete" role="img" aria-label="DELETE"></span>Delete a vector store</a></li><li class="stldocs-sidebar-entry stldocs-sidebar-entry-link"><a href="/api/reference/resources/vector_stores/methods/list" data-stldocs-method="get"><span class="stl-ui-badge stl-ui-badge--size-sm stl-sidebar-icon stl-ui-badge--http stl-ui-badge--http-get" role="img" aria-label="GET"></span>List vector stores</a></li><li class="stldocs-sidebar-entry stldocs-sidebar-entry-link"><a href="/api/reference/resources/vector_stores/methods/search" data-stldocs-method="post"><span class="stl-ui-badge stl-ui-badge--size-sm stl-sidebar-icon stl-ui-badge--http stl-ui-badge--http-post" role="img" aria-label="POST"></span>Search</a></li></ul></details></li><li class="stldocs-sidebar-entry stldocs-sidebar-entry-group"><details class="stldocs-sidebar-expander"><summary class="stldocs-expander-summary"><span>File Batches</span><svg xmlns="http://www.w3.org/2000/svg" width="16" height="16" viewBox="0 0 24 24" fill="none" stroke="currentColor" stroke-width="1" stroke-linecap="round" stroke-linejoin="round" class="lucide lucide-chevron-right stldocs-icon stldocs-expander-summary-icon" aria-hidden="true"><path d="m9 18 6-6-6-6"></path></svg></summary><ul class="stldocs-sidebar-list"><li class="stldocs-sidebar-entry stldocs-sidebar-entry-link"><a href="/api/reference/resources/vector_stores/subresources/file_batches/methods/create" data-stldocs-method="post"><span class="stl-ui-badge stl-ui-badge--size-sm stl-sidebar-icon stl-ui-badge--http stl-ui-badge--http-post" role="img" aria-label="POST"></span>Create a file batch</a></li><li class="stldocs-sidebar-entry stldocs-sidebar-entry-link"><a href="/api/reference/resources/vector_stores/subresources/file_batches/methods/retrieve" data-stldocs-method="get"><span class="stl-ui-badge stl-ui-badge--size-sm stl-sidebar-icon stl-ui-badge--http stl-ui-badge--http-get" role="img" aria-label="GET"></span>Retrieve a file batch</a></li><li class="stldocs-sidebar-entry stldocs-sidebar-entry-link"><a href="/api/reference/resources/vector_stores/subresources/file_batches/methods/list_files" data-stldocs-method="get"><span class="stl-ui-badge stl-ui-badge--size-sm stl-sidebar-icon stl-ui-badge--http stl-ui-badge--http-get" role="img" aria-label="GET"></span>List Files</a></li><li class="stldocs-sidebar-entry stldocs-sidebar-entry-link"><a href="/api/reference/resources/vector_stores/subresources/file_batches/methods/cancel" data-stldocs-method="post"><span class="stl-ui-badge stl-ui-badge--size-sm stl-sidebar-icon stl-ui-badge--http stl-ui-badge--http-post" role="img" aria-label="POST"></span>Cancel a file batch</a></li></ul></details></li><li class="stldocs-sidebar-entry stldocs-sidebar-entry-group"><details class="stldocs-sidebar-expander"><summary class="stldocs-expander-summary"><span>Files</span><svg xmlns="http://www.w3.org/2000/svg" width="16" height="16" viewBox="0 0 24 24" fill="none" stroke="currentColor" stroke-width="1" stroke-linecap="round" stroke-linejoin="round" class="lucide lucide-chevron-right stldocs-icon stldocs-expander-summary-icon" aria-hidden="true"><path d="m9 18 6-6-6-6"></path></svg></summary><ul class="stldocs-sidebar-list"><li class="stldocs-sidebar-entry stldocs-sidebar-entry-link"><a href="/api/reference/resources/vector_stores/subresources/files/methods/list" data-stldocs-method="get"><span class="stl-ui-badge stl-ui-badge--size-sm stl-sidebar-icon stl-ui-badge--http stl-ui-badge--http-get" role="img" aria-label="GET"></span>List files</a></li><li class="stldocs-sidebar-entry stldocs-sidebar-entry-link"><a href="/api/reference/resources/vector_stores/subresources/files/methods/create" data-stldocs-method="post"><span class="stl-ui-badge stl-ui-badge--size-sm stl-sidebar-icon stl-ui-badge--http stl-ui-badge--http-post" role="img" aria-label="POST"></span>Create a file</a></li><li class="stldocs-sidebar-entry stldocs-sidebar-entry-link"><a href="/api/reference/resources/vector_stores/subresources/files/methods/retrieve" data-stldocs-method="get"><span class="stl-ui-badge stl-ui-badge--size-sm stl-sidebar-icon stl-ui-badge--http stl-ui-badge--http-get" role="img" aria-label="GET"></span>Retrieve a file</a></li><li class="stldocs-sidebar-entry stldocs-sidebar-entry-link"><a href="/api/reference/resources/vector_stores/subresources/files/methods/update" data-stldocs-method="post"><span class="stl-ui-badge stl-ui-badge--size-sm stl-sidebar-icon stl-ui-badge--http stl-ui-badge--http-post" role="img" aria-label="POST"></span>Update a file</a></li><li class="stldocs-sidebar-entry stldocs-sidebar-entry-link"><a href="/api/reference/resources/vector_stores/subresources/files/methods/delete" data-stldocs-method="delete"><span class="stl-ui-badge stl-ui-badge--size-sm stl-sidebar-icon stl-ui-badge--http stl-ui-badge--http-delete" role="img" aria-label="DELETE"></span>Delete a file</a></li><li class="stldocs-sidebar-entry stldocs-sidebar-entry-link"><a href="/api/reference/resources/vector_stores/subresources/files/methods/content" data-stldocs-method="get"><span class="stl-ui-badge stl-ui-badge--size-sm stl-sidebar-icon stl-ui-badge--http stl-ui-badge--http-get" role="img" aria-label="GET"></span>Retrieve file content</a></li></ul></details></li></ul></div></li><li class="stldocs-sidebar-entry stldocs-sidebar-entry-group"><div class="stldocs-sidebar-expander"><div class="stldocs-expander-summary"><span>ChatKit</span></div><ul class="stldocs-sidebar-list"><li class="stldocs-sidebar-entry stldocs-sidebar-entry-group"><details class="stldocs-sidebar-expander"><summary class="stldocs-expander-summary"><span>Sessions</span><svg xmlns="http://www.w3.org/2000/svg" width="16" height="16" viewBox="0 0 24 24" fill="none" stroke="currentColor" stroke-width="1" stroke-linecap="round" stroke-linejoin="round" class="lucide lucide-chevron-right stldocs-icon stldocs-expander-summary-icon" aria-hidden="true"><path d="m9 18 6-6-6-6"></path></svg></summary><ul class="stldocs-sidebar-list"><li class="stldocs-sidebar-entry stldocs-sidebar-entry-link"><a href="/api/reference/resources/beta/subresources/chatkit/subresources/sessions/methods/create" data-stldocs-method="post"><span class="stl-ui-badge stl-ui-badge--size-sm stl-sidebar-icon stl-ui-badge--http stl-ui-badge--http-post" role="img" aria-label="POST"></span>Create a session</a></li><li class="stldocs-sidebar-entry stldocs-sidebar-entry-link"><a href="/api/reference/resources/beta/subresources/chatkit/subresources/sessions/methods/cancel" data-stldocs-method="post"><span class="stl-ui-badge stl-ui-badge--size-sm stl-sidebar-icon stl-ui-badge--http stl-ui-badge--http-post" role="img" aria-label="POST"></span>Cancel a session</a></li></ul></details></li><li class="stldocs-sidebar-entry stldocs-sidebar-entry-group"><details class="stldocs-sidebar-expander"><summary class="stldocs-expander-summary"><span>Threads</span><svg xmlns="http://www.w3.org/2000/svg" width="16" height="16" viewBox="0 0 24 24" fill="none" stroke="currentColor" stroke-width="1" stroke-linecap="round" stroke-linejoin="round" class="lucide lucide-chevron-right stldocs-icon stldocs-expander-summary-icon" aria-hidden="true"><path d="m9 18 6-6-6-6"></path></svg></summary><ul class="stldocs-sidebar-list"><li class="stldocs-sidebar-entry stldocs-sidebar-entry-link"><a href="/api/reference/resources/beta/subresources/chatkit/subresources/threads/methods/retrieve" data-stldocs-method="get"><span class="stl-ui-badge stl-ui-badge--size-sm stl-sidebar-icon stl-ui-badge--http stl-ui-badge--http-get" role="img" aria-label="GET"></span>Retrieve a thread</a></li><li class="stldocs-sidebar-entry stldocs-sidebar-entry-link"><a href="/api/reference/resources/beta/subresources/chatkit/subresources/threads/methods/delete" data-stldocs-method="delete"><span class="stl-ui-badge stl-ui-badge--size-sm stl-sidebar-icon stl-ui-badge--http stl-ui-badge--http-delete" role="img" aria-label="DELETE"></span>Delete a thread</a></li><li class="stldocs-sidebar-entry stldocs-sidebar-entry-link"><a href="/api/reference/resources/beta/subresources/chatkit/subresources/threads/methods/list" data-stldocs-method="get"><span class="stl-ui-badge stl-ui-badge--size-sm stl-sidebar-icon stl-ui-badge--http stl-ui-badge--http-get" role="img" aria-label="GET"></span>List threads</a></li><li class="stldocs-sidebar-entry stldocs-sidebar-entry-link"><a href="/api/reference/resources/beta/subresources/chatkit/subresources/threads/methods/list_items" data-stldocs-method="get"><span class="stl-ui-badge stl-ui-badge--size-sm stl-sidebar-icon stl-ui-badge--http stl-ui-badge--http-get" role="img" aria-label="GET"></span>List Items</a></li></ul></details></li></ul></div></li><li class="stldocs-sidebar-entry stldocs-sidebar-entry-group"><div class="stldocs-sidebar-expander"><div class="stldocs-expander-summary"><span>Containers</span></div><ul class="stldocs-sidebar-list"><li class="stldocs-sidebar-entry stldocs-sidebar-entry-group"><details class="stldocs-sidebar-expander"><summary class="stldocs-expander-summary"><span>Containers</span><svg xmlns="http://www.w3.org/2000/svg" width="16" height="16" viewBox="0 0 24 24" fill="none" stroke="currentColor" stroke-width="1" stroke-linecap="round" stroke-linejoin="round" class="lucide lucide-chevron-right stldocs-icon stldocs-expander-summary-icon" aria-hidden="true"><path d="m9 18 6-6-6-6"></path></svg></summary><ul class="stldocs-sidebar-list"><li class="stldocs-sidebar-entry stldocs-sidebar-entry-link"><a href="/api/reference/resources/containers/methods/create" data-stldocs-method="post"><span class="stl-ui-badge stl-ui-badge--size-sm stl-sidebar-icon stl-ui-badge--http stl-ui-badge--http-post" role="img" aria-label="POST"></span>Create a container</a></li><li class="stldocs-sidebar-entry stldocs-sidebar-entry-link"><a href="/api/reference/resources/containers/methods/retrieve" data-stldocs-method="get"><span class="stl-ui-badge stl-ui-badge--size-sm stl-sidebar-icon stl-ui-badge--http stl-ui-badge--http-get" role="img" aria-label="GET"></span>Retrieve a container</a></li><li class="stldocs-sidebar-entry stldocs-sidebar-entry-link"><a href="/api/reference/resources/containers/methods/delete" data-stldocs-method="delete"><span class="stl-ui-badge stl-ui-badge--size-sm stl-sidebar-icon stl-ui-badge--http stl-ui-badge--http-delete" role="img" aria-label="DELETE"></span>Delete a container</a></li><li class="stldocs-sidebar-entry stldocs-sidebar-entry-link"><a href="/api/reference/resources/containers/methods/list" data-stldocs-method="get"><span class="stl-ui-badge stl-ui-badge--size-sm stl-sidebar-icon stl-ui-badge--http stl-ui-badge--http-get" role="img" aria-label="GET"></span>List containers</a></li></ul></details></li><li class="stldocs-sidebar-entry stldocs-sidebar-entry-group"><details class="stldocs-sidebar-expander"><summary class="stldocs-expander-summary"><span>Files</span><svg xmlns="http://www.w3.org/2000/svg" width="16" height="16" viewBox="0 0 24 24" fill="none" stroke="currentColor" stroke-width="1" stroke-linecap="round" stroke-linejoin="round" class="lucide lucide-chevron-right stldocs-icon stldocs-expander-summary-icon" aria-hidden="true"><path d="m9 18 6-6-6-6"></path></svg></summary><ul class="stldocs-sidebar-list"><li class="stldocs-sidebar-entry stldocs-sidebar-entry-link"><a href="/api/reference/resources/containers/subresources/files/methods/list" data-stldocs-method="get"><span class="stl-ui-badge stl-ui-badge--size-sm stl-sidebar-icon stl-ui-badge--http stl-ui-badge--http-get" role="img" aria-label="GET"></span>List files</a></li><li class="stldocs-sidebar-entry stldocs-sidebar-entry-link"><a href="/api/reference/resources/containers/subresources/files/methods/create" data-stldocs-method="post"><span class="stl-ui-badge stl-ui-badge--size-sm stl-sidebar-icon stl-ui-badge--http stl-ui-badge--http-post" role="img" aria-label="POST"></span>Create a file</a></li><li class="stldocs-sidebar-entry stldocs-sidebar-entry-link"><a href="/api/reference/resources/containers/subresources/files/methods/retrieve" data-stldocs-method="get"><span class="stl-ui-badge stl-ui-badge--size-sm stl-sidebar-icon stl-ui-badge--http stl-ui-badge--http-get" role="img" aria-label="GET"></span>Retrieve a file</a></li><li class="stldocs-sidebar-entry stldocs-sidebar-entry-link"><a href="/api/reference/resources/containers/subresources/files/methods/delete" data-stldocs-method="delete"><span class="stl-ui-badge stl-ui-badge--size-sm stl-sidebar-icon stl-ui-badge--http stl-ui-badge--http-delete" role="img" aria-label="DELETE"></span>Delete a file</a></li><li class="stldocs-sidebar-entry stldocs-sidebar-entry-group"><details class="stldocs-sidebar-expander"><summary class="stldocs-expander-summary"><span>Content</span><svg xmlns="http://www.w3.org/2000/svg" width="16" height="16" viewBox="0 0 24 24" fill="none" stroke="currentColor" stroke-width="1" stroke-linecap="round" stroke-linejoin="round" class="lucide lucide-chevron-right stldocs-icon stldocs-expander-summary-icon" aria-hidden="true"><path d="m9 18 6-6-6-6"></path></svg></summary><ul class="stldocs-sidebar-list"><li class="stldocs-sidebar-entry stldocs-sidebar-entry-link"><a href="/api/reference/resources/containers/subresources/files/subresources/content/methods/retrieve" data-stldocs-method="get"><span class="stl-ui-badge stl-ui-badge--size-sm stl-sidebar-icon stl-ui-badge--http stl-ui-badge--http-get" role="img" aria-label="GET"></span>Retrieve a content</a></li></ul></details></li></ul></details></li></ul></div></li><li class="stldocs-sidebar-entry stldocs-sidebar-entry-group"><div class="stldocs-sidebar-expander"><div class="stldocs-expander-summary"><span>Skills</span></div><ul class="stldocs-sidebar-list"><li class="stldocs-sidebar-entry stldocs-sidebar-entry-group"><details class="stldocs-sidebar-expander"><summary class="stldocs-expander-summary"><span>Skills</span><svg xmlns="http://www.w3.org/2000/svg" width="16" height="16" viewBox="0 0 24 24" fill="none" stroke="currentColor" stroke-width="1" stroke-linecap="round" stroke-linejoin="round" class="lucide lucide-chevron-right stldocs-icon stldocs-expander-summary-icon" aria-hidden="true"><path d="m9 18 6-6-6-6"></path></svg></summary><ul class="stldocs-sidebar-list"><li class="stldocs-sidebar-entry stldocs-sidebar-entry-link"><a href="/api/reference/resources/skills/methods/create" data-stldocs-method="post"><span class="stl-ui-badge stl-ui-badge--size-sm stl-sidebar-icon stl-ui-badge--http stl-ui-badge--http-post" role="img" aria-label="POST"></span>Create a skill</a></li><li class="stldocs-sidebar-entry stldocs-sidebar-entry-link"><a href="/api/reference/resources/skills/methods/retrieve" data-stldocs-method="get"><span class="stl-ui-badge stl-ui-badge--size-sm stl-sidebar-icon stl-ui-badge--http stl-ui-badge--http-get" role="img" aria-label="GET"></span>Retrieve a skill</a></li><li class="stldocs-sidebar-entry stldocs-sidebar-entry-link"><a href="/api/reference/resources/skills/subresources/content/methods/retrieve" data-stldocs-method="get"><span class="stl-ui-badge stl-ui-badge--size-sm stl-sidebar-icon stl-ui-badge--http stl-ui-badge--http-get" role="img" aria-label="GET"></span>Retrieve skill content</a></li><li class="stldocs-sidebar-entry stldocs-sidebar-entry-link"><a href="/api/reference/resources/skills/methods/update" data-stldocs-method="post"><span class="stl-ui-badge stl-ui-badge--size-sm stl-sidebar-icon stl-ui-badge--http stl-ui-badge--http-post" role="img" aria-label="POST"></span>Update a skill</a></li><li class="stldocs-sidebar-entry stldocs-sidebar-entry-link"><a href="/api/reference/resources/skills/methods/delete" data-stldocs-method="delete"><span class="stl-ui-badge stl-ui-badge--size-sm stl-sidebar-icon stl-ui-badge--http stl-ui-badge--http-delete" role="img" aria-label="DELETE"></span>Delete a skill</a></li><li class="stldocs-sidebar-entry stldocs-sidebar-entry-link"><a href="/api/reference/resources/skills/methods/list" data-stldocs-method="get"><span class="stl-ui-badge stl-ui-badge--size-sm stl-sidebar-icon stl-ui-badge--http stl-ui-badge--http-get" role="img" aria-label="GET"></span>List skills</a></li><li class="stldocs-sidebar-entry stldocs-sidebar-entry-group"><details class="stldocs-sidebar-expander"><summary class="stldocs-expander-summary"><span>Versions</span><svg xmlns="http://www.w3.org/2000/svg" width="16" height="16" viewBox="0 0 24 24" fill="none" stroke="currentColor" stroke-width="1" stroke-linecap="round" stroke-linejoin="round" class="lucide lucide-chevron-right stldocs-icon stldocs-expander-summary-icon" aria-hidden="true"><path d="m9 18 6-6-6-6"></path></svg></summary><ul class="stldocs-sidebar-list"><li class="stldocs-sidebar-entry stldocs-sidebar-entry-link"><a href="/api/reference/resources/skills/subresources/versions/methods/create" data-stldocs-method="post"><span class="stl-ui-badge stl-ui-badge--size-sm stl-sidebar-icon stl-ui-badge--http stl-ui-badge--http-post" role="img" aria-label="POST"></span>Create skill version</a></li><li class="stldocs-sidebar-entry stldocs-sidebar-entry-link"><a href="/api/reference/resources/skills/subresources/versions/methods/retrieve" data-stldocs-method="get"><span class="stl-ui-badge stl-ui-badge--size-sm stl-sidebar-icon stl-ui-badge--http stl-ui-badge--http-get" role="img" aria-label="GET"></span>Retrieve skill version</a></li><li class="stldocs-sidebar-entry stldocs-sidebar-entry-link"><a href="/api/reference/resources/skills/subresources/versions/subresources/content/methods/retrieve" data-stldocs-method="get"><span class="stl-ui-badge stl-ui-badge--size-sm stl-sidebar-icon stl-ui-badge--http stl-ui-badge--http-get" role="img" aria-label="GET"></span>Retrieve Skill Version Content</a></li><li class="stldocs-sidebar-entry stldocs-sidebar-entry-link"><a href="/api/reference/resources/skills/subresources/versions/methods/delete" data-stldocs-method="delete"><span class="stl-ui-badge stl-ui-badge--size-sm stl-sidebar-icon stl-ui-badge--http stl-ui-badge--http-delete" role="img" aria-label="DELETE"></span>Delete skill version</a></li><li class="stldocs-sidebar-entry stldocs-sidebar-entry-link"><a href="/api/reference/resources/skills/subresources/versions/methods/list" data-stldocs-method="get"><span class="stl-ui-badge stl-ui-badge--size-sm stl-sidebar-icon stl-ui-badge--http stl-ui-badge--http-get" role="img" aria-label="GET"></span>List skill versions</a></li></ul></details></li></ul></details></li></ul></div></li><li class="stldocs-sidebar-entry stldocs-sidebar-entry-group"><div class="stldocs-sidebar-expander"><div class="stldocs-expander-summary"><span>Realtime</span></div><ul class="stldocs-sidebar-list"><li class="stldocs-sidebar-entry stldocs-sidebar-entry-group"><details class="stldocs-sidebar-expander"><summary class="stldocs-expander-summary"><span>Translations</span><svg xmlns="http://www.w3.org/2000/svg" width="16" height="16" viewBox="0 0 24 24" fill="none" stroke="currentColor" stroke-width="1" stroke-linecap="round" stroke-linejoin="round" class="lucide lucide-chevron-right stldocs-icon stldocs-expander-summary-icon" aria-hidden="true"><path d="m9 18 6-6-6-6"></path></svg></summary><ul class="stldocs-sidebar-list"><li class="stldocs-sidebar-entry stldocs-sidebar-entry-group"><details class="stldocs-sidebar-expander"><summary class="stldocs-expander-summary"><span>Client Secrets</span><svg xmlns="http://www.w3.org/2000/svg" width="16" height="16" viewBox="0 0 24 24" fill="none" stroke="currentColor" stroke-width="1" stroke-linecap="round" stroke-linejoin="round" class="lucide lucide-chevron-right stldocs-icon stldocs-expander-summary-icon" aria-hidden="true"><path d="m9 18 6-6-6-6"></path></svg></summary><ul class="stldocs-sidebar-list"><li class="stldocs-sidebar-entry stldocs-sidebar-entry-link"><a href="/api/reference/resources/realtime/subresources/translations/subresources/client_secrets/methods/create" data-stldocs-method="post"><span class="stl-ui-badge stl-ui-badge--size-sm stl-sidebar-icon stl-ui-badge--http stl-ui-badge--http-post" role="img" aria-label="POST"></span>Create a client secret</a></li></ul></details></li><li class="stldocs-sidebar-entry stldocs-sidebar-entry-link"><a href="/api/reference/resources/realtime/translation-client-events">Translation client events</a></li><li class="stldocs-sidebar-entry stldocs-sidebar-entry-link"><a href="/api/reference/resources/realtime/translation-server-events">Translation server events</a></li></ul></details></li><li class="stldocs-sidebar-entry stldocs-sidebar-entry-group"><details class="stldocs-sidebar-expander"><summary class="stldocs-expander-summary"><span>Client Secrets</span><svg xmlns="http://www.w3.org/2000/svg" width="16" height="16" viewBox="0 0 24 24" fill="none" stroke="currentColor" stroke-width="1" stroke-linecap="round" stroke-linejoin="round" class="lucide lucide-chevron-right stldocs-icon stldocs-expander-summary-icon" aria-hidden="true"><path d="m9 18 6-6-6-6"></path></svg></summary><ul class="stldocs-sidebar-list"><li class="stldocs-sidebar-entry stldocs-sidebar-entry-link"><a href="/api/reference/resources/realtime/subresources/client_secrets/methods/create" data-stldocs-method="post"><span class="stl-ui-badge stl-ui-badge--size-sm stl-sidebar-icon stl-ui-badge--http stl-ui-badge--http-post" role="img" aria-label="POST"></span>Create a client secret</a></li></ul></details></li><li class="stldocs-sidebar-entry stldocs-sidebar-entry-group"><details class="stldocs-sidebar-expander"><summary class="stldocs-expander-summary"><span>Calls</span><svg xmlns="http://www.w3.org/2000/svg" width="16" height="16" viewBox="0 0 24 24" fill="none" stroke="currentColor" stroke-width="1" stroke-linecap="round" stroke-linejoin="round" class="lucide lucide-chevron-right stldocs-icon stldocs-expander-summary-icon" aria-hidden="true"><path d="m9 18 6-6-6-6"></path></svg></summary><ul class="stldocs-sidebar-list"><li class="stldocs-sidebar-entry stldocs-sidebar-entry-link"><a href="/api/reference/resources/realtime/subresources/calls/methods/accept" data-stldocs-method="post"><span class="stl-ui-badge stl-ui-badge--size-sm stl-sidebar-icon stl-ui-badge--http stl-ui-badge--http-post" role="img" aria-label="POST"></span>Accept</a></li><li class="stldocs-sidebar-entry stldocs-sidebar-entry-link"><a href="/api/reference/resources/realtime/subresources/calls/methods/hangup" data-stldocs-method="post"><span class="stl-ui-badge stl-ui-badge--size-sm stl-sidebar-icon stl-ui-badge--http stl-ui-badge--http-post" role="img" aria-label="POST"></span>Hangup</a></li><li class="stldocs-sidebar-entry stldocs-sidebar-entry-link"><a href="/api/reference/resources/realtime/subresources/calls/methods/refer" data-stldocs-method="post"><span class="stl-ui-badge stl-ui-badge--size-sm stl-sidebar-icon stl-ui-badge--http stl-ui-badge--http-post" role="img" aria-label="POST"></span>Refer</a></li><li class="stldocs-sidebar-entry stldocs-sidebar-entry-link"><a href="/api/reference/resources/realtime/subresources/calls/methods/reject" data-stldocs-method="post"><span class="stl-ui-badge stl-ui-badge--size-sm stl-sidebar-icon stl-ui-badge--http stl-ui-badge--http-post" role="img" aria-label="POST"></span>Reject</a></li></ul></details></li><li class="stldocs-sidebar-entry stldocs-sidebar-entry-link"><a href="/api/reference/resources/realtime/client-events">Client events</a></li><li class="stldocs-sidebar-entry stldocs-sidebar-entry-link"><a href="/api/reference/resources/realtime/server-events">Server events</a></li></ul></div></li><li class="stldocs-sidebar-entry stldocs-sidebar-entry-group"><div class="stldocs-sidebar-expander"><div class="stldocs-expander-summary"><span>Administration</span></div><ul class="stldocs-sidebar-list"><li class="stldocs-sidebar-entry stldocs-sidebar-entry-link"><a href="/api/reference/administration/overview">Overview</a></li><li class="stldocs-sidebar-entry stldocs-sidebar-entry-group"><details class="stldocs-sidebar-expander"><summary class="stldocs-expander-summary"><span>Admin API Keys</span><svg xmlns="http://www.w3.org/2000/svg" width="16" height="16" viewBox="0 0 24 24" fill="none" stroke="currentColor" stroke-width="1" stroke-linecap="round" stroke-linejoin="round" class="lucide lucide-chevron-right stldocs-icon stldocs-expander-summary-icon" aria-hidden="true"><path d="m9 18 6-6-6-6"></path></svg></summary><ul class="stldocs-sidebar-list"><li class="stldocs-sidebar-entry stldocs-sidebar-entry-link"><a href="/api/reference/resources/admin/subresources/organization/subresources/admin_api_keys/methods/create" data-stldocs-method="post"><span class="stl-ui-badge stl-ui-badge--size-sm stl-sidebar-icon stl-ui-badge--http stl-ui-badge--http-post" role="img" aria-label="POST"></span>Create an admin API key</a></li><li class="stldocs-sidebar-entry stldocs-sidebar-entry-link"><a href="/api/reference/resources/admin/subresources/organization/subresources/admin_api_keys/methods/retrieve" data-stldocs-method="get"><span class="stl-ui-badge stl-ui-badge--size-sm stl-sidebar-icon stl-ui-badge--http stl-ui-badge--http-get" role="img" aria-label="GET"></span>Retrieve an admin API key</a></li><li class="stldocs-sidebar-entry stldocs-sidebar-entry-link"><a href="/api/reference/resources/admin/subresources/organization/subresources/admin_api_keys/methods/delete" data-stldocs-method="delete"><span class="stl-ui-badge stl-ui-badge--size-sm stl-sidebar-icon stl-ui-badge--http stl-ui-badge--http-delete" role="img" aria-label="DELETE"></span>Delete an admin API key</a></li><li class="stldocs-sidebar-entry stldocs-sidebar-entry-link"><a href="/api/reference/resources/admin/subresources/organization/subresources/admin_api_keys/methods/list" data-stldocs-method="get"><span class="stl-ui-badge stl-ui-badge--size-sm stl-sidebar-icon stl-ui-badge--http stl-ui-badge--http-get" role="img" aria-label="GET"></span>List admin API keys</a></li></ul></details></li><li class="stldocs-sidebar-entry stldocs-sidebar-entry-group"><details class="stldocs-sidebar-expander"><summary class="stldocs-expander-summary"><span>Audit Logs</span><svg xmlns="http://www.w3.org/2000/svg" width="16" height="16" viewBox="0 0 24 24" fill="none" stroke="currentColor" stroke-width="1" stroke-linecap="round" stroke-linejoin="round" class="lucide lucide-chevron-right stldocs-icon stldocs-expander-summary-icon" aria-hidden="true"><path d="m9 18 6-6-6-6"></path></svg></summary><ul class="stldocs-sidebar-list"><li class="stldocs-sidebar-entry stldocs-sidebar-entry-link"><a href="/api/reference/resources/admin/subresources/organization/subresources/audit_logs/methods/list" data-stldocs-method="get"><span class="stl-ui-badge stl-ui-badge--size-sm stl-sidebar-icon stl-ui-badge--http stl-ui-badge--http-get" role="img" aria-label="GET"></span>List audit logs</a></li></ul></details></li><li class="stldocs-sidebar-entry stldocs-sidebar-entry-group"><details class="stldocs-sidebar-expander"><summary class="stldocs-expander-summary"><span>Certificates</span><svg xmlns="http://www.w3.org/2000/svg" width="16" height="16" viewBox="0 0 24 24" fill="none" stroke="currentColor" stroke-width="1" stroke-linecap="round" stroke-linejoin="round" class="lucide lucide-chevron-right stldocs-icon stldocs-expander-summary-icon" aria-hidden="true"><path d="m9 18 6-6-6-6"></path></svg></summary><ul class="stldocs-sidebar-list"><li class="stldocs-sidebar-entry stldocs-sidebar-entry-link"><a href="/api/reference/resources/admin/subresources/organization/subresources/certificates/methods/create" data-stldocs-method="post"><span class="stl-ui-badge stl-ui-badge--size-sm stl-sidebar-icon stl-ui-badge--http stl-ui-badge--http-post" role="img" aria-label="POST"></span>Create a certificate</a></li><li class="stldocs-sidebar-entry stldocs-sidebar-entry-link"><a href="/api/reference/resources/admin/subresources/organization/subresources/certificates/methods/retrieve" data-stldocs-method="get"><span class="stl-ui-badge stl-ui-badge--size-sm stl-sidebar-icon stl-ui-badge--http stl-ui-badge--http-get" role="img" aria-label="GET"></span>Retrieve a certificate</a></li><li class="stldocs-sidebar-entry stldocs-sidebar-entry-link"><a href="/api/reference/resources/admin/subresources/organization/subresources/certificates/methods/update" data-stldocs-method="post"><span class="stl-ui-badge stl-ui-badge--size-sm stl-sidebar-icon stl-ui-badge--http stl-ui-badge--http-post" role="img" aria-label="POST"></span>Update a certificate</a></li><li class="stldocs-sidebar-entry stldocs-sidebar-entry-link"><a href="/api/reference/resources/admin/subresources/organization/subresources/certificates/methods/delete" data-stldocs-method="delete"><span class="stl-ui-badge stl-ui-badge--size-sm stl-sidebar-icon stl-ui-badge--http stl-ui-badge--http-delete" role="img" aria-label="DELETE"></span>Delete a certificate</a></li><li class="stldocs-sidebar-entry stldocs-sidebar-entry-link"><a href="/api/reference/resources/admin/subresources/organization/subresources/certificates/methods/list" data-stldocs-method="get"><span class="stl-ui-badge stl-ui-badge--size-sm stl-sidebar-icon stl-ui-badge--http stl-ui-badge--http-get" role="img" aria-label="GET"></span>List certificates</a></li><li class="stldocs-sidebar-entry stldocs-sidebar-entry-link"><a href="/api/reference/resources/admin/subresources/organization/subresources/certificates/methods/activate" data-stldocs-method="post"><span class="stl-ui-badge stl-ui-badge--size-sm stl-sidebar-icon stl-ui-badge--http stl-ui-badge--http-post" role="img" aria-label="POST"></span>Activate</a></li><li class="stldocs-sidebar-entry stldocs-sidebar-entry-link"><a href="/api/reference/resources/admin/subresources/organization/subresources/certificates/methods/deactivate" data-stldocs-method="post"><span class="stl-ui-badge stl-ui-badge--size-sm stl-sidebar-icon stl-ui-badge--http stl-ui-badge--http-post" role="img" aria-label="POST"></span>Deactivate</a></li></ul></details></li><li class="stldocs-sidebar-entry stldocs-sidebar-entry-group"><details class="stldocs-sidebar-expander"><summary class="stldocs-expander-summary"><span>Data Retention</span><svg xmlns="http://www.w3.org/2000/svg" width="16" height="16" viewBox="0 0 24 24" fill="none" stroke="currentColor" stroke-width="1" stroke-linecap="round" stroke-linejoin="round" class="lucide lucide-chevron-right stldocs-icon stldocs-expander-summary-icon" aria-hidden="true"><path d="m9 18 6-6-6-6"></path></svg></summary><ul class="stldocs-sidebar-list"><li class="stldocs-sidebar-entry stldocs-sidebar-entry-link"><a href="/api/reference/resources/admin/subresources/organization/subresources/data_retention/methods/retrieve" data-stldocs-method="get"><span class="stl-ui-badge stl-ui-badge--size-sm stl-sidebar-icon stl-ui-badge--http stl-ui-badge--http-get" role="img" aria-label="GET"></span>Retrieve a data retention</a></li><li class="stldocs-sidebar-entry stldocs-sidebar-entry-link"><a href="/api/reference/resources/admin/subresources/organization/subresources/data_retention/methods/update" data-stldocs-method="post"><span class="stl-ui-badge stl-ui-badge--size-sm stl-sidebar-icon stl-ui-badge--http stl-ui-badge--http-post" role="img" aria-label="POST"></span>Update a data retention</a></li></ul></details></li><li class="stldocs-sidebar-entry stldocs-sidebar-entry-group"><details class="stldocs-sidebar-expander"><summary class="stldocs-expander-summary"><span>Groups</span><svg xmlns="http://www.w3.org/2000/svg" width="16" height="16" viewBox="0 0 24 24" fill="none" stroke="currentColor" stroke-width="1" stroke-linecap="round" stroke-linejoin="round" class="lucide lucide-chevron-right stldocs-icon stldocs-expander-summary-icon" aria-hidden="true"><path d="m9 18 6-6-6-6"></path></svg></summary><ul class="stldocs-sidebar-list"><li class="stldocs-sidebar-entry stldocs-sidebar-entry-link"><a href="/api/reference/resources/admin/subresources/organization/subresources/groups/methods/create" data-stldocs-method="post"><span class="stl-ui-badge stl-ui-badge--size-sm stl-sidebar-icon stl-ui-badge--http stl-ui-badge--http-post" role="img" aria-label="POST"></span>Create a group</a></li><li class="stldocs-sidebar-entry stldocs-sidebar-entry-link"><a href="/api/reference/resources/admin/subresources/organization/subresources/groups/methods/retrieve" data-stldocs-method="get"><span class="stl-ui-badge stl-ui-badge--size-sm stl-sidebar-icon stl-ui-badge--http stl-ui-badge--http-get" role="img" aria-label="GET"></span>Retrieve a group</a></li><li class="stldocs-sidebar-entry stldocs-sidebar-entry-link"><a href="/api/reference/resources/admin/subresources/organization/subresources/groups/methods/update" data-stldocs-method="post"><span class="stl-ui-badge stl-ui-badge--size-sm stl-sidebar-icon stl-ui-badge--http stl-ui-badge--http-post" role="img" aria-label="POST"></span>Update a group</a></li><li class="stldocs-sidebar-entry stldocs-sidebar-entry-link"><a href="/api/reference/resources/admin/subresources/organization/subresources/groups/methods/delete" data-stldocs-method="delete"><span class="stl-ui-badge stl-ui-badge--size-sm stl-sidebar-icon stl-ui-badge--http stl-ui-badge--http-delete" role="img" aria-label="DELETE"></span>Delete a group</a></li><li class="stldocs-sidebar-entry stldocs-sidebar-entry-link"><a href="/api/reference/resources/admin/subresources/organization/subresources/groups/methods/list" data-stldocs-method="get"><span class="stl-ui-badge stl-ui-badge--size-sm stl-sidebar-icon stl-ui-badge--http stl-ui-badge--http-get" role="img" aria-label="GET"></span>List groups</a></li><li class="stldocs-sidebar-entry stldocs-sidebar-entry-group"><details class="stldocs-sidebar-expander"><summary class="stldocs-expander-summary"><span>Roles</span><svg xmlns="http://www.w3.org/2000/svg" width="16" height="16" viewBox="0 0 24 24" fill="none" stroke="currentColor" stroke-width="1" stroke-linecap="round" stroke-linejoin="round" class="lucide lucide-chevron-right stldocs-icon stldocs-expander-summary-icon" aria-hidden="true"><path d="m9 18 6-6-6-6"></path></svg></summary><ul class="stldocs-sidebar-list"><li class="stldocs-sidebar-entry stldocs-sidebar-entry-link"><a href="/api/reference/resources/admin/subresources/organization/subresources/groups/subresources/roles/methods/create" data-stldocs-method="post"><span class="stl-ui-badge stl-ui-badge--size-sm stl-sidebar-icon stl-ui-badge--http stl-ui-badge--http-post" role="img" aria-label="POST"></span>Create a role</a></li><li class="stldocs-sidebar-entry stldocs-sidebar-entry-link"><a href="/api/reference/resources/admin/subresources/organization/subresources/groups/subresources/roles/methods/retrieve" data-stldocs-method="get"><span class="stl-ui-badge stl-ui-badge--size-sm stl-sidebar-icon stl-ui-badge--http stl-ui-badge--http-get" role="img" aria-label="GET"></span>Retrieve a role</a></li><li class="stldocs-sidebar-entry stldocs-sidebar-entry-link"><a href="/api/reference/resources/admin/subresources/organization/subresources/groups/subresources/roles/methods/delete" data-stldocs-method="delete"><span class="stl-ui-badge stl-ui-badge--size-sm stl-sidebar-icon stl-ui-badge--http stl-ui-badge--http-delete" role="img" aria-label="DELETE"></span>Delete a role</a></li><li class="stldocs-sidebar-entry stldocs-sidebar-entry-link"><a href="/api/reference/resources/admin/subresources/organization/subresources/groups/subresources/roles/methods/list" data-stldocs-method="get"><span class="stl-ui-badge stl-ui-badge--size-sm stl-sidebar-icon stl-ui-badge--http stl-ui-badge--http-get" role="img" aria-label="GET"></span>List roles</a></li></ul></details></li><li class="stldocs-sidebar-entry stldocs-sidebar-entry-group"><details class="stldocs-sidebar-expander"><summary class="stldocs-expander-summary"><span>Users</span><svg xmlns="http://www.w3.org/2000/svg" width="16" height="16" viewBox="0 0 24 24" fill="none" stroke="currentColor" stroke-width="1" stroke-linecap="round" stroke-linejoin="round" class="lucide lucide-chevron-right stldocs-icon stldocs-expander-summary-icon" aria-hidden="true"><path d="m9 18 6-6-6-6"></path></svg></summary><ul class="stldocs-sidebar-list"><li class="stldocs-sidebar-entry stldocs-sidebar-entry-link"><a href="/api/reference/resources/admin/subresources/organization/subresources/groups/subresources/users/methods/create" data-stldocs-method="post"><span class="stl-ui-badge stl-ui-badge--size-sm stl-sidebar-icon stl-ui-badge--http stl-ui-badge--http-post" role="img" aria-label="POST"></span>Create an user</a></li><li class="stldocs-sidebar-entry stldocs-sidebar-entry-link"><a href="/api/reference/resources/admin/subresources/organization/subresources/groups/subresources/users/methods/retrieve" data-stldocs-method="get"><span class="stl-ui-badge stl-ui-badge--size-sm stl-sidebar-icon stl-ui-badge--http stl-ui-badge--http-get" role="img" aria-label="GET"></span>Retrieve an user</a></li><li class="stldocs-sidebar-entry stldocs-sidebar-entry-link"><a href="/api/reference/resources/admin/subresources/organization/subresources/groups/subresources/users/methods/delete" data-stldocs-method="delete"><span class="stl-ui-badge stl-ui-badge--size-sm stl-sidebar-icon stl-ui-badge--http stl-ui-badge--http-delete" role="img" aria-label="DELETE"></span>Delete an user</a></li><li class="stldocs-sidebar-entry stldocs-sidebar-entry-link"><a href="/api/reference/resources/admin/subresources/organization/subresources/groups/subresources/users/methods/list" data-stldocs-method="get"><span class="stl-ui-badge stl-ui-badge--size-sm stl-sidebar-icon stl-ui-badge--http stl-ui-badge--http-get" role="img" aria-label="GET"></span>List users</a></li></ul></details></li></ul></details></li><li class="stldocs-sidebar-entry stldocs-sidebar-entry-group"><details class="stldocs-sidebar-expander"><summary class="stldocs-expander-summary"><span>Invites</span><svg xmlns="http://www.w3.org/2000/svg" width="16" height="16" viewBox="0 0 24 24" fill="none" stroke="currentColor" stroke-width="1" stroke-linecap="round" stroke-linejoin="round" class="lucide lucide-chevron-right stldocs-icon stldocs-expander-summary-icon" aria-hidden="true"><path d="m9 18 6-6-6-6"></path></svg></summary><ul class="stldocs-sidebar-list"><li class="stldocs-sidebar-entry stldocs-sidebar-entry-link"><a href="/api/reference/resources/admin/subresources/organization/subresources/invites/methods/create" data-stldocs-method="post"><span class="stl-ui-badge stl-ui-badge--size-sm stl-sidebar-icon stl-ui-badge--http stl-ui-badge--http-post" role="img" aria-label="POST"></span>Create an invite</a></li><li class="stldocs-sidebar-entry stldocs-sidebar-entry-link"><a href="/api/reference/resources/admin/subresources/organization/subresources/invites/methods/retrieve" data-stldocs-method="get"><span class="stl-ui-badge stl-ui-badge--size-sm stl-sidebar-icon stl-ui-badge--http stl-ui-badge--http-get" role="img" aria-label="GET"></span>Retrieve an invite</a></li><li class="stldocs-sidebar-entry stldocs-sidebar-entry-link"><a href="/api/reference/resources/admin/subresources/organization/subresources/invites/methods/delete" data-stldocs-method="delete"><span class="stl-ui-badge stl-ui-badge--size-sm stl-sidebar-icon stl-ui-badge--http stl-ui-badge--http-delete" role="img" aria-label="DELETE"></span>Delete an invite</a></li><li class="stldocs-sidebar-entry stldocs-sidebar-entry-link"><a href="/api/reference/resources/admin/subresources/organization/subresources/invites/methods/list" data-stldocs-method="get"><span class="stl-ui-badge stl-ui-badge--size-sm stl-sidebar-icon stl-ui-badge--http stl-ui-badge--http-get" role="img" aria-label="GET"></span>List invites</a></li></ul></details></li><li class="stldocs-sidebar-entry stldocs-sidebar-entry-group"><details class="stldocs-sidebar-expander"><summary class="stldocs-expander-summary"><span>Projects</span><svg xmlns="http://www.w3.org/2000/svg" width="16" height="16" viewBox="0 0 24 24" fill="none" stroke="currentColor" stroke-width="1" stroke-linecap="round" stroke-linejoin="round" class="lucide lucide-chevron-right stldocs-icon stldocs-expander-summary-icon" aria-hidden="true"><path d="m9 18 6-6-6-6"></path></svg></summary><ul class="stldocs-sidebar-list"><li class="stldocs-sidebar-entry stldocs-sidebar-entry-link"><a href="/api/reference/resources/admin/subresources/organization/subresources/projects/methods/create" data-stldocs-method="post"><span class="stl-ui-badge stl-ui-badge--size-sm stl-sidebar-icon stl-ui-badge--http stl-ui-badge--http-post" role="img" aria-label="POST"></span>Create a project</a></li><li class="stldocs-sidebar-entry stldocs-sidebar-entry-link"><a href="/api/reference/resources/admin/subresources/organization/subresources/projects/methods/retrieve" data-stldocs-method="get"><span class="stl-ui-badge stl-ui-badge--size-sm stl-sidebar-icon stl-ui-badge--http stl-ui-badge--http-get" role="img" aria-label="GET"></span>Retrieve a project</a></li><li class="stldocs-sidebar-entry stldocs-sidebar-entry-link"><a href="/api/reference/resources/admin/subresources/organization/subresources/projects/methods/update" data-stldocs-method="post"><span class="stl-ui-badge stl-ui-badge--size-sm stl-sidebar-icon stl-ui-badge--http stl-ui-badge--http-post" role="img" aria-label="POST"></span>Update a project</a></li><li class="stldocs-sidebar-entry stldocs-sidebar-entry-link"><a href="/api/reference/resources/admin/subresources/organization/subresources/projects/methods/list" data-stldocs-method="get"><span class="stl-ui-badge stl-ui-badge--size-sm stl-sidebar-icon stl-ui-badge--http stl-ui-badge--http-get" role="img" aria-label="GET"></span>List projects</a></li><li class="stldocs-sidebar-entry stldocs-sidebar-entry-link"><a href="/api/reference/resources/admin/subresources/organization/subresources/projects/methods/archive" data-stldocs-method="post"><span class="stl-ui-badge stl-ui-badge--size-sm stl-sidebar-icon stl-ui-badge--http stl-ui-badge--http-post" role="img" aria-label="POST"></span>Archive</a></li><li class="stldocs-sidebar-entry stldocs-sidebar-entry-group"><details class="stldocs-sidebar-expander"><summary class="stldocs-expander-summary"><span>API Keys</span><svg xmlns="http://www.w3.org/2000/svg" width="16" height="16" viewBox="0 0 24 24" fill="none" stroke="currentColor" stroke-width="1" stroke-linecap="round" stroke-linejoin="round" class="lucide lucide-chevron-right stldocs-icon stldocs-expander-summary-icon" aria-hidden="true"><path d="m9 18 6-6-6-6"></path></svg></summary><ul class="stldocs-sidebar-list"><li class="stldocs-sidebar-entry stldocs-sidebar-entry-link"><a href="/api/reference/resources/admin/subresources/organization/subresources/projects/subresources/api_keys/methods/retrieve" data-stldocs-method="get"><span class="stl-ui-badge stl-ui-badge--size-sm stl-sidebar-icon stl-ui-badge--http stl-ui-badge--http-get" role="img" aria-label="GET"></span>Retrieve an API key</a></li><li class="stldocs-sidebar-entry stldocs-sidebar-entry-link"><a href="/api/reference/resources/admin/subresources/organization/subresources/projects/subresources/api_keys/methods/delete" data-stldocs-method="delete"><span class="stl-ui-badge stl-ui-badge--size-sm stl-sidebar-icon stl-ui-badge--http stl-ui-badge--http-delete" role="img" aria-label="DELETE"></span>Delete an API key</a></li><li class="stldocs-sidebar-entry stldocs-sidebar-entry-link"><a href="/api/reference/resources/admin/subresources/organization/subresources/projects/subresources/api_keys/methods/list" data-stldocs-method="get"><span class="stl-ui-badge stl-ui-badge--size-sm stl-sidebar-icon stl-ui-badge--http stl-ui-badge--http-get" role="img" aria-label="GET"></span>List API keys</a></li></ul></details></li><li class="stldocs-sidebar-entry stldocs-sidebar-entry-group"><details class="stldocs-sidebar-expander"><summary class="stldocs-expander-summary"><span>Certificates</span><svg xmlns="http://www.w3.org/2000/svg" width="16" height="16" viewBox="0 0 24 24" fill="none" stroke="currentColor" stroke-width="1" stroke-linecap="round" stroke-linejoin="round" class="lucide lucide-chevron-right stldocs-icon stldocs-expander-summary-icon" aria-hidden="true"><path d="m9 18 6-6-6-6"></path></svg></summary><ul class="stldocs-sidebar-list"><li class="stldocs-sidebar-entry stldocs-sidebar-entry-link"><a href="/api/reference/resources/admin/subresources/organization/subresources/projects/subresources/certificates/methods/list" data-stldocs-method="get"><span class="stl-ui-badge stl-ui-badge--size-sm stl-sidebar-icon stl-ui-badge--http stl-ui-badge--http-get" role="img" aria-label="GET"></span>List certificates</a></li><li class="stldocs-sidebar-entry stldocs-sidebar-entry-link"><a href="/api/reference/resources/admin/subresources/organization/subresources/projects/subresources/certificates/methods/activate" data-stldocs-method="post"><span class="stl-ui-badge stl-ui-badge--size-sm stl-sidebar-icon stl-ui-badge--http stl-ui-badge--http-post" role="img" aria-label="POST"></span>Activate</a></li><li class="stldocs-sidebar-entry stldocs-sidebar-entry-link"><a href="/api/reference/resources/admin/subresources/organization/subresources/projects/subresources/certificates/methods/deactivate" data-stldocs-method="post"><span class="stl-ui-badge stl-ui-badge--size-sm stl-sidebar-icon stl-ui-badge--http stl-ui-badge--http-post" role="img" aria-label="POST"></span>Deactivate</a></li></ul></details></li><li class="stldocs-sidebar-entry stldocs-sidebar-entry-group"><details class="stldocs-sidebar-expander"><summary class="stldocs-expander-summary"><span>Data Retention</span><svg xmlns="http://www.w3.org/2000/svg" width="16" height="16" viewBox="0 0 24 24" fill="none" stroke="currentColor" stroke-width="1" stroke-linecap="round" stroke-linejoin="round" class="lucide lucide-chevron-right stldocs-icon stldocs-expander-summary-icon" aria-hidden="true"><path d="m9 18 6-6-6-6"></path></svg></summary><ul class="stldocs-sidebar-list"><li class="stldocs-sidebar-entry stldocs-sidebar-entry-link"><a href="/api/reference/resources/admin/subresources/organization/subresources/projects/subresources/data_retention/methods/retrieve" data-stldocs-method="get"><span class="stl-ui-badge stl-ui-badge--size-sm stl-sidebar-icon stl-ui-badge--http stl-ui-badge--http-get" role="img" aria-label="GET"></span>Retrieve a data retention</a></li><li class="stldocs-sidebar-entry stldocs-sidebar-entry-link"><a href="/api/reference/resources/admin/subresources/organization/subresources/projects/subresources/data_retention/methods/update" data-stldocs-method="post"><span class="stl-ui-badge stl-ui-badge--size-sm stl-sidebar-icon stl-ui-badge--http stl-ui-badge--http-post" role="img" aria-label="POST"></span>Update a data retention</a></li></ul></details></li><li class="stldocs-sidebar-entry stldocs-sidebar-entry-group"><details class="stldocs-sidebar-expander"><summary class="stldocs-expander-summary"><span>Groups</span><svg xmlns="http://www.w3.org/2000/svg" width="16" height="16" viewBox="0 0 24 24" fill="none" stroke="currentColor" stroke-width="1" stroke-linecap="round" stroke-linejoin="round" class="lucide lucide-chevron-right stldocs-icon stldocs-expander-summary-icon" aria-hidden="true"><path d="m9 18 6-6-6-6"></path></svg></summary><ul class="stldocs-sidebar-list"><li class="stldocs-sidebar-entry stldocs-sidebar-entry-link"><a href="/api/reference/resources/admin/subresources/organization/subresources/projects/subresources/groups/methods/create" data-stldocs-method="post"><span class="stl-ui-badge stl-ui-badge--size-sm stl-sidebar-icon stl-ui-badge--http stl-ui-badge--http-post" role="img" aria-label="POST"></span>Create a group</a></li><li class="stldocs-sidebar-entry stldocs-sidebar-entry-link"><a href="/api/reference/resources/admin/subresources/organization/subresources/projects/subresources/groups/methods/retrieve" data-stldocs-method="get"><span class="stl-ui-badge stl-ui-badge--size-sm stl-sidebar-icon stl-ui-badge--http stl-ui-badge--http-get" role="img" aria-label="GET"></span>Retrieve a group</a></li><li class="stldocs-sidebar-entry stldocs-sidebar-entry-link"><a href="/api/reference/resources/admin/subresources/organization/subresources/projects/subresources/groups/methods/delete" data-stldocs-method="delete"><span class="stl-ui-badge stl-ui-badge--size-sm stl-sidebar-icon stl-ui-badge--http stl-ui-badge--http-delete" role="img" aria-label="DELETE"></span>Delete a group</a></li><li class="stldocs-sidebar-entry stldocs-sidebar-entry-link"><a href="/api/reference/resources/admin/subresources/organization/subresources/projects/subresources/groups/methods/list" data-stldocs-method="get"><span class="stl-ui-badge stl-ui-badge--size-sm stl-sidebar-icon stl-ui-badge--http stl-ui-badge--http-get" role="img" aria-label="GET"></span>List groups</a></li><li class="stldocs-sidebar-entry stldocs-sidebar-entry-group"><details class="stldocs-sidebar-expander"><summary class="stldocs-expander-summary"><span>Roles</span><svg xmlns="http://www.w3.org/2000/svg" width="16" height="16" viewBox="0 0 24 24" fill="none" stroke="currentColor" stroke-width="1" stroke-linecap="round" stroke-linejoin="round" class="lucide lucide-chevron-right stldocs-icon stldocs-expander-summary-icon" aria-hidden="true"><path d="m9 18 6-6-6-6"></path></svg></summary><ul class="stldocs-sidebar-list"><li class="stldocs-sidebar-entry stldocs-sidebar-entry-link"><a href="/api/reference/resources/admin/subresources/organization/subresources/projects/subresources/groups/subresources/roles/methods/create" data-stldocs-method="post"><span class="stl-ui-badge stl-ui-badge--size-sm stl-sidebar-icon stl-ui-badge--http stl-ui-badge--http-post" role="img" aria-label="POST"></span>Create a role</a></li><li class="stldocs-sidebar-entry stldocs-sidebar-entry-link"><a href="/api/reference/resources/admin/subresources/organization/subresources/projects/subresources/groups/subresources/roles/methods/retrieve" data-stldocs-method="get"><span class="stl-ui-badge stl-ui-badge--size-sm stl-sidebar-icon stl-ui-badge--http stl-ui-badge--http-get" role="img" aria-label="GET"></span>Retrieve a role</a></li><li class="stldocs-sidebar-entry stldocs-sidebar-entry-link"><a href="/api/reference/resources/admin/subresources/organization/subresources/projects/subresources/groups/subresources/roles/methods/delete" data-stldocs-method="delete"><span class="stl-ui-badge stl-ui-badge--size-sm stl-sidebar-icon stl-ui-badge--http stl-ui-badge--http-delete" role="img" aria-label="DELETE"></span>Delete a role</a></li><li class="stldocs-sidebar-entry stldocs-sidebar-entry-link"><a href="/api/reference/resources/admin/subresources/organization/subresources/projects/subresources/groups/subresources/roles/methods/list" data-stldocs-method="get"><span class="stl-ui-badge stl-ui-badge--size-sm stl-sidebar-icon stl-ui-badge--http stl-ui-badge--http-get" role="img" aria-label="GET"></span>List roles</a></li></ul></details></li></ul></details></li><li class="stldocs-sidebar-entry stldocs-sidebar-entry-group"><details class="stldocs-sidebar-expander"><summary class="stldocs-expander-summary"><span>Hosted Tool Permissions</span><svg xmlns="http://www.w3.org/2000/svg" width="16" height="16" viewBox="0 0 24 24" fill="none" stroke="currentColor" stroke-width="1" stroke-linecap="round" stroke-linejoin="round" class="lucide lucide-chevron-right stldocs-icon stldocs-expander-summary-icon" aria-hidden="true"><path d="m9 18 6-6-6-6"></path></svg></summary><ul class="stldocs-sidebar-list"><li class="stldocs-sidebar-entry stldocs-sidebar-entry-link"><a href="/api/reference/resources/admin/subresources/organization/subresources/projects/subresources/hosted_tool_permissions/methods/retrieve" data-stldocs-method="get"><span class="stl-ui-badge stl-ui-badge--size-sm stl-sidebar-icon stl-ui-badge--http stl-ui-badge--http-get" role="img" aria-label="GET"></span>Retrieve a hosted tool permission</a></li><li class="stldocs-sidebar-entry stldocs-sidebar-entry-link"><a href="/api/reference/resources/admin/subresources/organization/subresources/projects/subresources/hosted_tool_permissions/methods/update" data-stldocs-method="post"><span class="stl-ui-badge stl-ui-badge--size-sm stl-sidebar-icon stl-ui-badge--http stl-ui-badge--http-post" role="img" aria-label="POST"></span>Update a hosted tool permission</a></li></ul></details></li><li class="stldocs-sidebar-entry stldocs-sidebar-entry-group"><details class="stldocs-sidebar-expander"><summary class="stldocs-expander-summary"><span>Model Permissions</span><svg xmlns="http://www.w3.org/2000/svg" width="16" height="16" viewBox="0 0 24 24" fill="none" stroke="currentColor" stroke-width="1" stroke-linecap="round" stroke-linejoin="round" class="lucide lucide-chevron-right stldocs-icon stldocs-expander-summary-icon" aria-hidden="true"><path d="m9 18 6-6-6-6"></path></svg></summary><ul class="stldocs-sidebar-list"><li class="stldocs-sidebar-entry stldocs-sidebar-entry-link"><a href="/api/reference/resources/admin/subresources/organization/subresources/projects/subresources/model_permissions/methods/retrieve" data-stldocs-method="get"><span class="stl-ui-badge stl-ui-badge--size-sm stl-sidebar-icon stl-ui-badge--http stl-ui-badge--http-get" role="img" aria-label="GET"></span>Retrieve a model permission</a></li><li class="stldocs-sidebar-entry stldocs-sidebar-entry-link"><a href="/api/reference/resources/admin/subresources/organization/subresources/projects/subresources/model_permissions/methods/update" data-stldocs-method="post"><span class="stl-ui-badge stl-ui-badge--size-sm stl-sidebar-icon stl-ui-badge--http stl-ui-badge--http-post" role="img" aria-label="POST"></span>Update a model permission</a></li><li class="stldocs-sidebar-entry stldocs-sidebar-entry-link"><a href="/api/reference/resources/admin/subresources/organization/subresources/projects/subresources/model_permissions/methods/delete" data-stldocs-method="delete"><span class="stl-ui-badge stl-ui-badge--size-sm stl-sidebar-icon stl-ui-badge--http stl-ui-badge--http-delete" role="img" aria-label="DELETE"></span>Delete a model permission</a></li></ul></details></li><li class="stldocs-sidebar-entry stldocs-sidebar-entry-group"><details class="stldocs-sidebar-expander"><summary class="stldocs-expander-summary"><span>Rate Limits</span><svg xmlns="http://www.w3.org/2000/svg" width="16" height="16" viewBox="0 0 24 24" fill="none" stroke="currentColor" stroke-width="1" stroke-linecap="round" stroke-linejoin="round" class="lucide lucide-chevron-right stldocs-icon stldocs-expander-summary-icon" aria-hidden="true"><path d="m9 18 6-6-6-6"></path></svg></summary><ul class="stldocs-sidebar-list"><li class="stldocs-sidebar-entry stldocs-sidebar-entry-link"><a href="/api/reference/resources/admin/subresources/organization/subresources/projects/subresources/rate_limits/methods/update_rate_limit" data-stldocs-method="post"><span class="stl-ui-badge stl-ui-badge--size-sm stl-sidebar-icon stl-ui-badge--http stl-ui-badge--http-post" role="img" aria-label="POST"></span>Update Rate Limit</a></li><li class="stldocs-sidebar-entry stldocs-sidebar-entry-link"><a href="/api/reference/resources/admin/subresources/organization/subresources/projects/subresources/rate_limits/methods/list_rate_limits" data-stldocs-method="get"><span class="stl-ui-badge stl-ui-badge--size-sm stl-sidebar-icon stl-ui-badge--http stl-ui-badge--http-get" role="img" aria-label="GET"></span>List Rate Limits</a></li></ul></details></li><li class="stldocs-sidebar-entry stldocs-sidebar-entry-group"><details class="stldocs-sidebar-expander"><summary class="stldocs-expander-summary"><span>Roles</span><svg xmlns="http://www.w3.org/2000/svg" width="16" height="16" viewBox="0 0 24 24" fill="none" stroke="currentColor" stroke-width="1" stroke-linecap="round" stroke-linejoin="round" class="lucide lucide-chevron-right stldocs-icon stldocs-expander-summary-icon" aria-hidden="true"><path d="m9 18 6-6-6-6"></path></svg></summary><ul class="stldocs-sidebar-list"><li class="stldocs-sidebar-entry stldocs-sidebar-entry-link"><a href="/api/reference/resources/admin/subresources/organization/subresources/projects/subresources/roles/methods/create" data-stldocs-method="post"><span class="stl-ui-badge stl-ui-badge--size-sm stl-sidebar-icon stl-ui-badge--http stl-ui-badge--http-post" role="img" aria-label="POST"></span>Create a role</a></li><li class="stldocs-sidebar-entry stldocs-sidebar-entry-link"><a href="/api/reference/resources/admin/subresources/organization/subresources/projects/subresources/roles/methods/retrieve" data-stldocs-method="get"><span class="stl-ui-badge stl-ui-badge--size-sm stl-sidebar-icon stl-ui-badge--http stl-ui-badge--http-get" role="img" aria-label="GET"></span>Retrieve a role</a></li><li class="stldocs-sidebar-entry stldocs-sidebar-entry-link"><a href="/api/reference/resources/admin/subresources/organization/subresources/projects/subresources/roles/methods/update" data-stldocs-method="post"><span class="stl-ui-badge stl-ui-badge--size-sm stl-sidebar-icon stl-ui-badge--http stl-ui-badge--http-post" role="img" aria-label="POST"></span>Update a role</a></li><li class="stldocs-sidebar-entry stldocs-sidebar-entry-link"><a href="/api/reference/resources/admin/subresources/organization/subresources/projects/subresources/roles/methods/delete" data-stldocs-method="delete"><span class="stl-ui-badge stl-ui-badge--size-sm stl-sidebar-icon stl-ui-badge--http stl-ui-badge--http-delete" role="img" aria-label="DELETE"></span>Delete a role</a></li><li class="stldocs-sidebar-entry stldocs-sidebar-entry-link"><a href="/api/reference/resources/admin/subresources/organization/subresources/projects/subresources/roles/methods/list" data-stldocs-method="get"><span class="stl-ui-badge stl-ui-badge--size-sm stl-sidebar-icon stl-ui-badge--http stl-ui-badge--http-get" role="img" aria-label="GET"></span>List roles</a></li></ul></details></li><li class="stldocs-sidebar-entry stldocs-sidebar-entry-group"><details class="stldocs-sidebar-expander"><summary class="stldocs-expander-summary"><span>Service Accounts</span><svg xmlns="http://www.w3.org/2000/svg" width="16" height="16" viewBox="0 0 24 24" fill="none" stroke="currentColor" stroke-width="1" stroke-linecap="round" stroke-linejoin="round" class="lucide lucide-chevron-right stldocs-icon stldocs-expander-summary-icon" aria-hidden="true"><path d="m9 18 6-6-6-6"></path></svg></summary><ul class="stldocs-sidebar-list"><li class="stldocs-sidebar-entry stldocs-sidebar-entry-link"><a href="/api/reference/resources/admin/subresources/organization/subresources/projects/subresources/service_accounts/methods/create" data-stldocs-method="post"><span class="stl-ui-badge stl-ui-badge--size-sm stl-sidebar-icon stl-ui-badge--http stl-ui-badge--http-post" role="img" aria-label="POST"></span>Create a service account</a></li><li class="stldocs-sidebar-entry stldocs-sidebar-entry-link"><a href="/api/reference/resources/admin/subresources/organization/subresources/projects/subresources/service_accounts/methods/retrieve" data-stldocs-method="get"><span class="stl-ui-badge stl-ui-badge--size-sm stl-sidebar-icon stl-ui-badge--http stl-ui-badge--http-get" role="img" aria-label="GET"></span>Retrieve a service account</a></li><li class="stldocs-sidebar-entry stldocs-sidebar-entry-link"><a href="/api/reference/resources/admin/subresources/organization/subresources/projects/subresources/service_accounts/methods/update" data-stldocs-method="post"><span class="stl-ui-badge stl-ui-badge--size-sm stl-sidebar-icon stl-ui-badge--http stl-ui-badge--http-post" role="img" aria-label="POST"></span>Update a service account</a></li><li class="stldocs-sidebar-entry stldocs-sidebar-entry-link"><a href="/api/reference/resources/admin/subresources/organization/subresources/projects/subresources/service_accounts/methods/delete" data-stldocs-method="delete"><span class="stl-ui-badge stl-ui-badge--size-sm stl-sidebar-icon stl-ui-badge--http stl-ui-badge--http-delete" role="img" aria-label="DELETE"></span>Delete a service account</a></li><li class="stldocs-sidebar-entry stldocs-sidebar-entry-link"><a href="/api/reference/resources/admin/subresources/organization/subresources/projects/subresources/service_accounts/methods/list" data-stldocs-method="get"><span class="stl-ui-badge stl-ui-badge--size-sm stl-sidebar-icon stl-ui-badge--http stl-ui-badge--http-get" role="img" aria-label="GET"></span>List service accounts</a></li><li class="stldocs-sidebar-entry stldocs-sidebar-entry-group"><details class="stldocs-sidebar-expander"><summary class="stldocs-expander-summary"><span>API Keys</span><svg xmlns="http://www.w3.org/2000/svg" width="16" height="16" viewBox="0 0 24 24" fill="none" stroke="currentColor" stroke-width="1" stroke-linecap="round" stroke-linejoin="round" class="lucide lucide-chevron-right stldocs-icon stldocs-expander-summary-icon" aria-hidden="true"><path d="m9 18 6-6-6-6"></path></svg></summary><ul class="stldocs-sidebar-list"><li class="stldocs-sidebar-entry stldocs-sidebar-entry-link"><a href="/api/reference/resources/admin/subresources/organization/subresources/projects/subresources/service_accounts/subresources/api_keys/methods/create" data-stldocs-method="post"><span class="stl-ui-badge stl-ui-badge--size-sm stl-sidebar-icon stl-ui-badge--http stl-ui-badge--http-post" role="img" aria-label="POST"></span>Create an API key</a></li></ul></details></li></ul></details></li><li class="stldocs-sidebar-entry stldocs-sidebar-entry-group"><details class="stldocs-sidebar-expander"><summary class="stldocs-expander-summary"><span>Spend Alerts</span><svg xmlns="http://www.w3.org/2000/svg" width="16" height="16" viewBox="0 0 24 24" fill="none" stroke="currentColor" stroke-width="1" stroke-linecap="round" stroke-linejoin="round" class="lucide lucide-chevron-right stldocs-icon stldocs-expander-summary-icon" aria-hidden="true"><path d="m9 18 6-6-6-6"></path></svg></summary><ul class="stldocs-sidebar-list"><li class="stldocs-sidebar-entry stldocs-sidebar-entry-link"><a href="/api/reference/resources/admin/subresources/organization/subresources/projects/subresources/spend_alerts/methods/create" data-stldocs-method="post"><span class="stl-ui-badge stl-ui-badge--size-sm stl-sidebar-icon stl-ui-badge--http stl-ui-badge--http-post" role="img" aria-label="POST"></span>Create a spend alert</a></li><li class="stldocs-sidebar-entry stldocs-sidebar-entry-link"><a href="/api/reference/resources/admin/subresources/organization/subresources/projects/subresources/spend_alerts/methods/retrieve" data-stldocs-method="get"><span class="stl-ui-badge stl-ui-badge--size-sm stl-sidebar-icon stl-ui-badge--http stl-ui-badge--http-get" role="img" aria-label="GET"></span>Retrieve a spend alert</a></li><li class="stldocs-sidebar-entry stldocs-sidebar-entry-link"><a href="/api/reference/resources/admin/subresources/organization/subresources/projects/subresources/spend_alerts/methods/update" data-stldocs-method="post"><span class="stl-ui-badge stl-ui-badge--size-sm stl-sidebar-icon stl-ui-badge--http stl-ui-badge--http-post" role="img" aria-label="POST"></span>Update a spend alert</a></li><li class="stldocs-sidebar-entry stldocs-sidebar-entry-link"><a href="/api/reference/resources/admin/subresources/organization/subresources/projects/subresources/spend_alerts/methods/delete" data-stldocs-method="delete"><span class="stl-ui-badge stl-ui-badge--size-sm stl-sidebar-icon stl-ui-badge--http stl-ui-badge--http-delete" role="img" aria-label="DELETE"></span>Delete a spend alert</a></li><li class="stldocs-sidebar-entry stldocs-sidebar-entry-link"><a href="/api/reference/resources/admin/subresources/organization/subresources/projects/subresources/spend_alerts/methods/list" data-stldocs-method="get"><span class="stl-ui-badge stl-ui-badge--size-sm stl-sidebar-icon stl-ui-badge--http stl-ui-badge--http-get" role="img" aria-label="GET"></span>List spend alerts</a></li></ul></details></li><li class="stldocs-sidebar-entry stldocs-sidebar-entry-group"><details class="stldocs-sidebar-expander"><summary class="stldocs-expander-summary"><span>Spend Limit</span><svg xmlns="http://www.w3.org/2000/svg" width="16" height="16" viewBox="0 0 24 24" fill="none" stroke="currentColor" stroke-width="1" stroke-linecap="round" stroke-linejoin="round" class="lucide lucide-chevron-right stldocs-icon stldocs-expander-summary-icon" aria-hidden="true"><path d="m9 18 6-6-6-6"></path></svg></summary><ul class="stldocs-sidebar-list"><li class="stldocs-sidebar-entry stldocs-sidebar-entry-link"><a href="/api/reference/resources/admin/subresources/organization/subresources/projects/subresources/spend_limit/methods/retrieve" data-stldocs-method="get"><span class="stl-ui-badge stl-ui-badge--size-sm stl-sidebar-icon stl-ui-badge--http stl-ui-badge--http-get" role="img" aria-label="GET"></span>Retrieve a spend limit</a></li><li class="stldocs-sidebar-entry stldocs-sidebar-entry-link"><a href="/api/reference/resources/admin/subresources/organization/subresources/projects/subresources/spend_limit/methods/update" data-stldocs-method="post"><span class="stl-ui-badge stl-ui-badge--size-sm stl-sidebar-icon stl-ui-badge--http stl-ui-badge--http-post" role="img" aria-label="POST"></span>Update a spend limit</a></li><li class="stldocs-sidebar-entry stldocs-sidebar-entry-link"><a href="/api/reference/resources/admin/subresources/organization/subresources/projects/subresources/spend_limit/methods/delete" data-stldocs-method="delete"><span class="stl-ui-badge stl-ui-badge--size-sm stl-sidebar-icon stl-ui-badge--http stl-ui-badge--http-delete" role="img" aria-label="DELETE"></span>Delete a spend limit</a></li></ul></details></li><li class="stldocs-sidebar-entry stldocs-sidebar-entry-group"><details class="stldocs-sidebar-expander"><summary class="stldocs-expander-summary"><span>Users</span><svg xmlns="http://www.w3.org/2000/svg" width="16" height="16" viewBox="0 0 24 24" fill="none" stroke="currentColor" stroke-width="1" stroke-linecap="round" stroke-linejoin="round" class="lucide lucide-chevron-right stldocs-icon stldocs-expander-summary-icon" aria-hidden="true"><path d="m9 18 6-6-6-6"></path></svg></summary><ul class="stldocs-sidebar-list"><li class="stldocs-sidebar-entry stldocs-sidebar-entry-link"><a href="/api/reference/resources/admin/subresources/organization/subresources/projects/subresources/users/methods/create" data-stldocs-method="post"><span class="stl-ui-badge stl-ui-badge--size-sm stl-sidebar-icon stl-ui-badge--http stl-ui-badge--http-post" role="img" aria-label="POST"></span>Create an user</a></li><li class="stldocs-sidebar-entry stldocs-sidebar-entry-link"><a href="/api/reference/resources/admin/subresources/organization/subresources/projects/subresources/users/methods/retrieve" data-stldocs-method="get"><span class="stl-ui-badge stl-ui-badge--size-sm stl-sidebar-icon stl-ui-badge--http stl-ui-badge--http-get" role="img" aria-label="GET"></span>Retrieve an user</a></li><li class="stldocs-sidebar-entry stldocs-sidebar-entry-link"><a href="/api/reference/resources/admin/subresources/organization/subresources/projects/subresources/users/methods/update" data-stldocs-method="post"><span class="stl-ui-badge stl-ui-badge--size-sm stl-sidebar-icon stl-ui-badge--http stl-ui-badge--http-post" role="img" aria-label="POST"></span>Update an user</a></li><li class="stldocs-sidebar-entry stldocs-sidebar-entry-link"><a href="/api/reference/resources/admin/subresources/organization/subresources/projects/subresources/users/methods/delete" data-stldocs-method="delete"><span class="stl-ui-badge stl-ui-badge--size-sm stl-sidebar-icon stl-ui-badge--http stl-ui-badge--http-delete" role="img" aria-label="DELETE"></span>Delete an user</a></li><li class="stldocs-sidebar-entry stldocs-sidebar-entry-link"><a href="/api/reference/resources/admin/subresources/organization/subresources/projects/subresources/users/methods/list" data-stldocs-method="get"><span class="stl-ui-badge stl-ui-badge--size-sm stl-sidebar-icon stl-ui-badge--http stl-ui-badge--http-get" role="img" aria-label="GET"></span>List users</a></li><li class="stldocs-sidebar-entry stldocs-sidebar-entry-group"><details class="stldocs-sidebar-expander"><summary class="stldocs-expander-summary"><span>Roles</span><svg xmlns="http://www.w3.org/2000/svg" width="16" height="16" viewBox="0 0 24 24" fill="none" stroke="currentColor" stroke-width="1" stroke-linecap="round" stroke-linejoin="round" class="lucide lucide-chevron-right stldocs-icon stldocs-expander-summary-icon" aria-hidden="true"><path d="m9 18 6-6-6-6"></path></svg></summary><ul class="stldocs-sidebar-list"><li class="stldocs-sidebar-entry stldocs-sidebar-entry-link"><a href="/api/reference/resources/admin/subresources/organization/subresources/projects/subresources/users/subresources/roles/methods/create" data-stldocs-method="post"><span class="stl-ui-badge stl-ui-badge--size-sm stl-sidebar-icon stl-ui-badge--http stl-ui-badge--http-post" role="img" aria-label="POST"></span>Create a role</a></li><li class="stldocs-sidebar-entry stldocs-sidebar-entry-link"><a href="/api/reference/resources/admin/subresources/organization/subresources/projects/subresources/users/subresources/roles/methods/retrieve" data-stldocs-method="get"><span class="stl-ui-badge stl-ui-badge--size-sm stl-sidebar-icon stl-ui-badge--http stl-ui-badge--http-get" role="img" aria-label="GET"></span>Retrieve a role</a></li><li class="stldocs-sidebar-entry stldocs-sidebar-entry-link"><a href="/api/reference/resources/admin/subresources/organization/subresources/projects/subresources/users/subresources/roles/methods/delete" data-stldocs-method="delete"><span class="stl-ui-badge stl-ui-badge--size-sm stl-sidebar-icon stl-ui-badge--http stl-ui-badge--http-delete" role="img" aria-label="DELETE"></span>Delete a role</a></li><li class="stldocs-sidebar-entry stldocs-sidebar-entry-link"><a href="/api/reference/resources/admin/subresources/organization/subresources/projects/subresources/users/subresources/roles/methods/list" data-stldocs-method="get"><span class="stl-ui-badge stl-ui-badge--size-sm stl-sidebar-icon stl-ui-badge--http stl-ui-badge--http-get" role="img" aria-label="GET"></span>List roles</a></li></ul></details></li></ul></details></li></ul></details></li><li class="stldocs-sidebar-entry stldocs-sidebar-entry-group"><details class="stldocs-sidebar-expander"><summary class="stldocs-expander-summary"><span>Roles</span><svg xmlns="http://www.w3.org/2000/svg" width="16" height="16" viewBox="0 0 24 24" fill="none" stroke="currentColor" stroke-width="1" stroke-linecap="round" stroke-linejoin="round" class="lucide lucide-chevron-right stldocs-icon stldocs-expander-summary-icon" aria-hidden="true"><path d="m9 18 6-6-6-6"></path></svg></summary><ul class="stldocs-sidebar-list"><li class="stldocs-sidebar-entry stldocs-sidebar-entry-link"><a href="/api/reference/resources/admin/subresources/organization/subresources/roles/methods/create" data-stldocs-method="post"><span class="stl-ui-badge stl-ui-badge--size-sm stl-sidebar-icon stl-ui-badge--http stl-ui-badge--http-post" role="img" aria-label="POST"></span>Create a role</a></li><li class="stldocs-sidebar-entry stldocs-sidebar-entry-link"><a href="/api/reference/resources/admin/subresources/organization/subresources/roles/methods/retrieve" data-stldocs-method="get"><span class="stl-ui-badge stl-ui-badge--size-sm stl-sidebar-icon stl-ui-badge--http stl-ui-badge--http-get" role="img" aria-label="GET"></span>Retrieve a role</a></li><li class="stldocs-sidebar-entry stldocs-sidebar-entry-link"><a href="/api/reference/resources/admin/subresources/organization/subresources/roles/methods/update" data-stldocs-method="post"><span class="stl-ui-badge stl-ui-badge--size-sm stl-sidebar-icon stl-ui-badge--http stl-ui-badge--http-post" role="img" aria-label="POST"></span>Update a role</a></li><li class="stldocs-sidebar-entry stldocs-sidebar-entry-link"><a href="/api/reference/resources/admin/subresources/organization/subresources/roles/methods/delete" data-stldocs-method="delete"><span class="stl-ui-badge stl-ui-badge--size-sm stl-sidebar-icon stl-ui-badge--http stl-ui-badge--http-delete" role="img" aria-label="DELETE"></span>Delete a role</a></li><li class="stldocs-sidebar-entry stldocs-sidebar-entry-link"><a href="/api/reference/resources/admin/subresources/organization/subresources/roles/methods/list" data-stldocs-method="get"><span class="stl-ui-badge stl-ui-badge--size-sm stl-sidebar-icon stl-ui-badge--http stl-ui-badge--http-get" role="img" aria-label="GET"></span>List roles</a></li></ul></details></li><li class="stldocs-sidebar-entry stldocs-sidebar-entry-group"><details class="stldocs-sidebar-expander"><summary class="stldocs-expander-summary"><span>Spend Alerts</span><svg xmlns="http://www.w3.org/2000/svg" width="16" height="16" viewBox="0 0 24 24" fill="none" stroke="currentColor" stroke-width="1" stroke-linecap="round" stroke-linejoin="round" class="lucide lucide-chevron-right stldocs-icon stldocs-expander-summary-icon" aria-hidden="true"><path d="m9 18 6-6-6-6"></path></svg></summary><ul class="stldocs-sidebar-list"><li class="stldocs-sidebar-entry stldocs-sidebar-entry-link"><a href="/api/reference/resources/admin/subresources/organization/subresources/spend_alerts/methods/create" data-stldocs-method="post"><span class="stl-ui-badge stl-ui-badge--size-sm stl-sidebar-icon stl-ui-badge--http stl-ui-badge--http-post" role="img" aria-label="POST"></span>Create a spend alert</a></li><li class="stldocs-sidebar-entry stldocs-sidebar-entry-link"><a href="/api/reference/resources/admin/subresources/organization/subresources/spend_alerts/methods/retrieve" data-stldocs-method="get"><span class="stl-ui-badge stl-ui-badge--size-sm stl-sidebar-icon stl-ui-badge--http stl-ui-badge--http-get" role="img" aria-label="GET"></span>Retrieve a spend alert</a></li><li class="stldocs-sidebar-entry stldocs-sidebar-entry-link"><a href="/api/reference/resources/admin/subresources/organization/subresources/spend_alerts/methods/update" data-stldocs-method="post"><span class="stl-ui-badge stl-ui-badge--size-sm stl-sidebar-icon stl-ui-badge--http stl-ui-badge--http-post" role="img" aria-label="POST"></span>Update a spend alert</a></li><li class="stldocs-sidebar-entry stldocs-sidebar-entry-link"><a href="/api/reference/resources/admin/subresources/organization/subresources/spend_alerts/methods/delete" data-stldocs-method="delete"><span class="stl-ui-badge stl-ui-badge--size-sm stl-sidebar-icon stl-ui-badge--http stl-ui-badge--http-delete" role="img" aria-label="DELETE"></span>Delete a spend alert</a></li><li class="stldocs-sidebar-entry stldocs-sidebar-entry-link"><a href="/api/reference/resources/admin/subresources/organization/subresources/spend_alerts/methods/list" data-stldocs-method="get"><span class="stl-ui-badge stl-ui-badge--size-sm stl-sidebar-icon stl-ui-badge--http stl-ui-badge--http-get" role="img" aria-label="GET"></span>List spend alerts</a></li></ul></details></li><li class="stldocs-sidebar-entry stldocs-sidebar-entry-group"><details class="stldocs-sidebar-expander"><summary class="stldocs-expander-summary"><span>Spend Limit</span><svg xmlns="http://www.w3.org/2000/svg" width="16" height="16" viewBox="0 0 24 24" fill="none" stroke="currentColor" stroke-width="1" stroke-linecap="round" stroke-linejoin="round" class="lucide lucide-chevron-right stldocs-icon stldocs-expander-summary-icon" aria-hidden="true"><path d="m9 18 6-6-6-6"></path></svg></summary><ul class="stldocs-sidebar-list"><li class="stldocs-sidebar-entry stldocs-sidebar-entry-link"><a href="/api/reference/resources/admin/subresources/organization/subresources/spend_limit/methods/retrieve" data-stldocs-method="get"><span class="stl-ui-badge stl-ui-badge--size-sm stl-sidebar-icon stl-ui-badge--http stl-ui-badge--http-get" role="img" aria-label="GET"></span>Retrieve a spend limit</a></li><li class="stldocs-sidebar-entry stldocs-sidebar-entry-link"><a href="/api/reference/resources/admin/subresources/organization/subresources/spend_limit/methods/update" data-stldocs-method="post"><span class="stl-ui-badge stl-ui-badge--size-sm stl-sidebar-icon stl-ui-badge--http stl-ui-badge--http-post" role="img" aria-label="POST"></span>Update a spend limit</a></li><li class="stldocs-sidebar-entry stldocs-sidebar-entry-link"><a href="/api/reference/resources/admin/subresources/organization/subresources/spend_limit/methods/delete" data-stldocs-method="delete"><span class="stl-ui-badge stl-ui-badge--size-sm stl-sidebar-icon stl-ui-badge--http stl-ui-badge--http-delete" role="img" aria-label="DELETE"></span>Delete a spend limit</a></li></ul></details></li><li class="stldocs-sidebar-entry stldocs-sidebar-entry-group"><details class="stldocs-sidebar-expander"><summary class="stldocs-expander-summary"><span>Usage</span><svg xmlns="http://www.w3.org/2000/svg" width="16" height="16" viewBox="0 0 24 24" fill="none" stroke="currentColor" stroke-width="1" stroke-linecap="round" stroke-linejoin="round" class="lucide lucide-chevron-right stldocs-icon stldocs-expander-summary-icon" aria-hidden="true"><path d="m9 18 6-6-6-6"></path></svg></summary><ul class="stldocs-sidebar-list"><li class="stldocs-sidebar-entry stldocs-sidebar-entry-link"><a href="/api/reference/resources/admin/subresources/organization/subresources/usage/methods/audio_speeches" data-stldocs-method="get"><span class="stl-ui-badge stl-ui-badge--size-sm stl-sidebar-icon stl-ui-badge--http stl-ui-badge--http-get" role="img" aria-label="GET"></span>Audio Speeches</a></li><li class="stldocs-sidebar-entry stldocs-sidebar-entry-link"><a href="/api/reference/resources/admin/subresources/organization/subresources/usage/methods/audio_transcriptions" data-stldocs-method="get"><span class="stl-ui-badge stl-ui-badge--size-sm stl-sidebar-icon stl-ui-badge--http stl-ui-badge--http-get" role="img" aria-label="GET"></span>Audio Transcriptions</a></li><li class="stldocs-sidebar-entry stldocs-sidebar-entry-link"><a href="/api/reference/resources/admin/subresources/organization/subresources/usage/methods/code_interpreter_sessions" data-stldocs-method="get"><span class="stl-ui-badge stl-ui-badge--size-sm stl-sidebar-icon stl-ui-badge--http stl-ui-badge--http-get" role="img" aria-label="GET"></span>Code Interpreter Sessions</a></li><li class="stldocs-sidebar-entry stldocs-sidebar-entry-link"><a href="/api/reference/resources/admin/subresources/organization/subresources/usage/methods/completions" data-stldocs-method="get"><span class="stl-ui-badge stl-ui-badge--size-sm stl-sidebar-icon stl-ui-badge--http stl-ui-badge--http-get" role="img" aria-label="GET"></span>Completions</a></li><li class="stldocs-sidebar-entry stldocs-sidebar-entry-link"><a href="/api/reference/resources/admin/subresources/organization/subresources/usage/methods/costs" data-stldocs-method="get"><span class="stl-ui-badge stl-ui-badge--size-sm stl-sidebar-icon stl-ui-badge--http stl-ui-badge--http-get" role="img" aria-label="GET"></span>Costs</a></li><li class="stldocs-sidebar-entry stldocs-sidebar-entry-link"><a href="/api/reference/resources/admin/subresources/organization/subresources/usage/methods/embeddings" data-stldocs-method="get"><span class="stl-ui-badge stl-ui-badge--size-sm stl-sidebar-icon stl-ui-badge--http stl-ui-badge--http-get" role="img" aria-label="GET"></span>Embeddings</a></li><li class="stldocs-sidebar-entry stldocs-sidebar-entry-link"><a href="/api/reference/resources/admin/subresources/organization/subresources/usage/methods/file_search_calls" data-stldocs-method="get"><span class="stl-ui-badge stl-ui-badge--size-sm stl-sidebar-icon stl-ui-badge--http stl-ui-badge--http-get" role="img" aria-label="GET"></span>File Search Calls</a></li><li class="stldocs-sidebar-entry stldocs-sidebar-entry-link"><a href="/api/reference/resources/admin/subresources/organization/subresources/usage/methods/images" data-stldocs-method="get"><span class="stl-ui-badge stl-ui-badge--size-sm stl-sidebar-icon stl-ui-badge--http stl-ui-badge--http-get" role="img" aria-label="GET"></span>Images</a></li><li class="stldocs-sidebar-entry stldocs-sidebar-entry-link"><a href="/api/reference/resources/admin/subresources/organization/subresources/usage/methods/moderations" data-stldocs-method="get"><span class="stl-ui-badge stl-ui-badge--size-sm stl-sidebar-icon stl-ui-badge--http stl-ui-badge--http-get" role="img" aria-label="GET"></span>Moderations</a></li><li class="stldocs-sidebar-entry stldocs-sidebar-entry-link"><a href="/api/reference/resources/admin/subresources/organization/subresources/usage/methods/vector_stores" data-stldocs-method="get"><span class="stl-ui-badge stl-ui-badge--size-sm stl-sidebar-icon stl-ui-badge--http stl-ui-badge--http-get" role="img" aria-label="GET"></span>Vector Stores</a></li><li class="stldocs-sidebar-entry stldocs-sidebar-entry-link"><a href="/api/reference/resources/admin/subresources/organization/subresources/usage/methods/web_search_calls" data-stldocs-method="get"><span class="stl-ui-badge stl-ui-badge--size-sm stl-sidebar-icon stl-ui-badge--http stl-ui-badge--http-get" role="img" aria-label="GET"></span>Web Search Calls</a></li></ul></details></li><li class="stldocs-sidebar-entry stldocs-sidebar-entry-group"><details class="stldocs-sidebar-expander"><summary class="stldocs-expander-summary"><span>Users</span><svg xmlns="http://www.w3.org/2000/svg" width="16" height="16" viewBox="0 0 24 24" fill="none" stroke="currentColor" stroke-width="1" stroke-linecap="round" stroke-linejoin="round" class="lucide lucide-chevron-right stldocs-icon stldocs-expander-summary-icon" aria-hidden="true"><path d="m9 18 6-6-6-6"></path></svg></summary><ul class="stldocs-sidebar-list"><li class="stldocs-sidebar-entry stldocs-sidebar-entry-link"><a href="/api/reference/resources/admin/subresources/organization/subresources/users/methods/retrieve" data-stldocs-method="get"><span class="stl-ui-badge stl-ui-badge--size-sm stl-sidebar-icon stl-ui-badge--http stl-ui-badge--http-get" role="img" aria-label="GET"></span>Retrieve an user</a></li><li class="stldocs-sidebar-entry stldocs-sidebar-entry-link"><a href="/api/reference/resources/admin/subresources/organization/subresources/users/methods/update" data-stldocs-method="post"><span class="stl-ui-badge stl-ui-badge--size-sm stl-sidebar-icon stl-ui-badge--http stl-ui-badge--http-post" role="img" aria-label="POST"></span>Update an user</a></li><li class="stldocs-sidebar-entry stldocs-sidebar-entry-link"><a href="/api/reference/resources/admin/subresources/organization/subresources/users/methods/delete" data-stldocs-method="delete"><span class="stl-ui-badge stl-ui-badge--size-sm stl-sidebar-icon stl-ui-badge--http stl-ui-badge--http-delete" role="img" aria-label="DELETE"></span>Delete an user</a></li><li class="stldocs-sidebar-entry stldocs-sidebar-entry-link"><a href="/api/reference/resources/admin/subresources/organization/subresources/users/methods/list" data-stldocs-method="get"><span class="stl-ui-badge stl-ui-badge--size-sm stl-sidebar-icon stl-ui-badge--http stl-ui-badge--http-get" role="img" aria-label="GET"></span>List users</a></li><li class="stldocs-sidebar-entry stldocs-sidebar-entry-group"><details class="stldocs-sidebar-expander"><summary class="stldocs-expander-summary"><span>Roles</span><svg xmlns="http://www.w3.org/2000/svg" width="16" height="16" viewBox="0 0 24 24" fill="none" stroke="currentColor" stroke-width="1" stroke-linecap="round" stroke-linejoin="round" class="lucide lucide-chevron-right stldocs-icon stldocs-expander-summary-icon" aria-hidden="true"><path d="m9 18 6-6-6-6"></path></svg></summary><ul class="stldocs-sidebar-list"><li class="stldocs-sidebar-entry stldocs-sidebar-entry-link"><a href="/api/reference/resources/admin/subresources/organization/subresources/users/subresources/roles/methods/create" data-stldocs-method="post"><span class="stl-ui-badge stl-ui-badge--size-sm stl-sidebar-icon stl-ui-badge--http stl-ui-badge--http-post" role="img" aria-label="POST"></span>Create a role</a></li><li class="stldocs-sidebar-entry stldocs-sidebar-entry-link"><a href="/api/reference/resources/admin/subresources/organization/subresources/users/subresources/roles/methods/retrieve" data-stldocs-method="get"><span class="stl-ui-badge stl-ui-badge--size-sm stl-sidebar-icon stl-ui-badge--http stl-ui-badge--http-get" role="img" aria-label="GET"></span>Retrieve a role</a></li><li class="stldocs-sidebar-entry stldocs-sidebar-entry-link"><a href="/api/reference/resources/admin/subresources/organization/subresources/users/subresources/roles/methods/delete" data-stldocs-method="delete"><span class="stl-ui-badge stl-ui-badge--size-sm stl-sidebar-icon stl-ui-badge--http stl-ui-badge--http-delete" role="img" aria-label="DELETE"></span>Delete a role</a></li><li class="stldocs-sidebar-entry stldocs-sidebar-entry-link"><a href="/api/reference/resources/admin/subresources/organization/subresources/users/subresources/roles/methods/list" data-stldocs-method="get"><span class="stl-ui-badge stl-ui-badge--size-sm stl-sidebar-icon stl-ui-badge--http stl-ui-badge--http-get" role="img" aria-label="GET"></span>List roles</a></li></ul></details></li></ul></details></li></ul></div></li><li class="stldocs-sidebar-entry stldocs-sidebar-entry-group"><div class="stldocs-sidebar-expander"><div class="stldocs-expander-summary"><span>Chat Completions</span></div><ul class="stldocs-sidebar-list"><li class="stldocs-sidebar-entry stldocs-sidebar-entry-group"><details class="stldocs-sidebar-expander"><summary class="stldocs-expander-summary"><span>Chat Completions</span><svg xmlns="http://www.w3.org/2000/svg" width="16" height="16" viewBox="0 0 24 24" fill="none" stroke="currentColor" stroke-width="1" stroke-linecap="round" stroke-linejoin="round" class="lucide lucide-chevron-right stldocs-icon stldocs-expander-summary-icon" aria-hidden="true"><path d="m9 18 6-6-6-6"></path></svg></summary><ul class="stldocs-sidebar-list"><li class="stldocs-sidebar-entry stldocs-sidebar-entry-link"><a href="/api/reference/chat-completions/overview">Overview</a></li><li class="stldocs-sidebar-entry stldocs-sidebar-entry-link"><a href="/api/reference/resources/chat/subresources/completions/methods/create" data-stldocs-method="post"><span class="stl-ui-badge stl-ui-badge--size-sm stl-sidebar-icon stl-ui-badge--http stl-ui-badge--http-post" role="img" aria-label="POST"></span>Create a chat completion</a></li><li class="stldocs-sidebar-entry stldocs-sidebar-entry-link"><a href="/api/reference/resources/chat/subresources/completions/methods/retrieve" data-stldocs-method="get"><span class="stl-ui-badge stl-ui-badge--size-sm stl-sidebar-icon stl-ui-badge--http stl-ui-badge--http-get" role="img" aria-label="GET"></span>Retrieve a chat completion</a></li><li class="stldocs-sidebar-entry stldocs-sidebar-entry-link"><a href="/api/reference/resources/chat/subresources/completions/methods/update" data-stldocs-method="post"><span class="stl-ui-badge stl-ui-badge--size-sm stl-sidebar-icon stl-ui-badge--http stl-ui-badge--http-post" role="img" aria-label="POST"></span>Update a chat completion</a></li><li class="stldocs-sidebar-entry stldocs-sidebar-entry-link"><a href="/api/reference/resources/chat/subresources/completions/methods/delete" data-stldocs-method="delete"><span class="stl-ui-badge stl-ui-badge--size-sm stl-sidebar-icon stl-ui-badge--http stl-ui-badge--http-delete" role="img" aria-label="DELETE"></span>Delete a chat completion</a></li><li class="stldocs-sidebar-entry stldocs-sidebar-entry-link"><a href="/api/reference/resources/chat/subresources/completions/methods/list" data-stldocs-method="get"><span class="stl-ui-badge stl-ui-badge--size-sm stl-sidebar-icon stl-ui-badge--http stl-ui-badge--http-get" role="img" aria-label="GET"></span>List chat completions</a></li><li class="stldocs-sidebar-entry stldocs-sidebar-entry-link"><a href="/api/reference/resources/chat/subresources/completions/subresources/messages/methods/list" data-stldocs-method="get"><span class="stl-ui-badge stl-ui-badge--size-sm stl-sidebar-icon stl-ui-badge--http stl-ui-badge--http-get" role="img" aria-label="GET"></span>List chat completions</a></li><li class="stldocs-sidebar-entry stldocs-sidebar-entry-link"><a href="/api/reference/resources/chat/subresources/completions/streaming-events">Streaming events</a></li></ul></details></li></ul></div></li><li class="stldocs-sidebar-entry stldocs-sidebar-entry-group"><div class="stldocs-sidebar-expander"><div class="stldocs-expander-summary"><span>Legacy</span></div><ul class="stldocs-sidebar-list"><li class="stldocs-sidebar-entry stldocs-sidebar-entry-group"><details class="stldocs-sidebar-expander"><summary class="stldocs-expander-summary"><span>Realtime Beta</span><svg xmlns="http://www.w3.org/2000/svg" width="16" height="16" viewBox="0 0 24 24" fill="none" stroke="currentColor" stroke-width="1" stroke-linecap="round" stroke-linejoin="round" class="lucide lucide-chevron-right stldocs-icon stldocs-expander-summary-icon" aria-hidden="true"><path d="m9 18 6-6-6-6"></path></svg></summary><ul class="stldocs-sidebar-list"><li class="stldocs-sidebar-entry stldocs-sidebar-entry-link"><a href="/api/reference/realtime-beta/overview">Overview</a></li><li class="stldocs-sidebar-entry stldocs-sidebar-entry-group"><details class="stldocs-sidebar-expander"><summary class="stldocs-expander-summary"><span>Sessions</span><svg xmlns="http://www.w3.org/2000/svg" width="16" height="16" viewBox="0 0 24 24" fill="none" stroke="currentColor" stroke-width="1" stroke-linecap="round" stroke-linejoin="round" class="lucide lucide-chevron-right stldocs-icon stldocs-expander-summary-icon" aria-hidden="true"><path d="m9 18 6-6-6-6"></path></svg></summary><ul class="stldocs-sidebar-list"><li class="stldocs-sidebar-entry stldocs-sidebar-entry-link"><a href="/api/reference/resources/realtime/subresources/sessions/methods/create" data-stldocs-method="post"><span class="stl-ui-badge stl-ui-badge--size-sm stl-sidebar-icon stl-ui-badge--http stl-ui-badge--http-post" role="img" aria-label="POST"></span>Create a session</a></li></ul></details></li><li class="stldocs-sidebar-entry stldocs-sidebar-entry-group"><details class="stldocs-sidebar-expander"><summary class="stldocs-expander-summary"><span>Transcription Sessions</span><svg xmlns="http://www.w3.org/2000/svg" width="16" height="16" viewBox="0 0 24 24" fill="none" stroke="currentColor" stroke-width="1" stroke-linecap="round" stroke-linejoin="round" class="lucide lucide-chevron-right stldocs-icon stldocs-expander-summary-icon" aria-hidden="true"><path d="m9 18 6-6-6-6"></path></svg></summary><ul class="stldocs-sidebar-list"><li class="stldocs-sidebar-entry stldocs-sidebar-entry-link"><a href="/api/reference/resources/realtime/subresources/transcription_sessions/methods/create" data-stldocs-method="post"><span class="stl-ui-badge stl-ui-badge--size-sm stl-sidebar-icon stl-ui-badge--http stl-ui-badge--http-post" role="img" aria-label="POST"></span>Create a transcription session</a></li></ul></details></li></ul></details></li><li class="stldocs-sidebar-entry stldocs-sidebar-entry-group"><details class="stldocs-sidebar-expander"><summary class="stldocs-expander-summary"><span>Assistants</span><svg xmlns="http://www.w3.org/2000/svg" width="16" height="16" viewBox="0 0 24 24" fill="none" stroke="currentColor" stroke-width="1" stroke-linecap="round" stroke-linejoin="round" class="lucide lucide-chevron-right stldocs-icon stldocs-expander-summary-icon" aria-hidden="true"><path d="m9 18 6-6-6-6"></path></svg></summary><ul class="stldocs-sidebar-list"><li class="stldocs-sidebar-entry stldocs-sidebar-entry-link"><a href="/api/reference/resources/beta/subresources/assistants/methods/create" data-stldocs-method="post"><span class="stl-ui-badge stl-ui-badge--size-sm stl-sidebar-icon stl-ui-badge--http stl-ui-badge--http-post" role="img" aria-label="POST"></span>Create an assistant</a></li><li class="stldocs-sidebar-entry stldocs-sidebar-entry-link"><a href="/api/reference/resources/beta/subresources/assistants/methods/retrieve" data-stldocs-method="get"><span class="stl-ui-badge stl-ui-badge--size-sm stl-sidebar-icon stl-ui-badge--http stl-ui-badge--http-get" role="img" aria-label="GET"></span>Retrieve an assistant</a></li><li class="stldocs-sidebar-entry stldocs-sidebar-entry-link"><a href="/api/reference/resources/beta/subresources/assistants/methods/update" data-stldocs-method="post"><span class="stl-ui-badge stl-ui-badge--size-sm stl-sidebar-icon stl-ui-badge--http stl-ui-badge--http-post" role="img" aria-label="POST"></span>Update an assistant</a></li><li class="stldocs-sidebar-entry stldocs-sidebar-entry-link"><a href="/api/reference/resources/beta/subresources/assistants/methods/delete" data-stldocs-method="delete"><span class="stl-ui-badge stl-ui-badge--size-sm stl-sidebar-icon stl-ui-badge--http stl-ui-badge--http-delete" role="img" aria-label="DELETE"></span>Delete an assistant</a></li><li class="stldocs-sidebar-entry stldocs-sidebar-entry-link"><a href="/api/reference/resources/beta/subresources/assistants/methods/list" data-stldocs-method="get"><span class="stl-ui-badge stl-ui-badge--size-sm stl-sidebar-icon stl-ui-badge--http stl-ui-badge--http-get" role="img" aria-label="GET"></span>List assistants</a></li><li class="stldocs-sidebar-entry stldocs-sidebar-entry-group"><details class="stldocs-sidebar-expander"><summary class="stldocs-expander-summary"><span>Threads</span><svg xmlns="http://www.w3.org/2000/svg" width="16" height="16" viewBox="0 0 24 24" fill="none" stroke="currentColor" stroke-width="1" stroke-linecap="round" stroke-linejoin="round" class="lucide lucide-chevron-right stldocs-icon stldocs-expander-summary-icon" aria-hidden="true"><path d="m9 18 6-6-6-6"></path></svg></summary><ul class="stldocs-sidebar-list"><li class="stldocs-sidebar-entry stldocs-sidebar-entry-link"><a href="/api/reference/resources/beta/subresources/threads/methods/create" data-stldocs-method="post"><span class="stl-ui-badge stl-ui-badge--size-sm stl-sidebar-icon stl-ui-badge--http stl-ui-badge--http-post" role="img" aria-label="POST"></span>Create a thread</a></li><li class="stldocs-sidebar-entry stldocs-sidebar-entry-link"><a href="/api/reference/resources/beta/subresources/threads/methods/create_and_run" data-stldocs-method="post"><span class="stl-ui-badge stl-ui-badge--size-sm stl-sidebar-icon stl-ui-badge--http stl-ui-badge--http-post" role="img" aria-label="POST"></span>Create And Run</a></li><li class="stldocs-sidebar-entry stldocs-sidebar-entry-link"><a href="/api/reference/resources/beta/subresources/threads/methods/retrieve" data-stldocs-method="get"><span class="stl-ui-badge stl-ui-badge--size-sm stl-sidebar-icon stl-ui-badge--http stl-ui-badge--http-get" role="img" aria-label="GET"></span>Retrieve a thread</a></li><li class="stldocs-sidebar-entry stldocs-sidebar-entry-link"><a href="/api/reference/resources/beta/subresources/threads/methods/update" data-stldocs-method="post"><span class="stl-ui-badge stl-ui-badge--size-sm stl-sidebar-icon stl-ui-badge--http stl-ui-badge--http-post" role="img" aria-label="POST"></span>Update a thread</a></li><li class="stldocs-sidebar-entry stldocs-sidebar-entry-link"><a href="/api/reference/resources/beta/subresources/threads/methods/delete" data-stldocs-method="delete"><span class="stl-ui-badge stl-ui-badge--size-sm stl-sidebar-icon stl-ui-badge--http stl-ui-badge--http-delete" role="img" aria-label="DELETE"></span>Delete a thread</a></li><li class="stldocs-sidebar-entry stldocs-sidebar-entry-group"><details class="stldocs-sidebar-expander"><summary class="stldocs-expander-summary"><span>Messages</span><svg xmlns="http://www.w3.org/2000/svg" width="16" height="16" viewBox="0 0 24 24" fill="none" stroke="currentColor" stroke-width="1" stroke-linecap="round" stroke-linejoin="round" class="lucide lucide-chevron-right stldocs-icon stldocs-expander-summary-icon" aria-hidden="true"><path d="m9 18 6-6-6-6"></path></svg></summary><ul class="stldocs-sidebar-list"><li class="stldocs-sidebar-entry stldocs-sidebar-entry-link"><a href="/api/reference/resources/beta/subresources/threads/subresources/messages/methods/create" data-stldocs-method="post"><span class="stl-ui-badge stl-ui-badge--size-sm stl-sidebar-icon stl-ui-badge--http stl-ui-badge--http-post" role="img" aria-label="POST"></span>Create a message</a></li><li class="stldocs-sidebar-entry stldocs-sidebar-entry-link"><a href="/api/reference/resources/beta/subresources/threads/subresources/messages/methods/retrieve" data-stldocs-method="get"><span class="stl-ui-badge stl-ui-badge--size-sm stl-sidebar-icon stl-ui-badge--http stl-ui-badge--http-get" role="img" aria-label="GET"></span>Retrieve a message</a></li><li class="stldocs-sidebar-entry stldocs-sidebar-entry-link"><a href="/api/reference/resources/beta/subresources/threads/subresources/messages/methods/update" data-stldocs-method="post"><span class="stl-ui-badge stl-ui-badge--size-sm stl-sidebar-icon stl-ui-badge--http stl-ui-badge--http-post" role="img" aria-label="POST"></span>Update a message</a></li><li class="stldocs-sidebar-entry stldocs-sidebar-entry-link"><a href="/api/reference/resources/beta/subresources/threads/subresources/messages/methods/delete" data-stldocs-method="delete"><span class="stl-ui-badge stl-ui-badge--size-sm stl-sidebar-icon stl-ui-badge--http stl-ui-badge--http-delete" role="img" aria-label="DELETE"></span>Delete a message</a></li><li class="stldocs-sidebar-entry stldocs-sidebar-entry-link"><a href="/api/reference/resources/beta/subresources/threads/subresources/messages/methods/list" data-stldocs-method="get"><span class="stl-ui-badge stl-ui-badge--size-sm stl-sidebar-icon stl-ui-badge--http stl-ui-badge--http-get" role="img" aria-label="GET"></span>List messages</a></li></ul></details></li><li class="stldocs-sidebar-entry stldocs-sidebar-entry-group"><details class="stldocs-sidebar-expander"><summary class="stldocs-expander-summary"><span>Runs</span><svg xmlns="http://www.w3.org/2000/svg" width="16" height="16" viewBox="0 0 24 24" fill="none" stroke="currentColor" stroke-width="1" stroke-linecap="round" stroke-linejoin="round" class="lucide lucide-chevron-right stldocs-icon stldocs-expander-summary-icon" aria-hidden="true"><path d="m9 18 6-6-6-6"></path></svg></summary><ul class="stldocs-sidebar-list"><li class="stldocs-sidebar-entry stldocs-sidebar-entry-link"><a href="/api/reference/resources/beta/subresources/threads/subresources/runs/methods/create" data-stldocs-method="post"><span class="stl-ui-badge stl-ui-badge--size-sm stl-sidebar-icon stl-ui-badge--http stl-ui-badge--http-post" role="img" aria-label="POST"></span>Create a run</a></li><li class="stldocs-sidebar-entry stldocs-sidebar-entry-link"><a href="/api/reference/resources/beta/subresources/threads/subresources/runs/methods/retrieve" data-stldocs-method="get"><span class="stl-ui-badge stl-ui-badge--size-sm stl-sidebar-icon stl-ui-badge--http stl-ui-badge--http-get" role="img" aria-label="GET"></span>Retrieve a run</a></li><li class="stldocs-sidebar-entry stldocs-sidebar-entry-link"><a href="/api/reference/resources/beta/subresources/threads/subresources/runs/methods/update" data-stldocs-method="post"><span class="stl-ui-badge stl-ui-badge--size-sm stl-sidebar-icon stl-ui-badge--http stl-ui-badge--http-post" role="img" aria-label="POST"></span>Update a run</a></li><li class="stldocs-sidebar-entry stldocs-sidebar-entry-link"><a href="/api/reference/resources/beta/subresources/threads/subresources/runs/methods/list" data-stldocs-method="get"><span class="stl-ui-badge stl-ui-badge--size-sm stl-sidebar-icon stl-ui-badge--http stl-ui-badge--http-get" role="img" aria-label="GET"></span>List runs</a></li><li class="stldocs-sidebar-entry stldocs-sidebar-entry-link"><a href="/api/reference/resources/beta/subresources/threads/subresources/runs/methods/cancel" data-stldocs-method="post"><span class="stl-ui-badge stl-ui-badge--size-sm stl-sidebar-icon stl-ui-badge--http stl-ui-badge--http-post" role="img" aria-label="POST"></span>Cancel a run</a></li><li class="stldocs-sidebar-entry stldocs-sidebar-entry-link"><a href="/api/reference/resources/beta/subresources/threads/subresources/runs/methods/submit_tool_outputs" data-stldocs-method="post"><span class="stl-ui-badge stl-ui-badge--size-sm stl-sidebar-icon stl-ui-badge--http stl-ui-badge--http-post" role="img" aria-label="POST"></span>Submit Tool Outputs</a></li><li class="stldocs-sidebar-entry stldocs-sidebar-entry-group"><details class="stldocs-sidebar-expander"><summary class="stldocs-expander-summary"><span>Steps</span><svg xmlns="http://www.w3.org/2000/svg" width="16" height="16" viewBox="0 0 24 24" fill="none" stroke="currentColor" stroke-width="1" stroke-linecap="round" stroke-linejoin="round" class="lucide lucide-chevron-right stldocs-icon stldocs-expander-summary-icon" aria-hidden="true"><path d="m9 18 6-6-6-6"></path></svg></summary><ul class="stldocs-sidebar-list"><li class="stldocs-sidebar-entry stldocs-sidebar-entry-link"><a href="/api/reference/resources/beta/subresources/threads/subresources/runs/subresources/steps/methods/retrieve" data-stldocs-method="get"><span class="stl-ui-badge stl-ui-badge--size-sm stl-sidebar-icon stl-ui-badge--http stl-ui-badge--http-get" role="img" aria-label="GET"></span>Retrieve a step</a></li><li class="stldocs-sidebar-entry stldocs-sidebar-entry-link"><a href="/api/reference/resources/beta/subresources/threads/subresources/runs/subresources/steps/methods/list" data-stldocs-method="get"><span class="stl-ui-badge stl-ui-badge--size-sm stl-sidebar-icon stl-ui-badge--http stl-ui-badge--http-get" role="img" aria-label="GET"></span>List steps</a></li></ul></details></li></ul></details></li></ul></details></li><li class="stldocs-sidebar-entry stldocs-sidebar-entry-link"><a href="/api/reference/resources/beta/subresources/assistants/streaming-events">Assistants streaming events</a></li></ul></details></li><li class="stldocs-sidebar-entry stldocs-sidebar-entry-group"><details class="stldocs-sidebar-expander"><summary class="stldocs-expander-summary"><span>Completions</span><svg xmlns="http://www.w3.org/2000/svg" width="16" height="16" viewBox="0 0 24 24" fill="none" stroke="currentColor" stroke-width="1" stroke-linecap="round" stroke-linejoin="round" class="lucide lucide-chevron-right stldocs-icon stldocs-expander-summary-icon" aria-hidden="true"><path d="m9 18 6-6-6-6"></path></svg></summary><ul class="stldocs-sidebar-list"><li class="stldocs-sidebar-entry stldocs-sidebar-entry-link"><a href="/api/reference/resources/completions/methods/create" data-stldocs-method="post"><span class="stl-ui-badge stl-ui-badge--size-sm stl-sidebar-icon stl-ui-badge--http stl-ui-badge--http-post" role="img" aria-label="POST"></span>Create a completion</a></li></ul></details></li></ul></div></li></ul></div> <script>
  const SIDEBAR_CONTAINER_SELECTOR = "#starlight__sidebar";
  const ACTIVE_ITEM_SELECTOR =
    "a[aria-current='page'], [aria-current='page'] a";
  const STORAGE_KEY = "starlight-sidebar-scroll";
  const INITIALIZED_ATTRIBUTE = "data-sidebar-scroll-initialized";
  const OVERVIEW_PATH = "/api/reference/overview";
  const OVERVIEW_INTRODUCTION_ID = "introduction";
  const MAIN_FRAME_SELECTOR = ".page > .main-frame, .page";
  const OVERVIEW_SECTION_SCROLL_OFFSET = 12;
  const OVERVIEW_HASH_PRIORITY_MS = 900;
  const MODEL_ANCHOR_LINK_SELECTOR =
    "a[href*='/api/reference/resources/'][href*='#(resource)']";

  let disposeOverviewSectionObserver = null;

  const isStorageAvailable = (() => {
    try {
      sessionStorage.setItem(`${STORAGE_KEY}-test`, "1");
      sessionStorage.removeItem(`${STORAGE_KEY}-test`);
      return true;
    } catch {
      return false;
    }
  })();

  const getSidebarContainer = () => {
    const container = document.querySelector(SIDEBAR_CONTAINER_SELECTOR);
    return container instanceof HTMLElement ? container : null;
  };

  const saveScrollPosition = (container) => {
    if (!isStorageAvailable) return;
    sessionStorage.setItem(STORAGE_KEY, String(container.scrollTop));
  };

  const restoreScrollPosition = (container) => {
    if (!isStorageAvailable) return false;

    const storedScrollTop = sessionStorage.getItem(STORAGE_KEY);
    if (storedScrollTop === null) return false;

    const parsedScrollTop = Number(storedScrollTop);
    if (!Number.isFinite(parsedScrollTop)) return false;

    container.scrollTop = parsedScrollTop;
    return true;
  };

  const isVisibleInContainer = (element, container) => {
    const elementRect = element.getBoundingClientRect();
    const containerRect = container.getBoundingClientRect();

    return (
      elementRect.bottom > containerRect.top &&
      elementRect.top < containerRect.bottom
    );
  };

  const scrollActiveSidebarItemToMiddle = (container, activeItem) => {
    const targetTop =
      activeItem.getBoundingClientRect().top -
      container.getBoundingClientRect().top +
      container.scrollTop -
      container.clientHeight / 2 +
      activeItem.clientHeight / 2;

    container.scrollTo({
      top: Math.max(0, targetTop),
      behavior: "auto",
    });
  };

  const setupSidebar = () => {
    const container = getSidebarContainer();
    if (!container || container.getAttribute(INITIALIZED_ATTRIBUTE) === "true")
      return;

    container.addEventListener(
      "scroll",
      () => {
        saveScrollPosition(container);
      },
      { passive: true }
    );

    container.setAttribute(INITIALIZED_ATTRIBUTE, "true");
  };

  const persistScrollPosition = () => {
    const container = getSidebarContainer();
    if (!container) return;
    saveScrollPosition(container);
  };

  const restoreAndMaybeCenter = () => {
    const container = getSidebarContainer();
    if (!container) return;

    const hasStoredScrollPosition = restoreScrollPosition(container);
    if (!matchMedia("(min-width: 50em)").matches) return;

    const activeItem = container.querySelector(ACTIVE_ITEM_SELECTOR);
    if (!(activeItem instanceof HTMLElement)) return;

    const shouldCenter =
      !hasStoredScrollPosition || !isVisibleInContainer(activeItem, container);

    if (shouldCenter) {
      scrollActiveSidebarItemToMiddle(container, activeItem);
    }
  };

  const initialize = () => {
    setupSidebar();
    setupOverviewSectionHighlight();
    syncModelAnchorSidebarActiveState();
    // Wait a frame so sidebar DOM/layout settles after client navigation.
    requestAnimationFrame(restoreAndMaybeCenter);
  };

  const normalizePathname = (pathname) => pathname.replace(/\/+$/, "") || "/";
  const normalizeHash = (hash) =>
    decodeURIComponent(hash.replace(/^#/, "")).trim();
  const prefersReducedMotion = () =>
    window.matchMedia("(prefers-reduced-motion: reduce)").matches;

  const isScrollableElement = (element) => {
    if (!(element instanceof HTMLElement)) return false;

    const style = window.getComputedStyle(element);
    const overflowY = style.overflowY;
    const allowsScroll =
      overflowY === "auto" || overflowY === "scroll" || overflowY === "overlay";

    return allowsScroll && element.scrollHeight > element.clientHeight + 1;
  };

  const getMainScrollContainer = () => {
    const candidates = document.querySelectorAll(MAIN_FRAME_SELECTOR);
    for (const candidate of candidates) {
      if (isScrollableElement(candidate)) {
        return candidate;
      }
    }

    return null;
  };

  const scrollOverviewHeadingIntoView = (heading) => {
    const behavior = prefersReducedMotion() ? "auto" : "smooth";
    const mainFrame = getMainScrollContainer();

    if (mainFrame instanceof HTMLElement) {
      const targetTop =
        heading.getBoundingClientRect().top -
        mainFrame.getBoundingClientRect().top +
        mainFrame.scrollTop -
        OVERVIEW_SECTION_SCROLL_OFFSET;

      mainFrame.scrollTo({
        top: Math.max(0, targetTop),
        behavior,
      });
      return;
    }

    heading.scrollIntoView({ behavior, block: "start" });
  };

  const syncModelAnchorSidebarActiveState = () => {
    if (typeof window === "undefined") return;

    const sidebarContainer = getSidebarContainer();
    if (!sidebarContainer) return;

    const currentPathname = normalizePathname(window.location.pathname);
    const currentHash = normalizeHash(window.location.hash);
    const hasCurrentHash = currentHash.length > 0;

    const modelAnchorLinks = Array.from(
      sidebarContainer.querySelectorAll(MODEL_ANCHOR_LINK_SELECTOR)
    ).filter((link) => link instanceof HTMLAnchorElement);

    modelAnchorLinks.forEach((link) => {
      const linkUrl = new URL(link.href, window.location.origin);
      const linkPath = normalizePathname(linkUrl.pathname);
      const linkHash = normalizeHash(linkUrl.hash);
      const isActive =
        hasCurrentHash &&
        linkPath === currentPathname &&
        linkHash === currentHash;

      if (isActive) {
        link.setAttribute("aria-current", "page");
      } else {
        link.removeAttribute("aria-current");
      }
    });
  };

  const setupOverviewSectionHighlight = () => {
    if (typeof window === "undefined") return;

    disposeOverviewSectionObserver?.();
    disposeOverviewSectionObserver = null;

    if (
      normalizePathname(window.location.pathname) !==
      normalizePathname(OVERVIEW_PATH)
    ) {
      return;
    }

    const sidebarContainer = getSidebarContainer();
    if (!sidebarContainer) return;

    const sectionLinks = Array.from(
      sidebarContainer.querySelectorAll("a[href]")
    ).filter((link) => {
      if (!(link instanceof HTMLAnchorElement)) return false;
      const url = new URL(link.href, window.location.origin);
      return (
        normalizePathname(url.pathname) === normalizePathname(OVERVIEW_PATH)
      );
    });

    if (sectionLinks.length <= 1) return;

    const introLink = sectionLinks.find((link) => {
      const url = new URL(link.href, window.location.origin);
      return !url.hash;
    });
    const hashedLinks = sectionLinks.filter((link) => {
      const url = new URL(link.href, window.location.origin);
      return Boolean(url.hash);
    });

    const sectionTargets = [];
    if (introLink) {
      const introHeading =
        document.getElementById(OVERVIEW_INTRODUCTION_ID) ??
        document.querySelector("main h2[id]");
      if (introHeading instanceof HTMLElement) {
        sectionTargets.push({
          id: introHeading.id,
          heading: introHeading,
          link: introLink,
        });
      }
    }

    for (const link of hashedLinks) {
      const url = new URL(link.href, window.location.origin);
      const id = decodeURIComponent(url.hash.slice(1));
      const heading = document.getElementById(id);
      if (!(heading instanceof HTMLElement)) continue;
      sectionTargets.push({ id, heading, link });
    }

    if (sectionTargets.length <= 1) return;

    let bottomSentinelVisible = false;
    let hashPriorityUntil = 0;
    const intersectionState = new Map();
    const targetIndexById = new Map(
      sectionTargets.map(({ id }, index) => [id, index])
    );
    const introTargetIndex = introLink
      ? sectionTargets.findIndex(({ link }) => link === introLink)
      : -1;

    const applyActiveLink = (activeIndex) => {
      sectionTargets.forEach(({ link }, index) => {
        if (index === activeIndex) {
          link.setAttribute("aria-current", "page");
        } else {
          link.removeAttribute("aria-current");
        }
      });
    };

    const getActiveIndex = () => {
      if (bottomSentinelVisible) return sectionTargets.length - 1;

      const activationOffset = Math.min(window.innerHeight * 0.3, 180);
      let index = 0;
      for (let i = 0; i < sectionTargets.length; i += 1) {
        const { heading } = sectionTargets[i];
        if (heading.getBoundingClientRect().top <= activationOffset) {
          index = i;
          continue;
        }
        break;
      }

      return index;
    };

    const applyActiveLinkFromLocation = () => {
      const currentHash = normalizeHash(window.location.hash);
      if (!currentHash) return false;

      const hashMatchIndex = targetIndexById.get(currentHash);
      if (typeof hashMatchIndex === "number") {
        applyActiveLink(hashMatchIndex);
        return true;
      }

      return false;
    };

    const refreshHashPriorityWindow = () => {
      hashPriorityUntil = performance.now() + OVERVIEW_HASH_PRIORITY_MS;
    };

    const updateActiveLink = () => {
      if (
        performance.now() < hashPriorityUntil &&
        applyActiveLinkFromLocation()
      ) {
        return;
      }

      const hasIntersectingSection =
        bottomSentinelVisible ||
        Array.from(intersectionState.values()).some(
          (isIntersecting) => isIntersecting
        );
      if (!hasIntersectingSection) return;

      applyActiveLink(getActiveIndex());
    };

    const sectionObserver = new IntersectionObserver(
      (entries) => {
        for (const entry of entries) {
          intersectionState.set(entry.target, entry.isIntersecting);
        }
        updateActiveLink();
      },
      {
        root: null,
        threshold: 0,
        rootMargin: "-20% 0px -65% 0px",
      }
    );

    for (const { heading } of sectionTargets) {
      intersectionState.set(heading, false);
      sectionObserver.observe(heading);
    }

    const bottomSentinel = document.createElement("div");
    bottomSentinel.setAttribute("data-api-overview-bottom-sentinel", "true");
    bottomSentinel.style.cssText =
      "position: relative; width: 1px; height: 1px; pointer-events: none;";

    const mainContent =
      document.querySelector("main .sl-markdown-content") ??
      document.querySelector("main");
    if (!(mainContent instanceof HTMLElement)) {
      sectionObserver.disconnect();
      return;
    }
    mainContent.append(bottomSentinel);

    const bottomObserver = new IntersectionObserver(
      (entries) => {
        bottomSentinelVisible = entries.some((entry) => entry.isIntersecting);
        updateActiveLink();
      },
      {
        root: null,
        threshold: 0,
      }
    );
    bottomObserver.observe(bottomSentinel);

    const onOverviewHashChange = () => {
      refreshHashPriorityWindow();
      applyActiveLinkFromLocation();
    };
    window.addEventListener("hashchange", onOverviewHashChange);

    const onOverviewLinkClick = (event) => {
      if (
        event.defaultPrevented ||
        event.button !== 0 ||
        event.metaKey ||
        event.ctrlKey ||
        event.shiftKey ||
        event.altKey
      ) {
        return;
      }

      const link = event.currentTarget;
      if (!(link instanceof HTMLAnchorElement)) return;

      const linkUrl = new URL(link.href, window.location.origin);
      if (
        normalizePathname(linkUrl.pathname) !== normalizePathname(OVERVIEW_PATH)
      ) {
        return;
      }

      const targetId =
        normalizeHash(linkUrl.hash) ||
        sectionTargets[introTargetIndex >= 0 ? introTargetIndex : 0]?.id;
      if (!targetId) return;

      const targetIndex = targetIndexById.get(targetId);
      if (typeof targetIndex !== "number") return;

      const { heading } = sectionTargets[targetIndex];
      if (!(heading instanceof HTMLElement)) return;

      event.preventDefault();
      applyActiveLink(targetIndex);
      scrollOverviewHeadingIntoView(heading);
      refreshHashPriorityWindow();

      history.pushState(
        null,
        "",
        `${linkUrl.pathname}${linkUrl.search}${linkUrl.hash}`
      );
    };

    for (const { link } of sectionTargets) {
      link.addEventListener("click", onOverviewLinkClick);
    }

    applyActiveLinkFromLocation();
    updateActiveLink();

    disposeOverviewSectionObserver = () => {
      sectionObserver.disconnect();
      bottomObserver.disconnect();
      bottomSentinel.remove();
      window.removeEventListener("hashchange", onOverviewHashChange);
      for (const { link } of sectionTargets) {
        link.removeEventListener("click", onOverviewLinkClick);
      }
    };
  };

  document.addEventListener("DOMContentLoaded", initialize);
  document.addEventListener("astro:page-load", initialize);
  document.addEventListener("astro:after-swap", initialize);
  window.addEventListener("hashchange", syncModelAnchorSidebarActiveState);

  document.addEventListener("astro:before-swap", persistScrollPosition);
  document.addEventListener("astro:before-swap", () => {
    disposeOverviewSectionObserver?.();
    disposeOverviewSectionObserver = null;
  });
  window.addEventListener("beforeunload", persistScrollPosition);
  window.addEventListener("beforeunload", () => {
    disposeOverviewSectionObserver?.();
    disposeOverviewSectionObserver = null;
  });

  initialize();
</script> </div> </nav>      <script type="module">const a=document.getElementById("starlight__sidebar"),n=a?.querySelector("sl-sidebar-state-persist"),o="sl-sidebar-state",i=()=>{let t=[];const e=n?.dataset.hash||"";try{const s=sessionStorage.getItem(o),r=JSON.parse(s||"{}");Array.isArray(r.open)&&r.hash===e&&(t=r.open)}catch{}return{hash:e,open:t,scroll:a?.scrollTop||0}},c=t=>{try{sessionStorage.setItem(o,JSON.stringify(t))}catch{}},d=()=>c(i()),l=(t,e)=>{const s=i();s.open[e]=t,c(s)};n?.addEventListener("click",t=>{if(!(t.target instanceof Element))return;const e=t.target.closest("summary")?.closest("details");if(!e)return;const s=e.querySelector("sl-sidebar-restore"),r=parseInt(s?.dataset.index||"");isNaN(r)||l(!e.open,r)});addEventListener("visibilitychange",()=>{document.visibilityState==="hidden"&&d()});addEventListener("pageHide",d);</script>   <main data-pagefind-body class="astro-i35jzdbg" lang="en" dir="ltr">    <div class="stl-ui-prose stl-content-panel astro-b5jjb557">  <div class="stl-ui-not-prose stl-page-nav-container stl-prose-page-nav-container astro-zd6xmrrb" data-pagefind-ignore><div class="stl-content-breadcrumbs stldocs-root"><div class="stldocs-breadcrumbs"><div class="stldocs-breadcrumbs-item"><span class="stldocs-breadcrumbs-non-link">API Reference</span></div><svg xmlns="http://www.w3.org/2000/svg" width="24" height="24" viewBox="0 0 24 24" fill="none" stroke="currentColor" stroke-width="2" stroke-linecap="round" stroke-linejoin="round" class="lucide lucide-chevron-right" aria-hidden="true"><path d="m9 18 6-6-6-6"></path></svg><div class="stldocs-breadcrumbs-item"><a href="/api/reference/overview" class="stldocs-breadcrumbs-link">Introduction</a></div></div></div></div><h1 id="_top" class="astro-wikk2uhu">API Overview</h1>  </div> <div class="stl-ui-prose stl-content-panel astro-b5jjb557">  <div class="sl-markdown-content">  <div class="api-reference-custom-content" data-api-anchor-links data-api-anchor-offset="28" data-api-anchor-behavior="instant"> <p>Use this reference to look up OpenAI API endpoints, request and response
schemas, streaming events, client library methods, and shared behavior such as
authentication, errors, rate limits, and request IDs.</p>
<div class="sl-heading-wrapper level-h2"><h2 id="start-here">Start here</h2><a class="sl-anchor-link" href="#start-here"><span aria-hidden="true" class="sl-anchor-icon"><svg width="16" height="16" viewBox="0 0 24 24"><path fill="currentcolor" d="m12.11 15.39-3.88 3.88a2.52 2.52 0 0 1-3.5 0 2.47 2.47 0 0 1 0-3.5l3.88-3.88a1 1 0 0 0-1.42-1.42l-3.88 3.89a4.48 4.48 0 0 0 6.33 6.33l3.89-3.88a1 1 0 1 0-1.42-1.42Zm8.58-12.08a4.49 4.49 0 0 0-6.33 0l-3.89 3.88a1 1 0 0 0 1.42 1.42l3.88-3.88a2.52 2.52 0 0 1 3.5 0 2.47 2.47 0 0 1 0 3.5l-3.88 3.88a1 1 0 1 0 1.42 1.42l3.88-3.89a4.49 4.49 0 0 0 0-6.33ZM8.83 15.17a1 1 0 0 0 1.1.22 1 1 0 0 0 .32-.22l4.92-4.92a1 1 0 0 0-1.42-1.42l-4.92 4.92a1 1 0 0 0 0 1.42Z"></path></svg></span><span class="sr-only" data-pagefind-ignore="true">Section titled “Start here”</span></a></div>
<ol>
<li>Choose the API surface for your application:
<ul>
<li><a href="/api/reference/responses/overview">Responses</a> for direct model requests, tool use, audio, image, and text inputs, and stateful interactions.</li>
<li><a href="/api/docs/guides/realtime">Realtime API</a> for low-latency voice or audio sessions over WebRTC, WebSocket, or SIP. Use the <a href="/api/reference/resources/realtime/client-events">client events</a> and <a href="/api/reference/resources/realtime/server-events">server events</a> references while building sessions.</li>
<li><a href="/api/reference/administration/overview">Administration</a> for organization workflows such as users, invites, projects, API keys, and audit logs.</li>
</ul>
</li>
<li>Create credentials. Use a standard <a href="https://platform.openai.com/settings/organization/api-keys">API key</a> for application requests, an <a href="https://platform.openai.com/settings/organization/admin-keys">Admin API key</a> for Administration endpoints, or <a href="/api/docs/guides/workload-identity-federation">workload identity federation</a> for short-lived access tokens.</li>
<li>Install an official client library from the <a href="/api/docs/libraries">libraries page</a>, or call the HTTP API directly from any environment that supports HTTP requests.</li>
<li>Make a first request with the <a href="/api/docs/quickstart">developer quickstart</a> or go straight to the <a href="/api/reference/resources/responses/methods/create">Responses create reference</a>.</li>
<li>Before production, review <a href="/api/docs/guides/error-codes">error codes</a>, <a href="/api/docs/guides/rate-limits">rate limits</a>, and request ID logging below.</li>
</ol>
<div class="sl-heading-wrapper level-h2"><h2 id="authentication">Authentication</h2><a class="sl-anchor-link" href="#authentication"><span aria-hidden="true" class="sl-anchor-icon"><svg width="16" height="16" viewBox="0 0 24 24"><path fill="currentcolor" d="m12.11 15.39-3.88 3.88a2.52 2.52 0 0 1-3.5 0 2.47 2.47 0 0 1 0-3.5l3.88-3.88a1 1 0 0 0-1.42-1.42l-3.88 3.89a4.48 4.48 0 0 0 6.33 6.33l3.89-3.88a1 1 0 1 0-1.42-1.42Zm8.58-12.08a4.49 4.49 0 0 0-6.33 0l-3.89 3.88a1 1 0 0 0 1.42 1.42l3.88-3.88a2.52 2.52 0 0 1 3.5 0 2.47 2.47 0 0 1 0 3.5l-3.88 3.88a1 1 0 1 0 1.42 1.42l3.88-3.89a4.49 4.49 0 0 0 0-6.33ZM8.83 15.17a1 1 0 0 0 1.1.22 1 1 0 0 0 .32-.22l4.92-4.92a1 1 0 0 0-1.42-1.42l-4.92 4.92a1 1 0 0 0 0 1.42Z"></path></svg></span><span class="sr-only" data-pagefind-ignore="true">Section titled “Authentication”</span></a></div>
<p>The OpenAI API accepts bearer credentials from API keys or from short-lived access tokens created with <a href="/api/docs/guides/workload-identity-federation">workload identity federation</a>.</p>
<p><strong>Remember that your API key is a secret.</strong> Don’t share it with others or expose it in any client-side code such as browsers or apps. Load API keys from an environment variable or key management service on the server.</p>
<div class="_Notice_wyxfv_1"><div class="_Alert_1bpiz_1" data-variant="outline" data-color="info" data-actions-placement="end"><div class="_Indicator_1bpiz_159"><svg width="1em" height="1em" viewBox="0 0 24 24" fill="currentColor"><path d="M13 12a1 1 0 1 0-2 0v4a1 1 0 1 0 2 0v-4Zm-1-2.5A1.25 1.25 0 1 0 12 7a1.25 1.25 0 0 0 0 2.5Z"></path><path fill-rule="evenodd" d="M12 2C6.477 2 2 6.477 2 12s4.477 10 10 10 10-4.477 10-10S17.523 2 12 2ZM4 12a8 8 0 1 1 16 0 8 8 0 0 1-16 0Z" clip-rule="evenodd"></path></svg></div><div class="_Content_1bpiz_147"><div class="_Message_1bpiz_166"><div class="_Description_1bpiz_176"><p>Revocations of an API key take effect within a few seconds. Most updates that
affect authentication results of an API key propagate within 15 minutes, but
can potentially take longer.</p></div></div></div></div></div>
<p>Provide API credentials with <a href="https://swagger.io/docs/specification/v3_0/authentication/bearer-authentication/">HTTP Bearer authentication</a>.</p>
<pre class="astro-code astro-code-themes github-light github-dark" style="background-color:#fff;--shiki-dark-bg:#24292e;color:#24292e;--shiki-dark:#e1e4e8;overflow-x:auto" tabindex="0" data-language="bash" dir="ltr"><code><span class="line"><span style="color:#6F42C1;--shiki-dark:#B392F0">Authorization:</span><span style="color:#032F62;--shiki-dark:#9ECBFF"> Bearer</span><span style="color:#032F62;--shiki-dark:#9ECBFF"> OPENAI_API_KEY_OR_ACCESS_TOKEN</span></span></code></pre>
<p>If you belong to more than one organization or access projects through a legacy user API key, pass a header to specify which organization and project to use for an API request:</p>
<pre class="astro-code astro-code-themes github-light github-dark" style="background-color:#fff;--shiki-dark-bg:#24292e;color:#24292e;--shiki-dark:#e1e4e8;overflow-x:auto" tabindex="0" data-language="bash" dir="ltr"><code><span class="line"><span style="color:#6F42C1;--shiki-dark:#B392F0">curl</span><span style="color:#032F62;--shiki-dark:#9ECBFF"> https://api.openai.com/v1/models</span><span style="color:#005CC5;--shiki-dark:#79B8FF"> \</span></span>
<span class="line"><span style="color:#005CC5;--shiki-dark:#79B8FF">  -H</span><span style="color:#032F62;--shiki-dark:#9ECBFF"> &quot;Authorization: Bearer </span><span style="color:#24292E;--shiki-dark:#E1E4E8">$OPENAI_API_KEY</span><span style="color:#032F62;--shiki-dark:#9ECBFF">&quot;</span><span style="color:#005CC5;--shiki-dark:#79B8FF"> \</span></span>
<span class="line"><span style="color:#005CC5;--shiki-dark:#79B8FF">  -H</span><span style="color:#032F62;--shiki-dark:#9ECBFF"> &quot;OpenAI-Organization: </span><span style="color:#24292E;--shiki-dark:#E1E4E8">$ORGANIZATION_ID</span><span style="color:#032F62;--shiki-dark:#9ECBFF">&quot;</span><span style="color:#005CC5;--shiki-dark:#79B8FF"> \</span></span>
<span class="line"><span style="color:#005CC5;--shiki-dark:#79B8FF">  -H</span><span style="color:#032F62;--shiki-dark:#9ECBFF"> &quot;OpenAI-Project: </span><span style="color:#24292E;--shiki-dark:#E1E4E8">$PROJECT_ID</span><span style="color:#032F62;--shiki-dark:#9ECBFF">&quot;</span></span></code></pre>
<p>Usage from these API requests counts as usage for the specified organization and project. Find organization and project IDs in your <a href="https://platform.openai.com/settings/organization/general">dashboard settings</a>.</p>
<div class="sl-heading-wrapper level-h2"><h2 id="request-headers">Request headers</h2><a class="sl-anchor-link" href="#request-headers"><span aria-hidden="true" class="sl-anchor-icon"><svg width="16" height="16" viewBox="0 0 24 24"><path fill="currentcolor" d="m12.11 15.39-3.88 3.88a2.52 2.52 0 0 1-3.5 0 2.47 2.47 0 0 1 0-3.5l3.88-3.88a1 1 0 0 0-1.42-1.42l-3.88 3.89a4.48 4.48 0 0 0 6.33 6.33l3.89-3.88a1 1 0 1 0-1.42-1.42Zm8.58-12.08a4.49 4.49 0 0 0-6.33 0l-3.89 3.88a1 1 0 0 0 1.42 1.42l3.88-3.88a2.52 2.52 0 0 1 3.5 0 2.47 2.47 0 0 1 0 3.5l-3.88 3.88a1 1 0 1 0 1.42 1.42l3.88-3.89a4.49 4.49 0 0 0 0-6.33ZM8.83 15.17a1 1 0 0 0 1.1.22 1 1 0 0 0 .32-.22l4.92-4.92a1 1 0 0 0-1.42-1.42l-4.92 4.92a1 1 0 0 0 0 1.42Z"></path></svg></span><span class="sr-only" data-pagefind-ignore="true">Section titled “Request headers”</span></a></div>
<p>For reliable behavior across API paths and HTTP versions, keep the total size
of an API request’s headers under 64 KiB. This budget includes the names and
values of all headers, including common headers such as <code dir="auto">Authorization</code>,
<code dir="auto">Content-Type</code>, and <code dir="auto">User-Agent</code>, as well as any custom headers.</p>
<p>To leave room for required headers and headers added by intermediaries, keep
any individual custom header value and the total size of all custom header
values at 60 KiB or less. Requests with larger headers may fail before they
reach the API, so you may not receive a response or an <code dir="auto">x-request-id</code>.</p>
<div class="sl-heading-wrapper level-h2"><h2 id="debugging-requests">Debugging requests</h2><a class="sl-anchor-link" href="#debugging-requests"><span aria-hidden="true" class="sl-anchor-icon"><svg width="16" height="16" viewBox="0 0 24 24"><path fill="currentcolor" d="m12.11 15.39-3.88 3.88a2.52 2.52 0 0 1-3.5 0 2.47 2.47 0 0 1 0-3.5l3.88-3.88a1 1 0 0 0-1.42-1.42l-3.88 3.89a4.48 4.48 0 0 0 6.33 6.33l3.89-3.88a1 1 0 1 0-1.42-1.42Zm8.58-12.08a4.49 4.49 0 0 0-6.33 0l-3.89 3.88a1 1 0 0 0 1.42 1.42l3.88-3.88a2.52 2.52 0 0 1 3.5 0 2.47 2.47 0 0 1 0 3.5l-3.88 3.88a1 1 0 1 0 1.42 1.42l3.88-3.89a4.49 4.49 0 0 0 0-6.33ZM8.83 15.17a1 1 0 0 0 1.1.22 1 1 0 0 0 .32-.22l4.92-4.92a1 1 0 0 0-1.42-1.42l-4.92 4.92a1 1 0 0 0 0 1.42Z"></path></svg></span><span class="sr-only" data-pagefind-ignore="true">Section titled “Debugging requests”</span></a></div>
<p><a href="/api/docs/guides/error-codes">Error codes</a> describe failures returned from API responses. Inspect HTTP response headers for the unique ID of a request and rate limit details. Common response headers include:</p>
<p><strong>API meta information</strong></p>
<ul>
<li><code dir="auto">openai-organization</code>: The <a href="/api/docs/guides/production-best-practices#setting-up-your-organization">organization</a> associated with the request</li>
<li><code dir="auto">openai-processing-ms</code>: Time taken processing your API request</li>
<li><code dir="auto">openai-version</code>: REST API version used for this request (currently <code dir="auto">2020-10-01</code>)</li>
<li><code dir="auto">x-request-id</code>: Unique identifier for this API request (used in troubleshooting)</li>
</ul>
<p><strong><a href="/api/docs/guides/rate-limits">Rate limiting information</a></strong></p>
<ul>
<li><code dir="auto">x-ratelimit-limit-requests</code></li>
<li><code dir="auto">x-ratelimit-limit-tokens</code></li>
<li><code dir="auto">x-ratelimit-remaining-requests</code></li>
<li><code dir="auto">x-ratelimit-remaining-tokens</code></li>
<li><code dir="auto">x-ratelimit-reset-requests</code></li>
<li><code dir="auto">x-ratelimit-reset-tokens</code></li>
<li><code dir="auto">x-ratelimit-limit-project-tokens</code></li>
<li><code dir="auto">x-ratelimit-remaining-project-tokens</code></li>
<li><code dir="auto">x-ratelimit-reset-project-tokens</code></li>
</ul>
<p>Project-token headers may be present when a project-scoped token limit applies.</p>
<p><strong>OpenAI recommends logging request IDs in production deployments</strong> for more efficient troubleshooting with the <a href="https://help.openai.com/en/">support team</a>, should the need arise. Official <a href="/api/docs/libraries">client libraries</a> provide a property on top-level response objects containing the value of the <code dir="auto">x-request-id</code> header.</p>
<div class="sl-heading-wrapper level-h3"><h3 id="supplying-your-own-request-id-with-x-client-request-id">Supplying your own request ID with <code dir="auto">X-Client-Request-Id</code></h3><a class="sl-anchor-link" href="#supplying-your-own-request-id-with-x-client-request-id"><span aria-hidden="true" class="sl-anchor-icon"><svg width="16" height="16" viewBox="0 0 24 24"><path fill="currentcolor" d="m12.11 15.39-3.88 3.88a2.52 2.52 0 0 1-3.5 0 2.47 2.47 0 0 1 0-3.5l3.88-3.88a1 1 0 0 0-1.42-1.42l-3.88 3.89a4.48 4.48 0 0 0 6.33 6.33l3.89-3.88a1 1 0 1 0-1.42-1.42Zm8.58-12.08a4.49 4.49 0 0 0-6.33 0l-3.89 3.88a1 1 0 0 0 1.42 1.42l3.88-3.88a2.52 2.52 0 0 1 3.5 0 2.47 2.47 0 0 1 0 3.5l-3.88 3.88a1 1 0 1 0 1.42 1.42l3.88-3.89a4.49 4.49 0 0 0 0-6.33ZM8.83 15.17a1 1 0 0 0 1.1.22 1 1 0 0 0 .32-.22l4.92-4.92a1 1 0 0 0-1.42-1.42l-4.92 4.92a1 1 0 0 0 0 1.42Z"></path></svg></span><span class="sr-only" data-pagefind-ignore="true">Section titled “Supplying your own request ID with X-Client-Request-Id”</span></a></div>
<p>Along with the server-generated <code dir="auto">x-request-id</code>, you can supply your own unique identifier for each request via the <code dir="auto">X-Client-Request-Id</code> request header. This header isn’t added automatically; you must explicitly set it on the request.</p>
<p>When you include <code dir="auto">X-Client-Request-Id</code>:</p>
<ul>
<li>
<p>You control the ID format (for example, a UUID or your internal trace ID), but it must contain only ASCII characters and be no more than 512 characters long; otherwise, the request will fail with a 400 error. Make this value unique per request.</p>
</li>
<li>
<p>OpenAI logs this value internally for supported endpoints, including chat/completions, embeddings, responses, and more.</p>
</li>
<li>
<p>In cases like timeouts or network issues when you can’t get the <code dir="auto">X-Request-Id</code> response header, you can share the <code dir="auto">X-Client-Request-Id</code> value with the support team to look up whether OpenAI received the request and when.</p>
</li>
</ul>
<p><strong>Example:</strong></p>
<pre class="astro-code astro-code-themes github-light github-dark" style="background-color:#fff;--shiki-dark-bg:#24292e;color:#24292e;--shiki-dark:#e1e4e8;overflow-x:auto" tabindex="0" data-language="bash" dir="ltr"><code><span class="line"><span style="color:#6F42C1;--shiki-dark:#B392F0">curl</span><span style="color:#032F62;--shiki-dark:#9ECBFF"> https://api.openai.com/v1/chat/completions</span><span style="color:#005CC5;--shiki-dark:#79B8FF"> \</span></span>
<span class="line"><span style="color:#005CC5;--shiki-dark:#79B8FF">  -H</span><span style="color:#032F62;--shiki-dark:#9ECBFF"> &quot;Authorization: Bearer </span><span style="color:#24292E;--shiki-dark:#E1E4E8">$OPENAI_API_KEY</span><span style="color:#032F62;--shiki-dark:#9ECBFF">&quot;</span><span style="color:#005CC5;--shiki-dark:#79B8FF"> \</span></span>
<span class="line"><span style="color:#005CC5;--shiki-dark:#79B8FF">  -H</span><span style="color:#032F62;--shiki-dark:#9ECBFF"> &quot;X-Client-Request-Id: 123e4567-e89b-12d3-a456-426614174000&quot;</span></span></code></pre>
<div class="sl-heading-wrapper level-h2"><h2 id="backwards-compatibility">Backwards compatibility</h2><a class="sl-anchor-link" href="#backwards-compatibility"><span aria-hidden="true" class="sl-anchor-icon"><svg width="16" height="16" viewBox="0 0 24 24"><path fill="currentcolor" d="m12.11 15.39-3.88 3.88a2.52 2.52 0 0 1-3.5 0 2.47 2.47 0 0 1 0-3.5l3.88-3.88a1 1 0 0 0-1.42-1.42l-3.88 3.89a4.48 4.48 0 0 0 6.33 6.33l3.89-3.88a1 1 0 1 0-1.42-1.42Zm8.58-12.08a4.49 4.49 0 0 0-6.33 0l-3.89 3.88a1 1 0 0 0 1.42 1.42l3.88-3.88a2.52 2.52 0 0 1 3.5 0 2.47 2.47 0 0 1 0 3.5l-3.88 3.88a1 1 0 1 0 1.42 1.42l3.88-3.89a4.49 4.49 0 0 0 0-6.33ZM8.83 15.17a1 1 0 0 0 1.1.22 1 1 0 0 0 .32-.22l4.92-4.92a1 1 0 0 0-1.42-1.42l-4.92 4.92a1 1 0 0 0 0 1.42Z"></path></svg></span><span class="sr-only" data-pagefind-ignore="true">Section titled “Backwards compatibility”</span></a></div>
<p>OpenAI provides stability to API users by avoiding breaking changes in major API versions whenever reasonably possible. This includes:</p>
<ul>
<li>The REST API (currently <code dir="auto">v1</code>)</li>
<li>First-party <a href="/api/docs/libraries">client libraries</a> (released libraries adhere to <a href="https://semver.org/">semantic versioning</a>)</li>
<li><a href="/api/docs/models">Model</a> families (like <code dir="auto">gpt-4o</code> or <code dir="auto">o4-mini</code>)</li>
</ul>
<p><strong>Model prompting behavior between snapshots is subject to change</strong>.
Model outputs are by their nature variable, so expect changes in prompting and model behavior between snapshots. The best way to ensure consistent prompting behavior and model output is to use pinned model versions, and to run <a href="/api/docs/guides/evals">evals</a> for your applications.</p>
<p><strong>Backwards-compatible API changes</strong>:</p>
<ul>
<li>Adding new resources (URLs) to the REST API and client libraries</li>
<li>Adding new optional API parameters</li>
<li>Adding new properties to JSON response objects or event data</li>
<li>Changing the order of properties in a JSON response object</li>
<li>Changing the length or format of opaque strings, like resource identifiers</li>
<li>Adding new event types in streaming APIs</li>
</ul>
<p>See the <a href="/api/docs/changelog">changelog</a> for a list of backwards-compatible changes and rare breaking changes.</p> </div>  </div>   </div>  </main>      </div> <!-- Note: padding-inline-end was just manually computed here. There is some offset between starlight <> stainless and content this is manually accounting for--> </body></html> <script defer src="/js/copy.js"></script> <script defer src="/js/api-reference-anchor-links.js"></script>