Ask for priority

A draft request for schedule priority.

All action kinds · Project workflow

• Kind: factory_prioritisation
• Availability: available
• Registry cost category: one_call
• Lifecycle stage IDs: factory_prioritisation

The cost category describes model work in the registry; it is not a manufacturing price or a monetary quote. Read maglev actions kinds --json for current availability and schemas.

What this does

Can create a message draft. Priority at a factory remains unconfirmed until the factory replies.

Input

Send these fields inside the request’s input object. Use only facts you have, and keep unresolved requirements explicit. Optional fields with defaults can be omitted.

Field	Type	Required	Details
factoryId	string	No	Min length 1. Max length 120
factoryName	string	No	Min length 1. Max length 200
orderSummary	string	Yes	What the order is, in a sentence or two. Min length 1. Max length 2000
dateThatMatters	string	Yes	Pattern: ^(?:(?:\d\d[2468][048]|\d\d[13579][26]|\d\d0[48]|[02468][048]00|[13579][26]00)-02-29|\d{4}-(?:(?:0[13578]|1[02])-(?:0[1-9]|[12]\d|3[01])|(?:0[469]|11)-(?:0[1-9]|[12]\d|30)|(?:02)-(?:0[1-9]|1\d|2[0-8])))$. Format: date
whyItMatters	string	Yes	Min length 1. Max length 1000
offers	string[]	No	What we are authorised to offer: an early deposit, flexibility on another date, a follow on order. Max items 6
currentPromise	string	No	What the factory has promised so far, if anything. Max length 500

Input JSON schema

{
  "$schema": "https://json-schema.org/draft/2020-12/schema",
  "type": "object",
  "properties": {
    "factoryId": {
      "type": "string",
      "minLength": 1,
      "maxLength": 120
    },
    "factoryName": {
      "type": "string",
      "minLength": 1,
      "maxLength": 200
    },
    "orderSummary": {
      "type": "string",
      "minLength": 1,
      "maxLength": 2000,
      "description": "What the order is, in a sentence or two"
    },
    "dateThatMatters": {
      "type": "string",
      "format": "date",
      "pattern": "^(?:(?:\\d\\d[2468][048]|\\d\\d[13579][26]|\\d\\d0[48]|[02468][048]00|[13579][26]00)-02-29|\\d{4}-(?:(?:0[13578]|1[02])-(?:0[1-9]|[12]\\d|3[01])|(?:0[469]|11)-(?:0[1-9]|[12]\\d|30)|(?:02)-(?:0[1-9]|1\\d|2[0-8])))$"
    },
    "whyItMatters": {
      "type": "string",
      "minLength": 1,
      "maxLength": 1000
    },
    "offers": {
      "description": "What we are authorised to offer: an early deposit, flexibility on another date, a follow on order",
      "maxItems": 6,
      "type": "array",
      "items": {
        "type": "string",
        "minLength": 1,
        "maxLength": 200
      }
    },
    "currentPromise": {
      "description": "What the factory has promised so far, if anything",
      "type": "string",
      "maxLength": 500
    }
  },
  "required": [
    "orderSummary",
    "dateThatMatters",
    "whyItMatters"
  ]
}

Request the action

Prepare action.json with kind: "factory_prioritisation" and an input object matching the schema above.

Replace PROJECT_ID with your saved project ID. Use a new idempotency key for new work and retain it for an identical retry.

maglev actions request PROJECT_ID --input action.json \
  --idempotency-key example-factory-prioritisation-001 --json

Read action.status, action.output, deliveries and any task in the response. Model actions can take several minutes. After a timeout, check saved actions before retrying. See request and recovery behavior.

Output

The schema below describes action.output.result. The saved action.output envelope also contains draft: true and a note. It can be null while an action is running or after a failure; check the status before reading the result. Null or missing facts are unknown; preserve source references and open questions.

Field	Type	Required	Details
messageZh	string	Yes
messageEn	string	Yes
whatWeOffer	string[]	Yes	The exact authorised offers supplied by the caller; empty when none were supplied
whatNotToPromise	string[]	Yes
factory	object or null	Yes
factoryResolved	boolean	Yes
subjectZh	string	Yes

Output JSON schema

{
  "$schema": "https://json-schema.org/draft/2020-12/schema",
  "type": "object",
  "properties": {
    "messageZh": {
      "type": "string"
    },
    "messageEn": {
      "type": "string"
    },
    "whatWeOffer": {
      "type": "array",
      "items": {
        "type": "string"
      },
      "description": "The exact authorised offers supplied by the caller; empty when none were supplied"
    },
    "whatNotToPromise": {
      "type": "array",
      "items": {
        "type": "string"
      }
    },
    "factory": {
      "anyOf": [
        {
          "type": "object",
          "properties": {
            "factoryId": {
              "type": [
                "string",
                "null"
              ]
            },
            "directoryId": {
              "type": [
                "string",
                "null"
              ]
            },
            "nameEn": {
              "type": "string"
            },
            "nameZh": {
              "type": [
                "string",
                "null"
              ]
            }
          },
          "required": [
            "factoryId",
            "directoryId",
            "nameEn",
            "nameZh"
          ],
          "additionalProperties": false
        },
        {
          "type": "null"
        }
      ]
    },
    "factoryResolved": {
      "type": "boolean"
    },
    "subjectZh": {
      "type": "string"
    }
  },
  "required": [
    "messageZh",
    "messageEn",
    "whatWeOffer",
    "whatNotToPromise",
    "factory",
    "factoryResolved",
    "subjectZh"
  ],
  "additionalProperties": false
}