---
title: "Suggest source assets matching criteria"
method: POST
path: "/v1/integration/continuous/projects/{projectId}/pipelines/{pipelineId}/suggest/source"
tags: ["Build and Configure Continuous Integration Projects"]
---

# Suggest source assets matching criteria

`POST /v1/integration/continuous/projects/{projectId}/pipelines/{pipelineId}/suggest/source`

## Request

- Base URL: `https://integration-adapter.connect.cloud.precisely.com`
- URL: `https://integration-adapter.connect.cloud.precisely.com/v1/integration/continuous/projects/{projectId}/pipelines/{pipelineId}/suggest/source`
- Auth: HTTP bearer

Suggests source assets (DATABASE, SCHEMA, TABLE, TOPIC, KAFKA_SCHEMA) matching the provided search patterns for a pipeline.

**Process Overview:**
1. **Input Validation** - Validates input parameters and permissions.
2. **Asset Discovery** - Matches cataloged assets using provided regex patterns.
3. **Detailed Response** - Returns full asset path details for the matching source resources.

**Supported Asset Types:**
- `DATABASE` - RDBMS database assets
- `SCHEMA` - RDBMS schema assets
- `TABLE` - RDBMS table assets
- `TOPIC` - Kafka topic assets
- `KAFKA_SCHEMA` - Schema Registry subject assets

**Use Cases:**
- Source asset selection and validation during pipeline setup.
- Interactive workflows for asset discovery and filtering.

**Required Permissions:** Either `replication-pipeline::create` or `replication-pipeline::update` when permission harmonization is enabled; otherwise, `replication-pipeline::manage`.

## Path parameters

- `projectId` string, required
- `pipelineId` string, required

## Query parameters

- `type` 'DATABASE' | 'SCHEMA' | 'TABLE' | 'TOPIC' | 'KAFKA_SCHEMA', required

## Request body

- AssetMatchCriteria: Request model for asset matching at any hierarchy level.
  - `database` string: Optional: Database name for schema/table matching.
  - `schema` string: Optional: Schema name for table matching.
  - `patterns` string[], required: List of regex patterns for matching assets.

## Response `200`

List of matching assets along with context and fully qualified hierarchy

- SuggestedAssetResponse: Full path details for a matched catalog asset. Fields are populated based on asset type.
  - `database` string: Database name (for RDBMS assets)
  - `schema` string: Schema name (for RDBMS assets)
  - `table` string: Table name (for RDBMS assets)
  - `journal` string: Journal name (for DB2I/DB2LUW RDBMS assets)
  - `topic` string: Kafka topic name (for Kafka assets)
  - `subject` string: Schema Registry subject (for Schema Registry assets)

## Other responses

- `400`: Bad request. Invalid criteria or missing parameters.
- `401`: Unauthorized - Authentication required, valid credentials not provided
- `403`: Forbidden. Insufficient permissions.
- `404`: No source assets exist matching criteria.
- `422`: Unprocessable entity. Criteria not supported.
- `500`: Internal server error - failed retrieving matching source assets

---

[API](https://skmtc.dev/precisely/apis/precisely-integration-adapter-service.md) · [All operations](https://skmtc.dev/precisely/apis/precisely-integration-adapter-service/llms.txt) · [OpenAPI document](https://skmtc.dev/precisely/apis/precisely-integration-adapter-service/revisions/2d2629f4987d?raw)