project_duo_workflow_workflows

Gets or lists a project_duo_workflow_workflows resource.

Overview

Name	project_duo_workflow_workflows
Type	Resource
Id	gitlab.duo.project_duo_workflow_workflows

Fields

The following fields are returned by SELECT queries:

list

GraphQL response envelope

Name	Datatype	Description
id	string	ID of the session.
name	string	Name or title of the object.
namespace_id	string	ID of the namespace.
project_id	string	ID of the project.
user_id	string	ID of the user.
status_name	string	Status name of the session.
agent_privileges_names	array
all_executor_logs_urls	array
allow_agent_to_request_user	boolean	Allow the agent to request user input.
archived	boolean	Archived due to retention policy.
created_at	string	Timestamp of when the session was created.
environment	string	Environment, like IDE or web. (CHAT_PARTIAL, CHAT, AMBIENT)
goal	string	Goal of the session.
human_status	string	Human-readable status of the session.
incremental_checkpoints_enabled	boolean	Indicates incremental checkpoints were enabled for the session at creation.
last_executor_logs_url	string	URL to the latest executor logs of the workflow.
mcp_enabled	boolean	Has MCP been enabled for the namespace.
namespace	object	Namespace identity (id, full_path, name)
pre_approved_agent_privileges_names	array
project	object	Project identity (id, full_path, name)
resource_iid	integer	IID of the associated resource (issue or merge request).
resource_web_url	string	Web URL of the associated resource (issue or merge request).
stalled	boolean	Workflow got created but has no checkpoints.
status	string	Status of the session. (CREATED, RUNNING, PAUSED, INPUT_REQUIRED, PLAN_APPROVAL_REQUIRED, TOOL_CALL_APPROVAL_REQUIRED, STOPPED, FAILED, FINISHED)
status_group	string	Status group of the flow session. (ACTIVE, PAUSED, AWAITING_INPUT, COMPLETED, FAILED, CANCELED)
summary	string	Summary of the session.
title	string	Title of the session.
tool_call_approvals	string	Tools approval per session policy.
updated_at	string	Timestamp of when the session was last updated.
user	object	UserCore identity (id, username, name)
web_url	string	URL of the object.
workflow_definition	string	GitLab Duo Agent Platform flow type based on its capabilities.

Methods

The following methods are available for this resource:

Name	Accessible by	Required Params	Optional Params	Description
list	select	full_path, host	environment, project_path, search, sort, status_group, type, updated_after, workflow_id	GitLab Duo Agent Platform flows for a project, for all users (remote flows only). Generated from the GitLab GraphQL schema field Project.duoWorkflowWorkflows (connection of DuoWorkflow nodes).

Parameters

Parameters can be passed in the WHERE clause of a query. Check the Methods section to see which parameters are required or optional for each operation.

Name	Datatype	Description
full_path	string	Full path of the project, for example gitlab-org/gitlab
host	string	GitLab host, with an optional port (default gitlab.com). Resolved from the GITLAB_HOST environment variable when it is set (x-stackQL-envVar); a WHERE host value always takes precedence. Self-managed instances: the provider is generated from the gitlab.com schema, so older instances may reject fields they do not serve. (default: gitlab.com, x-stackQL-envVar: GITLAB_HOST)
environment	string	Environment, for example, IDE or web.
project_path	string	Full path of the project that contains the flows.
search	string	Flow title or goal to search for.
sort	string	Sort flows by the criteria.
status_group	string	Status group to filter flow sessions by.
type	string	Type of flow to filter by (for example, software_development or foundational_chat_agents).
updated_after	string	Filters flows updated after a given date.
workflow_id	string	Flow ID to filter by.

SELECT examples

list

GitLab Duo Agent Platform flows for a project, for all users (remote flows only). Generated from the GitLab GraphQL schema field Project.duoWorkflowWorkflows (connection of DuoWorkflow nodes).

SELECT
id,
name,
namespace_id,
project_id,
user_id,
status_name,
agent_privileges_names,
all_executor_logs_urls,
allow_agent_to_request_user,
archived,
created_at,
environment,
goal,
human_status,
incremental_checkpoints_enabled,
last_executor_logs_url,
mcp_enabled,
namespace,
pre_approved_agent_privileges_names,
project,
resource_iid,
resource_web_url,
stalled,
status,
status_group,
summary,
title,
tool_call_approvals,
updated_at,
user,
web_url,
workflow_definition
FROM gitlab.duo.project_duo_workflow_workflows
WHERE full_path = '{{ full_path }}' -- required
AND host = '{{ host }}' -- required (defaults to gitlab.com; or set GITLAB_HOST)
AND environment = '{{ environment }}'
AND project_path = '{{ project_path }}'
AND search = '{{ search }}'
AND sort = '{{ sort }}'
AND status_group = '{{ status_group }}'
AND type = '{{ type }}'
AND updated_after = '{{ updated_after }}'
AND workflow_id = '{{ workflow_id }}'
;