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

# Create prechain product

> Registers an existing product instance as an upstream ("prechain") input
at one of your plants, with an optional transport route.

**Idempotent create** — a replay of the same `Idempotency-Key` returns the
original response (`200`); otherwise a new prechain product is created
(`201`). See [External IDs](/external-ids).




## OpenAPI

````yaml POST /v2/prechain-products
openapi: 3.1.0
info:
  title: Emidat API
  version: '2.0'
  description: >
    The Emidat API v2 lets manufacturers create products and supplier products

    programmatically — designed for ERP and system integrations.


    Authentication uses a simple API key (`X-API-Key` header). Keys are issued

    per manufacturer and managed in the Emidat dashboard.


    Keys follow the format `emidat-{key_id}-{secret}`, where `key_id` is a

    random public handle.


    **Onboarding steps** — performed once before creating products:

    - Plant and production process setup (via Emidat UI)

    - Discover Emidat material types and their `elementary_id` values with `GET
    /v2/elementaries`

    - Your material codes → Emidat material types and plant codes → Emidat
    plants are mapped in your integration middleware during setup; at runtime
    you send your own codes and the middleware resolves them

    - Create supplier companies via `POST /v2/supplier-companies` — every
    supplier plant needs one, as `supplier_company_id` is required

    - Create supplier plants via `POST /v2/supplier-plants`, referencing a
    supplier company by its Emidat `id`

    - Create supplier products using your own `external_id`; reference them in a
    product's BOM by their Emidat `id` (from the create response, or resolved
    via `GET …?external_id=`)

    - (Optional) Create silos to merge same-type supplier products from
    different suppliers — reference by their Emidat `id` in a product's BOM


    **Preview endpoints** — the `Elementaries`, `Product Instances`,

    `Prechain Products`, `Projects` and `EPDs` tags and the

    `GET /v2/products/{id}/lca-results` and

    `GET /v2/products/{id}/lca-results/auto` endpoints are in preview.

    They are live and supported,

    but their contract is not frozen: request and response shapes, field names,

    and error codes may still change in ways that break existing integrations,

    possibly without a deprecation period.
servers:
  - url: https://api.emidat.com
    description: Production
security:
  - ApiKeyAuth: []
paths:
  /v2/prechain-products:
    post:
      tags:
        - Prechain Products
      summary: Create prechain product
      description: >
        Registers an existing product instance as an upstream ("prechain") input

        at one of your plants, with an optional transport route.


        **Idempotent create** — a replay of the same `Idempotency-Key` returns
        the

        original response (`200`); otherwise a new prechain product is created

        (`201`). See [External IDs](/external-ids).
      operationId: v2_prechain_products_create
      parameters:
        - $ref: '#/components/parameters/IdempotencyKeyHeader'
      requestBody:
        required: true
        content:
          application/json:
            schema:
              $ref: '#/components/schemas/CreatePrechainProduct'
            example:
              external_id: PRECHAIN-CLINKER-001
              product_instance_id: 44444444-4444-4444-4444-444444444444
              plant_id: 11111111-1111-1111-1111-111111111111
              transport_route_id: 55555555-5555-5555-5555-555555555555
      responses:
        '200':
          description: Returned unchanged — an `Idempotency-Key` replay.
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/PrechainProduct'
        '201':
          description: Prechain product created.
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/PrechainProduct'
        '401':
          $ref: '#/components/responses/Unauthorized'
        '403':
          $ref: '#/components/responses/Forbidden'
        '409':
          description: |
            That product instance is already registered as a prechain product at
            that plant (`err_prechain_product_exists`) or is not a main product
            of its production process (`err_prechain_product_not_main_product`),
            the `external_id` is already in use by another active prechain
            product, or the `Idempotency-Key` was reused with a different
            request body.
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/Error'
        '422':
          description: |
            Validation error — e.g. unknown `product_instance_id` or `plant_id`,
            a `transport_route_id` that does not resolve or runs another lane
            (`err_transport_route_wrong_lane`), a `transport_route` that
            disagrees with it.
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/Error'
        '500':
          $ref: '#/components/responses/InternalServerError'
