> ## Documentation Index > Fetch the complete documentation index at: https://openphone-dev.mintlify.site/llms.txt > Use this file to discover all available pages before exploring further. # Update contact shares > Add or remove the users, groups, or organization a contact is shared with. Only the shares you name change; the contact's other shares stay as they are. ## OpenAPI ````yaml https://openphone-public-api-dev.s3.us-west-2.amazonaws.com/public/openphone-public-api-2026-03-30-dev.json patch /contacts/{contactId}/shares openapi: 3.1.0 info: title: Quo Public API version: 1.0.0 description: API for connecting with Quo. contact: name: Quo Support email: support@quo.com url: https://support.quo.com/ termsOfService: https://www.quo.com/terms servers: - description: Development server url: https://dev-public-api.openphone.dev security: - apiKey: [] tags: - description: Operations related to the organization's A2P registration name: A2P Registration - description: Operations related to calls placed by an AI agent name: Agent Calls - description: Operations related to text conversations held by an AI agent name: Agent Conversations - description: Operations related to calls name: Calls - description: >- Operations related to call summaries, including AI-generated summaries and Sona voice assistant summaries name: Call Summaries - description: >- Operations related to call transcripts, including AI-generated transcripts and Sona voice assistant transcripts name: Call Transcripts - description: Operations related to contacts name: Contacts - description: Operations related to contact shares name: Contact Shares - description: Operations related to contact notes name: Contact Notes - description: Operations related to contact properties name: Contact Properties - description: Operations related to conversations name: Conversations - description: Operations related to workspace invitations name: Invites - description: Operations related to text messages name: Messages - description: Operations related to the organization name: Organization - description: Operations related to phone numbers name: Phone Numbers - description: Operations related to users name: Users - description: Operations related to webhooks name: Webhooks - description: >- Operations related to webhook events, including delivery history and test events name: Webhook Events paths: /contacts/{contactId}/shares: patch: tags: - Contact Shares summary: Update contact shares description: >- Add or remove the users, groups, or organization a contact is shared with. Only the shares you name change; the contact's other shares stay as they are. operationId: updateContactShares parameters: - in: path name: contactId required: true schema: description: >- The unique identifier of the contact whose shares are being updated. examples: - 6a145ff26212a192852c856e type: string pattern: ^(.*)$ example: 6a145ff26212a192852c856e - in: header name: Quo-Api-Version required: true schema: type: string enum: - '2026-03-30' description: 'API version header. Supported values: 2026-03-30' requestBody: required: true content: application/json: schema: type: object properties: add: type: array items: type: string pattern: ^(US|GR|OR)(.*)$ description: >- A user, group, or organization ID. User IDs start with `US`, group IDs start with `GR`, and organization IDs start with `OR`. examples: - US123abc - GR123abc - OR8UgLbDLE example: US123abc maxItems: 100 description: >- The IDs of the users, groups, or organization to share the contact with, in addition to its current shares. User IDs start with `US`, group IDs start with `GR`, and organization IDs start with `OR`. Each must belong to your organization. Sharing with your organization shares the contact with everyone in it. examples: - - US123abc - GR123abc example: - US123abc - GR123abc remove: type: array items: type: string pattern: ^(US|GR|OR)(.*)$ description: >- A user, group, or organization ID. User IDs start with `US`, group IDs start with `GR`, and organization IDs start with `OR`. examples: - US123abc - GR123abc - OR8UgLbDLE example: US123abc maxItems: 100 description: >- The IDs of the users, groups, or organization to stop sharing the contact with. User IDs start with `US`, group IDs start with `GR`, and organization IDs start with `OR`. IDs the contact isn't shared with are ignored. The contact's owner (the `actorId` returned by the list and get contact endpoints) cannot be removed: naming them here leaves them shared, and they are not included in `removed`. examples: - - US456def example: - US456def additionalProperties: false responses: '200': description: OK content: application/json: schema: type: object required: - data properties: data: type: object required: - contactId - added - removed properties: contactId: description: The unique identifier of the contact. examples: - 6a145ff26212a192852c856e example: 6a145ff26212a192852c856e type: string pattern: ^(.*)$ added: type: array items: type: string pattern: ^(US|GR|OR)(.*)$ description: >- A user, group, or organization ID. User IDs start with `US`, group IDs start with `GR`, and organization IDs start with `OR`. examples: - US123abc - GR123abc - OR8UgLbDLE example: US123abc description: >- The IDs the contact is now shared with that it wasn't before. User IDs start with `US`, group IDs start with `GR`, and organization IDs start with `OR`. examples: - - US123abc - GR123abc example: - US123abc - GR123abc removed: type: array items: type: string pattern: ^(US|GR|OR)(.*)$ description: >- A user, group, or organization ID. User IDs start with `US`, group IDs start with `GR`, and organization IDs start with `OR`. examples: - US123abc - GR123abc - OR8UgLbDLE example: US123abc description: >- The IDs the contact was shared with and no longer is. User IDs start with `US`, group IDs start with `GR`, and organization IDs start with `OR`. examples: - - US456def example: - US456def '400': description: Bad Request content: application/json: schema: type: object required: - message - docs - title properties: message: type: string docs: type: string const: https://quo.com/docs title: type: string const: Bad Request trace: type: string errors: type: array items: type: object required: - path - message - schema properties: path: type: string message: type: string value: {} schema: type: object properties: type: type: string example: message: The input was invalid docs: https://quo.com/docs title: Bad Request trace: '6897907457496870895' '401': description: Unauthorized content: application/json: schema: type: object required: - message - docs - title properties: message: type: string docs: type: string const: https://quo.com/docs title: type: string const: Unauthorized trace: type: string errors: type: array items: type: object required: - path - message - schema properties: path: type: string message: type: string value: {} schema: type: object properties: type: type: string example: message: User is unauthorized to perform this action docs: https://quo.com/docs title: Unauthorized trace: '6897907457496870895' '403': description: Forbidden content: application/json: schema: type: object required: - message - docs - title properties: message: type: string docs: type: string const: https://quo.com/docs title: type: string const: Forbidden trace: type: string errors: type: array items: type: object required: - path - message - schema properties: path: type: string message: type: string value: {} schema: type: object properties: type: type: string example: message: User is forbidden to perform this action docs: https://quo.com/docs title: Forbidden trace: '6897907457496870895' '404': description: Not Found content: application/json: schema: type: object required: - message - docs - title properties: message: type: string docs: type: string const: https://quo.com/docs title: type: string const: Not Found trace: type: string errors: type: array items: type: object required: - path - message - schema properties: path: type: string message: type: string value: {} schema: type: object properties: type: type: string example: message: The contact was not found docs: https://quo.com/docs title: Not Found trace: '6897907457496870895' '500': description: Unexpected Error | Unknown Error content: application/json: schema: oneOf: - $ref: '#/components/schemas/UnexpectedError' - $ref: '#/components/schemas/UnknownError' examples: UnexpectedError: summary: Unexpected Error value: message: An unexpected error has occurred docs: https://quo.com/docs title: Unexpected Error trace: '6897907457496870895' UnknownError: summary: Unknown Error value: message: An unknown error has occurred docs: https://quo.com/docs title: Unknown Error trace: '6897907457496870895' security: - apiKey: [] components: schemas: UnexpectedError: type: object required: - message - docs - title properties: message: type: string docs: type: string const: https://quo.com/docs title: type: string const: Unexpected trace: type: string errors: type: array items: type: object required: - path - message - schema properties: path: type: string message: type: string value: {} schema: type: object properties: type: type: string title: Unexpected Error UnknownError: type: object required: - message - docs - title properties: message: type: string docs: type: string const: https://quo.com/docs title: type: string const: Unknown trace: type: string errors: type: array items: type: object required: - path - message - schema properties: path: type: string message: type: string value: {} schema: type: object properties: type: type: string title: Unknown Error securitySchemes: apiKey: in: header name: Authorization type: apiKey ````