Skip to main content
POST
/
v1
/
certificates
Create Certificate
curl --request POST \
  --url https://api.mokaru.ai/v1/certificates \
  --header 'Authorization: Bearer <token>' \
  --header 'Content-Type: application/json' \
  --data '
{
  "name": "<string>",
  "issuer": "<string>",
  "description": "<string>",
  "issueDate": "<string>",
  "expiryDate": "<string>",
  "credentialId": "<string>",
  "verificationUrl": "<string>"
}
'

Documentation Index

Fetch the complete documentation index at: https://docs.mokaru.ai/llms.txt

Use this file to discover all available pages before exploring further.

​
Overview

Add a new certificate or credential to the authenticated user’s profile. Common use cases:
  • AI agent profile building - extract certifications from a LinkedIn export.
  • Career tracking - log a freshly earned certificate.
  • Verification - link to the issuing authority’s verification page.
Scope required: certificates:write | Rate limit: 20 requests/min

​
Request

POST /v1/certificates
Content-Type: application/json

​
Body Parameters

​
name
string
required
Certificate name (max 200 characters)
​
issuer
string
required
Issuing organisation (max 200 characters)
​
description
string
Free-text description
​
issueDate
string
ISO 8601 date string when the certificate was issued
​
expiryDate
string
ISO 8601 date string when the certificate expires (omit if no expiry)
​
credentialId
string
Credential ID from the issuer (max 200 characters)
​
verificationUrl
string
URL to verify the certificate (max 500 characters)

​
Response

{
  "success": true,
  "id": "clx..."
}