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

# Accept disclosures

> The caller submits the version they were shown, from
`GET /identity/v1/disclosures`. It is checked against the version in force and
rejected if a publish landed in between, so an acceptance can never name documents the
caller was not given.



## OpenAPI

````yaml /.tooling/schemas/rest/tags/product-finops.json post /identity/v1/disclosure-acceptances
openapi: 3.1.0
info:
  title: Tesouro Partner API
  version: '2026-09-24'
  description: The Tesouro REST API, for Tesouro partners to integrate with our solution.
  termsOfService: https://tesouro.com/terms
  contact:
    name: Tesouro team
    url: https://tesouro.com/about/
    email: developers@tesouro.com
servers:
  - url: https://api.sandbox.tesouro.com
    description: Sandbox
security: []
tags:
  - name: Accounting connections
  - name: Accounting data pull
  - name: Accounting synchronized records
  - name: Accounting tax rates
  - name: Analytics
  - name: Approval policies
  - name: Approval requests
  - name: Bank details
  - name: Comments
  - name: Cost centers
  - name: Counterpart addresses
  - name: Counterpart bank accounts
  - name: Counterpart contacts
  - name: Counterpart VAT IDs
  - name: Counterparts
  - name: Credit notes
  - name: Custom tax rates
  - name: Delivery notes
  - name: Departments
  - name: Disclosures
  - name: Documents
  - name: Events
  - name: Files
  - name: Ledger accounts
  - name: Locations
  - name: Mail templates
  - name: Mailbox domains
  - name: Mailboxes
  - name: Measure units
  - name: OCR
  - name: OIDC applications
  - name: Organizations
  - name: Overdue reminders
  - name: Payable duplicates
  - name: Payable line items
  - name: Payables
  - name: Payment intents
  - name: Payment links
  - name: Payment methods
  - name: Payment records
  - name: Payment reminders
  - name: Payment terms
  - name: PDF templates
  - name: Products
  - name: Projects
  - name: Purchase orders
  - name: Receipts
  - name: Receivables
  - name: Recurrences
  - name: Roles
  - name: Tags
  - name: Text templates
  - name: Transactions
  - name: Users
  - name: Webhook deliveries
  - name: Webhook subscriptions
paths:
  /identity/v1/disclosure-acceptances:
    post:
      tags:
        - Disclosures
      summary: Accept disclosures
      description: >-
        The caller submits the version they were shown, from

        `GET /identity/v1/disclosures`. It is checked against the version in
        force and

        rejected if a publish landed in between, so an acceptance can never name
        documents the

        caller was not given.
      operationId: PostDisclosureAcceptances
      parameters: []
      requestBody:
        content:
          application/json:
            schema:
              $ref: '#/components/schemas/AcceptDisclosuresRequestDto'
          text/json:
            schema:
              $ref: '#/components/schemas/AcceptDisclosuresRequestDto'
          application/*+json:
            schema:
              $ref: '#/components/schemas/AcceptDisclosuresRequestDto'
        required: true
      responses:
        '200':
          description: >-
            The acceptance on record. Accepting the same version again is a
            no-op and returns the original timestamp.
          content:
            text/plain:
              schema:
                $ref: '#/components/schemas/DisclosureAcceptanceResponseDto'
            application/json:
              schema:
                $ref: '#/components/schemas/DisclosureAcceptanceResponseDto'
            text/json:
              schema:
                $ref: '#/components/schemas/DisclosureAcceptanceResponseDto'
        '401':
          description: No authenticated user on the request.
          content:
            text/plain:
              schema:
                $ref: '#/components/schemas/ProblemDetails'
            application/json:
              schema:
                $ref: '#/components/schemas/ProblemDetails'
            text/json:
              schema:
                $ref: '#/components/schemas/ProblemDetails'
        '404':
          description: >-
            The caller's bank has published no disclosure version, so there is
            nothing to accept.
          content:
            text/plain:
              schema:
                $ref: '#/components/schemas/ProblemDetails'
            application/json:
              schema:
                $ref: '#/components/schemas/ProblemDetails'
            text/json:
              schema:
                $ref: '#/components/schemas/ProblemDetails'
        '409':
          description: >-
            The submitted version is no longer in force. Re-read the disclosures
            and accept the current set.
          content:
            text/plain:
              schema:
                $ref: '#/components/schemas/ProblemDetails'
            application/json:
              schema:
                $ref: '#/components/schemas/ProblemDetails'
            text/json:
              schema:
                $ref: '#/components/schemas/ProblemDetails'
      security:
        - HTTPBearer: []
components:
  schemas:
    AcceptDisclosuresRequestDto:
      required:
        - version
      type: object
      properties:
        version:
          type: string
          description: >-
            The version the caller was shown, as returned by `GET
            /identity/v1/disclosures`.

            Required, and rejected if it is no longer the version in force:
            without it the service

            would record acceptance of whatever is current at the moment the
            request lands, which

            after a publish is documents the caller never saw.
          format: uuid
      description: What the caller is accepting.
    DisclosureAcceptanceResponseDto:
      required:
        - userId
        - version
        - acceptedTsUtc
      type: object
      properties:
        acceptedTsUtc:
          type: string
          description: >-
            When the acceptance on record was made. Unchanged by accepting the
            same version again.
          format: date-time
        userId:
          type: string
          description: The user who accepted.
          format: uuid
        version:
          type: string
          description: The disclosure version accepted.
          format: uuid
      description: The recorded acceptance returned after a user accepts disclosures.
    ProblemDetails:
      type: object
      properties:
        detail:
          type:
            - 'null'
            - string
        instance:
          type:
            - 'null'
            - string
        status:
          pattern: ^-?(?:0|[1-9]\d*)$
          type:
            - 'null'
            - integer
            - string
          format: int32
        title:
          type:
            - 'null'
            - string
        type:
          type:
            - 'null'
            - string
  securitySchemes:
    HTTPBearer:
      type: http
      scheme: bearer

````