DigitalOcean API (unofficial showcase)
PUT/v2/databases/metrics/credentials

Replace database cluster metrics endpoint credentials

Replaces the metrics endpoint credentials for all database clusters. Include credentials to set the basic-auth username and password using basic_auth_username and basic_auth_password; the request body is optional. A successful request returns 204 with no response body.

1 body field

Optional credentials configuration for the metrics endpoints.

credentialsobjectoptional
Object containing the basic-auth username and password for the metrics endpoints.

5 status codes
204Returns no response body when the credentials are updated successfully.
401Returned when authentication fails because the request 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.
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 the request's authentication credentials are invalid. A 429 is returned when the API rate limit is exceeded, and a 500 indicates a server error. If you send credentials, provide the basic-auth values in basic_auth_username and basic_auth_password.