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

# Register a Discovery Source

> Requires the GV.APIOwner application role, or a higher role (Owner > Contributor > Reader).

API · Discovery

POST `/api/v1/discovery-sources`

Requires the GV.APIOwner application role, or a higher role (Owner > Contributor > Reader).

Operation ID · create\_discovery\_source

## Request example

```bash theme={null}
curl --request POST \
  --url 'https://api.generalvalidation.com/api/v1/discovery-sources' \
  --header 'Accept: application/json' \
  --header 'Authorization: Bearer <access-token>' \
  --header 'Idempotency-Key: <unique-idempotency-key>' \
  --header 'Content-Type: application/json' \
  --data '{
  "factoryName": "example-data-factory",
  "kind": "adfFactory",
  "name": "Example ADF source",
  "resourceGroup": "example-resource-group",
  "subscriptionId": "11111111-1111-4111-8111-111111111111"
}'
```

## Authentication and access

* **Required role:** GV.APIOwner
* **Data classification:** metadata
* **Side effects:** configurationWrite

Use an authentication scheme declared below. Ordinary workloads use application tokens; signed-in users use delegated tokens and Organization membership. Activation and invitation acceptance require a person, and execution callbacks require their registered identity.

* Microsoft Entra delegated user token
* Microsoft Entra application token

## Parameters

### Idempotency-Key

header Required

Required caller-chosen retry identity. Use 1-128 visible ASCII characters and reuse it only for an exact retry of this request.

`string`

minimum length: 1 · maximum length: 128

## Request body

Required

### application/json

`AdfDiscoverySourceCreate | FabricDiscoverySourceCreate`

Any of

**Option 1: AdfDiscoverySourceCreate**

**Schema AdfDiscoverySourceCreate**

`object`

Properties

`factoryName`— Required

`string`

minimum length: 3 · maximum length: 63

`kind`— Required

`string`

* **Constant:** `"adfFactory"`

`name`— Required

`string`

minimum length: 1 · maximum length: 255

`resourceGroup`— Required

`string`

minimum length: 1 · maximum length: 90

`subscriptionId`— Required

`string (uuid)`

Additional properties are not allowed.

Schema example

```
{
  "factoryName": "example-data-factory",
  "kind": "adfFactory",
  "name": "Example ADF source",
  "resourceGroup": "example-resource-group",
  "subscriptionId": "11111111-1111-4111-8111-111111111111"
}
```

**Option 2: FabricDiscoverySourceCreate**

**Schema FabricDiscoverySourceCreate**

`object`

Properties

`kind`— Required

`string`

* **Constant:** `"fabricWorkspace"`

`name`— Required

`string`

minimum length: 1 · maximum length: 255

`workspaceId`— Required

`string (uuid)`

Additional properties are not allowed.

Schema example

```
{
  "kind": "fabricWorkspace",
  "name": "Example Fabric source",
  "workspaceId": "22222222-2222-4222-8222-222222222222"
}
```

Examples

Register an Azure Data Factory · adfFactory

```
{
  "factoryName": "example-data-factory",
  "kind": "adfFactory",
  "name": "Example ADF source",
  "resourceGroup": "example-resource-group",
  "subscriptionId": "11111111-1111-4111-8111-111111111111"
}
```

Register a Microsoft Fabric workspace · fabricWorkspace

```
{
  "kind": "fabricWorkspace",
  "name": "Example Fabric source",
  "workspaceId": "22222222-2222-4222-8222-222222222222"
}
```

## Responses

This guide summarizes response status codes and headers. Retrieve the deployed, authenticated OpenAPI document for the exact response body schemas and examples. The API also provides an authenticated Swagger UI; opening it in a browser does not automatically attach a bearer token.

Error responses use `application/problem+json`. The response's stable `code` and `type` map to the [error-code reference](/errors).

### 201

Discovery Source registered.

#### Headers

* **ETag:** `string`
* **Idempotency-Replayed:** `boolean`
* **Location:** `string`

### 401

A valid Microsoft Entra bearer token is required.

### 403

The authenticated principal does not have the required role.

### 404

The resource does not exist in this tenant.

### 409

The operation conflicts with current resource or Azure state.

### 422

The request is syntactically valid but semantically invalid.

### 429

The bounded application request rate was exceeded.

#### Headers

* **Retry-After:** Seconds to wait before retrying. `integer`minimum: 1

### 503

A required dependency is temporarily unavailable.

#### Headers

* **Retry-After:** Seconds to wait before retrying. `integer`minimum: 1