API Tokens7

Audit Logs2

Code Fixing1

Custom Hosts1

Custom Tags8

Developer1

GitHub Check Runs2

Health Checks3

Honeytoken Activity Logs1

Honeytoken Notes4

Honeytoken Sources1

Honeytokens11

Honeytokens Events1

Internal Secret Incident Activity Logs1

Internal Secret Incident Notes4

Internal Secret Incidents26

Internal Secret Locations2

Internal Secret Occurrences2

Invitations9

IP Allowlist5

IPs1

Members12

NHI Identities7

NHI Identity Owners4

NHI Policies3

NHI Sources1

OAuth25

Public Secret Incident Activity Logs1

Public Secret Incident Notes4

Public Secret Incidents13

Public Secret Occurrences3

Quota1

Scan Methods3

SCIM Groups6

SCIM Metadata5

SCIM Users6

Secret Detectors2

Secrets5

Severity Rules1

Sources11

Status1

Team Invitations4

Team Memberships4

Team Requests5

Team Sources2

Teams9

Sources

Update a source

Changed on Oct 22, 2026

Update some source attributes such as monitored status and source criticality.

The monitored status can be updated for all source types except Custom Sources.

⚠️ Note: some sources types are supported on this endpoint, but cannot be updated yet on the dashboard.

Business sources can't be updated if your account doesn't have access to them.

patch/v1/sources/{source_id}

Request

Base URL
https://api.gitguardian.com
URL
https://api.gitguardian.com/v1/sources/{source_id}
Auth
HTTP bearer

Path parameters

source_idinteger required

Example:5523

The id of the source to retrieve.

Request body

idinteger

urlstring uri

typestring

full_namestring

full_pathstring nullable

Path of the repository on its VCS provider (GitHub, GitHub Enterprise, GitLab, Bitbucket, Bitbucket Cloud, Azure DevOps, Gerrit). It can differ from full_name, e.g. on GitLab. null for other source types.

health'safe' | 'unknown' | 'at_risk'

default_branchstring nullable

Default branch of the source repository.

default_branch_headstring nullable

Reference of the HEAD of the default branch.

open_incidents_countinteger

Number of open secret incidents with at least one occurrence on this source.

closed_incidents_countinteger

Number of closed secret incidents with at least one occurrence on this source.

visibilitystring

external_idstring

VCS identifier of the source (e.g.: the GitHub id for a GitHub repository). Warning: external_id is a string because some VCS ids can be UUIDs.

source_criticalitystring

Criticality of the source.

monitoredboolean

Deprecated: use monitoring_status to read a source's real-time monitoring state (monitoring_status distinguishes disabled, archived, unreachable and deleted-on-remote sources, which this boolean cannot). Whether the source is currently monitored by GitGuardian.

monitoring_status'active' | 'disabled' | 'unreachable' | 'archived' | 'deleted_on_remote'

Real-time monitoring status of the source. Note: the unreachable and disabled buckets are not fully backed yet and may report active until the supporting backend lands.

deletedboolean

Whether the source has been deleted

Example request

{
  "id": 6531,
  "url": "https://github.com/GitGuardian/gg-shield",
  "type": "github",
  "full_name": "gitguardian/gg-shield",
  "full_path": "GitGuardian/ggshield",
  "health": "at_risk",
  "default_branch": "main",
  "default_branch_head": "abcd97b4aaf927ea934504263322e75e86c31xyz",
  "open_incidents_count": 3,
  "closed_incidents_count": 2,
  "visibility": "public",
  "external_id": "125",
  "source_criticality": "critical",
  "last_scan": {
    "date": "2021-05-20T12:40:55.662949Z",
    "status": "finished",
    "failing_reason": "DMCA takedown",
    "commits_scanned": 123,
    "branches_scanned": 2,
    "duration": "1:30.454444"
  },
  "monitored": true,
  "monitoring_status": "active",
  "deleted": true
}

Response

The source was updated successfully