Sign in
External Services - Query

List containers at the root level (databases, keyspaces, etc.)

get/external-services/{service_id}/query/containers

Request

  • Base URL: /api (relative, and the document was published on a file host, not at the API’s origin)
  • URL: /api/external-services/{service_id}/query/containers
  • Auth: HTTP bearer

Path parameters

service_idinteger required

Response

List of root containers

can_contain_containersboolean required

Can this container hold other containers?

can_contain_entitiesboolean required

Can this container hold entities (tables, collections, etc.)?

child_container_typestring nullable

Type of child containers (if can_contain_containers is true)

container_typestring required

Container type (database, schema, keyspace, bucket, etc.)

entity_count_hintstring nullable

Hint for UI on expected entity count (small = sidebar, large = pagination)

entity_type_labelstring nullable

Label for entity type (if can_contain_entities is true)

metadataunknown required
namestring required

Container name

Example response

[
  {
    "can_contain_containers": true,
    "child_container_type": "schema",
    "container_type": "database",
    "entity_count_hint": "large",
    "entity_type_label": "table",
    "name": "mydb"
  }
]

Changes

No recorded changes to this operation across all 50 revisions of this API.