Change a Listed Path
Change a listed path's pattern, methods or signature check. A field you leave out keeps its value. The path keeps the list's mode: to switch it, use PUT .../access-paths/mode.
Path parameters
uuid string (uuid) Req
The endpoint's
uuid from /endpoints.path_uuid string (uuid) Req
The path's
uuid from the list.Request body
path string
The new pattern, with the rules of add.
methods string[]
Replaces the methods: any of
GET, HEAD, POST, PUT, PATCH, DELETE, OPTIONS, or ["*"] for every method. An empty list is refused.signature object | null
The signature check, with the fields of add, or
null to remove it. A secret of "****" keeps the saved secret, on a path that already has a check from the same provider. Setting or changing a check needs Verify Webhook in your plan; keeping or removing one doesn't.What the path becomes is checked whole: in the open mode, a path without a signature check that lists POST needs ["*"], whether this change adds POST or removes the check.
Response (200 OK)
The path as it is now, as an entry of the list.
Errors
400 Bad Request
A field the API doesn't know (
invalid json payload), or a field it refuses, named in fields, with what to send instead; "****" on a path without a check from that provider; POST without a check and without every method.401 Unauthorized
Missing auth.
403 Forbidden
Your role lacks
endpoints:update, or a new or changed check without Verify Webhook in your plan ("code": "entitlement_required").404 Not Found
No such endpoint in your active account, or
path not found on it.409 Conflict
The new pattern is listed already; a signature check on a
protect list; or the endpoint is paused over your plan's quota ("code": "quota_paused").Request — a new signing secret
curl -X PATCH "https://api.ngris.com/v1/endpoints/019bb1e4-e785-77d2-9966-c3cff31d0a0e/access-paths/019c1a20-5b7e-7c41-9a3e-2f6d8b0c4e11" \
-H "X-API-KEY: <your_api_key>" \
-H "Content-Type: application/json" \
-d '{"signature": {"provider": "github", "secret": "<the new webhook secret>"}}'
CLI — open GET and HEAD only
ngris api endpoint-access-paths update 019bb1e4-e785-77d2-9966-c3cff31d0a0e 019c1a20-6c1d-7f02-8b47-91e3a5d2c7f8 \
--methods GET --methods HEAD --yes
Response — 200 OK
{
"uuid": "019c1a20-5b7e-7c41-9a3e-2f6d8b0c4e11",
"path": "/webhooks/github",
"methods": ["POST"],
"signature": {
"provider": "github",
"secret": "****",
"signature_header": "",
"algorithm": "",
"signature_prefix": "",
"locked": false
},
"created_at": "2026-11-12T09:00:00Z",
"updated_at": "2026-11-12T10:30:00Z"
}
Was this helpful?