> This page is for API Reference & Tools.

> For clean Markdown of any page, append .md to the page URL.
> For a complete documentation index, see https://docs.moveworks.com/llms.txt.
> For AI client integration (Claude Code, Cursor, etc.), connect to the MCP server at https://docs.moveworks.com/_mcp/server.

# Create surface

POST https://api.moveworks.ai/configurations/v1alpha1/assistant/surfaces
Content-Type: application/json

Creates a surface and returns it with its server-assigned `id` and `version`.

Send the fields at the top level of the body. Don't send `id` or `version.num`; `version.change_description` is required.

Reference: https://docs.moveworks.com/api-reference/configuration-api/platform-org/surfaces/create-surface

## Authentication

- `Authorization` header (bearer token, required) — JWT bearer token authentication. Include the Configuration API key in the Authorization header as 'Bearer \<token>'.

## Request

### Body (application/json)

This endpoint expects a SurfaceConfigCreate.

- `channel` (enum, required) — Chat platform this bot runs on. Allowed values: msteams, movewebchat, slack, gchat, webex, zoom, glip, sms, conversationsrestapi. Cannot be changed after creation.
  - Allowed values: `msteams`, `movewebchat`, `slack`, `gchat`, `webex`, `zoom`, `glip`, `sms`, `conversationsrestapi`
- `version` (VersionCreate, required) — Document version. On update, send back the num from your last read.
- `assistant_id` (string, optional) — Bot ID of the account the assistant sends messages from, e.g. the Slack bot ID starting with B or the Google Chat bot email. For web chat it is generated from name and can be left empty on create.
- `name` (string, optional) — Unique Moveworks identifier for the bot, in the form orgname-channel (e.g. acme-slack). Letters, digits, underscores and hyphens only. Cannot be changed after creation.
- `assistant_name` (string, optional) — Customer-facing display name of the bot, usually the same across all of an organization's bots.
- `connector_id` (string, optional) — Connector used for this chat integration. Required except for movewebchat, gchat, zoom and webex, where one is created automatically if left empty. Cannot be changed after creation. ID of an existing connector (GET /configurations/v1alpha1/platform/connectors).
- `file_attachment_enabled` (boolean, optional) — If true, users can send file attachments to the bot.
- `ms_teams_config` (MSTeamsConfigCreate, optional) — Microsoft Teams settings. Set this when channel is msteams.
- `slack_config` (SurfaceSlackConfigCreate, optional) — Slack settings. Set this when channel is slack.
- `movewebchat_config` (MoveWebchatConfig, optional) — Moveworks web chat settings. Set this when channel is movewebchat.
- `gchat_config` (GChatConfigCreate, optional) — Google Chat settings. Set this when channel is gchat.
- `webex_config` (WebexConfigCreate, optional) — Webex settings. Set this when channel is webex.
- `zoom_config` (SurfaceZoomConfigCreate, optional) — Zoom settings. Set this when channel is zoom.
- `glip_config` (GlipConfigCreate, optional) — Glip (RingCentral) settings. Set this when channel is glip.
- `sms_config` (SMSConfig, optional) — SMS settings. Set this when channel is sms.
- `conversations_rest_api_config` (ConversationsRestAPIConfig, optional) — Conversations REST API settings. Set this when channel is conversationsrestapi; it has no fields.

## Response

### 200

The created surface

- `id` (string, optional) — Unique ID of this configuration, assigned by the server.
- `assistant_id` (string, optional) — Bot ID of the account the assistant sends messages from, e.g. the Slack bot ID starting with B or the Google Chat bot email. For web chat it is generated from name and can be left empty on create.
- `name` (string, optional) — Unique Moveworks identifier for the bot, in the form orgname-channel (e.g. acme-slack). Letters, digits, underscores and hyphens only. Cannot be changed after creation.
- `assistant_name` (string, optional) — Customer-facing display name of the bot, usually the same across all of an organization's bots.
- `channel` (enum, optional) — Chat platform this bot runs on. Allowed values: msteams, movewebchat, slack, gchat, webex, zoom, glip, sms, conversationsrestapi. Cannot be changed after creation.
  - Allowed values: `msteams`, `movewebchat`, `slack`, `gchat`, `webex`, `zoom`, `glip`, `sms`, `conversationsrestapi`
