---
title: "Revoke a portal link"
method: PUT
path: "/v1/projects/{projectID}/portal-links/{portalLinkID}/revoke"
tags: ["Portal Links"]
---

# Revoke a portal link

`PUT /v1/projects/{projectID}/portal-links/{portalLinkID}/revoke`

## Request

- Base URL: `https://us.getconvoy.cloud/api`
- URL: `https://us.getconvoy.cloud/api/v1/projects/{projectID}/portal-links/{portalLinkID}/revoke`
- Auth: HTTP bearer

This endpoint revokes a portal link

## Path parameters

- `projectID` string, required
- `portalLinkID` string, required

## Response `200`

OK

- object
  - `message` string
  - `status` boolean
  - `data` HandlersStub, nullable

## Other responses

- `400`: Bad Request
- `401`: Unauthorized
- `404`: Not Found

## Changes

- **2026-07-20** (v3) `bae289777c91`: 8 breaking, 4 info
  - the response property `allOf[subschema #2]/data` became nullable for the status `200`
  - the response property `allOf[subschema #2]/data` became nullable for the status `400`
  - the response property `allOf[subschema #2]/data` became nullable for the status `401`
  - the response property `allOf[subschema #2]/data` became nullable for the status `404`
  - …8 more
- **2024-03-26** (v3) `28d285e4302c`: 4 warning, 1 info
  - removed the optional property `allOf[#/components/schemas/util.ServerResponse]/data` from the response with the `200` status
  - removed the optional property `allOf[#/components/schemas/util.ServerResponse]/data` from the response with the `400` status
  - removed the optional property `allOf[#/components/schemas/util.ServerResponse]/data` from the response with the `401` status
  - removed the optional property `allOf[#/components/schemas/util.ServerResponse]/data` from the response with the `404` status
  - …1 more
- **2023-04-21** (v3) `196c93bf2075`: 1 info
  - endpoint added

[Operation history](https://skmtc.dev/getconvoy/apis/convoy-api-reference/changes/v1/projects/:projectID/portal-links/:portalLinkID/revoke/put.md)

---

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