Index Multiple Jobs🔗︎

HTTP Verb	Path
POST	/v10/index/(indexId)/joborders

Adds multiple jobs to an index.

Info

You can try this endpoint out at our Swagger page ( US Data Center | EU Data Center | AU Data Center )
Skills Normalization must be included to index documents using V2 Skills Taxonomy. These algorithms ignore raw skills and only consider the normalized skill concepts for skills category scoring. This leads to improved scoring and ranking because normalization produces less false negatives than simple exact keyword matching.

Path Parameters🔗︎

Parameter	Data Type	Description
indexId	string	The id for the index where the documents should be added (case-insensitive).

Request Body🔗︎

Jobs 🔗︎ object[]

Jobs🔗︎

The list of jobs to index.

Jobs properties

DocumentId 🔗︎ string required

DocumentId🔗︎

The id of the current document. This is restricted to alphanumeric with dashes and underscores. All values will be converted to lower-case.

JobData 🔗︎ object required

JobData🔗︎

The parsed JobData from the Textkernel Job Parser. See Parse a Job

UserDefinedTags 🔗︎ string[]

UserDefinedTags🔗︎

The user-defined tags you want the current document to have.

Sample JSON

{
  "Jobs": [
    {
      "DocumentId": "",
      "JobData": "...",
      "UserDefinedTags": [
        ""
      ]
    }
  ]
}

Response Body🔗︎

Info 🔗︎ object

Info🔗︎

Information explaining the outcome of the transaction.

Info properties

Code 🔗︎ string

Code🔗︎

Code	Description
`Success`	Successful transaction
`SomeErrors`	Some items in the bulk request failed
`MissingParameter`	A required parameter wasn't provided
`InvalidParameter`	A parameter was incorrectly specified
`AuthenticationError`	An error occurred with the credentials provided
`Unauthorized`	Your account doesn't have permission to perform this operation
`DataNotFound`	Data with the specified name wasn't found
`ConstraintError`	Data in the request is not allowed with the specific action being requested.

Message 🔗︎ string

Message🔗︎

This message further describes the code providing additional detail.

TransactionId 🔗︎ string

TransactionId🔗︎

The (GUID) id for a specific API transaction. Use this when contacting support@textkernel.com about issues.

EngineVersion 🔗︎ string

EngineVersion🔗︎

The version of the parsing/matching engine running under-the-hood.

ApiVersion 🔗︎ string

ApiVersion🔗︎

The version of the API.

TotalElapsedMilliseconds 🔗︎ integer

TotalElapsedMilliseconds🔗︎

How long the transaction took on Textkernel's server, in milliseconds. If the transaction takes longer to complete on the client side, that extra duration is solely network latency.

TransactionCost 🔗︎ decimal

TransactionCost🔗︎

How many credits the transaction costs.How many credits the transaction costs.

CustomerDetails 🔗︎ object

CustomerDetails🔗︎

Information about the customer who made the API call.

CustomerDetails properties

AccountId 🔗︎ string

AccountId🔗︎

The AccountId for the account.

Name 🔗︎ string

Name🔗︎

The customer name on the account.

IPAddress 🔗︎ string

IPAddress🔗︎

The client IP Address where the API call originated.

Region 🔗︎ string

Region🔗︎

The region for the account, also known as the 'Data Center'.

CreditsRemaining 🔗︎ decimal

CreditsRemaining🔗︎

The number of credits remaining to be used by the account.

CreditsUsed 🔗︎ decimal

CreditsUsed🔗︎

The number of credits used by the account.

MaximumConcurrentRequests 🔗︎ integer

MaximumConcurrentRequests🔗︎

The number of requests that can be made at one time. If using sub-accounts, this is the maximum number of concurent requests across all accounts, not just this single sub-account.

ExpirationDate 🔗︎ date

ExpirationDate🔗︎

The date that the current credits expire.

Value 🔗︎ object[]

Value🔗︎

An array of objects representing the individual document add responses. This is used to determine which documents failed in the event of an error.

Value properties

DocumentId 🔗︎ string

DocumentId🔗︎

Id of the specific document represented in the response

Code 🔗︎ string

Code🔗︎

Code	Description
`Success`	Successful transaction
`Error`	The specified document had an error during indexing

SubCode 🔗︎ string

SubCode🔗︎

The following is a list of subcodes that can be returned by the service:

Success

– Successful transaction

InvalidParameter

A parameter was incorrectly specified

UnhandledException

Unexpected error occurred

Message 🔗︎ string

Message🔗︎

This message further describes the code/subcode providing additional detail.

Sample JSON

{
  "Info": {
    "Code": "string",
    "Message": "string",
    "TransactionId": "string",
    "EngineVersion": "string",
    "ApiVersion": "string",
    "TotalElapsedMilliseconds": 0,
    "TransactionCost": 0,
    "CustomerDetails": {
      "AccountId": "string",
      "Name": "string",
      "IPAddress": "string",
      "Region": "string",
      "CreditsRemaining": 0,
      "CreditsUsed": 0,
      "ExpirationDate": "2021-12-31",
      "MaximumConcurrentRequests": 0
    }
  },
  "Value": [
    {
      "DocumentId": "",
      "Code": "",
      "SubCode": "",
      "Message": ""
    }
  ]
}