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

# List an integration's company links

> How one integration's customers (IT Glue organizations, RMM sites, CIPP tenants, …) map to the tenant's PSA companies: the data behind the integration's **Organization Mapping** tab. Each row carries `link_state` (`AUTO` from a sync, `MANUAL` set by a person and kept by later syncs, `UNMAPPED`), `match_method` and `confidence`. An `AUTO` link below 0.95 is one the dashboard flags for a person to check. Unmapped rows sort first. `counts` covers the `system`, `psa_company_id` and `search` filters, never `status`. A SharePoint folder that was never confirmed is not listed: review new folders on the dashboard.



## OpenAPI

````yaml https://api.neoagent.io/public-api/openapi.json get /public-api/company-links
openapi: 3.1.0
info:
  description: >-
    Neo's public contract for the dashboard ChatAgent, partner integrations, and
    MSP automation. Every response is wrapped in a `{data, meta}` envelope;
    errors use `{error: {code, message, details?}, meta: {request_id}}`.
    Authenticate with a `Bearer neo_sk_<env>_<secret>` API key (service account)
    or a Microsoft Entra ID JWT (dashboard user). Signed-URL endpoints (end-user
    feedback links) take a `signature` query parameter instead.
  title: Neo Public API
  version: 1.0.0
servers:
  - url: https://api.neoagent.io
security: []
tags:
  - description: Service metadata — health, OpenAPI.
    name: Meta
  - description: Agents and workflows — read, version history, delete, stats.
    name: Agents
  - description: Agent/workflow execution history, sub-resources, retry/cancel.
    name: Executions
  - description: >-
      Every tool call the tenant's agents made in the last 30 days, within the
      caller's workflow access.
    name: Audit Log
  - description: PSA webhook events and their workflow-match results.
    name: Callbacks
  - description: Technician-in-the-loop approval requests.
    name: TIL requests
  - description: RMM script executions triggered by agents.
    name: RMM scripts
  - description: Dispatch-agent field-update decisions.
    name: Dispatch
  - description: The authenticated tenant.
    name: Tenant
  - description: Agent-builder schema catalogs (raw JSON payloads).
    name: Schemas
  - description: Escalate to the Neo team (HubSpot ticket).
    name: Escalation
  - description: Tenant settings.
    name: Settings
  - description: Tenant API-key management (dashboard JWT only).
    name: API keys
  - description: End-user feedback links (signed-URL auth).
    name: Feedback
  - description: End-client companies (CRUD + bulk-update).
    name: End companies
  - description: Channels — bind a CONVERSATIONAL agent to a transport (Teams or Slack).
    name: Channels
  - description: PSA/RMM/M365 integration status and connection management.
    name: Integrations
  - description: Technician roster (controls TIL routing and paging).
    name: Technicians
  - description: Future runs queued for TRIGGERED agents.
    name: Scheduled work
  - description: Subscription state and customer-facing credit usage (no provider $).
    name: Billing
  - description: Inbox messages and announcements.
    name: Inbox & Comms
  - description: Tenant-authored agent skills (CRUD) and the built-in skill catalog.
    name: Skills
paths:
  /public-api/company-links:
    get:
      tags:
        - End companies
      summary: List an integration's company links
      description: >-
        How one integration's customers (IT Glue organizations, RMM sites, CIPP
        tenants, …) map to the tenant's PSA companies: the data behind the
        integration's **Organization Mapping** tab. Each row carries
        `link_state` (`AUTO` from a sync, `MANUAL` set by a person and kept by
        later syncs, `UNMAPPED`), `match_method` and `confidence`. An `AUTO`
        link below 0.95 is one the dashboard flags for a person to check.
        Unmapped rows sort first. `counts` covers the `system`, `psa_company_id`
        and `search` filters, never `status`. A SharePoint folder that was never
        confirmed is not listed: review new folders on the dashboard.
      operationId: public_api.company_links_list_get
      parameters:
        - description: The integration, for example `ITGLUE`, `CIPP` or `NINJA`.
          in: query
          name: system
          required: true
          schema:
            type: string
        - description: '`all` (default), `mapped`, `unmapped` or `manual`.'
          in: query
          name: status
          required: false
          schema:
            type: string
        - description: Only the links to this PSA company.
          in: query
          name: psa_company_id
          required: false
          schema:
            type: string
        - description: Case-insensitive substring of the integration's name for the entity.
          in: query
          name: search
          required: false
          schema:
            type: string
        - description: Items per page (1-200, default 50).
          in: query
          name: page_size
          required: false
          schema:
            type: integer
        - description: >-
            Opaque pagination cursor from a previous response's
            `meta.pagination.next_cursor`.
          in: query
          name: cursor
          required: false
          schema:
            type: string
      responses:
        '200':
          content:
            application/json:
              schema:
                properties:
                  data:
                    $ref: '#/components/schemas/PublicCompanyLinkPage'
                  meta:
                    $ref: '#/components/schemas/SuccessMeta'
                required:
                  - data
                  - meta
                type: object
          description: Success.
        '400':
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/ErrorEnvelope'
          description: Bad request — malformed input.
        '401':
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/ErrorEnvelope'
          description: Unauthenticated — missing or invalid credentials.
        '403':
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/ErrorEnvelope'
          description: Forbidden — authenticated but not allowed.
        '404':
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/ErrorEnvelope'
          description: Not found.
        '409':
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/ErrorEnvelope'
          description: Conflict — the resource is in a state that blocks this operation.
        '422':
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/ErrorEnvelope'
          description: Request validation failed.
        '429':
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/ErrorEnvelope'
          description: Rate limited — see Retry-After.
        '500':
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/ErrorEnvelope'
          description: Internal server error.
      security:
        - bearerAuth: []
