Update a document type

patch

/hcmRestApi/resources/11.13.18.05/hrDocumentTypes/{DocumentTypeId}

Request

Path Parameters
  • The value of this parameter could be a hash of the key that is used to uniquely identify the resource item. The client should not generate the hash key value. Instead, the client should query on the collection resource with a filter to navigate to a specific resource item. For example: products?q=InventoryItemId=
Header Parameters
  • If the REST API supports runtime customizations, the shape of the service may change during runtime. The REST client may isolate itself from these changes or choose to interact with the latest version of the API by specifying this header. For example: Metadata-Context:sandbox="TrackEmployeeFeature".
  • The protocol version between a REST client and service. If the client does not specify this header in the request the server will pick a default version for the API.
Supported Media Types
Request Body - application/json ()
Root Schema : schema
Type: object
Show Source
  • Title: Active
    Maximum Length: 30
    Default Value: true
    Indicates whether the document type is active. The default value is Yes.
  • Title: Archive Criteria Basis
    Maximum Length: 30
    Criteria for archiving document records based on the document type.
  • Title: Archive After Days
    Number of days after which document records are archived based on the document type.
  • Attachments
    Title: Attachments
    The attachments resource is used to view, create, and update attachments.
  • Title: Approval Required
    Maximum Length: 1
    Default Value: false
    Indicates whether approval is required for the document type. The default value is No.
  • Title: Report Path
    Maximum Length: 2000
    URL or path where the report is available.
  • Title: New Label for Issuing Comments
    Maximum Length: 200
    Label for the field that the user defines for the issuing comments.
  • Title: Issuing Comments Applicable
    Maximum Length: 30
    Default Value: Y
    Indicates whether comments are relevant (Y) or required (R) or not relevant (N). The default value is relevant (Y).
  • Title: New Label for From Date
    Maximum Length: 200
    Label for the field that the user defines for the from date.
  • Title: From Date Applicable
    Maximum Length: 30
    Default Value: Y
    Indicates whether date from is relevant (Y) or required (R) or not relevant (N). The default value is relevant (Y).
  • Title: New Label for To Date
    Maximum Length: 200
    Label for the field that the user defines for the to date.
  • Title: To Date Applicable
    Maximum Length: 30
    Default Value: Y
    Indicates whether date to is relevant (Y) or required (R) or not relevant (N). The default value is relevant (Y).
  • Title: Description
    Maximum Length: 4000
    Description for the document type.
  • Title: Default Value for Context Segment
    Maximum Length: 120
    Default value for the document records flexfield context segment.
  • Title: Display Preference for Context Segment
    Maximum Length: 30
    Display preference for the document records flexfield context segment.
  • Title: Display Preference for Global Segment
    Maximum Length: 30
    Display preference for the document records flexfield global segment.
  • Title: New Label for Name
    Maximum Length: 200
    Label for the field that the user defines for the document name.
  • Title: Document Name Applicable
    Maximum Length: 30
    Default Value: Y
    Indicates whether document name is relevant (Y) or required (R) or not relevant (N). The default setting is relevant (Y).
  • Title: New Label for Number
    Maximum Length: 200
    Label for the field that the user defines for the document number.
  • Title: Document Number Applicable
    Maximum Length: 30
    Default Value: Y
    Indicates whether document number is relevant (Y) or required (R) or not relevant (N). The default value is relevant (Y).
  • Title: Type
    Maximum Length: 80
    Unique name to identify the document type.
  • Title: Document Type Level
    Maximum Length: 30
    Default Value: ORA_P
    Indicates whether the document type applies to a person or an individual assignment. The default value is Person.
  • documentTypesDDF
  • documentTypesDFF
  • Title: Override Hierarchy
    Maximum Length: 30
    Hierarchy code to support delivery preferences on this document type.
  • Title: New Label for Issued Date
    Maximum Length: 200
    Label for the field that the user defines for the issued date.
  • Title: Issued on Applicable
    Maximum Length: 30
    Default Value: Y
    Indicates whether issued date is relevant (Y) or required (R) or not relevant (N). The default value is relevant (Y).
  • Title: New Label for Issuing Authority
    Maximum Length: 200
    Label for the field that the user defines for the issuing authority.
  • Title: Issuing Authority Applicable
    Maximum Length: 30
    Default Value: Y
    Indicates whether issuing authority is relevant (Y) or required (R) or not relevant (N). The default value is relevant (Y).
  • Title: New Label for Issuing Country
    Maximum Length: 200
    Label for the field that the user defines for the issuing country.
  • Title: Issuing Country Applicable
    Maximum Length: 30
    Default Value: Y
    Indicates whether issuing country is relevant (Y) or required (R) or not relevant (N). The default value is relevant (Y).
  • Title: New Label for Issuing Location
    Maximum Length: 200
    Label for the field that the user defines for the issuing location.
  • Title: Issuing Location Applicable
    Maximum Length: 30
    Default Value: Y
    Indicates whether issuing location is relevant (Y) or required (R) or not relevant (N). The default value is relevant (Y).
  • Title: Restrict Create
    Maximum Length: 30
    Default Value: false
    Indicates whether it restricts or allows creating document records of this document type. The default value is No
  • Title: Roles Excluded from Restriction
    Maximum Length: 4000
    List of roles that can create document records based on the document type.
  • Title: Restrict Delete
    Maximum Length: 30
    Default Value: false
    Indicates whether it restricts or allows deleting document records of this document type. The default value is No.
  • Title: Roles Excluded from Restriction
    Maximum Length: 4000
    List of roles allowed to delete document records based on the document type.
  • Title: Restrict Update
    Maximum Length: 30
    Default Value: false
    Indicates whether it restricts or allows updating document records of this document type. The default value is No.
  • Title: Roles Excluded from Restriction
    Maximum Length: 4000
    List of roles allowed to update document records based on the document type.
  • Title: Minimum Attachments
    Default Value: 0
    Minimum number of attachments that a user must attach for a specific document type.
  • Title: Allow multiple occurrences
    Maximum Length: 30
    Default Value: true
    Indicates whether multiple occurrences of this document type are allowed. The default value is Yes.
  • Title: Publish Required
    Maximum Length: 30
    Default Value: false
    Indicates whether document records of this document type must be published. The default value is No.
  • Title: Purge After Days
    Number of days after which archived document records will be purged.
  • Title: System Document Type
    Maximum Length: 120
    System-generated name that uniquely identifies the document type.
  • Title: Tags
    Maximum Length: 2000
    Lookup code of the tag used for the document type derived from the lookup ORA_PER_DOC_TYPE_TAGS.
  • Translations for Document Types
    Title: Translations for Document Types
    The translations is a child of the hrDocumentTypes resource. It includes all the translated values of the document type.
  • Title: Expiration Notification Period
    Number of days in advance to generate an alert when a document record based on this document type is about to expire.
