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

# Archive template listing

> <Info>This API is in beta. Endpoints, fields, and behavior may still change, so avoid depending on it in production.</Info>

Archives a template listing made from an app, which takes it off the template gallery.

The listing stops showing in the gallery right away. Apps that people already made from the template aren't affected. The app itself isn't changed either, and once its listing is archived you can list it as a template again from the builder. Archiving a listing that's already archived succeeds and changes nothing.

You need to be an owner or admin of the app's workspace. For a listing shared only within a workspace, you need to be an owner or admin of that workspace.

Archiving a listing is limited to 30 requests a minute per caller.

<Note>This endpoint accepts a personal API key. A read-only key is refused.</Note>



## OpenAPI

````yaml /developers/references/app-management/app-management-openapi.json post /api/app-catalog-items/catalog/{item_id}/archive
openapi: 3.1.0
info:
  title: Base44 App Management API
  version: 1.0.0
servers:
  - url: https://app.base44.com
security:
  - PersonalAccessTokenAuth: []
paths:
  /api/app-catalog-items/catalog/{item_id}/archive:
    post:
      summary: Archive template listing
      description: >-
        <Info>This API is in beta. Endpoints, fields, and behavior may still
        change, so avoid depending on it in production.</Info>


        Archives a template listing made from an app, which takes it off the
        template gallery.


        The listing stops showing in the gallery right away. Apps that people
        already made from the template aren't affected. The app itself isn't
        changed either, and once its listing is archived you can list it as a
        template again from the builder. Archiving a listing that's already
        archived succeeds and changes nothing.


        You need to be an owner or admin of the app's workspace. For a listing
        shared only within a workspace, you need to be an owner or admin of that
        workspace.


        Archiving a listing is limited to 30 requests a minute per caller.


        <Note>This endpoint accepts a personal API key. A read-only key is
        refused.</Note>
      operationId: archive_item_api_app_catalog_items_catalog__item_id__archive_post
      parameters:
        - name: item_id
          in: path
          required: true
          schema:
            type: string
            description: >-
              ID of the template listing to archive. Get it from `catalog_items`
              in [Check app delete
              impact](/api-reference/check-app-delete-impact).
            title: Item Id
          description: >-
            ID of the template listing to archive. Get it from `catalog_items`
            in [Check app delete
            impact](/api-reference/check-app-delete-impact).
          example: 68b2f0c1a4d9e7001c3b5a22
      responses:
        '200':
          description: The listing is archived.
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/ArchivedTemplateListing'
        '401':
          description: Missing or invalid credentials.
        '403':
          description: >-
            You aren't an owner or admin of the workspace the listing belongs
            to, you don't have access to the app it was made from, or your API
            key is read-only.
        '404':
          description: >-
            The listing doesn't exist, or the app it was made from is outside
            the workspace or apps your API key is scoped to.
        '429':
          description: Rate limit reached. Retry later.
        '503':
          description: >-
            Database temporarily unavailable (`database_unavailable`): the data
            cluster did not answer in time. Retry after the `Retry-After`
            seconds.
          headers:
            Retry-After:
              description: Seconds to wait before retrying.
              schema:
                type: integer
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/StandardErrorEnvelope'
              examples:
                database_unavailable:
                  summary: database_unavailable
                  value:
                    error:
                      code: database_unavailable
                      message: Database temporarily unavailable, please retry
                      details: {}
      security:
        - PersonalAccessTokenAuth:
            - full_access
        - WorkspaceApiKeyAuth:
            - full_access
        - WorkspaceApiKeyBearerAuth:
            - full_access
components:
  schemas:
    ArchivedTemplateListing:
      properties:
        message:
          type: string
          title: Message
          description: Confirmation message.
          example: Item archived successfully
      type: object
      required:
        - message
      title: ArchivedTemplateListing
      description: Confirmation that the template listing is archived.
    StandardErrorEnvelope:
      properties:
        error:
          $ref: '#/components/schemas/StandardError'
          description: What went wrong.
      type: object
      required:
        - error
      title: StandardErrorEnvelope
      description: The error body returned in the standard envelope.
    StandardError:
      properties:
        code:
          type: string
          title: Code
          description: >-
            Stable machine-readable cause of the failure. Match on this, not on
            `message`.
          example: not_found
        message:
          type: string
          title: Message
          description: Human-readable explanation. It isn't a stable contract.
          example: App not found
        details:
          additionalProperties: true
          type: object
          title: Details
          description: >-
            Structured context for the failure, or an empty object when there's
            none.
          example: {}
      type: object
      required:
        - code
        - message
      title: StandardError
  securitySchemes:
    PersonalAccessTokenAuth:
      type: http
      scheme: bearer
      description: >-
        Personal access token, sent as `Authorization: Bearer <token>`. Each
        operation lists the permission it needs: `read_only` or `full_access`. A
        full-access token can call every operation. A read-only token can call
        only the operations that list `read_only`; anything else returns 403
        `read_only_credential_route_not_allowed`.
    WorkspaceApiKeyAuth:
      type: apiKey
      in: header
      name: api_key
      description: >-
        Workspace API key, sent as `api_key: <key>`. Each operation that accepts
        one lists what the key needs: a permission, `read_only` or
        `full_access`, like a personal access token, or a scope. A key without
        the scope gets 403 `workspace_api_key_scope_required`.
    WorkspaceApiKeyBearerAuth:
      type: http
      scheme: bearer
      description: >-
        Workspace API key, sent as `Authorization: Bearer <key>`. Accepted
        wherever `api_key` is, with the same permission.

````

This documentation is built and hosted on [Mintlify](https://mintlify.com), a developer documentation platform.