- `connector_id` (string, optional) — Connector used for this chat integration. Required except for movewebchat, gchat, zoom and webex, where one is created automatically if left empty. Cannot be changed after creation. ID of an existing connector (GET /configurations/v1alpha1/platform/connectors).
- `file_attachment_enabled` (boolean, optional) — If true, users can send file attachments to the bot.
- `ms_teams_config` (MSTeamsConfig, optional) — Microsoft Teams settings. Set this when channel is msteams.
- `slack_config` (SurfaceSlackConfig, optional) — Slack settings. Set this when channel is slack.
- `movewebchat_config` (MoveWebchatConfig, optional) — Moveworks web chat settings. Set this when channel is movewebchat.
- `gchat_config` (GChatConfig, optional) — Google Chat settings. Set this when channel is gchat.
- `webex_config` (WebexConfig, optional) — Webex settings. Set this when channel is webex.
- `zoom_config` (SurfaceZoomConfig, optional) — Zoom settings. Set this when channel is zoom.
- `glip_config` (GlipConfig, optional) — Glip (RingCentral) settings. Set this when channel is glip.
- `sms_config` (SMSConfig, optional) — SMS settings. Set this when channel is sms.
- `conversations_rest_api_config` (ConversationsRestAPIConfig, optional) — Conversations REST API settings. Set this when channel is conversationsrestapi; it has no fields.
- `updated_time` (datetime, optional) — When the configuration was last updated.
- `updated_by` (string, optional) — Who last updated the configuration.
- `version` (Version, optional) — Document version. On update, send back the num from your last read.

## Errors

### 400 Bad Request Error

Bad request - the body breaks a rule in the schema (a missing required field, an unknown enum value, an invalid DSL or Data Mapper expression), `version.change_description` is missing, or an id in the body doesn't match the URL

- `error` (ErrorResponseError, required)

### 401 Unauthorized Error

Unauthorized - the `Authorization` header is missing or the token is invalid

- `error` (ErrorResponseError, required)

### 403 Forbidden Error

Forbidden - the API key isn't allowed to change this configuration, or the configuration is frozen for your organization

- `error` (ErrorResponseError, required)

### 409 Conflict Error

Conflict - `version.num` doesn't match the stored version (someone changed it since your last read; read it again and retry), or the item already exists

- `error` (ErrorResponseError, required)

### 429 Too Many Requests Error

Too many requests - the organization exceeded the Configuration API rate limit. Back off and retry.

- `error` (ErrorResponseError, required)

### 500 Internal Server Error

Internal server error - retry the request

- `error` (ErrorResponseError, required)

## Types

### VersionCreate

- `change_description` (string, required) — A short note describing this change. Required on every create and update.

### MSTeamsConfigCreate

- `app_id` (string, optional) — Microsoft Teams app ID, as a lowercase GUID.
- `app_guid` (string, optional) — Microsoft Teams app GUID, as shown in the Teams client. Needed when the bot was installed with the Teams app registration method.
- `tenant_id` (string, optional) — Microsoft Teams (Entra) tenant ID, as a lowercase GUID.
- `msteams_app_store_credentials` (MSTeamsAppStoreCredentials, optional) — Use no credentials because the Moveworks app was installed from the Microsoft Teams Store (AppSource). Supports only one Teams bot per customer. Set this, credentials_secret or oauth2_jwt_client_assertion_auth.
- `credentials_secret` (string, optional) — Microsoft Graph client secret generated in the Azure portal for your Azure Bot app. Set this, msteams_app_store_credentials or oauth2_jwt_client_assertion_auth. Secret: send the real value; it is stored encrypted.
- `oauth2_jwt_client_assertion_auth` (MSTeamsOauth2JwtClientAssertionAuthCreate, optional) — Certificate-based authentication using OAuth2 client credentials with a JWT assertion. Set this, msteams_app_store_credentials or credentials_secret.
- `region` (enum, optional) — Microsoft Teams region, set only if the app lives in a regional Microsoft tenant. Allowed values: AMER, APAC, EMEA, GCC, GCCH, or empty.
  - Allowed values: ``, `AMER`, `APAC`, `EMEA`, `GCC`, `GCCH`
