---
title: "PUT /v1/orgs/{orgId}/integrations/{integrationId}/scan-policy"
method: PUT
path: "/v1/orgs/{orgId}/integrations/{integrationId}/scan-policy"
tags: ["Orgs", "Integrations"]
---

# PUT /v1/orgs/{orgId}/integrations/{integrationId}/scan-policy

`PUT /v1/orgs/{orgId}/integrations/{integrationId}/scan-policy`

Replaces the integration's repo allow/deny scan policy. An `allow` policy with an empty `fullNames` is stored faithfully (scan nothing), not coerced to scan-everything. Duplicate names collapse to one. Returns 422 (not_scannable_integration) for non-scannable integration types.

## Path parameters

- `orgId` string, uuid, required
- `integrationId` string, uuid, required

## Headers

- `Authorization` string

## Request body

- object
  - `mode` union, required
    - 'allow'
    - 'deny'
  - `fullNames` string[], required

## Response `200`

Default Response

- object
  - `links` object, required
    - `self` string, uri, required
  - `data` object, required
    - `id` string, uuid, required
    - `type` 'integration-scan-policy', required
    - `attributes` object, required
      - `mode` union, required
        - 'allow'
        - 'deny'
      - `fullNames` string[], required
      - `excludedDataDeletion` union, required
        - 'complete'
        - 'in_progress'

## Other responses

- `401` — Unauthorized
- `403` — Forbidden
- `404` — Not Found
- `422` — Unprocessable Entity
- `500` — Internal Server Error

## Changes

- **2026-09-15** `d50a02b79ad3` — 2 info
  - added the optional property `error/code` to the response with the `403` status
  - added the optional property `error/url` to the response with the `403` status
- **2026-08-13** `9be5c2a862b7` — 1 info
  - endpoint added

[Change history](https://skmtc.dev/tessl/apis/tessl-api/changes/v1/orgs/:orgId/integrations/:integrationId/scan-policy/put.md)

---

[API](https://skmtc.dev/tessl/apis/tessl-api.md) · [All operations](https://skmtc.dev/tessl/apis/tessl-api/llms.txt) · [OpenAPI document](https://skmtc.dev/tessl/apis/tessl-api/revisions/9a8fc7f1fea0?raw)