---
title: "Update a Specific User Award"
method: PATCH
path: "/api/v2/awards/{id}"
tags: ["Awards"]
---

# Update a Specific User Award

`PATCH /api/v2/awards/{id}`

This endpoint updates the supplied fields for a specific award. <h3>Required Scope</h3>`awards:write`

## Path parameters

- `id` string, required

## Request body

- AwardsIdBody
  - `data` Apiv2awardsidData, required
    - `type` string — The type of the resource.
    - `id` string — Unique identifier for the award (for updates).
    - `attributes` Apiv2awardsidDataAttributes
      - `title` string — The title of the award. A maximum of 255 characters is allowed.
      - `awarded-at` string, date-time — The date and time when the award was given.
      - `image-url` string — The URL or path to an image representing the award. A maximum of 2000 characters is allowed.
      - `url` string, uri — A URL for more information about the award. A maximum of 2000 characters is allowed.
      - `issued-by` string — The organization or individual that issued the award. A maximum of 2000 characters is allowed.

## Response `201`

Success

- InlineResponse20113
  - `data` InlineResponse20113Data
    - `type` string — The type of resource.
    - `id` string — The unique identifier for the award.
    - `attributes` InlineResponse20113DataAttributes
      - `created-at` string, date-time — The date and time when the award was created.
      - `title` string — The title of the award.
      - `awarded-at` string, date-time — The date and time when the award was given.
      - `image-url` string, nullable — The URL or path to an image representing the award.
      - `url` string, uri, nullable — A URL for more information about the award.
      - `issued-by` string — The individual or organization that issued the award.
    - `links` InlineResponse20113DataLinks
      - `self` string, uri — The URL to access the specific award resource.
    - `relationships` InlineResponse20113DataRelationships[]
      - `user` InlineResponse20113DataUser
        - `data` InlineResponse20113DataUserData
          - `id` string — The ID of the user related to the award.
          - `type` string — The type of resource, which is "users" for this relationship.

---

[API](https://skmtc.net/degreed/apis/degreed-api-web.md) · [All operations](https://skmtc.net/degreed/apis/degreed-api-web/llms.txt) · [OpenAPI document](https://skmtc-service-staging.skmtc.workers.dev/v1/apis/degreed/degreed-api-web/revisions/4a22b709515c/schema)