Arca icon

Arca

Interact with the Arca API to manage users, workspaces, folders, lists, tasks, statuses, labels, and comments.

Folder → Create Folder

AI-generated

Summary

Creates a new folder within a specified Arca workspace, optionally setting an icon and color.

Inputs

  • workspaceId (required) — The ID of the workspace where the folder will be created. Can be selected from a list or specified via an expression.
  • name (required) — The name of the new folder.
  • additionalFields — Optional configuration for additional folder attributes. Includes 'icon' (a slug) and 'color' (one of gray, red, orange, yellow, green, teal, blue, cyan, purple, or pink).

Output shape

A single record representing the created folder, including its ID and properties.

The response is wrapped in a '' object and paired with the input item index.

Examples

Example 1: Create a standard folder named 'Projects' in the default workspace.

workspaceId: [Select default workspace], name: 'Projects'

Example 2: Create a folder with a specific visual style.

workspaceId: [Select workspace], name: 'Design Tasks', additionalFields: icon: 'check-circle', color: 'blue'

Links

Discussion