Decline an Invitation
Decline an invitation addressed to you. This closes the pending invitation without joining the account; the account admin sees it move out of the pending state. You can decline an invite you don't want instead of leaving it to expire.
The invitation must be addressed to your email and still pending. Find the invitation uuid via GET /v1/user/invitations.
Path parameters
uuid string (uuid) Req
The
uuid of the invitation to decline, as returned by GET /v1/user/invitations.Deprecated: the legacy integer id is still accepted in the path until the sunset, answered with Deprecation and Sunset headers. Use the uuid.
Request body
None — pass {} or omit the body entirely.
Response (200 OK)
success bool
true when the invitation has been declined.Errors
400 Bad Request
An integer id after the sunset (
integer_id_unsupported).401 Unauthorized
Missing or invalid auth.
404 Not Found
No such invitation, or it isn't addressed to your email.
409 Conflict
The invitation is no longer pending (already accepted, declined, revoked, or expired).
Request
curl -X POST "https://api.ngris.com/v1/user/invitations/019a89b0-bb2b-76eb-8f22-cf9745345430/decline" \
-H "X-API-KEY: <your_api_key>" \
-H "Content-Type: application/json"
Python
from ngris import Ngris
client = Ngris(api_key="<your_api_key>")
client._post_void("/user/invitations/019a89b0-bb2b-76eb-8f22-cf9745345430/decline")
Response — 200 OK
{
"success": true
}
Was this helpful?