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

Changes

Changed in 4 of the 61 revisions of this API.828

  • 1571b0380bd762See the full diff
    • ▲

      the response property errors/items/code became optional for the status 401

      response-property-became-optional

    • ▲

      the response property errors/items/code became optional for the status 422

      response-property-became-optional

    • ▲

      the response property errors/items/title became optional for the status 401

      response-property-became-optional

    • ▲

      the response property errors/items/title became optional for the status 422

      response-property-became-optional

    • ▲

      the errors/items/code response's property type/format changed from integer/int32 to string/ for status 401

      response-property-type-changed

    • ▲

      the errors/items/code response's property type/format changed from integer/int32 to string/ for status 422

      response-property-type-changed

    • ○

      added the optional property errors/items/meta/url to the response with the 401 status

      response-optional-property-added

    • ○

      added the optional property errors/items/meta/url to the response with the 422 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 errors/items/code response's property type/format changed from string/ to integer/int32 for status 401

      response-property-type-changed

    • ▲

      the errors/items/code response's property type/format changed from string/ to integer/int32 for status 422

      response-property-type-changed

    • ●

      removed the optional property errors/items/meta/url from the response with the 401 status

      response-optional-property-removed

    • ●

      removed the optional property errors/items/meta/url from the response with the 422 status

      response-optional-property-removed

    • ○

      the response property errors/items/code became required for the status 401

      response-property-became-required

    • ○

      the response property errors/items/code became required for the status 422

      response-property-became-required

    • ○

      the response property errors/items/title became required for the status 401

      response-property-became-required

    • ○

      the response property errors/items/title became required for the status 422

      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