---
title: "Remove the star of a contact"
method: DELETE
path: "/service_agents/contacts/{id}/star"
tags: ["Service Agent"]
---

# Remove the star of a contact

`DELETE /service_agents/contacts/{id}/star`

## Request

- Base URL: `https://api.voipbin.net/v1.0`
- URL: `https://api.voipbin.net/v1.0/service_agents/contacts/{id}/star`
- Auth: none declared
- TypeScript: <https://skmtc.dev/voipbin/apis/voipbin-api/docs/service_agents/contacts/:id/star/delete.ts> (a function with typed inputs; its response is checked against the schema)

Remove the calling agent's star on the contact. The call is idempotent: removing a star that
does not exist also returns 200. A contact that does not exist, is deleted, or belongs to
another customer returns 404.

## Path parameters

- `id` string, uuid, required

## Response `200`

The contact is not starred.

- ContactManagerContactStar
  - `contact_id` string, uuid, required: The contact ID returned from GET /service_agents/contacts.
  - `starred` boolean, required: Whether the calling agent has starred the contact.
  - `tm_create` string, date-time: When the contact was starred. Absent when starred is false.

## Other responses

- `400`: Invalid request (INVALID_ARGUMENT).
- `401`: Authentication required (UNAUTHENTICATED).
- `403`: Insufficient permission (PERMISSION_DENIED).
- `404`: Resource not found (NOT_FOUND).
- `500`: Internal error (INTERNAL).

## Changes

- **2026-11-02** `77a8b1190027`: 1 info
  - endpoint added

[Operation history](https://skmtc.dev/voipbin/apis/voipbin-api/changes/service_agents/contacts/:id/star/delete.md)

---

[API](https://skmtc.dev/voipbin/apis/voipbin-api.md) - [All operations](https://skmtc.dev/voipbin/apis/voipbin-api/llms.txt) - [OpenAPI document](https://skmtc.dev/voipbin/apis/voipbin-api/revisions/a3618cfd2159?raw)