### GET /config/v1/activity/ Source: https://docs.hydrolix.io/latest/openapi/config-api/index Retrieves audit activities. Supports filtering by various parameters like date, user, resource, and pagination. ```APIDOC ## GET /config/v1/activity/ ### Description Get audit activities. This endpoint allows fetching a list of audit activities with various filtering and sorting options. ### Method GET ### Endpoint /config/v1/activity/ ### Parameters #### Query Parameters - **action** (string) - Optional - Filter by action performed. - **direction** (string) - Optional - Sort order for activities (e.g., 'asc', 'desc'). Defaults to 'asc'. - **ip_address** (string) - Optional - Filter by IP address. - **max_date** (string) - Optional - Filter activities up to this date. - **min_date** (string) - Optional - Filter activities from this date. - **page** (integer) - Optional - Page number for pagination. - **page_size** (integer) - Optional - Number of items per page. - **resource_id** (string) - Optional - Filter by resource ID. - **resource_type** (string) - Optional - Filter by resource type. - **target_user_id** (string) - Optional - Filter by the ID of the target user. - **target_username** (string) - Optional - Filter by the username of the target user. - **user** (string) - Optional - Filter by username. - **user_id** (string) - Optional - Filter by user ID. ### Request Example ``` GET https://{hostname}/config/v1/activity/?action=create&user=admin&page=1&page_size=20 ``` ### Response #### Success Response (200) - **activities** (array) - A list of audit activity objects. - **id** (string) - The unique identifier of the activity. - **timestamp** (string) - The time the activity occurred. - **user** (string) - The username of the user who performed the activity. - **action** (string) - The action performed. - **resource_type** (string) - The type of resource affected. - **resource_id** (string) - The ID of the resource affected. - **details** (object) - Additional details about the activity. #### Response Example ```json { "activities": [ { "id": "activity-123", "timestamp": "2023-10-27T10:00:00Z", "user": "admin", "action": "create", "resource_type": "transform_template", "resource_id": "template-abc", "details": { "name": "New Template" } } ] } ``` ``` -------------------------------- ### Get Activity Logs (Shell) Source: https://docs.hydrolix.io/latest/openapi/config-api/index Retrieves audit activities from the Hydrolix platform. This operation supports filtering and sorting via query parameters. It requires authentication and can be executed using a cURL command. ```shell curl -X GET https://{hostname}/config/v1/activity/ \ -H "Accept: */*" \ -H "Authorization: Bearer " \ -G \ --data-urlencode "action=Value" \ --data-urlencode "direction=asc" \ --data-urlencode "ip_address=Value" \ --data-urlencode "max_date=Value" \ --data-urlencode "min_date=Value" \ --data-urlencode "page=Value" \ --data-urlencode "page_size=Value" \ --data-urlencode "resource_id=Value" \ --data-urlencode "resource_type=Value" \ --data-urlencode "target_user_id=Value" \ --data-urlencode "target_username=Value" \ --data-urlencode "user=Value" \ --data-urlencode "user_id=Value" ``` -------------------------------- ### Defaults Operations Source: https://docs.hydrolix.io/latest/openapi/config-api/index Operations for retrieving default configuration settings. ```APIDOC ## GET /config/v1/defaults/ ### Description Retrieves the system's default configuration settings. ### Method GET ### Endpoint /config/v1/defaults/ ### Response #### Success Response (200) - **defaults** (object) - An object containing default configuration values. #### Response Example ```json { "defaults": { "default_retention_policy": "30d", "default_region": "us-east-1" } } ``` ``` -------------------------------- ### Query Options API Source: https://docs.hydrolix.io/latest/openapi/config-api/index Operations for managing query options at both project and table levels. ```APIDOC ## GET /config/v1/orgs/{org_id}/projects/{project_id}/query_options/ ### Description Retrieves query options for a project. ### Method GET ### Endpoint /config/v1/orgs/{org_id}/projects/{project_id}/query_options/ ### Parameters #### Path Parameters - **org_id** (string) - Required - The organization ID. - **project_id** (string) - Required - The project ID. ### Response #### Success Response (200) - **query_options** (object) - The query options for the project. #### Response Example ```json { "query_options": { "timeout_seconds": 60 } } ``` ## PUT /config/v1/orgs/{org_id}/projects/{project_id}/query_options/ ### Description Updates query options for a project. ### Method PUT ### Endpoint /config/v1/orgs/{org_id}/projects/{project_id}/query_options/ ### Parameters #### Path Parameters - **org_id** (string) - Required - The organization ID. - **project_id** (string) - Required - The project ID. #### Request Body - **query_options** (object) - Required - The query options to set. ### Request Example ```json { "query_options": { "timeout_seconds": 120, "max_rows": 10000 } } ``` ### Response #### Success Response (200) - **message** (string) - Confirmation message. #### Response Example ```json { "message": "Query options updated successfully." } ``` ## PATCH /config/v1/orgs/{org_id}/projects/{project_id}/query_options/ ### Description Partially updates query options for a project. ### Method PATCH ### Endpoint /config/v1/orgs/{org_id}/projects/{project_id}/query_options/ ### Parameters #### Path Parameters - **org_id** (string) - Required - The organization ID. - **project_id** (string) - Required - The project ID. #### Request Body - **query_options** (object) - Required - The query options to update. ### Request Example ```json { "query_options": { "max_rows": 5000 } } ``` ### Response #### Success Response (200) - **message** (string) - Confirmation message. #### Response Example ```json { "message": "Query options patched successfully." } ``` ## GET /config/v1/orgs/{org_id}/projects/{project_id}/tables/{table_id}/query_options/ ### Description Retrieves query options for a specific table within a project. ### Method GET ### Endpoint /config/v1/orgs/{org_id}/projects/{project_id}/tables/{table_id}/query_options/ ### Parameters #### Path Parameters - **org_id** (string) - Required - The organization ID. - **project_id** (string) - Required - The project ID. - **table_id** (string) - Required - The ID of the table. ### Response #### Success Response (200) - **query_options** (object) - The query options for the table. #### Response Example ```json { "query_options": { "read_only": true } } ``` ## GET /config/v1/orgs/{org_id}/projects/{project_id}/tables/{table_id}/query_options_hierarchy/ ### Description Retrieves the query options hierarchy for a specific table within a project. ### Method GET ### Endpoint /config/v1/orgs/{org_id}/projects/{project_id}/tables/{table_id}/query_options_hierarchy/ ### Parameters #### Path Parameters - **org_id** (string) - Required - The organization ID. - **project_id** (string) - Required - The project ID. - **table_id** (string) - Required - The ID of the table. ### Response #### Success Response (200) - **query_options_hierarchy** (object) - The query options hierarchy. #### Response Example ```json { "query_options_hierarchy": { "project_level": {"timeout_seconds": 60}, "table_level": {"read_only": true} } } ``` ## GET /config/v1/orgs/{org_id}/query_options/ ### Description Retrieves global query options for an organization. ### Method GET ### Endpoint /config/v1/orgs/{org_id}/query_options/ ### Parameters #### Path Parameters - **org_id** (string) - Required - The organization ID. ### Response #### Success Response (200) - **query_options** (object) - The global query options for the organization. #### Response Example ```json { "query_options": { "default_timeout": 30 } } ``` ## PUT /config/v1/orgs/{org_id}/query_options/ ### Description Updates global query options for an organization. ### Method PUT ### Endpoint /config/v1/orgs/{org_id}/query_options/ ### Parameters #### Path Parameters - **org_id** (string) - Required - The organization ID. #### Request Body - **query_options** (object) - Required - The global query options to set. ### Request Example ```json { "query_options": { "default_timeout": 45, "default_max_rows": 20000 } } ``` ### Response #### Success Response (200) - **message** (string) - Confirmation message. #### Response Example ```json { "message": "Global query options updated successfully." } ``` ## PATCH /config/v1/orgs/{org_id}/query_options/ ### Description Partially updates global query options for an organization. ### Method PATCH ### Endpoint /config/v1/orgs/{org_id}/query_options/ ### Parameters #### Path Parameters - **org_id** (string) - Required - The organization ID. #### Request Body - **query_options** (object) - Required - The global query options to update. ### Request Example ```json { "query_options": { "default_max_rows": 15000 } } ``` ### Response #### Success Response (200) - **message** (string) - Confirmation message. #### Response Example ```json { "message": "Global query options patched successfully." } ``` ``` -------------------------------- ### Kafka Sources API Source: https://docs.hydrolix.io/latest/openapi/config-api/index Operations for managing Kafka data sources within Hydrolix IO projects. This includes creating, retrieving, updating, and deleting Kafka sources. ```APIDOC ## Kafka Sources API ### Description Operations for managing Kafka data sources within Hydrolix IO projects. This includes creating, retrieving, updating, and deleting Kafka sources. ### Endpoints #### List Kafka Sources - **Method**: GET - **Endpoint**: `/config/v1/orgs/{org_id}/projects/{project_id}/tables/{table_id}/sources/kafka/` #### Create Kafka Source - **Method**: POST - **Endpoint**: `/config/v1/orgs/{org_id}/projects/{project_id}/tables/{table_id}/sources/kafka/` #### Get Kafka Source by ID - **Method**: GET - **Endpoint**: `/config/v1/orgs/{org_id}/projects/{project_id}/tables/{table_id}/sources/kafka/{id}/` #### Update Kafka Source by ID - **Method**: PUT - **Endpoint**: `/config/v1/orgs/{org_id}/projects/{project_id}/tables/{table_id}/sources/kafka/{id}/` #### Partially Update Kafka Source by ID - **Method**: PATCH - **Endpoint**: `/config/v1/orgs/{org_id}/projects/{project_id}/tables/{table_id}/sources/kafka/{id}/` #### Delete Kafka Source by ID - **Method**: DELETE - **Endpoint**: `/config/v1/orgs/{org_id}/projects/{project_id}/tables/{table_id}/sources/kafka/{id}/` ### Parameters #### Path Parameters - **org_id** (string) - Required - The organization ID. - **project_id** (string) - Required - The project ID. - **table_id** (string) - Required - The table ID. - **id** (string) - Required - The Kafka source ID. ``` -------------------------------- ### Dictionaries Operations Source: https://docs.hydrolix.io/latest/openapi/config-api/index Operations for managing dictionaries within projects, including file uploads and downloads. ```APIDOC ## GET /config/v1/dictionary_input_formats/ ### Description Retrieves a list of supported dictionary input formats. ### Method GET ### Endpoint /config/v1/dictionary_input_formats/ ### Response #### Success Response (200) - **input_formats** (array) - A list of supported input format names. #### Response Example ```json { "input_formats": ["json", "csv", "parquet"] } ``` ## GET /config/v1/dictionary_layouts/ ### Description Retrieves a list of supported dictionary layouts. ### Method GET ### Endpoint /config/v1/dictionary_layouts/ ### Response #### Success Response (200) - **layouts** (array) - A list of supported layout types. #### Response Example ```json { "layouts": ["flat", "nested"] } ``` ## GET /config/v1/orgs/{org_id}/projects/{project_id}/dictionaries/ ### Description Retrieves a list of dictionaries within a specific project. ### Method GET ### Endpoint /config/v1/orgs/{org_id}/projects/{project_id}/dictionaries/ ### Parameters #### Path Parameters - **org_id** (string) - Required - The ID of the organization. - **project_id** (string) - Required - The ID of the project. ### Response #### Success Response (200) - **dictionaries** (array) - A list of dictionary objects. - **id** (string) - The unique identifier for the dictionary. - **name** (string) - The name of the dictionary. #### Response Example ```json { "dictionaries": [ { "id": "dict_abc", "name": "User Data Dictionary" } ] } ``` ## POST /config/v1/orgs/{org_id}/projects/{project_id}/dictionaries/ ### Description Creates a new dictionary within a specific project. ### Method POST ### Endpoint /config/v1/orgs/{org_id}/projects/{project_id}/dictionaries/ ### Parameters #### Path Parameters - **org_id** (string) - Required - The ID of the organization. - **project_id** (string) - Required - The ID of the project. #### Request Body - **name** (string) - Required - The name for the new dictionary. - **layout** (string) - Optional - The layout type for the dictionary. - **input_format** (string) - Optional - The input format for the dictionary. ### Request Example ```json { "name": "New Product Dictionary", "layout": "nested", "input_format": "json" } ``` ### Response #### Success Response (200) - **message** (string) - A confirmation message. - **dictionary_id** (string) - The ID of the newly created dictionary. #### Response Example ```json { "message": "Dictionary created successfully.", "dictionary_id": "dict_def" } ``` ## GET /config/v1/orgs/{org_id}/projects/{project_id}/dictionaries/{id}/ ### Description Retrieves details for a specific dictionary within a project. ### Method GET ### Endpoint /config/v1/orgs/{org_id}/projects/{project_id}/dictionaries/{id}/ ### Parameters #### Path Parameters - **org_id** (string) - Required - The ID of the organization. - **project_id** (string) - Required - The ID of the project. - **id** (string) - Required - The ID of the dictionary. ### Response #### Success Response (200) - **dictionary** (object) - The dictionary details. - **id** (string) - The unique identifier for the dictionary. - **name** (string) - The name of the dictionary. - **layout** (string) - The layout type. - **input_format** (string) - The input format. #### Response Example ```json { "dictionary": { "id": "dict_abc", "name": "User Data Dictionary", "layout": "flat", "input_format": "csv" } } ``` ## PUT /config/v1/orgs/{org_id}/projects/{project_id}/dictionaries/{id}/ ### Description Updates details for a specific dictionary within a project. ### Method PUT ### Endpoint /config/v1/orgs/{org_id}/projects/{project_id}/dictionaries/{id}/ ### Parameters #### Path Parameters - **org_id** (string) - Required - The ID of the organization. - **project_id** (string) - Required - The ID of the project. - **id** (string) - Required - The ID of the dictionary. #### Request Body - **name** (string) - Optional - The new name for the dictionary. - **layout** (string) - Optional - The new layout type. - **input_format** (string) - Optional - The new input format. ### Request Example ```json { "name": "Updated User Data Dictionary", "layout": "nested" } ``` ### Response #### Success Response (200) - **message** (string) - A confirmation message. #### Response Example ```json { "message": "Dictionary updated successfully." } ``` ## PATCH /config/v1/orgs/{org_id}/projects/{project_id}/dictionaries/{id}/ ### Description Partially updates details for a specific dictionary within a project. ### Method PATCH ### Endpoint /config/v1/orgs/{org_id}/projects/{project_id}/dictionaries/{id}/ ### Parameters #### Path Parameters - **org_id** (string) - Required - The ID of the organization. - **project_id** (string) - Required - The ID of the project. - **id** (string) - Required - The ID of the dictionary. #### Request Body - **name** (string) - Optional - The new name for the dictionary. ### Request Example ```json { "name": "Partially Updated User Data Dictionary" } ``` ### Response #### Success Response (200) - **message** (string) - A confirmation message. #### Response Example ```json { "message": "Dictionary partially updated successfully." } ``` ## DELETE /config/v1/orgs/{org_id}/projects/{project_id}/dictionaries/{id}/ ### Description Deletes a specific dictionary from a project. ### Method DELETE ### Endpoint /config/v1/orgs/{org_id}/projects/{project_id}/dictionaries/{id}/ ### Parameters #### Path Parameters - **org_id** (string) - Required - The ID of the organization. - **project_id** (string) - Required - The ID of the project. - **id** (string) - Required - The ID of the dictionary. ### Response #### Success Response (200) - **message** (string) - A confirmation message. #### Response Example ```json { "message": "Dictionary deleted successfully." } ``` ## GET /config/v1/orgs/{org_id}/projects/{project_id}/dictionaries/{id}/activity/ ### Description Retrieves activity logs for a specific dictionary. ### Method GET ### Endpoint /config/v1/orgs/{org_id}/projects/{project_id}/dictionaries/{id}/activity/ ### Parameters #### Path Parameters - **org_id** (string) - Required - The ID of the organization. - **project_id** (string) - Required - The ID of the project. - **id** (string) - Required - The ID of the dictionary. ### Response #### Success Response (200) - **activities** (array) - A list of activity logs for the dictionary. #### Response Example ```json { "activities": [ { "timestamp": "2023-10-27T10:20:00Z", "action": "update_schema", "details": "Dictionary schema updated." } ] } ``` ## GET /config/v1/orgs/{org_id}/projects/{project_id}/dictionaries/files/ ### Description Retrieves a list of files associated with dictionaries in a project. ### Method GET ### Endpoint /config/v1/orgs/{org_id}/projects/{project_id}/dictionaries/files/ ### Parameters #### Path Parameters - **org_id** (string) - Required - The ID of the organization. - **project_id** (string) - Required - The ID of the project. ### Response #### Success Response (200) - **files** (array) - A list of file objects. - **filename** (string) - The name of the file. - **size** (integer) - The size of the file in bytes. - **uploaded_at** (string) - The timestamp when the file was uploaded. #### Response Example ```json { "files": [ { "filename": "data.json", "size": 1024, "uploaded_at": "2023-10-27T10:25:00Z" } ] } ``` ## POST /config/v1/orgs/{org_id}/projects/{project_id}/dictionaries/files/ ### Description Uploads a file to be associated with dictionaries in a project. ### Method POST ### Endpoint /config/v1/orgs/{org_id}/projects/{project_id}/dictionaries/files/ ### Parameters #### Path Parameters - **org_id** (string) - Required - The ID of the organization. - **project_id** (string) - Required - The ID of the project. #### Request Body - **file** (file) - Required - The file to upload. - **dictionary_id** (string) - Optional - The ID of the dictionary to associate the file with. ### Request Example ```json { "file": "