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

{
    "type": "object",
    "title": "Issue (get)",
    "description": "Contains the full data of this issue. Any property that was never set on the issue will be omitted from the response.",
    "properties": {
        "id": {
            "type": "string",
            "description": "Unique identifier for this instance. Read-only."
        },
        "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."
        },
        "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."
        },
        "subject": {
            "type": "string",
            "nullable": true,
            "description": "Brief title/description of the issue."
        },
        "description": {
            "type": "string",
            "nullable": true,
            "description": "Detailed description of the issue."
        },
        "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."
        },
        "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."
        },
        "dueDate": {
            "type": "string",
            "nullable": true,
            "format": "date-time",
            "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."
        },
        "status": {
            "type": "string",
            "description": "The current workflow status the issue is in right now."
        },
        "state": {
            "type": "string",
            "description": "Indicates whether the issue's status is an Open, Closed, or Draft status. This property is read-only."
        },
        "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."
        },
        "assignee": {
            "description": "The primary user or role assigned to this issue.",
            "$ref": "#/components/schemas/primary-assignee"
        },
        "assignees": {
            "type": "array",
            "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.",
            "items": {
                "$ref": "#/components/schemas/secondary-assignee"
            }
        },
        "createdBy": {
            "type": "string",
            "description": "The display name of the user who originally created this issue. Read-only."
        },
        "createdDateTime": {
            "type": "string",
            "format": "date-time",
            "description": "The date and time when this issue was originally created. Read-only."
        },
        "lastModifiedBy": {
            "type": "string",
            "description": "The display name of the user who most recently made a change to this issue. Read-only."
        },
        "lastModifiedDateTime": {
            "type": "string",
            "format": "date-time",
            "description": "The date and time when this issue was most recently edited. Read-only."
        },
        "sourceEntity": {
            "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.",
            "oneOf": [
                {
                    "$ref": "#/components/schemas/source-entity-file"
                },
                {
                    "$ref": "#/components/schemas/source-entity-i-model-element"
                }
            ]
        },
        "boundingBox": {
            "description": "Origin info. Describes a rectangular-prism area of the model that the issue pertains to.",
            "$ref": "#/components/schemas/bounding-box"
        },
        "modelPin": {
            "description": "Origin info. Describes a point in 3D space that the issue pertains to. May or may not be based on the position of a particular element.",
            "$ref": "#/components/schemas/model-pin"
        },
        "modelView": {
            "description": "Origin info. Describes a view of the model that shows the relevant elements that the issue pertains to.",
            "$ref": "#/components/schemas/model-view"
        },
        "modelEventDateTime": {
            "type": "string",
            "nullable": true,
            "format": "date-time",
            "description": "The date and time represented in the model where the issue occurred (if in a 4D model)."
        },
        "location": {
            "description": "Origin info. Describes the geographical coordinates the issue pertains to.",
            "$ref": "#/components/schemas/location"
        },
        "properties": {
            "description": "Contains all issue-type-specific and user-defined properties that were set on this issue.  Properties set here may be strings, numbers, booleans, arrays, or objects, depending on how the project's administrator defined them in the Form Designer.",
            "$ref": "#/components/schemas/dynamic-object"
        },
        "_links": {
            "description": "Links to related entities, if applicable.",
            "oneOf": [
                {
                    "$ref": "#/components/schemas/source-entity-links-file"
                },
                {
                    "$ref": "#/components/schemas/source-entity-links-i-model-element"
                }
            ]
        }
    },
    "additionalProperties": false
}

