Create an attachment for a permit

post

/fscmRestApi/resources/11.13.18.05/publicSectorRecordAttachments

Request

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.
  • Contains one of the following values: true or false. If true, the server performs an Upsert operation instead of a Create operation. During an Upsert operation, the server attempts to find an existing resource that matches the payload. If a match is found, the server updates the existing resource instead of creating a new one. If not found or false (default), the server performs a Create operation. Note that the Upsert operation isn't supported for date-effective REST resources.
Supported Media Types
Request Body - application/json ()
Root Schema : schema
Type: object
Show Source
Nested Schema : Record Attachment Accessors
Type: array
Title: Record Attachment Accessors
The record attachment accessors resource is used for displaying permit attachment file-related information such as file name and file URL.
Show Source
Nested Schema : publicSectorRecordAttachments-LnpAttachmentAccessor-item-post-request
Type: object
Show Source
  • Title: Asynchronous Upload Tracker Id
    The attribute provided for exclusive use by the Attachment UI components to assist in uploading files.
  • Title: Attached Document Id
    The unique identifier for an attachment.
  • Record Attachment Revisions
    Title: Record Attachment Revisions
    The record attachments revisions resource is used for displaying the historical information for a permit attachment.
  • Title: Category
    Maximum Length: 30
    The unique name given to the permit attachment file-related information, which makes the attachment functionality work in conjunction with the entity name.
  • Title: Shared
    Indicates whether the attached file repository is shared. The default value is false.
  • Title: Type
    Maximum Length: 30
    Default Value: FILE
    The datatype code of the attachment.
  • Title: Description
    Maximum Length: 255
    The description of the attachment.
  • Maximum Length: 255
    The document ID from which the attachment is created.
  • Title: Dm Folder Path
    Maximum Length: 1000
    The folder path of the attachment file.
  • Maximum Length: 255
    The document version number from which the attachment is created.
  • Title: DownloadInfo
    The JSON object represented as a string containing information used to programmatically retrieve a file attachment.
  • Title: Error Status Code
    The code that indicates the error status of the attachment.
  • Title: Error Status Message
    The message that describes the error status of the attachment.
  • Title: Expiration Date
    The date of expiration of the attachment.
  • Title: File Contents
    The core attachments API has been restructured and this attribute is no longer supported for attachments insert functionality. Use these attributes instead: UploadedFileContentType, UploadedFileLength, and UploadedFileName. See Document 3034288.1 in My Oracle Support.
  • Title: File Name
    Maximum Length: 2048
    The name of the attached file.
  • Title: File Url
    The URL or web address of the attached file.
  • Title: PostProcessingAction
    The name of the action that can be performed after an attachment is uploaded.
  • Title: Title
    The title of the attachment.
  • Title: Uploaded File Content Type
    The content type of the attachment, such as text/plain or csv. The core attachments API has been restructured and this attribute is now required for attachments insert functionality. See Document 3034288.1 in My Oracle Support.
  • Title: File Size
    The file length of the attachment in bytes. The core attachments API has been restructured and this attribute is now required for attachments insert functionality. See Document 3034288.1 in My Oracle Support.
  • Title: Uploaded File Name
    The name of the attached file. The core attachments API has been restructured and this attribute is now required for attachments insert functionality. See Document 3034288.1 in My Oracle Support.
  • Title: Uploaded Text
    The text that is entered along with the attachment.
  • Title: Uri
    Maximum Length: 4000
    The type of universal resource identifier (URI) associated with the attachment. For example, URL.
  • Title: Url
    Maximum Length: 4000
    The URL associated with an attachment.
