cloudfs filesystems

List CloudFS filesystems

Changed on

Lists the CloudFS filesystems for the authenticated user's organization. Results use cursor-based pagination: fetch the next page by passing meta.cursors.after as page[after], or follow the meta.next URL.

get/storage/cloudfs

Request

  • Base URL: https://api.telnyx.com/v2
  • URL: https://api.telnyx.com/v2/storage/cloudfs
  • Auth: HTTP bearer

Query parameters

page[limit]integer

The number of filesystems to return per page. Values above 250 are treated as 250.

page[after]string

Opaque cursor from a previous response's meta.cursors.after; returns the page after it. Mutually exclusive with page[before].

page[before]string

Opaque cursor from a previous response's meta.cursors.before; returns the page before it. Mutually exclusive with page[after].

filter[name]string

Return only the filesystem whose name matches exactly.

filter[status]'provisioning' | 'ready' | 'needs_format' | 'deleting' | 'failed'

Return only filesystems with this status. Unrecognized values are ignored.

filter[region]string
Example:us-east-1

Return only filesystems in this region.

sort'created_at' | '-created_at' | 'updated_at' | '-updated_at' | 'name' | '-name'

Sort order for the results: a field name for ascending, or the field name prefixed with - for descending.

Response

CloudFS filesystems retrieved successfully

Example response

{
  "data": [
    {
      "record_type": "cloudfs",
      "id": "550e8400-e29b-41d4-a716-446655440000",
      "name": "agent-fs",
      "status": "ready",
      "s3_endpoint": "https://us-east-1.telnyxcloudstorage.com",
      "s3_bucket": "cloudfs-fs-0123456789abcdef",
      "region": "us-east-1",
      "created_at": "2026-07-14T21:42:01Z",
      "updated_at": "2026-07-14T21:42:01Z"
    }
  ]
}

Changes

  • 19db5ee4ec59Revision changes
    • breaking

      the // response's property type changed from integer to string, and format from int32 to no format for status

    • breaking

      the // response's property type changed from integer to string, and format from int32 to no format for status

    • info

      added the optional property // to the response with the status

    • info

      added the optional property // to the response with the status

  • a6a61a29ecddRevision changes
    • breaking

      the // response's property type changed from string to integer, and format from no format to int32 for status

    • breaking

      the // response's property type changed from string to integer, and format from no format to int32 for status

    • warning

      removed the optional property /// from the response with the status

    • warning

      removed the optional property /// from the response with the status

    • info

      the response property // became required for the status

    • info

      the response property // became required for the status

    • info

      the response property // became required for the status

    • info

      the response property // became required for the status