> 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/about-the-workflow-designer/workflow-permissions.md).

# Workflow permissions

You can define who has access to view, interact with, manage, or create workflows through a combination of global and resource permissions, roles and configuration settings.

{% hint style="warning" %}
While you can fine-tune where workflows are available and who has access to them, the actions performed by workflows are not restricted by the permissions of the users who are starting or participating in them.
{% endhint %}

## Prerequisites

You have a global role with the **Product Rights** > **System administration** global permission.

{% hint style="info" %}
To edit permissions and roles, you must have a [global role](https://productresources.collibra.com/docs/collibra/latest/Default.htm#cshid=DOC0635) that has the **System administration** [global permission](https://productresources.collibra.com/docs/collibra/latest/Default.htm#cshid=DOC0630).
{% endhint %}

## Accessing the Workflow Designer

To access the Workflow Designer, you must have a [global role](https://productresources.collibra.com/docs/collibra/latest/Default.htm#cshid=DOC0635) that has the [**Workflow Designer access**](/workflows/about-the-workflow-designer/enable-the-workflow-designer.md) [global permission](https://productresources.collibra.com/docs/collibra/latest/Default.htm#cshid=DOC0630). Once enabled, a link to the Workflow Designer will be added to the application menu.

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

## Managing workflows

To manage workflows in Collibra, you must have a [global role](https://productresources.collibra.com/docs/collibra/latest/Default.htm#cshid=DOC0635) with the **Workflow Administration** or the **System administration** [global permission](https://productresources.collibra.com/docs/collibra/latest/Default.htm#cshid=DOC0630), which allow you to:

* View workflows.
* Back up workflows.
* Publish workflows.
* Modify workflow definitions in Collibra.
* View the running instances of workflows.
* View the running instances of [Collibra-managed processes](/workflows/managing-workflows-in-collibra/system-instances.md).
* Restore workflows.
* Edit the workflow configuration options in Collibra.

## Interacting with workflows

At the platform level, you can manage who can start or participate in workflows by assigning the following permissions to the global roles that must interact with workflows:

* **Start workflow**
* **Participate in workflow**

{% hint style="info" %}
Users that have a global role with the **Workflow Administration** or **System administration** permission do not require these permissions explicitly.
{% endhint %}

At the workflow level, use roles to allow specific users to start, stop or reassign workflow tasks. You can configure the roles for each workflow individually in the workflow definition settings page:

{% stepper %}
{% step %}
On the main toolbar, click <img src="/files/M6nz1hzJEDs6R4z6SoGf" alt="Products icon" data-size="line"> → <img src="/files/enFqaM2f7lPrOzgBCLEP" alt="Cogwheel icon" data-size="line"> **Settings**.\ <i class="fa-chevrons-right">:chevrons-right:</i> The **Settings** page opens.
{% endstep %}

{% step %}
Click **Workflows**.\ <i class="fa-chevrons-right">:chevrons-right:</i> The Workflows settings page appears on the **Definitions** tab page.
{% endstep %}

{% step %}
Select a workflow.
{% endstep %}

{% step %}
[Edit the settings](/workflows/managing-workflows-in-collibra/view-and-edit-workflow-definition-settings.md#roles) in the **Roles** section of the workflow definition.
{% endstep %}
{% endstepper %}

## Viewing workflow tasks

Normally, you can only view tasks if you are a candidate user for the task. If you have a role with the **Manage workflows** resource permission for the asset related to the task or if you have the **View all running tasks** global permission, you can also see ongoing tasks that are assigned to other users in the **All Tasks** tab on the tasks page.

## Use workflow message events permission

**Use workflow message events** is a global permission that allows you to pass message events to the workflow engine via an API call.

{% tabs %}
{% tab title="Example" icon="glasses-round" %}
POST /workflowInstances/\<processInstanceId>/messageEvents/\<messageName>
{% endtab %}
{% endtabs %}


---

# 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/about-the-workflow-designer/workflow-permissions.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.
