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

# Read pending human task input

> Returns up to four complete human messages from the current source conversation in native FIFO order, with current task summaries. Reads never claim or consume input. Requires the current runner, live lease and fence.



## OpenAPI

````yaml https://raw.githubusercontent.com/agentsfleet/agentsfleet/main/public/openapi.json get /v1/runners/me/leases/{lease_id}/tasks/inputs
openapi: 3.1.0
info:
  title: agentsfleet API
  description: API for managing workspaces, fleets, triggers, and runs.
  contact:
    name: agentsfleet
    url: https://agentsfleet.net
  license:
    name: MIT
    identifier: MIT
  version: 1.0.0
servers:
  - url: https://api.agentsfleet.net
    description: Production
security: []
paths:
  /v1/runners/me/leases/{lease_id}/tasks/inputs:
    get:
      tags:
        - Runners
      summary: Read pending human task input
      description: >-
        Returns up to four complete human messages from the current source
        conversation in native FIFO order, with current task summaries. Reads
        never claim or consume input. Requires the current runner, live lease
        and fence.
      operationId: runner_read_task_inputs
      parameters:
        - name: lease_id
          in: path
          description: Current lease UUIDv7.
          required: true
          schema:
            type: string
        - name: fencing_token
          in: path
          description: Current native lease fence.
          required: true
          schema:
            type: integer
            format: int64
            minimum: 0
        - name: starting_after
          in: path
          description: Opaque ascending boundary returned by the previous input page.
          required: true
          schema:
            type:
              - string
              - 'null'
        - name: after_input_sequence
          in: path
          description: >-
            Task-local position already present in this worker's
            recovered/current history.
          required: true
          schema:
            type:
              - integer
              - 'null'
            format: int64
            minimum: 0
        - name: limit
          in: path
          description: At most four complete messages per safe boundary.
          required: true
          schema:
            type: integer
            format: int32
            minimum: 0
      responses:
        '200':
          description: Complete pending input and native work
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/TaskInputsResponse'
        '400':
          description: The request is invalid
          content:
            application/problem+json:
              schema:
                $ref: '#/components/schemas/ProblemBody'
        '401':
          description: Authentication is missing, invalid, or not accepted by this endpoint
          content:
            application/problem+json:
              schema:
                $ref: '#/components/schemas/ProblemBody'
        '403':
          description: You do not have permission for this action
          content:
            application/problem+json:
              schema:
                $ref: '#/components/schemas/ProblemBody'
        '404':
          description: The resource was not found or is not accessible to you
          content:
            application/problem+json:
              schema:
                $ref: '#/components/schemas/ProblemBody'
        '409':
          description: The request conflicts with the resource's current state
          content:
            application/problem+json:
              schema:
                $ref: '#/components/schemas/ProblemBody'
        '429':
          description: A request or capacity limit has been reached
          content:
            application/problem+json:
              schema:
                $ref: '#/components/schemas/ProblemBody'
        '500':
          description: An internal server error occurred
          content:
            application/problem+json:
              schema:
                $ref: '#/components/schemas/ProblemBody'
        '503':
          description: A required service is unavailable
          content:
            application/problem+json:
              schema:
                $ref: '#/components/schemas/ProblemBody'
      security:
        - RunnerBearerAuth: []
