---
title: "POST /v1/discoverers"
method: POST
path: "/v1/discoverers"
---

# POST /v1/discoverers

`POST /v1/discoverers`

Creates a discoverer.

## Request body

- object
  - `Description` string — A description for the discoverer.
  - `SourceArn` string, required — The ARN of the event bus.
  - `CrossAccount` boolean — Support discovery of schemas in events sent to the bus from another account. (default: true).
  - `tags` object — Key-value pairs associated with a resource.

## Response `201`

Success

- CreateDiscovererResponse
  - `Description` string — The description of the discoverer.
  - `DiscovererArn` string — The ARN of the discoverer.
  - `DiscovererId` string — The ID of the discoverer.
  - `SourceArn` string — The ARN of the event bus.
  - `State` 'STARTED' | 'STOPPED' — The state of the discoverer.
  - `CrossAccount` boolean — The Status if the discoverer will discover schemas from events sent from another account.
  - `Tags` object — Tags associated with the resource.

## Other responses

- `480` — BadRequestException
- `481` — InternalServerErrorException
- `482` — UnauthorizedException
- `483` — ForbiddenException
- `484` — ServiceUnavailableException
- `485` — ConflictException

---

[API](https://skmtc.net/aws/apis/schemas.md) · [All operations](https://skmtc.net/aws/apis/schemas/llms.txt) · [OpenAPI document](https://skmtc-service-staging.skmtc.workers.dev/v1/apis/aws/schemas/versions/90794fa9ec05/schema)