---
title: "Update a Talent Certificate"
method: PATCH
path: "/v1/talent/certificate/{certificateId}"
tags: ["Talent"]
---

# Update a Talent Certificate

`PATCH /v1/talent/certificate/{certificateId}`

## Request

- Base URL: `https://api.avionte.com/front-office`
- URL: `https://api.avionte.com/front-office/v1/talent/certificate/{certificateId}`
- Auth: one of:
  - API key in header `x-api-key`
  - HTTP bearer

Updates one or more settings for a talent certificate.

## Path parameters

- `certificateId` string, required

## Headers

- `RequestId` string, uuid: Unique request identifier in UUID format used to correlate request data to log entries and events.
- `FrontOfficeTenantId` integer
- `Tenant` string

## Request body

- Operation[]
  - `path` string: A JSON Pointer indicating the location in the document to apply the operation.
  - `op` string: Specifies the type of operation (e.g., add, remove, replace, move, copy, and test).
  - `from` string: The source path for move and copy operations.
  - `value` object: The value to be added, replaced, or tested (required for add, replace, and test operations).

## Response `200`

The updated talent certificate.

- TalentCertificate
  - `id` integer: The unique identifier for the talent certificate instance. Matches the *certificateId* provided in the request path.
  - `certificateId` integer: The identifier for the certificate definition associated with the talent certificate.
  - `categoryId` integer: The identifier for the certificate category.
  - `applicantId` integer: The identifier for the talent who holds the certificate.
  - `issueDate` string, date-time: The date the certficate was issued. The field follows the YYYY-MM-DDTHH:mm:ss format, for example, 2024-12-01T14:30:00 or 2024-12-01T00:00:00.
  - `expirationDate` string, date-time: The date the certificate is set to expire. The field follows the YYYY-MM-DDTHH:mm:ss format, for example, 2024-12-01T14:30:00 or 2024-12-01T00:00:00.
  - `notes` string: Additional notes related to the talent certificate.
  - `validated` boolean: An indication of whether the certificate has been validated or not.
  - `validatedDate` string, date-time: The date and time the certificate was validated. The field follows the YYYY-MM-DD or YYYY-MM-DDTHH:mm:ss formats and also supports fractional seconds, such as YYYY-MM-DDTHH:mm:ss.sss. For example, 2024-12-01, 2024-12-01T14:30:00, and 2024-12-01T14:30:00.546.
  - `validatedBy` integer: The identifier for the user that has validated the certificate of the talent.
  - `archived` boolean: An indication of whether the certificate is archived or not.
  - `archiveDate` string, date-time: The date the certificate was set to archived. The field follows the YYYY-MM-DD or YYYY-MM-DDTHH:mm:ss formats and also supports fractional seconds, such as YYYY-MM-DDTHH:mm:ss.sss. For example, 2024-12-01, 2024-12-01T14:30:00, and 2024-12-01T14:30:00.546.
  - `certificateNumber` string: The official number or reference assigned to the certificate.
  - `certificateName` string: The name of the certificate.
  - `categoryName` string: The name of the category the certificate belongs to.
  - `talentFirstName` string: The first name of the talent the certificate was issued to.
  - `talentLastName` string: The last name of the talent the certificate was issued to.
  - `certificateAuthorityId` integer: The identifier for the authority that issued the certificate.
  - `certificateAuthorityName` string: The name of the authority that issued the certificate.
  - `documents` TalentCertificateDocumentLink[]: A list of document references associated with the certificate.
    - `document` string, required: The URL of the document to associate with the talent certificate. Must begin with `https://` and end with one of the supported extensions: `.pdf`, `.docx`, `.jpg`, or `.png`.
    - `documentExpirationDateUtc` string, date-time: The expiration date and UTC time of the document. UTC timestamp in ISO 8601 format (e.g., 2025-06-09T14:30:00Z).

## Other responses

- `400`: Bad Request
- `401`: Unauthorized
- `403`: Access Denied
- `404`: Not found
- `405`: Unsupported method
- `406`: Unsupported format(s) indicated by Accept header
- `415`: Unsupported format(s) indicated by the Content-Type header
- `429`: Too many requests
- `500`: An unexpected error occurred
- `502`: Service Unavailable
- `504`: Gateway Timeout

---

[API](https://skmtc.dev/avionte/apis/bold-front-office-api.md) - [All operations](https://skmtc.dev/avionte/apis/bold-front-office-api/llms.txt) - [OpenAPI document](https://skmtc.dev/avionte/apis/bold-front-office-api/revisions/bd5996cbaa0f?raw)