Skip to content
Updawg

`PATCH /v1/orgs/{org}/notification-rules/{rule_id}`.

PATCH
/v1/orgs/{org}/notification-rules/{rule_id}
curl --request PATCH \
  --url https://api.updawg.net/v1/orgs/example/notification-rules/example \
  --header 'Content-Type: application/json' \
  --data '{ "channel_ids": [ "example" ], "enabled": true, "event_types": [ "example" ], "filter": { "known_exploited": true, "min_severity": "none", "proposal_kinds": [ "example" ] }, "name": "example" }'

Parameters

Section titled “Parameters”

Path Parameters

Section titled “Path Parameters”
org
required
string

Organization slug.

rule_id
required
string

The nru_… id.

Request Bodyrequired

Section titled “Request Bodyrequired”
Media typeapplication/json
object
channel_ids
Array<string> | null
enabled
boolean | null
event_types
Array<string> | null
filter
One of:

What a rule narrows its events by. Every field optional; all given must hold. The proposal fields do not narrow host events.

object
known_exploited

Only proposals that fix something known to be exploited (true), or only those that do not (false).

boolean | null
min_severity
One of:

At least this severe.

string
Allowed values: none low medium high critical
proposal_kinds

Only these kinds of proposal: security, bugfix, …

Array<string> | null
name
string | null

Responses

Section titled “Responses”

200

Section titled “200”

Changed. channel_ids, when given, replaces the list.

Media typeapplication/json
object
channel_ids
required

nch_… ids.

Array<string>
created_at
required
string format: date-time
enabled
required
boolean
event_types
required
Array<string>
filter
required

What a rule narrows its events by. Every field optional; all given must hold. The proposal fields do not narrow host events.

object
known_exploited

Only proposals that fix something known to be exploited (true), or only those that do not (false).

boolean | null
min_severity
One of:

At least this severe.

string
Allowed values: none low medium high critical
proposal_kinds

Only these kinds of proposal: security, bugfix, …

Array<string> | null
id
required

nru_….

string
name
required
string
updated_at
required
string format: date-time
Example
{
  "filter": {
    "min_severity": "none"
  }
}

400

Section titled “400”

As for creating one.

Media typeapplication/json
object
detail
string | null
status
required
integer format: int32
title
required
string
type
required
string
Examplegenerated
{
  "detail": "example",
  "status": 1,
  "title": "example",
  "type": "example"
}

401

Section titled “401”

No session.

Media typeapplication/json
object
detail
string | null
status
required
integer format: int32
title
required
string
type
required
string
Examplegenerated
{
  "detail": "example",
  "status": 1,
  "title": "example",
  "type": "example"
}

403

Section titled “403”

Not permitted for this role.

Media typeapplication/json
object
detail
string | null
status
required
integer format: int32
title
required
string
type
required
string
Examplegenerated
{
  "detail": "example",
  "status": 1,
  "title": "example",
  "type": "example"
}

404

Section titled “404”

No such rule here.

Media typeapplication/json
object
detail
string | null
status
required
integer format: int32
title
required
string
type
required
string
Examplegenerated
{
  "detail": "example",
  "status": 1,
  "title": "example",
  "type": "example"
}

409

Section titled “409”

A rule with that name exists.

Media typeapplication/json
object
detail
string | null
status
required
integer format: int32
title
required
string
type
required
string
Examplegenerated
{
  "detail": "example",
  "status": 1,
  "title": "example",
  "type": "example"
}

429

Section titled “429”

Over the organization’s request limit. Retry-After says when to try again; RateLimit-Limit is the burst.

Media typeapplication/json
object
detail
string | null
status
required
integer format: int32
title
required
string
type
required
string
Examplegenerated
{
  "detail": "example",
  "status": 1,
  "title": "example",
  "type": "example"
}