Skip to main

API Technical Specs

Learn how to configure and leverage our services to achieve your toughest recruiting needs.
SaaS     |

Create a Skills List

POST /v9/skills

Upload a custom data list to be optionally used during parsing.

This feature is not recommended and only available in special cases. Reach out to support@sovren.com for more information.

Notes

Request Body

Namerequiredstring
A name for the data being uploaded. Names must consist of only letters, digits, and ASCII hyphens. If the combination of Name and Culture already exists, it is overwritten.
Culturerequiredstring
The culture or language of the data, formatted as an ISO 639-1 two letter language code.
Contentrequiredstring[]
The Content of data being uploaded. Pass Taxonomy SDF in the first array element and Skills SDF in the second array element.

Sample Request

{ ... 
"Name" :  "","Culture" :  "",[ ... 
""
]
}

Response Body

Infoobject
Information explaining the outcome of the transaction.
Info.Codestring
A response code elaborating on the HTTP status code.
The following is a list of codes that can be returned by the service:

Success – Successful transaction

MissingParameter - A required parameter wasn't provided

InvalidParameter - A parameter was incorrectly specified

AuthenticationError - An error occurred with the credentials provided
Info.Messagestring
This message further describes the code providing additional detail.
Valueobject
Contains response data for the transaction.
Value.Keystring
The unique Key for the data list.
Value.Namestring
The Name of the data list.

Sample Response

{ ... 
{ ... 
"Code" :  "string","Message" :  "string"
},
{ ... 
"Key" :  "","Name" :  ""
}
}