Nested Schema : Record Attachment Revisions
Type: array
Title: Record Attachment Revisions
The record attachments revisions resource is used for displaying the historical information for a permit attachment.
Show Source
Nested Schema : publicSectorRecordAttachments-LnpAttachmentAccessor-AttachmentsRevision-item-post-request
Type: object
Show Source
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 : publicSectorRecordAttachments-item-response
Type: object
Show Source
  • Maximum Length: 1
    Default Value: false
    Indicates whether the attachment record meets the required documents document category and subcategory requirements for the acceptance application step. The default value is no.
  • Title: Agency ID
    Default Value: 1
    The agency identifier of the public sector entity to which this attachment applies.
  • Maximum Length: 255
    Default Value: PSC_DOC_LNP
    The entity name of the attachment.
  • The unique identifier for a permit attachment.
  • Maximum Length: 15
    Default Value: LNP
    The type of attachment, such as for plan reviews, inspections, or permits.
  • Maximum Length: 1
    Default Value: false
    Indicates whether the attachment record meets the required documents document category and subcategory requirements for the complete application step. The default value is no.
  • Maximum Length: 1
    Default Value: false
    Indicates whether the attachment is a confidential document. The default value is N for no.
  • Indicates that the attachment is being created as a copy from an existing attachment. The default value is N for No.
  • Title: Uploaded By
    The user who created the attachment.
  • Title: Uploaded On
    Read Only: true
    The date and time when the attachment was created.
  • Title: Description
    Maximum Length: 100
    The description of the attachment.
  • Maximum Length: 1
    Default Value: false
    Indicates whether the attachment requires a digital signature. If the value is Y, then a digital signature is required. The default value is N.
  • Title: Category
    Maximum Length: 30
    The category used for dividing the attached document into a logical group.
  • Maximum Length: 30
    The document group specified on the permit type when the attachment was uploaded.
  • Maximum Length: 1
    Default Value: false
    Indicates whether the attachment was reviewed and returned by the electronic document review application. The default value is N.
  • Title: Subcategory
    Maximum Length: 30
    The subcategory used for dividing the attached document into a logical group along with the category.
  • Maximum Length: 1
    Default Value: false
    Indicates whether the attachment file contents has been successfully uploaded. The default value is N for no. The core attachments API has been restructured for attachments insert functionality. See Document 3034288.1 in My Oracle Support.
  • Title: File Name
    Maximum Length: 255
    The name of the attached file.
  • Title: File Size
    The size of the attached file.
  • Maximum Length: 100
    The file type of attachment, such as PDF or text.
  • Title: Final
    Maximum Length: 1
    Default Value: false
    Indicates whether the attachment is the final document for a permit, business license, or planning application. The default value is N for no.
  • Maximum Length: 1
    Default Value: false
    Indicates whether the attachment record meets the required documents document category and subcategory requirements for the final inspection application step. The default value is no.
  • Maximum Length: 1
    Default Value: false
    Indicates whether the attachment record meets the required documents document category and subcategory requirements for the issuance application step. The default value is no.
  • Title: Last Updated Date
    Read Only: true
    The date and time when the attachment was last updated.
  • Links
  • Record Attachment Accessors
    Title: Record Attachment Accessors
    The record attachment accessors resource is used for displaying permit attachment file-related information such as file name and file URL.
  • The unique key associated with the permit attachment.
  • Maximum Length: 480
    The public unique identifier for a permit attachment.
  • The unique identifier for a record. The record is for a permit, business license, professional license, or planning and zoning, and is determined by the classification.
  • Maximum Length: 1
    Default Value: false
    Indicates whether the attachment is associated with a plan review. If the value is Y, then the attachment is associated with a plan review. The default value is N.
  • This column contains the thumbnail of an attached file.
  • This column indicates the height of a stored thumbnail.
  • This column indicates the width of a stored thumbnail.
  • Maximum Length: 1
    Default Value: N
    Indicates whether the attachment has some level of protection and what type of protection. The default value is N for None.
  • The agency identifier of the public sector entity to which this attachment applies.
  • The unique identifier for an attachment.
  • Maximum Length: 64
    The public unique identifier for a permit record.
  • Maximum Length: 1
    Default Value: false
    Indicates whether the attachment is a required document. The default value is N for no.
  • Maximum Length: 1
    Default Value: false
    Indicates whether the attachment file contents has been successfully uploaded. The default value is N for no.
  • The unique identifier of the source attachment, if the attachment is being created as a copy.
  • The attachment type of the source attachment, if the attachment is being created as a copy.
  • Maximum Length: 30
    The subject of the attachment.
  • Maximum Length: 1
    Default Value: false
    Indicates whether the attachment record meets the required documents document category and subcategory requirements for the submittal application step. The default value is no.
  • Title: Last Updated By
    The user who last updated the attachment.
  • The version of the attachment.
  • Maximum Length: 1
    Default Value: false
    Indicates whether the attachment is write-protected. The default value is N for no.
