> ## Documentation Index
> Fetch the complete documentation index at: https://docs.openhands.dev/llms.txt
> Use this file to discover all available pages before exploring further.

# Batch Get App Conversation Start Tasks

> Get a batch of start app conversation tasks given their ids. Return None for any missing.



## OpenAPI

````yaml /openapi/openhands-cloud.json get /api/v1/app-conversations/start-tasks
openapi: 3.1.0
info:
  title: OpenHands
  description: 'OpenHands: Code Less, Make More'
  version: 0.0.1
servers: []
security: []
paths:
  /api/v1/app-conversations/start-tasks:
    get:
      tags:
        - Conversations
      summary: Batch Get App Conversation Start Tasks
      description: >-
        Get a batch of start app conversation tasks given their ids. Return None
        for any missing.
      operationId: >-
        batch_get_app_conversation_start_tasks_api_v1_app_conversations_start_tasks_get
      parameters:
        - name: ids
          in: query
          required: true
          schema:
            type: array
            items:
              type: string
              format: uuid
            title: Ids
      responses:
        '200':
          description: Successful Response
          content:
            application/json:
              schema:
                type: array
                items:
                  anyOf:
                    - $ref: '#/components/schemas/AppConversationStartTask'
                    - type: 'null'
                title: >-
                  Response Batch Get App Conversation Start Tasks Api V1 App
                  Conversations Start Tasks Get
        '422':
          description: Validation Error
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/HTTPValidationError'
      security:
        - APIKeyHeader: []
