> ## 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.

# Create a redline URL for a member

> Generates a redline URL for a specific member email associated with a redline request.
The member must already be part of the redline request. API-created URLs use the
embedded path. If it is not that member's turn, an out-of-turn URL is returned instead.




## OpenAPI

````yaml /api-reference/openapi.json post /redline-requests/{redlineRequestId}/url
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}/url:
    post:
      tags:
        - Redlining
      summary: Create a redline URL for a member
      description: >
        Generates a redline URL for a specific member email associated with a
        redline request.

        The member must already be part of the redline request. API-created URLs
        use the

        embedded path. If it is not that member's turn, an out-of-turn URL is
        returned instead.
      parameters:
        - in: path
          name: redlineRequestId
          required: true
          schema:
            type: string
          description: The ID of the redline request
          example: abc123xyz
      requestBody:
        required: true
        content:
          application/json:
            schema:
              type: object
              required:
                - memberEmail
              properties:
                memberEmail:
                  type: string
                  format: email
                  description: Email address of the redline member
                  example: member@example.com
      responses:
        '200':
          description: Redline URL created successfully
          content:
            application/json:
              schema:
                type: object
                properties:
                  redlineUrl:
                    type: string
                    description: The generated redline URL for the member
                    example: https://app.formabledocs.com/redlining/embedded/xyz789abc
                  expiresAt:
                    type: string
                    format: date-time
                    description: ISO 8601 timestamp when the redline URL expires
                    example: '2024-01-16T10:30:00.000Z'
        '400':
          description: Bad request - missing or invalid parameters
          content:
            application/json:
              schema:
                type: object
                properties:
                  error:
                    type: string
                    example: memberEmail is required
        '401':
          $ref: '#/components/responses/UnauthorizedError'
        '403':
          description: Forbidden - client not authorized for this redline request
          content:
            application/json:
              schema:
                type: object
                properties:
                  error:
                    type: string
                    example: >-
                      Client not authorized to create a redline URL 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

````