Sign in
cloudfs filesystems

List CloudFS filesystems

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

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

Changed in 5 of the 99 revisions of this API.10412

  • a6a61a29ecdd224See the full diff
    • ▲

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

      response-property-type-changed

    • ▲

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

      response-property-type-changed

    • ●

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

      response-optional-property-removed

    • ●

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

      response-optional-property-removed

    • ○

      the response property // became required for the status

      response-property-became-required

    • ○

      the response property // became required for the status

      response-property-became-required

    • ○

      the response property // became required for the status

      response-property-became-required

    • ○

      the response property // became required for the status

      response-property-became-required

    This revision also has 34 changes that name no endpoint, such as unreferenced schemas being removed. See the revision's changelog

  • 1571b0380bd762See the full diff
    • ▲

      the response property // became optional for the status

      response-property-became-optional

    • ▲

      the response property // became optional for the status

      response-property-became-optional

    • ▲

      the response property // became optional for the status

      response-property-became-optional

    • ▲

      the response property // became optional for the status

      response-property-became-optional

    • ▲

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

      response-property-type-changed

    • ▲

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

      response-property-type-changed

    • ○

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

      response-optional-property-added

    • ○

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

      response-optional-property-added

    This revision also has 64 changes that name no endpoint, such as unreferenced schemas being removed. See the revision's changelog

  • 8f5f4e537994224See the full diff
    • ▲

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

      response-property-type-changed

    • ▲

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

      response-property-type-changed

    • ●

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

      response-optional-property-removed

    • ●

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

      response-optional-property-removed

    • ○

      the response property // became required for the status

      response-property-became-required

    • ○

      the response property // became required for the status

      response-property-became-required

    • ○

      the response property // became required for the status

      response-property-became-required

    • ○

      the response property // became required for the status

      response-property-became-required

    This revision also has 41 changes that name no endpoint, such as unreferenced schemas being removed. See the revision's changelog

  • eb02d7e7280b1See the full diff
    • ○

      the endpoint scheme security bearerAuth was removed from the API

      api-security-removed

  • dcc7fe8a21b61See the full diff
    • ○

      endpoint added

      endpoint-added

Of the 99 revisions, 1 has no diff computed.