- `teams_single_tenant_auth_endpoint_enabled` (boolean, optional) — If true, the bot uses single-tenant Microsoft authentication. Needed for new non-App Store Teams bots created after July 2025.

### SurfaceSlackConfigCreate

- `app_id` (string, optional) — Slack app ID, starting with A.
- `user_id` (string, optional) — Slack user ID of the bot, starting with U or W.
- `team_id` (string, optional) — Slack team (workspace) or enterprise ID, starting with T or E.
- `assistant_id` (string, optional) — Slack bot ID, starting with B.
- `chat_system_url` (string, optional) — URL of your Slack workspace, e.g. https://acme.slack.com.
- `instance_name` (string, optional) — Name of your Slack instance.
- `signing_secret` (string, optional) — Slack signing secret used to verify requests sent by Slack. Secret: send the real value; it is stored encrypted.
- `region` (string, optional) — Slack cloud hosting the app. Allowed values: COMMERCIAL, GOV. Use GOV only if the Slack app is hosted in the GOV cloud.
- `allow_multiple_threads` (boolean, optional) — If true, the bot can handle multiple concurrent chat threads. Enable this when using Slack agent mode.

### MoveWebchatConfig

- `on_prem_agent_id` (string, optional) — ID of the on-premises agent used by this web chat bot.
- `app_id` (string, optional) — Numeric web chat app ID. Generated from the surface name on create, so it can be left empty.
- `subdomain` (string, optional) — Custom domain alias that overrides the default bot domain. For a domain like abc.moveworks.com, enter abc.
- `surface` (string, optional) — Product UI surface where the web chat bot appears. Allowed values: embedded, assistant, employee-slate.

### GChatConfigCreate

- `app_id` (string, optional) — Google Chat app ID, which is the bot's email address.
- `proactive_reachout_enabled` (boolean, optional) — If true, the bot can proactively reach out to users in Google Chat.
- `credentials_secret` (string, optional) — JSON credentials file generated for the Google Chat app. Secret: send the real value; it is stored encrypted.
- `deep_link` (string, optional) — Link users open to chat with the bot, such as a Google Chat bot catalog link or a link from your SSO provider.
- `audience` (string, optional) — GCP project number of the Google Cloud project that owns the Chat app, used to verify inbound events from Google Chat. Up to 20 digits.

### WebexConfigCreate

- `app_id` (string, optional) — Webex app ID, an 86-character alphanumeric string.
- `public_url` (string, optional) — Public URL of the Webex bot.
- `org_id` (string, optional) — Webex organization ID.
- `domain_whitelist` (list of string, optional) — Email domains allowed to interact with the Webex bot, e.g. acme.com.
- `secret_token` (string, optional) — Webex bot API token. Secret: send the real value; it is stored encrypted.

### SurfaceZoomConfigCreate

- `bot_jid` (string, optional) — Zoom bot JID, in the form \<24 characters>@xmpp.zoom.us.
- `client_id` (string, optional) — Zoom app client ID.
- `account_id` (string, optional) — Zoom account ID.
- `app_id` (string, optional) — Zoom app ID, in the form \<24 characters>@xmpp.zoom.us.
- `client_secret` (string, optional) — Zoom app client secret. Secret: send the real value; it is stored encrypted.
- `verification_secret_key` (string, optional) — Secret key used to verify inbound messages from Zoom. Secret: send the real value; it is stored encrypted.
- `s2s_client_id` (string, optional) — Client ID of the Zoom Server-to-Server OAuth app.
- `s2s_client_secret` (string, optional) — Client secret of the Zoom Server-to-Server OAuth app. Secret: send the real value; it is stored encrypted.

