Table Management

Copy Markdown View Source

List tables in namespace

GET /accounts/{account_id}/r2-catalog/{bucket_name}/namespaces/{namespace}/tables

Returns a list of tables in the specified namespace within an R2 catalog. Supports pagination for efficient traversal of large table collections.

Responses

200 List of tables retrieved successfully.

Data is at body["result"]

{
  "details": [
    {
      "created_at": "*string*",
      "identifier": {
        "name": null,
        "namespace": null
      },
      "location": "*string*",
      "metadata_location": "*string*",
      "table_uuid": "*string*",
      "updated_at": "*string*"
    }
  ],
  "identifiers": [
    {
      "name": "*string*",
      "namespace": [
        null
      ]
    }
  ],
  "next_page_token": "*string*",
  "table_uuids": [
    "*string*"
  ]
}

400 Bad request (e.g., invalid page_size, malformed namespace).

{
  "errors": [
    {
      "code": "*integer*",
      "message": "*string*"
    }
  ],
  "messages": [
    {}
  ],
  "success": "*boolean*"
}

401 Authentication failed.

{
  "errors": [
    {
      "code": "*integer*",
      "message": "*string*"
    }
  ],
  "messages": [
    {}
  ],
  "success": "*boolean*"
}

403 Forbidden.

{
  "errors": [
    {
      "code": "*integer*",
      "message": "*string*"
    }
  ],
  "messages": [
    {}
  ],
  "success": "*boolean*"
}

404 Catalog or namespace not found.

{
  "errors": [
    {
      "code": "*integer*",
      "message": "*string*"
    }
  ],
  "messages": [
    {}
  ],
  "success": "*boolean*"
}

500 Internal server error.

{
  "errors": [
    {
      "code": "*integer*",
      "message": "*string*"
    }
  ],
  "messages": [
    {}
  ],
  "success": "*boolean*"
}