> ## 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.

# Generate a signed interview URL

> Generates a public, token-signed URL for an existing interview, profile, or result. The required id fields depend on `type`.



## OpenAPI

````yaml https://cool.jobmojito.com/functions/v1/openapi post /job-interview-token
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-token:
    post:
      tags:
        - Interviews
      summary: Generate a signed interview URL
      description: >-
        Generates a public, token-signed URL for an existing interview, profile,
        or result. The required id fields depend on `type`.
      requestBody:
        required: true
        content:
          application/json:
            schema:
              $ref: '#/components/schemas/JobInterviewTokenRequest'
      responses:
        '200':
          description: The signed URL.
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/JobInterviewTokenResponse'
        '401':
          description: Missing, expired or invalid access token.
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/Error'
        '422':
          description: >-
            Validation error (invalid type, missing conditional fields,
            unauthenticated, or interview not found).
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/Error'
        '500':
          description: Server error (includes authorization failures).
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/Error'
      security:
        - bearerAuth: []
components:
  schemas:
    JobInterviewTokenRequest:
      type: object
      properties:
        type:
          type: string
          enum:
            - interview-for-profile
            - results-for-profile
            - interview-result-candidate
            - interview-result-talent-seeker
            - interview-results-for-position
          description: Which kind of signed URL to generate.
        merchant_id:
          type: string
          description: Override merchant id (admin / sub-merchant only).
        interview_profile_id:
          type: string
          description: >-
            Candidate profile id. Required for interview-for-profile and
            results-for-profile.
        interview_id:
          type: string
          description: >-
            Interview or position id. Required for interview-for-profile and
            interview-results-for-position.
        interview_result_id:
          type: string
          description: >-
            Interview result id. Required for interview-result-candidate and
            interview-result-talent-seeker.
        hide_menu:
          anyOf:
            - type: string
            - type: boolean
          description: >-
            Pass the string 'false' to show the navigation menu; any other value
            hides it (default).
      required:
        - type
    JobInterviewTokenResponse:
      type: string
      description: The signed interview URL.
      example: >-
        https://interviews.example.com/interview/take/<id>/?interview_token=<jwt>&view_hm=true
    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>`.'

````