components:
  schemas:
    AppConversationStartTask:
      properties:
        id:
          type: string
          title: Id
        created_by_user_id:
          anyOf:
            - type: string
            - type: 'null'
          title: Created By User Id
        status:
          $ref: '#/components/schemas/AppConversationStartTaskStatus'
          default: WORKING
        detail:
          anyOf:
            - type: string
            - type: 'null'
          title: Detail
        app_conversation_id:
          anyOf:
            - type: string
            - type: 'null'
          title: App Conversation Id
          description: The id of the app_conversation, if READY
        sandbox_id:
          anyOf:
            - type: string
            - type: 'null'
          title: Sandbox Id
          description: The id of the sandbox, if READY
        agent_server_url:
          anyOf:
            - type: string
            - type: 'null'
          title: Agent Server Url
          description: The agent server url, if READY
        request:
          $ref: '#/components/schemas/AppConversationStartRequest-Output'
        created_at:
          type: string
          format: date-time
          title: Created At
        updated_at:
          type: string
          format: date-time
          title: Updated At
      type: object
      required:
        - created_by_user_id
        - request
      title: AppConversationStartTask
      description: >-
        Object describing the start process for an app conversation.


        Because starting an app conversation can be slow (And can involve
        starting a sandbox),

        we kick off a background task for it. Once the conversation is started,
        the app_conversation_id

        is populated.
    HTTPValidationError:
      properties:
        detail:
          items:
            $ref: '#/components/schemas/ValidationError'
          type: array
          title: Detail
      type: object
      title: HTTPValidationError
    AppConversationStartTaskStatus:
      type: string
      enum:
        - WORKING
        - WAITING_FOR_SANDBOX
        - PREPARING_REPOSITORY
        - RUNNING_SETUP_SCRIPT
        - SETTING_UP_GIT_HOOKS
        - SETTING_UP_SKILLS
        - STARTING_CONVERSATION
        - READY
        - ERROR
      title: AppConversationStartTaskStatus
    AppConversationStartRequest-Output:
      properties:
        sandbox_id:
          anyOf:
            - type: string
            - type: 'null'
          title: Sandbox Id
        conversation_id:
          anyOf:
            - type: string
              format: uuid
            - type: 'null'
          title: Conversation Id
        initial_message:
          anyOf:
            - $ref: '#/components/schemas/SendMessageRequest'
            - type: 'null'
        system_message_suffix:
          anyOf:
            - type: string
            - type: 'null'
          title: System Message Suffix
        processors:
          anyOf:
            - items:
                $ref: '#/components/schemas/EventCallbackProcessor-Output'
              type: array
            - type: 'null'
          title: Processors
        llm_model:
          anyOf:
            - type: string
            - type: 'null'
          title: Llm Model
        agent_profile_id:
          anyOf:
            - type: string
            - type: 'null'
          title: Agent Profile Id
        selected_repository:
          anyOf:
            - type: string
            - type: 'null'
          title: Selected Repository
        selected_branch:
          anyOf:
            - type: string
            - type: 'null'
          title: Selected Branch
        git_provider:
          anyOf:
            - $ref: '#/components/schemas/ProviderType'
            - type: 'null'
        suggested_task:
          anyOf:
            - $ref: '#/components/schemas/SuggestedTask'
            - type: 'null'
        title:
          anyOf:
            - type: string
            - type: 'null'
          title: Title
        trigger:
          anyOf:
            - $ref: '#/components/schemas/ConversationTrigger'
            - type: 'null'
        pr_number:
          items:
            type: integer
          type: array
          title: Pr Number
        parent_conversation_id:
          anyOf:
            - type: string
            - type: 'null'
          title: Parent Conversation Id
        agent_type:
          $ref: '#/components/schemas/AgentType'
          default: default
        public:
          anyOf:
            - type: boolean
            - type: 'null'
          title: Public
        observability_metadata:
          anyOf:
            - additionalProperties:
                $ref: '#/components/schemas/TraceMetadataValue'
              type: object
            - type: 'null'
          title: Observability Metadata
          description: >-
            Trace-level metadata to attach to observability backends. Values
            must be scalars or homogeneous scalar lists supported by
            OpenTelemetry.
        observability_tags:
          anyOf:
            - items:
                type: string
              type: array
            - type: 'null'
          title: Observability Tags
          description: Tags to attach to the conversation root observability span.
        observability_span_name:
          anyOf:
            - type: string
            - type: 'null'
          title: Observability Span Name
          description: >-
            Optional named child span to emit under the conversation root. Use
            stable, low-cardinality names because observability backends may use
            span names for grouping or signal routing.
        plugins:
          anyOf:
            - items:
                $ref: '#/components/schemas/PluginSpec'
              type: array
            - type: 'null'
          title: Plugins
          description: >-
            List of plugins to load for this conversation. Plugins are loaded
            and their skills/MCP config are merged into the agent.
        secrets:
          anyOf:
            - additionalProperties:
                type: string
                format: password
                writeOnly: true
              type: object
            - type: 'null'
          title: Secrets
          description: >-
            Secrets to pass to the conversation. These are merged with any
            existing secrets (from database or git providers), with API-provided
            secrets taking precedence (overriding any existing secret with the
            same name). Keys are secret names (e.g., "MY_API_KEY"), values are
            the secret values. Warning: Providing a secret that already exists
            will silently override it.
      type: object
      title: AppConversationStartRequest
      description: >-
        Start conversation request object.


        Although a user can go directly to the sandbox and start conversations,
        they

        would need to manually supply required startup parameters such as LLM
        key. Starting

        from the app server copies these from the user info.
    ValidationError:
      properties:
        loc:
          items:
            anyOf:
              - type: string
              - type: integer
          type: array
          title: Location
        msg:
          type: string
          title: Message
        type:
          type: string
          title: Error Type
        input:
          title: Input
        ctx:
          type: object
          title: Context
      type: object
      required:
        - loc
        - msg
        - type
      title: ValidationError
    SendMessageRequest:
      properties:
        role:
          type: string
          enum:
            - user
            - system
            - assistant
            - tool
          title: Role
          default: user
        content:
          items:
            anyOf:
              - $ref: '#/components/schemas/TextContent'
              - $ref: '#/components/schemas/ImageContent'
          type: array
          title: Content
        run:
          type: boolean
          title: Run
          description: Whether the agent loop should automatically run if not running
          default: false
      type: object
      title: SendMessageRequest
      description: Payload to send a message to the agent.
    EventCallbackProcessor-Output:
      oneOf:
        - $ref: '#/components/schemas/BitbucketV1CallbackProcessor-Output'
        - $ref: '#/components/schemas/GithubV1CallbackProcessor-Output'
        - $ref: '#/components/schemas/GitlabV1CallbackProcessor-Output'
        - $ref: '#/components/schemas/JiraV1CallbackProcessor-Output'
        - $ref: '#/components/schemas/JiraDcV1CallbackProcessor-Output'
        - $ref: '#/components/schemas/SlackV1CallbackProcessor-Output'
        - $ref: '#/components/schemas/LoggingCallbackProcessor-Output'
        - $ref: '#/components/schemas/SetTitleCallbackProcessor-Output'
      discriminator:
        propertyName: kind
        mapping:
          integrations__bitbucket__bitbucket_v1_callback_processor__BitbucketV1CallbackProcessor-Output__1:
            $ref: '#/components/schemas/BitbucketV1CallbackProcessor-Output'
          integrations__github__github_v1_callback_processor__GithubV1CallbackProcessor-Output__1:
            $ref: '#/components/schemas/GithubV1CallbackProcessor-Output'
          integrations__gitlab__gitlab_v1_callback_processor__GitlabV1CallbackProcessor-Output__1:
            $ref: '#/components/schemas/GitlabV1CallbackProcessor-Output'
          integrations__jira__jira_v1_callback_processor__JiraV1CallbackProcessor-Output__1:
            $ref: '#/components/schemas/JiraV1CallbackProcessor-Output'
          integrations__jira_dc__jira_dc_v1_callback_processor__JiraDcV1CallbackProcessor-Output__1:
            $ref: '#/components/schemas/JiraDcV1CallbackProcessor-Output'
          integrations__slack__slack_v1_callback_processor__SlackV1CallbackProcessor-Output__1:
            $ref: '#/components/schemas/SlackV1CallbackProcessor-Output'
          openhands__app_server__event_callback__event_callback_models__LoggingCallbackProcessor-Output__1:
            $ref: '#/components/schemas/LoggingCallbackProcessor-Output'
          openhands__app_server__event_callback__set_title_callback_processor__SetTitleCallbackProcessor-Output__1:
            $ref: '#/components/schemas/SetTitleCallbackProcessor-Output'
    ProviderType:
      type: string
      enum:
        - github
        - gitlab
        - bitbucket
        - bitbucket_data_center
        - forgejo
        - azure_devops
        - enterprise_sso
      title: ProviderType
    SuggestedTask:
      properties:
        git_provider:
          $ref: '#/components/schemas/ProviderType'
        task_type:
          $ref: '#/components/schemas/TaskType'
        repo:
          type: string
          title: Repo
        issue_number:
          type: integer
          title: Issue Number
        title:
          type: string
          title: Title
      type: object
      required:
        - git_provider
        - task_type
        - repo
        - issue_number
        - title
      title: SuggestedTask
    ConversationTrigger:
      type: string
      enum:
        - resolver
        - gui
        - suggested_task
        - openhands_api
        - slack
        - microagent_management
        - jira
        - jira_dc
        - linear
        - bitbucket
        - automation
      title: ConversationTrigger
    AgentType:
      type: string
      enum:
        - default
        - plan
      title: AgentType
      description: Agent type for conversation.
    TraceMetadataValue:
      anyOf:
        - type: string
        - type: boolean
        - type: integer
        - type: number
        - items:
            type: string
          type: array
        - items:
            type: boolean
          type: array
        - items:
            type: integer
          type: array
        - items:
            type: number
          type: array
    PluginSpec:
      properties:
        source:
          type: string
          title: Source
          description: 'Plugin source: ''github:owner/repo'', any git URL, or local path'
        ref:
          anyOf:
            - type: string
            - type: 'null'
          title: Ref
          description: Optional branch, tag, or commit (only for git sources)
        repo_path:
          anyOf:
            - type: string
            - type: 'null'
          title: Repo Path
          description: >-
            Subdirectory path within the git repository (e.g.,
            'plugins/my-plugin' for monorepos). Only relevant for git sources,
            not local paths.
        parameters:
          anyOf:
            - additionalProperties: true
              type: object
            - type: 'null'
          title: Parameters
          description: User-provided values for plugin input parameters
      type: object
      required:
        - source
      title: PluginSpec
      description: >-
        Specification for loading a plugin into a conversation.


        Extends SDK's PluginSource with user-provided plugin configuration
        parameters.

        Inherits source, ref, and repo_path fields along with their validation.
    TextContent:
      properties:
        cache_prompt:
          type: boolean
          title: Cache Prompt
          default: false
        type:
          type: string
          const: text
          title: Type
          default: text
        text:
          type: string
          title: Text
      additionalProperties: false
      type: object
      required:
        - text
      title: TextContent
    ImageContent:
      properties:
        cache_prompt:
          type: boolean
          title: Cache Prompt
          default: false
        type:
          type: string
          const: image
          title: Type
          default: image
        image_urls:
          items:
            type: string
          type: array
          title: Image Urls
      type: object
      required:
        - image_urls
      title: ImageContent
    BitbucketV1CallbackProcessor-Output:
      properties:
        bitbucket_view_data:
          additionalProperties: true
          type: object
          title: Bitbucket View Data
        should_request_summary:
          type: boolean
          title: Should Request Summary
          default: true
        kind:
          type: string
          const: BitbucketV1CallbackProcessor
          title: Kind
      type: object
      required:
        - kind
      title: BitbucketV1CallbackProcessor
      description: |-
        V1 callback processor for the Bitbucket Cloud resolver.

        Posts a summary comment back to the originating PR when the agent
        finishes successfully. Mirrors :class:`GitlabV1CallbackProcessor`.
    GithubV1CallbackProcessor-Output:
      properties:
        github_view_data:
          additionalProperties: true
          type: object
          title: Github View Data
        should_request_summary:
          type: boolean
          title: Should Request Summary
          default: true
        inline_pr_comment:
          type: boolean
          title: Inline Pr Comment
          default: false
        kind:
          type: string
          const: GithubV1CallbackProcessor
          title: Kind
      type: object
      required:
        - kind
      title: GithubV1CallbackProcessor
      description: Callback processor for GitHub V1 integrations.
    GitlabV1CallbackProcessor-Output:
      properties:
        gitlab_view_data:
          additionalProperties: true
          type: object
          title: Gitlab View Data
        should_request_summary:
          type: boolean
          title: Should Request Summary
          default: true
        inline_mr_comment:
          type: boolean
          title: Inline Mr Comment
          default: false
        kind:
          type: string
          const: GitlabV1CallbackProcessor
          title: Kind
      type: object
      required:
        - kind
      title: GitlabV1CallbackProcessor
      description: Callback processor for GitLab V1 integrations.
    JiraV1CallbackProcessor-Output:
      properties:
        should_request_summary:
          type: boolean
          title: Should Request Summary
          default: true
        svc_acc_email:
          type: string
          title: Svc Acc Email
        decrypted_api_key:
          type: string
          title: Decrypted Api Key
        issue_key:
          type: string
          title: Issue Key
        jira_cloud_id:
          type: string
          title: Jira Cloud Id
        kind:
          type: string
          const: JiraV1CallbackProcessor
          title: Kind
      type: object
      required:
        - svc_acc_email
        - decrypted_api_key
        - issue_key
        - jira_cloud_id
        - kind
      title: JiraV1CallbackProcessor
      description: Callback processor for Jira V1 integrations.
    JiraDcV1CallbackProcessor-Output:
      properties:
        should_request_summary:
          type: boolean
          title: Should Request Summary
          default: true
        issue_key:
          type: string
          title: Issue Key
        workspace_name:
          type: string
          title: Workspace Name
        base_api_url:
          type: string
          title: Base Api Url
        kind:
          type: string
          const: JiraDcV1CallbackProcessor
          title: Kind
      type: object
      required:
        - issue_key
        - workspace_name
        - base_api_url
        - kind
      title: JiraDcV1CallbackProcessor
      description: Callback processor for Jira Data Center V1 integrations.
    SlackV1CallbackProcessor-Output:
      properties:
        slack_view_data:
          additionalProperties:
            anyOf:
              - type: string
              - type: 'null'
          type: object
          title: Slack View Data
        kind:
          type: string
          const: SlackV1CallbackProcessor
          title: Kind
      type: object
      required:
        - kind
      title: SlackV1CallbackProcessor
      description: Callback processor for Slack V1 integrations.
    LoggingCallbackProcessor-Output:
      properties:
        kind:
          type: string
          const: LoggingCallbackProcessor
          title: Kind
      type: object
      required:
        - kind
      title: LoggingCallbackProcessor
      description: Example implementation which logs callbacks.
    SetTitleCallbackProcessor-Output:
      properties:
        kind:
          type: string
          const: SetTitleCallbackProcessor
          title: Kind
      type: object
      required:
        - kind
      title: SetTitleCallbackProcessor
      description: Callback processor which sets conversation titles.
    TaskType:
      type: string
      enum:
        - MERGE_CONFLICTS
        - FAILING_CHECKS
        - UNRESOLVED_COMMENTS
        - OPEN_ISSUE
        - OPEN_PR
      title: TaskType
  securitySchemes:
    APIKeyHeader:
      type: apiKey
      in: header
      name: X-Access-Token

````