Ordered chat messages that make up the conversation history. Always include the user’s latest turn; prepend prior turns when you want additional context.
Use this in the API call to specify the model to use for the completion request. Is generally the model ID from the LLM provider (e.g., "gpt-4o", "o1").
User-selected image generation model id. Overrides the workspace default when present. Validated server-side against the AI_ENABLED_IMAGE_MODELS feature flag.
Unique ID of the agent to use for the completion request. Used to load the agent's full configuration (system prompt, knowledge sources, etc.). NB: Agent must already be created in the database and available for the space.
ID of the Task to use for the completion request. Used to tie the completion back to a workflow step or scheduled job. NB: Task must already be created in the database and available for the space.
Array of Content document IDs to include in the RAG context. Used to pass relevant document IDs so their content is included as additional background information for the completion request.
Array of Folder IDs to include in the RAG context. When provided, the LLM will use assets/documents within these folders as additional background information for the completion request.
Grouped tool configurations keyed by provider context (nuwacom, paragon integration type, or MCP client). Backend expands these groups into per-tool configs.
{"docsConfig":{"theme":"mint","$schema":"https://mintlify.com/docs.json","name":"nuwacom Documentation","colors":{"primary":"#141414","light":"#9874FF","dark":"#3f4144"},"logo":{"light":"https://mintcdn.com/nuwacomgmbh/iKf-biIaJ-ZN1yrU/logo/Logocolored.svg?fit=max\u0026auto=format\u0026n=iKf-biIaJ-ZN1yrU\u0026q=85\u0026s=14c15585a045d5c691a8efcf59b1dfe5","dark":"https://mintcdn.com/nuwacomgmbh/iKf-biIaJ-ZN1yrU/logo/Logocolored.svg?fit=max\u0026auto=format\u0026n=iKf-biIaJ-ZN1yrU\u0026q=85\u0026s=14c15585a045d5c691a8efcf59b1dfe5"},"favicon":"https://mintcdn.com/nuwacomgmbh/dB1YncLxJIlPiFUo/Figurecolored.svg?fit=max\u0026auto=format\u0026n=dB1YncLxJIlPiFUo\u0026q=85\u0026s=860441510217c5ebce6f8c4f5e277162","api":{"playground":{"display":"simple"},"examples":{"languages":["Curl","JavaScript","Python","Go","PHP","Java"]},"mdx":{"auth":{"method":"bearer","name":"Authorization"},"server":"https://{customer-tenant}.nuwacom.ai/api"}},"navbar":{"links":[{"href":"mailto:support@nuwacom.ai","label":"Support"}],"primary":{"type":"button","label":"Homepage","href":"https://nuwacom.com"}},"footer":{"socials":{"linkedin":"https://linkedin.com/company/nuwacom"}},"integrations":{"ga4":{"measurementId":"G-RZFMQ9EQ6L"}},"styling":{"latex":false},"navigation":{"languages":[{"language":"en","href":"en/product/gettingstarted"},{"language":"de","href":"de/product/gettingstarted"}]}},"deployment":{"deploymentMetadataValue":{"subdomain":"nuwacomgmbh","hasAudioNarration":false,"actualSubdomain":"nuwacomgmbh","customDomains":["docs.nuwacom.ai"],"gitSource":{"type":"github","owner":"nuwacom","repo":"nuwacom-app","deployBranch":"master","contentDirectory":"docs-external","isPrivate":true,"mountPath":"","label":""},"chroma":{"liveDeploymentHistoryId":"6ada657c8b11aa630bf08b8a","collectionId":"ff496611-f319-457a-9781-809b074696c8","schemaVersion":"v3","latestBuiltDeploymentHistoryId":"6ada657c8b11aa630bf08b8a"},"entitlements":{"AI_CHAT":{"status":"ENABLED"},"WEB_MCP":{"status":"ENABLED"},"NARRATION":{"status":"ENABLED"}},"buildId":"6ada657c8b11aa630bf08b8a","clientVersion":"0.0.3966","searchFilterCounts":[{"language":"en","tag":"Using nuwacom","count":41},{"language":"de","tag":"nuwacom nutzen","count":41},{"language":"default","tag":"API Reference","count":26},{"language":"en","tag":"Product","count":18},{"language":"de","tag":"Produkt","count":18},{"language":"en","tag":"Admin","count":15},{"language":"de","tag":"Admin","count":15},{"language":"default","tag":"Skills","count":11},{"language":"en","tag":"Chat","count":10},{"language":"de","tag":"Chat","count":10},{"language":"en","tag":"Agents","count":7},{"language":"en","tag":"Skills","count":7},{"language":"de","tag":"Skills","count":7},{"language":"default","tag":"Agents","count":7},{"language":"de","tag":"Agenten","count":6},{"language":"en","tag":"Workspace","count":5},{"language":"en","tag":"Connectors","count":5},{"language":"de","tag":"Workspace","count":5},{"language":"de","tag":"Konnektoren","count":5},{"language":"default","tag":"Assets","count":5},{"language":"en","tag":"Guides","count":4},{"language":"de","tag":"Anleitungen","count":4},{"language":"en","tag":"API Reference","count":3},{"language":"de","tag":"API Reference","count":3},{"language":"default","tag":"AI","count":2},{"language":"default","tag":"Completion API","count":1}]},"assistantConfig":{},"hasChatPermissions":true,"hasWebMcpPermissions":true,"toggles":[{"name":"kill-isr","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"agent-mintlify-slack","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"editor-v7-file-tree","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"agent-integrations-settings","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"automations-pr-grouping","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"custom-prefix","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"analytics-v7","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"user-flows-analytics","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"no-publish-flow","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"workos-onboarding","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"llms-txt-v2","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"pause-universal-search-reconcile","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"snapshot-serving-live","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"stripTemperatureMiddleware","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"per-site-search-delta","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"support-platform-pylon-zendesk","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"snapshot-serving","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"instant-rollback","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"granular-notifications-server","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"granular-notifications","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"editor-private-page-search","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"automations-fable","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"fixed-ai-action-pricing","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"automation-resolve-merge-conflict","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"scoped-publishing","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"mintql","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"page-level-analytics","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"editor-version-history-v2","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"editor-nav-generations","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"billing-page-v2","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"workspace-projects","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"assistant-v5","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"byok-sep-25","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"fork-pr-previews","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"revalidation-jwt","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"vite-origin","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"editor-agent-model-picker","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"billing-updated-9-15","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"hobby-abuse-scan","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"dashboard-inbox","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false}],"isAtlas":false,"googleFontsInlined":false},"customCss":[],"page":{"pagePath":"api-reference/completion-api/openai-chat-completion","slug":"/api-reference/completion-api/openai-chat-completion","pageMetadata":{"title":"OpenAI Chat Completion","description":"Create a new AI completion. You can find the supported models using [List all AI models](/api-reference/ai/list-all-ai-models).","deprecated":null,"version":null,"openapi":"/openapi.yaml post /api/v1/openai/chat/completions","href":"/api-reference/completion-api/openai-chat-completion","autogeneratedByOpenApi":true},"description":{"compiledSource":"\"use strict\";\nconst {jsx: _jsx, jsxs: _jsxs} = arguments[0];\nconst {useMDXComponents: _provideComponents} = arguments[0];\nfunction _createMdxContent(props) {\n const _components = {\n a: \"a\",\n p: \"p\",\n ..._provideComponents(),\n ...props.components\n };\n return _jsxs(_components.p, {\n children: [\"Create a new AI completion. You can find the supported models using \", _jsx(_components.a, {\n href: \"/api-reference/ai/list-all-ai-models\",\n children: \"List all AI models\"\n }), \".\"]\n });\n}\nfunction MDXContent(props = {}) {\n const {wrapper: MDXLayout} = {\n ..._provideComponents(),\n ...props.components\n };\n return MDXLayout ? _jsx(MDXLayout, {\n ...props,\n children: _jsx(_createMdxContent, {\n ...props\n })\n }) : _createMdxContent(props);\n}\nreturn {\n default: MDXContent\n};\n","frontmatter":{},"scope":{}},"pageType":"default","mdx":{"mdxSource":{"compiledSource":"\"use strict\";const{Fragment:_Fragment,jsx:_jsx}=arguments[0];const{useMDXComponents:_provideComponents}=arguments[0];function _createMdxContent(props){return _jsx(_Fragment,{})}function MDXContent(props={}){const{wrapper:MDXLayout}={..._provideComponents(),...props.components};return MDXLayout?_jsx(MDXLayout,{...props,children:_jsx(_createMdxContent,{...props})}):_createMdxContent(props)}return{default:MDXContent}","frontmatter":{},"scope":{"config":{},"pageMetadata":{"title":"OpenAI Chat Completion","description":"Create a new AI completion. You can find the supported models using [List all AI models](/api-reference/ai/list-all-ai-models).","deprecated":null,"version":null,"openapi":"/openapi.yaml post /api/v1/openai/chat/completions","href":"/api-reference/completion-api/openai-chat-completion","autogeneratedByOpenApi":true}}},"mdxSourceWithNoJs":null},"mdxExtracts":{"tableOfContents":[],"codeExamples":{}},"jsLinks":[],"openApiReferenceData":{"operation":{"responses":{"200":"2c7ad1f0-7659-440e-93e7-8d5e11a78980"},"operationId":"postApiV1OpenaiChatCompletions","tags":["Completion API"],"parameters":["ba4fdeb5-7a13-4c62-b58a-078ae7838644"],"summary":"OpenAI Chat Completion","description":"Create a new AI completion. You can find the supported models using [List all AI models](/api-reference/ai/list-all-ai-models).","requestBody":"876e7450-acf0-440a-a40a-dfe1732ff726","externalDocs":{"description":"OpenAI API documentation for chat completions","url":"https://platform.openai.com/docs/api-reference/chat/create"},"method":"post","type":"path","servers":["57eb8469-52c1-48ad-9176-461dbfb165dc"],"security":["23fafa83-c844-4542-a0aa-b80a22f4c349"],"path":"/api/v1/openai/chat/completions","baseUrlOptions":["https://{customer-tenant}.nuwacom.ai"],"title":"OpenAI Chat Completion","codeSamples":[],"requestExampleLanguages":["bash","javascript","python","go","php","java"],"requiredOnlyExamples":false,"requestExampleType":"generated","responseExampleType":"generated"},"dependencies":{"parameters":{"ba4fdeb5-7a13-4c62-b58a-078ae7838644":{"in":"header","name":"x-space-id","schema":{"type":"string","isRequired":false,"description":"Space ID to run the completion in. Used as a fallback when `space_id` is not set in the request body.","uniqueKey":"","typeLabel":"string"},"required":false,"description":"Space ID to run the completion in. Used as a fallback when `space_id` is not set in the request body."}},"requestBody":{"content":{"application/json":{"schema":{"type":"object","properties":{"messages":{"type":"array","items":{"type":"object","properties":{"role":{"enum":["assistant","user","system"],"type":"string","isRequired":true,"uniqueKey":"messages.items.[INDEX].role","typeLabel":"enum\u003cstring>"},"content":{"oneOf":[{"type":"string","isRequired":true,"uniqueKey":"messages.items.[INDEX].content.oneOf.0","typeLabel":"string"},{"type":"array","items":{"oneOf":[{"type":"object","required":["type","text"],"properties":{"type":{"enum":["text"],"type":"string","isRequired":true,"uniqueKey":"messages.items.[INDEX].content.oneOf.1.items.[INDEX].oneOf.0.type","typeLabel":"enum\u003cstring>"},"text":{"type":"string","isRequired":true,"uniqueKey":"messages.items.[INDEX].content.oneOf.1.items.[INDEX].oneOf.0.text","typeLabel":"string"}},"uniqueKey":"messages.items.[INDEX].content.oneOf.1.items.[INDEX].oneOf.0","typeLabel":"object"},{"type":"object","required":["type","kbAssetId"],"properties":{"type":{"enum":["image"],"type":"string","isRequired":true,"uniqueKey":"messages.items.[INDEX].content.oneOf.1.items.[INDEX].oneOf.1.type","typeLabel":"enum\u003cstring>"},"kbAssetId":{"type":"string","format":"uuid","isRequired":true,"uniqueKey":"messages.items.[INDEX].content.oneOf.1.items.[INDEX].oneOf.1.kbAssetId","typeLabel":"string\u003cuuid>"}},"uniqueKey":"messages.items.[INDEX].content.oneOf.1.items.[INDEX].oneOf.1","typeLabel":"object"},{"type":"object","required":["type","data","mediaType","fileName"],"properties":{"type":{"enum":["file_data"],"type":"string","isRequired":true,"uniqueKey":"messages.items.[INDEX].content.oneOf.1.items.[INDEX].oneOf.2.type","typeLabel":"enum\u003cstring>"},"data":{"type":"string","isRequired":true,"uniqueKey":"messages.items.[INDEX].content.oneOf.1.items.[INDEX].oneOf.2.data","typeLabel":"string"},"mediaType":{"type":"string","isRequired":true,"uniqueKey":"messages.items.[INDEX].content.oneOf.1.items.[INDEX].oneOf.2.mediaType","typeLabel":"string"},"fileName":{"type":"string","isRequired":true,"uniqueKey":"messages.items.[INDEX].content.oneOf.1.items.[INDEX].oneOf.2.fileName","typeLabel":"string"}},"uniqueKey":"messages.items.[INDEX].content.oneOf.1.items.[INDEX].oneOf.2","typeLabel":"object"}],"uniqueKey":"messages.items.[INDEX].content.oneOf.1.items.[INDEX]","typeLabel":"object"},"isRequired":true,"uniqueKey":"messages.items.[INDEX].content.oneOf.1","typeLabel":"object[]"}],"isRequired":true,"uniqueKey":"messages.items.[INDEX].content","typeLabel":"string | object[]"},"id":{"type":"number","uniqueKey":"messages.items.[INDEX].id","typeLabel":"number"}},"required":["role","content"],"uniqueKey":"messages.items.[INDEX]","typeLabel":"object"},"minItems":1,"description":"Ordered chat messages that make up the conversation history. Always include the user’s latest turn; prepend prior turns when you want additional context.","isRequired":true,"uniqueKey":"messages","typeLabel":"object[]"},"space_id":{"oneOf":[{"type":"string","description":"Unique identifier of the space the completion should be run in.","maxLength":6,"minLength":2,"isRequired":true,"uniqueKey":"space_id.oneOf.0","typeLabel":"string"},{"type":"string","description":"Unique identifier of the space the completion should be run in.","maxLength":21,"minLength":21,"isRequired":true,"uniqueKey":"space_id.oneOf.1","typeLabel":"string"},{"type":"array","items":{"oneOf":[{"type":"string","maxLength":6,"minLength":2,"uniqueKey":"space_id.oneOf.2.items.[INDEX].oneOf.0","typeLabel":"string"},{"type":"string","maxLength":21,"minLength":21,"uniqueKey":"space_id.oneOf.2.items.[INDEX].oneOf.1","typeLabel":"string"}],"uniqueKey":"space_id.oneOf.2.items.[INDEX]","typeLabel":"string"},"description":"Unique identifier of the space the completion should be run in.","minItems":1,"isRequired":true,"uniqueKey":"space_id.oneOf.2","typeLabel":"string[]"}],"isRequired":true,"uniqueKey":"space_id","typeLabel":"string · string · string[]"},"model":{"oneOf":[{"type":"string","description":"Use this in the API call to specify the model to use for the completion request. Is generally the model ID from the LLM provider (e.g., \"gpt-4o\", \"o1\").","uniqueKey":"model.oneOf.0","typeLabel":"string"},{"type":"null","description":"Use this in the API call to specify the model to use for the completion request. Is generally the model ID from the LLM provider (e.g., \"gpt-4o\", \"o1\").","uniqueKey":"model.oneOf.1","typeLabel":"null"}],"uniqueKey":"model","typeLabel":"string | null"},"imageGenerationModel":{"enum":["gemini-2.5-flash-image","gemini-3-pro-image","gemini-3.1-flash-image","gemini-3.1-flash-image-eu","imagen","imagen-fast","gpt-image-2","gpt-image-2.5-sunburst","flux-1-1-pro-ultra","flux-1-kontext-pro","flux-2-pro","gemini-3-pro-image-preview","gemini-3.1-flash-image-preview"],"description":"User-selected image generation model id. Overrides the workspace default when present. Validated server-side against the AI_ENABLED_IMAGE_MODELS feature flag.","type":"string","uniqueKey":"imageGenerationModel","typeLabel":"enum\u003cstring>"},"temperature":{"type":"number","description":"Sampling temperature. Higher values make responses more adventurous; lower values keep them conservative.","uniqueKey":"temperature","typeLabel":"number"},"top_p":{"type":"number","description":"Nucleus sampling parameter. Use this instead of temperature when you want to strictly cap how much of the probability mass is considered.","uniqueKey":"top_p","typeLabel":"number"},"agentId":{"oneOf":[{"type":"string","description":"Unique ID of the agent to use for the completion request. Used to load the agent's full configuration (system prompt, knowledge sources, etc.). NB: Agent must already be created in the database and available for the space.","format":"uuid","uniqueKey":"agentId.oneOf.0","typeLabel":"string\u003cuuid>"},{"type":"null","description":"Unique ID of the agent to use for the completion request. Used to load the agent's full configuration (system prompt, knowledge sources, etc.). NB: Agent must already be created in the database and available for the space.","format":"uuid","uniqueKey":"agentId.oneOf.1","typeLabel":"null"}],"uniqueKey":"agentId","typeLabel":"string\u003cuuid> | null"},"agentPublished":{"type":"boolean","description":"Which version of the agent to use: true (default) = published version, false = draft. Useful to test an agent that has not been published yet.","uniqueKey":"agentPublished","typeLabel":"boolean"},"voiceId":{"oneOf":[{"type":"string","description":"UUID of the Voice to use for the completion request. NB: Voice must already be created in the database and available for the space.","format":"uuid","uniqueKey":"voiceId.oneOf.0","typeLabel":"string\u003cuuid>"},{"type":"null","description":"UUID of the Voice to use for the completion request. NB: Voice must already be created in the database and available for the space.","format":"uuid","uniqueKey":"voiceId.oneOf.1","typeLabel":"null"}],"uniqueKey":"voiceId","typeLabel":"string\u003cuuid> | null"},"taskId":{"oneOf":[{"type":"string","description":"ID of the Task to use for the completion request. Used to tie the completion back to a workflow step or scheduled job. NB: Task must already be created in the database and available for the space.","format":"uuid","uniqueKey":"taskId.oneOf.0","typeLabel":"string\u003cuuid>"},{"type":"null","description":"ID of the Task to use for the completion request. Used to tie the completion back to a workflow step or scheduled job. NB: Task must already be created in the database and available for the space.","format":"uuid","uniqueKey":"taskId.oneOf.1","typeLabel":"null"}],"uniqueKey":"taskId","typeLabel":"string\u003cuuid> | null"},"capabilities":{"type":"object","properties":{"webSearch":{"type":"boolean","uniqueKey":"capabilities.webSearch","typeLabel":"boolean"},"knowledgeBaseSearch":{"type":"boolean","uniqueKey":"capabilities.knowledgeBaseSearch","typeLabel":"boolean"},"visionEnabled":{"type":"boolean","uniqueKey":"capabilities.visionEnabled","typeLabel":"boolean"},"canvasEnabled":{"type":"boolean","uniqueKey":"capabilities.canvasEnabled","typeLabel":"boolean"}},"required":[],"description":"Provide an object of capabilities to enable the LLM perform specific tasks better (e.g., web search, internal KB, canvas, etc.).","uniqueKey":"capabilities","typeLabel":"object"},"attachmentIds":{"type":"array","items":{"type":"string","format":"uuid","uniqueKey":"attachmentIds.items.[INDEX]","typeLabel":"string\u003cuuid>"},"description":"Array of asset IDs (files, snippets, etc.) that should be injected into the completion request as supporting context.","uniqueKey":"attachmentIds","typeLabel":"string\u003cuuid>[]"},"contentIds":{"type":"array","items":{"type":"string","format":"uuid","uniqueKey":"contentIds.items.[INDEX]","typeLabel":"string\u003cuuid>"},"description":"Array of Content document IDs to include in the RAG context. Used to pass relevant document IDs so their content is included as additional background information for the completion request.","uniqueKey":"contentIds","typeLabel":"string\u003cuuid>[]"},"folderIds":{"type":"array","items":{"type":"string","format":"uuid","uniqueKey":"folderIds.items.[INDEX]","typeLabel":"string\u003cuuid>"},"description":"Array of Folder IDs to include in the RAG context. When provided, the LLM will use assets/documents within these folders as additional background information for the completion request.","uniqueKey":"folderIds","typeLabel":"string\u003cuuid>[]"},"toolOptions":{"type":"object","properties":{"language":{"type":"string","uniqueKey":"toolOptions.language","typeLabel":"string"},"audience":{"enum":["c_level","leaders_managers","new_customers_prospects","existing_customers","internal_team_members","partners_vendors"],"type":"string","uniqueKey":"toolOptions.audience","typeLabel":"enum\u003cstring>"},"imageStyle":{"enum":["photorealistic","illustration","sketch","comic"],"type":"string","uniqueKey":"toolOptions.imageStyle","typeLabel":"enum\u003cstring>"},"colorMood":{"enum":["vibrant","warm","cool","monochrome","pastel"],"type":"string","uniqueKey":"toolOptions.colorMood","typeLabel":"enum\u003cstring>"},"documentTemplate":{"enum":["report","article","briefing","social_media_post","strategy_paper","speech"],"type":"string","uniqueKey":"toolOptions.documentTemplate","typeLabel":"enum\u003cstring>"},"templateId":{"type":"string","uniqueKey":"toolOptions.templateId","typeLabel":"string"},"videoStyle":{"enum":["realistic","cinematic","motion_graphics","animated"],"type":"string","uniqueKey":"toolOptions.videoStyle","typeLabel":"enum\u003cstring>"},"aspectRatio":{"enum":["horizontal","vertical"],"type":"string","uniqueKey":"toolOptions.aspectRatio","typeLabel":"enum\u003cstring>"},"sourceFilters":{"type":"object","properties":{"docs":{"type":"boolean","uniqueKey":"toolOptions.sourceFilters.docs","typeLabel":"boolean"},"notes":{"type":"boolean","uniqueKey":"toolOptions.sourceFilters.notes","typeLabel":"boolean"}},"required":[],"uniqueKey":"toolOptions.sourceFilters","typeLabel":"object"}},"required":[],"description":"User preferences for AI behavior including language, audience, and image generation style. These options are injected into the system prompt.","uniqueKey":"toolOptions","typeLabel":"object"},"toolGroups":{"type":"array","items":{"oneOf":[{"type":"object","required":["kind","tools"],"properties":{"kind":{"enum":["nuwacom"],"type":"string","isRequired":true,"uniqueKey":"toolGroups.items.[INDEX].oneOf.0.kind","typeLabel":"enum\u003cstring>"},"tools":{"type":"array","items":{"type":"string","uniqueKey":"toolGroups.items.[INDEX].oneOf.0.tools.items.[INDEX]","typeLabel":"string"},"minItems":1,"isRequired":true,"uniqueKey":"toolGroups.items.[INDEX].oneOf.0.tools","typeLabel":"string[]"}},"uniqueKey":"toolGroups.items.[INDEX].oneOf.0","typeLabel":"object"},{"type":"object","required":["kind","integrationType","tools"],"properties":{"kind":{"enum":["paragon"],"type":"string","isRequired":true,"uniqueKey":"toolGroups.items.[INDEX].oneOf.1.kind","typeLabel":"enum\u003cstring>"},"integrationType":{"type":"string","isRequired":true,"uniqueKey":"toolGroups.items.[INDEX].oneOf.1.integrationType","typeLabel":"string"},"tools":{"type":"array","items":{"type":"string","uniqueKey":"toolGroups.items.[INDEX].oneOf.1.tools.items.[INDEX]","typeLabel":"string"},"minItems":1,"isRequired":true,"uniqueKey":"toolGroups.items.[INDEX].oneOf.1.tools","typeLabel":"string[]"},"integrationId":{"oneOf":[{"type":"string","format":"uuid","uniqueKey":"toolGroups.items.[INDEX].oneOf.1.integrationId.oneOf.0","typeLabel":"string\u003cuuid>"},{"type":"null","format":"uuid","uniqueKey":"toolGroups.items.[INDEX].oneOf.1.integrationId.oneOf.1","typeLabel":"null"}],"uniqueKey":"toolGroups.items.[INDEX].oneOf.1.integrationId","typeLabel":"string\u003cuuid> | null"}},"uniqueKey":"toolGroups.items.[INDEX].oneOf.1","typeLabel":"object"},{"type":"object","required":["kind","mcpClientId","tools"],"properties":{"kind":{"enum":["mcp"],"type":"string","isRequired":true,"uniqueKey":"toolGroups.items.[INDEX].oneOf.2.kind","typeLabel":"enum\u003cstring>"},"mcpClientId":{"type":"string","format":"uuid","isRequired":true,"uniqueKey":"toolGroups.items.[INDEX].oneOf.2.mcpClientId","typeLabel":"string\u003cuuid>"},"tools":{"type":"array","items":{"type":"string","uniqueKey":"toolGroups.items.[INDEX].oneOf.2.tools.items.[INDEX]","typeLabel":"string"},"minItems":1,"isRequired":true,"uniqueKey":"toolGroups.items.[INDEX].oneOf.2.tools","typeLabel":"string[]"},"integrationId":{"oneOf":[{"type":"string","format":"uuid","uniqueKey":"toolGroups.items.[INDEX].oneOf.2.integrationId.oneOf.0","typeLabel":"string\u003cuuid>"},{"type":"null","format":"uuid","uniqueKey":"toolGroups.items.[INDEX].oneOf.2.integrationId.oneOf.1","typeLabel":"null"}],"uniqueKey":"toolGroups.items.[INDEX].oneOf.2.integrationId","typeLabel":"string\u003cuuid> | null"}},"uniqueKey":"toolGroups.items.[INDEX].oneOf.2","typeLabel":"object"}],"uniqueKey":"toolGroups.items.[INDEX]","typeLabel":"object"},"description":"Grouped tool configurations keyed by provider context (nuwacom, paragon integration type, or MCP client). Backend expands these groups into per-tool configs.","uniqueKey":"toolGroups","typeLabel":"object[]"},"skillIds":{"type":"array","items":{"type":"string","format":"uuid","uniqueKey":"skillIds.items.[INDEX]","typeLabel":"string\u003cuuid>"},"description":"Skill IDs explicitly selected by the user from the skills dropdown. When present without an agent, only these skills are loaded.","uniqueKey":"skillIds","typeLabel":"string\u003cuuid>[]"},"workflowContext":{"type":"object","properties":{"enabled":{"type":"boolean","isRequired":true,"uniqueKey":"workflowContext.enabled","typeLabel":"boolean"},"isWorkflowBuilder":{"type":"boolean","uniqueKey":"workflowContext.isWorkflowBuilder","typeLabel":"boolean"},"workflow_intent":{"enum":["create","update"],"type":"string","uniqueKey":"workflowContext.workflow_intent","typeLabel":"enum\u003cstring>"},"current_workflow":{"type":"object","properties":{"nodes":{"type":"array","items":{"type":"object","properties":{"id":{"type":"string","isRequired":true,"uniqueKey":"workflowContext.current_workflow.nodes.items.[INDEX].id","typeLabel":"string"},"position":{"type":"object","properties":{"x":{"type":"number","isRequired":true,"uniqueKey":"workflowContext.current_workflow.nodes.items.[INDEX].position.x","typeLabel":"number"},"y":{"type":"number","isRequired":true,"uniqueKey":"workflowContext.current_workflow.nodes.items.[INDEX].position.y","typeLabel":"number"}},"required":["x","y"],"isRequired":true,"uniqueKey":"workflowContext.current_workflow.nodes.items.[INDEX].position","typeLabel":"object"},"data":{"type":"object","properties":{"label":{"type":"string","isRequired":true,"uniqueKey":"workflowContext.current_workflow.nodes.items.[INDEX].data.label","typeLabel":"string"},"type":{"type":"string","isRequired":true,"uniqueKey":"workflowContext.current_workflow.nodes.items.[INDEX].data.type","typeLabel":"string"},"category":{"type":"string","isRequired":true,"uniqueKey":"workflowContext.current_workflow.nodes.items.[INDEX].data.category","typeLabel":"string"},"config":{"type":"object","additionalProperties":{"oneOf":[{"type":"string","uniqueKey":"workflowContext.current_workflow.nodes.items.[INDEX].data.config.additionalProperties.oneOf.0","typeLabel":"string"},{"type":"number","uniqueKey":"workflowContext.current_workflow.nodes.items.[INDEX].data.config.additionalProperties.oneOf.1","typeLabel":"number"},{"type":"boolean","uniqueKey":"workflowContext.current_workflow.nodes.items.[INDEX].data.config.additionalProperties.oneOf.2","typeLabel":"boolean"},{"type":"null","uniqueKey":"workflowContext.current_workflow.nodes.items.[INDEX].data.config.additionalProperties.oneOf.3","typeLabel":"null"},{"type":"array","items":{"oneOf":[{}],"uniqueKey":"workflowContext.current_workflow.nodes.items.[INDEX].data.config.additionalProperties.oneOf.4.items.[INDEX]","typeLabel":"any"},"uniqueKey":"workflowContext.current_workflow.nodes.items.[INDEX].data.config.additionalProperties.oneOf.4","typeLabel":"any[]"},{"type":"object","uniqueKey":"workflowContext.current_workflow.nodes.items.[INDEX].data.config.additionalProperties.oneOf.5","typeLabel":"object"}],"uniqueKey":"workflowContext.current_workflow.nodes.items.[INDEX].data.config.additionalProperties","typeLabel":"string | number | boolean | null | any[] | object"},"isRequired":true,"uniqueKey":"workflowContext.current_workflow.nodes.items.[INDEX].data.config","typeLabel":"object"}},"required":["label","type","category","config"],"isRequired":true,"uniqueKey":"workflowContext.current_workflow.nodes.items.[INDEX].data","typeLabel":"object"},"type":{"type":"string","uniqueKey":"workflowContext.current_workflow.nodes.items.[INDEX].type","typeLabel":"string"}},"required":["id","position","data"],"uniqueKey":"workflowContext.current_workflow.nodes.items.[INDEX]","typeLabel":"object"},"isRequired":true,"uniqueKey":"workflowContext.current_workflow.nodes","typeLabel":"object[]"},"edges":{"type":"array","items":{"type":"object","properties":{"id":{"type":"string","isRequired":true,"uniqueKey":"workflowContext.current_workflow.edges.items.[INDEX].id","typeLabel":"string"},"source":{"type":"string","isRequired":true,"uniqueKey":"workflowContext.current_workflow.edges.items.[INDEX].source","typeLabel":"string"},"target":{"type":"string","isRequired":true,"uniqueKey":"workflowContext.current_workflow.edges.items.[INDEX].target","typeLabel":"string"},"sourceHandle":{"oneOf":[{"type":"string","uniqueKey":"workflowContext.current_workflow.edges.items.[INDEX].sourceHandle.oneOf.0","typeLabel":"string"},{"type":"null","uniqueKey":"workflowContext.current_workflow.edges.items.[INDEX].sourceHandle.oneOf.1","typeLabel":"null"}],"uniqueKey":"workflowContext.current_workflow.edges.items.[INDEX].sourceHandle","typeLabel":"string | null"},"targetHandle":{"oneOf":[{"type":"string","uniqueKey":"workflowContext.current_workflow.edges.items.[INDEX].targetHandle.oneOf.0","typeLabel":"string"},{"type":"null","uniqueKey":"workflowContext.current_workflow.edges.items.[INDEX].targetHandle.oneOf.1","typeLabel":"null"}],"uniqueKey":"workflowContext.current_workflow.edges.items.[INDEX].targetHandle","typeLabel":"string | null"}},"required":["id","source","target"],"uniqueKey":"workflowContext.current_workflow.edges.items.[INDEX]","typeLabel":"object"},"isRequired":true,"uniqueKey":"workflowContext.current_workflow.edges","typeLabel":"object[]"}},"required":["nodes","edges"],"uniqueKey":"workflowContext.current_workflow","typeLabel":"object"},"connected_integrations":{"type":"array","items":{"type":"object","properties":{"type":{"type":"string","isRequired":true,"uniqueKey":"workflowContext.connected_integrations.items.[INDEX].type","typeLabel":"string"},"name":{"type":"string","isRequired":true,"uniqueKey":"workflowContext.connected_integrations.items.[INDEX].name","typeLabel":"string"},"credentialId":{"oneOf":[{"type":"string","uniqueKey":"workflowContext.connected_integrations.items.[INDEX].credentialId.oneOf.0","typeLabel":"string"},{"type":"null","uniqueKey":"workflowContext.connected_integrations.items.[INDEX].credentialId.oneOf.1","typeLabel":"null"}],"uniqueKey":"workflowContext.connected_integrations.items.[INDEX].credentialId","typeLabel":"string | null"}},"required":["type","name"],"uniqueKey":"workflowContext.connected_integrations.items.[INDEX]","typeLabel":"object"},"uniqueKey":"workflowContext.connected_integrations","typeLabel":"object[]"},"canvas_workflow_id":{"type":"string","uniqueKey":"workflowContext.canvas_workflow_id","typeLabel":"string"}},"required":["enabled"],"uniqueKey":"workflowContext","typeLabel":"object"},"stream":{"type":"boolean","description":"When true the API sends partial chunks as the model generates them (ideal for typing indicators). Set to false to receive a single response payload.","uniqueKey":"stream","typeLabel":"boolean"},"parent_message_id":{"oneOf":[{"type":"number","description":"Internal reference to the last assistant message in the thread. Include this when you need the completion to “continue” an earlier answer.","uniqueKey":"parent_message_id.oneOf.0","typeLabel":"number"},{"type":"null","description":"Internal reference to the last assistant message in the thread. Include this when you need the completion to “continue” an earlier answer.","uniqueKey":"parent_message_id.oneOf.1","typeLabel":"null"}],"uniqueKey":"parent_message_id","typeLabel":"number | null"},"conversation_id":{"oneOf":[{"type":"string","description":"Conversation UUID tying multiple completions together. Provide it to append to an existing thread; leave empty to start fresh.","format":"uuid","uniqueKey":"conversation_id.oneOf.0","typeLabel":"string\u003cuuid>"},{"type":"null","description":"Conversation UUID tying multiple completions together. Provide it to append to an existing thread; leave empty to start fresh.","format":"uuid","uniqueKey":"conversation_id.oneOf.1","typeLabel":"null"}],"uniqueKey":"conversation_id","typeLabel":"string\u003cuuid> | null"}},"required":["messages","space_id"],"uniqueKey":"","typeLabel":"object"},"examples":{"Example":{"title":"Example","value":{"messages":[{"content":"\u003cstring>","id":123}],"space_id":"\u003cstring>","model":"\u003cstring>","temperature":123,"top_p":123,"agentId":"3c90c3cc-0d44-4b50-8888-8dd25736052a","agentPublished":true,"voiceId":"3c90c3cc-0d44-4b50-8888-8dd25736052a","taskId":"3c90c3cc-0d44-4b50-8888-8dd25736052a","capabilities":{"webSearch":true,"knowledgeBaseSearch":true,"visionEnabled":true,"canvasEnabled":true},"attachmentIds":["3c90c3cc-0d44-4b50-8888-8dd25736052a"],"contentIds":["3c90c3cc-0d44-4b50-8888-8dd25736052a"],"folderIds":["3c90c3cc-0d44-4b50-8888-8dd25736052a"],"toolOptions":{"language":"\u003cstring>","templateId":"\u003cstring>","sourceFilters":{"docs":true,"notes":true}},"toolGroups":[{"kind":"nuwacom","tools":["\u003cstring>"]}],"skillIds":["3c90c3cc-0d44-4b50-8888-8dd25736052a"],"stream":true,"parent_message_id":123,"conversation_id":"3c90c3cc-0d44-4b50-8888-8dd25736052a"}}},"exampleType":"generated"}},"exampleType":"generated"},"responses":{"2c7ad1f0-7659-440e-93e7-8d5e11a78980":{"description":"Successful completion response (see [OpenAI Completions Object](https://platform.openai.com/docs/api-reference/completions/object))","content":{"_mintlify/placeholder":{"schema":{"type":"object","description":""}}}}},"security":{"23fafa83-c844-4542-a0aa-b80a22f4c349":{"bearerAuth":{"type":"http","scheme":"bearer","bearerFormat":"JWT","scopes":[]}}},"servers":{"57eb8469-52c1-48ad-9176-461dbfb165dc":{"url":"https://{customer-tenant}.nuwacom.ai","description":"Nuwacom API"}},"processedSecurityOptions":[{"schemes":[{"scheme":{"type":"http","scheme":"bearer","bearerFormat":"JWT","scopes":[]},"schema":{"title":"Bearer Auth","type":"string","isRequired":true,"description":"Bearer authentication header of the form `Bearer \u003ctoken>`, where `\u003ctoken>` is your auth token.","format":"bearer","typeLabel":"string\u003cbearer>","deprecated":false},"schemeName":"bearerAuth","name":"Authorization"}],"title":"bearerAuth"}]},"originalFileLocation":"openapi.yaml"},"subdomain":"nuwacomgmbh","siteName":"nuwacom Documentation","title":"OpenAI Chat Completion - nuwacom Documentation","navMaps":{"firstHrefInVersion":{},"firstHrefInLanguage":{"en":{"href":"/api-reference/completion-api/openai-chat-completion","matchLevel":0},"de":{"href":"/api-reference/completion-api/openai-chat-completion","matchLevel":0}}},"lastModified":"2026-09-29T13:57:50.293Z","originalFileLocation":"api-reference/completion-api/openai-chat-completion.mdx","locale":"en"},"headHtml":"\u003cscript data-mint-head>(function(){var d=document.documentElement,p=null;if(!p){try{p=localStorage.getItem(\"isDarkMode\")}catch(e){}if(p==='true')p='dark';else if(p==='false')p='light';if(p!=='light'\u0026\u0026p!=='dark'\u0026\u0026p!=='system')p=\"system\"}var r=p==='system'?(matchMedia(\"(prefers-color-scheme: dark)\").matches?'dark':'light'):p;d.classList.remove(r==='dark'?'light':'dark');d.classList.add(r);d.setAttribute(\"data-theme-preference\",p)})();\u003c/script>\u003cmeta data-mint-head name=\"description\" content=\"Create a new AI completion. You can find the supported models using List all AI models.\">\u003cmeta data-mint-head name=\"application-name\" content=\"nuwacom Documentation\">\u003cmeta data-mint-head name=\"generator\" content=\"Mintlify\">\u003clink data-mint-head rel=\"icon\" type=\"image/png\" sizes=\"192x192\" href=\"/mintlify-assets/_mintlify/favicons/nuwacomgmbh/WC_nbhxEpKVcnsSG/_generated/favicon/android-chrome-192x192.png\" media=\"(prefers-color-scheme: light)\">\u003clink data-mint-head rel=\"apple-touch-icon\" type=\"image/png\" sizes=\"180x180\" href=\"/mintlify-assets/_mintlify/favicons/nuwacomgmbh/WC_nbhxEpKVcnsSG/_generated/favicon/apple-touch-icon.png\">\u003clink data-mint-head rel=\"icon\" type=\"image/png\" sizes=\"16x16\" href=\"/mintlify-assets/_mintlify/favicons/nuwacomgmbh/WC_nbhxEpKVcnsSG/_generated/favicon/favicon-16x16.png\" media=\"(prefers-color-scheme: light)\">\u003clink data-mint-head rel=\"icon\" type=\"image/png\" sizes=\"32x32\" href=\"/mintlify-assets/_mintlify/favicons/nuwacomgmbh/WC_nbhxEpKVcnsSG/_generated/favicon/favicon-32x32.png\" media=\"(prefers-color-scheme: light)\">\u003clink data-mint-head rel=\"shortcut icon\" type=\"image/x-icon\" href=\"/mintlify-assets/_mintlify/favicons/nuwacomgmbh/WC_nbhxEpKVcnsSG/_generated/favicon/favicon.ico\" media=\"(prefers-color-scheme: light)\">\u003clink data-mint-head rel=\"icon\" type=\"image/png\" sizes=\"192x192\" href=\"/mintlify-assets/_mintlify/favicons/nuwacomgmbh/WC_nbhxEpKVcnsSG/_generated/favicon-dark/android-chrome-192x192.png\" media=\"(prefers-color-scheme: dark)\">\u003clink data-mint-head rel=\"icon\" type=\"image/png\" sizes=\"16x16\" href=\"/mintlify-assets/_mintlify/favicons/nuwacomgmbh/WC_nbhxEpKVcnsSG/_generated/favicon-dark/favicon-16x16.png\" media=\"(prefers-color-scheme: dark)\">\u003clink data-mint-head rel=\"icon\" type=\"image/png\" sizes=\"32x32\" href=\"/mintlify-assets/_mintlify/favicons/nuwacomgmbh/WC_nbhxEpKVcnsSG/_generated/favicon-dark/favicon-32x32.png\" media=\"(prefers-color-scheme: dark)\">\u003clink data-mint-head rel=\"shortcut icon\" type=\"image/x-icon\" href=\"/mintlify-assets/_mintlify/favicons/nuwacomgmbh/WC_nbhxEpKVcnsSG/_generated/favicon-dark/favicon.ico\" media=\"(prefers-color-scheme: dark)\">\u003cmeta data-mint-head property=\"og:title\" content=\"OpenAI Chat Completion - nuwacom Documentation\">\u003cmeta data-mint-head property=\"og:description\" content=\"Create a new AI completion. You can find the supported models using List all AI models.\">\u003cmeta data-mint-head property=\"og:site_name\" content=\"nuwacom Documentation\">\u003cmeta data-mint-head property=\"og:url\" content=\"https://docs.nuwacom.ai/api-reference/completion-api/openai-chat-completion\">\u003cmeta data-mint-head property=\"og:type\" content=\"website\">\u003cmeta data-mint-head property=\"og:image\" content=\"https://nuwacomgmbh.mintlify.app/_mintlify/api/og/v2?division=Completion+API\u0026amp;title=OpenAI+Chat+Completion\u0026amp;description=Create+a+new+AI+completion.+You+can+find+the+supported+models+using+%5BList+all+AI+models%5D%28%2Fapi-reference%2Fai%2Flist-all-ai-models%29.\u0026amp;theme=55205240c4a712725b8bfdbb\u0026amp;signature=282353d025004f251e987d5a7d98d93a215869b368d769a32b557984ddae00da\">\u003cmeta data-mint-head property=\"og:image:width\" content=\"1200\">\u003cmeta data-mint-head property=\"og:image:height\" content=\"630\">\u003cmeta data-mint-head name=\"twitter:card\" content=\"summary_large_image\">\u003cmeta data-mint-head name=\"twitter:title\" content=\"OpenAI Chat Completion - nuwacom Documentation\">\u003cmeta data-mint-head name=\"twitter:description\" content=\"Create a new AI completion. You can find the supported models using List all AI models.\">\u003cmeta data-mint-head name=\"twitter:image\" content=\"https://nuwacomgmbh.mintlify.app/_mintlify/api/og/v2?division=Completion+API\u0026amp;title=OpenAI+Chat+Completion\u0026amp;description=Create+a+new+AI+completion.+You+can+find+the+supported+models+using+%5BList+all+AI+models%5D%28%2Fapi-reference%2Fai%2Flist-all-ai-models%29.\u0026amp;theme=55205240c4a712725b8bfdbb\u0026amp;signature=282353d025004f251e987d5a7d98d93a215869b368d769a32b557984ddae00da\">\u003cmeta data-mint-head name=\"twitter:image:width\" content=\"1200\">\u003cmeta data-mint-head name=\"twitter:image:height\" content=\"630\">\u003cmeta data-mint-head name=\"msapplication-config\" content=\"/mintlify-assets/_mintlify/favicons/nuwacomgmbh/WC_nbhxEpKVcnsSG/_generated/favicon/browserconfig.xml\">\u003cmeta data-mint-head name=\"apple-mobile-web-app-title\" content=\"nuwacom Documentation\">\u003cmeta data-mint-head name=\"msapplication-TileColor\" content=\"#141414\">\u003clink data-mint-head rel=\"canonical\" href=\"https://docs.nuwacom.ai/api-reference/completion-api/openai-chat-completion\">\u003clink data-mint-head rel=\"alternate\" type=\"application/xml\" href=\"/sitemap.xml\">\u003clink data-mint-head rel=\"alternate\" type=\"text/markdown\" href=\"/api-reference/completion-api/openai-chat-completion.md\">\u003cscript data-mint-head type=\"application/ld+json\">{\"@context\":\"https://schema.org\",\"@graph\":[{\"@type\":\"Organization\",\"@id\":\"https://docs.nuwacom.ai/#organization\",\"name\":\"nuwacom Documentation\",\"url\":\"https://docs.nuwacom.ai\",\"logo\":{\"@type\":\"ImageObject\",\"url\":\"https://mintcdn.com/nuwacomgmbh/iKf-biIaJ-ZN1yrU/logo/Logocolored.svg?fit=max\u0026auto=format\u0026n=iKf-biIaJ-ZN1yrU\u0026q=85\u0026s=14c15585a045d5c691a8efcf59b1dfe5\"}},{\"@type\":\"WebSite\",\"@id\":\"https://docs.nuwacom.ai#website\",\"name\":\"nuwacom Documentation\",\"url\":\"https://docs.nuwacom.ai\",\"publisher\":{\"@id\":\"https://docs.nuwacom.ai/#organization\"}},{\"@type\":\"WebPage\",\"@id\":\"https://docs.nuwacom.ai/api-reference/completion-api/openai-chat-completion#webpage\",\"url\":\"https://docs.nuwacom.ai/api-reference/completion-api/openai-chat-completion\",\"name\":\"OpenAI Chat Completion\",\"description\":\"Create a new AI completion. You can find the supported models using List all AI models.\",\"dateModified\":\"2026-09-29T13:57:50.293Z\",\"isPartOf\":{\"@id\":\"https://docs.nuwacom.ai#website\"},\"breadcrumb\":{\"@id\":\"https://docs.nuwacom.ai/api-reference/completion-api/openai-chat-completion#breadcrumb\"}},{\"@type\":\"BreadcrumbList\",\"@id\":\"https://docs.nuwacom.ai/api-reference/completion-api/openai-chat-completion#breadcrumb\",\"itemListElement\":[{\"@type\":\"ListItem\",\"position\":1,\"name\":\"nuwacom Documentation\",\"item\":\"https://docs.nuwacom.ai\"},{\"@type\":\"ListItem\",\"position\":2,\"name\":\"OpenAI Chat Completion\",\"item\":\"https://docs.nuwacom.ai/api-reference/completion-api/openai-chat-completion\"}]},{\"@type\":[\"TechArticle\",\"APIReference\"],\"@id\":\"https://docs.nuwacom.ai/api-reference/completion-api/openai-chat-completion#apireference\",\"headline\":\"OpenAI Chat Completion\",\"name\":\"OpenAI Chat Completion\",\"description\":\"Create a new AI completion. You can find the supported models using List all AI models.\",\"url\":\"https://docs.nuwacom.ai/api-reference/completion-api/openai-chat-completion\",\"mainEntityOfPage\":{\"@id\":\"https://docs.nuwacom.ai/api-reference/completion-api/openai-chat-completion#webpage\"},\"dateModified\":\"2026-09-29T13:57:50.293Z\",\"publisher\":{\"@id\":\"https://docs.nuwacom.ai/#organization\"},\"isPartOf\":{\"@id\":\"https://docs.nuwacom.ai#website\"}}]}\u003c/script>\u003cscript data-mint-head type=\"application/ld+json\">{\"@context\":\"https://schema.org\",\"@type\":\"WebSite\",\"name\":\"nuwacom Documentation\",\"creator\":{\"@type\":\"Organization\",\"name\":\"Mintlify\",\"url\":\"https://mintlify.com\"}}\u003c/script>","siteName":"nuwacom Documentation","nav":{"global":null,"languages":[{"language":"en","tabs":[{"tab":"Using nuwacom","pages":[{"title":"Using nuwacom","href":"/en/product/gettingstarted"}]},{"tab":"Admin","pages":[{"title":"Admin","href":"/en/workspacesettings"}]},{"tab":"Security","pages":[{"title":"Security","href":"/en/overviewdatasecurity"}]},{"tab":"API Reference","groups":[{"group":"Overview","pages":[{"title":"API Introduction","href":"/admin/api/introduction"}]},{"group":"AI","pages":[{"title":"List all AI models","deprecated":null,"version":null,"openapi":"/openapi.yaml get /api/ai/models","href":"/api-reference/ai/list-all-ai-models"},{"title":"List space AI models","deprecated":null,"version":null,"openapi":"/openapi.yaml get /api/ai/models/{spaceId}","href":"/api-reference/ai/list-space-ai-models"}]},{"group":"Assets","pages":[{"title":"Add an asset via URL","deprecated":null,"version":null,"openapi":"/openapi.yaml post /api/kb/assets","href":"/api-reference/assets/add-an-asset-via-url"},{"title":"Upload an asset","deprecated":null,"version":null,"openapi":"/openapi.yaml post /api/kb/assets/upload","href":"/api-reference/assets/upload-an-asset"},{"title":"Get an asset","deprecated":null,"version":null,"openapi":"/openapi.yaml get /api/kb/assets/{spaceId}/{assetId}","href":"/api-reference/assets/get-an-asset"},{"title":"Update an asset","deprecated":null,"version":null,"openapi":"/openapi.yaml patch /api/kb/assets/{spaceId}/{assetId}","href":"/api-reference/assets/update-an-asset"},{"title":"Delete an asset","description":"Permanently delete an asset from the given space. This removes the stored file and any derived embeddings for that asset.","deprecated":null,"version":null,"openapi":"/openapi.yaml delete /api/kb/assets/{spaceId}/{assetId}","href":"/api-reference/assets/delete-an-asset"}]},{"group":"Completion API","pages":[{"title":"OpenAI Chat Completion","deprecated":null,"version":null,"openapi":"/openapi.yaml post /api/v1/openai/chat/completions","href":"/api-reference/completion-api/openai-chat-completion"}]},{"group":"Agents","pages":[{"title":"Agents API Overview","description":"Create, manage, and chat with agents in your nuwacom workspace programmatically","href":"/admin/api/agents-overview"},{"title":"List agents","deprecated":null,"version":null,"openapi":"/openapi.yaml get /api/v1/spaces/{spaceId}/agents","href":"/api-reference/agents/list-agents"},{"title":"Create an agent","deprecated":null,"version":null,"openapi":"/openapi.yaml post /api/v1/spaces/{spaceId}/agents","href":"/api-reference/agents/create-an-agent"},{"title":"Get an agent","deprecated":null,"version":null,"openapi":"/openapi.yaml get /api/v1/spaces/{spaceId}/agents/{agentId}","href":"/api-reference/agents/get-an-agent"},{"title":"Update an agent","deprecated":null,"version":null,"openapi":"/openapi.yaml patch /api/v1/spaces/{spaceId}/agents/{agentId}","href":"/api-reference/agents/update-an-agent"},{"title":"Publish an agent","deprecated":null,"version":null,"openapi":"/openapi.yaml post /api/v1/spaces/{spaceId}/agents/{agentId}/publish","href":"/api-reference/agents/publish-an-agent"},{"title":"Unpublish an agent","deprecated":null,"version":null,"openapi":"/openapi.yaml post /api/v1/spaces/{spaceId}/agents/{agentId}/unpublish","href":"/api-reference/agents/unpublish-an-agent"},{"title":"Delete an agent","deprecated":null,"version":null,"openapi":"/openapi.yaml delete /api/v1/spaces/{spaceId}/agents/{agentId}","href":"/api-reference/agents/delete-an-agent"}]},{"group":"Skills","pages":[{"title":"Skills API Overview","href":"/admin/api/skills-overview"},{"title":"List skills","deprecated":null,"version":null,"openapi":"/openapi.yaml get /api/v1/spaces/{spaceId}/skills","href":"/api-reference/skills/list-skills"},{"title":"Create a skill","deprecated":null,"version":null,"openapi":"/openapi.yaml post /api/v1/spaces/{spaceId}/skills","href":"/api-reference/skills/create-a-skill"},{"title":"Get a skill","deprecated":null,"version":null,"openapi":"/openapi.yaml get /api/v1/spaces/{spaceId}/skills/{skillId}","href":"/api-reference/skills/get-a-skill"},{"title":"Update a skill","deprecated":null,"version":null,"openapi":"/openapi.yaml patch /api/v1/spaces/{spaceId}/skills/{skillId}","href":"/api-reference/skills/update-a-skill"},{"title":"Delete a skill","deprecated":null,"version":null,"openapi":"/openapi.yaml delete /api/v1/spaces/{spaceId}/skills/{skillId}","href":"/api-reference/skills/delete-a-skill"},{"title":"Enable a skill","deprecated":null,"version":null,"openapi":"/openapi.yaml post /api/v1/spaces/{spaceId}/skills/{skillId}/enable","href":"/api-reference/skills/enable-a-skill"},{"title":"Disable a skill","deprecated":null,"version":null,"openapi":"/openapi.yaml post /api/v1/spaces/{spaceId}/skills/{skillId}/disable","href":"/api-reference/skills/disable-a-skill"},{"title":"List skill files","deprecated":null,"version":null,"openapi":"/openapi.yaml get /api/v1/spaces/{spaceId}/skills/{skillId}/files","href":"/api-reference/skills/list-skill-files"},{"title":"Get a skill file","deprecated":null,"version":null,"openapi":"/openapi.yaml get /api/v1/spaces/{spaceId}/skills/{skillId}/files/{path}","href":"/api-reference/skills/get-a-skill-file"},{"title":"Create or replace a skill file","deprecated":null,"version":null,"openapi":"/openapi.yaml put /api/v1/spaces/{spaceId}/skills/{skillId}/files/{path}","href":"/api-reference/skills/create-or-replace-a-skill-file"},{"title":"Delete a skill file","deprecated":null,"version":null,"openapi":"/openapi.yaml delete /api/v1/spaces/{spaceId}/skills/{skillId}/files/{path}","href":"/api-reference/skills/delete-a-skill-file"}]}]}]},{"language":"de","tabs":[{"tab":"nuwacom nutzen","pages":[{"title":"nuwacom nutzen","href":"/de/product/gettingstarted"}]},{"tab":"Admin","pages":[{"title":"Admin","href":"/de/workspacesettings"}]},{"tab":"Sicherheit","pages":[{"title":"Sicherheit","href":"/de/overviewdatasecurity"}]},{"tab":"API Reference","groups":[{"group":"Übersicht","pages":[{"title":"API-Einführung","href":"/de/admin/apiendpunkte"}]},{"group":"AI","pages":[{"title":"List all AI models","deprecated":null,"version":null,"openapi":"/openapi.yaml get /api/ai/models","href":"/api-reference/ai/list-all-ai-models"},{"title":"List space AI models","deprecated":null,"version":null,"openapi":"/openapi.yaml get /api/ai/models/{spaceId}","href":"/api-reference/ai/list-space-ai-models"}]},{"group":"Assets","pages":[{"title":"Add an asset via URL","deprecated":null,"version":null,"openapi":"/openapi.yaml post /api/kb/assets","href":"/api-reference/assets/add-an-asset-via-url"},{"title":"Upload an asset","deprecated":null,"version":null,"openapi":"/openapi.yaml post /api/kb/assets/upload","href":"/api-reference/assets/upload-an-asset"},{"title":"Get an asset","deprecated":null,"version":null,"openapi":"/openapi.yaml get /api/kb/assets/{spaceId}/{assetId}","href":"/api-reference/assets/get-an-asset"},{"title":"Update an asset","deprecated":null,"version":null,"openapi":"/openapi.yaml patch /api/kb/assets/{spaceId}/{assetId}","href":"/api-reference/assets/update-an-asset"},{"title":"Delete an asset","description":"Permanently delete an asset from the given space. This removes the stored file and any derived embeddings for that asset.","deprecated":null,"version":null,"openapi":"/openapi.yaml delete /api/kb/assets/{spaceId}/{assetId}","href":"/api-reference/assets/delete-an-asset"}]},{"group":"Completion API","pages":[{"title":"OpenAI Chat Completion","deprecated":null,"version":null,"openapi":"/openapi.yaml post /api/v1/openai/chat/completions","href":"/api-reference/completion-api/openai-chat-completion"}]},{"group":"Agents","pages":[{"title":"Agents-API Übersicht","description":"Agents in deinem nuwacom Workspace programmatisch erstellen, verwalten und nutzen","href":"/de/admin/agents-api-uebersicht"},{"title":"List agents","deprecated":null,"version":null,"openapi":"/openapi.yaml get /api/v1/spaces/{spaceId}/agents","href":"/api-reference/agents/list-agents"},{"title":"Create an agent","deprecated":null,"version":null,"openapi":"/openapi.yaml post /api/v1/spaces/{spaceId}/agents","href":"/api-reference/agents/create-an-agent"},{"title":"Get an agent","deprecated":null,"version":null,"openapi":"/openapi.yaml get /api/v1/spaces/{spaceId}/agents/{agentId}","href":"/api-reference/agents/get-an-agent"},{"title":"Update an agent","deprecated":null,"version":null,"openapi":"/openapi.yaml patch /api/v1/spaces/{spaceId}/agents/{agentId}","href":"/api-reference/agents/update-an-agent"},{"title":"Publish an agent","deprecated":null,"version":null,"openapi":"/openapi.yaml post /api/v1/spaces/{spaceId}/agents/{agentId}/publish","href":"/api-reference/agents/publish-an-agent"},{"title":"Unpublish an agent","deprecated":null,"version":null,"openapi":"/openapi.yaml post /api/v1/spaces/{spaceId}/agents/{agentId}/unpublish","href":"/api-reference/agents/unpublish-an-agent"},{"title":"Delete an agent","deprecated":null,"version":null,"openapi":"/openapi.yaml delete /api/v1/spaces/{spaceId}/agents/{agentId}","href":"/api-reference/agents/delete-an-agent"}]},{"group":"Skills","pages":[{"title":"Skills-API Übersicht","href":"/de/admin/skills-api-uebersicht"},{"title":"List skills","deprecated":null,"version":null,"openapi":"/openapi.yaml get /api/v1/spaces/{spaceId}/skills","href":"/api-reference/skills/list-skills"},{"title":"Create a skill","deprecated":null,"version":null,"openapi":"/openapi.yaml post /api/v1/spaces/{spaceId}/skills","href":"/api-reference/skills/create-a-skill"},{"title":"Get a skill","deprecated":null,"version":null,"openapi":"/openapi.yaml get /api/v1/spaces/{spaceId}/skills/{skillId}","href":"/api-reference/skills/get-a-skill"},{"title":"Update a skill","deprecated":null,"version":null,"openapi":"/openapi.yaml patch /api/v1/spaces/{spaceId}/skills/{skillId}","href":"/api-reference/skills/update-a-skill"},{"title":"Delete a skill","deprecated":null,"version":null,"openapi":"/openapi.yaml delete /api/v1/spaces/{spaceId}/skills/{skillId}","href":"/api-reference/skills/delete-a-skill"},{"title":"Enable a skill","deprecated":null,"version":null,"openapi":"/openapi.yaml post /api/v1/spaces/{spaceId}/skills/{skillId}/enable","href":"/api-reference/skills/enable-a-skill"},{"title":"Disable a skill","deprecated":null,"version":null,"openapi":"/openapi.yaml post /api/v1/spaces/{spaceId}/skills/{skillId}/disable","href":"/api-reference/skills/disable-a-skill"},{"title":"List skill files","deprecated":null,"version":null,"openapi":"/openapi.yaml get /api/v1/spaces/{spaceId}/skills/{skillId}/files","href":"/api-reference/skills/list-skill-files"},{"title":"Get a skill file","deprecated":null,"version":null,"openapi":"/openapi.yaml get /api/v1/spaces/{spaceId}/skills/{skillId}/files/{path}","href":"/api-reference/skills/get-a-skill-file"},{"title":"Create or replace a skill file","deprecated":null,"version":null,"openapi":"/openapi.yaml put /api/v1/spaces/{spaceId}/skills/{skillId}/files/{path}","href":"/api-reference/skills/create-or-replace-a-skill-file"},{"title":"Delete a skill file","deprecated":null,"version":null,"openapi":"/openapi.yaml delete /api/v1/spaces/{spaceId}/skills/{skillId}/files/{path}","href":"/api-reference/skills/delete-a-skill-file"}]}]}]}]},"title":"OpenAI Chat Completion - nuwacom Documentation","buildId":"dpl_cadrRc5H9XQiJQbDFN5mcYRs2PAj","deploymentId":"dpl_cadrRc5H9XQiJQbDFN5mcYRs2PAj","dynamics":["c2aa737661","2b790eda92","b0f84f53ff","a9bb46feb3"],"chunks":["OpenApiReferenceProvider-DKJwRUt2.js","utils-CWD_VS3u.js","cloneDeep-izs3Hzxb.js","_Uint8Array-BVIqJ90l.js","isObjectLike-C8vmzPEN.js","isArray-Dcu1dQ5t.js","utils-oFjciODD.js","toString-BX-iyh8G.js","isSymbol-CSH9U2Gm.js","addUniqueKeysToSchema-C76WsxC3.js","snippetPresets-DvPMxpX_.js","style-to-object-BY3JEAdk.js","v4-DIgz8zy6.js","ApiExamples-CuNQfndH.js","isEqual-BfaiBbcl.js","usePlaygroundInputsStore-BVFpVUoF.js","shallow-t59Jg5Kr.js","getApiPlaygroundDisplay-C_JZ4amX.js","CodeSnippet-CLRDnx_h.js","CodeSnippets-C2myU4kc.js","Page-7TwLLapg.js","getPastedJson-B-JaVXw7.js","icon-BA-iDhH3.js","MethodPill-D4qZABFp.js","DuplicateIcon-THIDKO1O.js","createIcon-CYYJwgFd.js","DynamicMarkdown-UGQuxDKp.js","SectionHeading-jYELb23h.js","axios-vUo_bRtp.js","Markdown-DKsLa3wy.js","clsx-CefdjKz2.js","lib--scc4DXi.js","lib-B8HbPgcC.js","html-void-elements-mCSPHezU.js","dist-BaREnp3o.js","katex-YMM-FMeD.js","marked.esm-CZWythHk.js","AssistantPageLink-sgx_0XzF.js"]}