humanity protocol
  • Introduction
    • Overview
    • How Humanity Protocol Works
    • Palm Scanner
  • Getting Started
    • Network Configuration
    • Important Links
  • Testnet Info
    • Onboarding Tutorial
    • Testnet Rewards
    • Testnet FAQ
  • Build on Humanity
    • API
      • Issue Credentials (VCs)
      • Verify Credentials (VCs)
      • Revoke Credentials (VCs)
      • List Client Credentials (VCs)
    • Contracts
      • VC contract
      • Rewards contract
    • Contract Integrations Guide
    • Examples
      • Fairdrops
      • Social Media VCs
  • Glossary
  • Community/Support
Powered by GitBook
On this page
  1. Build on Humanity
  2. API

Revoke Credentials (VCs)

PreviousVerify Credentials (VCs)NextList Client Credentials (VCs)

Last updated 3 months ago

Revoke a Verifiable Credential

post

Marks a Verifiable Credential as revoked, making it invalid for future verification.

Authorizations
Body
credentialIdstringRequired

The identifier of the Verifiable Credential to be revoked

Example: urn:uuid:6aaefd3d-e462-4bb0-bed7-454b967d5d37
Responses
200
Revocation successful
application/json
400
Invalid request
application/json
401
Unauthorized
application/json
post
POST /credentials/revoke HTTP/1.1
Host: issuer.humanity.org
X-API-Token: YOUR_API_KEY
Content-Type: application/json
Accept: */*
Content-Length: 64

{
  "credentialId": "urn:uuid:6aaefd3d-e462-4bb0-bed7-454b967d5d37"
}
{
  "status": "success",
  "message": "Credential successfully revoked"
}