SimpleJobPostingRequest

{
  "$schema": "https://json-schema.org/draft/2020-12/schema",
  "$id": "https://artifacts.apis.io/linkedin/json-schema/linkedin-simple-job-posting-request-schema.json",
  "title": "SimpleJobPostingRequest",
  "description": "Request body for creating or updating job postings",
  "x-generated": "2026-11-05",
  "x-method": "derived",
  "x-generator": "derive-json-schema.py",
  "x-source": "openapi/linkedin-apply-connect-jobs-api-openapi.yml#/components/schemas/SimpleJobPostingRequest",
  "type": "object",
  "required": [
    "elements"
  ],
  "properties": {
    "elements": {
      "type": "array",
      "items": {
        "$ref": "#/$defs/JobPostingElement"
      }
    }
  },
  "$defs": {
    "AdditionalQuestions": {
      "type": "object",
      "properties": {
        "customQuestionSets": {
          "type": "array",
          "items": {
            "$ref": "#/$defs/CustomQuestionSet"
          }
        }
      }
    },
    "ApplicationQuestions": {
      "type": "object",
      "description": "Questions configuration for job applications",
      "properties": {
        "resumeQuestions": {
          "$ref": "#/$defs/ResumeQuestions"
        },
        "coverLetterQuestions": {
          "$ref": "#/$defs/CoverLetterQuestions"
        },
        "voluntarySelfIdentificationQuestions": {
          "type": "object",
          "description": "Voluntary self-identification questions"
        },
        "educationQuestions": {
          "$ref": "#/$defs/EducationQuestions"
        },
        "workQuestions": {
          "$ref": "#/$defs/WorkQuestions"
        },
        "additionalQuestions": {
          "$ref": "#/$defs/AdditionalQuestions"
        }
      }
    },
    "CoverLetterQuestions": {
      "type": "object",
      "properties": {
        "coverLetterQuestionRequirement": {
          "type": "string",
          "enum": [
            "REQUIRED",
            "OPTIONAL",
            "NOT_AVAILABLE"
          ]
        }
      }
    },
    "CustomQuestion": {
      "type": "object",
      "properties": {
        "required": {
          "type": "boolean"
        },
        "partnerQuestionIdentifier": {
          "type": "string"
        },
        "questionText": {
          "type": "string"
        },
        "questionDetails": {
          "$ref": "#/$defs/QuestionDetails"
        }
      }
    },
    "CustomQuestionSet": {
      "type": "object",
      "properties": {
        "questionSetId": {
          "type": "string"
        },
        "questions": {
          "type": "array",
          "items": {
            "$ref": "#/$defs/CustomQuestion"
          }
        }
      }
    },
    "EducationQuestions": {
      "type": "object",
      "properties": {
        "educationExperienceQuestionSet": {
          "type": "object"
        }
      }
    },
    "JobPostingElement": {
      "type": "object",
      "description": "Individual job posting element",
      "required": [
        "externalJobPostingId",
        "title",
        "description",
        "integrationContext",
        "listingType",
        "location"
      ],
      "properties": {
        "externalJobPostingId": {
          "type": "string",
          "description": "External identifier for the job posting"
        },
        "title": {
          "type": "string",
          "description": "Job title"
        },
        "description": {
          "type": "string",
          "description": "Full job description"
        },
        "integrationContext": {
          "type": "string",
          "description": "Organization URN for the job posting"
        },
        "jobPostingOperationType": {
          "type": "string",
          "description": "Operation type for the job posting",
          "enum": [
            "CREATE",
            "UPDATE",
            "CLOSE"
          ]
        },
        "listingType": {
          "type": "string",
          "description": "Type of job listing",
          "enum": [
            "BASIC",
            "PREMIUM"
          ]
        },
        "listedAt": {
          "type": "integer",
          "format": "int64",
          "description": "Timestamp when the job was listed"
        },
        "location": {
          "type": "string",
          "description": "Job location"
        },
        "companyApplyUrl": {
          "type": "string",
          "format": "uri",
          "description": "URL for company's application page"
        },
        "onsiteApplyConfiguration": {
          "$ref": "#/$defs/OnsiteApplyConfiguration"
        }
      }
    },
    "MultipleChoiceQuestionDetails": {
      "type": "object",
      "properties": {
        "choices": {
          "type": "array",
          "items": {
            "$ref": "#/$defs/QuestionChoice"
          }
        },
        "selectMultiple": {
          "type": "boolean"
        },
        "preferredFormComponent": {
          "type": "string",
          "enum": [
            "RADIO_BUTTONS",
            "DROPDOWN",
            "CHECKBOXES"
          ]
        }
      }
    },
    "OnsiteApplyConfiguration": {
      "type": "object",
      "description": "Configuration for onsite application collection",
      "properties": {
        "jobApplicationWebhookUrl": {
          "type": "string",
          "format": "uri",
          "description": "Webhook URL for receiving job applications"
        },
        "questions": {
          "$ref": "#/$defs/ApplicationQuestions"
        }
      }
    },
    "QuestionChoice": {
      "type": "object",
      "properties": {
        "symbolicName": {
          "type": "string"
        },
        "displayValue": {
          "type": "string"
        }
      }
    },
    "QuestionDetails": {
      "type": "object",
      "properties": {
        "multipleChoiceQuestionDetails": {
          "$ref": "#/$defs/MultipleChoiceQuestionDetails"
        }
      }
    },
    "ResumeQuestions": {
      "type": "object",
      "properties": {
        "resumeQuestionRequirement": {
          "type": "string",
          "enum": [
            "REQUIRED",
            "OPTIONAL",
            "NOT_AVAILABLE"
          ]
        }
      }
    },
    "WorkQuestions": {
      "type": "object",
      "properties": {
        "workExperienceQuestionSet": {
          "type": "object"
        }
      }
    }
  }
}