---
title: "Toggle shared status of a contact"
method: PATCH
path: "/contacts/{contactId}/shared/toggle"
tags: ["contacts"]
---

# Toggle shared status of a contact

`PATCH /contacts/{contactId}/shared/toggle`

Toggles the `is_shared` attribute of the specified contact. When shared, the contact becomes visible to other team members.

**Permission:** `Contacts Write` required.

**Monitoring:** No impact.

## Path parameters

- `contactId` integer, required

## Response `200`

Shared status successfully toggled.

## Other responses

- `304` — Contact was not modified — shared status unchanged.
- `401` — Unauthorized — missing or invalid API token, or missing `Contacts Write` permission.
- `404` — Contact not found — no contact matches the provided ID.
- `500` — Internal server error.

---

[API](https://skmtc.net/ringover/apis/ringover-public-api.md) · [All operations](https://skmtc.net/ringover/apis/ringover-public-api/llms.txt) · [OpenAPI document](https://skmtc-service-staging.skmtc.workers.dev/v1/apis/ringover/ringover-public-api/revisions/9da73dd2f99e/schema)