> For the complete documentation index, see [llms.txt](https://developer.collibra.com/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://developer.collibra.com/workflows/designing-workflows/processes/process-execution/beans/api-v2-in-workflows.md).

# API v2 in workflows

Collibra Platform has two API versions, v1 and v2. Use API v2 methods as v1 is deprecated.

To validate your code against API v2 in workflows, you have to enter the following value as **Namespace** in the **Process** section of the workflow properties: **<http://www.collibra.com/apiv2>**.

<img src="/files/8qbbBNQwL3PkUw40wEAo" alt="" width="50%">

{% hint style="info" %}
The value for the API v2 namespace has to be exactly as mentioned above. It is not a reachable URL.
{% endhint %}

If you use the API v2 namespace:

* You can no longer use API v1 calls in expressions and Groovy. These will be blocked and will result in failed workflows.
* All [form types](/workflows/designing-workflows/forms/start-forms/form-properties.md) are API v2 compatible.
* The Java beans expose and use only UUIDs and API v2 objects.

You can find the API v2 delegates, listeners and JavaBeans documentation in the API documentation of your environment. Go to https\://\<your\_collibra\_url>/docs/index.html and click Workflow beans.

{% hint style="success" %}
The direct link to this documentation is https\://\<your\_collibra\_url>/docs/java-workflow-api/index.html.
{% endhint %}

<img src="/files/5UrVEPsk9PA6wSwF8YCm" alt="" width="25%">


---

# Agent Instructions
This documentation is published with GitBook. GitBook is the documentation platform designed so that both humans and AI agents can read, navigate, and reason over technical content effectively. Learn more at gitbook.com.

## Querying This Documentation
If you need additional information that is not directly available in this page, you can query the documentation dynamically by asking a question.

Perform an HTTP GET request on the current page URL with the `ask` query parameter:

```
GET https://developer.collibra.com/workflows/designing-workflows/processes/process-execution/beans/api-v2-in-workflows.md?ask=<question>
```

The question should be specific, self-contained, and written in natural language.
The response will contain a direct answer to the question and relevant excerpts and sources from the documentation.

Use this mechanism when the answer is not explicitly present in the current page, you need clarification or additional context, or you want to retrieve related documentation sections.