> ## 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.

# Create Award

> Add a new award or honor to your career profile

## Overview

Add a new award or honor to the authenticated user's base resume.

**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.

<Note>
  **Scope required:** `awards:write` | **Rate limit:** 20 requests/min
</Note>

## Request

```bash theme={null}
POST /v1/awards
Content-Type: application/json
```

### Body Parameters

<ParamField body="name" type="string" required>
  Award name (max 200 characters)
</ParamField>

<ParamField body="organisation" type="string">
  Issuing organisation (max 200 characters)
</ParamField>

<ParamField body="description" type="string">
  Free-text description
</ParamField>

<ParamField body="date" type="string">
  ISO 8601 date string when the award was received (e.g. "2024-12-01")
</ParamField>

### Query Parameters

<ParamField query="cvId" type="string">
  Target a specific resume by its id (from `list-resumes`). Omit to use your base/default resume; the resume must be self-contained.
</ParamField>

## Response

```json theme={null}
{
  "success": true,
  "id": "clx..."
}
```

<ResponseField name="success" type="boolean">
  Always true on successful creation
</ResponseField>

<ResponseField name="id" type="string">
  The created award id
</ResponseField>