{
    "type": "object",
    "properties": {
        "href": {
            "type": "string"
        }
    },
    "additionalProperties": false
}

{
    "type": "object",
    "required": [
        "code",
        "message"
    ],
    "properties": {
        "code": {
            "type": "string",
            "description": "One of a server-defined set of error codes."
        },
        "target": {
            "type": "string",
            "nullable": true,
            "description": "The target of the error."
        },
        "message": {
            "type": "string",
            "description": "A human-readable representation of the error."
        }
    },
    "description": "Contains error information.",
    "additionalProperties": true
}

{
    "type": "object",
    "nullable": true,
    "properties": {
        "up": {
            "$ref": "#/components/schemas/point3D"
        },
        "direction": {
            "$ref": "#/components/schemas/point3D"
        },
        "viewPoint": {
            "$ref": "#/components/schemas/point3D"
        },
        "fieldOfView": {
            "type": "number",
            "nullable": true,
            "description": "Determines the number of degrees in the circular arc around the camera's position that is visible in the view. Either this or viewToWorldScale should be specified, but not both."
        },
        "viewToWorldScale": {
            "type": "number",
            "nullable": true,
            "description": "Determines the zoom level of the camera, i.e. how much to multiply 1 distance unit in the view by to get the actual distance in meters in the model. Either this or fieldOfView should be specified, but not both."
        }
    },
    "additionalProperties": false
}

{
    "type": "object",
    "nullable": true,
    "properties": {
        "x": {
            "type": "number"
        },
        "y": {
            "type": "number"
        },
        "z": {
            "type": "number"
        }
    },
    "additionalProperties": false
}

{
    "type": "object",
    "nullable": true,
    "properties": {
        "latitude": {
            "type": "number",
            "nullable": true,
            "description": "The degrees latitude of the issue's location. North: positive, south: negative."
        },
        "elevation": {
            "type": "number",
            "nullable": true,
            "description": "The geographical elevation above/below sea level. Units for this property are not standardized, so an application should not make assumptions about this property's value set by other applications unless that other application's units are known."
        },
        "longitude": {
            "type": "number",
            "nullable": true,
            "description": "The degrees longitude of the issues location. East: positive, west: negative."
        },
        "description": {
            "type": "string",
            "nullable": true,
            "description": "A string describing the significance of this location."
        }
    },
    "description": "Origin info. The geographical location the issue pertains to.",
    "additionalProperties": false
}

{
    "type": "object",
    "title": "Issue (get)",
    "properties": {
        "id": {
            "type": "string",
            "description": "Unique identifier for this instance. Read-only."
        },
        "type": {
            "type": "string",
            "description": "Read-only. Describes which domain of work the issue involves, which determines what applications will show it. Automatically set based on the form definition that was used to create the issue."
        },
        "state": {
            "type": "string",
            "description": "Indicates whether the issue's status is an Open, Closed, or Draft status. This property is read-only."
        },
        "_links": {
            "oneOf": [
                {
                    "$ref": "#/components/schemas/source-entity-links-file"
                },
                {
                    "$ref": "#/components/schemas/source-entity-links-i-model-element"
                }
            ],
            "description": "Links to related entities, if applicable."
        },
        "formId": {
            "type": "string",
            "description": "The ID of the form definition that this issue was created with. Note: This property will only be returned during the 'Get issue details' query, not in the result of a Create or Modify operation."
        },
        "number": {
            "type": "string",
            "nullable": true,
            "description": "An human-readable identifier for the issue, consisting of an alphanumeric prefix (that can be configured by the project administrator) followed by an auto-incrementing number. Read-only."
        },
        "status": {
            "type": "string",
            "description": "The current workflow status the issue is in right now."
        },
        "dueDate": {
            "type": "string",
            "format": "date-time",
            "nullable": true,
            "description": "The date by which an action should be taken on this issue. Applications will use this to determine whether an issue is near due or overdue."
        },
        "subject": {
            "type": "string",
            "nullable": true,
            "description": "Brief title/description of the issue."
        },
        "assignee": {
            "$ref": "#/components/schemas/primary-assignee"
        },
        "location": {
            "$ref": "#/components/schemas/location"
        },
        "modelPin": {
            "$ref": "#/components/schemas/model-pin"
        },
        "assignees": {
            "type": "array",
            "items": {
                "$ref": "#/components/schemas/secondary-assignee"
            },
            "description": "For cases when an issue is assigned to multiple people and/or roles, this lists all of them rather than just the primary assignee."
        },
        "createdBy": {
            "type": "string",
            "description": "The display name of the user who originally created this issue. Read-only."
        },
        "modelView": {
            "$ref": "#/components/schemas/model-view"
        },
        "properties": {
            "$ref": "#/components/schemas/dynamic-object"
        },
        "boundingBox": {
            "$ref": "#/components/schemas/bounding-box"
        },
        "description": {
            "type": "string",
            "nullable": true,
            "description": "Detailed description of the issue."
        },
        "displayName": {
            "type": "string",
            "nullable": true,
            "description": "Name that should be used to show this issue in a list of issues in the UI. This is read-only. Project managers can configure how this is generated; usually, it will be the value of another property."
        },
        "statusColor": {
            "type": "string",
            "nullable": true,
            "description": "A RBG hexadecimal color string, e.g. `#ff0000`. Read-only. If set, this gives a hint for how to highlight the issue in a list of issues based on its current workflow status."
        },
        "sourceEntity": {
            "oneOf": [
                {
                    "$ref": "#/components/schemas/source-entity-file"
                },
                {
                    "$ref": "#/components/schemas/source-entity-i-model-element"
                }
            ],
            "description": "Origin info. An object linking the issue to an entity outside the Issues service, such as a file in Storage or an element in an iModel, that the issue was created to pertain to."
        },
        "lastModifiedBy": {
            "type": "string",
            "description": "The display name of the user who most recently made a change to this issue. Read-only."
        },
        "createdDateTime": {
            "type": "string",
            "format": "date-time",
            "description": "The date and time when this issue was originally created. Read-only."
        },
        "modelEventDateTime": {
            "type": "string",
            "format": "date-time",
            "nullable": true,
            "description": "The date and time represented in the model where the issue occurred (if in a 4D model)."
        },
        "lastModifiedDateTime": {
            "type": "string",
            "format": "date-time",
            "description": "The date and time when this issue was most recently edited. Read-only."
        }
    },
    "description": "Contains the full data of this issue. Any property that was never set on the issue will be omitted from the response.",
    "additionalProperties": false
}

