Module airbyte_agent_sdk.connectors.gitlab
Gitlab connector for Airbyte SDK.
Auto-generated from OpenAPI specification.
Sub-modules
- airbyte_agent_sdk.connectors.gitlab.connector
- airbyte_agent_sdk.connectors.gitlab.connector_model
- airbyte_agent_sdk.connectors.gitlab.models
- airbyte_agent_sdk.connectors.gitlab.types
Classes
AirbyteAuthConfig(**data: Any)
: Authentication configuration for Airbyte hosted mode execution.
Pass this to the connector's auth_config parameter to use hosted mode,
where API credentials are stored securely in Airbyte Cloud.
For hosted mode execution, provide client credentials with either:
connector_id: Direct connector/source ID (skips lookup)workspace_name: Workspace name for connector lookup
Attributes: workspace_name: Workspace name for hosted mode connector lookup organization_id: Optional Airbyte organization ID for multi-org selection airbyte_client_id: Airbyte OAuth client ID (required for hosted mode) airbyte_client_secret: Airbyte OAuth client secret (required for hosted mode) connector_id: Specific connector/source ID (skips lookup if provided)
Examples:
Hosted mode with connector_id (no lookup needed)
connector = GongConnector( auth_config=AirbyteAuthConfig( airbyte_client_id="client_abc123", airbyte_client_secret="secret_xyz789", connector_id="existing-source-uuid" ) )
Hosted mode with workspace_name (lookup by workspace)
connector = GongConnector( auth_config=AirbyteAuthConfig( workspace_name="user-123", organization_id="00000000-0000-0000-0000-000000000123", airbyte_client_id="client_abc123", airbyte_client_secret="secret_xyz789" ) )
Create a new model by parsing and validating input data from keyword arguments.
Raises [ValidationError][pydantic_core.ValidationError] if the input data cannot be
validated to form a valid model.
self is explicitly positional-only to allow self as a field name.
Ancestors (in MRO)
- pydantic.main.BaseModel
Class variables
airbyte_client_id: str | None
: The type of the None singleton.
airbyte_client_secret: str | None
: The type of the None singleton.
connector_id: str | None
: The type of the None singleton.
model_config
: The type of the None singleton.
organization_id: str | None
: The type of the None singleton.
workspace_name: str | None
: The type of the None singleton.
AirbyteSearchMeta(**data: Any)
: Pagination metadata for search responses.
Create a new model by parsing and validating input data from keyword arguments.
Raises [ValidationError][pydantic_core.ValidationError] if the input data cannot be
validated to form a valid model.
self is explicitly positional-only to allow self as a field name.
Ancestors (in MRO)
- pydantic.main.BaseModel
Class variables
cursor: str | None
: Cursor for fetching the next page of results.
has_more: bool
: Whether more results are available.
model_config
: The type of the None singleton.
took_ms: int | None
: Time taken to execute the search in milliseconds.
AirbyteSearchResult(**data: Any)
: Result from Airbyte cache search operations with typed records.
Create a new model by parsing and validating input data from keyword arguments.
Raises [ValidationError][pydantic_core.ValidationError] if the input data cannot be
validated to form a valid model.
self is explicitly positional-only to allow self as a field name.
Ancestors (in MRO)
- pydantic.main.BaseModel
- typing.Generic
Descendants
- airbyte_agent_sdk.connectors.gitlab.models.AirbyteSearchResult[BranchesSearchData]
- airbyte_agent_sdk.connectors.gitlab.models.AirbyteSearchResult[CommitsSearchData]
- airbyte_agent_sdk.connectors.gitlab.models.AirbyteSearchResult[GroupMembersSearchData]
- airbyte_agent_sdk.connectors.gitlab.models.AirbyteSearchResult[GroupMilestonesSearchData]
- airbyte_agent_sdk.connectors.gitlab.models.AirbyteSearchResult[GroupsSearchData]
- airbyte_agent_sdk.connectors.gitlab.models.AirbyteSearchResult[IssuesSearchData]
- airbyte_agent_sdk.connectors.gitlab.models.AirbyteSearchResult[MergeRequestsSearchData]
- airbyte_agent_sdk.connectors.gitlab.models.AirbyteSearchResult[PipelinesSearchData]
- airbyte_agent_sdk.connectors.gitlab.models.AirbyteSearchResult[ProjectMembersSearchData]
- airbyte_agent_sdk.connectors.gitlab.models.AirbyteSearchResult[ProjectMilestonesSearchData]
- airbyte_agent_sdk.connectors.gitlab.models.AirbyteSearchResult[ProjectsSearchData]
- airbyte_agent_sdk.connectors.gitlab.models.AirbyteSearchResult[ReleasesSearchData]
- airbyte_agent_sdk.connectors.gitlab.models.AirbyteSearchResult[TagsSearchData]
- airbyte_agent_sdk.connectors.gitlab.models.AirbyteSearchResult[UsersSearchData]
Class variables
data: list[~D]
: List of matching records.
meta: airbyte_agent_sdk.connectors.gitlab.models.AirbyteSearchMeta
: Pagination metadata.
model_config
: The type of the None singleton.
BranchesSearchResult(**data: Any)
: Result from Airbyte cache search operations with typed records.
Create a new model by parsing and validating input data from keyword arguments.
Raises [ValidationError][pydantic_core.ValidationError] if the input data cannot be
validated to form a valid model.
self is explicitly positional-only to allow self as a field name.
Ancestors (in MRO)
- airbyte_agent_sdk.connectors.gitlab.models.AirbyteSearchResult
- pydantic.main.BaseModel
- typing.Generic
CommitsSearchResult(**data: Any)
: Result from Airbyte cache search operations with typed records.
Create a new model by parsing and validating input data from keyword arguments.
Raises [ValidationError][pydantic_core.ValidationError] if the input data cannot be
validated to form a valid model.
self is explicitly positional-only to allow self as a field name.
Ancestors (in MRO)
- airbyte_agent_sdk.connectors.gitlab.models.AirbyteSearchResult
- pydantic.main.BaseModel
- typing.Generic
GroupMembersSearchResult(**data: Any)
: Result from Airbyte cache search operations with typed records.
Create a new model by parsing and validating input data from keyword arguments.
Raises [ValidationError][pydantic_core.ValidationError] if the input data cannot be
validated to form a valid model.
self is explicitly positional-only to allow self as a field name.
Ancestors (in MRO)
- airbyte_agent_sdk.connectors.gitlab.models.AirbyteSearchResult
- pydantic.main.BaseModel
- typing.Generic
GroupMilestonesSearchResult(**data: Any)
: Result from Airbyte cache search operations with typed records.
Create a new model by parsing and validating input data from keyword arguments.
Raises [ValidationError][pydantic_core.ValidationError] if the input data cannot be
validated to form a valid model.
self is explicitly positional-only to allow self as a field name.
Ancestors (in MRO)
- airbyte_agent_sdk.connectors.gitlab.models.AirbyteSearchResult
- pydantic.main.BaseModel
- typing.Generic
GroupsSearchResult(**data: Any)
: Result from Airbyte cache search operations with typed records.
Create a new model by parsing and validating input data from keyword arguments.
Raises [ValidationError][pydantic_core.ValidationError] if the input data cannot be
validated to form a valid model.
self is explicitly positional-only to allow self as a field name.
Ancestors (in MRO)
- airbyte_agent_sdk.connectors.gitlab.models.AirbyteSearchResult
- pydantic.main.BaseModel
- typing.Generic
IssuesSearchResult(**data: Any)
: Result from Airbyte cache search operations with typed records.
Create a new model by parsing and validating input data from keyword arguments.
Raises [ValidationError][pydantic_core.ValidationError] if the input data cannot be
validated to form a valid model.
self is explicitly positional-only to allow self as a field name.
Ancestors (in MRO)
- airbyte_agent_sdk.connectors.gitlab.models.AirbyteSearchResult
- pydantic.main.BaseModel
- typing.Generic
MergeRequestsSearchResult(**data: Any)
: Result from Airbyte cache search operations with typed records.
Create a new model by parsing and validating input data from keyword arguments.
Raises [ValidationError][pydantic_core.ValidationError] if the input data cannot be
validated to form a valid model.
self is explicitly positional-only to allow self as a field name.
Ancestors (in MRO)
- airbyte_agent_sdk.connectors.gitlab.models.AirbyteSearchResult
- pydantic.main.BaseModel
- typing.Generic
PipelinesSearchResult(**data: Any)
: Result from Airbyte cache search operations with typed records.
Create a new model by parsing and validating input data from keyword arguments.
Raises [ValidationError][pydantic_core.ValidationError] if the input data cannot be
validated to form a valid model.
self is explicitly positional-only to allow self as a field name.
Ancestors (in MRO)
- airbyte_agent_sdk.connectors.gitlab.models.AirbyteSearchResult
- pydantic.main.BaseModel
- typing.Generic
ProjectMembersSearchResult(**data: Any)
: Result from Airbyte cache search operations with typed records.
Create a new model by parsing and validating input data from keyword arguments.
Raises [ValidationError][pydantic_core.ValidationError] if the input data cannot be
validated to form a valid model.
self is explicitly positional-only to allow self as a field name.
Ancestors (in MRO)
- airbyte_agent_sdk.connectors.gitlab.models.AirbyteSearchResult
- pydantic.main.BaseModel
- typing.Generic
ProjectMilestonesSearchResult(**data: Any)
: Result from Airbyte cache search operations with typed records.
Create a new model by parsing and validating input data from keyword arguments.
Raises [ValidationError][pydantic_core.ValidationError] if the input data cannot be
validated to form a valid model.
self is explicitly positional-only to allow self as a field name.
Ancestors (in MRO)
- airbyte_agent_sdk.connectors.gitlab.models.AirbyteSearchResult
- pydantic.main.BaseModel
- typing.Generic
ProjectsSearchResult(**data: Any)
: Result from Airbyte cache search operations with typed records.
Create a new model by parsing and validating input data from keyword arguments.
Raises [ValidationError][pydantic_core.ValidationError] if the input data cannot be
validated to form a valid model.
self is explicitly positional-only to allow self as a field name.
Ancestors (in MRO)
- airbyte_agent_sdk.connectors.gitlab.models.AirbyteSearchResult
- pydantic.main.BaseModel
- typing.Generic
ReleasesSearchResult(**data: Any)
: Result from Airbyte cache search operations with typed records.
Create a new model by parsing and validating input data from keyword arguments.
Raises [ValidationError][pydantic_core.ValidationError] if the input data cannot be
validated to form a valid model.
self is explicitly positional-only to allow self as a field name.
Ancestors (in MRO)
- airbyte_agent_sdk.connectors.gitlab.models.AirbyteSearchResult
- pydantic.main.BaseModel
- typing.Generic
TagsSearchResult(**data: Any)
: Result from Airbyte cache search operations with typed records.
Create a new model by parsing and validating input data from keyword arguments.
Raises [ValidationError][pydantic_core.ValidationError] if the input data cannot be
validated to form a valid model.
self is explicitly positional-only to allow self as a field name.
Ancestors (in MRO)
- airbyte_agent_sdk.connectors.gitlab.models.AirbyteSearchResult
- pydantic.main.BaseModel
- typing.Generic
UsersSearchResult(**data: Any)
: Result from Airbyte cache search operations with typed records.
Create a new model by parsing and validating input data from keyword arguments.
Raises [ValidationError][pydantic_core.ValidationError] if the input data cannot be
validated to form a valid model.
self is explicitly positional-only to allow self as a field name.
Ancestors (in MRO)
- airbyte_agent_sdk.connectors.gitlab.models.AirbyteSearchResult
- pydantic.main.BaseModel
- typing.Generic
BranchesSearchData(**data: Any)
: Search result data for branches entity.
Create a new model by parsing and validating input data from keyword arguments.
Raises [ValidationError][pydantic_core.ValidationError] if the input data cannot be
validated to form a valid model.
self is explicitly positional-only to allow self as a field name.
Ancestors (in MRO)
- pydantic.main.BaseModel
Class variables
can_push: bool | None
: Whether the current user can push
commit: dict[str, typing.Any] | None
: Head commit details
commit_id: str | None
: SHA of the head commit
default: bool | None
: Whether this is the default branch
developers_can_merge: bool | None
: Whether developers can merge into the branch
developers_can_push: bool | None
: Whether developers can push to the branch
merged: bool | None
: Whether the branch is merged
model_config
: The type of the None singleton.
name: str | None
: Name of the branch
project_id: int | None
: ID of the project the branch belongs to
protected: bool | None
: Whether the branch is protected
web_url: str | None
: Web URL of the branch
CommitsSearchData(**data: Any)
: Search result data for commits entity.
Create a new model by parsing and validating input data from keyword arguments.
Raises [ValidationError][pydantic_core.ValidationError] if the input data cannot be
validated to form a valid model.
self is explicitly positional-only to allow self as a field name.
Ancestors (in MRO)
- pydantic.main.BaseModel
Class variables
author_email: str | None
: Email of the commit author
author_name: str | None
: Name of the commit author
authored_date: str | None
: Date the commit was authored
committed_date: str | None
: Date the commit was committed
committer_email: str | None
: Email of the committer
committer_name: str | None
: Name of the committer
created_at: str | None
: Timestamp when the commit was created
id: str | None
: SHA of the commit
message: str | None
: Full commit message
model_config
: The type of the None singleton.
parent_ids: list[typing.Any] | None
: SHAs of parent commits
project_id: int | None
: ID of the project the commit belongs to
short_id: str | None
: Short SHA of the commit
stats: dict[str, typing.Any] | None
: Commit statistics
title: str | None
: Title of the commit
trailers: dict[str, typing.Any] | None
: Git trailers for the commit
web_url: str | None
: Web URL of the commit
GitlabConnector(auth_config: GitlabAuthConfig | AirbyteAuthConfig | BaseModel | None = None, on_token_refresh: Any | None = None, api_url: str | None = None)
: Type-safe Gitlab API connector.
Auto-generated from OpenAPI specification with full type safety.
Initialize a new gitlab connector instance.
Supports both local and hosted execution modes:
- Local mode: Provide connector-specific auth config (e.g., GitlabAuthConfig)
- Hosted mode: Provide
AirbyteAuthConfigwith client credentials and eitherconnector_idorworkspace_name
Args: auth_config: Either connector-specific auth config for local mode, or AirbyteAuthConfig for hosted mode on_token_refresh: Optional callback for OAuth2 token refresh persistence. Called with new_tokens dict when tokens are refreshed. Can be sync or async. Example: lambda tokens: save_to_database(tokens) api_url: GitLab instance hostname Examples:
Local mode (direct API calls)
connector = GitlabConnector(auth_config=GitlabAuthConfig(access_token="..."))
Hosted mode with explicit connector_id (no lookup needed)
connector = GitlabConnector( auth_config=AirbyteAuthConfig( airbyte_client_id="client_abc123", airbyte_client_secret="secret_xyz789", connector_id="existing-source-uuid" ) )
Hosted mode with lookup by workspace_name
connector = GitlabConnector( auth_config=AirbyteAuthConfig( workspace_name="user-123", organization_id="00000000-0000-0000-0000-000000000123", airbyte_client_id="client_abc123", airbyte_client_secret="secret_xyz789" ) )
Class variables
connector_name
: The type of the None singleton.
connector_version
: The type of the None singleton.
sdk_version
: The type of the None singleton.
Static methods
create(*, airbyte_config: AirbyteAuthConfig, auth_config: "'GitlabAuthConfig' | None" = None, server_side_oauth_secret_id: str | None = None, name: str | None = None, replication_config: "'GitlabReplicationConfig' | None" = None, source_template_id: str | None = None)
: Create a new hosted connector on Airbyte Cloud.
This factory method:
- Creates a source on Airbyte Cloud with the provided credentials
- Returns a connector configured with the new connector_id
Supports two authentication modes:
- Direct credentials: Provide
auth_configwith typed credentials - Server-side OAuth: Provide
server_side_oauth_secret_idfrom OAuth flow
Args: airbyte_config: Airbyte hosted auth config with client credentials and workspace_name. Optionally include organization_id for multi-org request routing. auth_config: Typed auth config. Required unless using server_side_oauth_secret_id. server_side_oauth_secret_id: OAuth secret ID from get_consent_url redirect. When provided, auth_config is not required. name: Optional source name (defaults to connector name + workspace_name) replication_config: Typed replication settings. Required for connectors with x-airbyte-replication-config (REPLICATION mode sources). source_template_id: Source template ID. Required when organization has multiple source templates for this connector type.
Returns: A GitlabConnector instance configured in hosted mode
Raises: ValueError: If neither or both auth_config and server_side_oauth_secret_id provided
Example:
Create a new hosted connector with API key auth
connector = await GitlabConnector.create( airbyte_config=AirbyteAuthConfig( workspace_name="my-workspace", organization_id="00000000-0000-0000-0000-000000000123", airbyte_client_id="client_abc", airbyte_client_secret="secret_xyz", ), auth_config=GitlabAuthConfig(access_token="..."), )
With replication config (required for this connector):
connector = await GitlabConnector.create( airbyte_config=AirbyteAuthConfig( workspace_name="my-workspace", organization_id="00000000-0000-0000-0000-000000000123", airbyte_client_id="client_abc", airbyte_client_secret="secret_xyz", ), auth_config=GitlabAuthConfig(access_token="..."), replication_config=GitlabReplicationConfig(start_date="..."), )
With server-side OAuth:
connector = await GitlabConnector.create( airbyte_config=AirbyteAuthConfig( workspace_name="my-workspace", organization_id="00000000-0000-0000-0000-000000000123", airbyte_client_id="client_abc", airbyte_client_secret="secret_xyz", ), server_side_oauth_secret_id="airbyte_oauth_...secret...", replication_config=GitlabReplicationConfig(start_date="..."), )
Use the connector
result = await connector.execute("entity", "list", {})
get_consent_url(*, airbyte_config: AirbyteAuthConfig, redirect_url: str, name: str | None = None, replication_config: "'GitlabReplicationConfig' | None" = None, source_template_id: str | None = None)
: Initiate server-side OAuth flow with auto-source creation.
Returns a consent URL where the end user should be redirected to grant access.
After completing consent, the source is automatically created and the user is
redirected to your redirect_url with a connector_id query parameter.
Args: airbyte_config: Airbyte hosted auth config with client credentials and workspace_name. Optionally include organization_id for multi-org request routing. redirect_url: URL where users will be redirected after OAuth consent. After consent, user arrives at: redirect_url?connector_id=... name: Optional name for the source. Defaults to connector name + workspace_name. replication_config: Typed replication settings. Merged with OAuth credentials. source_template_id: Source template ID. Required when organization has multiple source templates for this connector type.
Returns: The OAuth consent URL
Example: consent_url = await GitlabConnector.get_consent_url( airbyte_config=AirbyteAuthConfig( workspace_name="my-workspace", organization_id="00000000-0000-0000-0000-000000000123", airbyte_client_id="client_abc", airbyte_client_secret="secret_xyz", ), redirect_url="https://myapp.com/oauth/callback", name="My Gitlab Source", replication_config=GitlabReplicationConfig(start_date="..."), )
Redirect user to: consent_url
After consent, user arrives at: https://myapp.com/oauth/callback?connector_id=...
tool_utils(func: _F | None = None, *, update_docstring: bool = True, max_output_chars: int | None = 100000, framework: FrameworkName | None = None, internal_retries: int = 0, should_internal_retry: Callable[[Exception, tuple[Any, ...], dict[str, Any]], bool] | None = None, exhausted_runtime_failure_message: Callable[[Exception, tuple[Any, ...], dict[str, Any]], str | None] | None = None) ‑> ~_F | Callable[[~_F], ~_F]
: Decorator that adds tool utilities like docstring augmentation and output limits.
Composes :func:airbyte_agent_sdk.translation.translate_exceptions for
runtime wrapping (sync/async branch + output-size check + framework
signal translation + optional internal retry loop), and adds
connector-specific docstring augmentation on top of it.
Usage: @mcp.tool() @GitlabConnector.tool_utils async def execute(entity: str, action: str, params: dict): ...
@mcp.tool() @GitlabConnector.tool_utils(update_docstring=False, max_output_chars=None) async def execute(entity: str, action: str, params: dict): ...
@mcp.tool() @GitlabConnector.tool_utils(framework="pydantic_ai", internal_retries=2) async def execute(entity: str, action: str, params: dict): ...
Args:
update_docstring: When True, append connector capabilities to doc.
max_output_chars: Max serialized output size before raising. Use None to disable.
framework: One of "pydantic_ai" | "langchain" | "openai_agents" | "mcp".
Defaults to None → auto-detect by attempting each framework's canonical
import in order. Explicit always wins.
internal_retries: How many transient runtime failures (429/5xx, network,
timeout) to retry silently before surfacing. Default 0. Forwarded to
:func:airbyte_agent_sdk.translation.translate_exceptions.
should_internal_retry: Optional predicate (error, args, kwargs) -> bool
further restricting which retryable errors are safe for this specific
tool. Forwarded to
:func:airbyte_agent_sdk.translation.translate_exceptions.
exhausted_runtime_failure_message: Optional callback
(error, args, kwargs) -> str | None. Invoked after internal retries
are exhausted OR were skipped via should_internal_retry returning
False. Forwarded to
:func:airbyte_agent_sdk.translation.translate_exceptions.
Instance variables
connector_id: str | None
: Get the connector/source ID (only available in hosted mode).
Returns: The connector ID if in hosted mode, None if in local mode.
Example: connector = await GitlabConnector.create(...) print(f"Created connector: {connector.connector_id}")
Methods
check(self) ‑> airbyte_agent_sdk.connectors.gitlab.models.GitlabCheckResult
: Perform a health check to verify connectivity and credentials.
Executes a lightweight list operation (limit=1) to validate that the connector can communicate with the API and credentials are valid.
Returns: GitlabCheckResult with status ("healthy" or "unhealthy") and optional error message
Example: result = await connector.check() if result.status == "healthy": print("Connection verified!") else: print(f"Check failed: {result.error}")
close(self)
: Close the connector and release resources.
entity_schema(self, entity: str) ‑> dict[str, typing.Any] | None
: Get the JSON schema for an entity.
Args: entity: Entity name (e.g., "contacts", "companies")
Returns: JSON schema dict describing the entity structure, or None if not found.
Example: schema = connector.entity_schema("contacts") if schema: print(f"Contact properties: {list(schema.get('properties', {}).keys())}")
execute(self, entity: str, action: "Literal['list', 'get', 'context_store_search']", params: Mapping[str, Any] | None = None) ‑> Any
: Execute an entity operation with full type safety.
This is the recommended interface for blessed connectors as it:
- Uses the same signature as non-blessed connectors
- Provides full IDE autocomplete for entity/action/params
- Makes migration from generic to blessed connectors seamless
Args: entity: Entity name (e.g., "customers") action: Operation action (e.g., "create", "get", "list") params: Operation parameters (typed based on entity+action)
Returns: Typed response based on the operation
Example: customer = await connector.execute( entity="customers", action="get", params={"id": "cus_123"} )
list_entities(self) ‑> list[dict[str, typing.Any]]
: Get structured data about available entities, actions, and parameters.
Returns a list of entity descriptions with:
- entity_name: Name of the entity (e.g., "contacts", "deals")
- description: Entity description from the first endpoint
- available_actions: List of actions (e.g., ["list", "get", "create"])
- parameters: Dict mapping action -> list of parameter dicts
Example: entities = connector.list_entities() for entity in entities: print(f"{entity['entity_name']}: {entity['available_actions']}")
GitlabReplicationConfig(**data: Any)
: Replication Configuration - Settings for data replication from GitLab.
Create a new model by parsing and validating input data from keyword arguments.
Raises [ValidationError][pydantic_core.ValidationError] if the input data cannot be
validated to form a valid model.
self is explicitly positional-only to allow self as a field name.
Ancestors (in MRO)
- pydantic.main.BaseModel
Class variables
model_config
: The type of the None singleton.
start_date: str | None
: UTC date and time in the format YYYY-MM-DDTHH:mm:ssZ from which to start replicating data. If not set, all data will be replicated.
GroupMembersSearchData(**data: Any)
: Search result data for group_members entity.
Create a new model by parsing and validating input data from keyword arguments.
Raises [ValidationError][pydantic_core.ValidationError] if the input data cannot be
validated to form a valid model.
self is explicitly positional-only to allow self as a field name.
Ancestors (in MRO)
- pydantic.main.BaseModel
Class variables
access_level: int | None
: Access level of the member
avatar_url: str | None
: URL of the member avatar
created_at: str | None
: Timestamp when the member was added
created_by: dict[str, typing.Any] | None
: User who added the member
expires_at: str | None
: Expiration date of the membership
group_id: int | None
: ID of the group
id: int | None
: ID of the member
locked: bool | None
: Whether the member account is locked
membership_state: str | None
: State of the membership
model_config
: The type of the None singleton.
name: str | None
: Full name of the member
state: str | None
: State of the member account
username: str | None
: Username of the member
web_url: str | None
: Web URL of the member profile
GroupMilestonesSearchData(**data: Any)
: Search result data for group_milestones entity.
Create a new model by parsing and validating input data from keyword arguments.
Raises [ValidationError][pydantic_core.ValidationError] if the input data cannot be
validated to form a valid model.
self is explicitly positional-only to allow self as a field name.
Ancestors (in MRO)
- pydantic.main.BaseModel
Class variables
created_at: str | None
: Timestamp when the milestone was created
description: str | None
: Description of the milestone
due_date: str | None
: Due date of the milestone
expired: bool | None
: Whether the milestone is expired
group_id: int | None
: ID of the group
id: int | None
: ID of the milestone
iid: int | None
: Internal ID of the milestone within the group
model_config
: The type of the None singleton.
start_date: str | None
: Start date of the milestone
state: str | None
: State of the milestone
title: str | None
: Title of the milestone
updated_at: str | None
: Timestamp when the milestone was last updated
web_url: str | None
: Web URL of the milestone
GroupsSearchData(**data: Any)
: Search result data for groups entity.
Create a new model by parsing and validating input data from keyword arguments.
Raises [ValidationError][pydantic_core.ValidationError] if the input data cannot be
validated to form a valid model.
self is explicitly positional-only to allow self as a field name.
Ancestors (in MRO)
- pydantic.main.BaseModel
Class variables
auto_devops_enabled: bool | None
: Whether Auto DevOps is enabled
avatar_url: str | None
: URL of the group avatar
created_at: str | None
: Timestamp when the group was created
default_branch_protection: int | None
: Default branch protection level
description: str | None
: Description of the group
emails_disabled: bool | None
: Whether emails are disabled
emails_enabled: bool | None
: Whether emails are enabled
full_name: str | None
: Full name of the group
full_path: str | None
: Full path of the group
id: int | None
: ID of the group
lfs_enabled: bool | None
: Whether Git LFS is enabled
mentions_disabled: bool | None
: Whether mentions are disabled
model_config
: The type of the None singleton.
name: str | None
: Name of the group
parent_id: int | None
: ID of the parent group
path: str | None
: URL path of the group
project_creation_level: str | None
: Level required to create projects
projects: list[typing.Any] | None
: Projects in the group
request_access_enabled: bool | None
: Whether access requests are enabled
require_two_factor_authentication: bool | None
: Whether two-factor authentication is required
share_with_group_lock: bool | None
: Whether sharing with other groups is locked
shared_with_groups: list[typing.Any] | None
: Groups this group is shared with
subgroup_creation_level: str | None
: Level required to create subgroups
two_factor_grace_period: int | None
: Grace period for two-factor authentication
visibility: str | None
: Visibility level of the group
web_url: str | None
: Web URL of the group
IssuesSearchData(**data: Any)
: Search result data for issues entity.
Create a new model by parsing and validating input data from keyword arguments.
Raises [ValidationError][pydantic_core.ValidationError] if the input data cannot be
validated to form a valid model.
self is explicitly positional-only to allow self as a field name.
Ancestors (in MRO)
- pydantic.main.BaseModel
Class variables
assignee: dict[str, typing.Any] | None
: Primary assignee of the issue
assignee_id: int | None
: ID of the primary assignee
assignees: list[typing.Any] | None
: Users assigned to the issue
author: dict[str, typing.Any] | None
: Author of the issue
author_id: int | None
: ID of the author
blocking_issues_count: int | None
: Number of blocking issues
closed_at: str | None
: Timestamp when the issue was closed
closed_by: dict[str, typing.Any] | None
: User who closed the issue
closed_by_id: int | None
: ID of the user who closed the issue
confidential: bool | None
: Whether the issue is confidential
created_at: str | None
: Timestamp when the issue was created
description: str | None
: Description of the issue
discussion_locked: bool | None
: Whether discussion is locked
downvotes: int | None
: Number of downvotes
due_date: str | None
: Due date for the issue
has_tasks: bool | None
: Whether the issue has tasks
id: int | None
: ID of the issue
iid: int | None
: Internal ID of the issue within the project
issue_type: str | None
: Type classification of the issue
labels: list[typing.Any] | None
: Labels assigned to the issue
links: dict[str, typing.Any] | None
: Related resource links
merge_requests_count: int | None
: Number of related merge requests
milestone: dict[str, typing.Any] | None
: Milestone the issue belongs to
milestone_id: int | None
: ID of the milestone
model_config
: The type of the None singleton.
project_id: int | None
: ID of the project the issue belongs to
references: dict[str, typing.Any] | None
: Issue references
severity: str | None
: Severity level of the issue
state: str | None
: State of the issue
task_completion_status: dict[str, typing.Any] | None
: Task completion status
time_stats: dict[str, typing.Any] | None
: Time tracking statistics
title: str | None
: Title of the issue
type_: str | None
: Type of the issue
updated_at: str | None
: Timestamp when the issue was last updated
upvotes: int | None
: Number of upvotes
user_notes_count: int | None
: Number of user notes on the issue
web_url: str | None
: Web URL of the issue
weight: int | None
: Weight of the issue
MergeRequestsSearchData(**data: Any)
: Search result data for merge_requests entity.
Create a new model by parsing and validating input data from keyword arguments.
Raises [ValidationError][pydantic_core.ValidationError] if the input data cannot be
validated to form a valid model.
self is explicitly positional-only to allow self as a field name.
Ancestors (in MRO)
- pydantic.main.BaseModel
Class variables
assignee: dict[str, typing.Any] | None
: Primary assignee of the merge request
assignee_id: int | None
: ID of the primary assignee
assignees: list[typing.Any] | None
: Users assigned to the merge request
author: dict[str, typing.Any] | None
: Author of the merge request
author_id: int | None
: ID of the author
blocking_discussions_resolved: bool | None
: Whether blocking discussions are resolved
closed_at: str | None
: Timestamp when the merge request was closed
closed_by: dict[str, typing.Any] | None
: User who closed the merge request
closed_by_id: int | None
: ID of the user who closed it
created_at: str | None
: Timestamp when the merge request was created
description: str | None
: Description of the merge request
detailed_merge_status: str | None
: Detailed merge status
discussion_locked: bool | None
: Whether discussion is locked
downvotes: int | None
: Number of downvotes
draft: bool | None
: Whether the merge request is a draft
force_remove_source_branch: bool | None
: Whether to force remove source branch
has_conflicts: bool | None
: Whether the merge request has conflicts
id: int | None
: ID of the merge request
iid: int | None
: Internal ID of the merge request within the project
labels: list[typing.Any] | None
: Labels assigned to the merge request
merge_commit_sha: str | None
: SHA of the merge commit
merge_status: str | None
: Merge status of the merge request
merge_user: dict[str, typing.Any] | None
: User who performed the merge
merge_when_pipeline_succeeds: bool | None
: Whether to merge when pipeline succeeds
merged_at: str | None
: Timestamp when the merge request was merged
merged_by: dict[str, typing.Any] | None
: User who merged the merge request
merged_by_id: int | None
: ID of the user who merged it
milestone: dict[str, typing.Any] | None
: Milestone the merge request belongs to
milestone_id: int | None
: ID of the milestone
model_config
: The type of the None singleton.
project_id: int | None
: ID of the project
reference: str | None
: Short reference for the merge request
references: dict[str, typing.Any] | None
: Merge request references
reviewers: list[typing.Any] | None
: Users assigned as reviewers
sha: str | None
: SHA of the head commit
should_remove_source_branch: bool | None
: Whether source branch should be removed
source_branch: str | None
: Source branch for the merge request
source_project_id: int | None
: ID of the source project
squash: bool | None
: Whether to squash commits on merge
squash_commit_sha: str | None
: SHA of the squash commit
state: str | None
: State of the merge request
target_branch: str | None
: Target branch for the merge request
target_project_id: int | None
: ID of the target project
task_completion_status: dict[str, typing.Any] | None
: Task completion status
time_stats: dict[str, typing.Any] | None
: Time tracking statistics
title: str | None
: Title of the merge request
updated_at: str | None
: Timestamp when the merge request was last updated
upvotes: int | None
: Number of upvotes
user_notes_count: int | None
: Number of user notes
web_url: str | None
: Web URL of the merge request
work_in_progress: bool | None
: Whether the merge request is a work in progress
PipelinesSearchData(**data: Any)
: Search result data for pipelines entity.
Create a new model by parsing and validating input data from keyword arguments.
Raises [ValidationError][pydantic_core.ValidationError] if the input data cannot be
validated to form a valid model.
self is explicitly positional-only to allow self as a field name.
Ancestors (in MRO)
- pydantic.main.BaseModel
Class variables
created_at: str | None
: Timestamp when the pipeline was created
id: int | None
: ID of the pipeline
iid: int | None
: Internal ID of the pipeline within the project
model_config
: The type of the None singleton.
name: str | None
: Name of the pipeline
project_id: int | None
: ID of the project
ref: str | None
: Branch or tag that triggered the pipeline
sha: str | None
: SHA of the commit that triggered the pipeline
source: str | None
: Source that triggered the pipeline
status: str | None
: Status of the pipeline
updated_at: str | None
: Timestamp when the pipeline was last updated
web_url: str | None
: Web URL of the pipeline
ProjectMembersSearchData(**data: Any)
: Search result data for project_members entity.
Create a new model by parsing and validating input data from keyword arguments.
Raises [ValidationError][pydantic_core.ValidationError] if the input data cannot be
validated to form a valid model.
self is explicitly positional-only to allow self as a field name.
Ancestors (in MRO)
- pydantic.main.BaseModel
Class variables
access_level: int | None
: Access level of the member
avatar_url: str | None
: URL of the member avatar
created_at: str | None
: Timestamp when the member was added
created_by: dict[str, typing.Any] | None
: User who added the member
expires_at: str | None
: Expiration date of the membership
id: int | None
: ID of the member
locked: bool | None
: Whether the member account is locked
membership_state: str | None
: State of the membership
model_config
: The type of the None singleton.
name: str | None
: Full name of the member
project_id: int | None
: ID of the project
state: str | None
: State of the member account
username: str | None
: Username of the member
web_url: str | None
: Web URL of the member profile
ProjectMilestonesSearchData(**data: Any)
: Search result data for project_milestones entity.
Create a new model by parsing and validating input data from keyword arguments.
Raises [ValidationError][pydantic_core.ValidationError] if the input data cannot be
validated to form a valid model.
self is explicitly positional-only to allow self as a field name.
Ancestors (in MRO)
- pydantic.main.BaseModel
Class variables
created_at: str | None
: Timestamp when the milestone was created
description: str | None
: Description of the milestone
due_date: str | None
: Due date of the milestone
expired: bool | None
: Whether the milestone is expired
id: int | None
: ID of the milestone
iid: int | None
: Internal ID of the milestone within the project
model_config
: The type of the None singleton.
project_id: int | None
: ID of the project
start_date: str | None
: Start date of the milestone
state: str | None
: State of the milestone
title: str | None
: Title of the milestone
updated_at: str | None
: Timestamp when the milestone was last updated
web_url: str | None
: Web URL of the milestone
ProjectsSearchData(**data: Any)
: Search result data for projects entity.
Create a new model by parsing and validating input data from keyword arguments.
Raises [ValidationError][pydantic_core.ValidationError] if the input data cannot be
validated to form a valid model.
self is explicitly positional-only to allow self as a field name.
Ancestors (in MRO)
- pydantic.main.BaseModel
Class variables
allow_merge_on_skipped_pipeline: bool | None
: Whether merge is allowed on skipped pipeline
analytics_access_level: str | None
: Access level for analytics
archived: bool | None
: Whether the project is archived
auto_cancel_pending_pipelines: str | None
: Auto-cancel pending pipelines setting
auto_devops_deploy_strategy: str | None
: Auto DevOps deployment strategy
auto_devops_enabled: bool | None
: Whether Auto DevOps is enabled
autoclose_referenced_issues: bool | None
: Whether referenced issues are auto-closed
avatar_url: str | None
: URL of the project avatar
build_timeout: int | None
: Build timeout in seconds
builds_access_level: str | None
: Access level for builds
can_create_merge_request_in: bool | None
: Whether user can create merge requests
ci_config_path: str | None
: Path to the CI configuration file
ci_default_git_depth: int | None
: Default git depth for CI pipelines
ci_forward_deployment_enabled: bool | None
: Whether CI forward deployment is enabled
compliance_frameworks: list[typing.Any] | None
: Compliance frameworks for the project
container_expiration_policy: dict[str, typing.Any] | None
: Container expiration policy settings
container_registry_enabled: bool | None
: Whether container registry is enabled
container_registry_image_prefix: str | None
: Prefix for container registry images
created_at: str | None
: Timestamp when the project was created
creator_id: int | None
: ID of the project creator
default_branch: str | None
: Default branch of the project
description: str | None
: Description of the project
description_html: str | None
: HTML-rendered description of the project
emails_disabled: bool | None
: Whether emails are disabled
empty_repo: bool | None
: Whether the repository is empty
external_authorization_classification_label: str | None
: External authorization classification label
forking_access_level: str | None
: Access level for forking
forks_count: int | None
: Number of forks
http_url_to_repo: str | None
: HTTP URL to the repository
id: int | None
: ID of the project
import_status: str | None
: Import status of the project
issues_access_level: str | None
: Access level for issues
issues_enabled: bool | None
: Whether issues are enabled
jobs_enabled: bool | None
: Whether jobs are enabled
keep_latest_artifact: bool | None
: Whether the latest artifact is kept
last_activity_at: str | None
: Timestamp of last activity
lfs_enabled: bool | None
: Whether Git LFS is enabled
links: dict[str, typing.Any] | None
: Related resource links
merge_method: str | None
: Merge method used for the project
merge_requests_access_level: str | None
: Access level for merge requests
merge_requests_enabled: bool | None
: Whether merge requests are enabled
model_config
: The type of the None singleton.
name: str | None
: Name of the project
name_with_namespace: str | None
: Full name including namespace
namespace: dict[str, typing.Any] | None
: Namespace the project belongs to
only_allow_merge_if_all_discussions_are_resolved: bool | None
: Whether merge requires all discussions resolved
only_allow_merge_if_pipeline_succeeds: bool | None
: Whether merge requires pipeline success
open_issues_count: int | None
: Number of open issues
operations_access_level: str | None
: Access level for operations
packages_enabled: bool | None
: Whether packages are enabled
pages_access_level: str | None
: Access level for pages
path: str | None
: URL path of the project
path_with_namespace: str | None
: Full path including namespace
permissions: dict[str, typing.Any] | None
: User permissions for the project
printing_merge_request_link_enabled: bool | None
: Whether MR link printing is enabled
public_jobs: bool | None
: Whether jobs are public
readme_url: str | None
: URL to the project README
remove_source_branch_after_merge: bool | None
: Whether source branch is removed after merge
repository_access_level: str | None
: Access level for the repository
request_access_enabled: bool | None
: Whether access requests are enabled
requirements_enabled: bool | None
: Whether requirements are enabled
resolve_outdated_diff_discussions: bool | None
: Whether outdated diff discussions are auto-resolved
restrict_user_defined_variables: bool | None
: Whether user-defined variables are restricted
security_and_compliance_enabled: bool | None
: Whether security and compliance is enabled
service_desk_address: str | None
: Email address for the service desk
service_desk_enabled: bool | None
: Whether service desk is enabled
shared_runners_enabled: bool | None
: Whether shared runners are enabled
shared_with_groups: list[typing.Any] | None
: Groups the project is shared with
snippets_access_level: str | None
: Access level for snippets
snippets_enabled: bool | None
: Whether snippets are enabled
ssh_url_to_repo: str | None
: SSH URL to the repository
star_count: int | None
: Number of stars
statistics: dict[str, typing.Any] | None
: Project statistics
tag_list: list[typing.Any] | None
: List of tags for the project
topics: list[typing.Any] | None
: List of topics for the project
updated_at: str | None
: Timestamp when the project was last updated
visibility: str | None
: Visibility level of the project
web_url: str | None
: Web URL of the project
wiki_access_level: str | None
: Access level for the wiki
wiki_enabled: bool | None
: Whether wiki is enabled
ReleasesSearchData(**data: Any)
: Search result data for releases entity.
Create a new model by parsing and validating input data from keyword arguments.
Raises [ValidationError][pydantic_core.ValidationError] if the input data cannot be
validated to form a valid model.
self is explicitly positional-only to allow self as a field name.
Ancestors (in MRO)
- pydantic.main.BaseModel
Class variables
assets: dict[str, typing.Any] | None
: Assets attached to the release
author: dict[str, typing.Any] | None
: Author of the release
author_id: int | None
: ID of the author
commit: dict[str, typing.Any] | None
: Commit associated with the release
commit_id: str | None
: SHA of the associated commit
commit_path: str | None
: Path to the release commit
created_at: str | None
: Timestamp when the release was created
description: str | None
: Description of the release
evidences: list[typing.Any] | None
: Evidences collected for the release
links: dict[str, typing.Any] | None
: Related resource links
milestones: list[typing.Any] | None
: Milestones associated with the release
model_config
: The type of the None singleton.
name: str | None
: Name of the release
project_id: int | None
: ID of the project
released_at: str | None
: Timestamp when the release was published
tag_name: str | None
: Tag name associated with the release
tag_path: str | None
: Path to the release tag
upcoming_release: bool | None
: Whether this is an upcoming release
TagsSearchData(**data: Any)
: Search result data for tags entity.
Create a new model by parsing and validating input data from keyword arguments.
Raises [ValidationError][pydantic_core.ValidationError] if the input data cannot be
validated to form a valid model.
self is explicitly positional-only to allow self as a field name.
Ancestors (in MRO)
- pydantic.main.BaseModel
Class variables
commit: dict[str, typing.Any] | None
: Commit the tag points to
commit_id: str | None
: SHA of the tagged commit
message: str | None
: Annotation message of the tag
model_config
: The type of the None singleton.
name: str | None
: Name of the tag
project_id: int | None
: ID of the project
protected: bool | None
: Whether the tag is protected
release: dict[str, typing.Any] | None
: Release associated with the tag
target: str | None
: SHA the tag points to
UsersSearchData(**data: Any)
: Search result data for users entity.
Create a new model by parsing and validating input data from keyword arguments.
Raises [ValidationError][pydantic_core.ValidationError] if the input data cannot be
validated to form a valid model.
self is explicitly positional-only to allow self as a field name.
Ancestors (in MRO)
- pydantic.main.BaseModel
Class variables
avatar_url: str | None
: URL of the user avatar
id: int | None
: ID of the user
locked: bool | None
: Whether the user account is locked
model_config
: The type of the None singleton.
name: str | None
: Full name of the user
state: str | None
: State of the user account
username: str | None
: Username of the user
web_url: str | None
: Web URL of the user profile