---
title: "Create Or Update Chat Starter Settings For A Registered Agent"
method: PUT
path: "/v1/orchestrate/agents/{id}/chat-starter-settings"
tags: ["Agent Chat Starter Settings"]
---

# Create Or Update Chat Starter Settings For A Registered Agent

`PUT /v1/orchestrate/agents/{id}/chat-starter-settings`

Create or update chat starter settings for a registered agent.

## Path parameters

- `id` string, required

## Request body

- AgentChatStarterSettingsIn — A specification for chat starter settings within an agent
  - `starter_prompts` AgentCustomizedPromptsIn
    - `customize` AgentPrompt[] — list of starter prompts of the agent
      - `id` string — Unique identifier for the prompt
      - `title` string, required — Title of the prompt
      - `subtitle` string — description of the prompt
      - `prompt` string, required — contents of the prompt
      - `state` string — active/inactivate
  - `welcome_content` AgentWelcomeContentIn
    - `welcome_message` string, nullable — Welcome message
    - `description` string, nullable — Description
    - `is_default_voice_greeting` boolean — is the welcome message the default voice greeting
  - `icon` string — A raw SVG XML string (normalized from bytes / single- / double-escaped) that passes square-icon validation. When serialized, it's just a string.

## Response `200`

Successful Response

- unknown

## Other responses

- `422` — Validation Error

---

[API](https://skmtc.net/ibm/apis/wxo-server-api.md) · [All operations](https://skmtc.net/ibm/apis/wxo-server-api/llms.txt) · [OpenAPI document](https://skmtc-service-staging.skmtc.workers.dev/v1/apis/ibm/wxo-server-api/revisions/82c114c37196/schema)