### GlipConfigCreate

- `app_id` (string, optional) — Numeric Glip app ID.
- `public_url` (string, optional) — Public URL of the Glip bot.
- `secret_token` (string, optional) — Glip bot token. Secret: send the real value; it is stored encrypted.
- `verification_secret_token` (string, optional) — Glip verification token used to verify inbound requests. Secret: send the real value; it is stored encrypted.

### SMSConfig

- `app_id` (string, optional) — SMS app ID, as a lowercase GUID.

### ConversationsRestAPIConfig

### MSTeamsConfig

- `app_id` (string, optional) — Microsoft Teams app ID, as a lowercase GUID.
- `app_guid` (string, optional) — Microsoft Teams app GUID, as shown in the Teams client. Needed when the bot was installed with the Teams app registration method.
- `tenant_id` (string, optional) — Microsoft Teams (Entra) tenant ID, as a lowercase GUID.
- `msteams_app_store_credentials` (MSTeamsAppStoreCredentials, optional) — Use no credentials because the Moveworks app was installed from the Microsoft Teams Store (AppSource). Supports only one Teams bot per customer. Set this, credentials_secret or oauth2_jwt_client_assertion_auth.
- `credentials_secret` (string, optional) — Microsoft Graph client secret generated in the Azure portal for your Azure Bot app. Set this, msteams_app_store_credentials or oauth2_jwt_client_assertion_auth. Secret: always returned masked as *****.
- `oauth2_jwt_client_assertion_auth` (MSTeamsOauth2JwtClientAssertionAuth, optional) — Certificate-based authentication using OAuth2 client credentials with a JWT assertion. Set this, msteams_app_store_credentials or credentials_secret.
- `region` (enum, optional) — Microsoft Teams region, set only if the app lives in a regional Microsoft tenant. Allowed values: AMER, APAC, EMEA, GCC, GCCH, or empty.
  - Allowed values: ``, `AMER`, `APAC`, `EMEA`, `GCC`, `GCCH`
- `teams_single_tenant_auth_endpoint_enabled` (boolean, optional) — If true, the bot uses single-tenant Microsoft authentication. Needed for new non-App Store Teams bots created after July 2025.

### SurfaceSlackConfig

- `app_id` (string, optional) — Slack app ID, starting with A.
- `user_id` (string, optional) — Slack user ID of the bot, starting with U or W.
- `team_id` (string, optional) — Slack team (workspace) or enterprise ID, starting with T or E.
- `assistant_id` (string, optional) — Slack bot ID, starting with B.
- `chat_system_url` (string, optional) — URL of your Slack workspace, e.g. https://acme.slack.com.
- `instance_name` (string, optional) — Name of your Slack instance.
- `signing_secret` (string, optional) — Slack signing secret used to verify requests sent by Slack. Secret: always returned masked as *****.
- `region` (string, optional) — Slack cloud hosting the app. Allowed values: COMMERCIAL, GOV. Use GOV only if the Slack app is hosted in the GOV cloud.
- `allow_multiple_threads` (boolean, optional) — If true, the bot can handle multiple concurrent chat threads. Enable this when using Slack agent mode.

### GChatConfig

- `app_id` (string, optional) — Google Chat app ID, which is the bot's email address.
- `proactive_reachout_enabled` (boolean, optional) — If true, the bot can proactively reach out to users in Google Chat.
- `credentials_secret` (string, optional) — JSON credentials file generated for the Google Chat app. Secret: always returned masked as *****.
- `deep_link` (string, optional) — Link users open to chat with the bot, such as a Google Chat bot catalog link or a link from your SSO provider.
- `audience` (string, optional) — GCP project number of the Google Cloud project that owns the Chat app, used to verify inbound events from Google Chat. Up to 20 digits.

