--- title: "Add a Talent Certificate" method: POST path: "/v1/talent/{talentId}/certificate" tags: ["Talent"] --- # Add a Talent Certificate `POST /v1/talent/{talentId}/certificate` ## Request - Base URL: `https://api.avionte.com/front-office` - URL: `https://api.avionte.com/front-office/v1/talent/{talentId}/certificate` - Auth: one of: - API key in header `x-api-key` - HTTP bearer Creates a new talent certificate record in the *Certifications* tab. ## Path parameters - `talentId` 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 - TalentCertificateDto - `certificateId` integer: The identifier for the certificate definition to associate with the talent. If omitted or 0, the certificate definition is looked up by **certificateName**. - `categoryId` integer: The identifier for the certificate category. If omitted, the category is inherited from the certificate definition. - `certificateName` string, required: The name of the certificate. Used to look up the certificate definition when **certificateId** is not provided. - `certificateNumber` string: The official number or reference assigned to the certificate. - `certificateAuthorityId` integer: The identifier for the authority that issued the certificate. - `issueDate` string, date-time: The date the certificate 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. Must be on or after **issueDate** when both are provided. 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. - `documents` TalentCertificateDocumentLink[]: A list of document references to associate with the certificate. Each document URL must begin with `https://` and end with `.pdf`, `.docx`, `.jpg`, or `.png`. - `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). ## Response `200` The newly created 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)