Job

Manage Jobs

Listing available jobs

get

Retrieves agent jobs.

Required scopes

  • ai.agent_read

Authorizations
Path parameters
tenantstringRequired

Your Emporix tenant name.

Note: The tenant name should always be provided in lowercase.

Query parameters
qstringOptional

A standard query parameter is used to search for specific values.

See: Standard Practices - Query parameter

pageSizestringOptional

The number of documents to be retrieved per page.

pageNumberstringOptional

The page number to be retrieved. The size of the pages should be specified by the pageSize parameter.

sortstringOptional

List of properties used to sort the results, separated by colons.

fieldsstringOptional

Fields to be returned in the response.

Header parameters
X-Total-CountbooleanOptional

Flag indicating whether the total number of retrieved results should be returned.

Responses
200

List of available jobs.

application/json
get
/ai-service/{tenant}/jobs
GET /ai-service/{tenant}/jobs HTTP/1.1
Host: api.emporix.io
Authorization: Bearer YOUR_OAUTH2_TOKEN
Accept: */*
[
  {
    "id": "68835cc3ef4e8e1425c360ad",
    "status": "success",
    "sessionId": "123e4567-e89b-12d3-a456-426614174000",
    "agentType": "complaint",
    "agentId": "complaint-agent",
    "commerceEvent": "product.product-updated",
    "message": "Dear Customer,\n\nWe have successfully processed your support request regarding the incorrect information on invoice EIN251131 for order EON1031. Our team has verified the order and customer details, confirming both the order and legal entity were found.\nThank you for your patience and cooperation.\n\nBest regards,  \n[Your Support Team]",
    "metadata": {
      "version": 1,
      "createdAt": "2025-07-25T10:30:27.167Z",
      "modifiedAt": "2025-07-25T10:31:14.509Z"
    }
  }
]

Searching jobs

post

Searches for agent jobs based on the provided query.

Required scopes

  • ai.agent_read

Authorizations
Path parameters
tenantstringRequired

Your Emporix tenant name.

Note: The tenant name should always be provided in lowercase.

Query parameters
pageSizestringOptional

The number of documents to be retrieved per page.

pageNumberstringOptional

The page number to be retrieved. The size of the pages should be specified by the pageSize parameter.

sortstringOptional

List of properties used to sort the results, separated by colons.

fieldsstringOptional

Fields to be returned in the response.

Header parameters
X-Total-CountbooleanOptional

Flag indicating whether the total number of retrieved results should be returned.

Body
qstringOptional

A standard query parameter is used to search for specific values.

See: Standard Practices - Query parameter

Responses
200

List of available jobs.

application/json
post
/ai-service/{tenant}/jobs/search
POST /ai-service/{tenant}/jobs/search HTTP/1.1
Host: api.emporix.io
Authorization: Bearer YOUR_OAUTH2_TOKEN
Content-Type: application/json
Accept: */*
Content-Length: 21

{
  "q": "name:~Support"
}
[
  {
    "id": "68835cc3ef4e8e1425c360ad",
    "status": "success",
    "sessionId": "123e4567-e89b-12d3-a456-426614174000",
    "agentType": "complaint",
    "agentId": "complaint-agent",
    "commerceEvent": "product.product-updated",
    "message": "Dear Customer,\n\nWe have successfully processed your support request regarding the incorrect information on invoice EIN251131 for order EON1031. Our team has verified the order and customer details, confirming both the order and legal entity were found.\nThank you for your patience and cooperation.\n\nBest regards,  \n[Your Support Team]",
    "metadata": {
      "version": 1,
      "createdAt": "2025-07-25T10:30:27.167Z",
      "modifiedAt": "2025-07-25T10:31:14.509Z"
    }
  }
]

Retrieving available job

get

Retrieves agent job by its ID.

Required scopes

  • ai.agent_read

Authorizations
Path parameters
tenantstringRequired

Your Emporix tenant name.

Note: The tenant name should always be provided in lowercase.

jobIdstringRequired
Query parameters
fieldsstringOptional

Fields to be returned in the response.

Responses
200

A job details.

application/json
get
/ai-service/{tenant}/jobs/{jobId}
GET /ai-service/{tenant}/jobs/{jobId} HTTP/1.1
Host: api.emporix.io
Authorization: Bearer YOUR_OAUTH2_TOKEN
Accept: */*
{
  "id": "68835cc3ef4e8e1425c360ad",
  "status": "success",
  "sessionId": "123e4567-e89b-12d3-a456-426614174000",
  "agentType": "complaint",
  "agentId": "complaint-agent",
  "commerceEvent": "product.product-updated",
  "message": "Dear Customer,\n\nWe have successfully processed your support request regarding the incorrect information on invoice EIN251131 for order EON1031. Our team has verified the order and customer details, confirming both the order and legal entity were found.\nThank you for your patience and cooperation.\n\nBest regards,  \n[Your Support Team]",
  "metadata": {
    "version": 1,
    "createdAt": "2025-07-25T10:30:27.167Z",
    "modifiedAt": "2025-07-25T10:31:14.509Z"
  }
}

Deleting a job

delete

Deletes job by given ID.

Required scopes

  • ai.agent_manage

Authorizations
Path parameters
tenantstringRequired

Your Emporix tenant name.

Note: The tenant name should always be provided in lowercase.

jobIdstringRequired
Responses
204

Given job has been deleted.

No content

delete
/ai-service/{tenant}/jobs/{jobId}
DELETE /ai-service/{tenant}/jobs/{jobId} HTTP/1.1
Host: api.emporix.io
Authorization: Bearer YOUR_OAUTH2_TOKEN
Accept: */*

No content

Last updated

Was this helpful?