Sign in

v4

latestSwagger 2.02026-08-0343714211.7 MB
behaviors
Behaviors

List Behaviors by Path

List Behaviors by Path

get/behaviors/folders/{path}

Path parameters

pathstring required

Path to operate on.

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 behavior.

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

ancestor_behaviorsboolean

If true, behaviors above this path are shown.

Response

A list of Behaviors objects.

idinteger

Folder behavior ID

pathstring

Folder path. Note that Behavior paths cannot be updated once initially set. You will need to remove and re-create the behavior on the new path.

attachment_urlstring

URL for attached file

behavior'webhook' | 'file_expiration' | 'auto_encrypt' | 'lock_subfolders' | 'storage_region' | 'serve_publicly' | 'create_user_folders' | 'inbox' | 'limit_file_extensions' | 'limit_file_regex' | 'amazon_sns' | 'watermark' | 'remote_server_mount' | 'slack_webhook' | 'auto_decrypt' | 'override_upload_filename' | 'permission_fence' | 'limit_filename_length' | 'organize_files_into_subfolders' | 'teams_webhook' | 'google_pub_sub' | 'archive_overwritten_or_deleted_files' | 'auto_recrypt' | 'metadata_category' | 'auto_unzip' | 'remote_server_metadata_index'

Behavior type.

namestring

Name for this behavior.

descriptionstring

Description for this behavior.

valueobject

Settings for this behavior. See the section above for an example value to provide here. Formatting is different for each Behavior type. May be sent as nested JSON or a single JSON-encoded string. If using XML encoding for the API call, this data must be sent as a JSON-encoded string.

public_hosting_urlstring

Public URL for this publicly hosted folder when the Serve Publicly behavior has a key configured. When a Custom Domain with public_hosting destination is attached to this behavior, the URL uses that domain. Otherwise it uses the site's subdomain.hosted-by-files.com host.

disable_parent_folder_behaviorboolean

If true, the parent folder's behavior will be disabled for this folder and its children.

recursiveboolean

Whether this behavior is recursive for this record. always behaviors are always true, never behaviors are always false, and sometimes behaviors may be either value.

inheritedboolean

If true, this behavior is inherited from a higher scope rather than owned by the requested workspace.

managedboolean

If true, this behavior is controlled by a parent-site policy and cannot be modified locally.

root_behavior_site_admin_onlyboolean

If true, this behavior may only be modified by a site admin because it is at the site root or disables a root behavior.

Example response

[
  {
    "id": 1,
    "path": "example",
    "attachment_url": "example",
    "behavior": "webhook",
    "name": "example",
    "description": "example",
    "public_hosting_url": "example",
    "disable_parent_folder_behavior": true,
    "recursive": true,
    "inherited": true,
    "managed": true,
    "root_behavior_site_admin_only": true
  }
]