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

# Add Pay Items

> Add pay items to a DRAFT pay run, of any type, for employees of its pay group.

An employee needs no other pay items in the run or the period. Lines are validated as
on submit and keyed by wage type code and `external_ref`: a line with a key the
employee already has in the run replaces it, any other line is added. The employees'
payslips in the run are deleted, so calculate the run again before approving it.

A run that is not DRAFT, one being calculated included, is refused with 409
`INVALID_TRANSITION` (`params.reason` `NOT_DRAFT`, `params.from` its status). An
employee outside the pay group, or a wage type missing from the catalog, is refused
with 422
`INVALID_REFERENCE` (`params.reason` `OTHER_PARENT` or `NOT_FOUND`); a wage type the
engine calculates is refused with 422 `GB_WAGE_TYPE_NOT_AN_INPUT`. `field` names the
entry or line in the request, e.g. `payroll_group[0].pay_details.earnings[1].wage_type_code`.

Refused (409) for an employee whose payslip in the run was calculated with prior-period
NI-able earnings supplied through submit: deleting it would drop them. Submit that
employee's items with the prior-period NI-able earnings instead.



## OpenAPI

````yaml /api-reference/preview.json post /gb/organizations/{organization_id}/payruns/{payrun_id}/pay-items
openapi: 3.2.0
info:
  description: Intermezzo's global payroll apis, organized by country
  summary: Global Payroll Platform
  title: Intermezzo Global Payroll
  version: '2026-11-18'
  x-logo:
    url: /static/icon.svg
servers:
  - description: Preview
    url: https://preview.intermezzo.ai
