openapi: 3.1.0
info:
  title: LinkupAPI API
  version: '2026-10-18'
  description: 'GENERATED FROM DOCUMENTATION by API Evangelist on 2026-10-18: 55 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; LinkupAPI has published no machine-readable contract that the
    pipeline could find. Engine: local.'
  x-evidence-tiers:
    code-example: 2
    documentation: 53
    pages-with-code: 1
    pages-read: 2
  x-generated-from: documentation
  x-provenance: generated
  x-authored-by: API Evangelist
  x-generated: '2026-10-18'
  x-generator: generate-contract-from-docs.py
  x-engine: local
  x-sources:
  - https://docs.linkupapi.com/api-reference/v2/introduction
  - https://docs.linkupapi.com/api-reference/v2/migration.md
servers:
- url: https://api.linkupapi.com
paths:
  /v1/companies/info:
    post:
      operationId: post_v1_companies_info
      tags:
      - Companies
      summary: V1 endpoint to retrieve information about a specific company.
      x-source: https://docs.linkupapi.com/api-reference/v2/migration.md
      requestBody:
        required: true
        content:
          application/json:
            schema:
              $ref: '#/components/schemas/PostV1CompaniesInfoRequest'
      responses:
        '201':
          description: Success (status as documented)
      x-evidence:
        kind: documentation
  /v1/companies/search:
    post:
      operationId: post_v1_companies_search
      tags:
      - Companies
      summary: V1 endpoint to search for companies.
      x-source: https://docs.linkupapi.com/api-reference/v2/migration.md
      requestBody:
        required: true
        content:
          application/json:
            schema:
              $ref: '#/components/schemas/PostV1CompaniesSearchRequest'
      responses:
        '201':
          description: Success (status as documented)
      x-evidence:
        kind: documentation
  /v1/data/mail/finder:
    post:
      operationId: post_v1_data_mail_finder
      tags:
      - Data
      summary: Migration from V1 to V2
      x-source: https://docs.linkupapi.com/api-reference/v2/migration.md
      responses:
        '201':
          description: Success (status as documented)
      x-evidence:
        kind: documentation
  /v1/data/mail/reverse:
    post:
      operationId: post_v1_data_mail_reverse
      tags:
      - Data
      summary: Migration from V1 to V2
      x-source: https://docs.linkupapi.com/api-reference/v2/migration.md
      responses:
        '201':
          description: Success (status as documented)
      x-evidence:
        kind: documentation
  /v1/data/mail/validate:
    post:
      operationId: post_v1_data_mail_validate
      tags:
      - Data
      summary: Migration from V1 to V2
      x-source: https://docs.linkupapi.com/api-reference/v2/migration.md
      responses:
        '201':
          description: Success (status as documented)
      x-evidence:
        kind: documentation
  /v1/messages/conversation:
    post:
      operationId: post_v1_messages_conversation
      tags:
      - Messages
      summary: V1 endpoint to retrieve a conversation thread.
      x-source: https://docs.linkupapi.com/api-reference/v2/migration.md
      requestBody:
        required: true
        content:
          application/json:
            schema:
              $ref: '#/components/schemas/PostV1MessagesConversationRequest'
      responses:
        '201':
          description: Success (status as documented)
      x-evidence:
        kind: documentation
  /v1/messages/inbox:
    post:
      operationId: post_v1_messages_inbox
      tags:
      - Messages
      summary: V1 endpoint to list inbox messages.
      x-source: https://docs.linkupapi.com/api-reference/v2/migration.md
      requestBody:
        required: true
        content:
          application/json:
            schema:
              $ref: '#/components/schemas/PostV1MessagesInboxRequest'
      responses:
        '201':
          description: Success (status as documented)
      x-evidence:
        kind: documentation
  /v1/messages/send-message:
    post:
      operationId: post_v1_messages_send_message
      tags:
      - Messages
      summary: V1 endpoint to send a message to a contact.
      x-source: https://docs.linkupapi.com/api-reference/v2/migration.md
      requestBody:
        required: true
        content:
          application/json:
            schema:
              $ref: '#/components/schemas/PostV1MessagesSendMessageRequest'
      responses:
        '201':
          description: Success (status as documented)
      x-evidence:
        kind: documentation
  /v1/network/accept-invitation:
    post:
      operationId: post_v1_network_accept_invitation
      tags:
      - Network
      summary: Migration from V1 to V2
      x-source: https://docs.linkupapi.com/api-reference/v2/migration.md
      requestBody:
        required: true
        content:
          application/json:
            schema:
              $ref: '#/components/schemas/PostV1NetworkAcceptInvitationRequest'
      responses:
        '201':
          description: Success (status as documented)
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/PostV1NetworkAcceptInvitationResponse'
      x-evidence:
        kind: documentation
  /v1/network/connect:
    post:
      operationId: post_v1_network_connect
      tags:
      - Network
      summary: V1 endpoint to send a connection invitation.
      x-source: https://docs.linkupapi.com/api-reference/v2/migration.md
      requestBody:
        required: true
        content:
          application/json:
            schema:
              $ref: '#/components/schemas/PostV1NetworkConnectRequest'
      responses:
        '201':
          description: Success (status as documented)
      x-evidence:
        kind: documentation
  /v1/network/connections:
    post:
      operationId: post_v1_network_connections
      tags:
      - Network
      summary: Migration from V1 to V2
      x-source: https://docs.linkupapi.com/api-reference/v2/migration.md
      requestBody:
        required: true
        content:
          application/json:
            schema:
              $ref: '#/components/schemas/PostV1NetworkConnectionsRequest'
      responses:
        '201':
          description: Success (status as documented)
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/PostV1NetworkConnectionsResponse'
      x-evidence:
        kind: documentation
  /v1/network/get-network-recommendations:
    post:
      operationId: post_v1_network_get_network_recommendations
      tags:
      - Network
      summary: Migration from V1 to V2
      x-source: https://docs.linkupapi.com/api-reference/v2/migration.md
      requestBody:
        required: true
        content:
          application/json:
            schema:
              $ref: '#/components/schemas/PostV1NetworkGetNetworkRecommendationsRequest'
      responses:
        '201':
          description: Success (status as documented)
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/PostV1NetworkGetNetworkRecommendationsResponse'
      x-evidence:
        kind: documentation
  /v1/network/invitation-status:
    post:
      operationId: post_v1_network_invitation_status
      tags:
      - Network
      summary: Migration from V1 to V2
      x-source: https://docs.linkupapi.com/api-reference/v2/migration.md
      requestBody:
        required: true
        content:
          application/json:
            schema:
              $ref: '#/components/schemas/PostV1NetworkInvitationStatusRequest'
      responses:
        '201':
          description: Success (status as documented)
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/PostV1NetworkInvitationStatusResponse'
      x-evidence:
        kind: documentation
  /v1/network/invitations:
    post:
      operationId: post_v1_network_invitations
      tags:
      - Network
      summary: Migration from V1 to V2
      x-source: https://docs.linkupapi.com/api-reference/v2/migration.md
      requestBody:
        required: true
        content:
          application/json:
            schema:
              $ref: '#/components/schemas/PostV1NetworkInvitationsRequest'
      responses:
        '201':
          description: Success (status as documented)
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/PostV1NetworkInvitationsResponse'
      x-evidence:
        kind: documentation
  /v1/network/sent-invitations:
    post:
      operationId: post_v1_network_sent_invitations
      tags:
      - Network
      summary: Migration from V1 to V2
      x-source: https://docs.linkupapi.com/api-reference/v2/migration.md
      requestBody:
        required: true
        content:
          application/json:
            schema:
              $ref: '#/components/schemas/PostV1NetworkSentInvitationsRequest'
      responses:
        '201':
          description: Success (status as documented)
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/PostV1NetworkSentInvitationsResponse'
      x-evidence:
        kind: documentation
  /v1/network/withdraw:
    post:
      operationId: post_v1_network_withdraw
      tags:
      - Network
      summary: Migration from V1 to V2
      x-source: https://docs.linkupapi.com/api-reference/v2/migration.md
      requestBody:
        required: true
        content:
          application/json:
            schema:
              $ref: '#/components/schemas/PostV1NetworkWithdrawRequest'
      responses:
        '201':
          description: Success (status as documented)
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/PostV1NetworkWithdrawResponse'
      x-evidence:
        kind: documentation
  /v1/posts/answer-comment:
    post:
      operationId: post_v1_posts_answer_comment
      tags:
      - Posts
      summary: '`POST /v1/posts/answer-comment` – V1 endpoint mapped to V2 `answer_comment` action.'
      x-source: https://docs.linkupapi.com/api-reference/v2/migration.md
      responses:
        '201':
          description: Success (status as documented)
      x-evidence:
        kind: documentation
  /v1/posts/comment:
    post:
      operationId: post_v1_posts_comment
      tags:
      - Posts
      summary: '`POST /v1/posts/comment` – V1 endpoint mapped to V2 `comment` action.'
      x-source: https://docs.linkupapi.com/api-reference/v2/migration.md
      responses:
        '201':
          description: Success (status as documented)
      x-evidence:
        kind: documentation
  /v1/posts/create:
    post:
      operationId: post_v1_posts_create
      tags:
      - Posts
      summary: Migration from V1 to V2
      x-source: https://docs.linkupapi.com/api-reference/v2/migration.md
      requestBody:
        required: true
        content:
          application/json:
            schema:
              $ref: '#/components/schemas/PostV1PostsCreateRequest'
      responses:
        '201':
          description: Success (status as documented)
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/PostV1PostsCreateResponse'
      x-evidence:
        kind: documentation
  /v1/posts/create-company:
    post:
      operationId: post_v1_posts_create_company
      tags:
      - Posts
      summary: Migration from V1 to V2
      x-source: https://docs.linkupapi.com/api-reference/v2/migration.md
      requestBody:
        required: true
        content:
          application/json:
            schema:
              $ref: '#/components/schemas/PostV1PostsCreateCompanyRequest'
      responses:
        '201':
          description: Success (status as documented)
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/PostV1PostsCreateCompanyResponse'
      x-evidence:
        kind: documentation
  /v1/posts/extract-comments:
    post:
      operationId: post_v1_posts_extract_comments
      tags:
      - Posts
      summary: '`POST /v1/posts/extract-comments` – V1 endpoint mapped to V2 `get_comments` action.'
      x-source: https://docs.linkupapi.com/api-reference/v2/migration.md
      responses:
        '201':
          description: Success (status as documented)
      x-evidence:
        kind: documentation
  /v1/posts/feed:
    post:
      operationId: post_v1_posts_feed
      tags:
      - Posts
      summary: Migration from V1 to V2
      x-source: https://docs.linkupapi.com/api-reference/v2/migration.md
      requestBody:
        required: true
        content:
          application/json:
            schema:
              $ref: '#/components/schemas/PostV1PostsFeedRequest'
      responses:
        '201':
          description: Success (status as documented)
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/PostV1PostsFeedResponse'
      x-evidence:
        kind: documentation
  /v1/posts/like:
    post:
      operationId: post_v1_posts_like
      tags:
      - Posts
      summary: '`POST /v1/posts/like` – V1 endpoint mapped to V2 `like` action.'
      x-source: https://docs.linkupapi.com/api-reference/v2/migration.md
      responses:
        '201':
          description: Success (status as documented)
      x-evidence:
        kind: documentation
  /v1/posts/react:
    post:
      operationId: post_v1_posts_react
      tags:
      - Posts
      summary: '`POST /v1/posts/react` – V1 endpoint mapped to V2 `react` action.'
      x-source: https://docs.linkupapi.com/api-reference/v2/migration.md
      responses:
        '201':
          description: Success (status as documented)
      x-evidence:
        kind: documentation
  /v1/posts/reactions:
    post:
      operationId: post_v1_posts_reactions
      tags:
      - Posts
      summary: '`POST /v1/posts/reactions` – V1 endpoint mapped to V2 `get_reactions` action.'
      x-source: https://docs.linkupapi.com/api-reference/v2/migration.md
      responses:
        '201':
          description: Success (status as documented)
      x-evidence:
        kind: documentation
  /v1/posts/repost:
    post:
      operationId: post_v1_posts_repost
      tags:
      - Posts
      summary: '`POST /v1/posts/repost` – V1 endpoint mapped to V2 `repost` action.'
      x-source: https://docs.linkupapi.com/api-reference/v2/migration.md
      responses:
        '201':
          description: Success (status as documented)
      x-evidence:
        kind: documentation
  /v1/posts/search:
    post:
      operationId: post_v1_posts_search
      tags:
      - Posts
      summary: Migration from V1 to V2
      x-source: https://docs.linkupapi.com/api-reference/v2/migration.md
      requestBody:
        required: true
        content:
          application/json:
            schema:
              $ref: '#/components/schemas/PostV1PostsSearchRequest'
      responses:
        '201':
          description: Success (status as documented)
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/PostV1PostsSearchResponse'
      x-evidence:
        kind: documentation
  /v1/posts/time-spent:
    post:
      operationId: post_v1_posts_time_spent
      tags:
      - Posts
      summary: '`POST /v1/posts/time-spent` – V1 endpoint mapped to V2 `time_spent` action.'
      x-source: https://docs.linkupapi.com/api-reference/v2/migration.md
      responses:
        '201':
          description: Success (status as documented)
      x-evidence:
        kind: documentation
  /v1/profile/contact:
    post:
      operationId: post_v1_profile_contact
      tags:
      - Profile
      summary: V1 endpoint to get contact information for a profile.
      x-source: https://docs.linkupapi.com/api-reference/v2/migration.md
      requestBody:
        required: true
        content:
          application/json:
            schema:
              $ref: '#/components/schemas/PostV1ProfileContactRequest'
      responses:
        '201':
          description: Success (status as documented)
      x-evidence:
        kind: documentation
  /v1/profile/me:
    post:
      operationId: post_v1_profile_me
      tags:
      - Profile
      summary: V1 endpoint to retrieve the authenticated user's profile.
      x-source: https://docs.linkupapi.com/api-reference/v2/migration.md
      requestBody:
        required: true
        content:
          application/json:
            schema:
              $ref: '#/components/schemas/PostV1ProfileMeRequest'
      responses:
        '201':
          description: Success (status as documented)
      x-evidence:
        kind: documentation
  /v1/profile/search:
    post:
      operationId: post_v1_profile_search
      tags:
      - Profile
      summary: V1 endpoint to search for people profiles.
      x-source: https://docs.linkupapi.com/api-reference/v2/migration.md
      requestBody:
        required: true
        content:
          application/json:
            schema:
              $ref: '#/components/schemas/PostV1ProfileSearchRequest'
      responses:
        '201':
          description: Success (status as documented)
      x-evidence:
        kind: documentation
  /v1/profile/visit:
    post:
      operationId: post_v1_profile_visit
      tags:
      - Profile
      summary: V1 endpoint to record a visit to a profile.
      x-source: https://docs.linkupapi.com/api-reference/v2/migration.md
      requestBody:
        required: true
        content:
          application/json:
            schema:
              $ref: '#/components/schemas/PostV1ProfileVisitRequest'
      responses:
        '201':
          description: Success (status as documented)
      x-evidence:
        kind: documentation
  /v1/recruiter/close:
    post:
      operationId: post_v1_recruiter_close
      tags:
      - Recruiter
      summary: Migration from V1 to V2
      x-source: https://docs.linkupapi.com/api-reference/v2/migration.md
      responses:
        '201':
          description: Success (status as documented)
      x-evidence:
        kind: documentation
  /v1/recruiter/cv:
    post:
      operationId: post_v1_recruiter_cv
      tags:
      - Recruiter
      summary: '`POST /v1/recruiter/cv` – V1 endpoint mapped to V2 `get_cv` action.'
      x-source: https://docs.linkupapi.com/api-reference/v2/migration.md
      responses:
        '201':
          description: Success (status as documented)
      x-evidence:
        kind: documentation
  /v1/recruiter/get-candidate:
    post:
      operationId: post_v1_recruiter_get_candidate
      tags:
      - Recruiter
      summary: '`POST /v1/recruiter/get-candidate` – V1 endpoint mapped to V2 `get_candidates` action.'
      x-source: https://docs.linkupapi.com/api-reference/v2/migration.md
      responses:
        '201':
          description: Success (status as documented)
      x-evidence:
        kind: documentation
  /v1/recruiter/posts:
    post:
      operationId: post_v1_recruiter_posts
      tags:
      - Recruiter
      summary: '`POST /v1/recruiter/posts` – V1 endpoint mapped to V2 `get_posts` action.'
      x-source: https://docs.linkupapi.com/api-reference/v2/migration.md
      responses:
        '201':
          description: Success (status as documented)
      x-evidence:
        kind: documentation
  /v1/recruiter/publish:
    post:
      operationId: post_v1_recruiter_publish
      tags:
      - Recruiter
      summary: Migration from V1 to V2
      x-source: https://docs.linkupapi.com/api-reference/v2/migration.md
      responses:
        '201':
          description: Success (status as documented)
      x-evidence:
        kind: documentation
  /v1/webhooks/.../start:
    post:
      operationId: post_v1_webhooks_start
      tags:
      - Webhooks
      summary: Migration from V1 to V2
      x-source: https://docs.linkupapi.com/api-reference/v2/migration.md
      responses:
        '201':
          description: Success (status as documented)
      x-evidence:
        kind: documentation
  /v1/webhooks/.../status:
    get:
      operationId: get_v1_webhooks_status
      tags:
      - Webhooks
      summary: Get status of a V1 webhook
      x-source: https://docs.linkupapi.com/api-reference/v2/migration.md
      responses:
        '200':
          description: Success (status as documented)
      x-evidence:
        kind: documentation
  /v1/webhooks/.../stop:
    post:
      operationId: post_v1_webhooks_stop
      tags:
      - Webhooks
      summary: Stop a V1 webhook
      x-source: https://docs.linkupapi.com/api-reference/v2/migration.md
      responses:
        '201':
          description: Success (status as documented)
      x-evidence:
        kind: documentation
  /v1/webhooks/accounts:
    get:
      operationId: get_v1_webhooks_accounts
      tags:
      - Webhooks
      summary: Migration from V1 to V2
      x-source: https://docs.linkupapi.com/api-reference/v2/migration.md
      responses:
        '200':
          description: Success (status as documented)
      x-evidence:
        kind: documentation
    post:
      operationId: post_v1_webhooks_accounts
      tags:
      - Webhooks
      summary: Webhooks (V1) – before migration
      x-source: https://docs.linkupapi.com/api-reference/v2/migration.md
      requestBody:
        required: true
        content:
          application/json:
            schema:
              $ref: '#/components/schemas/PostV1WebhooksAccountsRequest'
      responses:
        '201':
          description: Success (status as documented)
      x-evidence:
        kind: documentation
  /v1/webhooks/accounts/{id}:
    delete:
      operationId: delete_v1_webhooks_accounts_id
      tags:
      - Webhooks
      summary: Migration from V1 to V2
      x-source: https://docs.linkupapi.com/api-reference/v2/migration.md
      parameters:
      - name: id
        in: path
        required: true
        schema:
          type: string
      responses:
        '200':
          description: Success (status as documented)
      x-evidence:
        kind: documentation
    put:
      operationId: put_v1_webhooks_accounts_id
      tags:
      - Webhooks
      summary: Migration from V1 to V2
      x-source: https://docs.linkupapi.com/api-reference/v2/migration.md
      parameters:
      - name: id
        in: path
        required: true
        schema:
          type: string
      responses:
        '200':
          description: Success (status as documented)
      x-evidence:
        kind: documentation
  /v2/accounts:
    get:
      operationId: get_v2_accounts
      tags:
      - Accounts
      summary: Simplified account management
      x-source: https://docs.linkupapi.com/api-reference/v2/migration.md
      responses:
        '200':
          description: Success (status as documented)
      x-evidence:
        kind: documentation
  /v2/accounts/{id}:
    get:
      operationId: get_v2_accounts_id
      tags:
      - Accounts
      summary: Account logs
      x-source: https://docs.linkupapi.com/api-reference/v2/migration.md
      parameters:
      - name: id
        in: path
        required: true
        schema:
          type: string
      responses:
        '200':
          description: Success (status as documented)
      x-evidence:
        kind: documentation
  /v2/credits:
    get:
      operationId: get_v2_credits
      tags:
      - Credits
      summary: Introduction - LinkUp API Documentation
      description: Check your credit balance
      x-source: https://docs.linkupapi.com/api-reference/v2/introduction
      responses:
        '200':
          description: Success (status as documented)
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/GetV2CreditsResponse'
      x-evidence:
        kind: documentation
  /v2/webhooks:
    get:
      operationId: get_v2_webhooks
      tags:
      - Webhooks
      summary: Webhooks – list configurations
      x-source: https://docs.linkupapi.com/api-reference/v2/migration.md
      responses:
        '200':
          description: Success (status as documented)
      x-evidence:
        kind: documentation
  /v2/webhooks/{id}:
    delete:
      operationId: delete_v2_webhooks_id
      tags:
      - Webhooks
      summary: Migration from V1 to V2
      x-source: https://docs.linkupapi.com/api-reference/v2/migration.md
      parameters:
      - name: id
        in: path
        required: true
        schema:
          type: string
      responses:
        '200':
          description: Success (status as documented)
      x-evidence:
        kind: documentation
    put:
      operationId: put_v2_webhooks_id
      tags:
      - Webhooks
      summary: Migration from V1 to V2
      x-source: https://docs.linkupapi.com/api-reference/v2/migration.md
      parameters:
      - name: id
        in: path
        required: true
        schema:
          type: string
      responses:
        '200':
          description: Success (status as documented)
      x-evidence:
        kind: documentation
  /v2/webhooks/{id}/events:
    get:
      operationId: get_v2_webhooks_id_events
      tags:
      - Webhooks
      summary: Polling endpoint for webhook events
      x-source: https://docs.linkupapi.com/api-reference/v2/migration.md
      parameters:
      - name: id
        in: path
        required: true
        schema:
          type: string
      responses:
        '200':
          description: Success (status as documented)
      x-evidence:
        kind: documentation
  /v2/webhooks/{id}/start:
    post:
      operationId: post_v2_webhooks_id_start
      tags:
      - Webhooks
      summary: Start a webhook
      x-source: https://docs.linkupapi.com/api-reference/v2/migration.md
      parameters:
      - name: id
        in: path
        required: true
        schema:
          type: string
      responses:
        '201':
          description: Success (status as documented)
      x-evidence:
        kind: documentation
  /v2/webhooks/{id}/stop:
    post:
      operationId: post_v2_webhooks_id_stop
      tags:
      - Webhooks
      summary: Stop a webhook
      x-source: https://docs.linkupapi.com/api-reference/v2/migration.md
      parameters:
      - name: id
        in: path
        required: true
        schema:
          type: string
      responses:
        '201':
          description: Success (status as documented)
      x-evidence:
        kind: documentation
  /v2/webhooks/{id}/stream:
    get:
      operationId: get_v2_webhooks_id_stream
      tags:
      - Webhooks
      summary: 'Hosted mode: SSE stream endpoint'
      x-source: https://docs.linkupapi.com/api-reference/v2/migration.md
      parameters:
      - name: id
        in: path
        required: true
        schema:
          type: string
      responses:
        '200':
          description: Success (status as documented)
      x-evidence:
        kind: documentation
  /v2/{category}:
    post:
      operationId: post_v2_category
      tags:
      - Api
      summary: Update Request Format
      x-source: https://docs.linkupapi.com/api-reference/v2/migration.md
      parameters:
      - name: category
        in: path
        required: true
        schema:
          type: string
      requestBody:
        required: true
        content:
          application/json:
            schema:
              $ref: '#/components/schemas/PostV2CategoryRequest'
      responses:
        '201':
          description: Success (status as documented)
      x-evidence:
        kind: documentation
