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

# Unlink Contacts from Opportunity

> Unlinks the given contacts from an opportunity. Idempotent — contacts that are not currently linked are recorded as removed so they stay off the opportunity.



## OpenAPI

````yaml https://api.monaco.com/openapi.json post /v1/opportunities/{opportunity_id}/contacts/remove
openapi: 3.1.0
info:
  title: Monaco Public API
  description: Public API for Monaco
  version: 1.0.0
servers:
  - url: https://api.monaco.com
security: []
paths:
  /v1/opportunities/{opportunity_id}/contacts/remove:
    post:
      tags:
        - Opportunities
      summary: Unlink Contacts from Opportunity
      description: >-
        Unlinks the given contacts from an opportunity. Idempotent — contacts
        that are not currently linked are recorded as removed so they stay off
        the opportunity.
      operationId: unlink_contacts_from_opportunity
      parameters:
        - name: opportunity_id
          in: path
          required: true
          schema:
            type: string
            format: uuid
            title: Opportunity Id
      requestBody:
        required: true
        content:
          application/json:
            schema:
              $ref: '#/components/schemas/OpportunityContactsRequest'
      responses:
        '200':
          description: Successful Response
          content:
            application/json:
              schema:
                $ref: >-
                  #/components/schemas/PublicItemResponse_OpportunityContactsMutationResponse_
              example:
                data:
                  opportunity_id: 550e8400-e29b-41d4-a716-446655440010
                  contact_ids:
                    - 550e8400-e29b-41d4-a716-446655440000
                meta:
                  timestamp: '2026-04-21T12:00:00Z'
        4XX:
          description: Client error
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/PublicErrorResponse'
components:
  schemas:
    OpportunityContactsRequest:
      properties:
        contact_ids:
          items:
            type: string
            format: uuid
          type: array
          maxItems: 500
          minItems: 1
          title: Contact Ids
          description: >-
            Contact IDs to link or unlink. At most 500 ids. MCP/LLM callers may
            pass a JSON-stringified array.
      type: object
      required:
        - contact_ids
      title: OpportunityContactsRequest
      description: Request body for linking or unlinking contacts on an opportunity.
    PublicItemResponse_OpportunityContactsMutationResponse_:
      properties:
        data:
          $ref: '#/components/schemas/OpportunityContactsMutationResponse'
        meta:
          $ref: '#/components/schemas/ResponseMeta'
      type: object
      required:
        - data
      title: PublicItemResponse[OpportunityContactsMutationResponse]
    PublicErrorResponse:
      properties:
        error:
          $ref: '#/components/schemas/ErrorDetail'
      type: object
      required:
        - error
      title: PublicErrorResponse
    OpportunityContactsMutationResponse:
      properties:
        opportunity_id:
          type: string
          title: Opportunity Id
          description: Opportunity the contacts were linked to or unlinked from
          examples:
            - 550e8400-e29b-41d4-a716-446655440010
        contact_ids:
          items:
            type: string
          type: array
          title: Contact Ids
          description: Contact IDs that were processed
          examples:
            - - 550e8400-e29b-41d4-a716-446655440000
      type: object
      required:
        - opportunity_id
        - contact_ids
      title: OpportunityContactsMutationResponse
      description: Result of linking or unlinking contacts on an opportunity.
    ResponseMeta:
      properties:
        timestamp:
          type: string
          format: date-time
          title: Timestamp
          description: Server timestamp of the response
      type: object
      title: ResponseMeta
    ErrorDetail:
      properties:
        code:
          type: string
          title: Code
          description: Machine-readable error code
          examples:
            - not_found
        message:
          type: string
          title: Message
          description: Human-readable error message
          examples:
            - Resource not found
      type: object
      required:
        - code
        - message
      title: ErrorDetail

````