---
title: "Lists all sinks"
method: GET
path: "/v2/monitoring/sinks"
tags: ["DigitalOcean-public.v2-new_Monitoring"]
---

# Lists all sinks

`GET /v2/monitoring/sinks`

To list all sinks, send a GET request to `/v2/monitoring/sinks`.

## Query parameters

- `resource_id` string — The uniform resource name (URN) for the resource in the format do:resource_type:resource_id.

## Response `200`

The response is a JSON object with a `sinks` key.

- object
  - `sinks` SinksResponse[] — List of sinks identified by their URNs.
    - `destination` Destination
      - `id` string — A unique identifier for a destination.
      - `name` string — destination name
      - `type` 'opensearch_dbaas' | 'opensearch_ext' — The destination type. `opensearch_dbaas` for a DigitalOcean managed OpenSearch cluster or `opensearch_ext` for an externally managed one.
      - `config` OpensearchConfig, required
        - `id` string — A unique identifier for a configuration.
        - `credentials` object — Credentials for an OpenSearch cluster user. Optional if `cluster_uuid` is passed.
          - `username` string
          - `password` string
        - `endpoint` string, required — host of the OpenSearch cluster
        - `cluster_uuid` string — A unique identifier for a managed OpenSearch cluster.
        - `cluster_name` string — Name of a managed OpenSearch cluster.
        - `index_name` string — OpenSearch index to send logs to.
        - `retention_days` integer — Number of days to retain logs in OpenSearch (default: 14)
    - `resources` SinkResource[] — List of resources identified by their URNs.
      - `urn` string, required — The uniform resource name (URN) for the resource in the format do:resource_type:resource_id.
      - `name` string — resource name

## Other responses

- `401` — Authentication failed due to invalid credentials.
- `404` — The resource was not found.
- `429` — The API rate limit has been exceeded.
- `500` — There was a server error.
- `default` — There was an unexpected error.

## Changes

- **2025-10-16** `cb3bf9b21459` — 2 info
  - api tag `DigitalOcean-public.v2-new_Monitoring` added
  - api tag `Monitoring` removed
- **2025-07-18** `f8e8c290636c` — 1 info
  - endpoint added
- **2025-07-17** `5fc9af728e82` — 1 breaking
  - api path removed without deprecation
- **2025-07-17** `f8e8c290636c` — 1 info
  - endpoint added

[Change history](https://skmtc.dev/digitalocean/apis/digitalocean-api/changes/v2/monitoring/sinks/get.md)

---

[API](https://skmtc.dev/digitalocean/apis/digitalocean-api.md) · [All operations](https://skmtc.dev/digitalocean/apis/digitalocean-api/llms.txt) · [OpenAPI document](https://skmtc-service-production.skmtc.workers.dev/v1/apis/digitalocean/digitalocean-api/revisions/cb3bf9b21459/schema)