Nested Schema : Attachments
Type: array
Title: Attachments
The attachments resource is used to view, create, and update attachments.
Show Source
Nested Schema : documentTypesDDF
Type: array
Show Source
Nested Schema : documentTypesDFF
Type: array
Show Source
Nested Schema : Translations for Document Types
Type: array
Title: Translations for Document Types
The translations is a child of the hrDocumentTypes resource. It includes all the translated values of the document type.
Show Source
Nested Schema : hrDocumentTypes-attachments-item-patch-request
Type: object
Show Source
Nested Schema : Attachment Previews
Type: array
Title: Attachment Previews
The attachments preview resource is used to preview the attachment pages.
Show Source
Nested Schema : hrDocumentTypes-attachments-AttachmentsPreview-item-patch-request
Type: object
Show Source
Nested Schema : hrDocumentTypes-documentTypesDDF-item-patch-request
Type: object
Show Source
Nested Schema : hrDocumentTypes-documentTypesDFF-item-patch-request
Type: object
Show Source
Nested Schema : hrDocumentTypes-translations-item-patch-request
Type: object
Show Source
  • Title: New Label for Issuing Comments
    Maximum Length: 200
    Translated label for the field that the user defines for the issuing comments.
  • Title: New Label for From Date
    Maximum Length: 200
    Translated label for the field that the user defines for the from date.
  • Title: New Label for To Date
    Maximum Length: 200
    Translated label for the field that the user defines for the to date.
  • Maximum Length: 4000
    Translated description for the document type.
  • Title: New Label for Name
    Maximum Length: 200
    Translated label for the field that the user defines for the document name.
  • Title: New Label for Number
    Maximum Length: 200
    Translated label for the field that the user defines for the document number.
  • Maximum Length: 80
    Translated name to uniquely identify the document type.
  • Title: New Label for Issued Date
    Maximum Length: 200
    Translated label for the field that the user defines for the issued date.
  • Title: New Label for Issuing Authority
    Maximum Length: 200
    Translated label for the field that the user defines for the issuing authority.
  • Title: New Label for Issuing Country
    Maximum Length: 200
    Translated label for the field that the user defines for the issuing country.
  • Title: New Label for Issuing Location
    Maximum Length: 200
    Translated label for the field that the user defines for the issuing location.
  • Maximum Length: 4
    Translated language of the document type.
  • Maximum Length: 4
    Source language of the document type.
