# Smart EPD

> Smart EPD is a platform for authoring, validating, verifying, and publishing Environmental Product Declarations (EPDs). Its v2 REST API covers the full workflow — workspace setup, EPD drafting against PCR-derived schemas, read-only pre-submit validation, LCA submission, third-party verification, and constraint-validated variant EPD generation.

Key facts for agents:

- Base URLs: sandbox `https://sandbox.smartepd.xyz` (develop here), production `https://app.smartepd.com`.
- Auth: `Authorization: Bearer <key>` with a workspace-scoped API key (`sk_...`); JWTs also accepted. Exception: the public EPD library (`GET /api/v2/public/epds/`) is anonymous — send no credentials.
- OpenAPI spec (endpoint source of truth): https://docs.smartepd.com/openapi/v2.json
- All hand-written docs in one file: https://docs.smartepd.com/llms-full.txt (endpoint reference is the OpenAPI spec above)
- Every page below is raw Markdown; the same path without `.md` is the human-readable HTML version.
- Errors use a stable envelope `{"error": {"code", "message", "details"?}}`; 404 also masks resources you lack access to.
- List endpoints use cursor pagination: request `?limit=&cursor=`, response `{"data", "next_cursor", "has_more"}`.

## Start here

- [AI Agent Integration](https://docs.smartepd.com/guides/agent-integration.md): grounding an agent on Smart EPD — doc surfaces, auth, the draft → validate → submit loop, and a copy-paste context block.
- [API Quickstart](https://docs.smartepd.com/guides/api-quickstart.md): end-to-end curl walkthrough — API key, workspace, category, project, EPD document, validation, submission, variants.
- [Authentication & Access](https://docs.smartepd.com/getting-started/authentication.md): auth methods, API keys, and the layered organization/workspace/project permission model.
- [Introduction](https://docs.smartepd.com/index.md): what Smart EPD is, who uses it, and how the docs are organized.
- [Platform Overview](https://docs.smartepd.com/getting-started/platform-overview.md): the entity hierarchy and the two EPD workflows (manual vs. tool-based).

## Concepts

- [Terminology](https://docs.smartepd.com/concepts/terminology.md): glossary of platform terms (EPD, PCR, PCC, LCA, workspace, template, variant, and more).
- [Data Model](https://docs.smartepd.com/concepts/data-model.md): entity relationships and schemas for API integrators.
- [EPD Schema (API)](https://docs.smartepd.com/concepts/epd-schema.md): the per-EPD schema endpoint — field definitions, requirements, constraints, and the summary view for integrations.
- [Specifications & Validation](https://docs.smartepd.com/concepts/specs-and-validation.md): the layered spec system (standards → PCR specs → templates) and how requirements resolve.
- [EPD Templating](https://docs.smartepd.com/concepts/epd-templating.md): how templates define the verified modeling envelope for a tool.
- [Roles & Access Control](https://docs.smartepd.com/concepts/roles-and-access.md): permission model reference.

## Task guides

- [Public EPD Library](https://docs.smartepd.com/guides/public-epd-library.md): anonymous listing of every published EPD across both Smart EPD platforms (v2 + classic v1) — search, gapless newest-first pagination, `unavailable_platforms`.
- [Writing Results Data](https://docs.smartepd.com/guides/writing-results-data.md): shaping impacts, resource uses, and output flows in the EPD document.
- [Reference EPDs & Constraints](https://docs.smartepd.com/guides/reference-epds-and-constraints.md): morphing an EPD to a reference, locking fields, and configuring template constraints.
- [Variant EPDs](https://docs.smartepd.com/guides/variant-epds.md): generating constraint-validated variants from a reference EPD.
- [LCA Submission](https://docs.smartepd.com/guides/lca-submission.md): the project-level LCA workflow — documents, submission, review.
- [Tool Verification & Constraints](https://docs.smartepd.com/guides/tool-verification-and-constraints.md): how LCA tools are verified and constrained within a category.
- [Verification Testing Shortcuts](https://docs.smartepd.com/guides/verification-testing.md): sandbox-only `force_status` / force-approve options for exercising the full lifecycle without human verifiers.

## Workflows

- [Onboarding & Setup](https://docs.smartepd.com/workflows/onboarding-workflow.md): how organizations, workspaces, and categories get created.
- [EPD Lifecycle](https://docs.smartepd.com/workflows/epd-lifecycle.md): every EPD status and the transitions between them.
- [Verification Workflow](https://docs.smartepd.com/workflows/verification-workflow.md): what happens between submission and publication.

## API reference

- [API Reference Overview](https://docs.smartepd.com/api-reference.md): how the endpoint reference is organized, plus the OpenAPI spec download.
- [Pagination](https://docs.smartepd.com/api-reference/pagination.md): the cursor model — parameters, response keys, iteration pattern, ordering caveat.
- [Errors](https://docs.smartepd.com/api-reference/errors.md): the error envelope, the error-code table, and which failures bypass the envelope.
- [OpenAPI spec (JSON)](https://docs.smartepd.com/openapi/v2.json): machine-readable spec for all public v2 endpoints; regenerated on every docs deploy.

## Optional

- [Lateral Workbook Format](https://docs.smartepd.com/concepts/lateral-workbook-format.md): the v1 spreadsheet import format (legacy).
- [Release Notes](https://docs.smartepd.com/release-notes.md): platform change log.