# Floral Documentation

> Guides and API reference for integrating with Floral.

## Docs

- [Floral documentation](https://docs.floral.so/index.md): Integrate relationship and meeting-intelligence data with Floral's public API.
- [Quickstart](https://docs.floral.so/quickstart.md): Authenticate and search relationships in a Floral workspace.
- [Work with companies](https://docs.floral.so/guides/companies.md): List, create, update, archive, and restore companies through Floral's public API.
- [Work with people](https://docs.floral.so/guides/people.md): List, create, update, archive, and restore people through Floral's public API.
- [Generate and read briefings](https://docs.floral.so/guides/briefings.md): List, filter, generate, and retrieve meeting briefings through Floral's public API.
- [Review and approve summaries](https://docs.floral.so/guides/summaries.md): List, retrieve, annotate, and approve meeting summaries through Floral's public API.
- [API overview](https://docs.floral.so/api/overview.md): Understand Floral's public API base URL, resources, versioning, and limits.
- [Authentication](https://docs.floral.so/api/authentication.md): Create and use a workspace-pinned Floral personal access token.
- [Reliability and retries](https://docs.floral.so/api/reliability.md): Use Floral's rate-limit, idempotency, concurrency, request-ID, and audit guarantees safely.
- [Errors](https://docs.floral.so/api/errors.md): Handle Floral's stable API error envelope, error codes, and request IDs.
- [Versioning and deprecation](https://docs.floral.so/api/versioning.md): Plan for compatible API changes, deprecation notices, and major-version migrations.
- [Search companies and people](https://docs.floral.so/api-reference/search/search-companies-and-people.md): Search active companies and people in one workspace.
- [Search the Danish company registry](https://docs.floral.so/api-reference/company-registry/search-the-danish-company-registry.md): Search company-register data by exact CVR or company name.
- [List companies](https://docs.floral.so/api-reference/companies/list-companies.md): List a cursor-paginated company collection in one workspace.
- [Create or resolve a company](https://docs.floral.so/api-reference/companies/create-or-resolve-a-company.md): Create a company or resolve the canonical workspace company for a supplied CVR.
- [Get a company](https://docs.floral.so/api-reference/companies/get-a-company.md): Get a bounded company profile and its active people.
- [Update a company](https://docs.floral.so/api-reference/companies/update-a-company.md): Apply a partial profile update and typed custom-field merge patch. Lifecycle, metadata, and custom fields require Work access.
- [Archive a company](https://docs.floral.so/api-reference/companies/archive-a-company.md): Soft archive an active company while preserving its stable ID.
- [Restore a company](https://docs.floral.so/api-reference/companies/restore-a-company.md): Restore an archived company with its stable ID.
- [List custom-field definitions](https://docs.floral.so/api-reference/custom-fields/list-custom-field-definitions.md): List active public custom-field definitions for companies or people.
- [List people](https://docs.floral.so/api-reference/people/list-people.md): List a cursor-paginated, data-minimized person collection in one workspace.
- [Create a person](https://docs.floral.so/api-reference/people/create-a-person.md): Create one person and optionally link an active company in the same workspace. Metadata and custom fields additionally require Work access.
- [Get a person](https://docs.floral.so/api-reference/people/get-a-person.md): Get a bounded person profile and linked company.
- [Update a person](https://docs.floral.so/api-reference/people/update-a-person.md): Partially update the approved person profile and active company link. Lifecycle stage, metadata, and custom-field changes additionally require Work access.
- [Archive a person](https://docs.floral.so/api-reference/people/archive-a-person.md): Soft-archive one active person while retaining its stable ID.
- [Restore a person](https://docs.floral.so/api-reference/people/restore-a-person.md): Restore one archived person while retaining its stable ID.
- [List briefings](https://docs.floral.so/api-reference/briefings/list-briefings.md): List a cursor-paginated briefing feed with status, company, and creation-time filters.
- [Create a briefing](https://docs.floral.so/api-reference/briefings/create-a-briefing.md): Create a pending briefing for an existing active company and enqueue one generation.
- [Get a briefing](https://docs.floral.so/api-reference/briefings/get-a-briefing.md): Get validated structured briefing content.
- [List summaries](https://docs.floral.so/api-reference/summaries/list-summaries.md): List a cursor-paginated meeting-summary feed with status, company, appointment-time, and evidence-audience filters.
- [Get a summary](https://docs.floral.so/api-reference/summaries/get-a-summary.md): Get validated structured meeting-summary content.
- [Update summary internal notes](https://docs.floral.so/api-reference/summaries/update-summary-internal-notes.md): Replace only the internal notes of a summary visible to the caller.
- [Approve a summary](https://docs.floral.so/api-reference/summaries/approve-a-summary.md): Approve a caller-created summary that is waiting for approval, optionally replacing public structured content and appointment time.

## OpenAPI Specs

- [public-v1](https://docs.floral.so/openapi/public-v1.json)

## Optional

- [Floral](https://floral.so)