> For the complete documentation index, see [llms.txt](https://docs.drivequant.com/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://docs.drivequant.com/backend/driver/add-or-update-a-metadata.md).

# Add or update a metadata

This service allows you to add or update custom metadata to a user, such as driving indicators that have been calculated in your backend.

You can add as many metadata as you need in a key-value format.

Metadata can be synchronized in the mobile application and displayed to the user.

{% hint style="info" %}
If you have your **admin API key**, you can try the API via this [**link**](https://drivequant.stoplight.io/docs/drivequant-public/859e608696efa-add-or-update-metadata-to-a-driver).
{% endhint %}

{% openapi src="/files/vFAk3JguKVX7puZ4T9le" path="/drivekit/admin/drivers/{userId}/metadata" method="put" %}
[driver-metadata.yaml](https://2525923625-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F-LXYIG5U3AO65YYFWJRK%2Fuploads%2FiJLlphV8KgW8vXmxhU6z%2Fdriver-metadata.yaml?alt=media\&token=c9240eba-618e-4020-9848-61e2dac658c4)
{% endopenapi %}

## Use case: custom scores

Custom scores can be calculated over a specific period of time (policy year, calendar year, 12 months rolling period...) using the individual scores of the trips made during this period, or using timelines.

If a customer has calculated one (or more) custom score(s) for a driver, this service can be used to attach this metadata to the driver. These scores can then be displayed to the user in the mobile app, and can be linked to a reward or a discount on an insurance premium.

Scores can be added one at a time or, more effectively, all at once:

{% tabs %}
{% tab title="Adding one score" %}

<pre class="language-json" data-title="JSON body (request)"><code class="lang-json">{
<strong>   "metaData" : {
</strong>     "annualSafetyScore" : "8.9"
   }
}
</code></pre>

{% endtab %}

{% tab title="Adding several scores" %}

<pre class="language-json" data-title="JSON body (request)"><code class="lang-json">{
<strong>   "metaData" : {
</strong>      "annualSafetyScore" : "8.9",
      "annualDistractionScore" : "9.8"
      "monthlyCustomScore": "8.1"
   }
}
</code></pre>

{% endtab %}
{% endtabs %}

{% hint style="info" %}
Scores can also be updated using the same service, providing a new value for the same key. This can be used for the driver to have a regular update on his/her progress.

**Example:**

1. First, set the driver's score to 9.8:\
   `{"metaData":{"monthlyCustomScore": "9.8"}}`&#x20;
2. Then, set it to 8.7:\
   `{"metaData":{"monthlyCustomScore": "8.7"}}`&#x20;
   {% endhint %}