---
title: "Update an Evidence Item"
method: PUT
path: "/v1/credentials/{credential_id}/evidence_items/{evidence_item_id}"
tags: ["Evidence Items"]
---

# Update an Evidence Item

`PUT /v1/credentials/{credential_id}/evidence_items/{evidence_item_id}`

## Request

- Base URL: `https://api.accredible.com`
- URL: `https://api.accredible.com/v1/credentials/{credential_id}/evidence_items/{evidence_item_id}`
- Auth: API key in header `Authorization`

## Path parameters

- `credential_id` string, required
- `evidence_item_id` number, required

## Request body

- object
  - `evidence_item` object
    - `description` string, required: Title text for the evidence item. This is displayed on a Credential.
    - `category` 'file' | 'url' | 'video' | 'grade' | 'transcript', required: Type of Evidence Item added, must be one of [file, url, video, grade, transcript]. The type dictates how the item is displayed on the Credential.
    - `url` string: If the category is url or video, this should be the URL of Evidence Item.
    - `file` string: If the category is file, this should be the file's URL.
    - `string_object` string: If the category is grade or transcript then use it. For grade it will be just string 83.
    - `preview` string: By default if you add a URL category EvidenceItem, we take a screenshot to set the preview of this URL on Credentials. You can overwrite this default behaviour by setting this preview field to be the URL of the desired image.
    - `position` number: The numeric position of the evidence item on the credential. 0 is displayed first in the list.
    - `custom_insight` string: The insights which will appear below Evidence Item, if not given it will be generated automatically based on data.

## Response `200`

OK

- object
  - `evidence_item` object
    - `id` number
    - `description` string
    - `link_url` string
    - `preview_image_url` string
    - `type` string
    - `supplemental` boolean
    - `string_object` unknown
    - `position` number

## Changes

- **2025-09-08** `cac96b8772c3`: 1 info
  - endpoint added
- **2025-07-08** `a93800de3a85`: 1 breaking
  - api path removed without deprecation
- **2025-07-08** `98201e8dd1b4`: 1 warning, 1 info
  - deleted the `header` request parameter `Authorization`
  - the endpoint scheme security `ApiKeyAuth` was added to the API

[Operation history](https://skmtc.dev/accredible/apis/accredible-credential-api/changes/v1/credentials/:credential_id/evidence_items/:evidence_item_id/put.md)

---

[API](https://skmtc.dev/accredible/apis/accredible-credential-api.md) - [All operations](https://skmtc.dev/accredible/apis/accredible-credential-api/llms.txt) - [OpenAPI document](https://skmtc.dev/accredible/apis/accredible-credential-api/revisions/dfd510ea66d5?raw)