components:
  schemas:
    TaskInputsResponse:
      type: object
      description: >-
        Complete bounded messages and eligible current work from the same lease
        scope.
      required:
        - source_admission_id
        - inputs
        - accepted_inputs
        - tasks
      properties:
        accepted_inputs:
          type: array
          items:
            $ref: '#/components/schemas/TaskAcceptedInput'
          description: >-
            Accepted meaning not yet incorporated by the current native task
            cursor.
        accepted_revision_id:
          type:
            - string
            - 'null'
          description: Installed revision under which a new human interpretation may bind.
        current_interpretation:
          oneOf:
            - $ref: '#/components/schemas/TaskAcceptedInterpretation'
              description: >-
                Current admission's complete saved meaning, including a
                conversation-only replay.
            - type: 'null'
        current_message:
          type:
            - string
            - 'null'
          description: >-
            Complete current human message, absent for native machine
            continuations.

            Its presence is established from native admission authority.
        current_task:
          oneOf:
            - $ref: '#/components/schemas/TaskContext'
              description: >-
                Current native objective and recovery pointer, including after
                interpretation replay.
            - type: 'null'
        execution_deadline:
          type:
            - string
            - 'null'
          format: date-time
          description: Immutable ceiling read with this lease's current native ownership.
        inputs:
          type: array
          items:
            $ref: '#/components/schemas/TaskHumanInput'
          description: Ascending native message order.
        next_cursor:
          type:
            - string
            - 'null'
          description: Absent when no next eligible input exists.
        source_admission_id:
          type: string
          description: >-
            Native admission owned by this lease, including signed continuation
            events.
        tasks:
          type: array
          items:
            $ref: '#/components/schemas/TaskInputCandidate'
          description: At most sixteen unfinished native objectives.
    ProblemBody:
      type: object
      description: The body every refusal carries, under `application/problem+json`.
      required:
        - docs_uri
        - title
        - detail
        - error_code
        - request_id
      properties:
        action_id:
          type:
            - string
            - 'null'
          description: 'On that 409 only: the action the gate held.'
        current_state:
          type:
            - string
            - 'null'
          description: 'On a 409 only: the state that forbade the transition.'
        detail:
          type: string
          description: One sentence on what was refused and why.
        docs_uri:
          type: string
          description: Where the error code is documented.
        error_code:
          type: string
          description: The registry code, stable across releases.
        etag:
          type:
            - string
            - 'null'
          description: >-
            On a 412 only: the resource's current entity tag, to refetch and
            retry.
        gate_id:
          type:
            - string
            - 'null'
          description: 'On an answered approval gate''s 409 only: the gate that was answered.'
        outcome:
          type:
            - string
            - 'null'
          description: 'On that 409 only: the answer that stands.'
        request_id:
          type: string
          description: The request this refusal answers, for support.
        resolved_at:
          type:
            - string
            - 'null'
          format: date-time
          description: 'On that 409 only: when the standing answer was given.'
        resolved_by:
          type:
            - string
            - 'null'
          description: 'On that 409 only: who gave it.'
        title:
          type: string
          description: A short name for the refusal, safe to show a person.
        user_message:
          type:
            - string
            - 'null'
          description: A curated sentence for end users, where the code has one.
    TaskAcceptedInput:
      type: object
      description: >-
        Recovery receipt for an acknowledged interpretation whose worker was
        lost.
      required:
        - source_admission_id
        - plan_digest
        - item_id
        - task
        - sequence
        - action
        - original_message
        - accepted_text
        - interpretation
        - applied
      properties:
        accepted_text:
          type: string
          description: Exact accepted source slice.
        action:
          $ref: '#/components/schemas/TaskInputAction'
          description: Accepted native action.
        applied:
          type: boolean
          description: >-
            Already incorporated natively; recovery restores meaning without
            applying it twice.
        interpretation:
          type: string
          description: Accepted interpretation, never recomputed after recovery.
        item_id:
          type: string
          description: Immutable interpreted item.
        original_message:
          type: string
          description: Complete original human message, preserving mixed-request context.
        plan_digest:
          type: string
          description: Immutable complete interpretation digest.
        response_text:
          type:
            - string
            - 'null'
          description: >-
            Confirmed original answer when available, independent of the lost
            local history.
        sequence:
          type: integer
          format: int64
          description: Strict task-local input order.
          minimum: 0
        source_admission_id:
          type: string
          description: Original native admission, retained even after queue settlement.
        task:
          $ref: '#/components/schemas/DecisionTaskVersion'
          description: Current task and generation that may apply this input.
    TaskAcceptedInterpretation:
      type: object
      description: >-
        Complete immutable source interpretation, retained independently of a
        worker.
      required:
        - source_admission_id
        - plan_digest
        - message
        - items
      properties:
        items:
          type: array
          items:
            $ref: '#/components/schemas/TaskRecoveredItem'
          description: Native item identities in the accepted original order.
        message:
          type: string
          description: Complete original human text.
        plan_digest:
          type: string
          description: Complete accepted plan digest.
        source_admission_id:
          type: string
          description: Original admitted source.
    TaskContext:
      type: object
      description: Context for a task-bound lease; ordinary leases omit this owner.
      required:
        - task_id
        - originating_item_id
        - target
        - generation
        - stop_generation
        - accepted_revision_id
        - objective
        - goal_digest
        - questions
        - state
        - covered_input_sequence
        - input_sequence
        - effect_cursor
        - confirmed_effect_watermark
        - expires_at
        - limits
        - usage
      properties:
        accepted_revision_id:
          type: string
          description: Fleet revision whose reviewed goal was accepted.
        checkpoint_generation:
          type:
            - integer
            - 'null'
          format: int64
          description: >-
            Last complete saved generation, distinct from allocated failed
            plans.
          minimum: 0
        checkpoint_id:
          type:
            - string
            - 'null'
          description: Compatible complete checkpoint, if one has been published.
        confirmed_effect_watermark:
          type: integer
          format: int64
          description: Last confirmed effect covered by the saved state.
          minimum: 0
        covered_input_sequence:
          type: integer
          format: int64
          description: Inputs whose meaning is included in the supplied state.
          minimum: 0
        effect_cursor:
          type: integer
          format: int64
          description: Native ordinal offered for the next immutable publication identity.
          minimum: 0
        expires_at:
          type: string
          format: date-time
          description: Existing wall deadline; waking does not extend it.
        generation:
          type: integer
          format: int64
          description: Generation the next semantic transition must assess.
          minimum: 0
        goal_digest:
          type: string
          description: Digest of the frozen objective and completion questions.
        input_sequence:
          type: integer
          format: int64
          description: >-
            Last accepted input; recovery must incorporate any gap before new
            effects.
          minimum: 0
        limits:
          $ref: '#/components/schemas/TaskLimits'
          description: Cumulative bounds, clamped by existing fleet/credit ceilings.
        objective:
          type: string
          description: Accepted objective, distinct from standing fleet instructions.
        originating_item_id:
          type: string
          description: Immutable source item required for attributable task effects.
        questions:
          type: array
          items:
            $ref: '#/components/schemas/NamedQuestion'
          description: >-
            Accepted questions with stable identities and complete reviewed
            criteria.
        state:
          $ref: '#/components/schemas/TaskState'
          description: Current durable state.
        stop_generation:
          type: integer
          format: int64
          description: Committed cutoff for new effects.
          minimum: 0
        target:
          $ref: '#/components/schemas/TaskTarget'
          description: >-
            Exact target selected by native admission, never changed by
            recovered notes.
        task_id:
          type: string
          description: Native task identity; never selected by a tool result.
        usage:
          $ref: '#/components/schemas/TaskUsage'
          description: Already consumed and reserved work.
    TaskHumanInput:
      type: object
      description: One complete saved human message; reading never consumes it.
      required:
        - source_admission_id
        - sequence
        - message
      properties:
        accepted:
          oneOf:
            - $ref: '#/components/schemas/TaskAcceptedInterpretation'
              description: >-
                Already accepted meaning; recovery must answer it without
                reclassification.
            - type: 'null'
        message:
          type: string
          description: Complete user text; never a truncated interpretation.
        sequence:
          type: integer
          format: int64
          description: Native FIFO position, independent of task-local input positions.
          minimum: 0
        source_admission_id:
          type: string
          description: Native source admission identity used for decision and consumption.
    TaskInputCandidate:
      type: object
      description: >-
        Trusted compact work offered for intent association without loading
        private evidence.
      required:
        - task_id
        - title
        - state
        - generation
      properties:
        generation:
          type: integer
          format: int64
          description: Current native generation, required for an accepted steer.
          minimum: 0
        state:
          $ref: '#/components/schemas/TaskState'
          description: Current durable state.
        task_id:
          type: string
          description: Native task identity.
        title:
          type: string
          description: User-facing compact objective name.
    TaskInputAction:
      type: string
      description: A closed routing answer; criteria remain authored in the accepted setup.
      enum:
        - conversation
        - status
        - refresh
        - steer
        - new_work
        - clarify
    DecisionTaskVersion:
      type: object
      description: Task identity and generation supplied from the native lease context.
      required:
        - task_id
        - generation
      properties:
        generation:
          type: integer
          format: int64
          description: >-
            Expected current task generation, without resetting cumulative
            usage.
          minimum: 0
        task_id:
          type: string
          description: >-
            The current lease's objective; not another task selected by model
            text.
      additionalProperties: false
    TaskRecoveredItem:
      type: object
      description: An accepted item and its already confirmed original reply, if any.
      required:
        - binding
        - accepted_text
        - interpretation
      properties:
        accepted_text:
          type: string
          description: Exact accepted byte slice.
        binding:
          $ref: '#/components/schemas/TaskItemBinding'
          description: Native current association; no new work is authorized by reading it.
        interpretation:
          type: string
          description: Immutable accepted interpretation.
        response_text:
          type:
            - string
            - 'null'
          description: >-
            Confirmed original response; absent means the item still needs an
            answer.
    TaskLimits:
      type: object
      description: Approved initial limits; a smaller existing fleet or credit limit wins.
      required:
        - model_nanos
        - wall_seconds
        - running_seconds
        - leases
        - publications
        - decision_calls
        - fallback_reads
      properties:
        decision_calls:
          type: integer
          format: int32
          description: Maximum physical decision calls, including retries.
          minimum: 0
        fallback_reads:
          type: integer
          format: int32
          description: Maximum fallback dependency reads; signed events remain separate.
          minimum: 0
        leases:
          type: integer
          format: int32
          description: Maximum distinct issued leases.
          minimum: 0
        model_nanos:
          $ref: '#/components/schemas/Nanos'
          description: Total paid-model allowance, in whole nanodollars.
        publications:
          type: integer
          format: int32
          description: Maximum physical repair publication attempts.
          minimum: 0
        running_seconds:
          type: integer
          format: int32
          description: Cumulative running time across all attempts.
          minimum: 0
        wall_seconds:
          type: integer
          format: int32
          description: Wall-clock lifetime including paused and waiting time.
          minimum: 0
      additionalProperties: false
    NamedQuestion:
      type: object
      description: Names are stable question identities, not model-generated output keys.
      required:
        - name
        - question
      properties:
        name:
          type: string
          description: Native question identity echoed by every adapter.
        question:
          $ref: '#/components/schemas/DecisionQuestion'
          description: Reviewed question representation.
      additionalProperties: false
    TaskState:
      type: string
      description: The durable objective's state, independent of its current admission.
      enum:
        - ready
        - running
        - waiting
        - blocked
        - paused
        - done
        - cancelled
        - exhausted
    TaskTarget:
      oneOf:
        - type: object
          description: >-
            Repository-free work cannot acquire a coding checkout by
            implication.
          required:
            - kind
          properties:
            kind:
              type: string
              enum:
                - api_only
        - type: object
          description: Explicitly accepted existing same-repository pull request.
          required:
            - repository
            - repository_id
            - number
            - branch
            - base
            - head
            - tree
            - url
            - workflows
            - kind
          properties:
            base:
              type: string
              description: Accepted base branch.
            branch:
              type: string
              description: Writable non-protected branch selected by native admission.
            head:
              type: string
              description: Latest native confirmed branch head.
            kind:
              type: string
              enum:
                - existing_pr
            number:
              type: integer
              format: int32
              description: Accepted pull request number.
              minimum: 0
            repository:
              type: string
              description: Canonical owner/name from GitHub, never a guessed repository.
            repository_id:
              type: integer
              format: int64
              description: Immutable native repository identity.
              minimum: 0
            tree:
              type: string
              description: Tree at that head.
            url:
              type: string
              description: Confirmed pull request link.
            workflows:
              type: array
              items:
                $ref: '#/components/schemas/TaskWorkflow'
              description: >-
                Owner-reviewed validation identities, never arbitrary workflow
                names.
      description: No repository is required for a repair performed only through APIs.
    TaskUsage:
      type: object
      description: Measured usage retained on the objective, including stopped attempts.
      required:
        - model_nanos
        - reserved_model_nanos
        - running_nanos
        - leases
        - publications
        - decision_calls
        - fallback_reads
      properties:
        decision_calls:
          type: integer
          format: int32
          description: Physical decision calls, including retries.
          minimum: 0
        fallback_reads:
          type: integer
          format: int32
          description: Fallback dependency reads already consumed.
          minimum: 0
        leases:
          type: integer
          format: int32
          description: Distinct issued leases.
          minimum: 0
        model_nanos:
          $ref: '#/components/schemas/Nanos'
          description: Measured paid-model cost, including coding and decision calls.
        publications:
          type: integer
          format: int32
          description: Physical publication attempts.
          minimum: 0
        reserved_model_nanos:
          $ref: '#/components/schemas/Nanos'
          description: Outstanding native model-call reservations.
        running_nanos:
          type: integer
          format: int64
          description: Cumulative measured running time, in nanoseconds.
          minimum: 0
      additionalProperties: false
    TaskItemBinding:
      type: object
      description: >-
        One accepted immutable action, with no invented task for conversational
        input.
      required:
        - item_id
        - action
        - applies_here
      properties:
        action:
          $ref: '#/components/schemas/TaskInputAction'
          description: Accepted routing meaning.
        applies_here:
          type: boolean
          description: >-
            Whether the current run may apply this input at its next safe
            boundary.
        input_sequence:
          type:
            - integer
            - 'null'
          format: int64
          description: Native FIFO cursor for an accepted existing-task input.
          minimum: 0
        item_id:
          type: string
          description: Native immutable item `UUIDv7`.
        task_generation:
          type:
            - integer
            - 'null'
          format: int64
          description: Current native generation, including a wake caused by this input.
          minimum: 0
        task_id:
          type:
            - string
            - 'null'
          description: Native objective, absent for conversation or clarification.
    Nanos:
      type: string
      description: A whole number of nanos (10⁻⁹ US dollars) as a decimal string.
      pattern: ^(0|[1-9][0-9]*)$
    DecisionQuestion:
      oneOf:
        - type: object
          description: True/false assessment with explicit criteria.
          required:
            - instructions
            - criteria
            - type
          properties:
            criteria:
              $ref: '#/components/schemas/NoulCriteria'
              description: Reviewed criteria for both answers.
            instructions:
              type: string
              description: The question to evaluate.
            type:
              type: string
              enum:
                - noul
        - type: object
          description: Choice among a complete fixed option set.
          required:
            - instructions
            - options
            - type
          properties:
            instructions:
              type: string
              description: The question to evaluate.
            options:
              type: array
              items:
                $ref: '#/components/schemas/ChoiceOption'
              description: >-
                Sixteen eligible tasks plus new-work and unclear fit without
                truncation.
            type:
              type: string
              enum:
                - choice
        - type: object
          description: Probability-weighted rating over an ordered rubric.
          required:
            - instructions
            - levels
            - type
          properties:
            instructions:
              type: string
              description: The question to evaluate.
            levels:
              type: array
              items:
                type: string
              description: Rubric from lowest to highest, with zero-based numeric levels.
            type:
              type: string
              enum:
                - score
      description: The typed question forms used for intent and goal evaluation.
    TaskWorkflow:
      type: object
      description: Frozen owner-reviewed validation identity.
      required:
        - id
        - path
        - digest
      properties:
        digest:
          type: string
          description: Owner-reviewed exact bytes.
        id:
          type: integer
          format: int64
          description: Native GitHub workflow identity.
          minimum: 0
        path:
          type: string
          description: Owner-reviewed path.
    NoulCriteria:
      type: object
      description: Accepted meanings of a true and false assessment.
      required:
        - 'true'
        - 'false'
      properties:
        'false':
          type: string
          description: Evidence supporting no.
        'true':
          type: string
          description: Evidence supporting yes.
      additionalProperties: false
    ChoiceOption:
      type: object
      description: One mutually exclusive choice with its reviewed meaning.
      required:
        - value
        - description
      properties:
        description:
          type: string
          description: Reviewed semantic meaning, never an authority grant.
        value:
          type: string
          description: >-
            Stable option identity, including native task identities when
            associating.
      additionalProperties: false
  securitySchemes:
    RunnerBearerAuth:
      type: http
      scheme: bearer
      bearerFormat: agt_r
      description: >-
        Runner token beginning with agt_r, returned once by POST
        /v1/admin/runners

````

This documentation is built and hosted on [Mintlify](https://mintlify.com), a developer documentation platform.