---
updatedAt: 2026-02-12T21:01:17.000Z
agentTools:
  siteIndex: https://developer.jamf.com/llms.txt
  projectIndex: https://developer.jamf.com/jamf-pro/llms.txt
---

# Create software title

Creates a software title object

# OpenAPI definition

```json
{
  "openapi": "3.1.0",
  "info": {
    "title": "Title Editor",
    "description": "External patch source for Jamf Pro",
    "version": "2.0"
  },
  "x-readme": {
    "explorer-enabled": false,
    "proxy-enabled": true
  },
  "servers": [
    {
      "url": "https://yourServer.appcatalog.jamfcloud.com/v2"
    }
  ],
  "tags": [
    {
      "name": "softwaretitles"
    }
  ],
  "paths": {
    "/softwaretitles": {
      "post": {
        "tags": [
          "softwaretitles"
        ],
        "summary": "Create software title",
        "description": "Creates a software title object",
        "operationId": "addSoftwareTitle",
        "requestBody": {
          "content": {
            "application/json": {
              "schema": {
                "$ref": "#/components/schemas/softwareTitle"
              }
            }
          },
          "required": true
        },
        "responses": {
          "200": {
            "description": "Successful response - Software title created",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/softwareTitle"
                }
              }
            }
          }
        },
        "security": [
          {
            "bearer": [
              "write:softwaretitles"
            ]
          }
        ],
        "x-codegen-request-body-name": "body"
      }
    }
  },
  "components": {
    "schemas": {
      "capability": {
        "required": [
          "name",
          "operator",
          "type"
        ],
        "type": "object",
        "properties": {
          "capabilityId": {
            "type": "integer",
            "example": 0
          },
          "patchId": {
            "type": "integer",
            "example": 1
          },
          "absoluteOrderId": {
            "type": "integer",
            "example": 0
          },
          "and": {
            "type": "boolean",
            "example": true
          },
          "name": {
            "type": "string",
            "example": "Operating System Version"
          },
          "operator": {
            "type": "string",
            "example": "greater than or equal"
          },
          "value": {
            "type": "string",
            "example": "10.12"
          },
          "type": {
            "type": "string",
            "example": "recon"
          }
        }
      },
      "component": {
        "required": [
          "name",
          "version"
        ],
        "type": "object",
        "properties": {
          "componentId": {
            "type": "integer",
            "example": 0
          },
          "patchId": {
            "type": "integer",
            "example": 1
          },
          "name": {
            "type": "string",
            "example": "Component Name"
          },
          "version": {
            "type": "string",
            "example": "1.0"
          },
          "criteria": {
            "type": "array",
            "items": {
              "$ref": "#/components/schemas/criteria"
            }
          }
        }
      },
      "criteria": {
        "required": [
          "name",
          "operator",
          "type"
        ],
        "type": "object",
        "properties": {
          "criteriaId": {
            "type": "integer",
            "example": 0
          },
          "componentId": {
            "type": "integer",
            "example": 1
          },
          "absoluteOrderId": {
            "type": "integer",
            "example": 0
          },
          "and": {
            "type": "boolean",
            "example": true
          },
          "name": {
            "type": "string",
            "example": "Application Bundle ID"
          },
          "operator": {
            "type": "string",
            "example": "is"
          },
          "value": {
            "type": "string",
            "example": "com.example.myapp"
          },
          "type": {
            "type": "string",
            "example": "recon"
          }
        }
      },
      "extensionAttribute": {
        "required": [
          "displayName",
          "key"
        ],
        "type": "object",
        "properties": {
          "extensionAttributeId": {
            "type": "integer",
            "example": 0
          },
          "softwareTitleId": {
            "type": "integer",
            "example": 0
          },
          "key": {
            "type": "string",
            "example": "my-app-version"
          },
          "value": {
            "pattern": "^(?:[A-Za-z0-9+/]{4})*(?:[A-Za-z0-9+/]{2}==|[A-Za-z0-9+/]{3}=)?$",
            "type": "string",
            "format": "byte",
            "example": "IyEvYmluL3NoCgplY2hvICI8cmVzdWx0PjIuMDwvcmVzdWx0PiIKCmV4aXQgMA=="
          },
          "displayName": {
            "type": "string",
            "example": "My App Version"
          }
        }
      },
      "killApp": {
        "required": [
          "appName",
          "bundleId"
        ],
        "type": "object",
        "properties": {
          "killAppId": {
            "type": "integer",
            "example": 0
          },
          "patchId": {
            "type": "integer",
            "example": 1
          },
          "bundleId": {
            "type": "string",
            "example": "com.example.myapp"
          },
          "appName": {
            "type": "string",
            "example": "My Application.app"
          }
        }
      },
      "patch": {
        "required": [
          "minimumOperatingSystem",
          "version"
        ],
        "type": "object",
        "properties": {
          "patchId": {
            "type": "integer",
            "example": 0
          },
          "softwareTitleId": {
            "type": "integer",
            "example": 1
          },
          "absoluteOrderId": {
            "type": "integer",
            "example": 0
          },
          "enabled": {
            "type": "boolean",
            "example": true
          },
          "version": {
            "type": "string",
            "example": "1.0"
          },
          "releaseDate": {
            "type": "string",
            "format": "date-time",
            "example": "2020-01-01T00:00:00.000Z"
          },
          "standalone": {
            "type": "boolean",
            "example": true
          },
          "minimumOperatingSystem": {
            "type": "string",
            "example": "10.12"
          },
          "reboot": {
            "type": "boolean",
            "example": false
          },
          "killApps": {
            "type": "array",
            "items": {
              "$ref": "#/components/schemas/killApp"
            }
          },
          "components": {
            "type": "array",
            "items": {
              "$ref": "#/components/schemas/component"
            }
          },
          "capabilities": {
            "type": "array",
            "items": {
              "$ref": "#/components/schemas/capability"
            }
          }
        }
      },
      "requirement": {
        "required": [
          "name",
          "operator",
          "type"
        ],
        "type": "object",
        "properties": {
          "requirementId": {
            "type": "integer",
            "example": 0
          },
          "softwareTitleId": {
            "type": "integer",
            "example": 1
          },
          "absoluteOrderId": {
            "type": "integer",
            "example": 0
          },
          "and": {
            "type": "boolean",
            "example": true
          },
          "name": {
            "type": "string",
            "example": "Application Bundle ID"
          },
          "operator": {
            "type": "string",
            "example": "is"
          },
          "value": {
            "type": "string",
            "example": "com.example.myapp"
          },
          "type": {
            "type": "string",
            "example": "recon"
          }
        }
      },
      "softwareTitle": {
        "type": "object",
        "properties": {
          "softwareTitleId": {
            "type": "integer",
            "example": 0
          },
          "sourceId": {
            "type": "integer",
            "example": 0
          },
          "enabled": {
            "type": "boolean",
            "example": true
          },
          "name": {
            "type": "string",
            "example": "My Title"
          },
          "publisher": {
            "type": "string",
            "example": "Publisher"
          },
          "appName": {
            "type": "string",
            "example": "My Application.app"
          },
          "bundleId": {
            "type": "string",
            "example": "com.example.myapp"
          },
          "lastModified": {
            "type": "string",
            "format": "date-time",
            "example": "2020-01-01T00:00:00.000Z"
          },
          "currentVersion": {
            "type": "string",
            "example": "1.0"
          },
          "requirements": {
            "type": "array",
            "items": {
              "$ref": "#/components/schemas/requirement"
            }
          },
          "patches": {
            "type": "array",
            "items": {
              "$ref": "#/components/schemas/patch"
            }
          },
          "extensionAttributes": {
            "type": "array",
            "items": {
              "$ref": "#/components/schemas/extensionAttribute"
            }
          },
          "id": {
            "type": "string",
            "example": "MyTitle"
          }
        }
      }
    },
    "securitySchemes": {
      "bearer": {
        "type": "http",
        "scheme": "bearer",
        "bearerFormat": "JWT"
      }
    }
  }
}
```