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

# Create assignment fund document template draft

> Creates a new DRAFT endorsement-term template version for one assignment fund. The clausulado is legal content of that fund's own regulation, which is why it is versioned per fund rather than per loan product.



## OpenAPI

````yaml /pt/openapi/v3-current/lender.yaml post /api/v1/assignment/funds/{fundId}/document-templates
openapi: 3.1.0
info:
  contact:
    email: contact@lerian.studio
    name: Lerian Studio
    url: https://lerian.studio
  description: >-
    Code-first OpenAPI 3.1 surface for the Lender service. Routes that move
    money are at-most-once per X-Idempotency: when one answers 5xx, the
    X-Idempotency-Fenced response header says whether that key is now refusing
    resends (true) or free to retry (false or absent). See
    docs/contracts/money-route-idempotency.md.
  license:
    name: Lerian Studio General License
  title: Lender API
  version: 1.0.0
servers:
  - url: https://lender.sandbox.lerian.net
security:
  - BearerAuth: []
tags:
  - description: >-
      Caller session projection: validated subject and effective permissions for
      the presented token.
    name: Session
  - description: >-
      Ledger accounting operations: journal entries and accrual postings for
      loan accounts.
    name: Accounting
  - description: >-
      Loan application intake and lifecycle: submission, decisioning, and
      status.
    name: LoanApplications
  - description: >-
      Loan product catalog: definition, versioning, and activation of lending
      products.
    name: LoanProducts
  - description: >-
      Loan account servicing operations: balances, schedules, and account-level
      actions.
    name: Loan Accounts
  - description: >-
      Portfolio dashboard read operations: aggregated portfolio and performance
      views.
    name: Dashboard
  - description: >-
      Jurisdiction registry: supported jurisdiction profiles and their
      capabilities.
    name: Jurisdictions
  - description: >-
      Jurisdiction-specific loan application operations (Brazil origination
      surface).
    name: Loan Applications
  - description: >-
      Tax computation operations for jurisdiction-specific lending (e.g. Brazil
      IOF).
    name: Tax
  - description: >-
      Brazil consignado privado operations: contract lifecycle, exclusion
      repair, and compensating adjustments.
    name: Consignado
  - description: >-
      Credit-instrument document template registry: versioned drafting and
      publication of CCB clausulado.
    name: DocumentTemplates
paths:
  /api/v1/assignment/funds/{fundId}/document-templates:
    post:
      tags:
        - AssignmentFundDocumentTemplates
      summary: Create assignment fund document template draft
      description: >-
        Creates a new DRAFT endorsement-term template version for one assignment
        fund. The clausulado is legal content of that fund's own regulation,
        which is why it is versioned per fund rather than per loan product.
      operationId: createAssignmentFundDocumentTemplate
      parameters:
        - description: Owning assignment fund identifier.
          in: path
          name: fundId
          required: true
          schema:
            description: Owning assignment fund identifier.
            format: uuid
            type: string
      requestBody:
        content:
          application/json:
            schema:
              $ref: '#/components/schemas/CreateFundDocumentTemplateHumaInputBody'
        required: true
      responses:
        '201':
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/DocumentTemplateHumaBody'
          description: Created
        '401':
          content:
            application/problem+json:
              schema:
                $ref: '#/components/schemas/Detail'
          description: Unauthorized
        '403':
          content:
            application/problem+json:
              schema:
                $ref: '#/components/schemas/Detail'
          description: Forbidden
        '422':
          content:
            application/problem+json:
              schema:
                $ref: '#/components/schemas/Detail'
          description: Unprocessable Entity
        '500':
          content:
            application/problem+json:
              schema:
                $ref: '#/components/schemas/Detail'
          description: Internal Server Error
        '503':
          content:
            application/problem+json:
              schema:
                $ref: '#/components/schemas/Detail'
          description: Service Unavailable
        default:
          content:
            application/problem+json:
              schema:
                $ref: '#/components/schemas/Detail'
          description: Error
