> ## 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.

# Accept a complete native task interpretation

> Checks accounted current intent and association answers, whole-message multiplicity, pinned item digests and native source spans. Accepts every item in one transaction. Conversation never creates a task; independent new work joins the existing FIFO admission path. Existing PR targets require exact human assignment, reviewed workflows and current grants.



## OpenAPI

````yaml https://raw.githubusercontent.com/agentsfleet/agentsfleet/main/public/openapi.json post /v1/runners/me/leases/{lease_id}/tasks/bindings
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/bindings:
    post:
      tags:
        - Runners
      summary: Accept a complete native task interpretation
      description: >-
        Checks accounted current intent and association answers, whole-message
        multiplicity, pinned item digests and native source spans. Accepts every
        item in one transaction. Conversation never creates a task; independent
        new work joins the existing FIFO admission path. Existing PR targets
        require exact human assignment, reviewed workflows and current grants.
      operationId: runner_accept_task_bindings
      parameters:
        - name: lease_id
          in: path
          description: Current lease UUIDv7.
          required: true
          schema:
            type: string
      requestBody:
        content:
          application/json:
            schema:
              $ref: '#/components/schemas/TaskBindingsInput'
        required: true
      responses:
        '200':
          description: Immutable interpretation replay
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/TaskBindingsResponse'
        '201':
          description: Complete interpretation accepted
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/TaskBindingsResponse'
        '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'
        '413':
          description: The request body exceeds this endpoint's size limit
          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:
    TaskBindingsInput:
      type: object
      description: >-
        Atomically accept the complete bounded interpretation of one admitted
        input.
      required:
        - fencing_token
        - source_admission_id
        - accepted_revision_id
        - plan_digest
        - message_decision_call_id
        - items
      properties:
        accepted_revision_id:
          type: string
          description: Reviewed setup used for the message's questions and new objectives.
        fencing_token:
          type: integer
          format: int64
          description: Current slot fence.
          minimum: 0
        items:
          type: array
          items:
            $ref: '#/components/schemas/TaskBindingItem'
          description: The complete interpretation; no prefix can be partially accepted.
        message_decision_call_id:
          type: string
          description: Paid, accounted, current complete-message routing decision.
        plan_digest:
          type: string
          description: SHA-256 of `interpretation()`, computed independently by the daemon.
        source_admission_id:
          type: string
          description: >-
            Complete native source admission; queued human claims use this same
            ID.
      additionalProperties: false
    TaskBindingsResponse:
      type: object
      description: Complete message receipt, stable across lost acknowledgements.
      required:
        - items
        - replayed
      properties:
        current_task:
          oneOf:
            - $ref: '#/components/schemas/TaskContext'
              description: >-
                Current lease objective after binding, with native target and
                recovery state.
            - type: 'null'
        execution_deadline:
          type:
            - string
            - 'null'
          format: date-time
          description: Current lease's immutable ceiling after native task binding.
        items:
          type: array
          items:
            $ref: '#/components/schemas/TaskItemBinding'
          description: Accepted immutable items in their original order.
        replayed:
          type: boolean
          description: True when no new item, task, input or continuation was allocated.
    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.
    TaskBindingItem:
      type: object
      description: >-
        One action and its separate decision proof when decomposition is
        required.
      required:
        - proposed
      properties:
        decision_call_id:
          type:
            - string
            - 'null'
          description: >-
            Omit only for a single request already covered by the message
            decision.
        proposed:
          $ref: '#/components/schemas/TaskProposedItem'
          description: Complete item whose meaning was pinned before classification.
      additionalProperties: false
    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.
    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.
    TaskProposedItem:
      type: object
      description: Model-proposed meaning; its digest is frozen before item decision calls.
      required:
        - source_start
        - source_end
        - action
        - title
        - interpretation
      properties:
        action:
          $ref: '#/components/schemas/TaskInputAction'
          description: >-
            One proposed route, subject to the recorded configured decision
            model.
        interpretation:
          type: string
          description: Bounded explanation retained in the native interpretation receipt.
        source_end:
          type: integer
          format: int32
          description: >-
            Exclusive byte offset; native code checks UTF-8 boundaries and
            non-overlap.
        source_start:
          type: integer
          format: int32
          description: Inclusive byte offset in the complete original human message.
        target:
          oneOf:
            - $ref: '#/components/schemas/TaskRequestedTarget'
              description: Required for new work; not an authority token.
            - type: 'null'
        task_id:
          type:
            - string
            - 'null'
          description: Existing same-fleet task, when the item concerns prior work.
        title:
          type: string
          description: >-
            Compact label; the accepted objective remains the original source
            text.
      additionalProperties: false
    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
    TaskInputAction:
      type: string
      description: A closed routing answer; criteria remain authored in the accepted setup.
      enum:
        - conversation
        - status
        - refresh
        - steer
        - new_work
        - clarify
    TaskRequestedTarget:
      oneOf:
        - type: object
          description: API-only work has no mandatory repository checkout or GitHub grant.
          required:
            - kind
          properties:
            kind:
              type: string
              enum:
                - api_only
        - type: object
          description: >-
            Existing-PR work must name an exact human-assigned same-repository
            PR.
          required:
            - repository
            - number
            - kind
          properties:
            kind:
              type: string
              enum:
                - existing_pr
            number:
              type: integer
              format: int32
              description: Exact open PR requested by the person.
              minimum: 0
            repository:
              type: string
              description: Repository inside both accepted setup and current grant ceiling.
      description: >-
        Requested target; the daemon resolves its authority and exact remote
        identity.
    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.