GitLab Search

GitLab Search
Certified
Search issues in a project

Queries GitLab issues for the target project via the REST API. Requires projectId and token; state defaults to opened. Supports custom url and apiPath for self-hosted GitLab and renders templated values before the request.

yaml
type: io.kestra.plugin.gitlab.issues.Search

Examples

Search for issues in a GitLab project using an access token.

yaml
id: gitlab_search_issues
namespace: company.team

tasks:
  - id: search_issues
    type: io.kestra.plugin.gitlab.issues.Search
    token: "{{ secret('GITLAB_TOKEN') }}"
    projectId: "123"
    search: "bug"
    state: "opened"
    labels:
      - bug
      - critical

Search for issues in a GitLab project with custom API path for self-hosted GitLab.

yaml
id: gitlab_search_issues
namespace: company.team

tasks:
  - id: search_issues
    type: io.kestra.plugin.gitlab.issues.Search
    url: https://gitlab.example.com
    apiPath: /api/v4/projects
    token: "{{ secret('GITLAB_TOKEN') }}"
    projectId: "123"
    search: "bug"
    state: "opened"
    labels:
      - bug
      - critical

Properties

projectId *string

Project ID or path

Numeric project ID or URL-encoded project path rendered from the context to build API endpoints.

token *string

Access token used for API calls

GitLab Personal/Project/Group Access Token sent as the PRIVATE-TOKEN header; requires scopes that cover the requested API operations. See the GitLab Authentication docs.

apiPath string

Default/api/v4/projects

Projects API path

Projects API prefix appended before the project ID; defaults to /api/v4/projects. Override when fronting GitLab with a proxy or custom base path.

labels array

SubTypestring

Labels to filter by

Labels rendered from the context and comma-joined for the GitLab API.

pluginDefaultsRef string

Reference (ref) of the pluginDefaults to apply to this task.

search string

Search query

Free-text query matched against issue title and description.

state string

Defaultopened

Issue state

Filter by state: opened, closed, or all; defaults to opened when not provided.

url string

Defaulthttps://gitlab.com

GitLab API base URL

Base URL of the GitLab instance; defaults to https://gitlab.com. Override for self-hosted installations.

Outputs

count integer

Number of issues found

Count of issues returned by the request.

issues array

SubTypeobject

Found issues

statusCode integer

HTTP status code

HTTP response code from the GitLab API.

Zulip

Tasks that send messages to Zulip streams or users.

Business

OPA (Open Policy Agent)

Enterprise

Tasks to manage Open Policy Agent policies and decisions, including upload, evaluation, and partial evaluation.

Infrastructure

GitLab SearchCertifiedSearch issues in a project

More Plugins in this Category

Zulip

OPA (Open Policy Agent)

GitLab Search
Certified
Search issues in a project