components:
  schemas:
    CreateFundDocumentTemplateHumaInputBody:
      additionalProperties: false
      properties:
        kind:
          description: >-
            Document kind; a fund owns the endorsement-term clausulado and
            nothing else.
          enum:
            - assignment_term
          type: string
        requiredFields:
          description: >-
            Placeholder field names this template declares it needs; the term
            recorder supplies them from the approved set's frozen snapshot.
          items:
            type: string
          type:
            - array
            - 'null'
        sections:
          description: Ordered clauses.
          items:
            $ref: '#/components/schemas/DocumentTemplateSectionHumaBody'
          minItems: 1
          type:
            - array
            - 'null'
        signatureBlock:
          description: Signature block text.
          type: string
        title:
          description: Template title.
          type: string
      required:
        - kind
        - title
        - sections
        - signatureBlock
      type: object
    DocumentTemplateHumaBody:
      additionalProperties: false
      properties:
        active:
          description: Whether this is the currently active published version.
          type: boolean
        createdAt:
          description: Creation timestamp (RFC3339, UTC).
          type: string
        id:
          description: Template version identifier (uuid).
          type: string
        kind:
          description: Document kind.
          type: string
        loanProductId:
          description: >-
            Owning loan product identifier (uuid); absent on a fund-scoped
            template.
          type: string
        publishedAt:
          description: Publication timestamp (RFC3339, UTC); absent while draft.
          type: string
        requiredFields:
          description: Declared placeholder field names.
          items:
            type: string
          type:
            - array
            - 'null'
        scopeId:
          description: 'Owner identifier (uuid): the loan product or the assignment fund.'
          type: string
        scopeKind:
          description: Owner kind this template hangs off (loan_product|assignment_fund).
          type: string
        sections:
          description: Ordered clauses.
          items:
            $ref: '#/components/schemas/DocumentTemplateSectionHumaBody'
          type:
            - array
            - 'null'
        signatureBlock:
          description: Signature block text.
          type: string
        status:
          description: Lifecycle status (draft|published).
          type: string
        title:
          description: Template title.
          type: string
        updatedAt:
          description: Last-update timestamp (RFC3339, UTC).
          type: string
        versionNumber:
          description: Sequential version number within (tenant, product, kind).
          format: int64
          type: integer
      required:
        - id
        - scopeKind
        - scopeId
        - kind
        - versionNumber
        - status
        - active
        - title
        - sections
        - signatureBlock
        - requiredFields
        - createdAt
        - updatedAt
      type: object
    Detail:
      additionalProperties: false
      properties:
        code:
          description: >-
            Stable, machine-readable domain error code scoped to the emitting
            service (format: <SERVICE>-NNNN).
          type: string
        detail:
          description: >-
            A human-readable explanation specific to this occurrence of the
            problem.
          examples:
            - Property foo is required but is missing.
          type: string
        errors:
          description: Optional list of individual error details
          items:
            $ref: '#/components/schemas/ErrorDetail'
          type:
            - array
            - 'null'
        instance:
          description: >-
            A URI reference that identifies the specific occurrence of the
            problem.
          examples:
            - https://example.com/error-log/abc123
          format: uri
          type: string
        status:
          description: HTTP status code
          examples:
            - 400
          format: int64
          type: integer
        title:
          description: >-
            A short, human-readable summary of the problem type. This value
            should not change between occurrences of the error.
          examples:
            - Bad Request
          type: string
        type:
          default: about:blank
          description: A URI reference to human-readable documentation for the error.
          examples:
            - https://example.com/errors/example
          format: uri
          type: string
        upstream:
          $ref: '#/components/schemas/Upstream'
          description: >-
            RFC 9457 extension member: the error a proxied third-party provider
            reported. Absent unless the emitting service explicitly surfaced
            one.
      type: object
    DocumentTemplateSectionHumaBody:
      additionalProperties: false
      properties:
        body:
          description: >-
            Clause body; may carry text/template placeholders (e.g.
            "{{.PrincipalAmount}}") the render engine (Task 4.5.2) interprets.
          type: string
        heading:
          description: Clause heading.
          type: string
      required:
        - heading
        - body
      type: object
    ErrorDetail:
      additionalProperties: false
      properties:
        location:
          description: >-
            Where the error occurred, e.g. 'body.items[3].tags' or
            'path.thing-id'
          type: string
        message:
          description: Error message text
          type: string
        value:
          description: The value at the given location
      type: object
    Upstream:
      additionalProperties: false
      properties:
        code:
          description: The upstream provider's own error code, verbatim.
          examples:
            - E4001
          type: string
        message:
          description: >-
            The upstream provider's own error message, verbatim (bounded, never
            its raw response body).
          examples:
            - account not found at provider
          type: string
      type: object
  securitySchemes:
    BearerAuth:
      bearerFormat: JWT
      description: JWT bearer token issued by the identity provider.
      scheme: bearer
      type: http

````