Infomaniak Kdrive icon

Infomaniak Kdrive

Interact with Infomaniak Kdrive API

Actions178

Drive > Files > Category → Edit Category

AI-generated

Summary

Update a category's name and/or color in an Infomaniak Kdrive.

Inputs

  • authentication — Authentication method to use for the Infomaniak API request. Defaults to OAuth2 if not specified. Select between OAuth2 or API Key depending on how the node is configured in the workflow.
  • path_drive_id (required) — Identifier of the Kdrive (root drive ID). Must be provided as a numeric value.
  • path_category_id (required) — Identifier of the category to edit. Must be provided as a numeric value.
  • bodyParameters — Optional collection of additional fields to include in the edit request. Add 'body_name' to rename the category or 'body_color' to set its color. Each field is a key-value pair; unspecified fields are omitted from the API call.
  • returnFullResponse — When enabled, the full API response body is returned as workflow data. When disabled (default), only the item IDs of the updated category are returned.

Output shape

If returnFullResponse is true, returns the complete API response object. Otherwise, returns an array of item IDs corresponding to the updated category record.

The operation sends a PUT/PATCH request to the Infomaniak Kdrive API endpoint for category modification. The request body includes only the provided body_parameters (name and/or color). Authentication is handled via the selected method (OAuth2 or API Key).

Examples

Example 1: Edit only the category name

Set path_drive_id to the target drive ID, path_category_id to the category ID, body_parameters.body_name to the new name, leave body_color empty, and keep returnFullResponse as false.

Example 2: Edit both name and color, return full response

Set path_drive_id, path_category_id, body_parameters with both body_name and body_color, and enable returnFullResponse to receive the full API payload.

Links

Discussion