The testJob API from MEF — 2 operation(s) for testjob.
Every API here is available over the APIs.io API and to AI agents over MCP.
One button, every client — Claude, Cursor, VS Code and the rest.
https://apis.io/mcp
find_apisBrowse and filter every API in the catalog.get_api_artifactsOne API's artifacts, grouped by type.get_openapiThe primary OpenAPI for this API.find_similar_apisAPIs that look like this one.apis_io_searchSTART HERE — APIs, providers and tags for one query, each with its total.resolveTurn a domain, URL or GitHub org into the provider it belongs to.find_cohortsEvery scored population of providers in the catalog.curl "https://apis.io/api/v1/apis/mef-testjob-api"curl "https://apis.io/api/v1/apis?limit=25"Discovery needs no key. Ratings and market analysis are Pro.
openapi: 3.2.0
info:
title: Mef Test Job API
version: 3.0.0
description: 'Operations tagged testJob across 3 of this provider''s published API definitions: mef-lso-allegro-service-function-test-openapi.yml, mef-lso-interlude-service-function-test-openapi.yml, mef-lso-legato-service-function-test-openapi.yml. Each path carries the servers of the definition it was published in.'
servers:
- url: https://{serverBase}/mefApi/allegro/serviceFunctionTesting/v3/
variables:
serverBase:
description: The base of SOF's URL.
default: mplify.net
- url: https://{serverBase}/mefApi/interlude/serviceFunctionTesting/v3/
variables:
serverBase:
description: The base of SOF's URL.
default: mplify.net
- url: https://{serverBase}/mefApi/legato/serviceFunctionTesting/v3/
variables:
serverBase:
description: The base of SOF's URL.
default: mplify.net
tags:
- name: testJob
paths:
/testJob:
get:
tags:
- testJob
summary: List or find TestJob objects.
description: The Buyer/Client requests a list of Test Jobs using none or more of the filter criteria. The Seller/Server returns a summarized list of Test Jobs. For each Test Job returned, the Seller/Server also provides a Test Job Identifier that uniquely identifiers this Test Job within the Seller/Server. The order of the elements returned to the Buyer/Client is defined by the Seller/Server (e.g. natural order) and does not change between the pages.
operationId: listTestJob
parameters:
- name: relatedServiceIdFrom
in: query
description: The from service identifier of the Service to be tested.
required: false
schema:
type: string
- name: relatedServiceIdTo
in: query
description: The to service identifier of the Service to be tested.
required: false
schema:
type: string
- name: testProfileId
in: query
description: The identifier of the Test Profile.
required: false
schema:
type: string
- name: name
in: query
description: The name of the Test Job.
required: false
schema:
type: string
- name: requestedStartDateTime.gt
in: query
description: The start date and time of the Test Job - greater than.
required: false
schema:
type: string
format: date-time
- name: requestedStartDateTime.lt
in: query
description: The start date and time of the Test Job - lower than.
required: false
schema:
type: string
format: date-time
- name: requestedEndDateTime.gt
in: query
description: The end date and time of the Test Job - greater than.
required: false
schema:
type: string
format: date-time
- name: requestedEndDateTime.lt
in: query
description: The end date and time of the Test Job - lower than.
required: false
schema:
type: string
format: date-time
- name: offset
in: query
description: Requested index for start of item to be provided in response requested by the client. Note that the index starts with "0".
required: false
schema:
type: integer
- name: limit
in: query
description: Requested number of resources to be provided in response.
required: false
schema:
type: integer
format: int32
responses:
'200':
description: '''OK. (https://tools.ietf.org/html/rfc7231#section-6.3.1)'''
headers:
X-Pagination-Throttled:
description: Used to indicate that result page was throttled to maximum possible size and there are additional results that can be fetched.
schema:
type: boolean
X-Total-Count:
description: The total number of matching items. E.g. if there are 50 matching items in total, but the request has offset=10 and limit=10, then the X-Total-Count is 50.
schema:
type: integer
X-Result-Count:
description: The number of items included in the response.
schema:
type: integer
content:
application/json;charset=utf-8:
schema:
type: array
items:
$ref: '#/components/schemas/TestJob_Find'
'400':
description: Bad Request
content:
application/json;charset=utf-8:
schema:
$ref: '#/components/schemas/Error400'
'401':
description: Unauthorized
content:
application/json;charset=utf-8:
schema:
$ref: '#/components/schemas/Error401'
'403':
description: Forbidden
content:
application/json;charset=utf-8:
schema:
$ref: '#/components/schemas/Error403'
'422':
description: Unprocessable entity due to the business validation problems
content:
application/json;charset=utf-8:
schema:
type: array
items:
$ref: '#/components/schemas/Error422'
'500':
description: Internal Server Error
content:
application/json;charset=utf-8:
schema:
$ref: '#/components/schemas/Error500'
post:
tags:
- testJob
summary: Creates a TestJob.
description: A request initiated by the Buyer/Client to create a Test Job in the Seller/Server that specifies the service to be tested.
operationId: createTestJob
requestBody:
description: The Test Job to be created.
content:
application/json;charset=utf-8:
schema:
$ref: '#/components/schemas/TestJob_Common'
required: true
responses:
'201':
description: '''Created (https://tools.ietf.org/html/rfc7231#section-6.3.2)'''
content:
application/json;charset=utf-8:
schema:
$ref: '#/components/schemas/TestJob'
'400':
description: Bad Request
content:
application/json;charset=utf-8:
schema:
$ref: '#/components/schemas/Error400'
'401':
description: Unauthorized
content:
application/json;charset=utf-8:
schema:
$ref: '#/components/schemas/Error401'
'403':
description: Forbidden
content:
application/json;charset=utf-8:
schema:
$ref: '#/components/schemas/Error403'
'422':
description: Unprocessable entity due to the business validation problems
content:
application/json;charset=utf-8:
schema:
type: array
items:
$ref: '#/components/schemas/Error422'
'500':
description: Internal Server Error
content:
application/json;charset=utf-8:
schema:
$ref: '#/components/schemas/Error500'
servers:
- url: https://{serverBase}/mefApi/allegro/serviceFunctionTesting/v3/
variables:
serverBase:
description: The base of SOF's URL.
default: mplify.net
/testJob/{id}:
get:
tags:
- testJob
summary: Retrieves a TestJob by ID.
description: The Buyer/Client requests detailed information about a single Test Jobs based on the Test Job Identifier.
operationId: retrieveTestJob
parameters:
- name: id
in: path
description: Identifier of the Test Job
required: true
schema:
type: string
responses:
'200':
description: '''OK. (https://tools.ietf.org/html/rfc7231#section-6.3.1)'''
content:
application/json;charset=utf-8:
schema:
$ref: '#/components/schemas/TestJob'
'400':
description: Bad Request
content:
application/json;charset=utf-8:
schema:
$ref: '#/components/schemas/Error400'
'401':
description: Unauthorized
content:
application/json;charset=utf-8:
schema:
$ref: '#/components/schemas/Error401'
'403':
description: Forbidden
content:
application/json;charset=utf-8:
schema:
$ref: '#/components/schemas/Error403'
'404':
description: Not Found
content:
application/json;charset=utf-8:
schema:
$ref: '#/components/schemas/Error404'
'500':
description: Internal Server Error
content:
application/json;charset=utf-8:
schema:
$ref: '#/components/schemas/Error500'
servers:
- url: https://{serverBase}/mefApi/allegro/serviceFunctionTesting/v3/
variables:
serverBase:
description: The base of SOF's URL.
default: mplify.net
components:
schemas:
TimeUnit:
description: 'Represents a unit of time.
'
type: string
enum:
- seconds
- minutes
- businessHours
- calendarHours
- businessDays
- calendarDays
- months
- years
Error403Code:
description: 'This code indicates that the server understood
the request but refuses to authorize it because
of one of the following error codes:
- accessDenied: Access denied
- forbiddenRequester: Forbidden requester
- tooManyUsers: Too many users'
type: string
enum:
- accessDenied
- forbiddenRequester
- tooManyUsers
TerminationError:
description: This indicates an error that caused an Item to be terminated. The code and propertyPath should be used like in Error422.
type: object
properties:
code:
description: "One of the following error codes:\n - missingProperty: The property the SOF has expected is not present in the payload\n - invalidValue: The property has an incorrect value\n - invalidFormat: The property value does not comply with the expected value format\n - referenceNotFound: The object referenced by the property cannot be identified in the SOF system\n - unexpectedProperty: Additional property, not expected by the SOF has been provided\n - tooManyRecords: the number of records to be provided in the response exceeds the SOF's threshold.\n - otherIssue: Other problem was identified (detailed information provided in a reason)\n"
$ref: '#/components/schemas/Error422Code'
propertyPath:
description: 'A pointer to a particular property of the payload that caused the validation issue. It is highly recommended that this property should be used.
Defined using JavaScript Object Notation (JSON) Pointer (https://tools.ietf.org/html/rfc6901).
'
type: string
value:
description: Text to describe the reason of the termination.
type: string
Duration:
description: A Duration in a given unit of time e.g. 3 hours, or 5 days.
type: object
properties:
amount:
description: Duration (number of seconds, minutes, hours, etc.)
type: integer
minimum: 0
units:
description: Time unit enumerated
$ref: '#/components/schemas/TimeUnit'
required:
- amount
- units
TestJob:
allOf:
- $ref: '#/components/schemas/TestJob_Common'
- description: A definition of Test Job for a specific Service Identifier.
type: object
properties:
actualStartDateTime:
description: The actual start date and time that a Test Job started.
type: string
format: date-time
actualEndDateTime:
description: The actual end date and time of the Test Job.
type: string
format: date-time
creationDate:
type: string
format: date-time
description: Date when the Test Job was created.
href:
type: string
format: uri
description: Hyperlink reference
id:
description: The identifier of the Test Job.
type: string
lastModifiedDate:
type: string
format: date-time
description: Date when the job was last modified.
state:
$ref: '#/components/schemas/TestJobStateType'
terminationError:
description: When the Seller/Server cannot process the request, the Seller/Server returns a text-based list of reasons here.
type: array
items:
$ref: '#/components/schemas/TerminationError'
required:
- creationDate
- href
- id
- lastModifiedDate
- state
ServiceRef:
description: Reference to a Service instance.
type: object
properties:
href:
description: Hyperlink reference to Service
type: string
id:
description: unique identifier of Service
type: string
required:
- id
TestJob_Common:
description: A definition of Test Job for a specific Service Identifier.
type: object
properties:
name:
description: The name of the Test Job.
type: string
description:
description: A description of the Test Job.
type: string
requestedStartDateTime:
description: The start date and time of the Test Job. If the Buyer desires to schedule a test, this is a future date/time. If the Buyer desires an immediate test, this is empty.
type: string
format: date-time
requestedEndDateTime:
description: The end date and time of the Test Job.
type: string
format: date-time
recurrencePeriod:
$ref: '#/components/schemas/Duration'
testProfile:
$ref: '#/components/schemas/TestProfileRefOrValue'
relatedServiceFrom:
$ref: '#/components/schemas/ServiceRef'
relatedServiceTo:
$ref: '#/components/schemas/ServiceRef'
serviceSpecificTestJobConfiguration:
$ref: '#/components/schemas/ServiceSpecificTestJobConfiguration'
required:
- name
- relatedServiceFrom
- relatedServiceTo
- requestedEndDateTime
- serviceSpecificTestJobConfiguration
- testProfile
TestJob_Find:
description: This class represents a single list item for the response of `listTestJob`
type: object
properties:
requestedEndDateTime:
description: The end date and time of the Test Job.
type: string
id:
description: A unique identifier for the Test Job assigned by the Seller/Server.
type: string
name:
description: The name of the Test Job..
type: string
relatedServiceFrom:
$ref: '#/components/schemas/ServiceRef'
relatedServiceTo:
$ref: '#/components/schemas/ServiceRef'
requestedStartDateTime:
description: The start date and time of the Test Job.
type: string
testProfile:
$ref: '#/components/schemas/TestProfileRefOrValue'
required:
- idRelatedContact
- name
- relatedServiceFrom
- relatedServiceTo
- requestedEndDateTime
- requestedStartDateTime
- testProfile
Error401Code:
description: 'One of the following error codes:
- missingCredentials: No credentials provided.
- invalidCredentials: Provided credentials are invalid or expired
'
type: string
enum:
- missingCredentials
- invalidCredentials
Error400:
description: Bad Request. (https://tools.ietf.org/html/rfc7231#section-6.5.1)
allOf:
- $ref: '#/components/schemas/Error'
- type: object
properties:
code:
description: 'One of the following error codes:
- missingQueryParameter: The URI is missing a required
query-string parameter
- missingQueryValue: The URI is missing a required query-string
parameter value
- invalidQuery: The query section of the URI is invalid.
- invalidBody: The request has an invalid body
'
$ref: '#/components/schemas/Error400Code'
required:
- code
Error500:
description: Internal Server Error. (https://tools.ietf.org/html/rfc7231#section-6.6.1)
allOf:
- $ref: '#/components/schemas/Error'
- type: object
properties:
code:
description: 'The following error code:
- internalError: Internal server error - the server encountered
an unexpected condition that prevented it from fulfilling the
request.
'
type: string
enum:
- internalError
required:
- code
Error400Code:
description: 'One of the following error codes:
- missingQueryParameter: The URI is missing a required query-string
parameter
- missingQueryValue: The URI is missing a required query-string
parameter value
- invalidQuery: The query section of the URI is invalid.
- invalidBody: The request has an invalid body
'
type: string
enum:
- missingQueryParameter
- missingQueryValue
- invalidQuery
- invalidBody
Error401:
description: Unauthorized. (https://tools.ietf.org/html/rfc7235#section-3.1)
allOf:
- $ref: '#/components/schemas/Error'
- type: object
properties:
code:
description: 'One of the following error codes:
- missingCredentials: No credentials provided.
- invalidCredentials: Provided credentials are invalid or
expired
'
$ref: '#/components/schemas/Error401Code'
required:
- code
ServiceSpecificTestJobConfiguration:
description: ServiceSpecificTestJobConfiguration is used as an extension point for schema to be used that defines the Test Measure attributes. The `@type` attribute is used as a discriminator.
type: object
properties:
'@type':
description: The named type must be a subclass of ServiceSpecificTestJobConfiguration.
type: string
required:
- '@type'
discriminator:
propertyName: '@type'
Error:
description: 'Standard Class used to describe API response error Not intended to be used directly. The `code` in the HTTP header is used as a discriminator for the type of error returned in runtime.
'
type: object
properties:
message:
description: Text that provides mode details and corrective actions related to the error. This can be shown to a client user.
type: string
reason:
description: Text that explains the reason for the error. This can be shown to a client user.
type: string
maxLength: 255
referenceError:
description: URL pointing to documentation describing the error
type: string
format: uri
required:
- reason
Error422Code:
description: "One of the following error codes:\n - missingProperty: The property the Seller has expected is not present in the payload\n - invalidValue: The property has an incorrect value\n - invalidFormat: The property value does not comply with the expected value format\n - referenceNotFound: The object referenced by the property cannot be identified in the Seller system\n - unexpectedProperty: Additional property, not expected by the Seller has been provided\n - tooManyRecords: the number of records to be provided in the response exceeds the Seller's threshold.\n - otherIssue: Other problem was identified (detailed information provided in a reason)\n"
type: string
enum:
- missingProperty
- invalidValue
- invalidFormat
- referenceNotFound
- unexpectedProperty
- tooManyRecords
- otherIssue
Error422:
description: Unprocessable entity due to a business validation problem. (https://tools.ietf.org/html/rfc4918#section-11.2)
allOf:
- $ref: '#/components/schemas/Error'
- type: object
properties:
code:
description: "One of the following error codes:\n - missingProperty: The property the Seller has expected is not present in the payload\n - invalidValue: The property has an incorrect value\n - invalidFormat: The property value does not comply with the expected value format\n - referenceNotFound: The object referenced by the property cannot be identified in the Seller system\n - unexpectedProperty: Additional property, not expected by the Seller has been provided\n - tooManyRecords: the number of records to be provided in the response exceeds the Seller's threshold.\n - otherIssue: Other problem was identified (detailed information provided in a reason)\n"
$ref: '#/components/schemas/Error422Code'
propertyPath:
description: 'A pointer to a particular property of the payload that caused the validation issue. It is highly recommended that this property should be used.
Defined using JavaScript Object Notation (JSON) Pointer (https://tools.ietf.org/html/rfc6901).
'
type: string
required:
- code
Error404:
description: Resource for the requested path not found. (https://tools.ietf.org/html/rfc7231#section-6.5.4)
allOf:
- $ref: '#/components/schemas/Error'
- type: object
properties:
code:
description: 'The following error code:
- notFound: A current representation for the target resource
not found
'
type: string
enum:
- notFound
required:
- code
TestProfileRefOrValue:
description: Defines the reference to Test Profile or defines values from TestProfile type.
discriminator:
propertyName: '@type'
mapping:
TestProfileRef: '#/components/schemas/TestProfileRef'
TestProfileValue: '#/components/schemas/TestProfileValue'
properties:
'@type':
type: string
description: This field is used as a discriminator to differentiate if object relates directly to Test Profile entity or defines values from TestProfile type.
required:
- '@type'
Error403:
description: Forbidden. This code indicates that the server understood the request but refuses to authorize it. (https://tools.ietf.org/html/rfc7231#section-6.5.3)
allOf:
- $ref: '#/components/schemas/Error'
- type: object
properties:
code:
description: 'This code indicates that the server understood
the request but refuses to authorize it because
of one of the following error codes:
- accessDenied: Access denied
- forbiddenRequester: Forbidden requester
- tooManyUsers: Too many users'
$ref: '#/components/schemas/Error403Code'
required:
- code
TestJobStateType:
description: 'The state of the Test Job.
| State | Mplify 136.1 name | Description |
| -------------------------| -----------------------| -----------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------|
| `acknowledged` | ACKNOWLEDGED | The Create Test Job request has been received from the Buyer/Client and the Seller/Server has assigned a Test Job Identifier to it. If the request attributes fail validation, the Create Test Job moves to the REJECTED state. If the attributes pass validation, it is then determined if the Create Test Job Start Date Time is immediate or if the Create Test Job Start Date Time indicates that the Test Job is to be scheduled for a later date time. If the Test Job is to be scheduled the Test Job moves to the SCHEDULED state and awaits the scheduled date and time. If the Test Job is to be performed immediately, the Test Job moves to the IN_PROGRESS state and Test Results begin.|
| `assessingCancellation` | ASSESSING_CANCELLATION | A Cancel Test Job request is received while the Test Job is in the IN_PROGRESS, SUSPENDED or SCHEDULED state. If the Cancel Test Job request is approved, the Test Job moves to the CANCELLED state. If not, the Test Job returns to the IN_PROGRESS, SUSPENDED or SCHEDULED state. |
| `assessingModification` | ASSESSING_MODIFICATION | A Modify Test Job request was received while the Test Job is in the SUSPENDED or SCHEDULED state. If the Modify Test Job is accepted, the Test Job is updated. If the Modify Test Job is declined, the Test Job is not updated and returns to the SUSPENDED or SCHEDULED state. |
| `cancelled` | CANCELLED | A Cancel Test Job request is received from the Buyer/Client. If the request is accepted, the Test Job moves to the CANCELLED state. The Test Job must be in the IN_PROGRESS, SCHEDULED, or SUSPENDED, state. |
| `completed` | COMPLETED | The Test Job has reached the End Date Time or has completed all Test Measurements and provided Test Results. |
| `inProgress` | IN_PROGRESS | Whether an immediate request or a scheduled request, the Test Job moves to the IN_PROGRESS state when it begins performing Test Results. If a Cancel Test Job request is received and accepted, the Test Job moves to the CANCELLED state. If the Cancel Test Job request is declined, the Test Job returns to the IN_PROGRESS state and continues Test Results until they are completed. If a Suspend Test Job request is received, the Test Job moves to the SUSPENDED state. |
| `rejected` | REJECTED | The Create Test Job request fails validation and is rejected. |
| `scheduled` | SCHEDULED | The Test Job is scheduled to start at a later time. The Test Job stays in the SCHEDULED state until the Start Date and Time is reached. The Test Job moves to IN_PROGRESS when the Start Date and Time is reached. A Test Job with the state SCHEDULED can be moved to the SUSPENDED or CANCELLED state. |
| `suspended` | SUSPENDED | A Test Job in the IN_PROGRESS or SCHEDULED state receives a Suspend Test Job request. The Test Job moves to the SUSPENDED state. |'
type: string
enum:
- acknowledged
- assessingCancellation
- assessingModification
- cancelled
- completed
- inProgress
- rejected
- scheduled
- suspended
x-refined-from:
- mef-lso-allegro-service-function-test-openapi.yml
- mef-lso-interlude-service-function-test-openapi.yml
- mef-lso-legato-service-function-test-openapi.yml