
= Syslog Northbounder Interface Configuration

== GETs (reading data)

[caption=]
.Syslog Northbounder Interface Configuration API GET functions
[options="autowidth"]
|===
| Resource  | Description

| /config/syslog-nbi
| Gets full content of the configuration.

| /config/syslog-nbi/status
| Gets the status of the Syslog NBI (returns either `true` or `false`).

| /config/syslog-nbi/destinations
| Gets the name of all the existing destinations.

| /config/syslog-nbi/destinations/\{name}
| Gets the content of the destination named `\{name}`.
|===

== PUT (update defaults)

On a successful request, the Syslog NBI will be notified about the configuration change.

[caption=]
.Syslog Northbounder Interface Configuration API PUT function
[options="autowidth"]
|===
| Resource  | Description

| /config/syslog-nbi/status?enabled=(true;false)
| Sets the status of the Syslog NBI.
|===

== POSTs (adding data)

POST requires form data using `application/x-www-form-urlencoded` as a `Content-Type`.

On a successful request, the Syslog NBI will be notified about the configuration change.

[caption=]
.Syslog Northbounder Interface Configuration API POST functions
[options="autowidth"]
|===
| Resource  | Description

| /config/syslog-nbi
| Updates the full content of the configuration.

| /config/syslog-nbi/destinations
| Adds a new or overrides an existing destination.
|===

== PUT (modifying data)

PUT requires form data using `application/x-www-form-urlencoded` as a `Content-Type`.

On a successful request, the Syslog NBI will be notified about the configuration change.

[caption=]
.Syslog Northbounder Interface Configuration API PUT function
[options="autowidth"]
|===
| Resource  | Description

| /config/syslog-nbi/destinations/\{name}
| Updates the content of the destination named `\{name}`.
|===

== DELETE (remove data)

On a successful request, the Syslog NBI will be notified about the configuration change.

[caption=]
.Syslog Northbounder Interface Configuration API DELETE function
[options="autowidth"]
|===
| Resource  | Description

| /config/syslog-nbi/destinations/\{name}
| Updates the content of the destination named `\{name}`.
|===
