Skip to main content
POST
/
v1
/
awards
Create Award
curl --request POST \
  --url https://api.mokaru.ai/v1/awards \
  --header 'Authorization: Bearer <token>' \
  --header 'Content-Type: application/json' \
  --data '
{
  "name": "<string>",
  "organisation": "<string>",
  "description": "<string>",
  "date": "<string>"
}
'
{
  "success": true,
  "id": "<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 award or honor to the authenticated user’s profile. Common use cases:
  • AI agent profile building - automatically add awards extracted from a resume or LinkedIn.
  • Career tracking - log a new award when received.
  • Bulk import - add multiple honors from a spreadsheet.
Scope required: awards:write | Rate limit: 20 requests/min

​
Request

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

​
Body Parameters

​
name
string
required
Award name (max 200 characters)
​
organisation
string
Issuing organisation (max 200 characters)
​
description
string
Free-text description
​
date
string
ISO 8601 date string when the award was received (e.g. “2024-12-01”)

​
Response

{
  "success": true,
  "id": "clx..."
}
​
success
boolean
Always true on successful creation
​
id
string
The created award id