### WebexConfig

- `app_id` (string, optional) — Webex app ID, an 86-character alphanumeric string.
- `public_url` (string, optional) — Public URL of the Webex bot.
- `org_id` (string, optional) — Webex organization ID.
- `domain_whitelist` (list of string, optional) — Email domains allowed to interact with the Webex bot, e.g. acme.com.
- `secret_token` (string, optional) — Webex bot API token. Secret: always returned masked as *****.

### SurfaceZoomConfig

- `bot_jid` (string, optional) — Zoom bot JID, in the form \<24 characters>@xmpp.zoom.us.
- `client_id` (string, optional) — Zoom app client ID.
- `account_id` (string, optional) — Zoom account ID.
- `app_id` (string, optional) — Zoom app ID, in the form \<24 characters>@xmpp.zoom.us.
- `client_secret` (string, optional) — Zoom app client secret. Secret: always returned masked as *****.
- `verification_secret_key` (string, optional) — Secret key used to verify inbound messages from Zoom. Secret: always returned masked as *****.
- `s2s_client_id` (string, optional) — Client ID of the Zoom Server-to-Server OAuth app.
- `s2s_client_secret` (string, optional) — Client secret of the Zoom Server-to-Server OAuth app. Secret: always returned masked as *****.

### GlipConfig

- `app_id` (string, optional) — Numeric Glip app ID.
- `public_url` (string, optional) — Public URL of the Glip bot.
- `secret_token` (string, optional) — Glip bot token. Secret: always returned masked as *****.
- `verification_secret_token` (string, optional) — Glip verification token used to verify inbound requests. Secret: always returned masked as *****.

### Version

- `num` (integer, optional) — Version number set by the server. On update, send the num from your last read; a stale num is rejected as a conflict.
- `change_description` (string, optional) — A short note describing this change. Required on every create and update.

### ErrorResponseError

- `code` (string, optional) — A machine-readable error code.
- `message` (string, optional) — What went wrong, and for a rejected field, which rule it broke.

### MSTeamsAppStoreCredentials

### MSTeamsOauth2JwtClientAssertionAuthCreate

- `x5t_s256_token` (string, required) — SHA-256 thumbprint of the certificate uploaded to your Microsoft Entra app registration, as a hexadecimal string without colons or spaces. Secret: send the real value; it is stored encrypted.
- `private_key` (string, required) — PEM private key that corresponds to the certificate uploaded to your Microsoft Entra app registration. Secret: send the real value; it is stored encrypted.

### MSTeamsOauth2JwtClientAssertionAuth

- `x5t_s256_token` (string, optional) — SHA-256 thumbprint of the certificate uploaded to your Microsoft Entra app registration, as a hexadecimal string without colons or spaces. Secret: always returned masked as *****.
- `private_key` (string, optional) — PEM private key that corresponds to the certificate uploaded to your Microsoft Entra app registration. Secret: always returned masked as *****.

## Examples

### Surfaces endpoints_createSurface_example

**Response**

```json
{
  "id": "3f6c1e2a-8b4d-4c7e-9a1f-2d5b6c7e8f90",
  "assistant_id": "<id>",
  "name": "example-name",
  "slack_config": {
    "app_id": "A0123456789",
    "user_id": "U0123456789",
    "team_id": "T0123456789",
    "assistant_id": "B0123456789",
    "chat_system_url": "https://example.com/path",
    "instance_name": "acme"
  },
  "updated_time": "2026-11-12T18:04:11Z",
  "updated_by": "admin@example.com",
  "version": {
    "num": 1,
    "change_description": "Create surface"
  }
}
```

**SDK Code**

```python Surfaces endpoints_createSurface_example
import requests

url = "https://api.moveworks.ai/configurations/v1alpha1/assistant/surfaces"

headers = {"Authorization": "Bearer <token>"}

response = requests.post(url, headers=headers)

print(response.json())
```