{
    "type": "object",
    "title": "Issue (update)",
    "description": "Provides new property values for properties that are being changed in the update. All properties are optional. Omitting a property will keep its current value intact.",
    "properties": {
        "subject": {
            "type": "string",
            "nullable": true,
            "description": "Brief title/description of the issue."
        },
        "description": {
            "type": "string",
            "nullable": true,
            "description": "Detailed description of the issue."
        },
        "dueDate": {
            "type": "string",
            "nullable": true,
            "format": "date-time",
            "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."
        },
        "status": {
            "type": "string",
            "nullable": true,
            "description": "The issue's new workflow status, if applicable."
        },
        "workflowNote": {
            "type": "string",
            "nullable": true,
            "description": "Text of a comment to associated with the status change. This property MUST NOT be set UNLESS the 'status' property is also set AND the workflow for the issue's type allows a workflow note to be added for transitions from the old status to the new status."
        },
        "assignee": {
            "description": "The primary user or role assigned to this issue.",
            "$ref": "#/components/schemas/primary-assignee"
        },
        "assignees": {
            "type": "array",
            "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.",
            "items": {
                "$ref": "#/components/schemas/secondary-assignee"
            }
        },
        "sourceEntity": {
            "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.",
            "oneOf": [
                {
                    "$ref": "#/components/schemas/source-entity-file"
                },
                {
                    "$ref": "#/components/schemas/source-entity-i-model-element"
                }
            ]
        },
        "boundingBox": {
            "description": "Origin info. Describes a rectangular-prism area of the model that the issue pertains to.",
            "$ref": "#/components/schemas/bounding-box"
        },
        "modelPin": {
            "description": "Origin info. Describes a point in 3D space that the issue pertains to. May or may not be based on the position of a particular element.",
            "$ref": "#/components/schemas/model-pin"
        },
        "modelView": {
            "description": "Origin info. Describes a view of the model that shows the relevant elements that the issue pertains to.",
            "$ref": "#/components/schemas/model-view"
        },
        "modelEventDateTime": {
            "type": "string",
            "nullable": true,
            "format": "date-time",
            "description": "The date and time represented in the model where the issue occurred (if in a 4D model)."
        },
        "location": {
            "description": "Origin info. Describes the geographical coordinates the issue pertains to.",
            "$ref": "#/components/schemas/location"
        },
        "properties": {
            "description": "Any custom properties that are defined in the Form Designer for issues of this issue's type may be set here. If this object is omitted or set to null, all custom properties will retain their current values.",
            "$ref": "#/components/schemas/dynamic-object"
        }
    },
    "additionalProperties": false
}

{
    "type": "object",
    "title": "Primary Assignee",
    "description": "An object describing the primary user or role assigned to an issue.",
    "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."
        }
    },
    "additionalProperties": false
}

{
    "type": "object",
    "title": "Secondary Assignee",
    "description": "An object describing one of potentially several users or roles assigned to an issue.",
    "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."
        },
        "isRole": {
            "type": "boolean",
            "description": "If true, this is a role; otherwise, it is an individual user."
        }
    },
    "additionalProperties": false
}

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

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

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

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

{
    "type": "object",
    "nullable": true,
    "properties": {
        "viewPoint": {
            "$ref": "#/components/schemas/point3D",
            "description": "The location of the camera within the model."
        },
        "direction": {
            "$ref": "#/components/schemas/point3D",
            "description": "Endpoint of a vector from the origin that determines the camera's facing direction."
        },
        "up": {
            "$ref": "#/components/schemas/point3D",
            "description": "Endpoint of a vector from the origin that determines which direction appears as upwards in the view."
        },
        "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."
        },
        "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."
        }
    },
    "additionalProperties": false
}

{
    "type": "object",
    "nullable": true,
    "description": "Origin info. The geographical location the issue pertains to.",
    "properties": {
        "latitude": {
            "type": "number",
            "nullable": true,
            "description": "The degrees latitude of the issue's location. North: positive, south: negative."
        },
        "longitude": {
            "type": "number",
            "nullable": true,
            "description": "The degrees longitude of the issues location. East: positive, west: 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."
        },
        "description": {
            "type": "string",
            "nullable": true,
            "description": "A string describing the significance of this location."
        }
    },
    "additionalProperties": false
}

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

{
    "type": "object",
    "nullable": true,
    "description": "Represents an element in an iModel about which an issue was created.",
    "properties": {
        "iModelElement": {
            "type": "object",
            "description": "The info about the element.",
            "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."
                },
                "changeSetId": {
                    "type": "string",
                    "description": "ID of the changeset where the issue was created."
                },
                "modelName": {
                    "type": "string",
                    "description": "Name of the model."
                }
            },
            "required": [
                "modelId",
                "elementId",
                "changeSetId",
                "modelName"
            ],
            "additionalProperties": false
        }
    },
    "required": [
        "iModelElement"
    ],
    "additionalProperties": false
}

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

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

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

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

{
    "type": "object",
    "title": "Detailed Error Response",
    "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.",
    "properties": {
        "error": {
            "description": "Error Detailed information.",
            "$ref": "#/components/schemas/DetailedError"
        }
    },
    "required": [
        "error"
    ],
    "additionalProperties": false
}

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

{
    "type": "object",
    "title": "Error Response",
    "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.",
    "properties": {
        "error": {
            "description": "Error information.",
            "$ref": "#/components/schemas/Error"
        }
    },
    "required": [
        "error"
    ],
    "additionalProperties": false
}