Skip to main content

Project Id

Uncontrolled node

Overview​

The Project Id node retrieves the unique identifier of the current project at runtime. This node is useful when you need to reference the active project ID in other nodes, such as when writing to project databases, accessing project-specific files in the library, or making API calls that require project context.

note

This node has no inputs and does not require an event trigger. It outputs the project ID immediately when the workflow runs.

Inputs​

This node has no inputs.

Outputs​

OutputTypeDescription
projectIdTextThe unique identifier of the current project. Returns an error object if the project ID cannot be determined from the runtime context.

Runtime Behavior and Defaults​

  • Uncontrolled: This node runs automatically without requiring an event trigger.
  • Runtime Resolution: The node retrieves the runtimeProjectId from the workflow execution context.
  • Error Handling: If the project ID is not available or is not a valid string, the node outputs an error object: {error: 'Project ID could not be determined.'}.

Example Usage​

Basic Project ID Retrieval​

Connect the Project Id node to any node that requires a project identifier, such as the Insert Into Database or Write To Library nodes.

[Project Id] --(projectId)--> [Insert Into Database: databaseId]

Conditional Logic Based on Project​

Use the Project Id node with a Branch or Compare node to execute different logic based on the current project:

[Project Id] --(projectId)--> [Compare: a]
                                 |
[Text: "project-123"] ----------> [Compare: b]
                                 |
                           [Compare: result] --> [If: test]

In this example, you can compare the current project ID against a known value to conditionally run specific branches of your workflow.