```javascript Surfaces endpoints_createSurface_example
const url = 'https://api.moveworks.ai/configurations/v1alpha1/assistant/surfaces';
const options = {method: 'POST', headers: {Authorization: 'Bearer <token>'}};

try {
  const response = await fetch(url, options);
  const data = await response.json();
  console.log(data);
} catch (error) {
  console.error(error);
}
```

```go Surfaces endpoints_createSurface_example
package main

import (
	"fmt"
	"net/http"
	"io"
)

func main() {

	url := "https://api.moveworks.ai/configurations/v1alpha1/assistant/surfaces"

	req, _ := http.NewRequest("POST", url, nil)

	req.Header.Add("Authorization", "Bearer <token>")

	res, _ := http.DefaultClient.Do(req)

	defer res.Body.Close()
	body, _ := io.ReadAll(res.Body)

	fmt.Println(res)
	fmt.Println(string(body))

}
```

```ruby Surfaces endpoints_createSurface_example
require 'uri'
require 'net/http'

url = URI("https://api.moveworks.ai/configurations/v1alpha1/assistant/surfaces")

http = Net::HTTP.new(url.host, url.port)
http.use_ssl = true

request = Net::HTTP::Post.new(url)
request["Authorization"] = 'Bearer <token>'

response = http.request(request)
puts response.read_body
```

```java Surfaces endpoints_createSurface_example
import com.mashape.unirest.http.HttpResponse;
import com.mashape.unirest.http.Unirest;

HttpResponse<String> response = Unirest.post("https://api.moveworks.ai/configurations/v1alpha1/assistant/surfaces")
  .header("Authorization", "Bearer <token>")
  .asString();
```

```php Surfaces endpoints_createSurface_example
<?php
require_once('vendor/autoload.php');

$client = new \GuzzleHttp\Client();

$response = $client->request('POST', 'https://api.moveworks.ai/configurations/v1alpha1/assistant/surfaces', [
  'headers' => [
    'Authorization' => 'Bearer <token>',
  ],
]);

echo $response->getBody();
```

```csharp Surfaces endpoints_createSurface_example
using RestSharp;

var client = new RestClient("https://api.moveworks.ai/configurations/v1alpha1/assistant/surfaces");
var request = new RestRequest(Method.POST);
request.AddHeader("Authorization", "Bearer <token>");
IRestResponse response = client.Execute(request);
```

```swift Surfaces endpoints_createSurface_example
import Foundation

let headers = ["Authorization": "Bearer <token>"]

let request = NSMutableURLRequest(url: NSURL(string: "https://api.moveworks.ai/configurations/v1alpha1/assistant/surfaces")! as URL,
                                        cachePolicy: .useProtocolCachePolicy,
                                    timeoutInterval: 10.0)
request.httpMethod = "POST"
request.allHTTPHeaderFields = headers

let session = URLSession.shared
let dataTask = session.dataTask(with: request as URLRequest, completionHandler: { (data, response, error) -> Void in
  if (error != nil) {
    print(error as Any)
  } else {
    let httpResponse = response as? HTTPURLResponse
    print(httpResponse)
  }
})

dataTask.resume()
```

### Create a surface

**Request**

```json
{
  "channel": "slack",
  "version": {
    "change_description": "Create surface"
  },
  "assistant_id": "<id>",
  "name": "example-name",
  "slack_config": {
    "app_id": "A0123456789",
    "user_id": "U0123456789",
    "team_id": "T0123456789",
    "assistant_id": "B0123456789",
    "chat_system_url": "https://example.com/path",
    "instance_name": "acme"
  }
}
```

**Response**

```json
{
  "id": "3f6c1e2a-8b4d-4c7e-9a1f-2d5b6c7e8f90",
  "assistant_id": "<id>",
  "name": "example-name",
  "slack_config": {
    "app_id": "A0123456789",
    "user_id": "U0123456789",
    "team_id": "T0123456789",
    "assistant_id": "B0123456789",
    "chat_system_url": "https://example.com/path",
    "instance_name": "acme"
  },
  "updated_time": "2026-11-12T18:04:11Z",
  "updated_by": "admin@example.com",
  "version": {
    "num": 1,
    "change_description": "Create surface"
  }
}
```

