Links

Delete invite by id

Deletes an invite from the server.
Requires the create-invite-links permission.
URL
Requires Auth
HTTP Method
api/v1/removeInvite/:_id
YES
DELETE

Headers

Argument
Example
Required
Description
X-User-Id
myuser-name
Required
Your username hash (returned after you log in through the API)
X-Auth-Token
myauth-token
Required
Your token (returned after you log in through the API)

Payload

Argument
Example
Required
Description
_id
'kDKQ3H'
Required
The id of the invite to be deleted.

Example Call

curl --location --request DELETE 'http://localhost:3000/api/v1/removeInvite/:_id\
--header 'X-Auth-Token: myauth-token' \
--header 'X-User-Id: myuser-name'
-d "customUserStatusId=EscbQinc8jmeXbpt7"

Result

Success

{
"success": true
}

Errors

Any of the following errors can occur upon the endpoint.
  • Authorization: Requires an authentication token for the request to be made.
  • Invalid Invitation Id: Requires a valid invitation _id
Authorization
Invalid Invitation Id
{
"success": false,
"error": "unauthorized"
}
{
"success": false,
"error": "Invalid Invitation _id [invalid-invitation-id]",
"errorType": "invalid-invitation-id",
"details": {
"method": "removeInvite"
}
}
Last modified 1yr ago
Deprecation for cloud services and apps is now extended to November 20, 2023. Rocket.Chat versions receive support for six months after release.