> ## Documentation Index > Fetch the complete documentation index at: https://www.voiceflow.com/docs/llms.txt > Use this file to discover all available pages before exploring further. # Update prompt > Changes a prompt's name, its system text, or its whole settings object, and edits it in place so the step that uses it keeps pointing at the same ID. The `settings` value you send replaces the stored one, and an empty object returns it to the project defaults. ## OpenAPI ````yaml /specs-prettified/realtime/openapi.stable.json patch /v1/stable/prompt/{promptID} openapi: 3.0.0 info: title: Realtime description: Realtime gateway API service version: 1.0.0 contact: {} servers: - url: https://realtime-api.voiceflow.com security: [] tags: [] paths: /v1/stable/prompt/{promptID}: patch: tags: - Prompt summary: Update prompt description: Changes a prompt's name, its system text, or its whole settings object, and edits it in place so the step that uses it keeps pointing at the same ID. The `settings` value you send replaces the stored one, and an empty object returns it to the project defaults. operationId: StablePromptController_update parameters: - name: promptID required: true in: path schema: type: string x-vf-doc: description: The ID of the prompt to operate on. description: The ID of the prompt to operate on. - name: projectID required: true in: query schema: type: string description: The ID of the project to operate on. - name: environmentAlias required: true in: query schema: type: string description: The alias of the environment to operate on (e.g. `main`). requestBody: required: true content: application/json: schema: allOf: - $ref: "#/components/schemas/StablePromptUpdateRequest" responses: "200": description: Confirms the prompt was updated. The body is a message, with `unresolvedReferences` for any variable or reference in the new system text that did not resolve. content: application/json: schema: $ref: "#/components/schemas/StableTextUpdateResponse" x-vf-doc: description: Confirms the prompt was updated. The body is a message, with `unresolvedReferences` for any variable or reference in the new system text that did not resolve. security: - token: [] components: schemas: StablePromptUpdateRequest: type: object properties: name: type: string minLength: 1 maxLength: 255 system: allOf: - $ref: "#/components/schemas/VariableReferenceString" settings: allOf: - $ref: "#/components/schemas/StablePromptSettingsRequest" additionalProperties: false VariableReferenceString: type: string description: Plain text; markdown is not interpreted. {variable_name} inserts a variable or entity, {variable_name.path} a field of a variable. Escape a literal { or \ with a backslash. A name matching neither is stored as literal text and reported in unresolvedReferences; secrets are not available here. StablePromptSettingsRequest: type: object properties: model: allOf: - $ref: "#/components/schemas/AIModel" maxTokens: type: number temperature: type: number responseFormat: type: string reasoningEffort: nullable: true allOf: - $ref: "#/components/schemas/AIReasoningEffort" serviceTier: description: "The service tier to request from models that support it. `priority` is faster processing: faster responses at a higher credit cost. When unset, the deprecated project-level `priorityProcessing` setting applies." nullable: true allOf: - $ref: "#/components/schemas/AIParamsServiceTier" useStructuredOutput: type: boolean additionalProperties: false AIModel: type: string enum: - gpt-3.5-turbo-1106 - gpt-3.5-turbo - gpt-4 - gpt-4o - gpt-4o-mini - gpt-4.1-2025-04-14 - gpt-4.1-mini-2025-04-14 - gpt-4.1-nano-2025-04-14 - gpt-o3-mini - o3-2025-04-16 - o4-mini-2025-04-16 - gpt-5 - gpt-5-mini - gpt-5-nano - gpt-5.2 - gpt-5.4 - gpt-5.4-mini - gpt-5.5 - gpt-5.6-sol - gpt-5.6-terra - gpt-5.6-luna - gpt-6-sol - gpt-6-luna - gpt-6.1-sol - gpt-realtime - gpt-live-1 - claude-4-opus - claude-4-sonnet - claude-4.5-sonnet - claude-4.6-sonnet - claude-4.5-haiku - claude-4.5-opus - claude-4.7-opus - bedrock-claude-4-sonnet - bedrock-claude-4.5-sonnet - bedrock-claude-4.6-sonnet - bedrock-claude-5-sonnet - bedrock-claude-5.5-sonnet - bedrock-claude-4.5-haiku - bedrock-claude-4.5-opus - bedrock-claude-4.7-opus - bedrock-claude-4.8-opus - voiceflow-core-4.0 - voiceflow-core-4.1 - voiceflow-core-4.2 - voiceflow-flash-4.2 - gemini-2.5-pro - gemini-2.5-flash - gemini-live-2.5-flash - gemini-3-flash - gemini-3.5-flash - gemini-3.1-pro - gpt-oss-20b - gpt-oss-120b - llama-guard-4 - llama-3.1-instant - llama-3.3-versatile - qwen3.6-27b - grok-4.6 - voiceflow-flash-4.1 - kimi-k3 - gemini-flash-2 - gpt-4-turbo - claude-3.5-haiku - claude-3-opus - claude-3.7-sonnet - claude-v2 - llama-3.2-1b-preview - gemini-pro-1.5 - claude-3-haiku - claude-3-sonnet - text-davinci-003 - claude-v1 - claude-instant-v1 - deep-seek-r1-distill-llama-70B - claude-3.5-sonnet x-enumNames: - GPT_3_5_TURBO_1106 - GPT_3_5_TURBO - GPT_4 - GPT_4_O - GPT_4_O_MINI - GPT_4_1 - GPT_4_1_MINI - GPT_4_1_NANO - GPT_O_3_MINI - GPT_O_3 - GPT_O_4_MINI - GPT_5 - GPT_5_MINI - GPT_5_NANO - GPT_5_2 - GPT_5_4 - GPT_5_4_MINI - GPT_5_5 - GPT_5_6_SOL - GPT_5_6_TERRA - GPT_5_6_LUNA - GPT_6_SOL - GPT_6_LUNA - GPT_6_1_SOL - GPT_REALTIME - GPT_LIVE_1 - CLAUDE_4_OPUS - CLAUDE_4_SONNET - CLAUDE_4_5_SONNET - CLAUDE_4_6_SONNET - CLAUDE_4_5_HAIKU - CLAUDE_4_5_OPUS - CLAUDE_4_7_OPUS - BEDROCK_CLAUDE_4_SONNET - BEDROCK_CLAUDE_4_5_SONNET - BEDROCK_CLAUDE_4_6_SONNET - BEDROCK_CLAUDE_5_SONNET - BEDROCK_CLAUDE_5_5_SONNET - BEDROCK_CLAUDE_4_5_HAIKU - BEDROCK_CLAUDE_4_5_OPUS - BEDROCK_CLAUDE_4_7_OPUS - BEDROCK_CLAUDE_4_8_OPUS - VOICEFLOW_CORE_4_0 - VOICEFLOW_CORE_4_1 - VOICEFLOW_CORE_4_2 - VOICEFLOW_FLASH_4_2 - GEMINI_2_5_PRO - GEMINI_2_5_FLASH - GEMINI_LIVE_2_5_FLASH - GEMINI_3_FLASH - GEMINI_3_5_FLASH - GEMINI_3_1_PRO - GPT_OSS_20_B - GPT_OSS_120_B - LLAMA_GUARD_4 - LLAMA_3_1_INSTANT - LLAMA_3_3_VERSATILE - QWEN_3_6_27_B - GROK_4_6 - VOICEFLOW_FLASH_4_1 - KIMI_K_3 - GEMINI_FLASH_2 - GPT_4_TURBO - CLAUDE_3_5_HAIKU - CLAUDE_3_OPUS - CLAUDE_3_7_SONNET - CLAUDE_V_2 - LLAMA_3_2_1_B_PREVIEW - GEMINI_PRO_1_5 - CLAUDE_3_HAIKU - CLAUDE_3_SONNET - DA_VINCI_003 - CLAUDE_V_1 - CLAUDE_INSTANT_V_1 - DEEP_SEEK_R_1_DISTILL_LLAMA_70_B - CLAUDE_3_5_SONNET AIReasoningEffort: type: string enum: - off - adaptive - minimal - low - medium - high x-enumNames: - OFF - ADAPTIVE - MINIMAL - LOW - MEDIUM - HIGH AIParamsServiceTier: type: string enum: - default - flex - priority x-enumNames: - DEFAULT - FLEX - PRIORITY StableTextUpdateResponse: type: object properties: message: type: string description: A human-readable message confirming the update. unresolvedReferences: description: References this write kept as literal text instead of binding, each with the reason. The write still succeeded. type: array items: $ref: "#/components/schemas/StableUnresolvedReference" required: - message StableUnresolvedReference: type: object properties: path: type: string description: Dotted path of the field that carried it, e.g. `knowledgeBaseTool.filters[0].defaultValue`. token: type: string description: The reference as written, without braces. reason: type: string enum: - unknown - secret-not-allowed - path-on-non-variable - resource-id - invalid-name - dangling description: "`unknown`: no variable or entity of that name. `secret-not-allowed`: the name is a project secret and this field does not accept one. `path-on-non-variable`: only a variable has fields. `resource-id`: a bare resource id, not a name. `invalid-name`: outside the `^\\w{1,64}$` name grammar. `dangling`: the reference rendered as a bare id, because its row is gone or its name is outside the name grammar." x-enumNames: - UNKNOWN - SECRET_NOT_ALLOWED - PATH_ON_NON_VARIABLE - RESOURCE_ID - INVALID_NAME - DANGLING required: - path - token - reason securitySchemes: token: scheme: bearer bearerFormat: JWT type: http description: Voiceflow bearer token ````