---
title: "Delete call link"
method: DELETE
path: "/call-link/1/links/{id}"
tags: ["channels", "webrtc-calls", "call-link", "call-links"]
---

# Delete call link

`DELETE /call-link/1/links/{id}`

## Request

- Base URL: `https://api.infobip.com` (the document declares no server; this is the origin it was published from)
- URL: `https://api.infobip.com/call-link/1/links/{id}`
- Auth: one of:
  - OAuth 2
    - Client credentials
    - Token URL: `https://api.infobip.com/auth/1/oauth2/token`
  - API key in header `Authorization`
  - API key in header `Authorization`
  - HTTP basic

Use this method to delete a call link by its ID.

## Path parameters

- `id` string, required

## Response `200`

Success.

- Ae8a6eecccfb565f1840ac10e7bfb960a35d1e256ae31abf1bdea45a1d2f5557CallLink: Use the call link feature to enable calls between users that have an Infobip account and users that don't.
  - `id` string: Identifier of the created call link. To open a call link, it should be concatenated to the URL: https://call-link.com/.
  - `url` string: A URL to initiate a call.
  - `identity` string, required: Identity of a user who will use a call link.
  - `displayName` string: Display name of a user who will use a call link to initiate a call.
  - `showIdentity` boolean: Show identity or displayName on before a call.
  - `destination` 2188fec7c48e989bb7053521bdef9d76d71def96483c5304f01cd7e0878f8f14Destination, required: Description of who or what is going to receive a call.
    - `type` 'WEBRTC' | 'CONVERSATIONS' | 'ROOM' | 'PHONE' | 'VIBER' | 'APPLICATION'
  - `customData` object: Custom attributes sent in a call once it is started.
  - `validityWindow` 2188fec7c48e989bb7053521bdef9d76d71def96483c5304f01cd7e0878f8f14ValidityWindow: Description of a call link validation period and the number of times it can be used within the range.
    - `oneTime` boolean: By default, call links are generated for multiple calls.If you want to limit the period for how long a link is valid, specify the start and end time. If you want to invalidate a link after establishing a call, set this value to 'true' (defaults to 'false').For ROOM calls, this value cannot be 'true'.
    - `startTime` string, date-time: Specify starting moment in the UTC timezone for when a call link becomes valid. Defaults to the time when a link was created. Has the following format: `yyyy-MM-dd'T'HH:mm:ss.SSS+ZZZZ`.
    - `endTime` string, date-time: Specify ending moment in the UTC timezone for when a call link becomes invalid. Default value is 24 hours after a link was created. Has the following format: `yyyy-MM-dd'T'HH:mm:ss.SSS+ZZZZ`.
    - `acceptableHours` 2188fec7c48e989bb7053521bdef9d76d71def96483c5304f01cd7e0878f8f14AcceptableHours: Specify time range within a day when a link can be used. It is 00:00 - 23:59, by default. UTC timezone is used.
      - `start` 2188fec7c48e989bb7053521bdef9d76d71def96483c5304f01cd7e0878f8f14TimeOfDay
        - `hour` integer
        - `minute` integer
      - `end` 2188fec7c48e989bb7053521bdef9d76d71def96483c5304f01cd7e0878f8f14TimeOfDay
        - `hour` integer
        - `minute` integer
    - `acceptableDays` 2188fec7c48e989bb7053521bdef9d76d71def96483c5304f01cd7e0878f8f14DayOfWeek[]: Specify the days a link can be used. It is every day of the week, by default.
  - `callLinkConfigId` string: ID of a configuration to use on an existing call link. If this parameter is not sent, and there are some call link configurations, the default one will be used. If there is no configurations, then the one with the system default values will be used.

## Other responses

- `401`: Unauthorized
- `403`: Forbidden
- `404`: Not found.
- `429`: Too Many Requests
- `500`: Internal Server Error

---

[API](https://skmtc.dev/infobip/apis/infobip-openapi-specification.md) - [All operations](https://skmtc.dev/infobip/apis/infobip-openapi-specification/llms.txt) - [OpenAPI document](https://skmtc.dev/infobip/apis/infobip-openapi-specification/revisions/9dcbbaf902de?raw)