# Achievements

## Create an achievement

<mark style="color:green;">`POST`</mark> `/v1/games/:game_id/achievements`

#### Request Body

| Name                        | Type   | Description |
| --------------------------- | ------ | ----------- |
| custom\_id                  | string |             |
| name                        | string |             |
| description                 | string |             |
| is\_secret                  | string |             |
| points                      | string |             |
| custom\_criteria\_group\_id | string |             |
| custom\_data                | string |             |

{% tabs %}
{% tab title="200 " %}

```
```

{% endtab %}
{% endtabs %}

## Retrieve an achievement

<mark style="color:blue;">`GET`</mark> `/v1/games/:game_id/achievements/:id`

#### Path Parameters

| Name | Type   | Description |
| ---- | ------ | ----------- |
|      | string |             |

{% tabs %}
{% tab title="200 " %}

```
```

{% endtab %}
{% endtabs %}

## Update an achievement

<mark style="color:orange;">`PUT`</mark> `/v1/games/:game_id/achievements/:id`

#### Path Parameters

| Name | Type   | Description |
| ---- | ------ | ----------- |
|      | string |             |

{% tabs %}
{% tab title="200 " %}

```
```

{% endtab %}
{% endtabs %}

## Delete an achievement

<mark style="color:red;">`DELETE`</mark> `/v1/games/:game_id/achievements/:id`

#### Path Parameters

| Name | Type   | Description |
| ---- | ------ | ----------- |
|      | string |             |

{% tabs %}
{% tab title="200 " %}

```
```

{% endtab %}
{% endtabs %}

## List all achievements

<mark style="color:blue;">`GET`</mark> `/v1/games/:game_id/achievements`

#### Path Parameters

| Name | Type   | Description |
| ---- | ------ | ----------- |
|      | string |             |

{% tabs %}
{% tab title="200 " %}

```
```

{% endtab %}
{% endtabs %}