DigitalOcean API (unofficial showcase)
POST/v2/monitoring/sinks/destinations/{destination_uuid}

Update a logging destination

Updates the configuration of an existing logging destination. Identify it with destination_uuid and supply the required type and config fields, including the cluster endpoint; credentials are optional if you provide a managed cluster's cluster_uuid. A 204 response confirms the update and has no response body.

  • IdempotentThe SDK sends Idempotency-Key, so a retried request is only applied once.

1 parameter · 3 body fields
destination_uuidstringrequired
The unique identifier of the destination to update.

Logging destination configuration. Include the required type and config fields.

namestringoptional
destination name
typestringrequired
The destination type. `opensearch_dbaas` for a DigitalOcean managed OpenSearch cluster or `opensearch_ext` for an externally managed one.
Allowed:opensearch_dbaasopensearch_ext
configobjectrequired
OpenSearch connection settings. Include the cluster `endpoint`; credentials are optional when you provide `cluster_uuid`.

6 status codes
204Confirms the destination was updated successfully. The response body is empty.
401Returned when authentication fails because the supplied credentials are invalid.
idstringrequired
A short identifier corresponding to the HTTP status code returned. For example, the ID for a response returning a 404 status code would be "not_found."
messagestringrequired
A message providing additional information about the error, including details to help resolve it when possible.
request_idstringoptional
Optionally, some endpoints may include a request ID that should be provided when reporting bugs or opening support tickets to help identify the issue.
404Returned when the destination or a referenced resource is not found.
idstringrequired
A short identifier corresponding to the HTTP status code returned. For example, the ID for a response returning a 404 status code would be "not_found."
messagestringrequired
A message providing additional information about the error, including details to help resolve it when possible.
request_idstringoptional
Optionally, some endpoints may include a request ID that should be provided when reporting bugs or opening support tickets to help identify the issue.
429Returned when the API rate limit has been exceeded.
idstringrequired
A short identifier corresponding to the HTTP status code returned. For example, the ID for a response returning a 404 status code would be "not_found."
messagestringrequired
A message providing additional information about the error, including details to help resolve it when possible.
request_idstringoptional
Optionally, some endpoints may include a request ID that should be provided when reporting bugs or opening support tickets to help identify the issue.
500Returned when a server error occurs.
idstringrequired
A short identifier corresponding to the HTTP status code returned. For example, the ID for a response returning a 404 status code would be "not_found."
messagestringrequired
A message providing additional information about the error, including details to help resolve it when possible.
request_idstringoptional
Optionally, some endpoints may include a request ID that should be provided when reporting bugs or opening support tickets to help identify the issue.
defaultThere was an unexpected error.
idstringrequired
A short identifier corresponding to the HTTP status code returned. For example, the ID for a response returning a 404 status code would be "not_found."
messagestringrequired
A message providing additional information about the error, including details to help resolve it when possible.
request_idstringoptional
Optionally, some endpoints may include a request ID that should be provided when reporting bugs or opening support tickets to help identify the issue.

Error handling

A 401 is returned when authentication credentials are invalid. A 404 is returned when the destination or a referenced resource is not found, and a 429 is returned when the API rate limit is exceeded. A 500 indicates a server error; the destination_uuid path parameter must identify the destination, type must be opensearch_dbaas or opensearch_ext, and config must include endpoint.