Add a Talent Certificate

Creates a new talent certificate record in the Certifications tab.

Path Params
string
required

The talent's identifier for whom the certificate will be created.

Body Params
int32

The identifier for the certificate definition to associate with the talent. If omitted or 0, the certificate definition is looked up by certificateName.

int32

The identifier for the certificate category. If omitted, the category is inherited from the certificate definition.

string
required
length between 1 and 255

The name of the certificate. Used to look up the certificate definition when certificateId is not provided.

string
length ≤ 255

The official number or reference assigned to the certificate.

int32

The identifier for the authority that issued the certificate.

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.

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.

string

Additional notes related to the talent certificate.

boolean

An indication of whether the certificate has been validated or not.

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.

int32

The identifier for the user that has validated the certificate of the talent.

documents
array of objects

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.

documents
Headers
uuid

Unique request identifier (UUID) used to correlate request data with log entries and events.

integer

An integer identifier for the tenant that the request is being made for. Required when Tenant header is not provided.

string

Tenant company code that determines data access scope during the request. Required when FrontOfficeTenantId header is not provided.

Responses

401

Unauthorized

403

Access Denied

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

Language
Credentials
LoadingLoading…
Response
Click Try It! to start a request and see the response here! Or choose an example:
application/json