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

# Update redline request members

> Replaces or upserts the members for an existing redline request. Each member must have an email, displayName, and role. Valid roles are DisclosingParty, ReceivingParty, DisclosingCounsel, ReceivingCounsel.



## OpenAPI

````yaml /api-reference/openapi.json put /redline-requests/{redlineRequestId}/members
openapi: 3.0.0
info:
  title: Formable API
  version: 1.0.0
  description: External API for redlining and e-signatures.
servers:
  - url: https://api.formabledocs.com/v1
    description: Production
security:
  - bearerAuth: []
tags:
  - name: Templates
    description: Upload documents and generate editor URLs.
  - name: Signature Requests
    description: Send documents for e-signature and retrieve signed results.
  - name: Redlining
    description: Create and manage collaborative redline negotiations.
  - name: Billing
    description: Retrieve usage information.
  - name: Health
    description: Service health checks.
paths:
  /redline-requests/{redlineRequestId}/members:
    put:
      tags:
        - Redlining
      summary: Update redline request members
      description: >-
        Replaces or upserts the members for an existing redline request. Each
        member must have an email, displayName, and role. Valid roles are
        DisclosingParty, ReceivingParty, DisclosingCounsel, ReceivingCounsel.
      parameters:
        - in: path
          name: redlineRequestId
          required: true
          schema:
            type: string
          description: The ID of the redline request to update members for
          example: abc123xyz
      requestBody:
        required: true
        content:
          application/json:
            schema:
              type: object
              required:
                - members
              properties:
                members:
                  type: array
                  minItems: 1
                  description: >-
                    Array of members to set for the redline request (replaces
                    existing)
                  items:
                    type: object
                    required:
                      - email
                      - displayName
                      - role
                    properties:
                      email:
                        type: string
                        format: email
                        description: Email address of the member
                        example: member@example.com
                      displayName:
                        type: string
                        description: Display name of the member
                        example: John Doe
                      role:
                        type: string
                        enum:
                          - DisclosingParty
                          - ReceivingParty
                          - DisclosingCounsel
                          - ReceivingCounsel
                        description: Role of the member in the redline request
                        example: DisclosingParty
      responses:
        '200':
          description: Redline members updated successfully
          content:
            application/json:
              schema:
                type: object
                properties:
                  members:
                    type: array
                    description: The updated list of redline members
                    items:
                      type: object
                      properties:
                        role:
                          type: string
                          enum:
                            - DisclosingParty
                            - ReceivingParty
                            - DisclosingCounsel
                            - ReceivingCounsel
                          description: Role of the member
                        email:
                          type: string
                          format: email
                          description: Email address of the member
                        displayName:
                          type: string
                          description: Display name of the member
        '400':
          description: >-
            Bad request - missing or invalid parameters (e.g. RedlineRequestId
            required, members array required, each member must have
            email/displayName/role, invalid role)
          content:
            application/json:
              schema:
                type: object
                properties:
                  error:
                    type: string
                    example: >-
                      Members array is required and must contain at least one
                      member
        '401':
          $ref: '#/components/responses/UnauthorizedError'
        '403':
          description: >-
            Forbidden - client not authorized to update members for this redline
            request
          content:
            application/json:
              schema:
                type: object
                properties:
                  error:
                    type: string
                    example: >-
                      Client not authorized to put redline members for this
                      redline request
        '404':
          description: Redline request not found
          content:
            application/json:
              schema:
                type: object
                properties:
                  error:
                    type: string
                    example: Redline request not found for id abc123xyz
        '500':
          description: Internal server error
          content:
            application/json:
              schema:
                type: object
                properties:
                  error:
                    type: string
                    example: Internal server error
      security:
        - bearerAuth: []
components:
  responses:
    UnauthorizedError:
      description: Unauthorized - missing or invalid bearer token
      content:
        application/json:
          schema:
            type: object
            properties:
              error:
                type: string
                example: Auth token not valid
  securitySchemes:
    bearerAuth:
      type: http
      scheme: bearer
      bearerFormat: JWT

````