AVavionte
Talent

Remove Citizenship

Permanently deletes the specified citizenship tag or custom tag for the specified talent record from their profile.

delete/v1/talent/{talentId}/citizenship

Request

  • Base URL
    https://api.avionte.com/front-office
  • URL
    https://api.avionte.com/front-office/v1/talent/{talentId}/citizenship
  • Auth
    • API key in header x-api-key
    • or HTTP bearer

Path parameters

talentIdstring required

The identifier for the talent record for which the Citizenship tag should be removed.

Query parameters

itemIdstring required

The identifier for the Citizenship tag being removed.

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.

Response

The citizenship tag that was removed.

idinteger

The identifier for the Citizenship Tag.

talentIdinteger required

The identifier for the talent.

citizenshipIdinteger

The identifier for the Citizenship option.

citizenshipNamestring required

The name of the Citizenship option.

expirationDatestring date-time

The expiration date of the Citizenship Tag. The field follows the YYYY-MM-DD or YYYY-MM-DDTHH:mm:ss formats, for example, 2024-12-01 or 2024-12-01T14:30:00.

Example response

{
  "id": 1837,
  "talentId": 16745,
  "citizenshipId": 843,
  "citizenshipName": "Citizen"
}

Changes

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