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

# Get interview definition

> Retrieves the interview definition for a given interview-definition id or position id. Returns the compiled `calc_definition_json` plus basic metadata. Access is subject to the caller's row-level security.



## OpenAPI

````yaml https://cool.jobmojito.com/functions/v1/openapi get /job-interview-get
openapi: 3.1.0
info:
  title: JobMojito API
  version: 1.0.0
  description: >-
    Public API for JobMojito, served by Supabase Edge Functions. Authenticate
    with a Supabase JWT access token via the Authorization header.
servers:
  - url: https://cool.jobmojito.com/functions/v1
    description: Production
security: []
tags:
  - name: Interviews
    description: >-
      Create, configure and manage interview / coaching / assessment
      definitions.
  - name: Results
    description: >-
      Interview results, transcripts, reports, re-attempt requests and
      analytics.
  - name: Candidates
    description: List and manage candidates.
  - name: Knowledge base
    description: Upload documents used to generate knowledge-base interviews.
  - name: Resume & Form verification
    description: Pre-screen candidates from resumes and forms.
  - name: Admin
    description: >-
      Account administration — invite team/coaching users, manage sub-merchants
      and avatar templates.
paths:
  /job-interview-get:
    get:
      tags:
        - Interviews
      summary: Get interview definition
      description: >-
        Retrieves the interview definition for a given interview-definition id
        or position id. Returns the compiled `calc_definition_json` plus basic
        metadata. Access is subject to the caller's row-level security.
      parameters:
        - schema:
            type: string
            minLength: 1
            format: uuid
            description: >-
              Identifier of either an interview definition (single-stage) or a
              position definition (multi-stage). The function resolves whichever
              matches.
            example: 00000000-0000-0000-0000-000000000000
          required: true
          name: position_id
          in: query
      responses:
        '200':
          description: The resolved interview definition.
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/JobInterviewGetResponse'
        '401':
          description: Missing, expired or invalid access token.
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/Error'
        '404':
          description: >-
            No interview or position found for the given id (or hidden by
            row-level security).
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/Error'
        '422':
          description: Validation error.
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/Error'
        '500':
          description: Server error.
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/Error'
      security:
        - bearerAuth: []
components:
  schemas:
    JobInterviewGetResponse:
      type: object
      properties:
        name:
          type: string
          nullable: true
          description: Interview or position name.
        created_at:
          type: string
          nullable: true
          example: '2026-01-15T09:30:00.000Z'
        updated_at:
          type: string
          nullable: true
          example: '2026-01-20T14:05:00.000Z'
        calc_definition_json:
          nullable: true
          description: >-
            The compiled interview definition JSON (structure varies by
            interview type).
        is_multistage:
          type: boolean
          description: >-
            True when the id resolved to a multi-stage position rather than a
            single interview.
      required:
        - name
        - created_at
        - updated_at
        - is_multistage
    Error:
      type: object
      properties:
        error:
          type: string
          example: Field is required.
        name:
          type: string
          example: interview_result_id
      required:
        - error
  securitySchemes:
    bearerAuth:
      type: http
      scheme: bearer
      bearerFormat: JWT
      description: 'Supabase JWT access token, passed as `Authorization: Bearer <token>`.'

````