Get a single start task, returning None if missing.

Check if a Git organization is already claimed. Args: provider: Git provider name git_organization: Name of the Git o

Get the title and body of an issue. Args: repository: Repository name in format 'owner/repo' issue_number: The issue

Get the latest token for the provider type given

Get a model by its composite key (model_name, provider). Args: model_name: The model identifier provider: The provide

Get or create an API key for a user on behalf of the automations service. If a key with the given name already exists for the user/org and i

Return a stable install UUID for an OSS installation. On first call, generates a new UUID4, writes it to ``{persistence_dir}/analytics_id.txt

Get organization by ID with membership validation. This method verifies that the user is a member of the organization before

Get organization by name.

Get the project directory path for loading hooks. When a repository is selected, hooks are loaded from {working_dir}/{repo_name}/.openhands/h

Get suggested tasks from providers

Get a team's bot access token by team_id

Get the top k chunks in the text that match the query. The query could be a string of draft code edits. Args: text: The text to sear

Get user app settings. User ID is obtained from the injected user_context. Returns: UserAppSettingsResponse: The user's

Fetch the authenticated user's email addresses from GitHub. Calls GET /user/emails which returns a list of email objects, each contai

Gets webhook secret given the webhook uuid and admin keycloak user id

Extract workspace name from Jira webhook payload. This method is used by the route for signature verification.

Grant the instance-level super-admin role to an existing user. Sets ``user.role_id`` to the ``admin`` role row. Idempotent: if the us

Whether the caller has GenericContribute (write) on the repo. Fails closed: missing ids or any error returns False.

Check if an email address contains a + modifier. Args: email: The email address to check Returns: True if email contains + b

Hash email using SHA256-HMAC for Account Defender. Args: email: The user's email address. Returns: Hex-encod

Create and store the module-level AnalyticsService singleton. Returns the newly created instance. Subsequent calls to :func:`get_analytics_se

Initialize a new conversation and return the conversation ID. This method resolves the target organization and generates a new conver

True when the sandbox spec differs from the bundled release default (e.g. a custom image registered via runtime-api). The bundled spec always matc

Check if the device code is still pending authorization.

Check if a PR is still active (not closed/merged). Args: repository: Repository name in format 'owner/repo' pr_number

Check if a name is valid for use as an environment variable.

Handle Jira webhook events.

Load a GitHub App installation token. Args: installation_id: GitHub installation ID (integer or string) Returns:

Convert markdown text to Jira Wiki Markup format. This function handles common markdown elements and converts them to their Jira Wiki Mar

Whether composed marketplaces are sent to the agent-server at conversation start so their ``auto_load`` plugins are loaded. Enabled by defaul

Calculate the normalized Longest Common Subsequence (LCS) to compare file chunk with the query (e.g. edit draft). We normalize Longest Common Sub

Record a successful login for a user.

Remove a user from an organization.

Resolve the ``base_url`` to persist for an LLM configuration. Single source of truth for two code paths that otherwise duplicated the same lo

Search models with optional filtering and pagination. Args: query: Case-insensitive substring match on the model name.

Whether defaults should point directly at an OpenAI-compatible endpoint.

Store a GitHub App installation token. Args: installation_id: GitHub installation ID (integer or string) installation

Update organization details from a validated OrgUpdate payload.

Update organization app settings. Only updates fields that are explicitly provided in update_data. User ID is obtained from the injec

Backward-compatible wrapper for org-defaults updates.

Update user app settings. Only updates fields that are explicitly provided in update_data. User ID is obtained from the injected user

Update an existing verified model. Args: model_name: The model name to update provider: The provider name

Update a webhook entry based on project_id or group_id. Args: webhook: GitlabWebhook object containing the updated fields and eit

Update an existing Jira workspace with encrypted sensitive data.

Validate that a name is valid for use as an environment variable. Raises: ValueError: If the name is invalid.