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

# Add link attachment to room

> Add a link attachment to a room. The attachment will be added to the default materials group. Authenticate using Bearer token with your Noux API key.



## OpenAPI

````yaml /openapi.json post /api/v1/room/attachment/link
openapi: 3.0.0
info:
  title: Noux REST API
  version: 1.0.0
  description: This page contains the standard OpenAPI specification for the Noux REST API.
  contact:
    name: Noux Digital Oy
    url: https://nouxdigital.com/
servers:
  - url: https://api.noux.app
    description: Production API
  - url: http://localhost:4000
    description: Local development
security: []
paths:
  /api/v1/room/attachment/link:
    post:
      tags:
        - Rooms
      summary: Add link attachment to room
      description: >-
        Add a link attachment to a room. The attachment will be added to the
        default materials group. Authenticate using Bearer token with your Noux
        API key.
      parameters:
        - schema:
            type: string
            description: Bearer token with Noux API key
          required: true
          description: Bearer token with Noux API key
          name: authorization
          in: header
      requestBody:
        content:
          application/json:
            schema:
              type: object
              properties:
                roomId:
                  type: string
                  description: Room ID to add attachment to
                url:
                  type: string
                  format: uri
                  description: URL of the link attachment
                name:
                  type: string
                  minLength: 1
                  description: Title/name of the attachment
              required:
                - roomId
                - url
                - name
      responses:
        '200':
          description: Attachment added successfully
          content:
            application/json:
              schema:
                type: object
                properties:
                  attachmentId:
                    type: string
                    description: The created attachment ID
                required:
                  - attachmentId
        '400':
          description: Bad request - invalid input or room not found
          content:
            application/json:
              schema:
                type: object
                properties:
                  error:
                    type: boolean
                    enum:
                      - true
                    description: Indicates this is an error response
                  code:
                    type: string
                    enum:
                      - PARSE_ERROR
                      - BAD_REQUEST
                      - INTERNAL_SERVER_ERROR
                      - NOT_IMPLEMENTED
                      - METHOD_NOT_SUPPORTED
                      - TIMEOUT
                      - CONFLICT
                      - PRECONDITION_FAILED
                      - PAYLOAD_TOO_LARGE
                      - UNPROCESSABLE_CONTENT
                      - TOO_MANY_REQUESTS
                      - CLIENT_CLOSED_REQUEST
                      - INVALID_INPUT
                      - UNAUTHORIZED
                      - NOT_FOUND
                      - FORBIDDEN
                      - INVALID_STATE
                      - SERVER_ERROR
                    description: Error code for programmatic handling
                  message:
                    type: string
                    description: Human-readable error message
                required:
                  - error
                  - code
                  - message
        '401':
          description: Unauthorized - invalid or missing API key
          content:
            application/json:
              schema:
                type: object
                properties:
                  error:
                    type: boolean
                    enum:
                      - true
                    description: Indicates this is an error response
                  code:
                    type: string
                    enum:
                      - PARSE_ERROR
                      - BAD_REQUEST
                      - INTERNAL_SERVER_ERROR
                      - NOT_IMPLEMENTED
                      - METHOD_NOT_SUPPORTED
                      - TIMEOUT
                      - CONFLICT
                      - PRECONDITION_FAILED
                      - PAYLOAD_TOO_LARGE
                      - UNPROCESSABLE_CONTENT
                      - TOO_MANY_REQUESTS
                      - CLIENT_CLOSED_REQUEST
                      - INVALID_INPUT
                      - UNAUTHORIZED
                      - NOT_FOUND
                      - FORBIDDEN
                      - INVALID_STATE
                      - SERVER_ERROR
                    description: Error code for programmatic handling
                  message:
                    type: string
                    description: Human-readable error message
                required:
                  - error
                  - code
                  - message
      security:
        - BearerAuth: []
components:
  securitySchemes:
    BearerAuth:
      type: http
      scheme: bearer
      bearerFormat: API Key
      description: Noux API key from your integration settings

````