> ## 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. # Map an integration's entity to a PSA company > Sets a `MANUAL` link, the same change as **Map** or **Re-map** on the Organization Mapping tab. Later syncs keep it. The entity must already be listed by `GET /public-api/company-links`, else `404 company_link_not_found`; a `psa_company_id` that is not one of the tenant's synced PSA companies is `404 psa_company_not_found`. `M365` and `MARKETPLACE` links come from the company's own `tenant_id` and `marketplace_company_ids` (`PATCH /public-api/end-companies/{id}`), and a `SLACK` link from the Slack install, so all three are `400`. For a SharePoint folder, `restamp_failed_folder_paths` names a folder whose synced docs kept their previous scope (the old company, or none on a first mapping): retry the call. ## OpenAPI ````yaml https://api.neoagent.io/public-api/openapi.json post /public-api/company-links/assign 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__` 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/assign: post: tags: - End companies summary: Map an integration's entity to a PSA company description: >- Sets a `MANUAL` link, the same change as **Map** or **Re-map** on the Organization Mapping tab. Later syncs keep it. The entity must already be listed by `GET /public-api/company-links`, else `404 company_link_not_found`; a `psa_company_id` that is not one of the tenant's synced PSA companies is `404 psa_company_not_found`. `M365` and `MARKETPLACE` links come from the company's own `tenant_id` and `marketplace_company_ids` (`PATCH /public-api/end-companies/{id}`), and a `SLACK` link from the Slack install, so all three are `400`. For a SharePoint folder, `restamp_failed_folder_paths` names a folder whose synced docs kept their previous scope (the old company, or none on a first mapping): retry the call. operationId: public_api.company_links_assign_post parameters: [] requestBody: content: application/json: schema: $ref: '#/components/schemas/AssignCompanyLinkRequest' required: true responses: '200': content: application/json: schema: properties: data: $ref: '#/components/schemas/CompanyLinkWriteResponse' 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: AssignCompanyLinkRequest: properties: external_id: minLength: 1 title: External Id type: string psa_company_id: minLength: 1 title: Psa Company Id type: string system: $ref: '#/components/schemas/CompanyLinkSystem' required: - system - external_id - psa_company_id title: AssignCompanyLinkRequest type: object CompanyLinkWriteResponse: properties: link: $ref: '#/components/schemas/PublicCompanyLink' restamp_failed_folder_paths: items: type: string title: Restamp Failed Folder Paths type: array required: - link - restamp_failed_folder_paths title: CompanyLinkWriteResponse 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 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 - MIMECAST - 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 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 securitySchemes: bearerAuth: description: >- `Authorization: Bearer ` where `` is either a `neo_sk__` 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.