---
title: "Change Conversation Privacy"
method: PUT
path: "/conversations/{id}/change_privacy"
tags: ["Conversation"]
---

# Change Conversation Privacy

`PUT /conversations/{id}/change_privacy`

Change the privacy of a conversation from private to public and vice versa

## Path parameters

- `id` string, required

## Query parameters

- `privacy` 'public' | 'private', required

## Response `200`

Successfully updated conversation

- Conversation
  - `type` 'conversations'
  - `id` string
  - `attributes` object
    - `uuid` string
    - `transcript` object
    - `boards` ConversationBoard[]
      - `uuid` string
      - `board` Board
        - `uuid` string
        - `name` string
        - `columns` Column[]
          - `id` string
          - `title` string
          - `children` Battlecard[]
            - `uuid` string
            - `keywords` string[]
            - `response` string
            - `text` string
        - `team` Team — Represents a team in the system with its properties and hierarchical structure
          - `uuid` string — Unique identifier of the team
          - `name` string — Name of the team
          - `phrases` string[] — List of keywords or phrases associated with the team
          - `slackConnection` SlackConnection — Represents the Slack integration details for a team
            - `id` string — Slack connection identifier
            - `info` SlackTeamInfo — Information about a connected Slack team
              - …
          - `domain` string — Domain associated with the team
          - `organizerJoinInternalMeetings` boolean — Whether team organizers can join internal meetings
          - `consentEmailEnabled` boolean — Whether email consent is enabled for the team
          - `parentTeamUUID` string — UUID of the parent team if this team is part of a hierarchy
          - `organizationUUID` string — UUID of the organization this team belongs to
          - `children` Team[] — List of child teams if this team has a hierarchical structure
        - `teamUUID` string
      - `battlecards` ConversationBoardBattlecard[]
        - `uuid` string
        - `activatedBattlecardID` string
        - `hidden` boolean
        - `feedbackAction` string
    - `finishedAt` string, date-time
    - `title` string
    - `liveStreamStartedAt` string, date-time
    - `liveStreamEndedAt` string, date-time
    - `talktracks` ConversationTalktrack[]
      - `uuid` string
      - `items` ConversationTalktrackItem[]
        - `uuid` string
        - `activatedItemId` string
        - `done` boolean
    - `createdAt` string, date-time
    - `userUUID` string
    - `user` User
      - `uuid` string — The unique identifier of the user.
      - `email` string — The email address of the user.
      - `firstName` string — The first name of the user.
      - `lastName` string — The last name of the user.
      - `createdAt` string — The date and time the user was created.
      - `deletedAt` string — The date and time the user was deactivated.
      - `transcriptLang` string — The preferred transcript language for the user.
      - `joinOutsideHostMeetings` boolean — Indicates if the user can join meetings outside their host organization.
      - `realTimeCapabilities` boolean — Indicates if the user has real-time transcription capabilities.
      - `settings` UserSettings
        - `realTimeCapabilitiesOFF` boolean
        - `autoCalculateCRMFields` boolean
        - `joinWhenIAmHostAndAlone` boolean
        - `joinWhenIAmHostWithPeers` boolean
        - `joinWhenPeerIsHost` boolean
        - `joinWhenUnlicensedPeerIsHost` boolean
        - `dealsEnabled` boolean
      - `botName` string — The name of the bot associated with the user.
      - `botImageURL` string — The URL of the bot's profile image.
      - `primaryTeamUUID` string — The UUID of the user's primary team.
      - `organizationRoleUUID` string — The UUID of the user's role in the organization.
      - `roles` Role[] — A list of roles assigned to the user.
        - `uuid` string
        - `name` string
        - `type` string
      - `showReferralScreen` boolean — Whether the user is shown a referral screen.
      - `seatType` string — The type of seat assigned to the user.
      - `teams` Team[] — A list of teams assigned to the user.
        - `uuid` string — Unique identifier of the team
        - `name` string — Name of the team
        - `phrases` string[] — List of keywords or phrases associated with the team
        - `slackConnection` SlackConnection — Represents the Slack integration details for a team
          - `id` string — Slack connection identifier
          - `info` SlackTeamInfo — Information about a connected Slack team
            - `id` string — Slack team identifier
            - `name` string — Name of the Slack team
        - `domain` string — Domain associated with the team
        - `organizerJoinInternalMeetings` boolean — Whether team organizers can join internal meetings
        - `consentEmailEnabled` boolean — Whether email consent is enabled for the team
        - `parentTeamUUID` string — UUID of the parent team if this team is part of a hierarchy
        - `organizationUUID` string — UUID of the organization this team belongs to
        - `children` Team[] — List of child teams if this team has a hierarchical structure
    - `team` Team — Represents a team in the system with its properties and hierarchical structure
      - `uuid` string — Unique identifier of the team
      - `name` string — Name of the team
      - `phrases` string[] — List of keywords or phrases associated with the team
      - `slackConnection` SlackConnection — Represents the Slack integration details for a team
        - `id` string — Slack connection identifier
        - `info` SlackTeamInfo — Information about a connected Slack team
          - `id` string — Slack team identifier
          - `name` string — Name of the Slack team
      - `domain` string — Domain associated with the team
      - `organizerJoinInternalMeetings` boolean — Whether team organizers can join internal meetings
      - `consentEmailEnabled` boolean — Whether email consent is enabled for the team
      - `parentTeamUUID` string — UUID of the parent team if this team is part of a hierarchy
      - `organizationUUID` string — UUID of the organization this team belongs to
      - `children` Team[] — List of child teams if this team has a hierarchical structure
    - `teamUUID` string
    - `extractedIntelligence` object
    - `confirmedExtractedIntelligence` object
    - `externalIntelligenceOpportunityID` string, required
    - `crmExportStatus` 'PENDING' | 'EXPORTED' | 'DISMISSED'
    - `archived` boolean
    - `externalOpportunity` CRMExportOpportunity, required
      - `uuid` string
      - `title` string
    - `videoUID` string
    - `videoStatus` 'PENDING' | 'UNAVAILABLE' | 'IMPORTING' | 'READY'
    - `bots` ConversationBot[]
      - `uuid` string
      - `status` BotStatus
        - `code` string
        - `message` string
        - `createdAt` string, date-time
      - `meetingUrl` string — The original meeting URL used to invite the bot
    - `transcriptStatus` string
    - `participants` Participant[]
      - `id` string
      - `email` string
      - `organizer` boolean
      - `name` string
      - `status` string
    - `attendees` Participant[]
      - `id` string
      - `email` string
      - `organizer` boolean
      - `name` string
      - `status` string
    - `referenceable` boolean
    - `private` boolean
    - `mediaStorageStatus` 'PENDING' | 'UNAVAILABLE' | 'IMPORTING' | 'READY'
    - `importStatus` 'NONE' | 'PENDING' | 'IN_PROGRESS' | 'FINISHED' | 'DISCARDED' | 'FAILED'
    - `scorecardResults` ScorecardResult[]
      - `uuid` string
      - `title` string
      - `summary` ScorecardResultSummary
        - `min` integer
        - `max` integer
        - `averageScore` number, float
        - `summaryText` string
      - `items` ScorecardItemResult[]
        - `uuid` string
        - `title` string
        - `status` 'CALCULATED' | 'CALCULATING'
        - `type` 'NUMERIC'
        - `position` integer
        - `numericResult` NumericScorecardResult
          - `min` integer
          - `max` integer
          - `score` integer
        - `description` string
        - `evidences` string[]
        - `scorecardItemUUID` string
    - `labels` object
    - `labelTagsToFilterIfNA` string[]
    - `deprecatedLabelCategories` string[]
    - `isInternal` boolean
    - `mediaDuration` number, float
    - `dealUUID` string, required
    - `emailTemplateID` string
    - `linkedCrmRecords` LinkedCrmRecord[]
      - `id` string, required
      - `code` string, required
    - `externalAccounts` LinkedCrmRecord[]
      - `id` string, required
      - `code` string, required
    - `externalContacts` LinkedCrmRecord[]
      - `id` string, required
      - `code` string, required
    - `isEmpty` boolean
    - `zoomMetadata` ZoomMetadata, required
      - `calleeName` string, required
      - `calleeNumber` string, required
      - `callerName` string, required
      - `callerNumber` string, required
    - `importMetadata` object, required
    - `zoomMeetingJoinUrl` string — The Zoom meeting join URL if the conversation was recorded from a Zoom meeting
    - `googleMeetJoinUrl` string — The Google Meet join URL if the conversation was recorded from a Google Meet
    - `microsoftTeamsJoinUrl` string — The Microsoft Teams meeting join URL if the conversation was recorded from a Teams meeting
    - `webexJoinUrl` string — The Webex meeting join URL if the conversation was recorded from a Webex meeting
  - `links` Links
    - `self` string
    - `related` string

## Other responses

- `401` — Authentication failed - valid API key required
- `404` — Conversation not found
- `default` — Unexpected error occurred

---

[API](https://skmtc.net/attention/apis/attention-service-v2.md) · [All operations](https://skmtc.net/attention/apis/attention-service-v2/llms.txt) · [OpenAPI document](https://skmtc-service-staging.skmtc.workers.dev/v1/apis/attention/attention-service-v2/revisions/5de55d3804cf/schema)