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

# Restore an archived eval prompt set

> Restore an archived prompt set.



## OpenAPI

````yaml /api/openapi.yaml post /v1/ai/eval/prompt-sets/{promptSetId}/unarchive
openapi: 3.1.0
info:
  title: Omni API
  description: >
    The Omni REST API provides programmatic access to your Omni instance for
    managing users, documents, queries, schedules, and more.  
  version: 1.0.0
  contact:
    name: Omni Support
    url: https://docs.omni.co
servers:
  - url: https://{instance}.omniapp.co/api
    description: Production
    variables:
      instance:
        default: blobsrus
        description: Your production Omni instance subdomain
  - url: https://{instance}.playground.exploreomni.dev/api
    description: Playground
    variables:
      instance:
        default: blobsrus
        description: Your playground Omni instance subdomain
security:
  - bearerAuth: []
  - orgApiKey: []
tags:
  - name: Who Am I
    description: Inspect your own user permissions
  - name: AI
    description: AI-powered query generation
  - name: AI Credit Controls
    description: Manage organization-level AI credit usage
  - name: AI Eval
    description: >-
      AI evaluation: manage prompt sets and runs used to score AI quality
      against curated prompt suites.
  - name: AI Model Suggestions
    description: Manage AI-generated suggestions for shared models
  - name: AI Routines
    description: >-
      Manage AI Routines: schedule recurring AI-powered tasks to run
      automatically on your data.
  - name: Documents v2
    description: >
      A draft-based workflow for creating and editing documents: create a
      document, patch a draft, then publish. Replaces the one-shot `PUT`/`PATCH`
      v1 document write endpoints.
  - name: Documents
    description: Create, retrieve, and manage documents
  - name: API Tokens
    description: >-
      Manage API tokens (Organization keys, Personal Access Tokens, MCP OAuth
      grants)
  - name: Connections
    description: Manage database connections
  - name: Connection environments
    description: Manage connection environments database connections
  - name: Content
    description: Unified content retrieval (documents and folders)
  - name: Content migration
    description: Export and import dashboards
  - name: Content validator
    description: Validate content against models and perform find/replace operations
  - name: Dashboard downloads
    description: Download dashboards and tiles as PDF, PNG, XLSX, CSV, or JSON files
  - name: Dashboard filters and controls
    description: Read and update dashboard filter and control default values
  - name: dbt
    description: Manage dbt configuration for connections
  - name: Document favorites
    description: Favorite and unfavorite documents
  - name: Document labels
    description: Apply and manage labels on documents
  - name: Document permissions
    description: Manage document-level access
  - name: Labels
    description: >
      Manage labels in an organization. Labels can be applied to documents and
      folders to help organize and categorize content.


      **Label types:**

      - **Basic labels**: Can be created and managed by any user

      - **Verified labels**: Indicate curated or officially sanctioned content.
      Admin-only.

      - **Homepage labels**: Appear on the organization homepage. Admin-only.
  - name: Folders
    description: Create and organize content folders
  - name: Folder permissions
    description: Manage folder-level access
  - name: Jobs
    description: Check status of asynchronous jobs
  - name: Models
    description: Create and manage data models
  - name: Model branches
    description: Manage model branches and merge changes
  - name: Model git configuration
    description: Manage git configuration for shared models
  - name: Queries
    description: Execute workbook queries
  - name: Schedules
    description: Create and manage scheduled tasks
  - name: Schedule recipients
    description: Manage schedule recipients
  - name: Schema refresh schedules
    description: Manage automated schema refresh schedules for connections
  - name: Topics
    description: Retrieve topic information from models
  - name: Uploads
    description: Manage file uploads
  - name: Users
    description: Manage users
  - name: User attributes
    description: Manage user attribute definitions
  - name: User groups
    description: Manage user groups
  - name: User model roles
    description: Manage model and connection role assignments for users
  - name: User group model roles
    description: Manage model and connection role assignments for user groups
  - name: Uploads
    description: Manage CSV and spreadsheet uploads