**SDK Code**

```python Create a surface
import requests

url = "https://api.moveworks.ai/configurations/v1alpha1/assistant/surfaces"

payload = {
    "channel": "slack",
    "version": { "change_description": "Create surface" },
    "assistant_id": "<id>",
    "name": "example-name",
    "slack_config": {
        "app_id": "A0123456789",
        "user_id": "U0123456789",
        "team_id": "T0123456789",
        "assistant_id": "B0123456789",
        "chat_system_url": "https://example.com/path",
        "instance_name": "acme"
    }
}
headers = {
    "Authorization": "Bearer <token>",
    "Content-Type": "application/json"
}

response = requests.post(url, json=payload, headers=headers)

print(response.json())
```

```javascript Create a surface
const url = 'https://api.moveworks.ai/configurations/v1alpha1/assistant/surfaces';
const options = {
  method: 'POST',
  headers: {Authorization: 'Bearer <token>', 'Content-Type': 'application/json'},
  body: '{"channel":"slack","version":{"change_description":"Create surface"},"assistant_id":"<id>","name":"example-name","slack_config":{"app_id":"A0123456789","user_id":"U0123456789","team_id":"T0123456789","assistant_id":"B0123456789","chat_system_url":"https://example.com/path","instance_name":"acme"}}'
};

try {
  const response = await fetch(url, options);
  const data = await response.json();
  console.log(data);
} catch (error) {
  console.error(error);
}
```

```go Create a surface
package main

import (
	"fmt"
	"strings"
	"net/http"
	"io"
)

func main() {

	url := "https://api.moveworks.ai/configurations/v1alpha1/assistant/surfaces"

	payload := strings.NewReader("{\n  \"channel\": \"slack\",\n  \"version\": {\n    \"change_description\": \"Create surface\"\n  },\n  \"assistant_id\": \"<id>\",\n  \"name\": \"example-name\",\n  \"slack_config\": {\n    \"app_id\": \"A0123456789\",\n    \"user_id\": \"U0123456789\",\n    \"team_id\": \"T0123456789\",\n    \"assistant_id\": \"B0123456789\",\n    \"chat_system_url\": \"https://example.com/path\",\n    \"instance_name\": \"acme\"\n  }\n}")

	req, _ := http.NewRequest("POST", url, payload)

	req.Header.Add("Authorization", "Bearer <token>")
	req.Header.Add("Content-Type", "application/json")

	res, _ := http.DefaultClient.Do(req)

	defer res.Body.Close()
	body, _ := io.ReadAll(res.Body)

	fmt.Println(res)
	fmt.Println(string(body))

}
```

```ruby Create a surface
require 'uri'
require 'net/http'

url = URI("https://api.moveworks.ai/configurations/v1alpha1/assistant/surfaces")

http = Net::HTTP.new(url.host, url.port)
http.use_ssl = true

request = Net::HTTP::Post.new(url)
request["Authorization"] = 'Bearer <token>'
request["Content-Type"] = 'application/json'
request.body = "{\n  \"channel\": \"slack\",\n  \"version\": {\n    \"change_description\": \"Create surface\"\n  },\n  \"assistant_id\": \"<id>\",\n  \"name\": \"example-name\",\n  \"slack_config\": {\n    \"app_id\": \"A0123456789\",\n    \"user_id\": \"U0123456789\",\n    \"team_id\": \"T0123456789\",\n    \"assistant_id\": \"B0123456789\",\n    \"chat_system_url\": \"https://example.com/path\",\n    \"instance_name\": \"acme\"\n  }\n}"

response = http.request(request)
puts response.read_body
```

