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

# Unarchive MCP Connection

> Connections to external systems that AI agents can call tools against.

A connection is created as a draft pinned to the connector's current version. Fill its
credentials directly with ``config``, or mint a setup link and let a third party fill
them in their own browser; then ``PATCH {"active": true}`` to put it in service. Each
connector may hold several connections, one per account you connect, each with its own
slug — which is also the namespace its tools are exposed under.

On plans with access control, visibility and writes follow the access granted on each
connection: viewers see it, editors edit its description and tags, managers change
everything else — configuration, state, slug, the exposed tools, setup links and
disconnection. Admins and owners always have full access.



## OpenAPI

````yaml POST /api/v1/live-connections/{slug}/unarchive/
openapi: 3.0.3
info:
  title: Nekt API
  version: v1
  description: Nekt API Documentation
  contact:
    email: support@nekt.ai
servers:
  - url: https://api.nekt.ai
security: []
paths:
  /api/v1/live-connections/{slug}/unarchive/:
    post:
      tags:
        - v1
      description: >-
        Connections to external systems that AI agents can call tools against.


        A connection is created as a draft pinned to the connector's current
        version. Fill its

        credentials directly with ``config``, or mint a setup link and let a
        third party fill

        them in their own browser; then ``PATCH {"active": true}`` to put it in
        service. Each

        connector may hold several connections, one per account you connect,
        each with its own

        slug — which is also the namespace its tools are exposed under.


        On plans with access control, visibility and writes follow the access
        granted on each

        connection: viewers see it, editors edit its description and tags,
        managers change

        everything else — configuration, state, slug, the exposed tools, setup
        links and

        disconnection. Admins and owners always have full access.
      operationId: v1_live_connections_unarchive_create
      parameters:
        - in: path
          name: slug
          schema:
            type: string
            description: >-
              Stable identifier and tool namespace; globally unique. Defaults to
              the connector slug (uniquified) when left blank.
          required: true
      requestBody:
        content:
          application/json:
            schema:
              $ref: '#/components/schemas/LiveConnection'
          application/x-www-form-urlencoded:
            schema:
              $ref: '#/components/schemas/LiveConnection'
          multipart/form-data:
            schema:
              $ref: '#/components/schemas/LiveConnection'
        required: true
      responses:
        '200':
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/LiveConnection'
          description: ''
      security:
        - ApiKeyAuth: []
components:
  schemas:
    LiveConnection:
      type: object
      description: >-
        A connection to an external system that AI agents can call tools
        against.
      properties:
        id:
          type: string
          format: uuid
          readOnly: true
        connector:
          type: string
          description: Connector of this connection (Expandable)
        connector_version:
          type: string
          format: uuid
          readOnly: true
        connector_config:
          type: object
          additionalProperties: {}
          readOnly: true
        config:
          writeOnly: true
        callback_webhook:
          allOf:
            - $ref: '#/components/schemas/LiveConnectionCallbackWebhook'
          writeOnly: true
          nullable: true
        has_callback_webhook:
          type: boolean
          readOnly: true
        credentials_version:
          type: integer
          readOnly: true
          description: >-
            Bumped whenever connector_config changes (in the viewset/serializer,
            not a signal); the MCP uses it to invalidate its credential cache
        active:
          type: boolean
          description: The user on/off toggle. Activating clears draft and error.
        draft:
          type: boolean
          readOnly: true
          description: >-
            Not yet activated for the first time; the setup-link flow is only
            valid while draft (or error).
        error:
          type: boolean
          readOnly: true
          description: >-
            Set by the credential broker on a refused OAuth refresh; the
            connection needs a reconnect and is not served while set.
        archived:
          type: boolean
          readOnly: true
          description: >-
            Set via the archive/unarchive endpoints (mirrors Pipeline.archived);
            archived connections are never served to the MCP server.
        slug:
          type: string
          description: >-
            Stable identifier and tool namespace; globally unique. Defaults to
            the connector slug (uniquified) when left blank.
          maxLength: 256
          pattern: ^[-a-zA-Z0-9_]+$
        description:
          type: string
          nullable: true
        available_tools:
          type: array
          items:
            type: string
        tags:
          type: array
          items: {}
          readOnly: true
        permission_level:
          type: string
          readOnly: true
          nullable: true
        created_by:
          type: object
          additionalProperties: {}
          readOnly: true
        created_at:
          type: string
          format: date-time
          readOnly: true
        updated_at:
          type: string
          format: date-time
          readOnly: true
      required:
        - archived
        - connector
        - connector_config
        - connector_version
        - created_at
        - created_by
        - credentials_version
        - draft
        - error
        - has_callback_webhook
        - id
        - permission_level
        - tags
        - updated_at
    LiveConnectionCallbackWebhook:
      type: object
      description: >-
        Where Nekt announces that someone finished configuring this connection
        through a setup link.
      properties:
        url:
          type: string
          format: uri
          maxLength: 2048
        header_name:
          type: string
          maxLength: 256
        header_value:
          type: string
          writeOnly: true
          maxLength: 2048
      required:
        - url
  securitySchemes:
    ApiKeyAuth:
      type: apiKey
      in: header
      name: x-api-key
      description: 'API Key authentication. Format: ''x-api-key: api_key'''

````