Update a custom pattern
Change a custom pattern, publish it, or turn it back into a draft (publish false).
PATCH
/repos/{owner}/{name}/secret-scanning/custom-patterns/{id}Returns where it matched each test string.
- Authentication: Required. Send an access token as
Authorization: Bearer. - MCP tool:
securitywithactionupdate_pattern, and the same inputs - Scope: An access token needs
security:write. - Also at:
PATCH /workspaces/{workspace}/secret-scanning/custom-patterns/{id}
Path parameters
Section titled “Path parameters”| Name | Type | Required | Description |
|---|---|---|---|
owner |
string | Yes | The workspace that owns the repository. |
name |
string | Yes | The repository’s name. |
id |
string | Yes | The pattern’s id: pat_… |
Body parameters
Section titled “Body parameters”Send a JSON object. Names are snake_case, as in responses; the camelCase spelling is accepted too.
| Name | Type | Required | Description |
|---|---|---|---|
test_strings |
array of strings | No | Up to 20 strings to show the pattern working on. |
publish |
boolean | No | Published (true) or a draft (false). |
pattern_name |
string | Yes | What people call it: “Acme API key”. |
pattern |
string | Yes | The secret’s format, as a regular expression (the regex crate’s syntax: no look-around or back-references). At most 1,000 characters; it may not match an empty string. |
before |
string | No | What must come right before the secret, as a regular expression. Default: the start of the line or a character that is not a letter or digit. |
after |
string | No | What must come right after it. Default: the end of the line or a character that is not a letter or digit. |
workspace |
string | No | Instead of repo: the workspace’s slug, for all of it (or its own, for patterns). |
Example request
Section titled “Example request”curl -X PATCH https://api.g1t.sh/repos/flagon-io/hello/secret-scanning/custom-patterns/pat_01kq2p9f6g7h8j9k0m1n2p3q4r \ -H "Authorization: Bearer $G1T_TOKEN" \ -H "Content-Type: application/json" \ -d '{ "pattern_name": "Acme API key", "pattern": "acme_[a-z0-9]{32,40}", "publish": true }'Example response
Section titled “Example response”A successful request answers 200 with:
{ "pattern": { "id": "pat_01kq2p9f6g7h8j9k0m1n2p3q4r", "scope": "repository", "workspace": "flagon-io", "repo": "hello", "name": "Acme API key", "pattern": "acme_[a-z0-9]{32,40}", "before": null, "after": null, "test_strings": [ "ACME_KEY=acme_0123456789abcdef0123456789abcdef" ], "state": "published", "created_by": "syntaqx", "created_at": "2026-10-06T09:14:02.118Z", "updated_by": "syntaqx", "updated_at": "2026-10-06T09:14:02.118Z", "open_alerts": 0 }, "tests": [ [ 9, 46 ] ]}Errors
Section titled “Errors”A failed request answers with one of these statuses and a body like {"error": {"code": "not_found", "message": "Repository not found."}}. See errors.
| Status | Code | When |
|---|---|---|
| 401 | unauthenticated |
A token is required, or the one sent is not valid. |
| 403 | forbidden |
The token is valid but not allowed to do this, such as a member-only change or an agent token outside its repository. |
| 404 | not_found |
It does not exist, or you cannot see it. |
| 409 | conflict |
The request conflicts with the current state. |
| 422 | invalid |
The input is not valid. message says which field and why. |