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

# Update detailed project description

> Updates the detailed project description for a general lead.
Maximum 10,000 characters.




## OpenAPI

````yaml /openapi-manager.yaml post /general-leads/{generalLeadId}/detailed-project-description
openapi: 3.0.3
info:
  title: RenovationFind Manager API
  description: >
    Internal REST API for RenovationFind manager operations.


    ## Authentication

    All endpoints require a Bearer token in the `Authorization` header.

    Tokens are issued from the RenovationFind Manager Portal.


    ```

    Authorization: Bearer <your_jwt_token>

    ```


    ## Rate Limiting

    API requests are rate-limited to **250 requests per 5 minutes** per manager.

    When exceeded, the API returns `429 Too Many Requests` with a `Retry-After`
    header.


    ## Response Format

    All responses follow a consistent envelope:

    ```json

    {
      "success": true,
      "data": { ... },
      "message": "Optional message"
    }

    ```

    On error:

    ```json

    {
      "success": false,
      "error": "Error description"
    }

    ```


    ## Partial Updates

    All PATCH endpoints accept partial payloads. Only provided (non-null) fields
    are applied;

    omitted fields remain unchanged. Date fields use `dd/MM/yyyy` format.
  version: 1.0.0
  contact:
    name: RenovationFind
    url: https://www.renovationfind.com
servers:
  - url: https://www.renovationfind.com/rest-manager-api-v1
    description: Production
security:
  - BearerAuth: []
paths:
  /general-leads/{generalLeadId}/detailed-project-description:
    post:
      tags:
        - General Leads
      summary: Update detailed project description
      description: |
        Updates the detailed project description for a general lead.
        Maximum 10,000 characters.
      operationId: updateGeneralLeadDetailedProjectDescription
      parameters:
        - name: generalLeadId
          in: path
          required: true
          schema:
            type: integer
            format: int64
      requestBody:
        required: true
        content:
          application/json:
            schema:
              type: object
              properties:
                detailedProjectDescription:
                  type: string
                  maxLength: 10000
      responses:
        '200':
          description: Description updated
          content:
            application/json:
              schema:
                type: object
                properties:
                  success:
                    type: boolean
                  data:
                    type: object
                    description: >
                      Full general lead representation with all details
                      including customer info,

                      job details, vendor relations, location, financial info,
                      and communications.
                    properties:
                      id:
                        type: integer
                        format: int64
                      customerName:
                        type: string
                      email:
                        type: string
                      phone:
                        type: string
                      dateCreated:
                        type: string
                        format: date-time
                      dateModified:
                        type: string
                        format: date-time
                      jobDescription:
                        type: string
                      jobAmount:
                        type: number
                        format: double
                      paidAmount:
                        type: number
                        format: double
                      detailedProjectDescription:
                        type: string
                      generalLeadStatus:
                        type: string
                      specificLeadStatus:
                        type: string
                      leadSourceType:
                        type: string
                      assignedVendorId:
                        type: integer
                        format: int64
                      assignedVendorName:
                        type: string
                      referrerVendorId:
                        type: integer
                        format: int64
                      referrerVendorName:
                        type: string
                      postalCode:
                        type: string
                      city:
                        type: string
                      serviceBoundary:
                        type: object
                        properties:
                          id:
                            type: integer
                            format: int64
                          name:
                            type: string
                          urlPath:
                            type: string
                          cityName:
                            type: string
                      contactTime:
                        type: string
                      contactMethod:
                        type: string
                      leadTimeframe:
                        type: string
                      quoteTimeframe:
                        type: string
                      projectStage:
                        type: string
                      renofindLeadType:
                        type: string
                      jobBudget:
                        type: number
                        format: double
                      paymentStatus:
                        type: string
                      phoneLead:
                        type: boolean
                      externalNotes:
                        type: string
                      essentialInternalNotes:
                        type: string
                      requiresAction:
                        type: boolean
                      requireActionReason:
                        type: string
                      endCustomer:
                        type: object
                        properties:
                          id:
                            type: integer
                            format: int64
                          name:
                            type: string
                          email:
                            type: string
                          phone:
                            type: string
                  message:
                    type: string
components:
  securitySchemes:
    BearerAuth:
      type: http
      scheme: bearer
      bearerFormat: JWT
      description: JWT token issued from the RenovationFind Manager Portal

````