paths:
  /v1/ai/eval/prompt-sets/{promptSetId}/unarchive:
    post:
      tags:
        - AI Eval
      summary: Restore an archived eval prompt set
      description: Restore an archived prompt set.
      operationId: aiEvalPromptSetsUnarchive
      parameters:
        - schema:
            type: string
            format: uuid
            description: The unique identifier of the eval prompt set.
            example: 550e8400-e29b-41d4-a716-446655440000
          required: true
          description: The unique identifier of the eval prompt set.
          name: promptSetId
          in: path
      responses:
        '200':
          description: Prompt set restored successfully.
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/EvalPromptSetsUnarchiveResponse'
        '400':
          description: Invalid `promptSetId` — must be a UUID.
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/EvalApiError'
              example:
                detail: 'Bad Request: name: Required'
                status: 400
        '401':
          description: Missing or invalid API key.
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/EvalApiError'
              example:
                detail: 'Unauthorized: Missing or invalid API key'
                status: 401
        '403':
          description: Insufficient permissions.
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/EvalApiError'
              example:
                detail: AI eval requires at least Querier access on the model
                status: 403
        '404':
          description: Prompt set not found.
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/EvalApiError'
              example:
                detail: Prompt set not found
                status: 404
components:
  schemas:
    EvalPromptSetsUnarchiveResponse:
      type: object
      properties:
        prompt_set:
          $ref: '#/components/schemas/EvalPromptSet'
      required:
        - prompt_set
    EvalApiError:
      type: object
      description: Error response returned by the AI Eval endpoints.
      properties:
        detail:
          type: string
          description: Human-readable error message describing what went wrong.
        status:
          type: integer
          description: HTTP status code of the error.
      required:
        - detail
        - status
    EvalPromptSet:
      type: object
      properties:
        created_at:
          type:
            - string
            - 'null'
          description: ISO 8601 timestamp when the prompt set was created.
          example: '2025-01-15T10:00:00.000Z'
        description:
          type:
            - string
            - 'null'
          description: Optional human-readable description of the prompt set.
          example: Regression suite for the orders topic
        id:
          type: string
          format: uuid
          description: Unique identifier for the prompt set.
          example: 550e8400-e29b-41d4-a716-446655440000
        is_archived:
          type: boolean
          description: Whether the prompt set has been archived.
          example: false
        model_id:
          type: string
          format: uuid
          description: The shared model this prompt set is bound to.
          example: 880e8400-e29b-41d4-a716-446655440003
        name:
          type: string
          description: Human-readable name for the prompt set.
          example: Orders regression
        prompts:
          type: array
          items:
            $ref: '#/components/schemas/EvalPrompt'
          description: Prompts that make up the set.
        slug:
          type: string
          description: URL-safe identifier for the prompt set. Unique per `model_id`.
          example: orders-regression
        updated_at:
          type:
            - string
            - 'null'
          description: ISO 8601 timestamp when the prompt set was last updated.
          example: '2025-01-15T10:00:00.000Z'
      required:
        - created_at
        - description
        - id
        - is_archived
        - model_id
        - name
        - prompts
        - slug
        - updated_at
    EvalPrompt:
      type: object
      properties:
        created_at:
          type:
            - string
            - 'null'
          description: ISO 8601 timestamp when the prompt was created.
          example: '2025-01-15T10:00:00.000Z'
        expectation:
          type:
            - string
            - 'null'
          description: >-
            The expectation the analysis judge scores the analysis against, or
            null when none was set.
          example: The top product by revenue should be Aniseed Syrup.
        id:
          type: string
          format: uuid
          description: Unique identifier for the prompt.
          example: 770e8400-e29b-41d4-a716-446655440002
        prompt_text:
          type: string
          description: The natural language prompt text the AI is evaluated on.
          example: What are the top 5 products by revenue?
        updated_at:
          type:
            - string
            - 'null'
          description: ISO 8601 timestamp when the prompt was last updated.
          example: '2025-01-15T10:00:00.000Z'
      required:
        - created_at
        - expectation
        - id
        - prompt_text
        - updated_at
  securitySchemes:
    bearerAuth:
      type: http
      scheme: bearer
      bearerFormat: JWT
      description: >
        Can be either an [Organization API
        Key](/api/authentication#organization-api-keys) or [Personal Access
        Token (PAT)](/api/authentication#token-types).


        Include in the `Authorization` header as: `Bearer YOUR_TOKEN`
    orgApiKey:
      type: http
      scheme: bearer
      bearerFormat: JWT
      description: >
        Requires an [Organization API
        Key](/api/authentication#organization-api-keys). Personal Access Tokens
        (PATs) are not supported for this endpoint.


        Include in the `Authorization` header as: `Bearer ORGANIZATION_API_KEY`

````