Discuss with expertTry it for free
© 2026 Direct Cursus Technology L.L.C.
Written by
View in Markdown

🚧 [Experimental] List REST catalogs

Returns a list of REST catalogs available to the current DataLens tenant.

Request

POST

https://api.datalens.tech/rpc/listCatalogs

Headers

Name

Description

x-dl-api-version

Type: string

API version header.

Const: 3

Example: 3

Body

application/json
{
  "cloudEnvironmentId": "example",
  "filter": [
    "example"
  ],
  "pageSize": 0,
  "pageToken": "example",
  "sortBy": "name",
  "reverseOrder": true,
  "includePermissions": true
}

Name

Description

cloudEnvironmentId

Type: string

ID of the cloud environment to list REST catalogs in. Lists the whole tenant when omitted.

Example: example

filter

Type: string[]

Filter expressions such as name="…"; only matching REST catalogs are returned.

Example
[
  "example"
]

includePermissions

Type: boolean

Include permission information in the response.

pageSize

Type: integer

Maximum number of REST catalogs to return. The default is 100.

Min value: 0

pageToken

Type: string

Token for the next page of REST catalogs.

Example: example

reverseOrder

Type: boolean

Whether to sort REST catalogs in descending order.

sortBy

Type: string

Field used to sort REST catalogs.

Enum: name, createdAt, updatedAt

Responses

200 OK

Response

Body

application/json
{
  "restCatalogs": [
    {
      "id": "example",
      "organizationId": "example",
      "tenantId": "example",
      "cloudEnvironmentId": "example",
      "name": "example",
      "description": "example",
      "labels": {},
      "createdAt": {
        "seconds": "example",
        "nanos": 0.5
      },
      "createdById": "example",
      "updatedAt": {
        "seconds": "example",
        "nanos": 0.5
      },
      "bucket": {
        "settings": {
          "storageClass": "example",
          "maxSize": "example",
          "alias": "example",
          "description": "example"
        },
        "details": {
          "usedSize": "example",
          "maxSize": "example",
          "updatedAt": {}
        }
      },
      "permissions": {}
    }
  ],
  "nextPageToken": "example"
}

Name

Description

nextPageToken

Type: string

Token for the next page of REST catalogs.

Example: example

restCatalogs
Type: object[]

bucket
Type: object

settings
Type: object

alias

Type: string

Human-readable alias of the REST catalog bucket.

Example: example

maxSize

Type: string

Maximum size of the REST catalog bucket in bytes.

Example: example

storageClass

Type: string

Storage class of the REST catalog bucket.

Example: example

description

Type: string

Description of the REST catalog bucket.

Example: example

Settings of the REST catalog bucket.

Example
{
  "storageClass": "example",
  "maxSize": "example",
  "alias": "example",
  "description": "example"
}

details
Type: object

maxSize

Type: string

Maximum size of the bucket in bytes.

Example: example

updatedAt
Type: object

seconds

Type: string

Number of seconds since the Unix epoch.

Example: example

nanos

Type: number

Fractional seconds in nanoseconds.

Time when the bucket details were updated.

Example
{
  "seconds": "example",
  "nanos": 0.5
}

usedSize

Type: string

Current size of the bucket in bytes.

Example: example

Current details of the REST catalog bucket.

Example
{
  "usedSize": "example",
  "maxSize": "example",
  "updatedAt": {
    "seconds": "example",
    "nanos": 0.5
  }
}

Bucket associated with the REST catalog.

Example
{
  "settings": {
    "storageClass": "example",
    "maxSize": "example",
    "alias": "example",
    "description": "example"
  },
  "details": {
    "usedSize": "example",
    "maxSize": "example",
    "updatedAt": {
      "seconds": "example",
      "nanos": 0.5
    }
  }
}

cloudEnvironmentId

Type: string

ID of the associated cloud environment.

Example: example

createdById

Type: string

ID of the user who created the REST catalog.

Example: example

description

Type: string

Description of the REST catalog.

Example: example

id

Type: string

ID of the REST catalog.

Example: example

name

Type: string

Name of the REST catalog.

Example: example

organizationId

Type: string

ID of the organization that owns the REST catalog.

Example: example

tenantId

Type: string

ID of the tenant that owns the REST catalog.

Example: example

createdAt
Type: object

seconds

Type: string

Number of seconds since the Unix epoch.

Example: example

nanos

Type: number

Fractional seconds in nanoseconds.

Time when the REST catalog was created.

Example
{
  "seconds": "example",
  "nanos": 0.5
}

labels
Type: object

[additional]

Type: string

Example: example

REST catalog labels.

Example
{}

permissions
Type: object

[additional]

Type: boolean

Permissions for the REST catalog.

Example
{}

updatedAt
Type: object

seconds

Type: string

Number of seconds since the Unix epoch.

Example: example

nanos

Type: number

Fractional seconds in nanoseconds.

Time when the REST catalog was last updated.

Example
{
  "seconds": "example",
  "nanos": 0.5
}

REST catalogs matching the request.

Example
[
  {
    "id": "example",
    "organizationId": "example",
    "tenantId": "example",
    "cloudEnvironmentId": "example",
    "name": "example",
    "description": "example",
    "labels": {},
    "createdAt": {
      "seconds": "example",
      "nanos": 0.5
    },
    "createdById": "example",
    "updatedAt": {
      "seconds": "example",
      "nanos": 0.5
    },
    "bucket": {
      "settings": {
        "storageClass": "example",
        "maxSize": "example",
        "alias": "example",
        "description": "example"
      },
      "details": {
        "usedSize": "example",
        "maxSize": "example",
        "updatedAt": {
          "seconds": "example",
          "nanos": 0.5
        }
      }
    },
    "permissions": {}
  }
]
Previous
Overview
Next
🚧 [Experimental] Create REST catalog