Skip to main content
POST
https://api.thehyperstack.com
/
v1
/
group
/
update
/
{group_key}
Update Credential Group
curl --request POST \
  --url https://api.thehyperstack.com/v1/group/update/{group_key} \
  --header 'Content-Type: application/json' \
  --data '
{
  "title": "<string>",
  "description": "<string>",
  "certificate_template": "<string>",
  "badge_template": "<string>",
  "url": "<string>",
  "tags": {},
  "group_code": "<string>",
  "does_expire": true,
  "validity": 123,
  "blockchain": true
}
'
{
  "success": true
}

Description

This endpoint allows you to update an existing credential group in Hyperstack. The group key is passed as a URL path parameter. Only the fields provided in the request body will be updated.

Headers

Authorization
string
required
Bearer YOUR_API_TOKEN — obtainable from Hyperstack Dashboard → Settings → API Access

Path Parameters

group_key
string
required
Unique key of the credential group to update.

Body Parameters

title
string
required
Updated title of the credential group.
description
string
required
Updated description of the credential group.
certificate_template
string
required
New certificate template key.
badge_template
string
required
New badge template key.
url
string
required
Updated external URL associated with the credential group.
tags
array[string]
required
Updated tags for the credential group.
group_code
string
required
Updated human-readable code for the group. Alphanumeric, hyphens, and spaces only.
does_expire
boolean
required
Indicates whether credentials in this group expire.
validity
number
required
Validity period (in years) if does_expire is true.
blockchain
boolean
required
Enable/disable decentralized blockchain anchoring for credentials.

Success Response Fields

success
boolean
Indicates whether the group update was successful. Always true for a 200 response.

Responses

{
  "success": true
}

curl -X POST "https://api.thehyperstack.com/v1/group/update/unique_group_id_12345" \
  -H "Authorization: Bearer YOUR_API_TOKEN" \
  -H "Content-Type: application/json" \
  -d '{
    "title": "Updated Course Certificate",
    "description": "Updated course description",
    "tags": ["updated", "certificate"],
    "does_expire": true,
    "validity": 2
  }'
Last modified on February 22, 2026