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

# Attach a Dashboard Viewer

> Attach one of your provisioned users to an owner-linked organization as an organization-scoped, read-only dashboard viewer. The organization must be visible through an active partner link, and its owner or administrator must have granted your partner account permission to manage dashboard viewers. This endpoint does not grant settings, role-management, or other write access.




## OpenAPI

````yaml /openapi.yaml put /organizations/{organization_id}/dashboard-viewers/{external_id}
openapi: 3.0.0
info:
  title: Answering Agent API
  description: API for Answering Agent platform
  version: 1.0.0
servers:
  - url: https://answeringagent.com/api/v1
    description: Production API
  - url: https://playground.answeringagent.com/api/v1
    description: Playground API
security: []
paths:
  /organizations/{organization_id}/dashboard-viewers/{external_id}:
    put:
      tags:
        - Organizations
        - Users
      summary: Attach a Dashboard Viewer
      description: >
        Attach one of your provisioned users to an owner-linked organization as
        an organization-scoped, read-only dashboard viewer. The organization
        must be visible through an active partner link, and its owner or
        administrator must have granted your partner account permission to
        manage dashboard viewers. This endpoint does not grant settings,
        role-management, or other write access.
      operationId: attachOrganizationDashboardViewer
      parameters:
        - in: path
          name: organization_id
          required: true
          schema:
            type: integer
          description: ID of the owner-linked organization
        - in: path
          name: external_id
          required: true
          schema:
            type: string
          description: External ID of a user provisioned by your partner account
      responses:
        '200':
          description: Viewer attached. Repeating the request is idempotent.
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/User'
        '401':
          $ref: '#/components/responses/Unauthorized'
        '404':
          description: User or organization is not visible to this partner.
          content:
            application/json:
              schema:
                type: object
                properties:
                  message:
                    type: string
                    example: User not found
        '422':
          $ref: '#/components/responses/ValidationError'
      security:
        - ApiKeyAuth: []
components:
  schemas:
    User:
      type: object
      properties:
        id:
          type: integer
          description: Internal user ID
        external_id:
          type: string
          description: External identifier provided by the reseller
        email:
          type: string
          format: email
          description: User's email address
        name:
          type: string
          description: User's display name
        created_at:
          type: string
          format: date-time
          description: When the user was created
        updated_at:
          type: string
          format: date-time
          description: When the user was last updated
        organizations:
          type: array
          description: Organizations this user belongs to with their role
          items:
            type: object
            properties:
              id:
                type: integer
                description: Organization ID
              name:
                type: string
                description: Organization name
              role:
                type: string
                description: User's role in this organization
                enum:
                  - owner
                  - manager
                  - user
  responses:
    Unauthorized:
      description: Missing or invalid API key
      content:
        application/json:
          schema:
            type: object
            properties:
              error:
                type: string
                example: API key is required
                enum:
                  - API key is required
                  - Invalid credentials
    ValidationError:
      description: Validation failed.
      content:
        application/json:
          schema:
            type: object
            properties:
              message:
                type: string
              errors:
                type: object
  securitySchemes:
    ApiKeyAuth:
      type: apiKey
      in: header
      name: X-API-KEY

````