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

# Update summary internal notes

> Replace only the internal notes of a summary visible to the caller.



## OpenAPI

````yaml /openapi/public-v1.json patch /api/v1/workspaces/{workspaceSlug}/summaries/{id}
openapi: 3.1.0
info:
  description: Stable external API for relationship lookup and meeting intelligence.
  title: Floral Public API
  version: 1.0.0
servers:
  - description: Production
    url: https://app.floral.so
security: []
tags:
  - description: Search across active companies and people.
    name: Search
  - description: Create, list, inspect, update, archive, and restore companies.
    name: Companies
  - description: Create, list, inspect, update, archive, and restore people.
    name: People
  - description: Read active public custom-field definitions.
    name: Custom fields
  - description: Search normalized Danish company-register facts.
    name: Company registry
  - description: Generate, list, and inspect meeting briefings.
    name: Briefings
  - description: List, inspect, annotate, and approve meeting summaries.
    name: Summaries
paths:
  /api/v1/workspaces/{workspaceSlug}/summaries/{id}:
    patch:
      tags:
        - Summaries
      summary: Update summary internal notes
      description: Replace only the internal notes of a summary visible to the caller.
      operationId: updateSummaryV1
      parameters:
        - description: Slug of the workspace pinned to the credential.
          example: acme-nordic
          in: path
          name: workspaceSlug
          required: true
          schema:
            maxLength: 100
            minLength: 1
            pattern: ^[a-z0-9]+(?:-[a-z0-9]+)*$
            type: string
        - description: Stable numeric resource ID.
          example: 168
          in: path
          name: id
          required: true
          schema:
            minimum: 1
            type: integer
        - description: >-
            Optional caller-generated correlation ID. Floral returns the
            effective value in X-Request-ID.
          example: 550e8400-e29b-41d4-a716-446655440000
          in: header
          name: X-Request-ID
          required: false
          schema:
            maxLength: 128
            minLength: 1
            type: string
        - description: >-
            Strong ETag from the latest detail or mutation response. A stale
            value returns 412 VERSION_CONFLICT.
          example: '"v1.c3VtbWFyeS0xNjgtMg"'
          in: header
          name: If-Match
          required: true
          schema:
            pattern: ^"(?:[^"\\]|\\.)*"$
            type: string
      requestBody:
        content:
          application/json:
            example:
              internalNotes: Confirm the implementation owner before Friday.
            schema:
              $ref: '#/components/schemas/SummaryPatchRequest'
        description: >-
          Only internalNotes is accepted. Whitespace-only notes are stored as
          null. Maximum 65536 bytes.
        required: true
      responses:
        '200':
          content:
            application/json:
              example:
                summary:
                  appointmentDate: '2026-08-18T09:00:00.000Z'
                  appointmentSubject: Quarterly planning
                  company:
                    id: 42
                    name: Acme Nordic
                    organizationNumber: '12345678'
                  content: null
                  createdAt: '2026-08-15T10:00:00.000Z'
                  durationSec: 2700
                  evidenceAudience: CUSTOMER
                  id: 168
                  internalNotes: Confirm the implementation owner before Friday.
                  name: Quarterly planning
                  status: WAITING_APPROVAL
                  updatedAt: '2026-08-15T10:30:00.000Z'
                  version: v1.c3VtbWFyeS0xNjgtMg
              schema:
                $ref: '#/components/schemas/SummaryDetailResponse'
          description: Summary notes updated
          headers:
            X-Content-Type-Options:
              description: Always nosniff for JSON API responses.
              schema:
                const: nosniff
                type: string
            X-RateLimit-Limit:
              description: Maximum requests in the current rate-limit window.
              schema:
                minimum: 1
                type: integer
            X-RateLimit-Remaining:
              description: Requests remaining in the current rate-limit window.
              schema:
                minimum: 0
                type: integer
            X-Request-ID:
              description: Stable request or idempotent replay correlation ID.
              schema:
                minLength: 1
                type: string
            ETag:
              description: Opaque version for a subsequent If-Match.
              example: '"v1.c3VtbWFyeS0xNjgtMg"'
              schema:
                pattern: ^"(?:[^"\\]|\\.)*"$
                type: string
        '400':
          content:
            application/json:
              example:
                error:
                  code: INVALID_INPUT
                  message: The request contains invalid values.
                  requestId: 550e8400-e29b-41d4-a716-446655440000
              schema:
                allOf:
                  - $ref: '#/components/schemas/ApiErrorResponse'
                properties:
                  error:
                    properties:
                      code:
                        enum:
                          - INVALID_INPUT
                        type: string
                    required:
                      - code
                    type: object
                type: object
          description: 'Stable errors: INVALID_INPUT'
          headers:
            X-Content-Type-Options:
              description: Always nosniff for JSON API responses.
              schema:
                const: nosniff
                type: string
            X-RateLimit-Limit:
              description: Maximum requests in the current rate-limit window.
              schema:
                minimum: 1
                type: integer
            X-RateLimit-Remaining:
              description: Requests remaining in the current rate-limit window.
              schema:
                minimum: 0
                type: integer
            X-Request-ID:
              description: Stable request or idempotent replay correlation ID.
              schema:
                minLength: 1
                type: string
        '401':
          content:
            application/json:
              example:
                error:
                  code: UNAUTHENTICATED
                  message: A valid bearer credential is required.
                  requestId: 550e8400-e29b-41d4-a716-446655440000
              schema:
                allOf:
                  - $ref: '#/components/schemas/ApiErrorResponse'
                properties:
                  error:
                    properties:
                      code:
                        enum:
                          - UNAUTHENTICATED
                        type: string
                    required:
                      - code
                    type: object
                type: object
          description: 'Stable errors: UNAUTHENTICATED'
          headers:
            X-Content-Type-Options:
              description: Always nosniff for JSON API responses.
              schema:
                const: nosniff
                type: string
            X-RateLimit-Limit:
              description: Maximum requests in the current rate-limit window.
              schema:
                minimum: 1
                type: integer
            X-RateLimit-Remaining:
              description: Requests remaining in the current rate-limit window.
              schema:
                minimum: 0
                type: integer
            X-Request-ID:
              description: Stable request or idempotent replay correlation ID.
              schema:
                minLength: 1
                type: string
            WWW-Authenticate:
              description: Bearer authentication challenge.
              example: Bearer realm="floral-api"
              schema:
                type: string
        '403':
          content:
            application/json:
              example:
                error:
                  code: FORBIDDEN
                  message: The credential does not grant this operation.
                  requestId: 550e8400-e29b-41d4-a716-446655440000
              schema:
                allOf:
                  - $ref: '#/components/schemas/ApiErrorResponse'
                properties:
                  error:
                    properties:
                      code:
                        enum:
                          - FORBIDDEN
                        type: string
                    required:
                      - code
                    type: object
                type: object
          description: 'Stable errors: FORBIDDEN'
          headers:
            X-Content-Type-Options:
              description: Always nosniff for JSON API responses.
              schema:
                const: nosniff
                type: string
            X-RateLimit-Limit:
              description: Maximum requests in the current rate-limit window.
              schema:
                minimum: 1
                type: integer
            X-RateLimit-Remaining:
              description: Requests remaining in the current rate-limit window.
              schema:
                minimum: 0
                type: integer
            X-Request-ID:
              description: Stable request or idempotent replay correlation ID.
              schema:
                minLength: 1
                type: string
        '404':
          content:
            application/json:
              example:
                error:
                  code: NOT_FOUND
                  message: The resource was not found.
                  requestId: 550e8400-e29b-41d4-a716-446655440000
              schema:
                allOf:
                  - $ref: '#/components/schemas/ApiErrorResponse'
                properties:
                  error:
                    properties:
                      code:
                        enum:
                          - NOT_FOUND
                          - FEATURE_DISABLED
                        type: string
                    required:
                      - code
                    type: object
                type: object
          description: 'Stable errors: NOT_FOUND, FEATURE_DISABLED'
          headers:
            X-Content-Type-Options:
              description: Always nosniff for JSON API responses.
              schema:
                const: nosniff
                type: string
            X-RateLimit-Limit:
              description: Maximum requests in the current rate-limit window.
              schema:
                minimum: 1
                type: integer
            X-RateLimit-Remaining:
              description: Requests remaining in the current rate-limit window.
              schema:
                minimum: 0
                type: integer
            X-Request-ID:
              description: Stable request or idempotent replay correlation ID.
              schema:
                minLength: 1
                type: string
        '409':
          content:
            application/json:
              example:
                error:
                  code: CONFLICT
                  message: >-
                    The requested change conflicts with the current resource
                    state.
                  requestId: 550e8400-e29b-41d4-a716-446655440000
              schema:
                allOf:
                  - $ref: '#/components/schemas/ApiErrorResponse'
                properties:
                  error:
                    properties:
                      code:
                        enum:
                          - CONFLICT
                        type: string
                    required:
                      - code
                    type: object
                type: object
          description: 'Stable errors: CONFLICT'
          headers:
            X-Content-Type-Options:
              description: Always nosniff for JSON API responses.
              schema:
                const: nosniff
                type: string
            X-RateLimit-Limit:
              description: Maximum requests in the current rate-limit window.
              schema:
                minimum: 1
                type: integer
            X-RateLimit-Remaining:
              description: Requests remaining in the current rate-limit window.
              schema:
                minimum: 0
                type: integer
            X-Request-ID:
              description: Stable request or idempotent replay correlation ID.
              schema:
                minLength: 1
                type: string
        '412':
          content:
            application/json:
              example:
                error:
                  code: VERSION_CONFLICT
                  message: The resource changed since it was read.
                  requestId: 550e8400-e29b-41d4-a716-446655440000
              schema:
                allOf:
                  - $ref: '#/components/schemas/ApiErrorResponse'
                properties:
                  error:
                    properties:
                      code:
                        enum:
                          - VERSION_CONFLICT
                        type: string
                    required:
                      - code
                    type: object
                type: object
          description: 'Stable errors: VERSION_CONFLICT'
          headers:
            X-Content-Type-Options:
              description: Always nosniff for JSON API responses.
              schema:
                const: nosniff
                type: string
            X-RateLimit-Limit:
              description: Maximum requests in the current rate-limit window.
              schema:
                minimum: 1
                type: integer
            X-RateLimit-Remaining:
              description: Requests remaining in the current rate-limit window.
              schema:
                minimum: 0
                type: integer
            X-Request-ID:
              description: Stable request or idempotent replay correlation ID.
              schema:
                minLength: 1
                type: string
        '428':
          content:
            application/json:
              example:
                error:
                  code: PRECONDITION_REQUIRED
                  message: If-Match is required for this operation.
                  requestId: 550e8400-e29b-41d4-a716-446655440000
              schema:
                allOf:
                  - $ref: '#/components/schemas/ApiErrorResponse'
                properties:
                  error:
                    properties:
                      code:
                        enum:
                          - PRECONDITION_REQUIRED
                        type: string
                    required:
                      - code
                    type: object
                type: object
          description: 'Stable errors: PRECONDITION_REQUIRED'
          headers:
            X-Content-Type-Options:
              description: Always nosniff for JSON API responses.
              schema:
                const: nosniff
                type: string
            X-RateLimit-Limit:
              description: Maximum requests in the current rate-limit window.
              schema:
                minimum: 1
                type: integer
            X-RateLimit-Remaining:
              description: Requests remaining in the current rate-limit window.
              schema:
                minimum: 0
                type: integer
            X-Request-ID:
              description: Stable request or idempotent replay correlation ID.
              schema:
                minLength: 1
                type: string
        '429':
          content:
            application/json:
              example:
                error:
                  code: RATE_LIMITED
                  message: Too many requests. Retry shortly.
                  requestId: 550e8400-e29b-41d4-a716-446655440000
              schema:
                allOf:
                  - $ref: '#/components/schemas/ApiErrorResponse'
                properties:
                  error:
                    properties:
                      code:
                        enum:
                          - RATE_LIMITED
                        type: string
                    required:
                      - code
                    type: object
                type: object
          description: 'Stable errors: RATE_LIMITED'
          headers:
            X-Content-Type-Options:
              description: Always nosniff for JSON API responses.
              schema:
                const: nosniff
                type: string
            X-RateLimit-Limit:
              description: Maximum requests in the current rate-limit window.
              schema:
                minimum: 1
                type: integer
            X-RateLimit-Remaining:
              description: Requests remaining in the current rate-limit window.
              schema:
                minimum: 0
                type: integer
            X-Request-ID:
              description: Stable request or idempotent replay correlation ID.
              schema:
                minLength: 1
                type: string
            Retry-After:
              description: Seconds until the current limit resets.
              schema:
                minimum: 1
                type: integer
        '500':
          content:
            application/json:
              example:
                error:
                  code: INTERNAL_ERROR
                  message: An unexpected error occurred.
                  requestId: 550e8400-e29b-41d4-a716-446655440000
              schema:
                allOf:
                  - $ref: '#/components/schemas/ApiErrorResponse'
                properties:
                  error:
                    properties:
                      code:
                        enum:
                          - INTERNAL_ERROR
                        type: string
                    required:
                      - code
                    type: object
                type: object
          description: 'Stable errors: INTERNAL_ERROR'
          headers:
            X-Content-Type-Options:
              description: Always nosniff for JSON API responses.
              schema:
                const: nosniff
                type: string
            X-RateLimit-Limit:
              description: Maximum requests in the current rate-limit window.
              schema:
                minimum: 1
                type: integer
            X-RateLimit-Remaining:
              description: Requests remaining in the current rate-limit window.
              schema:
                minimum: 0
                type: integer
            X-Request-ID:
              description: Stable request or idempotent replay correlation ID.
              schema:
                minLength: 1
                type: string
      security:
        - bearerAuth: []
      x-codeSamples:
        - label: cURL
          lang: Shell
          source: |-
            curl --request PATCH \
              --url 'https://app.floral.so/api/v1/workspaces/acme-nordic/summaries/168' \
              --header 'Authorization: Bearer $FLORAL_TOKEN' \
              --header 'If-Match: "v1.c3VtbWFyeS0xNjgtMg"' \
              --header 'Content-Type: application/json' \
              --data '{
              "internalNotes": "Confirm the implementation owner before Friday."
            }'
