AVavionte
Talent

Add a Talent Certificate

Creates a new talent certificate record in the Certifications tab.

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
    • API key in header x-api-key
    • or HTTP bearer

Path parameters

talentIdstring required

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

Headers

RequestIdstring uuid

Unique request identifier in UUID format used to correlate request data to log entries and events.

Example:63680b86-c7e0-4a36-ae4a-d0d481089aff

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

FrontOfficeTenantIdinteger

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

Tenantstring

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

Request body

certificateIdinteger

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

categoryIdinteger

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

certificateNamestring required

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

certificateNumberstring

The official number or reference assigned to the certificate.

certificateAuthorityIdinteger

The identifier for the authority that issued the certificate.

issueDatestring 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.

expirationDatestring 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.

notesstring

Additional notes related to the talent certificate.

validatedboolean

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

validatedDatestring 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.

validatedByinteger

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

Example request

{
  "certificateId": 392,
  "categoryId": 58,
  "certificateName": "Tetanus vaccination",
  "certificateNumber": "A25623",
  "certificateAuthorityId": 350,
  "notes": "Waiting for validation.",
  "validated": true,
  "validatedBy": 13483,
  "documents": [
    {
      "document": "https://example.com/documents/Tetanus%20vaccination.pdf"
    }
  ]
}

Response

The newly created talent certificate.

idinteger

The unique identifier for the talent certificate instance. Matches the certificateId provided in the request path.

certificateIdinteger

The identifier for the certificate definition associated with the talent certificate.

categoryIdinteger

The identifier for the certificate category.

applicantIdinteger

The identifier for the talent who holds the certificate.

issueDatestring 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.

expirationDatestring 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.

notesstring

Additional notes related to the talent certificate.

validatedboolean

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

validatedDatestring 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.

validatedByinteger

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

archivedboolean

An indication of whether the certificate is archived or not.

archiveDatestring 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.

certificateNumberstring

The official number or reference assigned to the certificate.

certificateNamestring

The name of the certificate.

categoryNamestring

The name of the category the certificate belongs to.

talentFirstNamestring

The first name of the talent the certificate was issued to.

talentLastNamestring

The last name of the talent the certificate was issued to.

certificateAuthorityIdinteger

The identifier for the authority that issued the certificate.

certificateAuthorityNamestring

The name of the authority that issued the certificate.

Example response

{
  "id": 52910,
  "certificateId": 392,
  "categoryId": 58,
  "applicantId": 18499,
  "notes": "Waiting for validation.",
  "validated": true,
  "validatedBy": 13483,
  "certificateNumber": "A25623",
  "certificateName": "Tetanus vaccination",
  "categoryName": "Vaccinations",
  "talentFirstName": "John",
  "talentLastName": "Doe",
  "certificateAuthorityId": 350,
  "certificateAuthorityName": "America - MN",
  "documents": [
    {
      "document": "https://example.com/documents/Tetanus%20vaccination.pdf"
    }
  ]
}

Changes

No recorded changes to this operation across all 1 revision of this API.