Brief

{
  "$schema": "https://json-schema.org/draft/2020-12/schema",
  "$id": "https://artifacts.apis.io/essentras-com/json-schema/essentras-com-brief-schema.json",
  "title": "Brief",
  "x-generated": "2026-11-07",
  "x-method": "derived",
  "x-generator": "derive-json-schema.py",
  "x-source": "openapi/essentras-com-openapi.json#/components/schemas/Brief",
  "type": "object",
  "required": [
    "subject_name",
    "links",
    "goal"
  ],
  "properties": {
    "subject_name": {
      "type": "string",
      "minLength": 2,
      "maxLength": 200,
      "description": "Who or what the article is about."
    },
    "subject_title": {
      "type": "string",
      "maxLength": 200
    },
    "links": {
      "type": "string",
      "maxLength": 4000,
      "description": "Must contain at least one real link."
    },
    "goal": {
      "type": "string",
      "minLength": 50,
      "maxLength": 8000,
      "description": "The business and what the coverage should achieve."
    },
    "avoid": {
      "type": "string",
      "maxLength": 4000
    },
    "title_ideas": {
      "type": "string",
      "maxLength": 4000
    },
    "notes": {
      "type": "string",
      "maxLength": 8000
    },
    "placement_notes": {
      "type": "array",
      "maxItems": 30,
      "description": "Optional per-outlet angle. Each id must be an outlet on the order.",
      "items": {
        "type": "object",
        "required": [
          "id",
          "note"
        ],
        "properties": {
          "id": {
            "type": "string"
          },
          "note": {
            "type": "string",
            "maxLength": 2000
          }
        }
      }
    }
  }
}