---
title: "Register Watsonx Assistant Instance"
method: POST
path: "/v1/assistants/watsonx"
tags: ["watsonx Assistant"]
---

# Register Watsonx Assistant Instance

`POST /v1/assistants/watsonx`

## Request body

- RegisterWatsonAssistant
  - `title` string, nullable
  - `description` string, required
  - `tags` string[], nullable
  - `name` string, nullable
  - `nickname` string, nullable
  - `config` WatsonAssistantConfigRequest, required
    - `assistant_id` string, required
    - `environment_id` string, required
    - `intent` string, nullable
    - `action_title` string, nullable
    - `search_stickiness` boolean
    - `shareable_context` boolean
    - `hidden` boolean
    - `api_key` string, nullable
    - `service_instance_url` string, required
    - `api_version` string
    - `auth_type` 'ICP_IAM' | 'IBM_CLOUD_IAM' | 'MCSP' | 'BEARER_TOKEN'
    - `auth_config` object, nullable
    - `authorization_url` string, nullable
    - `crn` string, nullable
    - `message_context` object, nullable
    - `connection_id` string, nullable
    - `context_access_enabled` boolean — Enable access to context variables for this agent
    - `context_variables` string[] — List of context variable names that this agent can access

## 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)