kryptos-io kryptos connect API

openapi: 3.1.0
info:
  title: kryptos-io kryptos connect API
  version: '2026-10-30'
  description: 'GENERATED FROM DOCUMENTATION by API Evangelist on 2026-10-30: 7 operation(s) read from 2 public documentation page(s) (each operation
    names its page in x-source). This is not the provider''s published contract; kryptos-io has published no machine-readable contract that the
    pipeline could find. Engine: anthropic.'
  x-evidence-tiers:
    code-example: 23
    documentation: 45
    pages-with-code: 20
    pages-read: 28
  x-generated-from: documentation
  x-provenance: generated
  x-authored-by: API Evangelist
  x-generated: '2026-10-30'
  x-generator: generate-contract-from-docs.py
  x-engine: anthropic
  x-sources:
  - https://docs.kryptos.io/docs/kryptos-connect/backend
  - https://docs.kryptos.io/docs/kryptos-connect/examples
  x-docs-section: kryptos-connect
servers:
- url: https://api-v2.kryptos.io
paths:
  /api/kryptos/create-link-token:
    post:
      operationId: post_api_kryptos_create_link_token
      tags:
      - Api
      summary: POST /api/kryptos/create-link-token
      x-source: https://docs.kryptos.io/docs/kryptos-connect/examples
      responses:
        '201':
          description: Success (status as documented)
      x-evidence:
        kind: code-example
        language: javascript
        snippet: 'fetch ( "https://your-api.com/api/kryptos/create-link-token" , { method : "POST" , headers : { "Content-Type" : "application/json"
          } } , ) ; //Must be { link_token, isAuthorized } — not a bare string. return response . json ( ) ; } ; const handleConnectSuccess =
          ( consent ) => { if ( consent ?. public_token ) { fetch ( "https://your-api.com/api/kryptos/exchange-token" , { method : "POST" , headers'
  /developer/integrations/{walletid}:
    delete:
      operationId: delete_developer_integrations_walletid
      tags:
      - Developer
      summary: Delete one of a Guest (anonymous) user's integrations, together with all of its data.
      x-source: https://docs.kryptos.io/docs/kryptos-connect/backend
      parameters:
      - name: walletid
        in: path
        required: true
        schema:
          type: string
      - name: user_id
        in: query
        required: true
        schema:
          type: string
        description: The user the integration belongs to.
      responses:
        '202':
          description: Success (status as documented)
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/DeleteDeveloperIntegrationsWalletidResponse'
      x-evidence:
        kind: documentation
  /developer/integrations/{walletid}/resync:
    post:
      operationId: post_developer_integrations_walletid_resync
      tags:
      - Developer
      summary: Trigger a resync on a connected user's wallet, exchange, or CSV integration.
      x-source: https://docs.kryptos.io/docs/kryptos-connect/backend
      parameters:
      - name: walletid
        in: path
        required: true
        schema:
          type: string
      requestBody:
        required: true
        content:
          application/json:
            schema:
              $ref: '#/components/schemas/PostDeveloperIntegrationsWalletidResyncRequest'
      responses:
        '202':
          description: Success (status as documented)
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/PostDeveloperIntegrationsWalletidResyncResponse'
      x-evidence:
        kind: documentation
  /link-token:
    post:
      operationId: post_link_token
      tags:
      - Link Token
      summary: POST /link-token
      x-source: https://docs.kryptos.io/docs/kryptos-connect/backend
      requestBody:
        required: true
        content:
          application/json:
            schema:
              $ref: '#/components/schemas/PostLinkTokenRequest'
      responses:
        '201':
          description: Success (status as documented)
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/PostLinkTokenResponse'
      x-evidence:
        kind: documentation
  /token/exchange:
    post:
      operationId: post_token_exchange
      tags:
      - Token
      summary: Create an endpoint to exchange the public token for a long-lived access token.
      x-source: https://docs.kryptos.io/docs/kryptos-connect/backend
      requestBody:
        required: true
        content:
          application/json:
            schema:
              $ref: '#/components/schemas/PostTokenExchangeRequest'
      responses:
        '201':
          description: Success (status as documented)
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/PostTokenExchangeResponse'
      x-evidence:
        kind: documentation
  /token/grants:
    get:
      operationId: get_token_grants
      tags:
      - Token
      summary: Get all active grants for your client.
      x-source: https://docs.kryptos.io/docs/kryptos-connect/backend
      responses:
        '200':
          description: Success (status as documented)
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/GetTokenGrantsResponse'
      x-evidence:
        kind: documentation
  /token/revoke:
    post:
      operationId: post_token_revoke
      tags:
      - Token
      summary: Allow users to disconnect their account by revoking the grant.
      x-source: https://docs.kryptos.io/docs/kryptos-connect/backend
      requestBody:
        required: true
        content:
          application/json:
            schema:
              $ref: '#/components/schemas/PostTokenRevokeRequest'
      responses:
        '201':
          description: Success (status as documented)
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/PostTokenRevokeResponse'
      x-evidence:
        kind: documentation
security:
- bearer: []
components:
  schemas:
    DeleteDeveloperIntegrationsWalletidResponse:
      type: object
      properties:
        success:
          type: boolean
        data:
          type: object
          description: Object containing wallet_id, job_id, status, and note.
    PostDeveloperIntegrationsWalletidResyncRequest:
      type: object
      properties:
        user_id:
          type: string
          description: The user ID
        mode:
          type: string
          description: 'Resync mode: ''latest'' for incremental refresh or ''from_start'' for full re-fetch'
      required:
      - user_id
    PostDeveloperIntegrationsWalletidResyncResponse:
      type: object
      properties:
        mode:
          type: string
          description: The resync mode used
        integration_type:
          type: string
          description: Type of integration (wallet, exchange, etc.)
        wallet_id:
          type: string
          description: The wallet ID
        job_id:
          type: string
          description: Sync job ID to poll for status
        status:
          type: string
          description: Current status of the resync
        note:
          type: string
          description: Additional information about the resync
    PostLinkTokenRequest:
      type: object
      properties:
        scopes:
          type: string
          description: OAuth scopes for the user
        access_token:
          type: string
          description: Existing access token to skip authentication for returning users
      required:
      - scopes
    PostLinkTokenResponse:
      type: object
      properties:
        link_token:
          type: string
          description: Token to be used by Web SDK's generateLinkToken function
        expires_at:
          type: string
          description: Expiration time of the link token
        user_id:
          type: string
          description: User ID when session is resumed with existing access_token
        workspace_id:
          type: string
          description: Workspace ID when session is resumed with existing access_token
        has_existing_grant:
          type: boolean
          description: Whether user has existing grant when session is resumed
    PostTokenExchangeRequest:
      type: object
      properties:
        public_token:
          type: string
          description: Public token received from Web SDK's onSuccess callback
      required:
      - public_token
    PostTokenExchangeResponse:
      type: object
      properties:
        access_token:
          type: string
          description: Long-lived access token valid for 15 years
        grant_id:
          type: string
          description: Grant ID for revoking access later
        token_type:
          type: string
          description: Token type, typically 'Bearer'
        expires_in:
          type: number
          description: Token expiration in seconds (473,040,000 for 15 years)
        scope:
          type: string
          description: Granted scopes
        workspace_id:
          type: string
          description: Workspace ID associated with the access token
    GetTokenGrantsResponse:
      type: object
      properties:
        grants:
          type: array
          description: List of active grants
        count:
          type: number
          description: Number of active grants
    PostTokenRevokeRequest:
      type: object
      properties:
        grant_id:
          type: string
          description: Grant ID returned from token exchange
      required:
      - grant_id
    PostTokenRevokeResponse:
      type: object
      properties:
        message:
          type: string
          description: Confirmation message
  securitySchemes:
    bearer:
      type: http
      scheme: bearer
tags:
- name: Api
- name: Developer
- name: Link Token
- name: Token