Nested Schema : Record Attachment Accessors
Type: array
Title: Record Attachment Accessors
The record attachment accessors resource is used for displaying permit attachment file-related information such as file name and file URL.
Show Source
Nested Schema : publicSectorRecordAttachments-LnpAttachmentAccessor-item-response
Type: object
Show Source
  • Title: Asynchronous Upload Tracker Id
    The attribute provided for exclusive use by the Attachment UI components to assist in uploading files.
  • Title: Attached Document Id
    The unique identifier for an attachment.
  • Record Attachment Revisions
    Title: Record Attachment Revisions
    The record attachments revisions resource is used for displaying the historical information for a permit attachment.
  • Title: Category
    Maximum Length: 30
    The unique name given to the permit attachment file-related information, which makes the attachment functionality work in conjunction with the entity name.
  • Title: Shared
    Indicates whether the attached file repository is shared. The default value is false.
  • Title: Created By
    Read Only: true
    Maximum Length: 255
    The user who created the attachment.
  • Title: Created By User Name
    Read Only: true
    The user who created the attachment.
  • Title: Creation Date
    Read Only: true
    The date and time when the attachment was created.
  • Title: Type
    Maximum Length: 30
    Default Value: FILE
    The datatype code of the attachment.
  • Title: Description
    Maximum Length: 255
    The description of the attachment.
  • Maximum Length: 255
    The document ID from which the attachment is created.
  • Title: Dm Folder Path
    Maximum Length: 1000
    The folder path of the attachment file.
  • Maximum Length: 255
    The document version number from which the attachment is created.
  • Title: DownloadInfo
    The JSON object represented as a string containing information used to programmatically retrieve a file attachment.
  • Title: Error Status Code
    The code that indicates the error status of the attachment.
  • Title: Error Status Message
    The message that describes the error status of the attachment.
  • Title: Expiration Date
    The date of expiration of the attachment.
  • Title: File Contents
    The core attachments API has been restructured and this attribute is no longer supported for attachments insert functionality. Use these attributes instead: UploadedFileContentType, UploadedFileLength, and UploadedFileName. See Document 3034288.1 in My Oracle Support.
  • Title: File Name
    Maximum Length: 2048
    The name of the attached file.
  • Title: File Url
    The URL or web address of the attached file.
  • Title: File Web Image
    Read Only: true
    The base64 encoded image of the file displayed in PNG format if the source is a convertible image.
  • Title: Last Update Date
    Read Only: true
    The date and time when the attachment was last updated.
  • Title: Last Updated By
    Read Only: true
    Maximum Length: 255
    The user who last updated the attachment.
  • Title: Last Updated By User
    Read Only: true
    The user who last updated the attachment.
  • Links
  • Title: PostProcessingAction
    The name of the action that can be performed after an attachment is uploaded.
  • Title: Title
    The title of the attachment.
  • Title: Uploaded File Content Type
    The content type of the attachment, such as text/plain or csv. The core attachments API has been restructured and this attribute is now required for attachments insert functionality. See Document 3034288.1 in My Oracle Support.
  • Title: File Size
    The file length of the attachment in bytes. The core attachments API has been restructured and this attribute is now required for attachments insert functionality. See Document 3034288.1 in My Oracle Support.
  • Title: Uploaded File Name
    The name of the attached file. The core attachments API has been restructured and this attribute is now required for attachments insert functionality. See Document 3034288.1 in My Oracle Support.
  • Title: Uploaded Text
    The text that is entered along with the attachment.
  • Title: Uri
    Maximum Length: 4000
    The type of universal resource identifier (URI) associated with the attachment. For example, URL.
  • Title: Url
    Maximum Length: 4000
    The URL associated with an attachment.
  • Title: User Name
    Read Only: true
    Maximum Length: 255
    The user's unique user name for logging into the system.
Nested Schema : Record Attachment Revisions
Type: array
Title: Record Attachment Revisions
The record attachments revisions resource is used for displaying the historical information for a permit attachment.
Show Source
Nested Schema : publicSectorRecordAttachments-LnpAttachmentAccessor-AttachmentsRevision-item-response
Type: object
Show Source
Back to Top