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

# Create a partner-settled cash donation pledge

> 
    Creates a liquidated cash donation pledge for a donation that has already settled at a tech-platform partner.

    Authentication is required:
    - A valid tech-platform API key
    - An Endaoment user via the `x-endaoment-user-id` header

    This endpoint allows permissioned partners to:
    - Record an already-settled cash donation against a receiving fund
    - Provide the settled cash amount and partner operation reference
    - Create the resulting placeholder Donation in the same transaction
    



## OpenAPI

````yaml https://api.endaoment.org/oas-json post /v1/donation-pledges/partner/cash-settled
openapi: 3.0.0
info:
  title: Endaoment API
  description: >-
    The official Endaoment API endpoints. Dev (canary) = newest features;
    Staging (stable) = pre-production.
  version: 0.0.1
  contact: {}
servers:
  - url: https://api.endaoment.org
    description: Production
security: []
tags: []
paths:
  /v1/donation-pledges/partner/cash-settled:
    post:
      tags:
        - Donation Pledges
      summary: Create a partner-settled cash donation pledge
      description: |2-

            Creates a liquidated cash donation pledge for a donation that has already settled at a tech-platform partner.

            Authentication is required:
            - A valid tech-platform API key
            - An Endaoment user via the `x-endaoment-user-id` header

            This endpoint allows permissioned partners to:
            - Record an already-settled cash donation against a receiving fund
            - Provide the settled cash amount and partner operation reference
            - Create the resulting placeholder Donation in the same transaction
            
      operationId: DonationPledgesController_createSettledCashPledge
      parameters:
        - name: x-endaoment-user-id
          in: header
          description: UUID of the Endaoment user for this partner-settled operation
          required: true
          schema:
            type: string
        - name: x-api-key
          in: header
          description: Partner API key used for authentication
          required: true
          schema:
            type: string
      requestBody:
        required: true
        content:
          application/json:
            schema:
              $ref: '#/components/schemas/SettledCashPledgeInputDto'
      responses:
        '201':
          description: Partner-settled cash donation pledge successfully created
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/CreateDonationPledgeResponseDto'
        '400':
          description: Invalid cash pledge input data provided
        '401':
          description: Missing or invalid partner auth, or user could not be resolved
        '403':
          description: Partner is authenticated but not configured for settled operations
        '409':
          description: >-
            Idempotency conflict: the provided `idempotencyKey` is already bound
            to a different `partnerOperationId`, or the `partnerOperationId` has
            already been recorded under a different key
      security:
        - ApiKey: []
components:
  schemas:
    SettledCashPledgeInputDto:
      type: object
      properties:
        receivingFundId:
          type: string
          description: Unique identifier of the receiving fund
          format: uuid
          example: 123e4567-e89b-12d3-a456-426614174000
        idempotencyKey:
          type: string
          description: Client-generated key to ensure idempotency of the request
          format: uuid
          example: 123e4567-e89b-12d3-a456-426614174000
        pledgedAmountMicroDollars:
          type: string
          description: Settled cash donation amount in microdollars
          example: '50000000000'
        partnerOperationId:
          type: string
          description: Partner-owned reference for this operation
          example: a1b2c3d4-e5f6-7890-abcd-ef1234567890
          maxLength: 36
      required:
        - receivingFundId
        - idempotencyKey
        - pledgedAmountMicroDollars
        - partnerOperationId
    CreateDonationPledgeResponseDto:
      type: object
      properties:
        id:
          type: string
          description: Unique identifier of the created donation pledge
          example: 123e4567-e89b-12d3-a456-426614174000
          format: uuid
      required:
        - id

````