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

# Messaging Services

> Create and manage messaging service connections

# Messaging Services

A **Messaging Service** represents a connection to a messaging platform (e.g., Kafka, Redpanda, Kinesis). It is the root of the messaging hierarchy and contains Topics.

<Info>
  Entity schema follows the [OpenMetadata Standard](https://openmetadatastandards.org/data-assets/messaging/messaging-service/).
</Info>

## Entity Hierarchy

Messaging Services are at the top of the hierarchy:

<CodeGroup>
  ```txt Messaging Service theme={null}
  MessagingService (this page)
  └── Topic
  ```
</CodeGroup>

***

## API Endpoints

| Method   | Endpoint                                                   | Description                                                                                |
| -------- | ---------------------------------------------------------- | ------------------------------------------------------------------------------------------ |
| `PUT`    | `/v1/services/messagingServices`                           | [Create or update](/v1.12.x/api-reference/data-assets/messaging-services/create)           |
| `POST`   | `/v1/services/messagingServices`                           | [Create (POST variant)](/v1.12.x/api-reference/data-assets/messaging-services/create)      |
| `GET`    | `/v1/services/messagingServices`                           | [List services](/v1.12.x/api-reference/data-assets/messaging-services/list)                |
| `GET`    | `/v1/services/messagingServices/{id}`                      | [Get by ID](/v1.12.x/api-reference/data-assets/messaging-services/retrieve)                |
| `GET`    | `/v1/services/messagingServices/name/{fqn}`                | [Get by name](/v1.12.x/api-reference/data-assets/messaging-services/retrieve)              |
| `PATCH`  | `/v1/services/messagingServices/{id}`                      | [Update by ID](/v1.12.x/api-reference/data-assets/messaging-services/update)               |
| `PATCH`  | `/v1/services/messagingServices/name/{fqn}`                | [Update by name](/v1.12.x/api-reference/data-assets/messaging-services/update)             |
| `DELETE` | `/v1/services/messagingServices/{id}`                      | [Delete by ID](/v1.12.x/api-reference/data-assets/messaging-services/delete)               |
| `DELETE` | `/v1/services/messagingServices/name/{fqn}`                | [Delete by name](/v1.12.x/api-reference/data-assets/messaging-services/delete)             |
| `PUT`    | `/v1/services/messagingServices/restore`                   | [Restore](/v1.12.x/api-reference/data-assets/messaging-services/delete)                    |
| `GET`    | `/v1/services/messagingServices/{id}/versions`             | [List versions](/v1.12.x/api-reference/data-assets/messaging-services/versions)            |
| `GET`    | `/v1/services/messagingServices/{id}/versions/{version}`   | [Get version](/v1.12.x/api-reference/data-assets/messaging-services/versions)              |
| `GET`    | `/v1/services/messagingServices/name/{fqn}/export`         | [Export CSV](/v1.12.x/api-reference/data-assets/messaging-services/import-export)          |
| `PUT`    | `/v1/services/messagingServices/name/{fqn}/import`         | [Import CSV](/v1.12.x/api-reference/data-assets/messaging-services/import-export)          |
| `GET`    | `/v1/services/messagingServices/name/{fqn}/exportAsync`    | [Export CSV async](/v1.12.x/api-reference/data-assets/messaging-services/import-export)    |
| `PUT`    | `/v1/services/messagingServices/name/{fqn}/importAsync`    | [Import CSV async](/v1.12.x/api-reference/data-assets/messaging-services/import-export)    |
| `POST`   | `/v1/services/messagingServices/{id}/testConnectionResult` | [Add test connection result](/v1.12.x/api-reference/data-assets/messaging-services/create) |