Skip to main content

Regenerate Certificate

Refresh the student name printed on one issued certificate from the student's current account name. The request has no body. issued_at does not change, and this is not a draft write.

Request​

POST /players/{playerId}/analytics/certificates/{id}/regenerate

Path Parameters​

ParameterTypeRequiredDescription
playerIdstringYesCourse UUID. See Identifiers.
idstringYesCertificate id from List Certificates. It must belong to this course.

Example Request​

curl -X POST "https://app.easy.tools/api/v1/players/8f3c1a62-d047-4e89-9b25-1c6a4d8e0f71/analytics/certificates/V1StGXR8_Z5jdHi6B-myT/regenerate" \
  -H "Authorization: Bearer YOUR_API_TOKEN" \
  -H "Accept: application/json"

Response​

Success Response (200)​

{
  "data": {
    "id": "V1StGXR8_Z5jdHi6B-myT",
    "full_name": "John A. Smith",
    "issued_at": "2026-05-02T16:30:00.000Z",
    "public_url": "https://app.easy.tools/players/course-intro/certificates/V1StGXR8_Z5jdHi6B-myT"
  }
}

Response Fields​

data is the certificate after the refresh, with the fields described in Certificate Object. full_name may be empty when the student's account has no name.

Error Responses​

Not Found Error (404)​

Returned when the course is unknown, or the certificate id does not belong to this course. See Identifiers.

{
  "error": {
    "code": "RESOURCE_NOT_FOUND",
    "message": "Resource not found"
  }
}

Validation Error (422 Unprocessable Entity)​

Returned when the student no longer exists or the name cannot be read. The certificate is not changed.

{
  "error": {
    "code": "VALIDATION_ERROR",
    "message": "The student name cannot be refreshed"
  }
}

Service Unavailable Error (503)​

Returned when the name cannot be looked up right now. The certificate is not changed. Retry later.

{
  "error": {
    "code": "SERVICE_UNAVAILABLE",
    "message": "The name service is unavailable"
  }
}

Authentication, permission, and rate-limit errors are described in Authorization.