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

# Update Certificate

> Update an existing certificate

## Overview

Update an existing certificate. Only provided fields are modified. Pass `null` to clear an optional field.

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

## Request

```bash theme={null}
PATCH /v1/certificates/clx...
Content-Type: application/json
```

### Path Parameters

<ParamField path="id" type="string" required>
  Certificate id
</ParamField>

### Body Parameters

All fields are optional. Omit a field to leave it unchanged, set to `null` to clear it.

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

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

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

<ParamField body="issueDate" type="string">
  ISO 8601 date string (nullable)
</ParamField>

<ParamField body="expiryDate" type="string">
  ISO 8601 date string (nullable)
</ParamField>

<ParamField body="credentialId" type="string">
  Credential ID (max 200, nullable)
</ParamField>

<ParamField body="verificationUrl" type="string">
  Verification URL (max 500, nullable)
</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..."
}
```