Create an item

Existing items plus quantity may not exceed the part quantity — creating more first requires raising the part quantity via PUT /ticket-model/{id}, otherwise the call fails with 400 “Items can’t be created…”.

POST/item

Authorization

AuthorizationAPI key · headerrequired

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

Request body

application/json

ticketModelIdstringrequired

Id of the part the item belongs to, as a string.

shippingDeadlinestringrequired

Shipping deadline as an ISO date.

quantityintegerrequired

Number of items to create.

Responses

200

Created.

Array of object

object

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

ticketModelIdstring*Id of the part the item belongs to, as a string.shippingDeadlinestring*Shipping deadline as an ISO date.quantityinteger*Number of items to create.

Request

curl -X POST 'https://next.amfg.ai/engine-service/public-api/v1/item' \
  -H 'Authorization: YOUR_API_KEY' \
  -H 'Content-Type: application/json' \
  -d '{
  "ticketModelId": "4846",
  "shippingDeadline": "2026-09-01T12:00:00.000Z",
  "quantity": 1
}'

const response = await fetch("https://next.amfg.ai/engine-service/public-api/v1/item", {
  method: "POST",
  headers: {
    "Authorization": "YOUR_API_KEY",
    "Content-Type": "application/json"
  },
  body: "{\n  \"ticketModelId\": \"4846\",\n  \"shippingDeadline\": \"2026-09-01T12:00:00.000Z\",\n  \"quantity\": 1\n}"
});

import requests

response = requests.post(
    "https://next.amfg.ai/engine-service/public-api/v1/item",
    headers={
        "Authorization": "YOUR_API_KEY",
        "Content-Type": "application/json"
    },
    data="{\n  \"ticketModelId\": \"4846\",\n  \"shippingDeadline\": \"2026-09-01T12:00:00.000Z\",\n  \"quantity\": 1\n}",
)

Response

[
  {}
]

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

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