security: []
paths:
  /gb/organizations/{organization_id}/payruns/{payrun_id}/pay-items:
    post:
      tags:
        - Great Britain
        - Pay Items
      summary: Add Pay Items
      description: >-
        Add pay items to a DRAFT pay run, of any type, for employees of its pay
        group.


        An employee needs no other pay items in the run or the period. Lines are
        validated as

        on submit and keyed by wage type code and `external_ref`: a line with a
        key the

        employee already has in the run replaces it, any other line is added.
        The employees'

        payslips in the run are deleted, so calculate the run again before
        approving it.


        A run that is not DRAFT, one being calculated included, is refused with
        409

        `INVALID_TRANSITION` (`params.reason` `NOT_DRAFT`, `params.from` its
        status). An

        employee outside the pay group, or a wage type missing from the catalog,
        is refused

        with 422

        `INVALID_REFERENCE` (`params.reason` `OTHER_PARENT` or `NOT_FOUND`); a
        wage type the

        engine calculates is refused with 422 `GB_WAGE_TYPE_NOT_AN_INPUT`.
        `field` names the

        entry or line in the request, e.g.
        `payroll_group[0].pay_details.earnings[1].wage_type_code`.


        Refused (409) for an employee whose payslip in the run was calculated
        with prior-period

        NI-able earnings supplied through submit: deleting it would drop them.
        Submit that

        employee's items with the prior-period NI-able earnings instead.
      operationId: >-
        add_pay_items_gb_organizations__organization_id__payruns__payrun_id__pay_items_post
      parameters:
        - in: path
          name: organization_id
          required: true
          schema:
            title: Organization Id
            type: string
        - in: path
          name: payrun_id
          required: true
          schema:
            title: Payrun Id
            type: string
      requestBody:
        content:
          application/json:
            schema:
              $ref: '#/components/schemas/PayItemAddRequest'
        required: true
      responses:
        '200':
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/PayItemAddResponse'
          description: Successful Response
        '400':
          content:
            application/json:
              examples:
                ORG_BELONGS_TO_A_DIFFERENT_COUNTRY:
                  summary: >-
                    Raised when an organization belongs to a different country
                    than the one in the path.
                  value:
                    errors:
                      - code: ORG_BELONGS_TO_A_DIFFERENT_COUNTRY
                        message: >-
                          Raised when an organization belongs to a different
                          country than the one in the path.
                SACRIFICE_NOT_ALLOWED:
                  summary: >-
                    Raised when a line declares a sacrifice on a wage type whose
                    is_salary_sacrifice_allowed is false.
                  value:
                    errors:
                      - code: SACRIFICE_NOT_ALLOWED
                        message: >-
                          Raised when a line declares a sacrifice on a wage type
                          whose is_salary_sacrifice_allowed is false.
              schema:
                properties:
                  errors:
                    items:
                      additionalProperties: false
                      description: >-
                        Represents an error that occurred during processing.


                        Designed for client-side i18n:

                        - code: Use this to look up translation (e.g.,
                        "HUB_NOT_FOUND")

                        - message: English fallback if translation not available

                        - field: Field name for form validation highlighting

                        - params: Dynamic values for translation interpolation
                      properties:
                        code:
                          description: Unique error code for i18n lookup
                          enum:
                            - ORG_BELONGS_TO_A_DIFFERENT_COUNTRY
                            - SACRIFICE_NOT_ALLOWED
                          title: Code
                          type: string
                        field:
                          anyOf:
                            - type: string
                            - type: 'null'
                          description: Field that caused the error
                          title: Field
                        message:
                          description: English fallback error message
                          title: Message
                          type: string
                        params:
                          anyOf:
                            - additionalProperties: true
                              type: object
                            - type: 'null'
                          description: Parameters for translation interpolation
                          title: Params
                      required:
                        - code
                        - message
                      title: ErrorDetail
                      type: object
                    type: array
                required:
                  - errors
                title: ErrorResponse
                type: object
          description: >-
            - `ORG_BELONGS_TO_A_DIFFERENT_COUNTRY`: Raised when an organization
            belongs to a different country than the one in the path.

            - `SACRIFICE_NOT_ALLOWED`: Raised when a line declares a sacrifice
            on a wage type whose is_salary_sacrifice_allowed is false.
        '404':
          content:
            application/json:
              examples:
                HUB_NOT_FOUND:
                  summary: >-
                    Raised when a hub does not exist under the parent named in
                    the path.
                  value:
                    errors:
                      - code: HUB_NOT_FOUND
                        message: >-
                          Raised when a hub does not exist under the parent
                          named in the path.
                PAYRUN_NOT_FOUND:
                  summary: Raised when a payrun is not found.
                  value:
                    errors:
                      - code: PAYRUN_NOT_FOUND
                        message: Raised when a payrun is not found.
              schema:
                properties:
                  errors:
                    items:
                      additionalProperties: false
                      description: >-
                        Represents an error that occurred during processing.


                        Designed for client-side i18n:

                        - code: Use this to look up translation (e.g.,
                        "HUB_NOT_FOUND")

                        - message: English fallback if translation not available

                        - field: Field name for form validation highlighting

                        - params: Dynamic values for translation interpolation
                      properties:
                        code:
                          description: Unique error code for i18n lookup
                          enum:
                            - HUB_NOT_FOUND
                            - PAYRUN_NOT_FOUND
                          title: Code
                          type: string
                        field:
                          anyOf:
                            - type: string
                            - type: 'null'
                          description: Field that caused the error
                          title: Field
                        message:
                          description: English fallback error message
                          title: Message
                          type: string
                        params:
                          anyOf:
                            - additionalProperties: true
                              type: object
                            - type: 'null'
                          description: Parameters for translation interpolation
                          title: Params
                      required:
                        - code
                        - message
                      title: ErrorDetail
                      type: object
                    type: array
                required:
                  - errors
                title: ErrorResponse
                type: object
          description: >-
            - `HUB_NOT_FOUND`: Raised when a hub does not exist under the parent
            named in the path.

            - `PAYRUN_NOT_FOUND`: Raised when a payrun is not found.
        '409':
          content:
            application/json:
              examples:
                GB_NIC_PRIORS_WOULD_BE_LOST:
                  summary: >-
                    Raised when pay items are added for, or a move names,
                    employees whose current payslip in the pay run was
                    calculated with NIC prior-period niable earnings supplied
                    through submit.
                  value:
                    errors:
                      - code: GB_NIC_PRIORS_WOULD_BE_LOST
                        message: >-
                          Raised when pay items are added for, or a move names,
                          employees whose current payslip in the pay run was
                          calculated with NIC prior-period niable earnings
                          supplied through submit.
                INVALID_TRANSITION:
                  summary: >-
                    Raised when a pay run that is not DRAFT is changed: pay
                    items added or deleted, the run calculated or cancelled, or
                    employees moved into or out of it.
                  value:
                    errors:
                      - code: INVALID_TRANSITION
                        message: >-
                          Raised when a pay run that is not DRAFT is changed:
                          pay items added or deleted, the run calculated or
                          cancelled, or employees moved into or out of it.
              schema:
                properties:
                  errors:
                    items:
                      additionalProperties: false
                      description: >-
                        Represents an error that occurred during processing.


                        Designed for client-side i18n:

                        - code: Use this to look up translation (e.g.,
                        "HUB_NOT_FOUND")

                        - message: English fallback if translation not available

                        - field: Field name for form validation highlighting

                        - params: Dynamic values for translation interpolation
                      properties:
                        code:
                          description: Unique error code for i18n lookup
                          enum:
                            - INVALID_TRANSITION
                            - GB_NIC_PRIORS_WOULD_BE_LOST
                          title: Code
                          type: string
                        field:
                          anyOf:
                            - type: string
                            - type: 'null'
                          description: Field that caused the error
                          title: Field
                        message:
                          description: English fallback error message
                          title: Message
                          type: string
                        params:
                          anyOf:
                            - additionalProperties: true
                              type: object
                            - type: 'null'
                          description: Parameters for translation interpolation
                          title: Params
                      required:
                        - code
                        - message
                      title: ErrorDetail
                      type: object
                    type: array
                required:
                  - errors
                title: ErrorResponse
                type: object
          description: >-
            - `INVALID_TRANSITION`: Raised when a pay run that is not DRAFT is
            changed: pay items added or deleted, the run calculated or
            cancelled, or employees moved into or out of it.

            - `GB_NIC_PRIORS_WOULD_BE_LOST`: Raised when pay items are added
            for, or a move names, employees whose current payslip in the pay run
            was calculated with NIC prior-period niable earnings supplied
            through submit.
        '422':
          content:
            application/json:
              examples:
                GB_WAGE_TYPE_NOT_AN_INPUT:
                  summary: >-
                    Raised when a pay item added to a pay run names a
                    CALCULATED_ONLY system wage type, a pure engine output
                    (PAYE, NIC, loans, statutory pay).
                  value:
                    errors:
                      - code: GB_WAGE_TYPE_NOT_AN_INPUT
                        message: >-
                          Raised when a pay item added to a pay run names a
                          CALCULATED_ONLY system wage type, a pure engine output
                          (PAYE, NIC, loans, statutory pay).
                INVALID_REFERENCE:
                  summary: >-
                    Raised when pay items are added for employees who are not
                    members of the pay run's pay group on the pay calendar's pay
                    date.
                  value:
                    errors:
                      - code: INVALID_REFERENCE
                        field: payroll_group[0].employee_id
                        message: >-
                          Raised when pay items are added for employees who are
                          not members of the pay run's pay group on the pay
                          calendar's pay date.
                        params:
                          employee_ids:
                            - emp_01j0000000e008000000000002
                          id: emp_01j0000000e008000000000002
                          reason: OTHER_PARENT
                INVALID_REFERENCE (NOT_FOUND):
                  summary: >-
                    Raised when a pay item added to a pay run names a wage type
                    that is not in the organization's catalog on the pay
                    calendar's pay date.
                  value:
                    errors:
                      - code: INVALID_REFERENCE
                        field: >-
                          payroll_group[0].pay_details.earnings[0].wage_type_code
                        message: >-
                          Raised when a pay item added to a pay run names a wage
                          type that is not in the organization's catalog on the
                          pay calendar's pay date.
                        params:
                          id: UK-E-999
                          reason: NOT_FOUND
                PAY_PERIOD_UNRESOLVED:
                  summary: >-
                    Raised when a payrun's pay date and period type cannot be
                    mapped to a tax period — either the period type is one the
                    tax calendar does not support, or the pay date falls outside
                    the tax year.
                  value:
                    errors:
                      - code: PAY_PERIOD_UNRESOLVED
                        message: >-
                          Raised when a payrun's pay date and period type cannot
                          be mapped to a tax period — either the period type is
                          one the tax calendar does not support, or the pay date
                          falls outside the tax year.
              schema:
                properties:
                  errors:
                    items:
                      additionalProperties: false
                      description: >-
                        Represents an error that occurred during processing.


                        Designed for client-side i18n:

                        - code: Use this to look up translation (e.g.,
                        "HUB_NOT_FOUND")

                        - message: English fallback if translation not available

                        - field: Field name for form validation highlighting

                        - params: Dynamic values for translation interpolation
                      properties:
                        code:
                          description: Unique error code for i18n lookup
                          enum:
                            - INVALID_REFERENCE
                            - GB_WAGE_TYPE_NOT_AN_INPUT
                            - PAY_PERIOD_UNRESOLVED
                            - FIELD_REQUIRED
                            - FIELD_INVALID_TYPE_STRING
                            - FIELD_INVALID_TYPE_INT
                            - FIELD_INVALID_TYPE_FLOAT
                            - FIELD_INVALID_TYPE_BOOL
                            - FIELD_INVALID_TYPE_DICT
                            - FIELD_INVALID_TYPE_LIST
                            - FIELD_STRING_TOO_SHORT
                            - FIELD_STRING_TOO_LONG
                            - FIELD_STRING_PATTERN_MISMATCH
                            - FIELD_VALUE_TOO_SMALL
                            - FIELD_VALUE_TOO_LARGE
                            - FIELD_INVALID_DATE
                            - FIELD_INVALID_DATETIME
                            - FIELD_INVALID_TIME
                            - FIELD_INVALID_DATE_FORMAT
                            - FIELD_INVALID_DATETIME_FORMAT
                            - FIELD_INVALID_ENUM_VALUE
                            - FIELD_INVALID_EMAIL
                            - FIELD_INVALID_URL
                            - FIELD_LIST_TOO_SHORT
                            - FIELD_LIST_TOO_LONG
                            - FIELD_UNKNOWN
                            - FIELD_VALIDATION_ERROR
                          title: Code
                          type: string
                        field:
                          anyOf:
                            - type: string
                            - type: 'null'
                          description: Field that caused the error
                          title: Field
                        message:
                          description: English fallback error message
                          title: Message
                          type: string
                        params:
                          anyOf:
                            - additionalProperties: true
                              type: object
                            - type: 'null'
                          description: Parameters for translation interpolation
                          title: Params
                      required:
                        - code
                        - message
                      title: ErrorDetail
                      type: object
                    type: array
                required:
                  - errors
                title: ErrorResponse
                type: object
          description: >-
            The request failed validation. Type and format errors use the
            generic FIELD_* codes.

            - `INVALID_REFERENCE`: Raised when pay items are added for employees
            who are not members of the pay run's pay group on the pay calendar's
            pay date.

            - `INVALID_REFERENCE`: Raised when a pay item added to a pay run
            names a wage type that is not in the organization's catalog on the
            pay calendar's pay date.

            - `GB_WAGE_TYPE_NOT_AN_INPUT`: Raised when a pay item added to a pay
            run names a CALCULATED_ONLY system wage type, a pure engine output
            (PAYE, NIC, loans, statutory pay).

            - `PAY_PERIOD_UNRESOLVED`: Raised when a payrun's pay date and
            period type cannot be mapped to a tax period — either the period
            type is one the tax calendar does not support, or the pay date falls
            outside the tax year.
      security:
        - BearerToken: []
