---
title: "Get File-Log agent configuration list"
method: GET
path: "/v1/agents/{agentId}/configuration/list"
tags: ["Agents"]
---

# Get File-Log agent configuration list

`GET /v1/agents/{agentId}/configuration/list`

Use this endpoint to get the past configurations of a File-Log agent

## Path parameters

- `agentId` string, required

## Query parameters

- `page` integer
- `size` integer
- `by` 'local' | 'cloud' | 'all'
- `status` 'CREATED' | 'UNSENT' | 'PENDING' | 'PURGED' | 'ERROR' | 'PROCESSING' | 'REJECTED' | 'SUCCESS' | 'FAILURE' | 'all'
- `order` 'asc' | 'desc'

## Response `200`

Successful response

- object
  - `page` integer
  - `size` integer
  - `hasNext` boolean
  - `hits` AgentConfiguration[]
    - `id` string — The unique ID of the configuration.
    - `config` FLAConfiguration — Agent configuration if available, null otherwise.
      - `group_user` object
        - `user_name` string — The Windows User service account used for managing folder and file access for the agent.
        - `password` string — A secure hash of the user's password.
      - `agent_configuration` object
        - `s3_direct_upload` boolean — Whether to enable direct upload of files and logs to S3.
        - `receive_commands` boolean — Whether the agent should receive and execute commands from TDP.
        - `destination_id` string, uuid — The Destination Id of the Agent, used in place of its own ID in datalake file keys.
        - `agent_id` string — The ID of the agent.
        - `org_slug` string — The slug of the organization.
        - `Authentication` string — A secure hash of the agent's authentication token.
        - `advanced_setting` object
          - `heart_beat_interval` integer — The interval in seconds for the agent to check its connection status.
          - `agent_log_upload_job_interval` integer — The interval in seconds for the agent to upload logs.
          - `compression_type` 'Zip' | 'SevenZip' — The compression type for the agent.
          - `retry_limit` integer — The number of times the agent will retry to upload a file before it stops attempting the upload.
          - `tdpApiUrlOverride` string — The URL of the TDP API
          - `validateAwsCertificate` boolean — Indicates whether to validate the AWS certificate or not.
          - `proxyUseCustom` boolean — Indicates whether to use a custom proxy or not.
          - `proxyHost` string — The host of the proxy, if one is set.
          - `proxyPort` integer — The port of the proxy, if one is set.
          - `proxyBypassList` string — The list of addresses to bypass the proxy.
          - `proxyUsername` string — The username for the proxy, if one is set.
          - `proxyPassword` string — A secure hash of the agent's authentication token.
          - `proxyUseSystem` boolean — Indicates whether to use the system proxy or not.
      - `services_enabled` string[] — The services enabled for the agent.
      - `services_configuration` object
        - `fileWatcher` object, required
          - `use_path_configuration` boolean, required — Indicates whether or not to use path-level configuration for start date and interval.
          - `paths` FLAFileWatcherPathConfigurationItem[]
            - `path` string, required — The path to watch.
            - `file_watch_mode` 'file' | 'folder', required — The file watch mode.
            - `source_type` string, required — The source type.
            - `interval` integer, required — The time in seconds the agent will monitor the files for changes before uploading. This also specifies the time between scans of the path.
            - `start_date` string, date, required — Files with a last modified date on or after the specified date will be scanned and uploaded.
            - `patterns` string[], required — Defines a list of [glob patterns](https://developers.tetrascience.com/docs/common-glob-pattern) to match files in the path.
            - `metadata` object — Custom metadata to associate with files in the path.
            - `tags` string — Comma-separated list of tags to associate with files in the path.
            - `labels` object[] — **FLA v4.3.0+**: Labels applied to files in the path
              - …
            - `archive` object — **FLA v4.3.0+**: Options for archival and deletion of files in the path after upload
              - …
            - `fetch_os_created_user` boolean — Determines if the OS-created user metadata is retrieved and included as metadata on files in the path or not.
            - `symlink_behavior` 'Legacy' | 'Ignore' — **(For FLA v4.4.1 and higher only)** Specifies how the Agent handles symbolic links when file scanning.
      - `windows_scheduled_task` object
        - `enabled` boolean — Indicates whether the Windows scheduled task to ensure the agent service is running is enabled or not..
        - `time` string — The time of day when the Windows scheduled task is triggered.
    - `by` string — The entity that initiated the command.
    - `at` string, date-time — The timestamp when the command was executed.
    - `commandStatus` string — The status of the command.
    - `commandId` string — The unique ID of the command.

---

[API](https://skmtc.net/tetrascience/apis/tetra-data-lake.md) · [All operations](https://skmtc.net/tetrascience/apis/tetra-data-lake/llms.txt) · [OpenAPI document](https://skmtc-service-staging.skmtc.workers.dev/v1/apis/tetrascience/tetra-data-lake/revisions/0205e2bace53/schema)