> ## Documentation Index
> Fetch the complete documentation index at: https://www.text.com/docs/llms.txt
> Use this file to discover all available pages before exploring further.

# Using the Configuration API

> Manage the organization-wide accounts, settings, and rules used to handle customer conversations in Text.

The Configuration API controls resources and rules shared across a Text organization. It covers agent and bot accounts, groups and access rules, greetings, properties, tags, and webhook registrations.

## Before you start

For access requirements and version support, see:

<p>
  <Icon icon="file" /> [Authorization](/docs/authentication/overview)

  <br />

  <Icon icon="file" /> [Scopes](/docs/authentication/scopes)

  <br />

  <Icon icon="file" /> [API versioning](/docs/key-concepts/api-versioning)
</p>

### Propagation delay

Changes made through the Configuration API can take up to 2 minutes to take effect.

## Configuration resources

| Resource                                                                  | Description                                                                                                                                                                                                                                                                               |
| ------------------------------------------------------------------------- | ----------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- |
| [Agents](/docs/api/configuration/v3.6/agents/create-agent)                     | Use these methods to manage agent profiles: create or update agents, assign them to groups, and delete them.                                                                                                                                                                              |
| [Auto access](/docs/api/configuration/v3.6/auto-access/add-auto-access)        | Auto access rules assign groups to a thread based on the customer's geolocation and page URL. Text checks the rules when the customer logs in or changes pages. It applies the matching groups when the customer starts a chat and the thread is created.                                 |
| [Bots](/docs/api/configuration/v3.6/bots/create-bot-template)                  | Bots let integrations communicate in chats through the API in the same way as agents. Use these methods to manage bot templates and bot instances, issue bot tokens, and reset bot secrets.                                                                                               |
| [Customer bans](/docs/api/configuration/v3.6/customer-bans/list-customer-bans) | Use these methods to list active bans for a customer or lift a ban.                                                                                                                                                                                                                       |
| [Greetings](/docs/api/configuration/v3.6/greetings/create-greeting)            | Greetings are messages shown to customers when campaign conditions are met. Use these methods to create greetings and manage their content, display conditions, and target groups.                                                                                                        |
| [Groups](/docs/api/configuration/v3.6/groups/create-group)                     | Groups organize agents and bots into teams. They separate chat routing and provide shared configuration such as language, working hours, and department.                                                                                                                                  |
| [Properties](/docs/api/configuration/v3.6/properties/register-property)        | Properties are key-value fields grouped into namespaces. Each namespace belongs to the client that registered it and can be private or public. Use these methods to define property schemas and manage values stored on an organization or group.                                         |
| [Tags](/docs/api/configuration/v3.6/tags/create-tag)                           | Use the Tags resource to manage the labels available to agents for categorizing chat threads and filtering chats in archives and reports.                                                                                                                                                 |
| [Webhooks](/docs/api/configuration/v3.6/webhooks/register-webhook)             | Webhooks send event notifications to a registered URL when specific events occur. Use these methods to register, list, and remove webhooks, or to control their state for an organization.                                                                                                |
| [Other](/docs/api/configuration/v3.6/other/list-channels)                      | This group contains organization operations that do not belong to another resource. You can inspect communication channels and product limits, retrieve the source parameters passed when the Text product was activated, reactivate a bounced email address, and update company details. |

## Related APIs

| If you need to                                                                               | Use                                                        |
| -------------------------------------------------------------------------------------------- | ---------------------------------------------------------- |
| Work with conversations, including creating bans, applying tags, or updating chat properties | [Agent Chat API](/docs/api/agent-chat/)                         |
| Check supported webhook actions and payloads                                                 | [Webhooks reference](/docs/api/webhooks/v3.6/)                  |
| Store or query persistent customer profile data                                              | [Customer Data Platform API](/docs/api/customer-data-platform/) |

For a broader comparison, see [Management APIs](/docs/api-overview/management-apis).

## Batch requests

Batch methods run the same operation on multiple resources in one request. Items are processed concurrently, so execution order is not guaranteed. The `responses` array follows the order of the input, and a failed item does not affect the other items.

<Note>
  A batch request requires the same scopes as the corresponding non-batch
  method. You cannot mix methods in one batch request.
</Note>

Send a `POST` request to the batch method URL with a `requests` array. Each item uses the request payload of the corresponding non-batch method.

<Accordion title="Methods that support batch requests">
  **Agents**

  | Method                                                            | Batch URL                                                                      |
  | ----------------------------------------------------------------- | ------------------------------------------------------------------------------ |
  | [Create agent](/docs/api/configuration/v3.6/agents/create-agent)       | `https://api.livechatinc.com/v3.6/configuration/action/batch_create_agents`    |
  | [Update agent](/docs/api/configuration/v3.6/agents/update-agent)       | `https://api.livechatinc.com/v3.6/configuration/action/batch_update_agents`    |
  | [Delete agent](/docs/api/configuration/v3.6/agents/delete-agent)       | `https://api.livechatinc.com/v3.6/configuration/action/batch_delete_agents`    |
  | [Suspend agent](/docs/api/configuration/v3.6/agents/suspend-agent)     | `https://api.livechatinc.com/v3.6/configuration/action/batch_suspend_agents`   |
  | [Unsuspend agent](/docs/api/configuration/v3.6/agents/unsuspend-agent) | `https://api.livechatinc.com/v3.6/configuration/action/batch_unsuspend_agents` |
  | [Approve agent](/docs/api/configuration/v3.6/agents/approve-agent)     | `https://api.livechatinc.com/v3.6/configuration/action/batch_approve_agents`   |

  **Bots**

  | Method                                                | Batch URL                                                                 |
  | ----------------------------------------------------- | ------------------------------------------------------------------------- |
  | [Create bot](/docs/api/configuration/v3.6/bots/create-bot) | `https://api.livechatinc.com/v3.6/configuration/action/batch_create_bots` |
  | [Update bot](/docs/api/configuration/v3.6/bots/update-bot) | `https://api.livechatinc.com/v3.6/configuration/action/batch_update_bots` |
  | [Delete bot](/docs/api/configuration/v3.6/bots/delete-bot) | `https://api.livechatinc.com/v3.6/configuration/action/batch_delete_bots` |
</Accordion>

### Example: delete multiple agents

```shell title="Request" theme={null}
curl -X POST \
  https://api.livechatinc.com/v3.6/configuration/action/batch_delete_agents \
  -H 'Authorization: Basic <your_personal_access_token>' \
  -H 'Content-Type: application/json' \
  -d '{
        "requests": [
          { "id": "smith@example.com" },
          { "id": "brown@example.com" },
          {}
        ]
      }'
```

```json title="Response" theme={null}
{
  "responses": [
    {},
    {},
    {
      "error": {
        "type": "validation",
        "message": "`id` is required"
      }
    }
  ]
}
```