---
title: "Link or Unlink Generated Schema"
method: PATCH
path: "/targets/{target_id}/generated-schemas/{id}/"
tags: ["Schema Generation"]
---

# Link or Unlink Generated Schema

`PATCH /targets/{target_id}/generated-schemas/{id}/`

## Request

- Base URL: `https://api.probely.com`
- URL: `https://api.probely.com/targets/{target_id}/generated-schemas/{id}/`
- Auth: API key in header `Authorization`

Link a generated schema to the target for DAST scanning (`is_linked: true`) or unlink it (`is_linked: false`). Linking atomically unlinks any sibling and materializes the schema file; unlinking clears the target's linked-schema configuration. Idempotent.

## Path parameters

- `id` string, required
- `target_id` string, required

## Request body

- PatchedLinkGeneratedSchemaRequest
  - `is_linked` boolean

## Response `200`

- GeneratedSchema
  - `schema_id` string, required
  - `name` string, required
  - `format` 'openapi' | 'graphql', required: * `openapi` - OpenAPI * `graphql` - GraphQL
  - `version` string, required
  - `description` string, required
  - `endpoints_count` integer, required
  - `confidence_score` string, decimal, nullable, required
  - `base_url` string, nullable, required
  - `snyk_project_id` string, required
  - `snyk_project_name` string, nullable, required
  - `branch` string, required
  - `source` 'in_repo' | 'llm', required: * `in_repo` - Found in Repository * `llm` - LLM Generated
  - `warnings` unknown, required
  - `is_linked` boolean, required
  - `created_at` string, date-time, required

## Other responses

- `400`
- `401`
- `403`
- `404`
- `500`

## Changes

- **2026-11-03** `0b2f6cbe644d`: 1 info
  - endpoint added

[Operation history](https://skmtc.dev/probely/apis/snyk-api-web-s-api-reference-documentation/changes/targets/:target_id/generated-schemas/:id/patch.md)

---

[API](https://skmtc.dev/probely/apis/snyk-api-web-s-api-reference-documentation.md) - [All operations](https://skmtc.dev/probely/apis/snyk-api-web-s-api-reference-documentation/llms.txt) - [OpenAPI document](https://skmtc.dev/probely/apis/snyk-api-web-s-api-reference-documentation/revisions/0b2f6cbe644d?raw)