components:
  schemas:
    PublicCompanyLinkPage:
      properties:
        counts:
          $ref: '#/components/schemas/PublicCompanyLinkCounts'
        links:
          items:
            $ref: '#/components/schemas/PublicCompanyLink'
          title: Links
          type: array
      required:
        - links
        - counts
      title: PublicCompanyLinkPage
      type: object
    SuccessMeta:
      properties:
        pagination:
          $ref: '#/components/schemas/Pagination'
        request_id:
          format: uuid
          type: string
        timings_ms:
          additionalProperties:
            type: number
          type: object
        warnings:
          description: >-
            Non-fatal warnings about the created/updated resource (e.g. an
            unhealthy PSA callback).
          items:
            type: string
          type: array
      required:
        - request_id
        - timings_ms
      type: object
    ErrorEnvelope:
      properties:
        error:
          properties:
            code:
              description: Stable machine-readable error code.
              type: string
            details:
              additionalProperties: true
              type: object
            message:
              type: string
          required:
            - code
            - message
          type: object
        meta:
          properties:
            request_id:
              format: uuid
              type:
                - string
                - 'null'
          type: object
      required:
        - error
        - meta
      type: object
    PublicCompanyLinkCounts:
      properties:
        mapped:
          title: Mapped
          type: integer
        total:
          title: Total
          type: integer
        unmapped:
          title: Unmapped
          type: integer
      required:
        - total
        - mapped
        - unmapped
      title: PublicCompanyLinkCounts
      type: object
    PublicCompanyLink:
      properties:
        confidence:
          title: Confidence
          type: number
        external_id:
          title: External Id
          type: string
        external_name:
          anyOf:
            - type: string
            - type: 'null'
          title: External Name
        is_primary:
          title: Is Primary
          type: boolean
        link_state:
          $ref: '#/components/schemas/CompanyLinkDisplaySource'
        mapped_at:
          anyOf:
            - format: date-time
              type: string
            - type: 'null'
          title: Mapped At
        mapped_by:
          anyOf:
            - type: string
            - type: 'null'
          title: Mapped By
        match_method:
          $ref: '#/components/schemas/CompanyLinkMatchMethod'
        psa_company_id:
          anyOf:
            - type: string
            - type: 'null'
          title: Psa Company Id
        psa_company_name:
          anyOf:
            - type: string
            - type: 'null'
          title: Psa Company Name
        system:
          $ref: '#/components/schemas/CompanyLinkSystem'
      required:
        - system
        - external_id
        - external_name
        - psa_company_id
        - psa_company_name
        - link_state
        - match_method
        - confidence
        - is_primary
        - mapped_by
        - mapped_at
      title: PublicCompanyLink
      type: object
    Pagination:
      properties:
        has_more:
          type: boolean
        next_cursor:
          type:
            - string
            - 'null'
      required:
        - next_cursor
        - has_more
      type: object
    CompanyLinkDisplaySource:
      description: >-
        The per-row source shown in the tab — mirrors the RMM MappingSource so
        the FE badge logic is

        identical. AUTO/MANUAL come from the link's `source`; UNMAPPED is
        derived when there's no company.
      enum:
        - AUTO
        - MANUAL
        - UNMAPPED
      title: CompanyLinkDisplaySource
      type: string
    CompanyLinkMatchMethod:
      description: >-
        The rung of the resolution ladder that produced a link (strongest
        first).


        Precedence on conflict:

        MANUAL > LEARNED_MANUAL > NATIVE_ADAPTER > EXACT_NAME > FUZZY > DOMAIN >
        LLM > ASSET_OVERLAP.
      enum:
        - NATIVE_ADAPTER
        - DOMAIN
        - EXACT_NAME
        - FUZZY
        - LLM
        - ASSET_OVERLAP
        - LEARNED_MANUAL
        - MANUAL
        - UNMATCHED
      title: CompanyLinkMatchMethod
      type: string
    CompanyLinkSystem:
      enum:
        - ITGLUE
        - NINJA
        - DATTO
        - CW_ASIO
        - CW_AUTOMATE
        - NCENTRAL
        - NSIGHT
        - VSAX
        - SCREENCONNECT
        - SYNCRO_RMM
        - ADDIGY
        - CONFLUENCE
        - HUDU
        - LEXFUL
        - HUNTRESS
        - SHAREPOINT
        - THREATLOCKER
        - UNIFI
        - AUTOELEVATE
        - PROOFPOINT_ESSENTIALS
        - HORNETSECURITY
        - SENTINELONE
        - WIZER
        - UNIVIEW
        - DATTO_BCDR
        - CIPP
        - DOMOTZ
        - AUVIK
        - BEYONDTRUST_EPM
        - SAAS_ALERTS
        - KASEYA_QUOTE_MANAGER
        - DATTO_EDR
        - INGRAM_MICRO
        - TD_SYNNEX
        - TD_SYNNEX_STELLR
        - M365
        - MARKETPLACE
        - SLACK
      title: CompanyLinkSystem
      type: string
  securitySchemes:
    bearerAuth:
      description: >-
        `Authorization: Bearer <token>` where `<token>` is either a
        `neo_sk_<env>_<secret>` API key (service account) or a Microsoft Entra
        ID access token (dashboard user).
      scheme: bearer
      type: http

````

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