v1

latestOpenAPI 3.0.12026-07-243124341009.5 KB

Companies

Add Restrictions for a Company

Adds talent as 'do not place' for a company.

post/v1/company-restrictions

Headers

RequestIdstring uuid

The unique request identifier used to correlate request data with log entries and events, formatted as a UUID.

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

dnaIDinteger

The identifier for the restriction.

companyIDinteger

The identifier for the company.

branchIDsinteger[]

The identifiers for the departments the restriction applies to.

talentIDinteger

The identifier for the talent.

restrictedByUserIDinteger

The identifier for the user who added the restriction.

dnaDatestring date-time

The date when restriction was added. 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.

dnaNotesstring

The notes for the restriction.

Example request

{
  "dnaID": 123,
  "companyID": 456,
  "branchIDs": [
    789,
    101112
  ],
  "talentID": 18394,
  "restrictedByUserID": 12345,
  "dnaNotes": "This is a sample note."
}

Response

The created company restriction.

idinteger

The identifier for the company restriction.

companyIdinteger

The identifier for the company the restriction applies to.

branchIdsstring

The string representation of the array of identifiers for the departments the restriction applies to.

talentNamestring

The name of the talent who has been restricted from placement.

notesstring

Notes on the restriction.

userIdinteger

The identifier for the user who has added the restriction.

userNamestring

The name of the user who has added a restriction.

companyNamestring

The name of the company the restriction applies to.

talentIdinteger

The identifier for the talent who is blocked from placement at the selected company or office.

restrictionDatestring date-time

The date when the restriction has been added. 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.

Example response

{
  "id": 123456,
  "companyId": 284997,
  "branchIds": "[1835, 1383, 1922]",
  "talentName": "John Doe",
  "notes": "This talent is not eligible for placement due to previous performance issues.",
  "userId": 12345,
  "userName": "Jane Smith",
  "companyName": "Acme Corp",
  "talentId": 123456
}