Talent

Add Talent Referrals

Adds talent referrals by the specified talent and/or for the specified talent.

post/v1/talent/{talentId}/talent-referrals

Request

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

Path parameters

talentIdstring required

The identifier for the talent for whom the referral is being added.

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

talentIdinteger required

The identifier for the talent.

Example request

{
  "talentId": 18394,
  "referredBy": [
    {
      "referralId": 2842,
      "referredById": 167395,
      "referredByName": "Jane Doe",
      "referredByEntityType": "Talent"
    }
  ],
  "referrerOf": [
    {
      "referralId": 1894,
      "referrerOfId": 138952,
      "referrerOfName": "Jane Doe",
      "referrerOfEntityType": "Talent"
    }
  ]
}

Response

The response containing the added talent referrals.

errorsstring[]

A list of error messages after an attempt to add one or more talent referrals.

Example response

{
  "referrals": {
    "talentId": 18394,
    "referredBy": [
      {
        "referralId": 2842,
        "referredById": 167395,
        "referredByName": "Jane Doe",
        "referredByEntityType": "Talent"
      }
    ],
    "referrerOf": [
      {
        "referralId": 1894,
        "referrerOfId": 138952,
        "referrerOfName": "Jane Doe",
        "referrerOfEntityType": "Talent"
      }
    ]
  }
}

Changes

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