Create a service job

The material must be linked to the machine’s machine group, otherwise production-service answers 404 Machine group not found.

POST/service-job

Authorization

AuthorizationAPI key · headerrequired

The Incoming Secret value (<secretId>.<random>), with or without a Bearer prefix.

Request body

application/json

namestringrequired

Service job name.

statusNamestringrequired

Name of an existing service job status, e.g. "Scheduled".

materialIdintegerrequired

Id of the material; must be linked to the machine's machine group.

machineIdintegerrequired

Id of the machine the service job runs on.

machineConfigurationNamestringrequired

Name of an existing machine configuration.

Responses

200

Created. Returns only the id — fetch the full Service job with the corresponding GET.

idinteger | stringrequired

Id of the created Service job.

Show properties

One of:

integer

integer

string

string

401

Authentication failed. All causes return this identical response.

codeinteger

messagestring

typestring

default

Downstream errors pass through verbatim; x-error-source names the failing service.

codeinteger

messagestring

typestring

Try it

Server

Base URLCustom base URLOverrides the selected server when set.

Authorization

API keyRemember on this deviceInclude my values in samples

Bodyapplication/json

namestring*Service job name.statusNamestring*Name of an existing service job status, e.g. "Scheduled".materialIdinteger*Id of the material; must be linked to the machine's machine group.machineIdinteger*Id of the machine the service job runs on.machineConfigurationNamestring*Name of an existing machine configuration.

Request

curl -X POST 'https://next.amfg.ai/engine-service/public-api/v1/service-job' \
  -H 'Authorization: YOUR_API_KEY' \
  -H 'Content-Type: application/json' \
  -d '{
  "name": "string",
  "statusName": "string",
  "materialId": 0,
  "machineId": 0,
  "machineConfigurationName": "string"
}'

const response = await fetch("https://next.amfg.ai/engine-service/public-api/v1/service-job", {
  method: "POST",
  headers: {
    "Authorization": "YOUR_API_KEY",
    "Content-Type": "application/json"
  },
  body: "{\n  \"name\": \"string\",\n  \"statusName\": \"string\",\n  \"materialId\": 0,\n  \"machineId\": 0,\n  \"machineConfigurationName\": \"string\"\n}"
});

import requests

response = requests.post(
    "https://next.amfg.ai/engine-service/public-api/v1/service-job",
    headers={
        "Authorization": "YOUR_API_KEY",
        "Content-Type": "application/json"
    },
    data="{\n  \"name\": \"string\",\n  \"statusName\": \"string\",\n  \"materialId\": 0,\n  \"machineId\": 0,\n  \"machineConfigurationName\": \"string\"\n}",
)

Response

{
  "id": 0
}

{
  "code": 401,
  "message": "Not Authorized"
}

{
  "code": 0,
  "message": "string",
  "type": "string"
}