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

# Update Agent



## OpenAPI

````yaml PATCH /api/cloud/agents/{id}/
openapi: 3.0.3
info:
  title: Bedrock API
  version: 1.0.0
  description: API for managing agent templates, agents, organizations, and adapter state
servers: []
security: []
paths:
  /api/cloud/agents/{id}/:
    patch:
      tags:
        - cloud
      operationId: cloud_agents_partial_update
      parameters:
        - in: path
          name: id
          schema:
            type: string
            format: uuid
          description: A UUID string identifying this Agent.
          required: true
      requestBody:
        content:
          application/json:
            schema:
              $ref: '#/components/schemas/PatchedAgentRequest'
          application/x-www-form-urlencoded:
            schema:
              $ref: '#/components/schemas/PatchedAgentRequest'
          multipart/form-data:
            schema:
              $ref: '#/components/schemas/PatchedAgentRequest'
      responses:
        '200':
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/Agent'
          description: ''
      security:
        - tokenAuth: []
        - APIKeyAuth: []
        - ApiKeyAuth: []
components:
  schemas:
    PatchedAgentRequest:
      type: object
      properties:
        adapters:
          type: array
          items:
            type: string
            format: uuid
        template:
          type: string
          format: uuid
          nullable: true
        tags:
          type: array
          items:
            type: string
            minLength: 1
            maxLength: 255
        name:
          type: string
          minLength: 1
          maxLength: 255
        model:
          type: string
          minLength: 1
          maxLength: 255
        timezone:
          type: string
          minLength: 1
          maxLength: 255
        system_prompt:
          type: string
        sleep_until:
          type: string
          format: date-time
          nullable: true
        email_alias:
          type: string
          nullable: true
          description: >-
            Custom email alias for the agent's AgentMail inbox (e.g. 'support'
            becomes support@domain)
          maxLength: 255
        status:
          $ref: '#/components/schemas/AgentStatusEnum'
        run_started_at:
          type: string
          format: date-time
          nullable: true
        last_wake_reason:
          type: string
          maxLength: 64
        last_wake_interrupted_sleep_until:
          type: string
          format: date-time
          nullable: true
        max_turns:
          type: integer
          maximum: 2147483647
          minimum: -2147483648
        max_sleep_hours:
          type: integer
          maximum: 2147483647
          minimum: 0
          nullable: true
          description: >-
            Optional cap on how long the agent may sleep, in hours. When set,
            each harness run is started with --max-utc-sleep = now + this many
            hours, and sleep requests past that moment are clamped.
        harness_git_ref:
          type: string
          nullable: true
          description: >-
            Optional git ref (branch/tag/commit) for harness runs. Null = latest
            main at dispatch time.
          maxLength: 255
        reasoning_effort:
          oneOf:
            - $ref: '#/components/schemas/OpenRouterReasoningEffortEnum'
            - $ref: '#/components/schemas/BlankEnum'
        debounce_window_seconds:
          type: integer
          maximum: 2147483647
          minimum: 0
          nullable: true
          description: >-
            Per-agent override for the turn-boundary debounce window (seconds).
            Leave blank to inherit from the template.
        vapi_voice_id:
          type: string
          description: >-
            Unused: VAPI calls now use the gpt-realtime-2 model, which only
            supports a fixed set of OpenAI voices and doesn't support per-agent
            voice overrides. This field has no effect on call behavior.
          maxLength: 255
        purpose:
          $ref: '#/components/schemas/PurposeEnum'
        parent:
          type: string
          format: uuid
          nullable: true
    Agent:
      type: object
      properties:
        id:
          type: string
          format: uuid
          readOnly: true
        adapters:
          type: array
          items:
            type: string
            format: uuid
        organization:
          type: string
          format: uuid
          readOnly: true
        template:
          type: string
          format: uuid
          nullable: true
        parent_name:
          type: string
          readOnly: true
        template_name:
          type: string
          nullable: true
          readOnly: true
        tags:
          type: array
          items:
            type: string
            maxLength: 255
        name:
          type: string
          maxLength: 255
        model:
          type: string
          maxLength: 255
        created_at:
          type: string
          format: date-time
          readOnly: true
        timezone:
          type: string
          maxLength: 255
        system_prompt:
          type: string
        sleep_until:
          type: string
          format: date-time
          nullable: true
        email_alias:
          type: string
          nullable: true
          description: >-
            Custom email alias for the agent's AgentMail inbox (e.g. 'support'
            becomes support@domain)
          maxLength: 255
        status:
          $ref: '#/components/schemas/AgentStatusEnum'
        run_started_at:
          type: string
          format: date-time
          nullable: true
        last_wake_reason:
          type: string
          maxLength: 64
        last_wake_interrupted_sleep_until:
          type: string
          format: date-time
          nullable: true
        max_turns:
          type: integer
          maximum: 2147483647
          minimum: -2147483648
        max_sleep_hours:
          type: integer
          maximum: 2147483647
          minimum: 0
          nullable: true
          description: >-
            Optional cap on how long the agent may sleep, in hours. When set,
            each harness run is started with --max-utc-sleep = now + this many
            hours, and sleep requests past that moment are clamped.
        harness_git_ref:
          type: string
          nullable: true
          description: >-
            Optional git ref (branch/tag/commit) for harness runs. Null = latest
            main at dispatch time.
          maxLength: 255
        reasoning_effort:
          oneOf:
            - $ref: '#/components/schemas/OpenRouterReasoningEffortEnum'
            - $ref: '#/components/schemas/BlankEnum'
        debounce_window_seconds:
          type: integer
          maximum: 2147483647
          minimum: 0
          nullable: true
          description: >-
            Per-agent override for the turn-boundary debounce window (seconds).
            Leave blank to inherit from the template.
        vapi_voice_id:
          type: string
          description: >-
            Unused: VAPI calls now use the gpt-realtime-2 model, which only
            supports a fixed set of OpenAI voices and doesn't support per-agent
            voice overrides. This field has no effect on call behavior.
          maxLength: 255
        purpose:
          $ref: '#/components/schemas/PurposeEnum'
        parent:
          type: string
          format: uuid
          nullable: true
      required:
        - created_at
        - id
        - model
        - name
        - organization
        - parent_name
        - template_name
    AgentStatusEnum:
      enum:
        - running
        - sleeping
        - archived
      type: string
      description: |-
        * `running` - Running
        * `sleeping` - Sleeping
        * `archived` - Archived
    OpenRouterReasoningEffortEnum:
      enum:
        - none
        - minimal
        - low
        - medium
        - high
        - xhigh
      type: string
      description: |-
        * `none` - None
        * `minimal` - Minimal
        * `low` - Low
        * `medium` - Medium
        * `high` - High
        * `xhigh` - Extra high
    BlankEnum:
      enum:
        - ''
    PurposeEnum:
      enum:
        - production
        - eval
        - dev
      type: string
      description: |-
        * `production` - Production
        * `eval` - Eval
        * `dev` - Dev
  securitySchemes:
    tokenAuth:
      type: apiKey
      in: header
      name: Authorization
      description: Token-based authentication with required prefix "Token"
    APIKeyAuth:
      type: http
      scheme: bearer
      bearerFormat: API Key

````