> ## 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.

# Change the tenant's IT Glue settings

> Body: `general_docs_company_names` (the full list, which replaces the stored one; `[]` clears it), `restricted_docs` (`EXCLUDE_ALL` or `INCLUDE_ALL`), or both. A field left out keeps its value. Names match IT Glue organization names without regard to case; blanks and repeats are dropped, at most 100 names of 200 characters. A new general organization reaches every agent at once. `400` on any other field, a null, or a list while IT Glue is not connected. Returns the settings.



## OpenAPI

````yaml https://api.neoagent.io/public-api/openapi.json put /public-api/integrations/itglue-config
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/integrations/itglue-config:
    put:
      tags:
        - Integrations
      summary: Change the tenant's IT Glue settings
      description: >-
        Body: `general_docs_company_names` (the full list, which replaces the
        stored one; `[]` clears it), `restricted_docs` (`EXCLUDE_ALL` or
        `INCLUDE_ALL`), or both. A field left out keeps its value. Names match
        IT Glue organization names without regard to case; blanks and repeats
        are dropped, at most 100 names of 200 characters. A new general
        organization reaches every agent at once. `400` on any other field, a
        null, or a list while IT Glue is not connected. Returns the settings.
      operationId: public_api.itglue_config_update_put
      parameters: []
      requestBody:
        content:
          application/json:
            schema:
              $ref: '#/components/schemas/PublicItglueConfigUpdate'
        required: true
      responses:
        '200':
          content:
            application/json:
              schema:
                properties:
                  data:
                    $ref: '#/components/schemas/PublicItglueConfig'
                  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:
    PublicItglueConfigUpdate:
      additionalProperties: false
      description: >-
        A change to the tenant's IT Glue settings. A field left out keeps its
        stored value.
      properties:
        general_docs_company_names:
          anyOf:
            - items:
                type: string
              type: array
            - type: 'null'
          default: null
          description: >-
            The full list of general-documentation organizations; it replaces
            the stored one, and `[]` clears it. Each name as the organization is
            named in IT Glue.
          title: General Docs Company Names
        restricted_docs:
          anyOf:
            - enum:
                - EXCLUDE_ALL
                - INCLUDE_ALL
              type: string
            - type: 'null'
          default: null
          description: EXCLUDE_ALL or INCLUDE_ALL.
          title: Restricted Docs
      title: PublicItglueConfigUpdate
      type: object
    PublicItglueConfig:
      description: The tenant's IT Glue settings.
      properties:
        connected:
          description: >-
            Whether the IT Glue API integration is connected. The
            general-documentation list exists only while it is.
          title: Connected
          type: boolean
        general_docs_company_names:
          description: >-
            The IT Glue organizations whose documents every company shares
            (Company Names for General Documentation on the dashboard). Names
            match the IT Glue organization names, without regard to case. Empty
            when none is set.
          items:
            type: string
          title: General Docs Company Names
          type: array
        restricted_docs:
          description: >-
            EXCLUDE_ALL (the default): no agent uses documents IT Glue marks
            restricted. INCLUDE_ALL: the MSP's own agents may use them, marked
            confidential. Client-facing agents and the phone agent never use
            them.
          enum:
            - EXCLUDE_ALL
            - INCLUDE_ALL
          title: Restricted Docs
          type: string
      required:
        - connected
        - general_docs_company_names
        - restricted_docs
      title: PublicItglueConfig
      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
    Pagination:
      properties:
        has_more:
          type: boolean
        next_cursor:
          type:
            - string
            - 'null'
      required:
        - next_cursor
        - has_more
      type: object
  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.