public.databases.view
const url = 'https://rest.watchtower15.com/v1/databases/2489E9AD-2EE2-8E00-8EC9-32D5F69181C0';const options = {method: 'GET', headers: {Authorization: 'Bearer <token>'}};
try { const response = await fetch(url, options); const data = await response.json(); console.log(data);} catch (error) { console.error(error);}curl --request GET \ --url https://rest.watchtower15.com/v1/databases/2489E9AD-2EE2-8E00-8EC9-32D5F69181C0 \ --header 'Authorization: Bearer <token>'Authorizations
Section titled “Authorizations”Parameters
Section titled “Parameters”Path Parameters
Section titled “Path Parameters”Responses
Section titled “Responses”DatabasesViewResource
object
object
The hosting provider’s key, such as aws_rds_mysql.
How much of the database’s text the monitor keeps: hashed, identifiers or counts.
One of unknown, healthy, warning, critical.
One of draft, awaiting_collector, verifying, active, failing, paused.
Whether a collector holds more privilege than it needs.
What the collector’s probe found it can read, by layer; null before the first probe.
object
The 30-day projection less the size, while the forecast is ok.
The forecast’s status; null before the first forecast.
The storage ceiling set by hand, in GiB.
Epoch milliseconds: when the size was measured.
The schema collector’s state; its first seven fields are null while no pass has run.
object
The last attempt’s outcome.
Epoch milliseconds: the last attempt.
Epoch milliseconds: the last pass the database answered.
Epoch milliseconds: the next pass.
Why passes are paused, when they are.
Epoch milliseconds: since when passes are paused.
Int, views: int, routines: int}|null The object counts of the last answered pass; null before one.
object
Epoch milliseconds: when the schema history began.
Epoch milliseconds: the last schema change.
Epoch milliseconds: when a report last arrived; null if none ever did.
object
The database’s page in the console.
Example generated
{ "data": { "uuid": "example", "name": "example", "description": "example", "provider": "example", "provider_edition": "example", "engine": "example", "engine_version": "example", "engine_flavour": "example", "privacy_mode": "example", "tls_mode": "example", "health_status": "example", "status": "example", "over_privileged": true, "layers_available": "example", "storage": { "size_bytes": 1, "growth_30d_bytes": 1, "days_to_full": 1, "forecast_status": "example", "ceiling_gib": 1, "measured_at": 1 }, "schema": { "outcome": "example", "last_attempt_at": 1, "last_pass_at": 1, "next_pass_at": 1, "paused_reason": "example", "paused_since": 1, "object_counts": { "tables": 1, "views": 1, "routines": 1 }, "history_started_at": 1, "last_change_at": 1 }, "last_received_at": 1, "tags": [ { "uuid": "example", "name": "example" } ], "console_url": "example" }}The API key is missing, malformed, expired or revoked.
object
https://docs.watchtower15.com/api/errors/<code>/
object
Example generated
{ "type": "https://example.com", "title": "example", "status": 1, "code": "example", "detail": "example", "request_id": "example", "errors": { "additionalProperty": [ "example" ] }, "limit": 1, "used": 1}The key or its owner does not hold what the operation needs.
object
https://docs.watchtower15.com/api/errors/<code>/
object
Example generated
{ "type": "https://example.com", "title": "example", "status": 1, "code": "example", "detail": "example", "request_id": "example", "errors": { "additionalProperty": [ "example" ] }, "limit": 1, "used": 1}No such record in this organisation (an absent id and another organisation’s answer alike).
object
https://docs.watchtower15.com/api/errors/<code>/
object
Example generated
{ "type": "https://example.com", "title": "example", "status": 1, "code": "example", "detail": "example", "request_id": "example", "errors": { "additionalProperty": [ "example" ] }, "limit": 1, "used": 1}The request is invalid; errors names the parameters.
object
https://docs.watchtower15.com/api/errors/<code>/
object
Example generated
{ "type": "https://example.com", "title": "example", "status": 1, "code": "example", "detail": "example", "request_id": "example", "errors": { "additionalProperty": [ "example" ] }, "limit": 1, "used": 1}A rate limit or the organisation’s daily limit is reached; Retry-After says when to retry.
object
https://docs.watchtower15.com/api/errors/<code>/
object
Example generated
{ "type": "https://example.com", "title": "example", "status": 1, "code": "example", "detail": "example", "request_id": "example", "errors": { "additionalProperty": [ "example" ] }, "limit": 1, "used": 1}An unexpected error.
object
https://docs.watchtower15.com/api/errors/<code>/
object
Example generated
{ "type": "https://example.com", "title": "example", "status": 1, "code": "example", "detail": "example", "request_id": "example", "errors": { "additionalProperty": [ "example" ] }, "limit": 1, "used": 1}