v4

latestSwagger 2.02026-08-0343714211.7 MB
remote_server_credentials
Remote Server Credentials

List Remote Server Credentials

List Remote Server Credentials

get/remote_server_credentials

Query parameters

cursorstring

Used for pagination. When a list request has more records available, cursors are provided in the response headers X-Files-Cursor-Next and X-Files-Cursor-Prev. Send one of those cursor value here to resume an existing list from the next available record. Note: many of our SDKs have iterator methods that will automatically handle cursor-based pagination.

per_pageinteger

Number of records to show per page. (Max: 10000, 1,000 or less is recommended).

If set, sort records by the specified field in either asc or desc direction. Valid fields are workspace_id and id.

If set, return records where the specified field is equal to the supplied value. Valid fields are workspace_id and name. Valid field combinations are [ workspace_id, name ].

If set, return records where the specified field is prefixed by the supplied value. Valid fields are name.

Response

A list of RemoteServerCredentials objects.

idinteger

Remote Server Credential ID

workspace_idinteger

Workspace ID (0 for default workspace)

namestring

Internal name for your reference

descriptionstring

Internal description for your reference

server_type'ftp' | 'sftp' | 's3' | 'google_cloud_storage' | 'webdav' | 'wasabi' | 'backblaze_b2' | 'one_drive' | 'box' | 'dropbox' | 'google_drive' | 'azure' | 'sharepoint' | 's3_compatible' | 'azure_files' | 'files_agent' | 'filebase' | 'cloudflare' | 'linode' | 'files_com'

Remote server type. Remote Server Credentials are only valid for a single type of Remote Server.

aws_access_keystring

AWS Access Key.

s3_assume_role_arnstring

AWS IAM Role ARN for AssumeRole authentication.

s3_assume_role_duration_secondsinteger

Session duration in seconds for AssumeRole authentication (900-43200).

s3_assume_role_external_idstring

External ID for AssumeRole authentication.

google_cloud_storage_s3_compatible_access_keystring

Google Cloud Storage: S3-compatible Access Key.

wasabi_access_keystring

Wasabi: Access Key.

s3_compatible_access_keystring

S3-compatible: Access Key

filebase_access_keystring

Filebase: Access Key.

cloudflare_access_keystring

Cloudflare: Access Key.

linode_access_keystring

Linode: Access Key

sharepoint_tenant_idstring

SharePoint: Microsoft Entra tenant ID for app-only authentication.

sharepoint_client_idstring

SharePoint: Microsoft Entra application client ID for app-only authentication.

sharepoint_app_credential_typestring

SharePoint: App-only credential type. Either secret or certificate.

usernamestring

Remote server username.

Example response

[
  {
    "id": 1,
    "name": "My Credential",
    "description": "More information or notes about this credential.",
    "server_type": "s3",
    "aws_access_key": "example",
    "s3_assume_role_arn": "example",
    "s3_assume_role_duration_seconds": 1,
    "s3_assume_role_external_id": "example",
    "google_cloud_storage_s3_compatible_access_key": "example",
    "wasabi_access_key": "example",
    "s3_compatible_access_key": "example",
    "filebase_access_key": "example",
    "cloudflare_access_key": "example",
    "linode_access_key": "example",
    "sharepoint_tenant_id": "00000000-0000-0000-0000-000000000000",
    "sharepoint_client_id": "00000000-0000-0000-0000-000000000000",
    "sharepoint_app_credential_type": "secret",
    "username": "user"
  }
]