components:
  schemas:
    SummaryPatchRequest:
      $schema: https://json-schema.org/draft/2020-12/schema
      type: object
      properties:
        internalNotes:
          anyOf:
            - type: string
              maxLength: 50000
            - type: 'null'
      required:
        - internalNotes
      additionalProperties: false
    SummaryDetailResponse:
      $schema: https://json-schema.org/draft/2020-12/schema
      type: object
      properties:
        summary:
          type: object
          properties:
            id:
              type: integer
              exclusiveMinimum: 0
              maximum: 9007199254740991
            version:
              type: string
              minLength: 1
              maxLength: 512
              pattern: ^v1\.[A-Za-z0-9_-]+$
            name:
              type: string
            status:
              type: string
              enum:
                - WAITING
                - WAITING_APPROVAL
                - APPROVED
                - FAILED
            evidenceAudience:
              type: string
              enum:
                - CUSTOMER
                - INTERNAL
            createdAt:
              type: string
              format: date-time
              pattern: >-
                ^(?:(?:\d\d[2468][048]|\d\d[13579][26]|\d\d0[48]|[02468][048]00|[13579][26]00)-02-29|\d{4}-(?:(?:0[13578]|1[02])-(?:0[1-9]|[12]\d|3[01])|(?:0[469]|11)-(?:0[1-9]|[12]\d|30)|(?:02)-(?:0[1-9]|1\d|2[0-8])))T(?:(?:[01]\d|2[0-3]):[0-5]\d(?::[0-5]\d(?:\.\d+)?)?(?:Z))$
            updatedAt:
              type: string
              format: date-time
              pattern: >-
                ^(?:(?:\d\d[2468][048]|\d\d[13579][26]|\d\d0[48]|[02468][048]00|[13579][26]00)-02-29|\d{4}-(?:(?:0[13578]|1[02])-(?:0[1-9]|[12]\d|3[01])|(?:0[469]|11)-(?:0[1-9]|[12]\d|30)|(?:02)-(?:0[1-9]|1\d|2[0-8])))T(?:(?:[01]\d|2[0-3]):[0-5]\d(?::[0-5]\d(?:\.\d+)?)?(?:Z))$
            appointmentDate:
              anyOf:
                - type: string
                  format: date-time
                  pattern: >-
                    ^(?:(?:\d\d[2468][048]|\d\d[13579][26]|\d\d0[48]|[02468][048]00|[13579][26]00)-02-29|\d{4}-(?:(?:0[13578]|1[02])-(?:0[1-9]|[12]\d|3[01])|(?:0[469]|11)-(?:0[1-9]|[12]\d|30)|(?:02)-(?:0[1-9]|1\d|2[0-8])))T(?:(?:[01]\d|2[0-3]):[0-5]\d(?::[0-5]\d(?:\.\d+)?)?(?:Z))$
                - type: 'null'
            appointmentSubject:
              anyOf:
                - type: string
                - type: 'null'
            durationSec:
              anyOf:
                - type: integer
                  minimum: 0
                  maximum: 9007199254740991
                - type: 'null'
            internalNotes:
              anyOf:
                - type: string
                - type: 'null'
            company:
              anyOf:
                - type: object
                  properties:
                    id:
                      type: integer
                      exclusiveMinimum: 0
                      maximum: 9007199254740991
                    name:
                      type: string
                    organizationNumber:
                      type: string
                  required:
                    - id
                    - name
                    - organizationNumber
                  additionalProperties: false
                - type: 'null'
            content:
              anyOf:
                - type: object
                  properties:
                    titel:
                      description: >-
                        Kort, beskrivende titel for mødereferatet der opsummerer
                        mødets hovedformål (3-10 ord). Eksempel: 'Strategi for
                        digital transformation' eller 'Opfølgning på
                        eksportplaner'
                      type: string
                      maxLength: 200
                    opsummering:
                      description: >-
                        Sammenhængende opsummering af hele mødet i 2-4 sætninger
                        som flydende prosa. Skal give læseren et hurtigt
                        overblik over mødets vigtigste pointer, beslutninger og
                        næste skridt. Ingen punktopstillinger eller markdown.
                      type: string
                      maxLength: 1500
                    hvadBlevDroeftet:
                      default:
                        emner: []
                      description: >-
                        Sektion 1: Hvad blev drøftet - de vigtigste emner,
                        problemstillinger og muligheder fra mødet
                      type: object
                      properties:
                        emner:
                          description: >-
                            Array af de vigtigste emner, problemstillinger og
                            muligheder der blev drøftet under mødet (3-7 emner
                            anbefales)
                          default: []
                          maxItems: 10
                          type: array
                          items:
                            type: object
                            properties:
                              emne:
                                description: >-
                                  Kort titel på emnet der blev drøftet (1
                                  sætning, ca. 5-12 ord)
                                type: string
                                maxLength: 200
                              beskrivelse:
                                description: >-
                                  Uddybende beskrivelse af hvad der blev
                                  diskuteret omkring emnet, inkl.
                                  problemstillinger og muligheder (2-4
                                  sætninger)
                                type: string
                                maxLength: 2000
                              rejstAf:
                                description: >-
                                  Hvem der primært rejste emnet: 'virksomhed',
                                  'konsulent', eller 'fælles' dialog. Udelades
                                  hvis det ikke fremgår tydeligt.
                                type: string
                                enum:
                                  - virksomhed
                                  - konsulent
                                  - fælles
                            required:
                              - emne
                              - beskrivelse
                            additionalProperties: false
                      required:
                        - emner
                      additionalProperties: false
                    hvadBlevAftalt:
                      default: {}
                      description: >-
                        Sektion 2: Hvad blev aftalt - centrale beslutninger og
                        aftaler truffet under mødet
                      type: object
                      properties:
                        aftaler:
                          description: >-
                            Array af centrale aftaler og beslutninger truffet
                            under mødet (4-10 aftaler hvis så mange findes). Kan
                            være tomt hvis ingen konkrete aftaler blev truffet.
                          maxItems: 12
                          type: array
                          items:
                            type: object
                            properties:
                              aftale:
                                description: >-
                                  Kort beskrivelse af hvad der blev aftalt eller
                                  besluttet (1-2 sætninger)
                                type: string
                                maxLength: 1500
                              ansvarlig:
                                description: >-
                                  Hvem der er ansvarlig for aftalen: virksomhed,
                                  konsulent, eller navngiven person/rolle.
                                  Udelades hvis det ikke fremgår.
                                type: string
                                maxLength: 200
                              deadline:
                                description: >-
                                  Tidshorisont eller deadline for aftalen, fx
                                  'Inden næste møde', '01.10.2025'. Udelades
                                  hvis det ikke fremgår.
                                type: string
                                maxLength: 200
                            required:
                              - aftale
                            additionalProperties: false
                        ingenAftaler:
                          description: >-
                            Hvis der ikke blev truffet konkrete aftaler,
                            beskrives dette her, inkl. eventuelle forventede
                            næste skridt.
                          type: string
                          maxLength: 1500
                      additionalProperties: false
                    todos:
                      default: {}
                      description: >-
                        Sektion 3: To-dos - konkret checkliste med opgaver til
                        opfølgning
                      type: object
                      properties:
                        opgaver:
                          description: >-
                            Array af konkrete opgaver der skal udføres som
                            opfølgning på mødet. Kun opgaver der tydeligt
                            fremgår af mødet medtages.
                          maxItems: 15
                          type: array
                          items:
                            type: object
                            properties:
                              opgave:
                                description: >-
                                  Beskrivelse af den konkrete opgave der skal
                                  udføres (1-2 sætninger)
                                type: string
                                maxLength: 1500
                              ansvarlig:
                                description: >-
                                  Hvem der er ansvarlig for opgaven:
                                  'Virksomheden', 'Konsulent', eller navngiven
                                  person. Udelades hvis det ikke fremgår.
                                type: string
                                maxLength: 200
                              deadline:
                                description: >-
                                  Deadline for opgaven, fx '01.10.2025' eller
                                  'Ikke fastlagt'. Udelades hvis det ikke
                                  fremgår.
                                type: string
                                maxLength: 200
                              prioritet:
                                description: >-
                                  Opgavens prioritet baseret på kontekst i
                                  mødet. Udelades hvis det ikke kan vurderes.
                                type: string
                                enum:
                                  - høj
                                  - mellem
                                  - lav
                            required:
                              - opgave
                            additionalProperties: false
                      additionalProperties: false
                    context:
                      description: >-
                        Tag-slugs der beskriver mødets hovedtemaer. Vælg KUN
                        slugs fra den medsendte taxonomy der tydeligt blev
                        diskuteret. Kan være tomt hvis ingen passer.
                      default: []
                      maxItems: 5
                      type: array
                      items:
                        type: string
                  required:
                    - hvadBlevDroeftet
                    - hvadBlevAftalt
                    - todos
                    - context
                  additionalProperties: false
                - type: 'null'
          required:
            - id
            - version
            - name
            - status
            - evidenceAudience
            - createdAt
            - updatedAt
            - appointmentDate
            - appointmentSubject
            - durationSec
            - internalNotes
            - company
            - content
          additionalProperties: false
      required:
        - summary
      additionalProperties: false
    ApiErrorResponse:
      additionalProperties: false
      properties:
        error:
          additionalProperties: false
          properties:
            code:
              enum:
                - CONFLICT
                - FEATURE_DISABLED
                - FORBIDDEN
                - IDEMPOTENCY_CONFLICT
                - INTERNAL_ERROR
                - INVALID_INPUT
                - INVALID_STATE
                - NOT_FOUND
                - PRECONDITION_REQUIRED
                - RATE_LIMITED
                - UNAUTHENTICATED
                - VERSION_CONFLICT
              type: string
            message:
              minLength: 1
              type: string
            requestId:
              maxLength: 128
              minLength: 1
              type: string
          required:
            - code
            - message
            - requestId
          type: object
      required:
        - error
      type: object
  securitySchemes:
    bearerAuth:
      bearerFormat: Floral PAT
      description: Authenticate with a workspace-pinned Floral personal access token.
      scheme: bearer
      type: http

````