Certification Guide

The certification workflow verifies that your tenant’s BYOK credentials and infrastructure are production-ready.

Prerequisites

Before running certification:

1. BYOK credential must be uploaded and validated (see BYOK Setup)
2. Integration auth config must be active
3. Integration connectivity must be verified
4. Integration must be active
5. No other certification may be currently running

Running Certification

INTEGRATION_ID="your-integration-id"
 
curl -X POST "$GOTAMIL_API/v1/admin/integrations/$INTEGRATION_ID/certifications" \
  -H "Authorization: Bearer $TOKEN" \
  -H "Content-Type: application/json" \
  -H "Idempotency-Key: $(uuidgen)" \
  -d '{ "mode": "full" }'

Certification always returns 202 (async). Poll the operation to track progress.

Modes

Test Content

The certification runs with standard test inputs:

• Proofread: "இது சரிபார்ப்பு சான்றிதழ் சோதனை உரை."
• Essay critique: "தமிழ் கல்வி மாணவர்களின் மொழித் திறனை மேம்படுத்துகிறது..."

Polling for Results

OPERATION_ID="op-uuid-from-202-response"
 
curl "$GOTAMIL_API/v1/admin/operations/$OPERATION_ID" \
  -H "Authorization: Bearer $TOKEN"

After Certification

On success, your onboarding state transitions to go_live_ready. You can verify this:

curl "$GOTAMIL_API/v1/admin/onboarding/status" \
  -H "Authorization: Bearer $TOKEN"

The certification summary in the response will show passed: true and the last_run_operation_id.

Troubleshooting