> ## 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. # Approve a summary > Approve a caller-created summary that is waiting for approval, optionally replacing public structured content and appointment time. ## OpenAPI ````yaml /openapi/public-v1.json post /api/v1/workspaces/{workspaceSlug}/summaries/{id}/approve 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}/approve: post: tags: - Summaries summary: Approve a summary description: >- Approve a caller-created summary that is waiting for approval, optionally replacing public structured content and appointment time. operationId: approveSummaryV1 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: >- Required idempotency key. Exact retries of the same canonical request replay the original status, body, ETag, Location, and request ID for 24 hours. example: approveSummaryV1-20260816-001 in: header name: Idempotency-Key required: true schema: type: string minLength: 1 maxLength: 255 - description: >- Strong ETag from the latest detail or mutation response. A stale value returns 412 VERSION_CONFLICT. example: '"v1.c3VtbWFyeS0xNjgtMw"' in: header name: If-Match required: true schema: pattern: ^"(?:[^"\\]|\\.)*"$ type: string requestBody: content: application/json: example: appointmentDate: '2026-08-18T09:00:00.000Z' content: hvadBlevAftalt: aftaler: - aftale: Confirm the launch plan at the next meeting. ansvarlig: Customer team deadline: Before the next meeting hvadBlevDroeftet: emner: - beskrivelse: >- The teams reviewed delivery capacity and launch sequencing. emne: Launch planning rejstAf: fælles opsummering: The teams aligned on launch milestones and ownership. titel: Quarterly planning todos: opgaver: - ansvarlig: Customer team deadline: Friday opgave: Confirm the implementation owner. prioritet: høj schema: $ref: '#/components/schemas/SummaryApproveRequest' description: >- Optional edited structured content and appointment timestamp. Omit the body to approve the current values. Maximum 65536 bytes. required: false 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: context: [] hvadBlevAftalt: aftaler: - aftale: Confirm the launch plan at the next meeting. ansvarlig: Customer team deadline: Before the next meeting hvadBlevDroeftet: emner: - beskrivelse: >- The teams reviewed delivery capacity and launch sequencing. emne: Launch planning rejstAf: fælles opsummering: The teams aligned on launch milestones and ownership. titel: Quarterly planning todos: opgaver: - ansvarlig: Customer team deadline: Friday opgave: Confirm the implementation owner. prioritet: høj createdAt: '2026-08-15T10:00:00.000Z' durationSec: 2700 evidenceAudience: CUSTOMER id: 168 internalNotes: null name: Quarterly planning status: APPROVED updatedAt: '2026-08-15T10:30:00.000Z' version: v1.c3VtbWFyeS0xNjgtMw schema: $ref: '#/components/schemas/SummaryDetailResponse' description: Summary approved 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.c3VtbWFyeS0xNjgtMw"' 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 - INVALID_STATE - IDEMPOTENCY_CONFLICT type: string required: - code type: object type: object description: 'Stable errors: CONFLICT, INVALID_STATE, IDEMPOTENCY_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 POST \ --url 'https://app.floral.so/api/v1/workspaces/acme-nordic/summaries/168/approve' \ --header 'Authorization: Bearer $FLORAL_TOKEN' \ --header 'Idempotency-Key: approveSummaryV1-20260816-001' \ --header 'If-Match: "v1.c3VtbWFyeS0xNjgtMw"' \ --header 'Content-Type: application/json' \ --data '{ "appointmentDate": "2026-08-18T09:00:00.000Z", "content": { "hvadBlevAftalt": { "aftaler": [ { "aftale": "Confirm the launch plan at the next meeting.", "ansvarlig": "Customer team", "deadline": "Before the next meeting" } ] }, "hvadBlevDroeftet": { "emner": [ { "beskrivelse": "The teams reviewed delivery capacity and launch sequencing.", "emne": "Launch planning", "rejstAf": "fælles" } ] }, "opsummering": "The teams aligned on launch milestones and ownership.", "titel": "Quarterly planning", "todos": { "opgaver": [ { "ansvarlig": "Customer team", "deadline": "Friday", "opgave": "Confirm the implementation owner.", "prioritet": "høj" } ] } } }' components: schemas: SummaryApproveRequest: $schema: https://json-schema.org/draft/2020-12/schema type: object properties: appointmentDate: 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))$ content: type: object properties: titel: description: >- Short descriptive title that captures the meeting's main purpose in 3-10 words type: string maxLength: 200 opsummering: description: >- Two to four sentences of prose covering the meeting's main points, decisions, and next steps. Do not use lists or Markdown. type: string maxLength: 1500 hvadBlevDroeftet: default: emner: [] description: >- Section 1: What was discussed - the meeting's main topics, issues, and opportunities type: object properties: emner: description: >- Main topics, issues, and opportunities discussed during the meeting, usually three to seven items default: [] maxItems: 10 type: array items: type: object properties: emne: description: Short title for the discussed topic, about 5-12 words type: string maxLength: 200 beskrivelse: description: >- Two to four sentences explaining the discussion, including issues and opportunities type: string maxLength: 2000 rejstAf: description: >- Who mainly raised the topic: company, consultant, or shared discussion. Omitted when unclear. type: string enum: - virksomhed - konsulent - fælles required: - emne - beskrivelse additionalProperties: false required: - emner additionalProperties: false hvadBlevAftalt: default: {} description: >- Section 2: What was agreed - the meeting's main decisions and agreements type: object properties: aftaler: description: >- Main agreements and decisions from the meeting, usually four to ten when available. May be empty when no concrete agreement was made. maxItems: 12 type: array items: type: object properties: aftale: description: >- One or two sentences describing what was agreed or decided type: string maxLength: 1500 ansvarlig: description: >- Who owns the agreement: the company, the consultant, or a named person or role. Omitted when unclear. type: string maxLength: 200 deadline: description: >- Time frame or deadline, such as 'Before the next meeting' or '01.10.2025'. Omitted when unclear. type: string maxLength: 200 required: - aftale additionalProperties: false ingenAftaler: description: >- States that no concrete agreements were made and includes any expected next steps type: string maxLength: 1500 additionalProperties: false todos: default: {} description: 'Section 3: Tasks - a concrete follow-up checklist' type: object properties: opgaver: description: >- Concrete follow-up tasks that are clearly supported by the meeting maxItems: 15 type: array items: type: object properties: opgave: description: One or two sentences describing the task type: string maxLength: 1500 ansvarlig: description: >- Who owns the task: the company, consultant, or a named person. Omitted when unclear. type: string maxLength: 200 deadline: description: >- Task deadline, such as '01.10.2025' or 'Not set'. Omitted when unclear. type: string maxLength: 200 prioritet: description: >- Task priority based on the meeting context. Omitted when it cannot be assessed. type: string enum: - høj - mellem - lav required: - opgave additionalProperties: false additionalProperties: false required: - hvadBlevDroeftet - hvadBlevAftalt - todos additionalProperties: false 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: >- Short descriptive title that captures the meeting's main purpose in 3-10 words type: string maxLength: 200 opsummering: description: >- Two to four sentences of prose covering the meeting's main points, decisions, and next steps. Do not use lists or Markdown. type: string maxLength: 1500 hvadBlevDroeftet: default: emner: [] description: >- Section 1: What was discussed - the meeting's main topics, issues, and opportunities type: object properties: emner: description: >- Main topics, issues, and opportunities discussed during the meeting, usually three to seven items default: [] maxItems: 10 type: array items: type: object properties: emne: description: >- Short title for the discussed topic, about 5-12 words type: string maxLength: 200 beskrivelse: description: >- Two to four sentences explaining the discussion, including issues and opportunities type: string maxLength: 2000 rejstAf: description: >- Who mainly raised the topic: company, consultant, or shared discussion. Omitted when unclear. type: string enum: - virksomhed - konsulent - fælles required: - emne - beskrivelse additionalProperties: false required: - emner additionalProperties: false hvadBlevAftalt: default: {} description: >- Section 2: What was agreed - the meeting's main decisions and agreements type: object properties: aftaler: description: >- Main agreements and decisions from the meeting, usually four to ten when available. May be empty when no concrete agreement was made. maxItems: 12 type: array items: type: object properties: aftale: description: >- One or two sentences describing what was agreed or decided type: string maxLength: 1500 ansvarlig: description: >- Who owns the agreement: the company, the consultant, or a named person or role. Omitted when unclear. type: string maxLength: 200 deadline: description: >- Time frame or deadline, such as 'Before the next meeting' or '01.10.2025'. Omitted when unclear. type: string maxLength: 200 required: - aftale additionalProperties: false ingenAftaler: description: >- States that no concrete agreements were made and includes any expected next steps type: string maxLength: 1500 additionalProperties: false todos: default: {} description: 'Section 3: Tasks - a concrete follow-up checklist' type: object properties: opgaver: description: >- Concrete follow-up tasks that are clearly supported by the meeting maxItems: 15 type: array items: type: object properties: opgave: description: One or two sentences describing the task type: string maxLength: 1500 ansvarlig: description: >- Who owns the task: the company, consultant, or a named person. Omitted when unclear. type: string maxLength: 200 deadline: description: >- Task deadline, such as '01.10.2025' or 'Not set'. Omitted when unclear. type: string maxLength: 200 prioritet: description: >- Task priority based on the meeting context. Omitted when it cannot be assessed. type: string enum: - høj - mellem - lav required: - opgave additionalProperties: false additionalProperties: false context: description: >- Tag slugs for the meeting's main themes. Use only supplied taxonomy slugs that were clearly discussed. May be empty. 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 ````