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

# Refresh authenticated host capabilities



## OpenAPI

````yaml /openapi/overlay-web.openapi.json put /api/v1/agent-environments/{environmentId}/capabilities
openapi: 3.0.3
info:
  title: Overlay Web API
  version: 1.0.0
  description: >-
    Generated from the overlay-web route boundary registry. This first-pass
    reference documents stable route inventory and request shapes.
servers:
  - url: https://getoverlay.io
    description: Hosted Overlay web app
  - url: http://localhost:3000
    description: Local development web app
security: []
tags:
  - name: Administration
  - name: Agent environments
  - name: Automations
  - name: Billing
  - name: Bootstrap
  - name: Chat
  - name: Conversations
  - name: Discovery
  - name: Files
  - name: Integrations
  - name: Knowledge
  - name: MCP Servers
  - name: Media
  - name: Memory
  - name: Model Providers
  - name: Models
  - name: Notes
  - name: Onboarding
  - name: Outputs
  - name: Projects
  - name: Settings
  - name: Skills
  - name: Tools
  - name: Webhooks
paths:
  /api/v1/agent-environments/{environmentId}/capabilities:
    put:
      tags:
        - Agent environments
      summary: Refresh authenticated host capabilities
      operationId: putAgentEnvironmentsEnvironmentIdCapabilities
      parameters:
        - name: environmentId
          in: path
          required: true
          schema:
            type: string
      requestBody:
        required: true
        content:
          application/json:
            schema:
              type: object
              properties:
                protocolVersion:
                  type: number
                  enum:
                    - 1
                hostVersion:
                  type: string
                  minLength: 1
                  maxLength: 100
                platform:
                  type: string
                  minLength: 1
                  maxLength: 200
                adapters:
                  type: array
                  items:
                    type: object
                    properties:
                      id:
                        type: string
                        minLength: 1
                        maxLength: 200
                      displayName:
                        type: string
                        minLength: 1
                        maxLength: 200
                      protocol:
                        type: string
                        enum:
                          - fake
                          - acp
                          - eve
                          - native
                      version:
                        type: string
                        minLength: 1
                        maxLength: 100
                      supports:
                        type: object
                        properties:
                          prompt:
                            type: boolean
                          approval:
                            type: boolean
                          cancel:
                            type: boolean
                          resume:
                            type: boolean
                        required:
                          - prompt
                          - approval
                          - cancel
                          - resume
                        additionalProperties: false
                    required:
                      - id
                      - displayName
                      - protocol
                      - supports
                    additionalProperties: false
                  maxItems: 100
                filesystem:
                  anyOf:
                    - type: object
                      properties:
                        mode:
                          type: string
                          enum:
                            - selected_roots
                        roots:
                          type: array
                          items:
                            type: string
                            minLength: 1
                          minItems: 1
                          maxItems: 100
                      required:
                        - mode
                        - roots
                      additionalProperties: false
                    - type: object
                      properties:
                        mode:
                          type: string
                          enum:
                            - all_user_files
                      required:
                        - mode
                      additionalProperties: false
                maxConcurrentRuns:
                  type: integer
                  exclusiveMinimum: true
                  minimum: 0
                  maximum: 1000
              required:
                - protocolVersion
                - hostVersion
                - platform
                - adapters
                - filesystem
                - maxConcurrentRuns
              additionalProperties: false
      responses:
        '200':
          description: >-
            Successful response. Stable response schemas are documented in
            workflow guides when available.
          content:
            application/json:
              schema:
                description: >-
                  Response shape is route-specific and may be backed by
                  @overlay/app-core contracts.
        '400':
          description: Invalid request.
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/ErrorResponse'
        '401':
          description: Missing or invalid authentication.
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/ErrorResponse'
        '500':
          description: Unexpected server error.
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/ErrorResponse'
      security:
        - browserSession: []
        - bearerAuth: []
components:
  schemas:
    ErrorResponse:
      type: object
      properties:
        error:
          type: string
        code:
          type: string
      additionalProperties: true
  securitySchemes:
    browserSession:
      type: apiKey
      in: cookie
      name: overlay_session
      description: Signed httpOnly browser session cookie.
    bearerAuth:
      type: http
      scheme: bearer
      description: WorkOS bearer access token for native or service clients.

````