components:
  schemas:
    PostV1CompaniesInfoRequest:
      type: object
      properties:
        login_token:
          type: string
        country:
          type: string
        company_url:
          type: string
      required:
      - login_token
      - country
      - company_url
    PostV1CompaniesSearchRequest:
      type: object
      properties:
        login_token:
          type: string
        country:
          type: string
        keyword:
          type: string
        location:
          type: string
      required:
      - login_token
      - country
    PostV1MessagesConversationRequest:
      type: object
      properties:
        login_token:
          type: string
        country:
          type: string
        conversation_id:
          type: string
      required:
      - login_token
      - country
      - conversation_id
    PostV1MessagesInboxRequest:
      type: object
      properties:
        login_token:
          type: string
        country:
          type: string
      required:
      - login_token
      - country
    PostV1MessagesSendMessageRequest:
      type: object
      properties:
        login_token:
          type: string
        country:
          type: string
        profile_url:
          type: string
        message:
          type: string
      required:
      - login_token
      - country
      - profile_url
      - message
    PostV1NetworkAcceptInvitationRequest:
      type: object
      properties:
        account_id:
          type: string
          description: Persistent account identifier used in all V2 requests.
        action:
          type: string
          description: V2 action name – "accept".
        params:
          type: object
          description: Object containing the original V1 parameters for this endpoint.
      required:
      - account_id
      - action
    PostV1NetworkAcceptInvitationResponse:
      type: object
      properties:
        success:
          type: boolean
          description: Indicates whether the request succeeded.
        data:
          type: object
          description: Payload returned by the endpoint.
        metadata:
          type: object
          description: Standard metadata (action, account_id, credits_consumed, timestamp).
    PostV1NetworkConnectRequest:
      type: object
      properties:
        login_token:
          type: string
        country:
          type: string
        profile_url:
          type: string
        message:
          type: string
      required:
      - login_token
      - country
      - profile_url
    PostV1NetworkConnectionsRequest:
      type: object
      properties:
        account_id:
          type: string
        action:
          type: string
          description: V2 action name – "list_connections".
        params:
          type: object
      required:
      - account_id
      - action
    PostV1NetworkConnectionsResponse:
      type: object
      properties:
        success:
          type: boolean
        data:
          type: object
        metadata:
          type: object
    PostV1NetworkGetNetworkRecommendationsRequest:
      type: object
      properties:
        account_id:
          type: string
        action:
          type: string
          description: V2 action name – "recommendations".
        params:
          type: object
      required:
      - account_id
      - action
    PostV1NetworkGetNetworkRecommendationsResponse:
      type: object
      properties:
        success:
          type: boolean
        data:
          type: object
        metadata:
          type: object
    PostV1NetworkInvitationStatusRequest:
      type: object
      properties:
        account_id:
          type: string
        action:
          type: string
          description: V2 action name – "check_invitation".
        params:
          type: object
      required:
      - account_id
      - action
    PostV1NetworkInvitationStatusResponse:
      type: object
      properties:
        success:
          type: boolean
        data:
          type: object
        metadata:
          type: object
    PostV1NetworkInvitationsRequest:
      type: object
      properties:
        account_id:
          type: string
        action:
          type: string
          description: V2 action name – "list_invitations".
        params:
          type: object
      required:
      - account_id
      - action
    PostV1NetworkInvitationsResponse:
      type: object
      properties:
        success:
          type: boolean
        data:
          type: object
        metadata:
          type: object
    PostV1NetworkSentInvitationsRequest:
      type: object
      properties:
        account_id:
          type: string
        action:
          type: string
          description: V2 action name – "list_sent".
        params:
          type: object
      required:
      - account_id
      - action
    PostV1NetworkSentInvitationsResponse:
      type: object
      properties:
        success:
          type: boolean
        data:
          type: object
        metadata:
          type: object
    PostV1NetworkWithdrawRequest:
      type: object
      properties:
        account_id:
          type: string
        action:
          type: string
          description: V2 action name – "withdraw".
        params:
          type: object
      required:
      - account_id
      - action
    PostV1NetworkWithdrawResponse:
      type: object
      properties:
        success:
          type: boolean
        data:
          type: object
        metadata:
          type: object
    PostV1PostsCreateRequest:
      type: object
      properties:
        account_id:
          type: string
        action:
          type: string
          description: V2 action name – "create".
        params:
          type: object
      required:
      - account_id
      - action
    PostV1PostsCreateResponse:
      type: object
      properties:
        success:
          type: boolean
        data:
          type: object
        metadata:
          type: object
    PostV1PostsCreateCompanyRequest:
      type: object
      properties:
        account_id:
          type: string
        action:
          type: string
          description: V2 action name – "create_company".
        params:
          type: object
      required:
      - account_id
      - action
    PostV1PostsCreateCompanyResponse:
      type: object
      properties:
        success:
          type: boolean
        data:
          type: object
        metadata:
          type: object
    PostV1PostsFeedRequest:
      type: object
      properties:
        account_id:
          type: string
        action:
          type: string
          description: V2 action name – "get_feed".
        params:
          type: object
      required:
      - account_id
      - action
    PostV1PostsFeedResponse:
      type: object
      properties:
        success:
          type: boolean
        data:
          type: object
        metadata:
          type: object
    PostV1PostsSearchRequest:
      type: object
      properties:
        account_id:
          type: string
        action:
          type: string
          description: V2 action name – "search".
        params:
          type: object
      required:
      - account_id
      - action
    PostV1PostsSearchResponse:
      type: object
      properties:
        success:
          type: boolean
        data:
          type: object
        metadata:
          type: object
    PostV1ProfileContactRequest:
      type: object
      properties:
        login_token:
          type: string
        country:
          type: string
        linkedin_url:
          type: string
      required:
      - login_token
      - country
      - linkedin_url
    PostV1ProfileMeRequest:
      type: object
      properties:
        login_token:
          type: string
        country:
          type: string
      required:
      - login_token
      - country
    PostV1ProfileSearchRequest:
      type: object
      properties:
        login_token:
          type: string
        country:
          type: string
        keyword:
          type: string
        location:
          type: string
        network:
          type: string
      required:
      - login_token
      - country
    PostV1ProfileVisitRequest:
      type: object
      properties:
        login_token:
          type: string
        country:
          type: string
        linkedin_url:
          type: string
      required:
      - login_token
      - country
      - linkedin_url
    PostV1WebhooksAccountsRequest:
      type: object
      properties:
        platform:
          type: string
          description: Platform name
        login_token:
          type: string
          description: V1 login token
        webhook_url:
          type: string
          description: URL to receive webhook events
        country:
          type: string
          description: Country code
      required:
      - platform
      - login_token
      - webhook_url
      - country
    GetV2CreditsResponse:
      type: object
      properties:
        success:
          type: boolean
        data:
          type: object
        metadata:
          type: object
    PostV2CategoryRequest:
      type: object
      properties:
        account_id:
          type: string
          description: Persistent account identifier
        action:
          type: string
          description: Action to perform within the category
        params:
          type: object
          description: Parameters for the action
      required:
      - account_id
      - action
  securitySchemes:
    apiKey:
      type: apiKey
      in: header
      name: x-api-key
security:
- apiKey: []
tags:
- name: Accounts
- name: Api
- name: Companies
- name: Credits
- name: Data
- name: Messages
- name: Network
- name: Posts
- name: Profile
- name: Recruiter
- name: Webhooks