Lattice Feedbacks API

openapi: 3.2.0
info:
  title: Lattice HRIS Competencies Feedbacks API
  description: 'REST API (v2) for Lattice''s HRIS product covering employee records, organizational hierarchy, and HR core data. Supports service account Bearer token authentication and is designed for HR system integrations including Okta SCIM provisioning. Also exposes v2 review submission endpoints shared with the Talent API.

    '
  version: v2
  contact:
    name: Lattice Developer Support
    email: customercare@lattice.com
    url: https://developers.lattice.com
  termsOfService: https://lattice.com/legal/terms-of-service
  license:
    name: Proprietary
    url: https://lattice.com/legal/terms-of-service
servers:
- url: https://api.latticehq.com/v2
  description: Lattice HRIS API v2 production server
security:
- BearerAuth: []
tags:
- name: Feedbacks
  description: Retrieve continuous feedback
paths:
  /feedbacks:
    get:
      summary: List feedbacks
      operationId: listFeedbacks
      tags:
      - Feedbacks
      description: Returns a paginated list of all continuous feedback in Lattice. Newest feedback will be returned first.
      parameters:
      - $ref: '#/components/parameters/limit'
      - $ref: '#/components/parameters/startingAfter'
      - name: onlyPublic
        in: query
        required: false
        schema:
          type: boolean
        description: Filter to public feedback only
      responses:
        '200':
          description: Paginated list of feedback
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/FeedbackList'
        '400':
          $ref: '#/components/responses/BadRequest'
        '422':
          $ref: '#/components/responses/UnprocessableEntity'
        '500':
          $ref: '#/components/responses/ServerError'
  /feedback/{id}:
    get:
      summary: Get feedback by ID
      operationId: getFeedback
      tags:
      - Feedbacks
      description: Returns a feedback with the given id. If cannot find feedback, returns a 404.
      parameters:
      - name: id
        in: path
        required: true
        schema:
          type: string
        description: The feedback identifier
      responses:
        '200':
          description: Feedback object
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/Feedback'
        '400':
          $ref: '#/components/responses/BadRequest'
        '404':
          $ref: '#/components/responses/NotFound'
        '422':
          $ref: '#/components/responses/UnprocessableEntity'
        '500':
          $ref: '#/components/responses/ServerError'
components:
  parameters:
    limit:
      name: limit
      in: query
      required: false
      schema:
        type: integer
        format: int32
      description: Maximum number of items to return per page
    startingAfter:
      name: startingAfter
      in: query
      required: false
      schema:
        type: string
      description: Cursor for fetching the next page of results
  responses:
    UnprocessableEntity:
      description: Unprocessable - request is syntactically valid but cannot be processed
      content:
        application/json:
          schema:
            $ref: '#/components/schemas/ErrorResponse'
    ServerError:
      description: Server error while processing request
      content:
        application/json:
          schema:
            $ref: '#/components/schemas/ErrorResponse'
    NotFound:
      description: Could not find the requested resource
      content:
        application/json:
          schema:
            $ref: '#/components/schemas/ErrorResponse'
    BadRequest:
      description: Invalid request parameters
      content:
        application/json:
          schema:
            $ref: '#/components/schemas/ErrorResponse'
  schemas:
    ErrorResponse:
      type: object
      properties:
        error:
          type: string
          description: Human-readable error message
      required:
      - error
    ObjectReference:
      type: object
      description: A lightweight reference to another Lattice object
      properties:
        id:
          type: string
        object:
          type: string
        url:
          type: string
      required:
      - id
      - object
      - url
    PaginatedList:
      type: object
      properties:
        object:
          type: string
          enum:
          - list
        hasMore:
          type: boolean
          description: Whether or not there are more elements available after this set
        endingCursor:
          type:
          - string
          - 'null'
          description: The cursor to use to get the next set of items in the list
      required:
      - object
      - hasMore
    Feedback:
      type: object
      properties:
        id:
          type: string
        object:
          type: string
        url:
          type: string
        author:
          $ref: '#/components/schemas/ObjectReference'
        targets:
          type: object
          description: FeedbackTargetsList of users the feedback addresses
        body:
          type: string
          description: Feedback text content
        associatedValues:
          type:
          - object
          - 'null'
          description: CompanyValuesList of related company values
        feedbackRequest:
          type:
          - object
          - 'null'
          description: Original feedback request; null if unsolicited
        competency:
          $ref: '#/components/schemas/ObjectReference'
        visibility:
          type: string
          description: Who can view this feedback
        isPublic:
          type: boolean
          description: Company-wide visibility flag
        createdAt:
          type: integer
          description: Unix timestamp
      required:
      - id
      - object
      - url
      - author
      - targets
      - body
      - visibility
      - isPublic
      - createdAt
    FeedbackList:
      allOf:
      - $ref: '#/components/schemas/PaginatedList'
      - type: object
        properties:
          data:
            type: array
            items:
              $ref: '#/components/schemas/Feedback'
        required:
        - data
  securitySchemes:
    BearerAuth:
      type: http
      scheme: bearer
      description: 'Service account API key passed as a Bearer token in the Authorization header. Example: Authorization: Bearer <your-api-key>

        '