> ## 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. # Auto-map technicians to their Microsoft user > Matches PSA technicians to their Microsoft Entra identity by email/UPN against the members of every Team in the tenant and persists each match. Takes no body. Manual mappings set on the Profiles tab are never overwritten. Always requires technician approval via NEO_API_REQUEST (rewrites who dispatch reads presence for). ## OpenAPI ````yaml https://api.neoagent.io/public-api/openapi.json post /public-api/teams-availability/auto-map 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: 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). 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/teams-availability/auto-map: post: tags: - Integrations summary: Auto-map technicians to their Microsoft user description: >- Matches PSA technicians to their Microsoft Entra identity by email/UPN against the members of every Team in the tenant and persists each match. Takes no body. Manual mappings set on the Profiles tab are never overwritten. Always requires technician approval via NEO_API_REQUEST (rewrites who dispatch reads presence for). operationId: public_api.teams_availability_auto_map_post parameters: [] responses: '200': content: application/json: schema: properties: data: $ref: '#/components/schemas/TeamsAvailabilityAutoMapResponse' 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: TeamsAvailabilityAutoMapResponse: properties: matched: items: $ref: '#/components/schemas/PublicMappedTechnician' title: Matched type: array unmatched: items: $ref: '#/components/schemas/PublicUnmatchedTechnician' title: Unmatched type: array required: - matched - unmatched title: TeamsAvailabilityAutoMapResponse 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 PublicMappedTechnician: properties: entra_object_id: title: Entra Object Id type: string name: title: Name type: string psa_id: title: Psa Id type: string upn: anyOf: - type: string - type: 'null' title: Upn required: - psa_id - name - entra_object_id - upn title: PublicMappedTechnician type: object PublicUnmatchedTechnician: properties: email: anyOf: - type: string - type: 'null' title: Email name: title: Name type: string psa_id: title: Psa Id type: string required: - psa_id - name - email title: PublicUnmatchedTechnician 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 ` where `` is either a `neo_sk__` API key (service account) or a Microsoft Entra ID access token (dashboard user). scheme: bearer type: http ````