Skip to content
Nappai Documentation

Holded Projects Component

The Holded Projects Component lets you work with your Holded projects, tasks, and time‑tracking data directly from the Nappai dashboard. Pick the type of resource you want to work with, choose an action (list, create, or get), and the component will call the Holded API for you. It also supports being used as a tool for the AI assistant, so you can give the agent a name and description for the tool.

How it Works

When you drop the component into a workflow, it first asks for a Holded Task API credential. That credential holds your Holded API key, which the component uses to authenticate with the Holded service.
The component has three main inputs:

  1. Resource – choose “Projects”, “Tasks”, or “Time Tracking”.
  2. Operation – choose “List”, “Create”, or “Get”.
  3. Credential – the API key you set up in Nappai’s credentials section.

When you run the component, it builds a request to the Holded API based on the selected resource and operation, sends the request, and returns the response as a Message. If you connect the component as a tool, it also exposes a Tool output that the AI assistant can call.

The component supports Mapping Mode, which lets you feed multiple records at once. When you enable it, you can set each input to a fixed value, map it from another component, or compute it with JavaScript.

Inputs

Mapping Mode

This component has a special mode called “Mapping Mode”. When you enable this mode using the toggle switch, an additional input called “Mapping Data” is activated, and each input field offers you three different ways to provide data:

  • Fixed: You type the value directly into the field.
  • Mapped: You connect the output of another component to use its result as the value.
  • Javascript: You write Javascript code to dynamically calculate the value.

This flexibility allows you to create more dynamic and connected workflows.

Input Fields

  • Mapping Mode: Enable mapping mode to process multiple data records in batch.
  • Resource: Choose the type of Holded data you want to work with – Projects, Tasks, or Time Tracking.
  • Operation: Pick the action you want to perform – List, Create, or Get.
  • Tool Name: The name of the tool that will be used when this component is connected as a tool. This name will be displayed to the agent when it selects tools to use.
  • Tool Description: A detailed description of what this tool does. This description will help the agent understand when and how to use this tool effectively.
  • Tools arguments metadata: Defines the arguments metadata for the tools.

Credential Setup

  1. In Nappai, go to the Credentials section and create a new Holded Task API credential.
  2. Sign in to Holded and copy your API key.
  3. Paste the key into the credential you created.
  4. In the component, select that credential from the Credential field.

Outputs

  • Response: The raw response from the Holded API, wrapped in a Message object. You can use this output to feed into other components or to display results.
  • Tool: A Tool object that can be used by the AI assistant. It contains the tool name, description, and the function signature.

Usage Example

  1. Add the component to your workflow.
  2. Select a credential that contains your Holded API key.
  3. Choose a Resource – for example, “Projects”.
  4. Choose an Operation – for example, “List”.
  5. Run the workflow.
  6. The Response output will contain a list of all projects in your Holded account.
  7. If you want the AI assistant to list projects, set Tool Name to “List Projects” and Tool Description to “Lists all projects in Holded”. The assistant can then call this tool.
  • Holded Tasks Component – Manage tasks within Holded projects.
  • Holded Time Tracking Component – Record and retrieve time‑tracking entries.
  • Holded Projects Component – (this component) handles projects, tasks, and time tracking in one place.

Tips and Best Practices

  • Keep your Holded API key secure; never expose it in public workflows.
  • Use Mapping Mode when you need to process many records at once, such as importing a list of projects.
  • When using the component as a tool, give the tool a clear name and description so the AI assistant can choose it correctly.
  • Test each operation separately before chaining them together to avoid confusing errors.

Security Considerations

The component relies on a stored Holded Task API credential. Make sure that only trusted users have access to the credentials section in Nappai. The API key is never exposed in the workflow UI or logs. If you suspect the key has been compromised, revoke it in Holded and create a new one.