naftiko: 1.0.0-alpha2
info:
  label: Vital Link API
  description: Vital Link API. 14 operations. Self-contained Naftiko capability covering the Link business surface of the
    Junction (Vital) health-data platform.
  tags:
  - Vital
  - Junction
  - Link
  created: '2026-05-25'
  modified: '2026-05-25'
binds:
- namespace: env
  keys:
    VITAL_API_KEY: VITAL_API_KEY
capability:
  consumes:
  - type: http
    namespace: link
    baseUri: https://api.us.junction.com
    description: Vital Link API business capability. Self-contained, no shared references.
    resources:
    - name: v2-link-bulk-op
      path: /v2/link/bulk_op
      operations:
      - name: list_bulk_ops_v2_link_bulk_op_get
        method: GET
        description: List Bulk Ops
        outputRawFormat: json
        outputParameters:
        - name: result
          type: object
          value: $.
        inputParameters:
        - name: next_cursor
          in: query
          type: string
          description: ''
          required: false
        - name: page_size
          in: query
          type: integer
          description: ''
          required: false
    - name: v2-link-bulk-import
      path: /v2/link/bulk_import
      operations:
      - name: bulk_import_connections_v2_link_bulk_import_post
        method: POST
        description: Bulk Import Connections
        outputRawFormat: json
        outputParameters:
        - name: result
          type: object
          value: $.
        inputParameters:
        - name: body
          in: body
          type: object
          description: Request body (JSON).
          required: true
    - name: v2-link-bulk-trigger-historical-pull
      path: /v2/link/bulk_trigger_historical_pull
      operations:
      - name: bulk_trigger_historical_pull_v2_link_bulk_trigger_historical_pull_post
        method: POST
        description: Bulk Trigger Historical Pull
        outputRawFormat: json
        outputParameters:
        - name: result
          type: object
          value: $.
        inputParameters:
        - name: body
          in: body
          type: object
          description: Request body (JSON).
          required: true
    - name: v2-link-bulk-export
      path: /v2/link/bulk_export
      operations:
      - name: bulk_export_connections_v2_link_bulk_export_post
        method: POST
        description: Bulk Export Connections
        outputRawFormat: json
        outputParameters:
        - name: result
          type: object
          value: $.
        inputParameters:
        - name: body
          in: body
          type: object
          description: Request body (JSON).
          required: true
    - name: v2-link-bulk-pause
      path: /v2/link/bulk_pause
      operations:
      - name: bulk_pause_connections_v2_link_bulk_pause_post
        method: POST
        description: Bulk Pause Connections
        outputRawFormat: json
        outputParameters:
        - name: result
          type: object
          value: $.
        inputParameters:
        - name: body
          in: body
          type: object
          description: Request body (JSON).
          required: true
    - name: v2-link-token
      path: /v2/link/token
      operations:
      - name: generate_vital_link_token_v2_link_token_post
        method: POST
        description: Generate Vital Link Token
        outputRawFormat: json
        outputParameters:
        - name: result
          type: object
          value: $.
        inputParameters:
        - name: body
          in: body
          type: object
          description: Request body (JSON).
          required: true
    - name: v2-link-code-create
      path: /v2/link/code/create
      operations:
      - name: create_token_v2_link_code_create_post
        method: POST
        description: Create Token
        outputRawFormat: json
        outputParameters:
        - name: result
          type: object
          value: $.
        inputParameters:
        - name: user_id
          in: query
          type: string
          description: ''
          required: true
        - name: expires_at
          in: query
          type: string
          description: When the link code should expire. Defaults to server time plus 1 hour.
          required: false
    - name: v2-link-provider-oauth
      path: /v2/link/provider/oauth/{oauth_provider}
      operations:
      - name: generate_oauth_link
        method: GET
        description: Generate Oauth Link Endpoint
        outputRawFormat: json
        outputParameters:
        - name: result
          type: object
          value: $.
        inputParameters:
        - name: oauth_provider
          in: path
          type: string
          description: ''
          required: true
        - name: x-vital-link-token
          in: header
          type: string
          description: ''
          required: false
    - name: v2-link-provider-password
      path: /v2/link/provider/password/{provider}
      operations:
      - name: connect_password_provider_v2_link_provider_password__provider__post
        method: POST
        description: Connect Password Provider
        outputRawFormat: json
        outputParameters:
        - name: result
          type: object
          value: $.
        inputParameters:
        - name: provider
          in: path
          type: string
          description: ''
          required: true
        - name: x-vital-link-token
          in: header
          type: string
          description: ''
          required: false
        - name: body
          in: body
          type: object
          description: Request body (JSON).
          required: true
    - name: v2-link-provider-password--complete-mfa
      path: /v2/link/provider/password/{provider}/complete_mfa
      operations:
      - name: complete_password_provider_mfa_v2_link_provider_password__provider__complete_mfa_post
        method: POST
        description: Complete Password Provider Mfa
        outputRawFormat: json
        outputParameters:
        - name: result
          type: object
          value: $.
        inputParameters:
        - name: provider
          in: path
          type: string
          description: ''
          required: true
        - name: x-vital-link-token
          in: header
          type: string
          description: ''
          required: false
        - name: body
          in: body
          type: object
          description: Request body (JSON).
          required: true
    - name: v2-link-provider-email
      path: /v2/link/provider/email/{provider}
      operations:
      - name: connect_email_auth_provider_v2_link_provider_email__provider__post
        method: POST
        description: Connect Email Auth Provider
        outputRawFormat: json
        outputParameters:
        - name: result
          type: object
          value: $.
        inputParameters:
        - name: provider
          in: path
          type: string
          description: ''
          required: true
        - name: x-vital-link-token
          in: header
          type: string
          description: ''
          required: false
        - name: body
          in: body
          type: object
          description: Request body (JSON).
          required: true
    - name: v2-link-providers
      path: /v2/link/providers
      operations:
      - name: get_providers_v2_link_providers_get
        method: GET
        description: Get Providers
        outputRawFormat: json
        outputParameters:
        - name: result
          type: object
          value: $.
        inputParameters:
        - name: x-vital-link-token
          in: header
          type: string
          description: ''
          required: false
    - name: v2-link-connect-demo
      path: /v2/link/connect/demo
      operations:
      - name: create_demo_connection_v2_link_connect_demo_post
        method: POST
        description: Create Demo Connection
        outputRawFormat: json
        outputParameters:
        - name: result
          type: object
          value: $.
        inputParameters:
        - name: body
          in: body
          type: object
          description: Request body (JSON).
          required: true
    - name: v2-providers
      path: /v2/providers
      operations:
      - name: get_list_of_providers_v2_providers_get
        method: GET
        description: Get List Of Providers
        outputRawFormat: json
        outputParameters:
        - name: result
          type: object
          value: $.
        inputParameters:
        - name: source_type
          in: query
          type: string
          description: ''
          required: false
    auth:
      type: apiKey
      in: header
      name: X-Vital-API-Key
      valueFrom:
        env: VITAL_API_KEY