```java Create a surface
import com.mashape.unirest.http.HttpResponse;
import com.mashape.unirest.http.Unirest;

HttpResponse<String> response = Unirest.post("https://api.moveworks.ai/configurations/v1alpha1/assistant/surfaces")
  .header("Authorization", "Bearer <token>")
  .header("Content-Type", "application/json")
  .body("{\n  \"channel\": \"slack\",\n  \"version\": {\n    \"change_description\": \"Create surface\"\n  },\n  \"assistant_id\": \"<id>\",\n  \"name\": \"example-name\",\n  \"slack_config\": {\n    \"app_id\": \"A0123456789\",\n    \"user_id\": \"U0123456789\",\n    \"team_id\": \"T0123456789\",\n    \"assistant_id\": \"B0123456789\",\n    \"chat_system_url\": \"https://example.com/path\",\n    \"instance_name\": \"acme\"\n  }\n}")
  .asString();
```

```php Create a surface
<?php
require_once('vendor/autoload.php');

$client = new \GuzzleHttp\Client();

$response = $client->request('POST', 'https://api.moveworks.ai/configurations/v1alpha1/assistant/surfaces', [
  'body' => '{
  "channel": "slack",
  "version": {
    "change_description": "Create surface"
  },
  "assistant_id": "<id>",
  "name": "example-name",
  "slack_config": {
    "app_id": "A0123456789",
    "user_id": "U0123456789",
    "team_id": "T0123456789",
    "assistant_id": "B0123456789",
    "chat_system_url": "https://example.com/path",
    "instance_name": "acme"
  }
}',
  'headers' => [
    'Authorization' => 'Bearer <token>',
    'Content-Type' => 'application/json',
  ],
]);

echo $response->getBody();
```

```csharp Create a surface
using RestSharp;

var client = new RestClient("https://api.moveworks.ai/configurations/v1alpha1/assistant/surfaces");
var request = new RestRequest(Method.POST);
request.AddHeader("Authorization", "Bearer <token>");
request.AddHeader("Content-Type", "application/json");
request.AddParameter("application/json", "{\n  \"channel\": \"slack\",\n  \"version\": {\n    \"change_description\": \"Create surface\"\n  },\n  \"assistant_id\": \"<id>\",\n  \"name\": \"example-name\",\n  \"slack_config\": {\n    \"app_id\": \"A0123456789\",\n    \"user_id\": \"U0123456789\",\n    \"team_id\": \"T0123456789\",\n    \"assistant_id\": \"B0123456789\",\n    \"chat_system_url\": \"https://example.com/path\",\n    \"instance_name\": \"acme\"\n  }\n}", ParameterType.RequestBody);
IRestResponse response = client.Execute(request);
```

```swift Create a surface
import Foundation

let headers = [
  "Authorization": "Bearer <token>",
  "Content-Type": "application/json"
]
let parameters = [
  "channel": "slack",
  "version": ["change_description": "Create surface"],
  "assistant_id": "<id>",
  "name": "example-name",
  "slack_config": [
    "app_id": "A0123456789",
    "user_id": "U0123456789",
    "team_id": "T0123456789",
    "assistant_id": "B0123456789",
    "chat_system_url": "https://example.com/path",
    "instance_name": "acme"
  ]
] as [String : Any]

let postData = JSONSerialization.data(withJSONObject: parameters, options: [])

let request = NSMutableURLRequest(url: NSURL(string: "https://api.moveworks.ai/configurations/v1alpha1/assistant/surfaces")! as URL,
                                        cachePolicy: .useProtocolCachePolicy,
                                    timeoutInterval: 10.0)
request.httpMethod = "POST"
request.allHTTPHeaderFields = headers
request.httpBody = postData as Data

let session = URLSession.shared
let dataTask = session.dataTask(with: request as URLRequest, completionHandler: { (data, response, error) -> Void in
  if (error != nil) {
    print(error as Any)
  } else {
    let httpResponse = response as? HTTPURLResponse
    print(httpResponse)
  }
})

dataTask.resume()
```