{
    "type": "object",
    "title": "Model Pin",
    "nullable": true,
    "properties": {
        "location": {
            "$ref": "#/components/schemas/point3D"
        },
        "description": {
            "type": "string",
            "nullable": true,
            "description": "String describing the relevance of the pin's location."
        }
    },
    "description": "Origin info. Associates an issue with a single point in a model that does not necessarily correspond to a model element.",
    "additionalProperties": false
}

{
    "type": "object",
    "title": "Model View",
    "nullable": true,
    "properties": {
        "cameraView": {
            "$ref": "#/components/schemas/camera"
        },
        "iModelJsView": {
            "type": "string",
            "nullable": true,
            "description": "The ID of a saved view showing the issue."
        }
    },
    "description": "Origin info. Describes the view that was visible when the issue was created.",
    "additionalProperties": false
}

{
    "type": "object",
    "nullable": true,
    "properties": {
        "lowerLeftPoint3D": {
            "$ref": "#/components/schemas/point3D"
        },
        "upperRightPoint3D": {
            "$ref": "#/components/schemas/point3D"
        }
    },
    "description": "Origin info. Describes a rectangular-prism-shaped region in a 3D model that the issue pertains to.",
    "additionalProperties": false
}

{
    "type": "object",
    "title": "Issue (create)",
    "required": [
        "formId"
    ],
    "properties": {
        "formId": {
            "type": "string",
            "description": "The ID of the form definition (obtained from the Get project form definitions query) to associate this issue with. The chosen form definition will be used to display the issue in the Issues webapp and other Bentley applications. If no form definition exists in the current project for the issue type you wish to create, please have a project administrator create or import such a form definition using Bentley's Form Designer."
        },
        "status": {
            "type": "string",
            "nullable": true,
            "description": "The issue's new workflow status, if applicable."
        },
        "dueDate": {
            "type": "string",
            "format": "date-time",
            "nullable": true,
            "description": "The date by which an action should be taken on this issue. Applications will use this to determine whether an issue is near due or overdue."
        },
        "subject": {
            "type": "string",
            "nullable": true,
            "description": "Brief title/description of the issue."
        },
        "assignee": {
            "$ref": "#/components/schemas/primary-assignee"
        },
        "location": {
            "$ref": "#/components/schemas/location"
        },
        "modelPin": {
            "$ref": "#/components/schemas/model-pin"
        },
        "assignees": {
            "type": "array",
            "items": {
                "$ref": "#/components/schemas/secondary-assignee"
            },
            "description": "For cases when an issue is assigned to multiple people and/or roles, this lists all of them rather than just the primary assignee."
        },
        "modelView": {
            "$ref": "#/components/schemas/model-view"
        },
        "properties": {
            "$ref": "#/components/schemas/dynamic-object"
        },
        "boundingBox": {
            "$ref": "#/components/schemas/bounding-box"
        },
        "description": {
            "type": "string",
            "nullable": true,
            "description": "Detailed description of the issue."
        },
        "sourceEntity": {
            "oneOf": [
                {
                    "$ref": "#/components/schemas/source-entity-file"
                },
                {
                    "$ref": "#/components/schemas/source-entity-i-model-element"
                }
            ],
            "description": "Origin info. An object linking the issue to an entity outside the Issues service, such as a file in Storage or an element in an iModel, that the issue was created to pertain to."
        },
        "modelEventDateTime": {
            "type": "string",
            "format": "date-time",
            "nullable": true,
            "description": "The date and time represented in the model where the issue occurred (if in a 4D model)."
        }
    },
    "description": "Sets property values for an issue being newly created.",
    "additionalProperties": false
}