components:
  schemas:
    PayItemAddRequest:
      additionalProperties: false
      description: Pay items to add to a draft pay run, per employee.
      properties:
        payroll_group:
          description: >-
            Each line is keyed by its wage type code and `external_ref`, as on
            submit: a line whose key the employee already has in the run
            replaces that line, any other line is added. A line without
            `external_ref` is the wage type's single keyless line.
          items:
            $ref: '#/components/schemas/PayItemAddEntry'
          minItems: 1
          title: Payroll Group
          type: array
      required:
        - payroll_group
      title: PayItemAddRequest
      type: object
    PayItemAddResponse:
      additionalProperties: false
      properties:
        added_employee_ids:
          description: >-
            The employees given pay items, once each in request order. Their
            payslips in the run are deleted: calculate the run again before
            approving it.
          items:
            type: string
          title: Added Employee Ids
          type: array
      required:
        - added_employee_ids
      title: PayItemAddResponse
      type: object
    PayItemAddEntry:
      additionalProperties: false
      description: One employee's pay items, in submit's line schema.
      properties:
        employee_id:
          title: Employee Id
          type: string
        pay_details:
          $ref: '#/components/schemas/Gross'
          description: 'At least one line: an earning, benefit, deduction or reimbursement.'
      required:
        - employee_id
        - pay_details
      title: PayItemAddEntry
      type: object
    Gross:
      additionalProperties: false
      properties:
        benefits:
          anyOf:
            - items:
                $ref: '#/components/schemas/Benefits-Input'
              type: array
            - type: 'null'
          title: Benefits
        deductions:
          anyOf:
            - items:
                $ref: '#/components/schemas/Deductions-Input'
              type: array
            - type: 'null'
          title: Deductions
        earnings:
          anyOf:
            - items:
                discriminator:
                  mapping:
                    AMOUNT: '#/components/schemas/AmountEarnings-Input'
                    HOURS: '#/components/schemas/HoursEarnings'
                  propertyName: earning_type
                oneOf:
                  - $ref: '#/components/schemas/AmountEarnings-Input'
                  - $ref: '#/components/schemas/HoursEarnings'
              type: array
            - type: 'null'
          title: Earnings
        reimbursements:
          anyOf:
            - items:
                $ref: '#/components/schemas/Reimbursement-Input'
              type: array
            - type: 'null'
          title: Reimbursements
      required:
        - earnings
        - benefits
      title: Gross
      type: object
    Benefits-Input:
      additionalProperties: false
      properties:
        amount:
          anyOf:
            - minimum: 0
              type: number
            - type: string
            - type: 'null'
          default: '0.00'
          description: Amount of benefit
          title: Amount
        cash_alternative_amount:
          anyOf:
            - minimum: 0
              type: number
            - type: string
            - type: 'null'
          default: '0.00'
          description: >-
            Cash alternative the employee declined in favour of this benefit
            (Type B OpRA). Contributes to BIK higher-of valuation only; does NOT
            reduce gross. The wage type's is_salary_sacrifice_allowed must be
            true.
          title: Cash Alternative Amount
        external_ref:
          anyOf:
            - type: string
            - type: 'null'
          description: >-
            Caller-owned line key, scoped to (payrun, employee, wage_type).
            Re-send with the same value to patch that line in place. Omit for
            the single default line of the wage type (also patched in place on
            re-send). Use distinct values to carry multiple lines of one wage
            type.
          title: External Ref
        foregone_amount:
          anyOf:
            - minimum: 0
              type: number
            - type: string
            - type: 'null'
          default: '0.00'
          description: If subject to OpRa, amount foregone
          title: Foregone Amount
        make_good_amount:
          anyOf:
            - minimum: 0
              type: number
            - type: string
            - type: 'null'
          default: '0.00'
          description: Amount paid by employee for the benefit
          title: Make Good Amount
        wage_type_code:
          description: Wage type code from catalog (e.g. UK-B-001)
          title: Wage Type Code
          type: string
      required:
        - wage_type_code
      title: Benefits
      type: object
    Deductions-Input:
      additionalProperties: false
      properties:
        amount:
          anyOf:
            - minimum: 0
              type: number
            - type: string
          title: Amount
        external_ref:
          anyOf:
            - type: string
            - type: 'null'
          description: >-
            Caller-owned line key, scoped to (payrun, employee, wage_type).
            Re-send with the same value to patch that line in place. Omit for
            the single default line of the wage type (also patched in place on
            re-send). Use distinct values to carry multiple lines of one wage
            type.
          title: External Ref
        sacrificed_amount:
          anyOf:
            - minimum: 0
              type: number
            - type: string
            - type: 'null'
          description: >-
            Portion of this deduction that is pre-tax salary sacrifice (Type A
            OpRA). Must be > 0 and <= amount when set. The wage type's
            is_salary_sacrifice_allowed must be true.
          title: Sacrificed Amount
        wage_type_code:
          description: Wage type code from catalog (e.g. UK-D-001)
          title: Wage Type Code
          type: string
      required:
        - wage_type_code
        - amount
      title: Deductions
      type: object
    AmountEarnings-Input:
      additionalProperties: false
      description: Fixed-amount earnings (salary, bonus, allowance). Amount + frequency.
      properties:
        amount:
          anyOf:
            - type: number
            - type: string
          description: >-
            Earnings amount (negative values represent period adjustments, e.g.
            leave reductions)
          title: Amount
        earning_frequency:
          anyOf:
            - $ref: '#/components/schemas/PayCycle'
            - type: 'null'
          default: MONTH
          description: If recurring, specify the frequency
        earning_type:
          const: AMOUNT
          default: AMOUNT
          title: Earning Type
          type: string
        external_ref:
          anyOf:
            - type: string
            - type: 'null'
          description: >-
            Caller-owned line key, scoped to (payrun, employee, wage_type).
            Re-send with the same value to patch that line in place. Omit for
            the single default line of the wage type (also patched in place on
            re-send). Use distinct values to carry multiple lines of one wage
            type.
          title: External Ref
        is_lumpsum:
          default: false
          description: True if onetime. Defaults to False
          title: Is Lumpsum
          type: boolean
        sacrificed_amount:
          anyOf:
            - minimum: 0
              type: number
            - type: string
            - type: 'null'
          description: >-
            Amount of this earning the employee has sacrificed (Type A OpRA).
            Pre-tax. Must be > 0 when set. The wage type's
            is_salary_sacrifice_allowed must be true
          title: Sacrificed Amount
        wage_type_code:
          description: Wage type code from catalog (e.g. UK-E-001)
          title: Wage Type Code
          type: string
      required:
        - wage_type_code
        - amount
      title: AmountEarnings
      type: object
    HoursEarnings:
      additionalProperties: false
      description: Hours-based earnings. Gross = hours_worked x hourly_rate.
      properties:
        earning_type:
          const: HOURS
          default: HOURS
          title: Earning Type
          type: string
        external_ref:
          anyOf:
            - type: string
            - type: 'null'
          description: >-
            Caller-owned line key, scoped to (payrun, employee, wage_type).
            Re-send with the same value to patch that line in place. Omit for
            the single default line of the wage type (also patched in place on
            re-send). Use distinct values to carry multiple lines of one wage
            type.
          title: External Ref
        hourly_rate:
          anyOf:
            - minimum: 0
              type: number
            - type: string
          description: Hourly rate
          title: Hourly Rate
        hours_worked:
          anyOf:
            - minimum: 0
              type: number
            - type: string
          description: Number of hours worked
          title: Hours Worked
        is_lumpsum:
          default: false
          description: True if onetime. Defaults to False
          title: Is Lumpsum
          type: boolean
        sacrificed_amount:
          anyOf:
            - minimum: 0
              type: number
            - type: string
            - type: 'null'
          description: >-
            Amount of this earning the employee has sacrificed (Type A OpRA).
            Pre-tax. Must be > 0 and <= hours_worked x hourly_rate when set.
          title: Sacrificed Amount
        wage_type_code:
          description: Wage type code from catalog (e.g. UK-E-002)
          title: Wage Type Code
          type: string
      required:
        - wage_type_code
        - hours_worked
        - hourly_rate
      title: HoursEarnings
      type: object
    Reimbursement-Input:
      additionalProperties: false
      properties:
        amount:
          anyOf:
            - minimum: 0
              type: number
            - type: string
          title: Amount
        external_ref:
          anyOf:
            - type: string
            - type: 'null'
          description: >-
            Caller-owned line key, scoped to (payrun, employee, wage_type).
            Re-send with the same value to patch that line in place. Omit for
            the single default line of the wage type (also patched in place on
            re-send). Use distinct values to carry multiple lines of one wage
            type.
          title: External Ref
        wage_type_code:
          description: Wage type code from catalog (e.g. UK-R-001)
          title: Wage Type Code
          type: string
      required:
        - wage_type_code
        - amount
      title: Reimbursement
      type: object
    PayCycle:
      description: >-
        Employee pay cadence (WEEK, MONTH, etc.).


        The `UpperStrEnum` base keeps members equal to their upper-case names,
        so

        stored payloads and API strings round-trip.
      enum:
        - YEAR
        - MONTH
        - WEEK
        - TWO_WEEK
        - FOUR_WEEK
        - QUARTER
        - BIANNUAL
      title: PayCycle
      type: string
  securitySchemes:
    BearerToken:
      bearerFormat: JWT
      description: Get token from Auth0 and paste it here
      scheme: bearer
      type: http

````

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