components:
  parameters:
    IdempotencyKeyHeader:
      name: Idempotency-Key
      in: header
      required: false
      schema:
        type: string
        minLength: 1
        maxLength: 255
      description: >
        Optional client-generated key of 1–255 characters (e.g. a UUID) that
        makes

        a create idempotent — the only mechanism that does so. A replay carrying
        the same

        key returns the original response unchanged (`200`); reusing a key with
        a

        different request body (compared byte for byte) or create endpoint is

        rejected with `409 err_idempotency_key_reused`. Concurrent requests with

        the same key receive `409 err_idempotency_in_progress`. Keys are scoped

        to your manufacturer; successful responses are retained for 6h without

        extending that window on replay. Current permissions are required on

        every retry; product-instance replays also require the original

        production-data scopes. Deduplication is best effort: Redis data loss

        can end the window early, and Redis unavailability, timeouts, or
        unreadable

        cache entries can allow creation without replay protection. Successful

        creates still return 201 if caching fails. Redis waits share a
        two-second

        budget excluding creation time. Incompatible replay-format upgrades

        reset replay protection, so retries across that boundary can create
        again.

        An interrupted create can reserve the key for up to 6h.

        See [External IDs](/external-ids) for recovery guidance.
  schemas:
    CreatePrechainProduct:
      type: object
      required:
        - external_id
        - product_instance_id
        - plant_id
      properties:
        external_id:
          anyOf:
            - type: string
            - type: 'null'
          description: |
            Your own code for this prechain product. Required; pass `null` if
            unset. A non-null code must be unique among your active prechain
            products; a duplicate returns `409` (see [External
            IDs](/external-ids)).
        product_instance_id:
          type: string
          format: uuid
          description: |
            UUID of the product instance used as the upstream input. Create via
            `POST /v2/product-instances`, or resolve your code with
            `GET /v2/product-instances?external_id=…`.
        plant_id:
          type: string
          format: uuid
          description: UUID of the plant that consumes this input.
        transport_route_id:
          anyOf:
            - type: string
              format: uuid
            - type: 'null'
          description: >
            UUID of the transport route this material travels. The route must

            run from the plant that makes the product instance to the consuming
            plant; one on another lane

            returns `422` (`err_transport_route_wrong_lane`). Create one with

            `POST /v2/transport-routes`, or find the routes on the lane with

            `GET /v2/transport-routes`.


            Replaces the deprecated `transport_route`. To change the distances

            of the route, update it with

            [`PUT
            /v2/transport-routes/{id}`](/api-reference/transport-routes/update)

            rather than sending `transport_route`.


            For clients still on the deprecated field: sent together with

            `transport_route` distances that differ from the named route's,

            the distances are applied to that route, as in v1: it is updated

            in place when no other material travels it, and otherwise forked

            into a new route on the lane that only this material moves to.

            Matching distances, as in an echoed GET response, change nothing.
        transport_route:
          deprecated: true
          description: >
            **Deprecated** — use `transport_route_id`. Distances for a route of

            this material's own, one per modality (km). Still accepted for

            existing clients.


            To change a route's distances, take `transport_route_id` from the

            GET response and update that route with

            [`PUT
            /v2/transport-routes/{id}`](/api-reference/transport-routes/update).
          anyOf:
            - $ref: '#/components/schemas/TransportRouteInput'
            - type: 'null'
    PrechainProduct:
      type: object
      required:
        - id
        - external_id
        - product_instance_id
        - plant_id
        - transport_route_id
        - transport_route
        - entry_units
        - impacts_per_kg
        - transport_impacts_per_kg
      description: >
        An existing product instance used as an upstream ("prechain") input at
        one

        of your plants, with an optional transport route and its per-kg impacts.
      properties:
        id:
          type: string
          format: uuid
        external_id:
          anyOf:
            - type: string
            - type: 'null'
          description: Your own code for this prechain product, or null if none.
        product_instance_id:
          type: string
          format: uuid
          description: UUID of the product instance used as the input.
        plant_id:
          type: string
          format: uuid
          description: UUID of the consuming plant.
        transport_route_id:
          anyOf:
            - type: string
              format: uuid
            - type: 'null'
          description: >
            UUID of the transport route this material travels from the plant
            that makes the product instance,

            or null if none. Read it with `GET /v2/transport-routes/{id}`.
        transport_route:
          deprecated: true
          description: >
            **Deprecated** — use `transport_route_id`. The distances of the
            route

            this material travels, one per modality (km). Still returned for

            existing clients.


            To change a route's distances, take `transport_route_id` from the

            GET response and update that route with

            [`PUT
            /v2/transport-routes/{id}`](/api-reference/transport-routes/update).
          anyOf:
            - $ref: '#/components/schemas/TransportRoute'
            - type: 'null'
        entry_units:
          type: array
          description: |
            Units this component's BOM amount can be given in, with today's kg
            per unit. Always includes `KG`.
          items:
            $ref: '#/components/schemas/EntryUnit'
        impacts_per_kg:
          anyOf:
            - type: array
              items:
                $ref: '#/components/schemas/Indicator'
            - type: 'null'
          description: Characterized impacts of the input per kg. Null until computed.
        transport_impacts_per_kg:
          anyOf:
            - type: array
              items:
                $ref: '#/components/schemas/Indicator'
            - type: 'null'
          description: Transport-only impacts per kg. Null until computed.
    Error:
      type: object
      required:
        - msg
        - err_code
      properties:
        msg:
          type: string
          description: Human-readable explanation, for logs and operators. Do not parse it.
          example: supplier product requires a supplier plant
        err_code:
          type: string
          description: >
            Stable, machine-readable error code — branch on this, never on
            `msg`.

            The set may grow over time; treat an unrecognized code as

            non-retryable and surface it to an operator. The enum lists every

            code the platform can emit; only a subset is reachable per

            endpoint — see [Errors](/errors) for the actionable catalog.


            `LcaRecomputeJob.err_code` reports failures from this same `err_*`

            namespace. `LcaBlocker.err_code` does not — those values are a

            separate, disjoint set.
          example: err_supplier_product_missing_supplier_plant
          enum:
            - err_invalid_query
            - err_invalid_cursor
            - err_stale_cursor
            - err_history_temporarily_unavailable
            - err_emigo_daily_limit_reached
            - err_not_defined
            - err_not_found
            - err_not_valid
            - err_not_authenticated
            - err_permission_denied
            - err_account_frozen
            - err_declaration_not_completed
            - err_declaration_not_regenerable
            - err_epd_document_already_exists
            - err_invalid_product_ids
            - err_comparison_unresolved
            - err_comparison_not_comparable
            - err_comparison_base_product_required
            - err_generate_products_limit
            - err_plant_missing_product_category
            - err_plant_incomplete_address
            - err_plant_incomplete_company_fields
            - err_plant_categories_not_covering_processes
            - err_plant_categories_not_covering_active_products
            - err_plant_invalid_category_id
            - err_plant_invalid_balancing_authority
            - err_plant_balancing_authority_non_us
            - err_plant_custom_electricity_mix_not_allowed
            - err_plant_electricity_mix_mismatch
            - err_plant_negative_electricity_values
            - err_plant_electricity_without_mix
            - err_electricity_plant_production_mismatch
            - err_lca_mass_balance
            - err_lca_allocation_data_incomplete
            - err_lca_production_output_mismatch
            - err_process_output_below_linked_output
            - err_product_mass_larger_than_recipe_mass
            - err_recipe_unit_not_available
            - err_product_category_not_allowed_at_plant
            - err_water_not_scoped_but_wastewater_is_scoped
            - err_more_wastewater_than_water
            - err_project_no_products
            - err_invalid_product_quantity
            - err_duplicate_product
            - err_product_missing_gwp_total
            - err_elementary_deactivated
            - err_product_missing_supplier
            - err_epd_unusable
            - err_epd_service
            - err_lca_update_not_queued
            - err_lca_export_not_ready
            - err_project_document_failed
            - err_not_ready_for_epd
            - err_material_not_hazardous
            - err_material_no_limited_lifetime
            - err_invalid_lifetime_years
            - err_invalid_secondary_percentage_range
            - err_secondary_percentage_not_customizable
            - err_moisture_content_not_bio_based
            - err_invalid_moisture_content_range
            - err_eow_state_not_overwritable
            - err_declaration_not_exists
            - err_declaration_not_under_review
            - err_no_manufacturer
            - err_company_setup_required
            - err_account_setup_complete
            - err_wrong_email_domain
            - err_user_exists
            - err_inviter_email_not_found
            - err_composite_used_in_supplier_products
            - err_composite_name_exists
            - err_plant_io_invalid_field
            - err_plant_io_field_not_switchable
            - err_plant_io_value_not_scoped
            - err_field_is_plant_level
            - err_negative_io_value
            - err_invalid_packaging_material
            - err_plant_io_mixed_allocation_groups
            - err_inies_sworn_statement_exists
            - err_supplier_in_use
            - err_supplier_name_exists
            - err_supplier_plant_in_use
            - err_supplier_plant_name_exists
            - err_supplier_product_in_recipe
            - err_supplier_product_in_silo
            - err_supplier_product_scoped_as_packaging
            - err_supplier_product_declared_on_a_product
            - err_packaging_scoped_by_the_process
            - err_packaging_declared_on_a_product
            - err_packaging_on_a_byproduct
            - err_supplier_product_missing_supplier_plant
            - err_silo_in_use
            - err_silo_name_exists
            - err_elementary_unknown_matching
            - err_product_document_not_deletable
            - err_product_has_declarations
            - err_product_instance_in_recipe
            - err_product_instance_has_declarations
            - err_prechain_product_in_recipe
            - err_prechain_product_exists
            - err_prechain_product_not_main_product
            - err_ccf_exists
            - err_ccf_not_completed
            - err_external_id_exists
            - err_external_owner_invitation_already_sent
            - err_external_owner_invitation_epd_taken
            - err_external_owner_invitation_message_missing
            - err_external_owner_invitation_exists
            - err_external_owner_invitation_not_deletable
            - err_external_owner_invitation_not_editable
            - err_external_owner_invitation_not_resendable
            - err_external_owner_invitation_not_sendable
            - err_external_owner_invitation_not_withdrawable
            - err_external_owner_invitation_no_contract
            - err_external_owner_invitation_multilingual
            - err_external_owner_invitation_preview_failed
            - err_external_owner_invitation_review_stale
            - err_external_owner_invitation_not_submittable
            - err_external_owner_invitation_not_confirmed
            - err_external_owner_invitation_confirmed
            - err_external_owner_invitation_epd_not_rebuildable
            - err_external_owner_invitation_send_failed
            - err_external_owner_invitation_send_limit
            - err_external_owner_invitation_already_started
            - err_external_owner_invitation_same_address
            - err_external_owner_invitation_subject_missing
            - err_idempotency_key_reused
            - err_idempotency_in_progress
            - err_address_not_found
            - err_customer_not_found
            - err_geocoding_unavailable
            - err_bulk_upload_invalid_file
            - err_bulk_upload_duplicate_headers
            - err_bulk_upload_ambiguous_headers
            - err_bulk_upload_ambiguous_values
            - err_bulk_upload_ambiguous_header_language
            - err_bulk_upload_mixed_header_languages
            - err_bulk_upload_language_mismatch
            - err_bulk_upload_value_language_mismatch
            - err_bulk_upload_obsolete_template
            - err_bulk_upload_missing_translation
            - err_bulk_upload_template_no_plants
            - err_bulk_upload_template_no_material_types
            - err_material_type_not_found
            - err_material_type_unvalidated
            - err_unvalidated_material_type_not_found
            - err_material_type_not_configured
            - err_unit_not_allowed_for_material
            - err_production_process_not_found
            - err_multiple_production_processes
            - err_process_plant_mismatch
            - err_material_process_incompatible
            - err_process_output_kind_change
            - err_production_process_required
            - err_composite_not_allowed_in_recipe
            - err_elementary_not_allowed_in_recipe
            - err_elementary_already_allowed_for_product
            - err_elementary_request_idempotency_conflict
            - err_prechain_circular_reference
            - err_product_type_no_recipe
            - err_product_mass_not_set
            - err_required_cell_empty
            - err_plant_not_found
            - err_plant_no_access
            - err_multiple_plants
            - err_product_already_exists
            - err_multiple_products
            - err_instance_material_type_mismatch
            - err_instance_unit_mismatch
            - err_instance_id_belongs_to_other
            - err_instance_id_differs_from_stored
            - err_duplicate_instance_id
            - err_instance_updated
            - err_bulk_change
            - err_bulk_unchanged
            - err_bulk_skipped_existing
            - err_instance_years_removed
            - err_annual_year_outside_stored_period
            - err_linked_product_type_mismatch
            - err_tech_spec_not_recognized
            - err_recipe_incomplete
            - err_packaging_incomplete
            - err_packaging_amount_invalid
            - err_packaging_not_found
            - err_packaging_ambiguous
            - err_packaging_duplicate
            - err_annual_output_invalid
            - err_annual_economic_value_invalid
            - err_annual_output_year_required
            - err_annual_output_year_invalid
            - err_annual_output_year_duplicate
            - err_annual_output_year_outside_period
            - err_orphan_row
            - err_duplicate_tech_spec
            - err_empty_sheet
            - err_no_products
            - err_tech_spec_invalid_value
            - err_dtp_service
            - err_data_translation_wrong_step
            - err_data_translation_invalid_plant_mapping
            - err_data_translation_unresolved_reference
            - err_data_translation_incomplete
            - err_data_translation_material_not_available
            - err_data_translation_duplicate_supplier_name
            - err_recycled_content_proof_missing
            - err_ppwr_declaration_exists
            - err_ppwr_declaration_editable_exists
            - err_ppwr_declaration_frozen
            - err_ppwr_doc_number_unavailable
            - err_ppwr_variant_mass_invalid
            - err_ppwr_variant_dimension_invalid
            - err_ppwr_variant_material_repeated
            - err_ppwr_variant_material_type
            - err_ppwr_invalid_field_key
            - err_ppwr_supplier_request_not_packaging_manufacturer
            - err_ppwr_supplier_request_pending
            - err_ppwr_supplier_request_not_pending
            - err_ppwr_field_not_requested
            - err_ppwr_document_limit_reached
            - err_ppwr_generation_not_packaging_manufacturer
            - err_ppwr_issuance_generation_in_progress
            - err_ppwr_issuance_reservation_released
            - err_license_not_started
            - err_ppwr_declaration_incomplete
            - err_ppwr_invalid_signatory
            - err_ppwr_invitation_send_failed
            - err_ppwr_supplier_link_placeholder_missing
            - err_ppwr_supplier_subject_missing
            - err_ppwr_supplier_email_missing
            - err_ppwr_verification_code_limit
            - err_ppwr_verification_code_send_failed
            - err_ppwr_email_not_verified
            - err_ppwr_attestation_required
            - err_ppwr_document_not_deletable
            - err_proof_document_limit
            - err_proof_size_limit
            - err_supplier_address_country_only
            - err_supplier_address_ignored
            - err_supplier_ignored_for_water
            - err_supplier_address_not_found
            - err_transport_distance_unresolved
            - err_transport_modality_duplicate
            - err_transport_modality_invalid
            - err_transport_route_unavailable
            - err_transport_missing_coordinates
            - err_transport_no_route
            - err_transport_same_address
            - err_transport_route_in_use
            - err_transport_route_name_exists
            - err_transport_route_invalid_polyline
            - err_transport_route_source_ambiguous
            - err_transport_route_no_materials_selected
            - err_transport_route_wrong_lane
            - err_transport_route_missing_source
            - err_reauthentication_required
            - err_two_factor_required
            - err_entitlement_limit_reached
            - err_licence_busy
            - err_program_operator_not_entitled
            - err_product_category_not_entitled
            - err_product_category_paused
            - err_translation_package_required
            - err_epd_tier_required
            - err_prechain_category_not_publishable
            - err_self_upgrade_not_offered
            - err_self_upgrade_request_required
            - err_self_upgrade_limit_changed
            - err_self_upgrade_unavailable
            - err_self_upgrade_in_progress
            - err_self_upgrade_already_requested
            - err_self_upgrade_offer_changed
            - err_upgrade_approval_not_pending
            - err_translation_unavailable
        entitlement_limit:
          anyOf:
            - $ref: '#/components/schemas/EntitlementLimitDetail'
            - type: 'null'
          description: |
            Structured context for `err_entitlement_limit_reached` — which
            licensed dimension is exhausted and the numbers behind it.
            Omitted on every other error, so check for presence rather than
            comparing against `null`.
        product_categories:
          anyOf:
            - type: array
              items:
                type: string
            - type: 'null'
          description: |
            For `err_product_category_not_entitled` and
            `err_product_category_paused`: the names of the product
            categories the license doesn't include, so a client can show
            them. Omitted on every other error, so check for presence rather
            than comparing against `null`.
        epd_category:
          anyOf:
            - type: integer
            - type: 'null'
          description: |
            For `err_epd_tier_required`: the pricing category (1-3) the EPD
            belongs to, which has no EPD tier booked. Omitted on every other
            error, so check for presence rather than comparing against `null`.
        license_start:
          anyOf:
            - type: string
              format: date
            - type: 'null'
          description: |
            For `err_license_not_started`: the day the license starts, before
            which its allowance can't be used. Omitted on every other error,
            so check for presence rather than comparing against `null`.
    TransportRouteInput:
      type: object
      description: >
        Transport distances to your gate, one per modality in km. Set at least
        one.

        Deprecated with the `transport_route` field that carries it; to change

        a route's distances use `PUT /v2/transport-routes/{id}`.
      properties:
        truck_distance_km:
          anyOf:
            - type: number
            - type: 'null'
          description: Distance by truck in km.
          example: 80
        train_distance_km:
          anyOf:
            - type: number
            - type: 'null'
          description: Distance by train in km.
        ship_distance_km:
          anyOf:
            - type: number
            - type: 'null'
          description: Distance by ship in km.
    TransportRoute:
      type: object
      description: |
        **Deprecated** — products now reference a transport route by
        `transport_route_id`. Transport distances to the consuming gate, one
        per modality in km. To change them, take `transport_route_id` from
        the product and update the route with `PUT /v2/transport-routes/{id}`.
      required:
        - truck_distance_km
        - train_distance_km
        - ship_distance_km
      properties:
        truck_distance_km:
          anyOf:
            - type: number
            - type: 'null'
          description: Distance by truck in km.
        train_distance_km:
          anyOf:
            - type: number
            - type: 'null'
          description: Distance by train in km.
        ship_distance_km:
          anyOf:
            - type: number
            - type: 'null'
          description: Distance by ship in km.
    EntryUnit:
      type: object
      required:
        - unit
        - kg_per_unit
      description: A unit a BOM amount of this component can be given in.
      properties:
        unit:
          type: string
          enum:
            - KG
            - M3
            - M2
            - M
            - UNIT
        kg_per_unit:
          type: number
          description: kg in one of `unit`, with today's conversion factors.
          example: 387
    Indicator:
      type: object
      required:
        - indicator_name
        - unit
        - value
      properties:
        indicator_name:
          type: string
          example: GWP-total
        unit:
          type: string
          example: kg CO2-Eq
        value:
          anyOf:
            - type: number
            - type: 'null'
          description: Null when the indicator could not be characterized.
          example: -1.7838794215158404
    EntitlementLimitDetail:
      type: object
      description: >-
        The exhausted license dimension behind an
        `err_entitlement_limit_reached` error.
      required:
        - dimension
        - usage
        - limit
      properties:
        dimension:
          type: string
          description: |
            The set may grow as more dimensions become enforced — treat an
            unrecognized value like the generic limit error.
          enum:
            - users
            - plants
            - product_instances
            - published_epds
            - translations
            - ppwr_issuances
        usage:
          type: integer
          description: What the account currently uses in this dimension.
        limit:
          type: integer
          description: What the license allows.
  responses:
    Unauthorized:
      description: >
        No credentials; or the key is malformed, unknown, revoked, or expired.
        The

        response is uniform and does not reveal which check failed.
      content:
        application/json:
          schema:
            $ref: '#/components/schemas/Error'
    Forbidden:
      description: >
        A valid key lacked the required permission, or targeted a resource
        outside

        its access.
      content:
        application/json:
          schema:
            $ref: '#/components/schemas/Error'
    InternalServerError:
      description: An unexpected server error occurred. Surface it to an operator.
      content:
        application/json:
          schema:
            $ref: '#/components/schemas/Error'
  securitySchemes:
    ApiKeyAuth:
      type: apiKey
      in: header
      name: X-API-Key
      description: |
        Per-manufacturer API key in the `X-API-Key` header, format
        `emidat-{key_id}-{secret}` where `key_id` is a random public handle.
        Issued by an owner in the Emidat
        dashboard; carries its own permission scopes, optional plant
        restrictions, and optional expiry. A revoked, expired, or unknown key
        returns 401. See the Authentication guide for details.

````

This documentation is built and hosted on [Mintlify](https://mintlify.com), a developer documentation platform.