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

# Get staff members

> Returns all staff members configured for the dealership

Returns all staff members configured for the site. Staff information is used by the AI to personalize content with real employee names and roles.

**Scope required:** `site:read`

<ResponseExample>
  ```json 200 theme={"theme":{"light":"github-light","dark":"github-dark"}}
  {
    "data": {
      "staff": [
        {
          "id": "a04ddd07-86c9-426d-b0b6-dae743cc9f2d",
          "first_name": "Malcolm",
          "last_name": "Heath",
          "role": "General Manager",
          "years_experience": 10,
          "created_at": "2025-11-10T18:18:18.005367+00:00",
          "updated_at": "2025-11-10T18:18:18.005367+00:00"
        },
        {
          "id": "29fdc0a4-7512-4713-bc8e-0cd3a23208c9",
          "first_name": "Kyle",
          "last_name": "Morissette",
          "role": "Service Director",
          "years_experience": 10,
          "created_at": "2025-10-22T17:42:50.189303+00:00",
          "updated_at": "2025-10-22T17:42:50.189303+00:00"
        }
      ]
    }
  }
  ```
</ResponseExample>


## OpenAPI

````yaml GET /site/staff
openapi: 3.1.0
info:
  title: Hrizn Public API
  version: 1.2.0
  description: >
    The Hrizn Public API allows partners to programmatically create content,
    manage inventory descriptions, and integrate with the Hrizn platform.


    All endpoints are prefixed with `/public` and require an API key passed via
    the `X-API-Key` header (except the health check).
  contact:
    email: support@hrizn.io
servers:
  - url: https://api.app.hrizn.io/v1/public
    description: Production
security:
  - apiKeyAuth: []
tags:
  - name: IdeaClouds
    description: Create and manage AI-powered keyword research
  - name: Content Intelligence
    description: AI-powered content gap analysis and recommendations
  - name: Content
    description: Generate content from IdeaClouds
  - name: Compliance
    description: Run OEM compliance checks on content
  - name: Content Tools
    description: Generate SEO metadata, schemas, and social snippets
  - name: Inventory
    description: Access vehicle data and AI descriptions
  - name: Site
    description: View dealership details and configuration
  - name: Webhooks
    description: Manage webhook subscriptions for real-time events
  - name: Reference
    description: Look up available types, scopes, and events
  - name: Social
    description: >-
      Zernio-backed social posting and reviews across all connected platforms
      (X, Facebook, Instagram, LinkedIn, Google Business Profile)
  - name: Health
    description: Health check (no authentication)
paths:
  /site/staff:
    get:
      tags:
        - Site
      summary: List staff members
      description: Returns all staff members configured for the dealership.
      operationId: getSiteStaff
      responses:
        '200':
          description: Staff members
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/SiteStaffResponse'
        '401':
          $ref: '#/components/responses/Unauthorized'
        '403':
          $ref: '#/components/responses/Forbidden'
        '500':
          $ref: '#/components/responses/InternalError'
components:
  schemas:
    SiteStaffResponse:
      type: object
      properties:
        data:
          type: object
          properties:
            staff:
              type: array
              items:
                type: object
                properties:
                  id:
                    type: string
                    format: uuid
                  first_name:
                    type: string
                    nullable: true
                  last_name:
                    type: string
                    nullable: true
                  role:
                    type: string
                    nullable: true
                  years_experience:
                    type: integer
                    nullable: true
                  created_at:
                    type: string
                    format: date-time
                  updated_at:
                    type: string
                    format: date-time
    ErrorResponse:
      type: object
      properties:
        error:
          type: object
          properties:
            code:
              type: string
              example: validation_error
            message:
              type: string
              example: 'keyword: Required'
            details:
              type: object
            request_id:
              type: string
  responses:
    Unauthorized:
      description: Missing or invalid API key
      content:
        application/json:
          schema:
            $ref: '#/components/schemas/ErrorResponse'
    Forbidden:
      description: API key lacks required scope
      content:
        application/json:
          schema:
            $ref: '#/components/schemas/ErrorResponse'
    InternalError:
      description: Internal server error
      content:
        application/json:
          schema:
            $ref: '#/components/schemas/ErrorResponse'
  securitySchemes:
    apiKeyAuth:
      type: apiKey
      in: header
      name: X-API-Key
      description: Your Hrizn API key (prefix hzk_)

````