swagger: '2.0' info: title: Document description: TMF667 Document API describes the meta-data of a Document, such as the name, creationDate and lifecycle status. The (typically binary) body of this document (such as a Word.doc, PDF, Video clip, or Image) will be held in the associated Attachment(s) either by Ref or Value. If by value - the binary content is held in the Attachment.content. If by reference, the Attachment.url might point to a (file:) or remote (http:) pointer to the Document media.\n\n A Document may be associated with a DocumentSpecification, which will detail the characteristics of that type of Document (an Image may have a width, height and format; a Video may have a length and format).\n A Document has a collection of RelatedParty's, for roles such as author, reviewer, publisher, and a lifecycle status to take the document through a simple set of production stages. version: 4.0.0 host: omvpapi.ooredoo.mv basePath: /tmf-api/document/v1/ schemes: - https consumes: - application/json produces: - application/json;charset=utf-8 security: - Oauth: [] tags: - name: document - name: documentSpecification paths: /document: get: operationId: listDocument summary: List or find Document objects description: This operation list or find Document entities tags: - document parameters: - name: fields description: Comma-separated properties to be provided in response required: false in: query type: string - name: offset description: Requested index for start of resources to be provided in response required: false in: query type: integer - name: limit description: Requested number of resources to be provided in response required: false in: query type: integer - name: Accept required: true type: string in: header description: application/json - name: Content-Type required: true type: string in: header description: application/json - name: transactionId required: true type: string in: header description: abc123 responses: '200': description: Success headers: X-Result-Count: description: Actual number of items returned in the response body type: integer X-Total-Count: description: Total number of items matching criteria type: integer schema: type: array items: $ref: '#/definitions/Document' '400': description: Bad Request schema: $ref: '#/definitions/Error' '401': description: Unauthorized schema: $ref: '#/definitions/Error' '403': description: Forbidden schema: $ref: '#/definitions/Error' '404': description: Not Found schema: $ref: '#/definitions/Error' '405': description: Method Not allowed schema: $ref: '#/definitions/Error' '409': description: Conflict schema: $ref: '#/definitions/Error' '500': description: Internal Server Error schema: $ref: '#/definitions/Error' post: operationId: createDocument summary: Creates a Document description: This operation creates a Document entity. tags: - document parameters: - name: document description: The Document to be created required: true schema: $ref: '#/definitions/Document_Create' in: body - name: Accept required: true type: string in: header description: application/json - name: Content-Type required: true type: string in: header description: application/json - name: transactionId required: true type: string in: header description: abc123 responses: '201': description: Created schema: $ref: '#/definitions/Document' '400': description: Bad Request schema: $ref: '#/definitions/Error' '401': description: Unauthorized schema: $ref: '#/definitions/Error' '403': description: Forbidden schema: $ref: '#/definitions/Error' '405': description: Method Not allowed schema: $ref: '#/definitions/Error' '409': description: Conflict schema: $ref: '#/definitions/Error' '500': description: Internal Server Error schema: $ref: '#/definitions/Error' /document/{id}: get: operationId: retrieveDocument summary: Retrieves a Document by ID description: This operation retrieves a Document entity. Attribute selection is enabled for all first level attributes. tags: - document parameters: - name: id description: Identifier of the Document required: true type: string in: path - name: fields description: Comma-separated properties to provide in response required: false type: string in: query - name: Accept required: true type: string in: header description: application/json - name: Content-Type required: true type: string in: header description: application/json - name: transactionId required: true type: string in: header description: abc123 responses: '200': description: Success schema: $ref: '#/definitions/Document' '400': description: Bad Request schema: $ref: '#/definitions/Error' '401': description: Unauthorized schema: $ref: '#/definitions/Error' '403': description: Forbidden schema: $ref: '#/definitions/Error' '404': description: Not Found schema: $ref: '#/definitions/Error' '405': description: Method Not allowed schema: $ref: '#/definitions/Error' '409': description: Conflict schema: $ref: '#/definitions/Error' '500': description: Internal Server Error schema: $ref: '#/definitions/Error' patch: operationId: patchDocument summary: Updates partially a Document description: This operation updates partially a Document entity. tags: - document parameters: - name: id description: Identifier of the Document required: true type: string in: path - name: document description: The Document to be updated required: true schema: $ref: '#/definitions/Document_Update' in: body - name: Accept required: true type: string in: header description: application/json - name: Content-Type required: true type: string in: header description: application/json - name: transactionId required: true type: string in: header description: abc123 responses: '200': description: Updated schema: $ref: '#/definitions/Document' '400': description: Bad Request schema: $ref: '#/definitions/Error' '401': description: Unauthorized schema: $ref: '#/definitions/Error' '403': description: Forbidden schema: $ref: '#/definitions/Error' '404': description: Not Found schema: $ref: '#/definitions/Error' '405': description: Method Not allowed schema: $ref: '#/definitions/Error' '409': description: Conflict schema: $ref: '#/definitions/Error' '500': description: Internal Server Error schema: $ref: '#/definitions/Error' delete: operationId: deleteDocument summary: Deletes a Document description: This operation deletes a Document entity. tags: - document parameters: - name: id description: Identifier of the Document required: true type: string in: path - name: Accept required: true type: string in: header description: application/json - name: Content-Type required: true type: string in: header description: application/json - name: transactionId required: true type: string in: header description: abc123 responses: '204': description: Deleted '400': description: Bad Request schema: $ref: '#/definitions/Error' '401': description: Unauthorized schema: $ref: '#/definitions/Error' '403': description: Forbidden schema: $ref: '#/definitions/Error' '404': description: Not Found schema: $ref: '#/definitions/Error' '405': description: Method Not allowed schema: $ref: '#/definitions/Error' '409': description: Conflict schema: $ref: '#/definitions/Error' '500': description: Internal Server Error schema: $ref: '#/definitions/Error' /documentSpecification: get: operationId: listDocumentSpecification summary: List or find DocumentSpecification objects description: This operation list or find DocumentSpecification entities tags: - documentSpecification parameters: - name: fields description: Comma-separated properties to be provided in response required: false in: query type: string - name: offset description: Requested index for start of resources to be provided in response required: false in: query type: integer - name: limit description: Requested number of resources to be provided in response required: false in: query type: integer - name: Accept required: true type: string in: header description: application/json - name: Content-Type required: true type: string in: header description: application/json - name: transactionId required: true type: string in: header description: abc123 responses: '200': description: Success headers: X-Result-Count: description: Actual number of items returned in the response body type: integer X-Total-Count: description: Total number of items matching criteria type: integer schema: type: array items: $ref: '#/definitions/DocumentSpecification' '400': description: Bad Request schema: $ref: '#/definitions/Error' '401': description: Unauthorized schema: $ref: '#/definitions/Error' '403': description: Forbidden schema: $ref: '#/definitions/Error' '404': description: Not Found schema: $ref: '#/definitions/Error' '405': description: Method Not allowed schema: $ref: '#/definitions/Error' '409': description: Conflict schema: $ref: '#/definitions/Error' '500': description: Internal Server Error schema: $ref: '#/definitions/Error' post: operationId: createDocumentSpecification summary: Creates a DocumentSpecification description: This operation creates a DocumentSpecification entity. tags: - documentSpecification parameters: - name: documentSpecification description: The DocumentSpecification to be created required: true schema: $ref: '#/definitions/DocumentSpecification_Create' in: body - name: Accept required: true type: string in: header description: application/json - name: Content-Type required: true type: string in: header description: application/json - name: transactionId required: true type: string in: header description: abc123 responses: '201': description: Created schema: $ref: '#/definitions/DocumentSpecification' '400': description: Bad Request schema: $ref: '#/definitions/Error' '401': description: Unauthorized schema: $ref: '#/definitions/Error' '403': description: Forbidden schema: $ref: '#/definitions/Error' '405': description: Method Not allowed schema: $ref: '#/definitions/Error' '409': description: Conflict schema: $ref: '#/definitions/Error' '500': description: Internal Server Error schema: $ref: '#/definitions/Error' /documentSpecification/{id}: get: operationId: retrieveDocumentSpecification summary: Retrieves a DocumentSpecification by ID description: This operation retrieves a DocumentSpecification entity. Attribute selection is enabled for all first level attributes. tags: - documentSpecification parameters: - name: id description: Identifier of the DocumentSpecification required: true type: string in: path - name: fields description: Comma-separated properties to provide in response required: false type: string in: query - name: Accept required: true type: string in: header description: application/json - name: Content-Type required: true type: string in: header description: application/json - name: transactionId required: true type: string in: header description: abc123 responses: '200': description: Success schema: $ref: '#/definitions/DocumentSpecification' '400': description: Bad Request schema: $ref: '#/definitions/Error' '401': description: Unauthorized schema: $ref: '#/definitions/Error' '403': description: Forbidden schema: $ref: '#/definitions/Error' '404': description: Not Found schema: $ref: '#/definitions/Error' '405': description: Method Not allowed schema: $ref: '#/definitions/Error' '409': description: Conflict schema: $ref: '#/definitions/Error' '500': description: Internal Server Error schema: $ref: '#/definitions/Error' patch: operationId: patchDocumentSpecification summary: Updates partially a DocumentSpecification description: This operation updates partially a DocumentSpecification entity. tags: - documentSpecification parameters: - name: id description: Identifier of the DocumentSpecification required: true type: string in: path - name: documentSpecification description: The DocumentSpecification to be updated required: true schema: $ref: '#/definitions/DocumentSpecification_Update' in: body - name: Accept required: true type: string in: header description: application/json - name: Content-Type required: true type: string in: header description: application/json - name: transactionId required: true type: string in: header description: abc123 responses: '200': description: Updated schema: $ref: '#/definitions/DocumentSpecification' '400': description: Bad Request schema: $ref: '#/definitions/Error' '401': description: Unauthorized schema: $ref: '#/definitions/Error' '403': description: Forbidden schema: $ref: '#/definitions/Error' '404': description: Not Found schema: $ref: '#/definitions/Error' '405': description: Method Not allowed schema: $ref: '#/definitions/Error' '409': description: Conflict schema: $ref: '#/definitions/Error' '500': description: Internal Server Error schema: $ref: '#/definitions/Error' delete: operationId: deleteDocumentSpecification summary: Deletes a DocumentSpecification description: This operation deletes a DocumentSpecification entity. tags: - documentSpecification parameters: - name: id description: Identifier of the DocumentSpecification required: true type: string in: path - name: Accept required: true type: string in: header description: application/json - name: Content-Type required: true type: string in: header description: application/json - name: transactionId required: true type: string in: header description: abc123 responses: '204': description: Deleted '400': description: Bad Request schema: $ref: '#/definitions/Error' '401': description: Unauthorized schema: $ref: '#/definitions/Error' '403': description: Forbidden schema: $ref: '#/definitions/Error' '404': description: Not Found schema: $ref: '#/definitions/Error' '405': description: Method Not allowed schema: $ref: '#/definitions/Error' '409': description: Conflict schema: $ref: '#/definitions/Error' '500': description: Internal Server Error schema: $ref: '#/definitions/Error' securityDefinitions: Oauth: type: "oauth2" tokenUrl: "https://omvpapi.ooredoo.mv/tmf-api/oauth/token" flow: "application" definitions: Addressable: type: object description: Base schema for adressable entities properties: id: type: string description: unique identifier href: type: string format: uri description: Hyperlink reference Any: {} AssociationSpecificationRef: type: object description: reference to an AssociationSpecification object properties: id: type: string description: unique identifier href: type: string format: uri description: Hyperlink reference name: type: string description: Name of the related entity. '@baseType': type: string description: When sub-classing, this defines the super-class '@schemaLocation': type: string format: uri description: A URI to a JSON-Schema file that defines additional attributes and relationships '@type': type: string description: When sub-classing, this defines the sub-class Extensible name '@referredType': type: string description: The actual type of the target instance when needed for disambiguation. required: - id Attachment: type: object description: Complements the description of an element (for instance a product) through video, pictures... properties: id: example: 4aafacbd-11ff-4dc8-b445-305f2215715f type: string description: Unique identifier for this particular attachment href: example: http://host/Attachment/4aafacbd-11ff-4dc8-b445-305f2215715f type: string format: uri description: URI for this Attachment attachmentType: example: video type: string description: Attachment type such as video, picture content: type: string format: base64 description: The actual contents of the attachment object, if embedded, encoded as base64 description: example: Photograph of the Product type: string description: A narrative text describing the content of the attachment mimeType: example: video/mp4 type: string description: Attachment mime type such as extension file for video, picture and document name: example: iPhone 14 video type: string description: The name of the attachment url: example: http://host/Content/4aafacbd-11ff-4dc8-b445-305f2215715f type: string format: uri description: Remote reference to the content if web-addressable size: $ref: '#/definitions/Quantity' description: The size of the attachment validFor: $ref: '#/definitions/TimePeriod' description: The period of time for which the attachment is valid '@baseType': type: string description: When sub-classing, this defines the super-class '@schemaLocation': type: string format: uri description: A URI to a JSON-Schema file that defines additional attributes and relationships '@type': type: string description: When sub-classing, this defines the sub-class Extensible name AttachmentRef: type: object description: Attachment reference. An attachment complements the description of an element (for instance a product) through video, pictures properties: id: type: string description: Unique-Identifier for this attachment href: type: string format: uri description: URL serving as reference for the attachment resource description: type: string description: A narrative text describing the content of the attachment name: type: string description: Name of the related entity. url: type: string format: uri description: Link to the attachment media/content '@baseType': type: string description: When sub-classing, this defines the super-class '@schemaLocation': type: string format: uri description: A URI to a JSON-Schema file that defines additional attributes and relationships '@type': type: string description: When sub-classing, this defines the sub-class Extensible name '@referredType': type: string description: The actual type of the target instance when needed for disambiguation. required: - id AttachmentRefOrValue: type: object description: An attachment by value or by reference. An attachment complements the description of an element, for example through a document, a video, a picture. properties: id: example: 4aafacbd-11ff-4dc8-b445-305f2215715f type: string description: Unique identifier for this particular attachment href: example: http://host/Attachment/4aafacbd-11ff-4dc8-b445-305f2215715f type: string format: uri description: URI for this Attachment attachmentType: example: video type: string description: Attachment type such as video, picture content: type: string format: base64 description: The actual contents of the attachment object, if embedded, encoded as base64 description: example: Photograph of the Product type: string description: A narrative text describing the content of the attachment mimeType: example: video/mp4 type: string description: Attachment mime type such as extension file for video, picture and document name: example: iPhone 14 video type: string description: The name of the attachment url: example: http://host/Content/4aafacbd-11ff-4dc8-b445-305f2215715f type: string format: uri description: Remote reference to the content if web-addressable size: $ref: '#/definitions/Quantity' description: The size of the attachment validFor: $ref: '#/definitions/TimePeriod' description: The period of time for which the attachment is valid '@baseType': type: string description: When sub-classing, this defines the super-class '@schemaLocation': type: string format: uri description: A URI to a JSON-Schema file that defines additional attributes and relationships '@type': type: string description: When sub-classing, this defines the sub-class Extensible name '@referredType': type: string description: The actual type of the target instance when needed for disambiguation. CategoryRef: type: object description: The category for grouping recommendations properties: id: type: string description: unique identifier href: type: string format: uri description: Hyperlink reference name: type: string description: Name of the related entity. version: type: string description: Category version '@baseType': type: string description: When sub-classing, this defines the super-class '@schemaLocation': type: string format: uri description: A URI to a JSON-Schema file that defines additional attributes and relationships '@type': type: string description: When sub-classing, this defines the sub-class Extensible name '@referredType': type: string description: The actual type of the target instance when needed for disambiguation. required: - id Characteristic: type: object description: Describes a given characteristic of an object or entity through a name/value pair. required: - name - value properties: id: type: string description: Unique identifier of the characteristic name: type: string description: Name of the characteristic valueType: type: string description: Data type of the value of the characteristic characteristicRelationship: type: array items: $ref: '#/definitions/CharacteristicRelationship' value: $ref: '#/definitions/Any' description: The value of the characteristic '@baseType': type: string description: When sub-classing, this defines the super-class '@schemaLocation': type: string format: uri description: A URI to a JSON-Schema file that defines additional attributes and relationships '@type': type: string description: When sub-classing, this defines the sub-class Extensible name CharacteristicRelationship: type: object description: Another Characteristic that is related to the current Characteristic; properties: id: type: string description: Unique identifier of the characteristic href: type: string format: uri description: Hyperlink reference relationshipType: type: string description: The type of relationship '@baseType': type: string description: When sub-classing, this defines the super-class '@schemaLocation': type: string format: uri description: A URI to a JSON-Schema file that defines additional attributes and relationships '@type': type: string description: When sub-classing, this defines the sub-class Extensible name CharacteristicSpecification: type: object description: This class defines a characteristic specification. properties: id: type: string description: Unique ID for the characteristic configurable: type: boolean description: If true, the Boolean indicates that the target Characteristic is configurable description: type: string description: A narrative that explains the CharacteristicSpecification. extensible: type: boolean description: An indicator that specifies that the values for the characteristic can be extended by adding new values when instantiating a characteristic for a resource. isUnique: type: boolean description: Specifies if the value of this characteristic is unique across all entities instantiated from the specification that uses this characteristc. For example, consider a ProductSpecification for a set-top box, with a CharacteristicSpecification cardID. Each set-top box must have a different value for cardID, so this isUnique attribute would be set to true for the characteristic. maxCardinality: type: integer description: The maximum number of instances a CharacteristicValue can take on. For example, zero to five phone numbers in a group calling plan, where five is the value for the maxCardinality. minCardinality: type: integer description: The minimum number of instances a CharacteristicValue can take on. For example, zero to five phone numbers in a group calling plan, where zero is the value for the minCardinality. name: type: string description: A word, term, or phrase by which this characteristic specification is known and distinguished from other characteristic specifications. regex: type: string description: A rule or principle represented in regular expression used to derive the value of a characteristic value. valueType: type: string description: A kind of value that the characteristic can take on, such as numeric, text and so forth charSpecRelationship: type: array items: $ref: '#/definitions/CharacteristicSpecificationRelationship' description: An aggregation, migration, substitution, dependency or exclusivity relationship between/among Specification Characteristics. characteristicValueSpecification: type: array items: $ref: '#/definitions/CharacteristicValueSpecification' description: A CharacteristicValueSpecification object is used to define a set of attributes, each of which can be assigned to a corresponding set of attributes in a CharacteristicSpecification object. The values of the attributes in the CharacteristicValueSpecification object describe the values of the attributes that a corresponding Characteristic object can take on. validFor: $ref: '#/definitions/TimePeriod' description: The period of time for which a characteristic is applicable. '@baseType': type: string description: When sub-classing, this defines the super-class '@schemaLocation': type: string format: uri description: A URI to a JSON-Schema file that defines additional attributes and relationships '@type': type: string description: When sub-classing, this defines the sub-class Extensible name '@valueSchemaLocation': type: string description: This (optional) field provides a link to the schema describing the value type. CharacteristicSpecificationBase: type: object description: This class defines a characteristic specification. properties: id: type: string description: Unique ID for the characteristic configurable: type: boolean description: If true, the Boolean indicates that the target Characteristic is configurable description: type: string description: A narrative that explains the CharacteristicSpecification. extensible: type: boolean description: An indicator that specifies that the values for the characteristic can be extended by adding new values when instantiating a characteristic for a resource. isUnique: type: boolean description: Specifies if the value of this characteristic is unique across all entities instantiated from the specification that uses this characteristc. For example, consider a ProductSpecification for a set-top box, with a CharacteristicSpecification cardID. Each set-top box must have a different value for cardID, so this isUnique attribute would be set to true for the characteristic. maxCardinality: type: integer description: The maximum number of instances a CharacteristicValue can take on. For example, zero to five phone numbers in a group calling plan, where five is the value for the maxCardinality. minCardinality: type: integer description: The minimum number of instances a CharacteristicValue can take on. For example, zero to five phone numbers in a group calling plan, where zero is the value for the minCardinality. name: type: string description: A word, term, or phrase by which this characteristic specification is known and distinguished from other characteristic specifications. regex: type: string description: A rule or principle represented in regular expression used to derive the value of a characteristic value. valueType: type: string description: A kind of value that the characteristic can take on, such as numeric, text and so forth validFor: $ref: '#/definitions/TimePeriod' description: The period of time for which a characteristic is applicable. '@baseType': type: string description: When sub-classing, this defines the super-class '@schemaLocation': type: string format: uri description: A URI to a JSON-Schema file that defines additional attributes and relationships '@type': type: string description: When sub-classing, this defines the sub-class Extensible name '@valueSchemaLocation': type: string description: This (optional) field provides a link to the schema describing the value type. CharacteristicSpecificationRelationship: type: object description: An aggregation, migration, substitution, dependency or exclusivity relationship between/among Characteristic specifications. The specification characteristic is embedded within the specification whose ID and href are in this entity, and identified by its ID. properties: characteristicSpecificationId: type: string description: Unique identifier of the characteristic within the specification name: type: string description: Name of the target characteristic within the specification parentSpecificationHref: type: string format: uri description: Hyperlink reference to the parent specification containing the target characteristic parentSpecificationId: type: string description: Unique identifier of the parent specification containing the target characteristic relationshipType: type: string description: Type of relationship such as aggregation, migration, substitution, dependency, exclusivity validFor: $ref: '#/definitions/TimePeriod' description: The period for which the object is valid '@baseType': type: string description: When sub-classing, this defines the super-class '@schemaLocation': type: string format: uri description: A URI to a JSON-Schema file that defines additional attributes and relationships '@type': type: string description: When sub-classing, this defines the sub-class Extensible name CharacteristicValueSpecification: type: object description: specification of a value (number or text or an object) that can be assigned to a Characteristic. properties: isDefault: type: boolean description: If true, the Boolean Indicates if the value is the default value for a characteristic rangeInterval: type: string description: An indicator that specifies the inclusion or exclusion of the valueFrom and valueTo attributes. If applicable, possible values are "open", "closed", "closedBottom" and "closedTop". regex: type: string description: A regular expression constraint for given value unitOfMeasure: type: string description: A length, surface, volume, dry measure, liquid measure, money, weight, time, and the like. In general, a determinate quantity or magnitude of the kind designated, taken as a standard of comparison for others of the same kind, in assigning to them numerical values, as 1 foot, 1 yard, 1 mile, 1 square foot. valueFrom: type: integer description: The low range value that a characteristic can take on valueTo: type: integer description: The upper range value that a characteristic can take on valueType: type: string description: A kind of value that the characteristic value can take on, such as numeric, text and so forth validFor: $ref: '#/definitions/TimePeriod' description: The period of time for which a value is applicable. value: $ref: '#/definitions/Any' description: A discrete value that the characteristic can take on, or the actual value of the characteristic '@baseType': type: string description: When sub-classing, this defines the super-class '@schemaLocation': type: string format: uri description: A URI to a JSON-Schema file that defines additional attributes and relationships '@type': type: string description: When sub-classing, this defines the sub-class Extensible name ConstraintRef: type: object description: Constraint reference. The Constraint resource represents a policy/rule applied to an entity or entity spec. properties: id: type: string description: unique identifier href: type: string format: uri description: Hyperlink reference name: type: string description: Name of the related entity. version: type: string description: constraint version '@baseType': type: string description: When sub-classing, this defines the super-class '@schemaLocation': type: string format: uri description: A URI to a JSON-Schema file that defines additional attributes and relationships '@type': type: string description: When sub-classing, this defines the sub-class Extensible name '@referredType': type: string description: The actual type of the target instance when needed for disambiguation. required: - id Document: type: object description: |- A Document describes the meta-data of a Document - such as the name, creationDate and lifecycle status. The (typically binary) body of this document (such as a Word.doc, PDF, Video clip, or Image) will be held in the associated Attachment(s) either by Ref or Value. If by value - the binary content is held in the Attachment.content. If by reference, the Attachment.url might point to a (file:) or remote (http:) pointer to the Document media. A Document may be associated with a DocumentSpecification, which will detail the characteristics of that type of Document (an Image may have a width, height and format; a Video may have a length and format). A Document has a collection of RelatedParty's, for roles such as author, reviewer, publisher; and a lifecycle status to take the document through a simple set of production stages. properties: id: type: string description: unique identifier href: type: string format: uri description: Hyperlink reference creationDate: type: string format: date-time description: The date and time the document was created. A date and time formatted in compliance with the ISO8601 standard must be used. description: type: string description: free-text description of the document documentType: type: string description: Name of the document type lastUpdate: type: string format: date-time description: The date and time the document was last modified. A date and time formatted in compliance with the ISO8601 standard must be used. name: type: string description: A string used to give a name to the document version: type: string description: A particular form or variety of an artefact that is different from others or from the original. The form represents differences in properties that characterize an artefact, that are not enough to warrant creating a new artefact attachment: type: array items: $ref: '#/definitions/AttachmentRefOrValue' category: type: array items: $ref: '#/definitions/CategoryRef' characteristic: type: array items: $ref: '#/definitions/Characteristic' document: type: array items: $ref: '#/definitions/DocumentRef' documentSpecification: $ref: '#/definitions/DocumentSpecificationRefOrValue' externalIdentifier: type: array items: $ref: '#/definitions/ExternalIdentifier' relatedEntity: type: array items: $ref: '#/definitions/RelatedEntity' relatedParty: type: array items: $ref: '#/definitions/RelatedParty' status: $ref: '#/definitions/DocumentStatusType' description: The life cycle state of the document '@baseType': type: string description: When sub-classing, this defines the super-class '@schemaLocation': type: string format: uri description: A URI to a JSON-Schema file that defines additional attributes and relationships '@type': type: string description: When sub-classing, this defines the sub-class Extensible name Document_Create: type: object description: |- A Document describes the meta-data of a Document - such as the name, creationDate and lifecycle status. The (typically binary) body of this document (such as a Word.doc, PDF, Video clip, or Image) will be held in the associated Attachment(s) either by Ref or Value. If by value - the binary content is held in the Attachment.content. If by reference, the Attachment.url might point to a (file:) or remote (http:) pointer to the Document media. A Document may be associated with a DocumentSpecification, which will detail the characteristics of that type of Document (an Image may have a width, height and format; a Video may have a length and format). A Document has a collection of RelatedParty's, for roles such as author, reviewer, publisher; and a lifecycle status to take the document through a simple set of production stages. Skipped properties: id,href required: - name properties: creationDate: type: string format: date-time description: The date and time the document was created. A date and time formatted in compliance with the ISO8601 standard must be used. description: type: string description: free-text description of the document documentType: type: string description: Name of the document type lastUpdate: type: string format: date-time description: The date and time the document was last modified. A date and time formatted in compliance with the ISO8601 standard must be used. name: type: string description: A string used to give a name to the document version: type: string description: A particular form or variety of an artefact that is different from others or from the original. The form represents differences in properties that characterize an artefact, that are not enough to warrant creating a new artefact attachment: type: array items: $ref: '#/definitions/AttachmentRefOrValue' category: type: array items: $ref: '#/definitions/CategoryRef' characteristic: type: array items: $ref: '#/definitions/Characteristic' document: type: array items: $ref: '#/definitions/DocumentRef' documentSpecification: $ref: '#/definitions/DocumentSpecificationRefOrValue' externalIdentifier: type: array items: $ref: '#/definitions/ExternalIdentifier' relatedEntity: type: array items: $ref: '#/definitions/RelatedEntity' relatedParty: type: array items: $ref: '#/definitions/RelatedParty' status: $ref: '#/definitions/DocumentStatusType' description: The life cycle state of the document '@baseType': type: string description: When sub-classing, this defines the super-class '@schemaLocation': type: string format: uri description: A URI to a JSON-Schema file that defines additional attributes and relationships '@type': type: string description: When sub-classing, this defines the sub-class Extensible name Document_Update: type: object description: |- A Document describes the meta-data of a Document - such as the name, creationDate and lifecycle status. The (typically binary) body of this document (such as a Word.doc, PDF, Video clip, or Image) will be held in the associated Attachment(s) either by Ref or Value. If by value - the binary content is held in the Attachment.content. If by reference, the Attachment.url might point to a (file:) or remote (http:) pointer to the Document media. A Document may be associated with a DocumentSpecification, which will detail the characteristics of that type of Document (an Image may have a width, height and format; a Video may have a length and format). A Document has a collection of RelatedParty's, for roles such as author, reviewer, publisher; and a lifecycle status to take the document through a simple set of production stages. Skipped properties: id,href,@type,@baseType,@schemaLocation properties: creationDate: type: string format: date-time description: The date and time the document was created. A date and time formatted in compliance with the ISO8601 standard must be used. description: type: string description: free-text description of the document documentType: type: string description: Name of the document type lastUpdate: type: string format: date-time description: The date and time the document was last modified. A date and time formatted in compliance with the ISO8601 standard must be used. name: type: string description: A string used to give a name to the document version: type: string description: A particular form or variety of an artefact that is different from others or from the original. The form represents differences in properties that characterize an artefact, that are not enough to warrant creating a new artefact attachment: type: array items: $ref: '#/definitions/AttachmentRefOrValue' category: type: array items: $ref: '#/definitions/CategoryRef' characteristic: type: array items: $ref: '#/definitions/Characteristic' document: type: array items: $ref: '#/definitions/DocumentRef' documentSpecification: $ref: '#/definitions/DocumentSpecificationRefOrValue' externalIdentifier: type: array items: $ref: '#/definitions/ExternalIdentifier' relatedEntity: type: array items: $ref: '#/definitions/RelatedEntity' relatedParty: type: array items: $ref: '#/definitions/RelatedParty' status: $ref: '#/definitions/DocumentStatusType' description: The life cycle state of the document DocumentRef: type: object properties: id: type: string description: Identifier of the document href: type: string description: The URI for the object itself. name: type: string description: Name of the related entity. '@baseType': type: string description: When sub-classing, this defines the super-class '@schemaLocation': type: string format: uri description: A URI to a JSON-Schema file that defines additional attributes and relationships '@type': type: string description: When sub-classing, this defines the sub-class Extensible name '@referredType': type: string description: The actual type of the target instance when needed for disambiguation. required: - id DocumentSpecification: type: object description: 'A DocumentSpecification provides the characteristics and constraints that describe a particular type of Document. It follows the EntitySpecification pattern, so allows you to define the characteristics expected, as well as the nature of the values of those characteristics (eg: integer range [valueFrom/valueTo], regular expression or unitOfMeasure).' properties: id: type: string description: unique identifier href: type: string format: uri description: Hyperlink reference description: type: string description: Description of the specification isBundle: type: boolean description: isBundle determines whether specification represents a single specification (false), or a bundle of specifications (true). lastUpdate: type: string format: date-time description: Date and time of the last update of the specification name: example: Image Specification type: string description: The name of the DocumentSpecification version: example: 1.0.0 type: string description: The version of the DocumentSpecification attachment: type: array items: $ref: '#/definitions/AttachmentRefOrValue' description: Attachments that may be of relevance to this specification, such as picture, document, media constraint: type: array items: $ref: '#/definitions/ConstraintRef' description: This is a list of constraint references applied to this specification entitySpecRelationship: type: array items: $ref: '#/definitions/EntitySpecificationRelationship' description: Relationship to another specification lifecycleStatus: example: approved $ref: '#/definitions/DocumentSpecificationStatusType' description: The current lifecycle status of this DocumentSpecification relatedParty: type: array items: $ref: '#/definitions/RelatedParty' description: Parties who manage or otherwise have an interest in this specification specCharacteristic: type: array items: $ref: '#/definitions/CharacteristicSpecification' description: List of characteristics that the entity can take targetEntitySchema: $ref: '#/definitions/TargetEntitySchema' description: Pointer to a schema that defines the target entity validFor: $ref: '#/definitions/TimePeriod' description: The period for which this REST resource is valid '@baseType': type: string description: When sub-classing, this defines the super-class '@schemaLocation': type: string format: uri description: A URI to a JSON-Schema file that defines additional attributes and relationships '@type': type: string description: When sub-classing, this defines the sub-class Extensible name DocumentSpecification_Create: type: object description: |- A DocumentSpecification provides the characteristics and constraints that describe a particular type of Document. It follows the EntitySpecification pattern, so allows you to define the characteristics expected, as well as the nature of the values of those characteristics (eg: integer range [valueFrom/valueTo], regular expression or unitOfMeasure). Skipped properties: id,href required: - name properties: description: type: string description: Description of the specification isBundle: type: boolean description: isBundle determines whether specification represents a single specification (false), or a bundle of specifications (true). lastUpdate: type: string format: date-time description: Date and time of the last update of the specification name: example: Image Specification type: string description: The name of the DocumentSpecification version: example: 1.0.0 type: string description: The version of the DocumentSpecification attachment: type: array items: $ref: '#/definitions/AttachmentRefOrValue' description: Attachments that may be of relevance to this specification, such as picture, document, media constraint: type: array items: $ref: '#/definitions/ConstraintRef' description: This is a list of constraint references applied to this specification entitySpecRelationship: type: array items: $ref: '#/definitions/EntitySpecificationRelationship' description: Relationship to another specification lifecycleStatus: example: approved $ref: '#/definitions/DocumentSpecificationStatusType' description: The current lifecycle status of this DocumentSpecification relatedParty: type: array items: $ref: '#/definitions/RelatedParty' description: Parties who manage or otherwise have an interest in this specification specCharacteristic: type: array items: $ref: '#/definitions/CharacteristicSpecification' description: List of characteristics that the entity can take targetEntitySchema: $ref: '#/definitions/TargetEntitySchema' description: Pointer to a schema that defines the target entity validFor: $ref: '#/definitions/TimePeriod' description: The period for which this REST resource is valid '@baseType': type: string description: When sub-classing, this defines the super-class '@schemaLocation': type: string format: uri description: A URI to a JSON-Schema file that defines additional attributes and relationships '@type': type: string description: When sub-classing, this defines the sub-class Extensible name DocumentSpecification_Update: type: object description: |- A DocumentSpecification provides the characteristics and constraints that describe a particular type of Document. It follows the EntitySpecification pattern, so allows you to define the characteristics expected, as well as the nature of the values of those characteristics (eg: integer range [valueFrom/valueTo], regular expression or unitOfMeasure). Skipped properties: id,href,@type,@baseType,@schemaLocation properties: description: type: string description: Description of the specification isBundle: type: boolean description: isBundle determines whether specification represents a single specification (false), or a bundle of specifications (true). lastUpdate: type: string format: date-time description: Date and time of the last update of the specification name: example: Image Specification type: string description: The name of the DocumentSpecification version: example: 1.0.0 type: string description: The version of the DocumentSpecification attachment: type: array items: $ref: '#/definitions/AttachmentRefOrValue' description: Attachments that may be of relevance to this specification, such as picture, document, media constraint: type: array items: $ref: '#/definitions/ConstraintRef' description: This is a list of constraint references applied to this specification entitySpecRelationship: type: array items: $ref: '#/definitions/EntitySpecificationRelationship' description: Relationship to another specification lifecycleStatus: example: approved $ref: '#/definitions/DocumentSpecificationStatusType' description: The current lifecycle status of this DocumentSpecification relatedParty: type: array items: $ref: '#/definitions/RelatedParty' description: Parties who manage or otherwise have an interest in this specification specCharacteristic: type: array items: $ref: '#/definitions/CharacteristicSpecification' description: List of characteristics that the entity can take targetEntitySchema: $ref: '#/definitions/TargetEntitySchema' description: Pointer to a schema that defines the target entity validFor: $ref: '#/definitions/TimePeriod' description: The period for which this REST resource is valid DocumentSpecificationRef: type: object description: A DocumentSpecificationRef provides a reference to a DocumentSpefication properties: id: type: string description: unique identifier href: type: string format: uri description: Hyperlink reference name: type: string description: Name of the related entity. '@baseType': type: string description: When sub-classing, this defines the super-class '@schemaLocation': type: string format: uri description: A URI to a JSON-Schema file that defines additional attributes and relationships '@type': type: string description: When sub-classing, this defines the sub-class Extensible name '@referredType': type: string description: The actual type of the target instance when needed for disambiguation. required: - id DocumentSpecificationRefOrValue: type: object description: A DocumentSpecificationRefOrValue where you can select between a DocumentSpecification (by Value) or a DocumentSpecificationRef (by Reference) properties: id: type: string description: unique identifier href: type: string format: uri description: Hyperlink reference description: type: string description: Description of the specification isBundle: type: boolean description: isBundle determines whether specification represents a single specification (false), or a bundle of specifications (true). lastUpdate: type: string format: date-time description: Date and time of the last update of the specification name: type: string description: Name given to the specification version: type: string description: specification version attachment: type: array items: $ref: '#/definitions/AttachmentRefOrValue' description: Attachments that may be of relevance to this specification, such as picture, document, media constraint: type: array items: $ref: '#/definitions/ConstraintRef' description: This is a list of constraint references applied to this specification entitySpecRelationship: type: array items: $ref: '#/definitions/EntitySpecificationRelationship' description: Relationship to another specification lifecycleStatus: example: approved $ref: '#/definitions/DocumentSpecificationStatusType' description: The current lifecycle status of this DocumentSpecification relatedParty: type: array items: $ref: '#/definitions/RelatedParty' description: Parties who manage or otherwise have an interest in this specification specCharacteristic: type: array items: $ref: '#/definitions/CharacteristicSpecification' description: List of characteristics that the entity can take targetEntitySchema: $ref: '#/definitions/TargetEntitySchema' description: Pointer to a schema that defines the target entity validFor: $ref: '#/definitions/TimePeriod' description: The period for which this REST resource is valid '@baseType': type: string description: When sub-classing, this defines the super-class '@schemaLocation': type: string format: uri description: A URI to a JSON-Schema file that defines additional attributes and relationships '@type': type: string description: When sub-classing, this defines the sub-class Extensible name '@referredType': type: string description: The actual type of the target instance when needed for disambiguation. DocumentSpecificationStatusType: type: string description: Possible values for the status of a DocumentSpecification enum: - created - reviewed - approved - published - archived - deleted DocumentStatusType: type: string description: Possible values for the status of a Document enum: - created - reviewed - approved - published - archived - deleted Entity: type: object description: Base entity schema for use in TMForum Open-APIs properties: id: type: string description: unique identifier href: type: string format: uri description: Hyperlink reference '@baseType': type: string description: When sub-classing, this defines the super-class '@schemaLocation': type: string format: uri description: A URI to a JSON-Schema file that defines additional attributes and relationships '@type': type: string description: When sub-classing, this defines the sub-class Extensible name EntityRef: type: object description: Entity reference schema to be use for all entityRef class. properties: id: type: string description: unique identifier href: type: string format: uri description: Hyperlink reference name: type: string description: Name of the related entity. '@baseType': type: string description: When sub-classing, this defines the super-class '@schemaLocation': type: string format: uri description: A URI to a JSON-Schema file that defines additional attributes and relationships '@type': type: string description: When sub-classing, this defines the sub-class Extensible name '@referredType': type: string description: The actual type of the target instance when needed for disambiguation. required: - id EntitySpecification: type: object description: |- EntitySpecification is a class that offers characteristics to describe a type of entity. Entities are generic constructs that may be used to describe bespoke business entities that are not effectively covered by the existing SID model. Functionally, the entity specification acts as a template by which entities may be instantiated and described. By sharing the same specification, these entities would therefore share the same set of characteristics. Note: The ‘configurable’ attribute on the specCharacteristics determines if an entity instantiated from the entity specification can override the value of the attribute. When set to false, the entity instance may not define a value that differs from the value in the specification. properties: id: type: string description: unique identifier href: type: string format: uri description: Hyperlink reference description: type: string description: Description of the specification isBundle: type: boolean description: isBundle determines whether specification represents a single specification (false), or a bundle of specifications (true). lastUpdate: type: string format: date-time description: Date and time of the last update of the specification lifecycleStatus: type: string description: Used to indicate the current lifecycle status of this catalog item name: type: string description: Name given to the specification version: type: string description: specification version attachment: type: array items: $ref: '#/definitions/AttachmentRefOrValue' description: Attachments that may be of relevance to this specification, such as picture, document, media constraint: type: array items: $ref: '#/definitions/ConstraintRef' description: This is a list of constraint references applied to this specification entitySpecRelationship: type: array items: $ref: '#/definitions/EntitySpecificationRelationship' description: Relationship to another specification relatedParty: type: array items: $ref: '#/definitions/RelatedParty' description: Parties who manage or otherwise have an interest in this specification specCharacteristic: type: array items: $ref: '#/definitions/CharacteristicSpecification' description: List of characteristics that the entity can take targetEntitySchema: $ref: '#/definitions/TargetEntitySchema' description: Pointer to a schema that defines the target entity validFor: $ref: '#/definitions/TimePeriod' description: The period for which this REST resource is valid '@baseType': type: string description: When sub-classing, this defines the super-class '@schemaLocation': type: string format: uri description: A URI to a JSON-Schema file that defines additional attributes and relationships '@type': type: string description: When sub-classing, this defines the sub-class Extensible name EntitySpecificationRelationship: type: object description: A migration, substitution, dependency or exclusivity relationship between/among entity specifications. required: - id - relationshipType properties: id: type: string description: unique identifier href: type: string format: uri description: Hyperlink reference name: type: string description: Name of the related entity. relationshipType: type: string description: Type of relationship such as migration, substitution, dependency, exclusivity role: type: string description: The association role for this entity specification associationSpec: $ref: '#/definitions/AssociationSpecificationRef' description: A specification for an association used by this relationship validFor: $ref: '#/definitions/TimePeriod' description: The period for which the entitySpecRelationship is valid '@baseType': type: string description: When sub-classing, this defines the super-class '@schemaLocation': type: string format: uri description: A URI to a JSON-Schema file that defines additional attributes and relationships '@type': type: string description: When sub-classing, this defines the sub-class Extensible name '@referredType': type: string description: The actual type of the target instance when needed for disambiguation. Extensible: type: object description: Base Extensible schema for use in TMForum Open-APIs properties: '@baseType': type: string description: When sub-classing, this defines the super-class '@schemaLocation': type: string format: uri description: A URI to a JSON-Schema file that defines additional attributes and relationships '@type': type: string description: When sub-classing, this defines the sub-class Extensible name ExternalIdentifier: type: object description: An identification of an entity that is owned by or originates in a software system different from the current system, for example a ProductOrder handed off from a commerce platform into an order handling system. The structure identifies the system itself, the nature of the entity within the system (e.g. class name) and the unique ID of the entity within the system. It is anticipated that multiple external IDs can be held for a single entity, e.g. if the entity passed through multiple systems on the way to the current system. In this case the consumer is expected to sequence the IDs in the array in reverse order of provenance, i.e. most recent system first in the list. required: - id properties: id: example: MC2255771199555 type: string description: identification of the entity within the external system. href: type: string format: uri description: Hyperlink reference externalIdentifierType: example: ProductOrder type: string description: Type of the identification, typically would be the type of the entity within the external system owner: example: MagentoCommerce type: string description: Name of the external system that owns the entity. '@baseType': type: string description: When sub-classing, this defines the super-class '@schemaLocation': type: string format: uri description: A URI to a JSON-Schema file that defines additional attributes and relationships '@type': type: string description: When sub-classing, this defines the sub-class Extensible name Quantity: type: object description: An amount in a given unit properties: amount: default: 1 type: number format: float description: Numeric value in a given unit units: type: string description: Unit RelatedEntity: type: object description: A reference to an entity, where the type of the entity is not known in advance. required: - '@referredType' - id - role properties: id: type: string description: unique identifier href: type: string format: uri description: Hyperlink reference name: type: string description: Name of the related entity. role: type: string description: The role of an entity. '@baseType': type: string description: When sub-classing, this defines the super-class '@schemaLocation': type: string format: uri description: A URI to a JSON-Schema file that defines additional attributes and relationships '@type': type: string description: When sub-classing, this defines the sub-class Extensible name '@referredType': type: string description: The actual type of the target instance when needed for disambiguation. RelatedParty: type: object description: Related Entity reference. A related party defines party or party role linked to a specific entity. required: - '@referredType' - id properties: id: type: string description: unique identifier href: type: string format: uri description: Hyperlink reference name: type: string description: Name of the related entity. role: type: string description: Role played by the related party '@baseType': type: string description: When sub-classing, this defines the super-class '@schemaLocation': type: string format: uri description: A URI to a JSON-Schema file that defines additional attributes and relationships '@type': type: string description: When sub-classing, this defines the sub-class Extensible name '@referredType': type: string description: The actual type of the target instance when needed for disambiguation. TargetEntitySchema: type: object description: The reference object to the schema and type of target entity which is described by a specification required: - '@schemaLocation' - '@type' properties: '@schemaLocation': type: string description: This field provides a link to the schema describing the target entity '@type': type: string description: Class type of the target entity TimePeriod: type: object description: A period of time, either as a deadline (endDateTime only) a startDateTime only, or both properties: endDateTime: example: '1985-04-12T23:20:50.52Z' type: string format: date-time description: End of the time period, using IETC-RFC-3339 format startDateTime: example: '1985-04-12T23:20:50.52Z' type: string format: date-time description: Start of the time period, using IETC-RFC-3339 format EventSubscription: type: object description: Sets the communication endpoint address the service instance must use to deliver notification information required: - id - callback properties: id: type: string description: Id of the listener callback: type: string description: The callback being registered. query: type: string description: additional data to be passed EventSubscriptionInput: type: object description: Sets the communication endpoint address the service instance must use to deliver notification information required: - callback properties: callback: type: string description: The callback being registered. query: type: string description: additional data to be passed DocumentCreateEvent: type: object description: The notification data structure properties: event: description: The event payload linked to the involved resource object $ref: '#/definitions/DocumentCreateEventPayload' eventId: type: string description: The identifier of the notification. eventTime: type: string format: date-time description: Time of the event occurrence. eventType: type: string description: The type of the notification. correlationId: type: string description: The correlation id for this event. domain: type: string description: The domain of the event. title: type: string description: The title of the event. description: type: string description: An explnatory of the event. priority: type: string description: A priority. timeOcurred: type: string format: date-time description: The time the event occured. DocumentCreateEventPayload: type: object description: The event data structure properties: document: description: The involved resource data for the event $ref: '#/definitions/Document' DocumentChangeEvent: type: object description: The notification data structure properties: event: description: The event payload linked to the involved resource object $ref: '#/definitions/DocumentChangeEventPayload' eventId: type: string description: The identifier of the notification. eventTime: type: string format: date-time description: Time of the event occurrence. eventType: type: string description: The type of the notification. correlationId: type: string description: The correlation id for this event. domain: type: string description: The domain of the event. title: type: string description: The title of the event. description: type: string description: An explnatory of the event. priority: type: string description: A priority. timeOcurred: type: string format: date-time description: The time the event occured. DocumentChangeEventPayload: type: object description: The event data structure properties: document: description: The involved resource data for the event $ref: '#/definitions/Document' DocumentBatchEvent: type: object description: The notification data structure properties: event: description: The event payload linked to the involved resource object $ref: '#/definitions/DocumentBatchEventPayload' eventId: type: string description: The identifier of the notification. eventTime: type: string format: date-time description: Time of the event occurrence. eventType: type: string description: The type of the notification. correlationId: type: string description: The correlation id for this event. domain: type: string description: The domain of the event. title: type: string description: The title of the event. description: type: string description: An explnatory of the event. priority: type: string description: A priority. timeOcurred: type: string format: date-time description: The time the event occured. DocumentBatchEventPayload: type: object description: The event data structure properties: document: description: The involved resource data for the event $ref: '#/definitions/Document' DocumentDeleteEvent: type: object description: The notification data structure properties: event: description: The event payload linked to the involved resource object $ref: '#/definitions/DocumentDeleteEventPayload' eventId: type: string description: The identifier of the notification. eventTime: type: string format: date-time description: Time of the event occurrence. eventType: type: string description: The type of the notification. correlationId: type: string description: The correlation id for this event. domain: type: string description: The domain of the event. title: type: string description: The title of the event. description: type: string description: An explnatory of the event. priority: type: string description: A priority. timeOcurred: type: string format: date-time description: The time the event occured. DocumentDeleteEventPayload: type: object description: The event data structure properties: document: description: The involved resource data for the event $ref: '#/definitions/Document' DocumentSpecificationCreateEvent: type: object description: The notification data structure properties: event: description: The event payload linked to the involved resource object $ref: '#/definitions/DocumentSpecificationCreateEventPayload' eventId: type: string description: The identifier of the notification. eventTime: type: string format: date-time description: Time of the event occurrence. eventType: type: string description: The type of the notification. correlationId: type: string description: The correlation id for this event. domain: type: string description: The domain of the event. title: type: string description: The title of the event. description: type: string description: An explnatory of the event. priority: type: string description: A priority. timeOcurred: type: string format: date-time description: The time the event occured. DocumentSpecificationCreateEventPayload: type: object description: The event data structure properties: documentSpecification: description: The involved resource data for the event $ref: '#/definitions/DocumentSpecification' DocumentSpecificationAttributeValueChangeEvent: type: object description: The notification data structure properties: eventId: type: string description: The identifier of the notification. eventTime: type: string format: date-time description: Time of the event occurrence. eventType: type: string description: The type of the notification. correlationId: type: string description: The correlation id for this event. domain: type: string description: The domain of the event. title: type: string description: The title of the event. description: type: string description: An explnatory of the event. priority: type: string description: A priority. timeOcurred: type: string format: date-time description: The time the event occured. fieldPath: type: string description: The path identifying the object field concerned by this notification. event: description: The event payload linked to the involved resource object $ref: '#/definitions/DocumentSpecificationAttributeValueChangeEventPayload' DocumentSpecificationAttributeValueChangeEventPayload: type: object description: The event data structure properties: documentSpecification: description: The involved resource data for the event $ref: '#/definitions/DocumentSpecification' DocumentSpecificationDeleteEvent: type: object description: The notification data structure properties: event: description: The event payload linked to the involved resource object $ref: '#/definitions/DocumentSpecificationDeleteEventPayload' eventId: type: string description: The identifier of the notification. eventTime: type: string format: date-time description: Time of the event occurrence. eventType: type: string description: The type of the notification. correlationId: type: string description: The correlation id for this event. domain: type: string description: The domain of the event. title: type: string description: The title of the event. description: type: string description: An explnatory of the event. priority: type: string description: A priority. timeOcurred: type: string format: date-time description: The time the event occured. DocumentSpecificationDeleteEventPayload: type: object description: The event data structure properties: documentSpecification: description: The involved resource data for the event $ref: '#/definitions/DocumentSpecification' Error: description: Used when an API throws an Error, typically with a HTTP error response-code (3xx, 4xx, 5xx) type: object required: - code - reason properties: code: type: string description: Application relevant detail, defined in the API or a common list. reason: type: string description: Explanation of the reason for the error which can be shown to a client user. message: type: string description: More details and corrective actions related to the error which can be shown to a client user. status: type: string description: HTTP Error code extension referenceError: type: string format: uri description: URI of documentation describing the error. '@baseType': type: string description: When sub-classing, this defines the super-class. '@schemaLocation': type: string format: uri description: A URI to a JSON-Schema file that defines additional attributes and relationships '@type': type: string description: When sub-classing, this defines the sub-class entity name.