---
title: "Update a Reference"
method: PUT
path: "/v1/credentials/{credential_id}/references/{reference_id}"
tags: ["References"]
---

# Update a Reference

`PUT /v1/credentials/{credential_id}/references/{reference_id}`

## Path parameters

- `credential_id` string, required
- `reference_id` number, required

## Request body

- object
  - `reference` object
    - `description` string, required — The reference comments / text.
    - `relationship` 'taught' | 'managed' | 'mentored' | 'worked' | 'studied' | 'friends' | 'stranger' | 'professor', required — Must be one of: "taught", "managed", "mentored", "worked", "studied", "friends", "stranger", "professor".
    - `position` number — The numeric position of the evidence item on the credential. 0 is displayed first in the list.

## Response `200`

OK

- object
  - `reference` object
    - `id` number
    - `description` string
    - `referee` object
      - `name` string
      - `email` string
      - `avatar` string
    - `supplemental` boolean
    - `relationship` string

---

[API](https://skmtc.net/accredible/apis/accredible-credential-api.md) · [All operations](https://skmtc.net/accredible/apis/accredible-credential-api/llms.txt) · [OpenAPI document](https://skmtc-service-staging.skmtc.workers.dev/v1/apis/accredible/accredible-credential-api/revisions/56b317c13686/schema)