Back to Top

Response

Supported Media Types

Default Response

The following table describes the default response for this task.
Headers
  • If the REST API supports runtime customizations, the shape of the service may change during runtime. The REST client may isolate itself from these changes or choose to interact with the latest version of the API by specifying this header. For example: Metadata-Context:sandbox="TrackEmployeeFeature".
  • The protocol version between a REST client and service. If the client does not specify this header in the request the server will pick a default version for the API.
Body ()
Root Schema : hrDocumentTypes-item-response
Type: object
Show Source
  • Title: Active
    Maximum Length: 30
    Default Value: true
    Indicates whether the document type is active. The default value is Yes.
  • Title: Archive Criteria Basis
    Maximum Length: 30
    Criteria for archiving document records based on the document type.
  • Title: Archive After Days
    Number of days after which document records are archived based on the document type.
  • Attachments
    Title: Attachments
    The attachments resource is used to view, create, and update attachments.
  • Title: Approval Required
    Maximum Length: 1
    Default Value: false
    Indicates whether approval is required for the document type. The default value is No.
  • Title: Report Path
    Maximum Length: 2000
    URL or path where the report is available.
  • Title: Category
    Maximum Length: 30
    Category of the document type.
  • Title: New Label for Issuing Comments
    Maximum Length: 200
    Label for the field that the user defines for the issuing comments.
  • Title: Issuing Comments Applicable
    Maximum Length: 30
    Default Value: Y
    Indicates whether comments are relevant (Y) or required (R) or not relevant (N). The default value is relevant (Y).
  • Read Only: true
    Maximum Length: 64
    Name of the user who created the document type.
  • Read Only: true
    Date on which the document type was created.
  • Title: New Label for From Date
    Maximum Length: 200
    Label for the field that the user defines for the from date.
  • Title: From Date Applicable
    Maximum Length: 30
    Default Value: Y
    Indicates whether date from is relevant (Y) or required (R) or not relevant (N). The default value is relevant (Y).
  • Title: New Label for To Date
    Maximum Length: 200
    Label for the field that the user defines for the to date.
  • Title: To Date Applicable
    Maximum Length: 30
    Default Value: Y
    Indicates whether date to is relevant (Y) or required (R) or not relevant (N). The default value is relevant (Y).
  • Title: Description
    Maximum Length: 4000
    Description for the document type.
  • Title: Default Value for Context Segment
    Maximum Length: 120
    Default value for the document records flexfield context segment.
  • Title: Display Preference for Context Segment
    Maximum Length: 30
    Display preference for the document records flexfield context segment.
  • Title: Display Preference for Global Segment
    Maximum Length: 30
    Display preference for the document records flexfield global segment.
  • Title: New Label for Name
    Maximum Length: 200
    Label for the field that the user defines for the document name.
  • Title: Document Name Applicable
    Maximum Length: 30
    Default Value: Y
    Indicates whether document name is relevant (Y) or required (R) or not relevant (N). The default setting is relevant (Y).
  • Title: New Label for Number
    Maximum Length: 200
    Label for the field that the user defines for the document number.
  • Title: Document Number Applicable
    Maximum Length: 30
    Default Value: Y
    Indicates whether document number is relevant (Y) or required (R) or not relevant (N). The default value is relevant (Y).
  • Title: Type
    Maximum Length: 80
    Unique name to identify the document type.
  • Title: Type
    Surrogate ID for the document type which is available only when updating existing records.
  • Title: Document Type Level
    Maximum Length: 30
    Default Value: ORA_P
    Indicates whether the document type applies to a person or an individual assignment. The default value is Person.
  • documentTypesDDF
  • documentTypesDFF
  • Title: Override Hierarchy
    Maximum Length: 30
    Hierarchy code to support delivery preferences on this document type.
  • Title: New Label for Issued Date
    Maximum Length: 200
    Label for the field that the user defines for the issued date.
  • Title: Issued on Applicable
    Maximum Length: 30
    Default Value: Y
    Indicates whether issued date is relevant (Y) or required (R) or not relevant (N). The default value is relevant (Y).
  • Title: New Label for Issuing Authority
    Maximum Length: 200
    Label for the field that the user defines for the issuing authority.
  • Title: Issuing Authority Applicable
    Maximum Length: 30
    Default Value: Y
    Indicates whether issuing authority is relevant (Y) or required (R) or not relevant (N). The default value is relevant (Y).
  • Title: New Label for Issuing Country
    Maximum Length: 200
    Label for the field that the user defines for the issuing country.
  • Title: Issuing Country Applicable
    Maximum Length: 30
    Default Value: Y
    Indicates whether issuing country is relevant (Y) or required (R) or not relevant (N). The default value is relevant (Y).
  • Title: New Label for Issuing Location
    Maximum Length: 200
    Label for the field that the user defines for the issuing location.
  • Title: Issuing Location Applicable
    Maximum Length: 30
    Default Value: Y
    Indicates whether issuing location is relevant (Y) or required (R) or not relevant (N). The default value is relevant (Y).
  • Read Only: true
    Date the document type was last updated.
  • Read Only: true
    Maximum Length: 64
    User who last updated the document type.
  • Title: Country
    Maximum Length: 30
    Legislation code if this is a legislation specific document type.
  • Links
  • Title: Restrict Create
    Maximum Length: 30
    Default Value: false
    Indicates whether it restricts or allows creating document records of this document type. The default value is No
  • Title: Roles Excluded from Restriction
    Maximum Length: 4000
    List of roles that can create document records based on the document type.
  • Title: Restrict Delete
    Maximum Length: 30
    Default Value: false
    Indicates whether it restricts or allows deleting document records of this document type. The default value is No.
  • Title: Roles Excluded from Restriction
    Maximum Length: 4000
    List of roles allowed to delete document records based on the document type.
  • Title: Restrict Update
    Maximum Length: 30
    Default Value: false
    Indicates whether it restricts or allows updating document records of this document type. The default value is No.
  • Title: Roles Excluded from Restriction
    Maximum Length: 4000
    List of roles allowed to update document records based on the document type.
  • Title: Minimum Attachments
    Default Value: 0
    Minimum number of attachments that a user must attach for a specific document type.
  • Title: Allow multiple occurrences
    Maximum Length: 30
    Default Value: true
    Indicates whether multiple occurrences of this document type are allowed. The default value is Yes.
  • Title: Publish Required
    Maximum Length: 30
    Default Value: false
    Indicates whether document records of this document type must be published. The default value is No.
  • Title: Purge After Days
    Number of days after which archived document records will be purged.
  • Title: Subcategory
    Maximum Length: 30
    Code of the subcategory for the document type.
  • Title: System Document Type
    Maximum Length: 120
    System-generated name that uniquely identifies the document type.
  • Title: Tags
    Maximum Length: 2000
    Lookup code of the tag used for the document type derived from the lookup ORA_PER_DOC_TYPE_TAGS.
  • Translations for Document Types
    Title: Translations for Document Types
    The translations is a child of the hrDocumentTypes resource. It includes all the translated values of the document type.
  • Title: Expiration Notification Period
    Number of days in advance to generate an alert when a document record based on this document type is about to expire.
Nested Schema : Attachments
Type: array
Title: Attachments
The attachments resource is used to view, create, and update attachments.
Show Source
Nested Schema : documentTypesDDF
Type: array
Show Source
Nested Schema : documentTypesDFF
Type: array
Show Source
Nested Schema : Translations for Document Types
Type: array
Title: Translations for Document Types
The translations is a child of the hrDocumentTypes resource. It includes all the translated values of the document type.
Show Source
Nested Schema : hrDocumentTypes-attachments-item-response
Type: object
Show Source
Nested Schema : Attachment Previews
Type: array
Title: Attachment Previews
The attachments preview resource is used to preview the attachment pages.
Show Source
Nested Schema : hrDocumentTypes-attachments-AttachmentsPreview-item-response
Type: object
Show Source
Nested Schema : hrDocumentTypes-documentTypesDDF-item-response
Type: object
Show Source
Nested Schema : hrDocumentTypes-documentTypesDFF-item-response
Type: object
Show Source
Nested Schema : hrDocumentTypes-translations-item-response
Type: object
Show Source
Back to Top