{
    "type": "object",
    "required": [
        "code",
        "message",
        "details"
    ],
    "properties": {
        "code": {
            "type": "string",
            "description": "One of a server-defined set of error codes."
        },
        "target": {
            "type": "string",
            "nullable": true,
            "description": "The target of the error."
        },
        "details": {
            "type": "array",
            "items": {
                "$ref": "#/components/schemas/Error"
            },
            "description": "Optional array of more specific errors."
        },
        "message": {
            "type": "string",
            "description": "A human-readable representation of the error."
        }
    },
    "description": "Contains error information and an array of more specific errors.",
    "additionalProperties": true
}

{
    "type": "object",
    "title": "Error Response",
    "required": [
        "error"
    ],
    "properties": {
        "error": {
            "$ref": "#/components/schemas/Error",
            "description": "Error information."
        }
    },
    "description": "Gives details for an error that occurred while handling the request. Note that clients MUST NOT assume that every failed request will produce an object of this schema, or that all of the properties in the response will be non-null, as the error may have prevented this response from being constructed.",
    "additionalProperties": false
}

{
    "type": "object",
    "title": "Primary Assignee",
    "properties": {
        "id": {
            "type": "string",
            "description": "The GUID identifying the user or role."
        },
        "displayName": {
            "type": "string",
            "description": "The role's name, or the user's given name and surname, as it should be displayed in an application."
        }
    },
    "description": "An object describing the primary user or role assigned to an issue.",
    "additionalProperties": false
}

{
    "type": "object",
    "title": "Issue Details (get)",
    "properties": {
        "issue": {
            "$ref": "#/components/schemas/issue-get"
        }
    },
    "additionalProperties": false
}

{
    "type": "object",
    "title": "Secondary Assignee",
    "properties": {
        "id": {
            "type": "string",
            "description": "The GUID identifying the user or role."
        },
        "isRole": {
            "type": "boolean",
            "description": "If true, this is a role; otherwise, it is an individual user."
        },
        "displayName": {
            "type": "string",
            "description": "The role's name, or the user's given name and surname, as it should be displayed in an application."
        }
    },
    "description": "An object describing one of potentially several users or roles assigned to an issue.",
    "additionalProperties": false
}

{
    "type": "object",
    "required": [
        "storageFile"
    ],
    "properties": {
        "storageFile": {
            "type": "object",
            "required": [
                "fileId",
                "folderId"
            ],
            "properties": {
                "fileId": {
                    "type": "string",
                    "description": "ID used to identify the file in the Storage API."
                },
                "fileName": {
                    "type": "string",
                    "nullable": true,
                    "description": "Name of the file, including extension."
                },
                "folderId": {
                    "type": "string",
                    "description": "ID of the folder containing the file in the Storage API."
                }
            },
            "description": "The info about the file.",
            "additionalProperties": false
        }
    },
    "description": "Represents a file in Storage about which an issue was created.",
    "additionalProperties": false
}

{
    "type": "object",
    "title": "Detailed Error Response",
    "required": [
        "error"
    ],
    "properties": {
        "error": {
            "$ref": "#/components/schemas/DetailedError",
            "description": "Error Detailed information."
        }
    },
    "description": "Gives details for an error that occurred while handling the request. Note that clients MUST NOT assume that every failed request will produce an object of this schema, or that all of the properties in the response will be non-null, as the error may have prevented this response from being constructed.",
    "additionalProperties": false
}

{
    "type": "object",
    "required": [
        "folder",
        "file"
    ],
    "properties": {
        "file": {
            "$ref": "#/components/schemas/link"
        },
        "folder": {
            "$ref": "#/components/schemas/link"
        }
    },
    "description": "Links to retrieve the related file, and the folder that contains it, from the Storage API.",
    "additionalProperties": false
}

{
    "type": "object",
    "nullable": true,
    "required": [
        "iModelElement"
    ],
    "properties": {
        "iModelElement": {
            "type": "object",
            "required": [
                "modelId",
                "elementId",
                "changeSetId",
                "modelName"
            ],
            "properties": {
                "modelId": {
                    "type": "string",
                    "description": "ID of the iModel containing the element, as it exists in the iModels API."
                },
                "elementId": {
                    "type": "string",
                    "description": "ID of the element. Can be a hexadecimal numeric string (space-separated to include multiple elements) or a presentation key."
                },
                "modelName": {
                    "type": "string",
                    "description": "Name of the model."
                },
                "changeSetId": {
                    "type": "string",
                    "description": "ID of the changeset where the issue was created."
                }
            },
            "description": "The info about the element.",
            "additionalProperties": false
        }
    },
    "description": "Represents an element in an iModel about which an issue was created.",
    "additionalProperties": false
}

{
    "type": "object",
    "nullable": true,
    "required": [
        "iModel",
        "iModelChangeset"
    ],
    "properties": {
        "iModel": {
            "$ref": "#/components/schemas/link"
        },
        "iModelChangeset": {
            "$ref": "#/components/schemas/link"
        }
    },
    "description": "Links to retrieve the related element's specific changeset, or iModel in general, from the iModels API.",
    "additionalProperties": false
}