Create a new Jira DC workspace registration. Setting up the instance connection (server, service account, webhook) is an admin/owner action;

Recursively merge *updates* into a shallow copy of *base*. * Nested dicts are merged recursively. * ``None`` values in *updates* remove the c

Generate default encryption keys obtain these from previously saved values and environment variables.

Get paginated financial data for organization members. Fetches member list from database and joins with financial data from LiteLLM.

Remove a member from an organization. Only owners and admins can remove members: - Owners can remove admins and regular users - Admins ca

Switch ``agent_settings.llm`` to a saved profile. Raises :class:`ProfileNotFoundError` if ``name`` isn't a saved profile.

Validate an API key and return the associated user_id and org_id if valid. A key is valid only when ``not_before <= now < expires_at``. Both

Validate the entire secrets dictionary for size limits. This should be called before iterating over individual secrets. Args: secret

Validate an ``X-Session-API-Key`` and return the associated sandbox. Security: This function enforces that session API keys are only vali

Create a mock AppConversationService for testing.

Build a DataSettings with diff-only nested settings payloads.

Create an async_sessionmaker that points at the test SQLite engine.

Create an async session maker for testing.

Clone or initialize a git repository. This is a simplified version of the actual method for testing purposes.

Compose marketplaces from the three scopes, keyed on ``name``. Precedence is Instance < Org < User for identity; org overrides an instance en

Count conversations matching the given filters with SAAS metadata.

Create a reCAPTCHA Enterprise assessment. Args: token: The reCAPTCHA token from the frontend. action: The expected ac

Create a new device code entry. Uses database constraints to ensure uniqueness, avoiding TOCTOU race conditions. Retries on constrain

Get a single conversation info, returning None if missing.

Instance-level default marketplaces from the environment. Instance defaults auto-load by default. Parsing/validation never raises: a bad valu

Get paginated list of organization members with user and role info. Args: org_id: Organization UUID. offset: Number o

Get all comments from all threads in a pull request. Retrieves all threads and extracts comments from them, converting to Comment objects.

Get the provider tokens for the current user.

Get paginated list of organizations for a user. Args: user_id: User UUID page_id: Optional page ID (offset as string)

Return True when the model uses the public OpenHands provider prefix.

Send a follow-up message to an existing conversation. This REST endpoint provides a simplified way to send messages to a running conversation

Kick off a job with openhands agent. Args: view: Integration-specific view object containing job context. Each

Switch the running conversation's LLM to a saved profile. Profiles live in the app-server's user settings, not on the sandbox FS, so we resol

Return True when ``selected_user_id`` is a workspace ``owner`` or ``collaborator`` on ``workspace`` — Bitbucket Cloud's workspace-leve

Configure git global user settings from user preferences. Reads git_user_name and git_user_email from user settings and configures th

Get configured OAuth providers from environment variables. Checks for presence of OAuth client ID env vars and returns a list of configured p

Handle the creation or reactivation of a workspace link for a user.

Create a mock AppConversation for testing.

Create a mock AppSendMessageRequest for testing.

Create a mock SandboxService for testing.

Parse repository string into organization, project, and repo name.

Patch ``get_sandbox_service`` in ``session_auth`` to return a mock service.

Send a request to the remote runtime API.

Set up secrets for all git provider authentication. Args: user: User information containing authentication details Retur

Shorthand for running a function in the default background thread pool executor and awaiting the result. The nature of synchronous code is that th

Create a mock FastAPI Request object with proper state.

Ensure conversation info exists, otherwise raise a clear error.

Extract base email from an email address. For emails with + modifier, extracts the base email (local part before + and @, plus domain). For e

Return the agent server URL from sandbox exposed URLs.

Get a path for a conversation. Ensure user_id is included if possible.

Get branches for a repository with pagination

Get the storage provider based on environment variables. Determines the storage provider from environment configuration: - SHARED_EVENT_STORA

Collect every model available to this server and return structured data. The returned ``ModelsResponse`` contains: * a flat list of ``provid

Get the user info. Defaults to the PERSISTED settings view. ``resolve_agent_profile=True`` opts into the effective launch view (the a

Determine if a job should be started based on the current context. This method checks: 1. If the view type allows immediate job s

Load ``AgentProfiles`` from the org row, defaulting to empty if unset. Degrades to an empty collection on schema drift rather than 500-ing — the

Handle external_select options loading (block_suggestion payload). This endpoint is called by Slack when a user interacts with an external_select

Apply pagination to a list of items. Args: items: Full list of items to paginate. page_id: Optional page token from previous requ

Rename a profile, preserving stored LLM config, insertion order, and the active flag (if the renamed profile was active). Raises :cla

Resolve the effective Jira DC service account for runtime API calls. KOTS/env values are authoritative when both are set. Otherwise the existing

Update the event callback given.

Get or search repositories. If query is provided, searches repositories across the git provider. If query is not provided, returns a paginate

Update shared settings for all members of an organization. Args: session: Database session (passed from caller for transaction)

Update an organization-member relationship.

Use a session api key for validation, and get a sandbox record. Subsequent actions are executed in the context of the owner of the sandbox