{"openapi":"3.1.0","info":{"title":"File Storage","version":"1.0.0"},"paths":{"/filestorage/v1/drives":{"get":{"operationId":"drives_list","summary":"List","description":"Returns a list of `Drive` objects.{/* BEGIN_FILESTORAGE_DRIVE_FETCH_SUPPORTED_FIELDS */}{/* END_FILESTORAGE_DRIVE_FETCH_SUPPORTED_FIELDS */}","tags":["drives"],"parameters":[{"name":"created_after","in":"query","description":"If provided, will only return objects created after this datetime.","required":false,"schema":{"type":"string","format":"date-time"}},{"name":"created_before","in":"query","description":"If provided, will only return objects created before this datetime.","required":false,"schema":{"type":"string","format":"date-time"}},{"name":"cursor","in":"query","description":"The pagination cursor value.","required":false,"schema":{"type":"string"}},{"name":"include_deleted_data","in":"query","description":"Indicates whether or not this object has been deleted in the third party platform. Full coverage deletion detection is a premium add-on. Native deletion detection is offered for free with limited coverage. [Learn more](https://docs.merge.dev/integrations/hris/supported-features/).","required":false,"schema":{"type":"boolean"}},{"name":"include_remote_data","in":"query","description":"Whether to include the original data Merge fetched from the third-party to produce these models.","required":false,"schema":{"type":"boolean"}},{"name":"include_shell_data","in":"query","description":"Whether to include shell records. Shell records are empty records (they may contain some metadata but all other fields are null).","required":false,"schema":{"type":"boolean"}},{"name":"modified_after","in":"query","description":"If provided, only objects synced by Merge after this date time will be returned.","required":false,"schema":{"type":"string","format":"date-time"}},{"name":"modified_before","in":"query","description":"If provided, only objects synced by Merge before this date time will be returned.","required":false,"schema":{"type":"string","format":"date-time"}},{"name":"name","in":"query","description":"If provided, will only return drives with this name. This performs an exact match.","required":false,"schema":{"type":"string"}},{"name":"page_size","in":"query","description":"Number of results to return per page. The maximum limit is 100.","required":false,"schema":{"type":"integer"}},{"name":"remote_id","in":"query","description":"The API provider's ID for the given object.","required":false,"schema":{"type":"string"}},{"name":"X-Account-Token","in":"header","description":"Token identifying the end user.","required":true,"schema":{"type":"string"}}],"responses":{"200":{"description":"","content":{"application/json":{"schema":{"$ref":"#/components/schemas/PaginatedDriveList"}}}}},"security":[{"tokenAuth":[]}]}},"/filestorage/v1/drives/{id}":{"get":{"operationId":"drives_retrieve","summary":"Retrieve","description":"Returns a `Drive` object with the given `id`.{/* BEGIN_FILESTORAGE_DRIVE_FETCH_SUPPORTED_FIELDS */}{/* END_FILESTORAGE_DRIVE_FETCH_SUPPORTED_FIELDS */}","tags":["drives"],"parameters":[{"name":"id","in":"path","required":true,"schema":{"type":"string","format":"uuid"}},{"name":"include_remote_data","in":"query","description":"Whether to include the original data Merge fetched from the third-party to produce these models.","required":false,"schema":{"type":"boolean"}},{"name":"include_shell_data","in":"query","description":"Whether to include shell records. Shell records are empty records (they may contain some metadata but all other fields are null).","required":false,"schema":{"type":"boolean"}},{"name":"X-Account-Token","in":"header","description":"Token identifying the end user.","required":true,"schema":{"type":"string"}}],"responses":{"200":{"description":"","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Drive"}}}}},"security":[{"tokenAuth":[]}]}},"/filestorage/v1/files":{"get":{"operationId":"files_list","summary":"List","description":"Returns a list of `File` objects.{/* BEGIN_FILESTORAGE_FILE_FETCH_SUPPORTED_FIELDS */}{/* END_FILESTORAGE_FILE_FETCH_SUPPORTED_FIELDS */}","tags":["files"],"parameters":[{"name":"created_after","in":"query","description":"If provided, will only return objects created after this datetime.","required":false,"schema":{"type":"string","format":"date-time"}},{"name":"created_before","in":"query","description":"If provided, will only return objects created before this datetime.","required":false,"schema":{"type":"string","format":"date-time"}},{"name":"cursor","in":"query","description":"The pagination cursor value.","required":false,"schema":{"type":"string"}},{"name":"drive_id","in":"query","description":"Specifying a drive id returns only the files in that drive. Specifying null returns only the files outside the top-level drive.","required":false,"schema":{"type":"string"}},{"name":"expand","in":"query","description":"Which relations should be returned in expanded form. Multiple relation names should be comma separated without spaces.","required":false,"schema":{"type":"array","items":{"$ref":"#/components/schemas/FilesGetParametersExpandSchemaItems"}}},{"name":"folder_id","in":"query","description":"Specifying a folder id returns only the files in that folder. Specifying null returns only the files in root directory.","required":false,"schema":{"type":"string"}},{"name":"include_deleted_data","in":"query","description":"Indicates whether or not this object has been deleted in the third party platform. Full coverage deletion detection is a premium add-on. Native deletion detection is offered for free with limited coverage. [Learn more](https://docs.merge.dev/integrations/hris/supported-features/).","required":false,"schema":{"type":"boolean"}},{"name":"include_remote_data","in":"query","description":"Whether to include the original data Merge fetched from the third-party to produce these models.","required":false,"schema":{"type":"boolean"}},{"name":"include_shell_data","in":"query","description":"Whether to include shell records. Shell records are empty records (they may contain some metadata but all other fields are null).","required":false,"schema":{"type":"boolean"}},{"name":"mime_type","in":"query","description":"If provided, will only return files with these mime_types. Multiple values can be separated by commas.","required":false,"schema":{"type":"string"}},{"name":"modified_after","in":"query","description":"If provided, only objects synced by Merge after this date time will be returned.","required":false,"schema":{"type":"string","format":"date-time"}},{"name":"modified_before","in":"query","description":"If provided, only objects synced by Merge before this date time will be returned.","required":false,"schema":{"type":"string","format":"date-time"}},{"name":"name","in":"query","description":"If provided, will only return files with this name. This performs an exact match.","required":false,"schema":{"type":"string"}},{"name":"order_by","in":"query","description":"Overrides the default ordering for this endpoint. Possible values include: created_at, -created_at, modified_at, -modified_at.","required":false,"schema":{"$ref":"#/components/schemas/FilesGetParametersOrderBy"}},{"name":"page_size","in":"query","description":"Number of results to return per page. The maximum limit is 100.","required":false,"schema":{"type":"integer"}},{"name":"remote_created_after","in":"query","description":"If provided, will only return files created in the third party platform after this datetime.","required":false,"schema":{"type":"string","format":"date-time"}},{"name":"remote_created_before","in":"query","description":"If provided, will only return files created in the third party platform before this datetime.","required":false,"schema":{"type":"string","format":"date-time"}},{"name":"remote_id","in":"query","description":"The API provider's ID for the given object.","required":false,"schema":{"type":"string"}},{"name":"X-Account-Token","in":"header","description":"Token identifying the end user.","required":true,"schema":{"type":"string"}}],"responses":{"200":{"description":"","content":{"application/json":{"schema":{"$ref":"#/components/schemas/PaginatedFileList"}}}}},"security":[{"tokenAuth":[]}]},"post":{"operationId":"files_create","summary":"Create","description":"Creates a `File` object with the given values.{/* BEGIN_FILESTORAGE_FILE_CREATE_SUPPORTED_FIELDS */}{/* END_FILESTORAGE_FILE_CREATE_SUPPORTED_FIELDS */}","tags":["files"],"parameters":[{"name":"is_debug_mode","in":"query","description":"Whether to include debug fields (such as log file links) in the response.","required":false,"schema":{"type":"boolean"}},{"name":"run_async","in":"query","description":"Whether or not third-party updates should be run asynchronously.","required":false,"schema":{"type":"boolean"}},{"name":"X-Account-Token","in":"header","description":"Token identifying the end user.","required":true,"schema":{"type":"string"}}],"responses":{"201":{"description":"","content":{"application/json":{"schema":{"$ref":"#/components/schemas/FileStorageFileResponse"}}}}},"requestBody":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/FileStorageFileEndpointRequest"}}}},"security":[{"tokenAuth":[]}]}},"/filestorage/v1/files/{id}":{"get":{"operationId":"files_retrieve","summary":"Retrieve","description":"Returns a `File` object with the given `id`.{/* BEGIN_FILESTORAGE_FILE_FETCH_SUPPORTED_FIELDS */}{/* END_FILESTORAGE_FILE_FETCH_SUPPORTED_FIELDS */}","tags":["files"],"parameters":[{"name":"id","in":"path","required":true,"schema":{"type":"string","format":"uuid"}},{"name":"expand","in":"query","description":"Which relations should be returned in expanded form. Multiple relation names should be comma separated without spaces.","required":false,"schema":{"type":"array","items":{"$ref":"#/components/schemas/FilesIdGetParametersExpandSchemaItems"}}},{"name":"include_remote_data","in":"query","description":"Whether to include the original data Merge fetched from the third-party to produce these models.","required":false,"schema":{"type":"boolean"}},{"name":"include_shell_data","in":"query","description":"Whether to include shell records. Shell records are empty records (they may contain some metadata but all other fields are null).","required":false,"schema":{"type":"boolean"}},{"name":"X-Account-Token","in":"header","description":"Token identifying the end user.","required":true,"schema":{"type":"string"}}],"responses":{"200":{"description":"","content":{"application/json":{"schema":{"$ref":"#/components/schemas/File"}}}}},"security":[{"tokenAuth":[]}]}},"/filestorage/v1/files/{id}/download":{"get":{"operationId":"files_downloadRetrieve","summary":"Download Retrieve","description":"Returns the `File` content with the given `id` as a stream of bytes.{/* BEGIN_FILESTORAGE_FILE_FETCH_SUPPORTED_FIELDS */}{/* END_FILESTORAGE_FILE_FETCH_SUPPORTED_FIELDS */}","tags":["files"],"parameters":[{"name":"id","in":"path","required":true,"schema":{"type":"string","format":"uuid"}},{"name":"include_shell_data","in":"query","description":"Whether to include shell records. Shell records are empty records (they may contain some metadata but all other fields are null).","required":false,"schema":{"type":"boolean"}},{"name":"mime_type","in":"query","description":"If provided, specifies the export format of the file to be downloaded. For information on supported export formats, please refer to our export format help center article.","required":false,"schema":{"type":"string"}},{"name":"X-Account-Token","in":"header","description":"Token identifying the end user.","required":true,"schema":{"type":"string"}}],"responses":{"200":{"description":"","content":{"application/octet-stream":{"schema":{"type":"string","format":"binary"}}}}},"security":[{"tokenAuth":[]}]}},"/filestorage/v1/files/{id}/download/request-meta":{"get":{"operationId":"files_downloadRequestMetaRetrieve","summary":"Download Request Meta Retrieve","description":"Returns metadata to construct an authenticated file download request for a singular file, allowing you to download file directly from the third-party. For information on our download process please refer to our direct file download help center article.{/* BEGIN_FILESTORAGE_FILE_FETCH_SUPPORTED_FIELDS */}{/* END_FILESTORAGE_FILE_FETCH_SUPPORTED_FIELDS */}","tags":["files"],"parameters":[{"name":"id","in":"path","required":true,"schema":{"type":"string","format":"uuid"}},{"name":"mime_type","in":"query","description":"If provided, specifies the export format of the file to be downloaded.","required":false,"schema":{"type":"string"}},{"name":"X-Account-Token","in":"header","description":"Token identifying the end user.","required":true,"schema":{"type":"string"}}],"responses":{"200":{"description":"","content":{"application/json":{"schema":{"$ref":"#/components/schemas/DownloadRequestMeta"}}}}},"security":[{"tokenAuth":[]}]}},"/filestorage/v1/files/download/request-meta":{"get":{"operationId":"files_downloadRequestMetaList","summary":"Download Request Meta List","description":"Returns metadata to construct authenticated file download requests, allowing you to download files directly from the third-party.{/* BEGIN_FILESTORAGE_FILE_FETCH_SUPPORTED_FIELDS */}{/* END_FILESTORAGE_FILE_FETCH_SUPPORTED_FIELDS */}","tags":["files"],"parameters":[{"name":"created_after","in":"query","description":"If provided, will only return objects created after this datetime.","required":false,"schema":{"type":"string"}},{"name":"created_before","in":"query","description":"If provided, will only return objects created before this datetime.","required":false,"schema":{"type":"string"}},{"name":"cursor","in":"query","description":"The pagination cursor value.","required":false,"schema":{"type":"string"}},{"name":"ids","in":"query","description":"If provided, will only return objects with the given IDs. Comma-separated list of strings.","required":false,"schema":{"type":"array","items":{"type":"string"}}},{"name":"include_deleted_data","in":"query","description":"Indicates whether or not this object has been deleted in the third party platform. Full coverage deletion detection is a premium add-on. Native deletion detection is offered for free with limited coverage. [Learn more](https://docs.merge.dev/integrations/hris/supported-features/).","required":false,"schema":{"type":"boolean"}},{"name":"mime_types","in":"query","description":"A comma-separated list of preferred MIME types in order of priority. If supported by the third-party provider, the file(s) will be returned in the first supported MIME type from the list. The default MIME type is PDF. To see supported MIME types by file type, refer to our export format help center article.","required":false,"schema":{"type":"string"}},{"name":"modified_after","in":"query","description":"If provided, will only return objects modified after this datetime.","required":false,"schema":{"type":"string"}},{"name":"modified_before","in":"query","description":"If provided, will only return objects modified before this datetime.","required":false,"schema":{"type":"string"}},{"name":"order_by","in":"query","description":"Overrides the default ordering for this endpoint. Possible values include: created_at, -created_at, modified_at, -modified_at.","required":false,"schema":{"$ref":"#/components/schemas/FilesDownloadRequestMetaGetParametersOrderBy"}},{"name":"page_size","in":"query","description":"Number of results to return per page. The maximum limit is 100.","required":false,"schema":{"type":"integer"}},{"name":"X-Account-Token","in":"header","description":"Token identifying the end user.","required":true,"schema":{"type":"string"}}],"responses":{"200":{"description":"","content":{"application/json":{"schema":{"$ref":"#/components/schemas/PaginatedDownloadRequestMetaList"}}}}},"security":[{"tokenAuth":[]}]}},"/filestorage/v1/files/meta/post":{"get":{"operationId":"files_metaPostRetrieve","summary":"Meta Post Retrieve","description":"Returns metadata for `FileStorageFile` POSTs.{/* BEGIN_FILESTORAGE_FILE_FETCH_SUPPORTED_FIELDS */}{/* END_FILESTORAGE_FILE_FETCH_SUPPORTED_FIELDS */}","tags":["files"],"parameters":[{"name":"X-Account-Token","in":"header","description":"Token identifying the end user.","required":true,"schema":{"type":"string"}}],"responses":{"200":{"description":"","content":{"application/json":{"schema":{"$ref":"#/components/schemas/MetaResponse"}}}}},"security":[{"tokenAuth":[]}]}},"/filestorage/v1/folders":{"get":{"operationId":"folders_list","summary":"List","description":"Returns a list of `Folder` objects.{/* BEGIN_FILESTORAGE_FOLDER_FETCH_SUPPORTED_FIELDS */}{/* END_FILESTORAGE_FOLDER_FETCH_SUPPORTED_FIELDS */}","tags":["folders"],"parameters":[{"name":"created_after","in":"query","description":"If provided, will only return objects created after this datetime.","required":false,"schema":{"type":"string","format":"date-time"}},{"name":"created_before","in":"query","description":"If provided, will only return objects created before this datetime.","required":false,"schema":{"type":"string","format":"date-time"}},{"name":"cursor","in":"query","description":"The pagination cursor value.","required":false,"schema":{"type":"string"}},{"name":"drive_id","in":"query","description":"If provided, will only return folders in this drive.","required":false,"schema":{"type":"string"}},{"name":"expand","in":"query","description":"Which relations should be returned in expanded form. Multiple relation names should be comma separated without spaces.","required":false,"schema":{"type":"array","items":{"$ref":"#/components/schemas/FoldersGetParametersExpandSchemaItems"}}},{"name":"include_deleted_data","in":"query","description":"Indicates whether or not this object has been deleted in the third party platform. Full coverage deletion detection is a premium add-on. Native deletion detection is offered for free with limited coverage. [Learn more](https://docs.merge.dev/integrations/hris/supported-features/).","required":false,"schema":{"type":"boolean"}},{"name":"include_remote_data","in":"query","description":"Whether to include the original data Merge fetched from the third-party to produce these models.","required":false,"schema":{"type":"boolean"}},{"name":"include_shell_data","in":"query","description":"Whether to include shell records. Shell records are empty records (they may contain some metadata but all other fields are null).","required":false,"schema":{"type":"boolean"}},{"name":"modified_after","in":"query","description":"If provided, only objects synced by Merge after this date time will be returned.","required":false,"schema":{"type":"string","format":"date-time"}},{"name":"modified_before","in":"query","description":"If provided, only objects synced by Merge before this date time will be returned.","required":false,"schema":{"type":"string","format":"date-time"}},{"name":"name","in":"query","description":"If provided, will only return folders with this name. This performs an exact match.","required":false,"schema":{"type":"string"}},{"name":"page_size","in":"query","description":"Number of results to return per page. The maximum limit is 100.","required":false,"schema":{"type":"integer"}},{"name":"parent_folder_id","in":"query","description":"If provided, will only return folders in this parent folder. If null, will return folders in root directory.","required":false,"schema":{"type":"string"}},{"name":"remote_id","in":"query","description":"The API provider's ID for the given object.","required":false,"schema":{"type":"string"}},{"name":"X-Account-Token","in":"header","description":"Token identifying the end user.","required":true,"schema":{"type":"string"}}],"responses":{"200":{"description":"","content":{"application/json":{"schema":{"$ref":"#/components/schemas/PaginatedFolderList"}}}}},"security":[{"tokenAuth":[]}]},"post":{"operationId":"folders_create","summary":"Create","description":"Creates a `Folder` object with the given values.{/* BEGIN_FILESTORAGE_FOLDER_CREATE_SUPPORTED_FIELDS */}{/* END_FILESTORAGE_FOLDER_CREATE_SUPPORTED_FIELDS */}","tags":["folders"],"parameters":[{"name":"is_debug_mode","in":"query","description":"Whether to include debug fields (such as log file links) in the response.","required":false,"schema":{"type":"boolean"}},{"name":"run_async","in":"query","description":"Whether or not third-party updates should be run asynchronously.","required":false,"schema":{"type":"boolean"}},{"name":"X-Account-Token","in":"header","description":"Token identifying the end user.","required":true,"schema":{"type":"string"}}],"responses":{"201":{"description":"","content":{"application/json":{"schema":{"$ref":"#/components/schemas/FileStorageFolderResponse"}}}}},"requestBody":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/FileStorageFolderEndpointRequest"}}}},"security":[{"tokenAuth":[]}]}},"/filestorage/v1/folders/{id}":{"get":{"operationId":"folders_retrieve","summary":"Retrieve","description":"Returns a `Folder` object with the given `id`.{/* BEGIN_FILESTORAGE_FOLDER_FETCH_SUPPORTED_FIELDS */}{/* END_FILESTORAGE_FOLDER_FETCH_SUPPORTED_FIELDS */}","tags":["folders"],"parameters":[{"name":"id","in":"path","required":true,"schema":{"type":"string","format":"uuid"}},{"name":"expand","in":"query","description":"Which relations should be returned in expanded form. Multiple relation names should be comma separated without spaces.","required":false,"schema":{"type":"array","items":{"$ref":"#/components/schemas/FoldersIdGetParametersExpandSchemaItems"}}},{"name":"include_remote_data","in":"query","description":"Whether to include the original data Merge fetched from the third-party to produce these models.","required":false,"schema":{"type":"boolean"}},{"name":"include_shell_data","in":"query","description":"Whether to include shell records. Shell records are empty records (they may contain some metadata but all other fields are null).","required":false,"schema":{"type":"boolean"}},{"name":"X-Account-Token","in":"header","description":"Token identifying the end user.","required":true,"schema":{"type":"string"}}],"responses":{"200":{"description":"","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Folder"}}}}},"security":[{"tokenAuth":[]}]}},"/filestorage/v1/folders/meta/post":{"get":{"operationId":"folders_metaPostRetrieve","summary":"Meta Post Retrieve","description":"Returns metadata for `FileStorageFolder` POSTs.{/* BEGIN_FILESTORAGE_FOLDER_FETCH_SUPPORTED_FIELDS */}{/* END_FILESTORAGE_FOLDER_FETCH_SUPPORTED_FIELDS */}","tags":["folders"],"parameters":[{"name":"X-Account-Token","in":"header","description":"Token identifying the end user.","required":true,"schema":{"type":"string"}}],"responses":{"200":{"description":"","content":{"application/json":{"schema":{"$ref":"#/components/schemas/MetaResponse"}}}}},"security":[{"tokenAuth":[]}]}},"/filestorage/v1/groups":{"get":{"operationId":"groups_list","summary":"List","description":"Returns a list of `Group` objects.{/* BEGIN_FILESTORAGE_GROUP_FETCH_SUPPORTED_FIELDS */}{/* END_FILESTORAGE_GROUP_FETCH_SUPPORTED_FIELDS */}","tags":["groups"],"parameters":[{"name":"created_after","in":"query","description":"If provided, will only return objects created after this datetime.","required":false,"schema":{"type":"string","format":"date-time"}},{"name":"created_before","in":"query","description":"If provided, will only return objects created before this datetime.","required":false,"schema":{"type":"string","format":"date-time"}},{"name":"cursor","in":"query","description":"The pagination cursor value.","required":false,"schema":{"type":"string"}},{"name":"expand","in":"query","description":"Which relations should be returned in expanded form. Multiple relation names should be comma separated without spaces.","required":false,"schema":{"type":"array","items":{"$ref":"#/components/schemas/GroupsGetParametersExpandSchemaItems"}}},{"name":"include_deleted_data","in":"query","description":"Indicates whether or not this object has been deleted in the third party platform. Full coverage deletion detection is a premium add-on. Native deletion detection is offered for free with limited coverage. [Learn more](https://docs.merge.dev/integrations/hris/supported-features/).","required":false,"schema":{"type":"boolean"}},{"name":"include_remote_data","in":"query","description":"Whether to include the original data Merge fetched from the third-party to produce these models.","required":false,"schema":{"type":"boolean"}},{"name":"include_shell_data","in":"query","description":"Whether to include shell records. Shell records are empty records (they may contain some metadata but all other fields are null).","required":false,"schema":{"type":"boolean"}},{"name":"modified_after","in":"query","description":"If provided, only objects synced by Merge after this date time will be returned.","required":false,"schema":{"type":"string","format":"date-time"}},{"name":"modified_before","in":"query","description":"If provided, only objects synced by Merge before this date time will be returned.","required":false,"schema":{"type":"string","format":"date-time"}},{"name":"page_size","in":"query","description":"Number of results to return per page. The maximum limit is 100.","required":false,"schema":{"type":"integer"}},{"name":"remote_id","in":"query","description":"The API provider's ID for the given object.","required":false,"schema":{"type":"string"}},{"name":"X-Account-Token","in":"header","description":"Token identifying the end user.","required":true,"schema":{"type":"string"}}],"responses":{"200":{"description":"","content":{"application/json":{"schema":{"$ref":"#/components/schemas/PaginatedGroupList"}}}}},"security":[{"tokenAuth":[]}]}},"/filestorage/v1/groups/{id}":{"get":{"operationId":"groups_retrieve","summary":"Retrieve","description":"Returns a `Group` object with the given `id`.{/* BEGIN_FILESTORAGE_GROUP_FETCH_SUPPORTED_FIELDS */}{/* END_FILESTORAGE_GROUP_FETCH_SUPPORTED_FIELDS */}","tags":["groups"],"parameters":[{"name":"id","in":"path","required":true,"schema":{"type":"string","format":"uuid"}},{"name":"expand","in":"query","description":"Which relations should be returned in expanded form. Multiple relation names should be comma separated without spaces.","required":false,"schema":{"type":"array","items":{"$ref":"#/components/schemas/GroupsIdGetParametersExpandSchemaItems"}}},{"name":"include_remote_data","in":"query","description":"Whether to include the original data Merge fetched from the third-party to produce these models.","required":false,"schema":{"type":"boolean"}},{"name":"include_shell_data","in":"query","description":"Whether to include shell records. Shell records are empty records (they may contain some metadata but all other fields are null).","required":false,"schema":{"type":"boolean"}},{"name":"X-Account-Token","in":"header","description":"Token identifying the end user.","required":true,"schema":{"type":"string"}}],"responses":{"200":{"description":"","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Group"}}}}},"security":[{"tokenAuth":[]}]}},"/filestorage/v1/users":{"get":{"operationId":"users_list","summary":"List","description":"Returns a list of `User` objects.{/* BEGIN_FILESTORAGE_USER_FETCH_SUPPORTED_FIELDS */}{/* END_FILESTORAGE_USER_FETCH_SUPPORTED_FIELDS */}","tags":["users"],"parameters":[{"name":"created_after","in":"query","description":"If provided, will only return objects created after this datetime.","required":false,"schema":{"type":"string","format":"date-time"}},{"name":"created_before","in":"query","description":"If provided, will only return objects created before this datetime.","required":false,"schema":{"type":"string","format":"date-time"}},{"name":"cursor","in":"query","description":"The pagination cursor value.","required":false,"schema":{"type":"string"}},{"name":"email_address","in":"query","description":"If provided, will only return users with emails equal to this value (case insensitive).","required":false,"schema":{"type":"string"}},{"name":"include_deleted_data","in":"query","description":"Indicates whether or not this object has been deleted in the third party platform. Full coverage deletion detection is a premium add-on. Native deletion detection is offered for free with limited coverage. [Learn more](https://docs.merge.dev/integrations/hris/supported-features/).","required":false,"schema":{"type":"boolean"}},{"name":"include_remote_data","in":"query","description":"Whether to include the original data Merge fetched from the third-party to produce these models.","required":false,"schema":{"type":"boolean"}},{"name":"include_shell_data","in":"query","description":"Whether to include shell records. Shell records are empty records (they may contain some metadata but all other fields are null).","required":false,"schema":{"type":"boolean"}},{"name":"is_me","in":"query","description":"If provided, will only return the user object for requestor.","required":false,"schema":{"type":"string"}},{"name":"modified_after","in":"query","description":"If provided, only objects synced by Merge after this date time will be returned.","required":false,"schema":{"type":"string","format":"date-time"}},{"name":"modified_before","in":"query","description":"If provided, only objects synced by Merge before this date time will be returned.","required":false,"schema":{"type":"string","format":"date-time"}},{"name":"page_size","in":"query","description":"Number of results to return per page. The maximum limit is 100.","required":false,"schema":{"type":"integer"}},{"name":"remote_id","in":"query","description":"The API provider's ID for the given object.","required":false,"schema":{"type":"string"}},{"name":"X-Account-Token","in":"header","description":"Token identifying the end user.","required":true,"schema":{"type":"string"}}],"responses":{"200":{"description":"","content":{"application/json":{"schema":{"$ref":"#/components/schemas/PaginatedUserList"}}}}},"security":[{"tokenAuth":[]}]}},"/filestorage/v1/users/{id}":{"get":{"operationId":"users_retrieve","summary":"Retrieve","description":"Returns a `User` object with the given `id`.{/* BEGIN_FILESTORAGE_USER_FETCH_SUPPORTED_FIELDS */}{/* END_FILESTORAGE_USER_FETCH_SUPPORTED_FIELDS */}","tags":["users"],"parameters":[{"name":"id","in":"path","required":true,"schema":{"type":"string","format":"uuid"}},{"name":"include_remote_data","in":"query","description":"Whether to include the original data Merge fetched from the third-party to produce these models.","required":false,"schema":{"type":"boolean"}},{"name":"include_shell_data","in":"query","description":"Whether to include shell records. Shell records are empty records (they may contain some metadata but all other fields are null).","required":false,"schema":{"type":"boolean"}},{"name":"X-Account-Token","in":"header","description":"Token identifying the end user.","required":true,"schema":{"type":"string"}}],"responses":{"200":{"description":"","content":{"application/json":{"schema":{"$ref":"#/components/schemas/User"}}}}},"security":[{"tokenAuth":[]}]}},"/filestorage/v1/account-details":{"get":{"operationId":"accountDetails_retrieve","summary":"Retrieve","description":"Get details for a linked account.","tags":["accountDetails"],"parameters":[{"name":"X-Account-Token","in":"header","description":"Token identifying the end user.","required":true,"schema":{"type":"string"}}],"responses":{"200":{"description":"","content":{"application/json":{"schema":{"$ref":"#/components/schemas/AccountDetails"}}}}},"security":[{"tokenAuth":[]}]}},"/filestorage/v1/account-token/{public_token}":{"get":{"operationId":"accountToken_retrieve","summary":"Retrieve","description":"Returns the account token for the end user with the provided public token.","tags":["accountToken"],"parameters":[{"name":"public_token","in":"path","required":true,"schema":{"type":"string"}}],"responses":{"200":{"description":"","content":{"application/json":{"schema":{"$ref":"#/components/schemas/AccountToken"}}}}},"security":[{"tokenAuth":[]}]}},"/filestorage/v1/account-token/regenerate":{"post":{"operationId":"accountToken_regenerateCreate","summary":"Regenerate Create","description":"Exchange Linked Account account tokens.","tags":["accountToken"],"parameters":[{"name":"X-Account-Token","in":"header","description":"Token identifying the end user.","required":true,"schema":{"type":"string"}}],"responses":{"200":{"description":"","content":{"application/json":{"schema":{"$ref":"#/components/schemas/RegenerateAccountToken"}}}}},"security":[{"tokenAuth":[]}]}},"/filestorage/v1/delete-account":{"post":{"operationId":"deleteAccount_delete","summary":"Delete","description":"Delete a linked account.","tags":["deleteAccount"],"parameters":[{"name":"X-Account-Token","in":"header","description":"Token identifying the end user.","required":true,"schema":{"type":"string"}}],"responses":{"200":{"description":"No response body","content":{"application/json":{"schema":{"$ref":"#/components/schemas/deleteAccount_delete_Response_200"}}}}},"security":[{"tokenAuth":[]}]}},"/filestorage/v1/issues":{"get":{"operationId":"issues_list","summary":"List","description":"Gets all issues for Organization.","tags":["issues"],"parameters":[{"name":"account_token","in":"query","required":false,"schema":{"type":"string"}},{"name":"cursor","in":"query","description":"The pagination cursor value.","required":false,"schema":{"type":"string"}},{"name":"end_date","in":"query","description":"If included, will only include issues whose most recent action occurred before this time","required":false,"schema":{"type":"string"}},{"name":"end_user_organization_name","in":"query","required":false,"schema":{"type":"string"}},{"name":"first_incident_time_after","in":"query","description":"If provided, will only return issues whose first incident time was after this datetime.","required":false,"schema":{"type":"string","format":"date-time"}},{"name":"first_incident_time_before","in":"query","description":"If provided, will only return issues whose first incident time was before this datetime.","required":false,"schema":{"type":"string","format":"date-time"}},{"name":"include_muted","in":"query","description":"If true, will include muted issues","required":false,"schema":{"type":"string"}},{"name":"integration_name","in":"query","required":false,"schema":{"type":"string"}},{"name":"last_incident_time_after","in":"query","description":"If provided, will only return issues whose last incident time was after this datetime.","required":false,"schema":{"type":"string","format":"date-time"}},{"name":"last_incident_time_before","in":"query","description":"If provided, will only return issues whose last incident time was before this datetime.","required":false,"schema":{"type":"string","format":"date-time"}},{"name":"linked_account_id","in":"query","description":"If provided, will only include issues pertaining to the linked account passed in.","required":false,"schema":{"type":"string"}},{"name":"page_size","in":"query","description":"Number of results to return per page. The maximum limit is 100.","required":false,"schema":{"type":"integer"}},{"name":"start_date","in":"query","description":"If included, will only include issues whose most recent action occurred after this time","required":false,"schema":{"type":"string"}},{"name":"status","in":"query","description":"Status of the issue.","required":false,"schema":{"$ref":"#/components/schemas/IssuesGetParametersStatus"}}],"responses":{"200":{"description":"","content":{"application/json":{"schema":{"$ref":"#/components/schemas/PaginatedIssueList"}}}}},"security":[{"tokenAuth":[]}]}},"/filestorage/v1/issues/{id}":{"get":{"operationId":"issues_retrieve","summary":"Retrieve","description":"Get a specific issue.","tags":["issues"],"parameters":[{"name":"id","in":"path","required":true,"schema":{"type":"string","format":"uuid"}}],"responses":{"200":{"description":"","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Issue"}}}}},"security":[{"tokenAuth":[]}]}},"/filestorage/v1/linked-accounts":{"get":{"operationId":"linkedAccounts_list","summary":"List","description":"List linked accounts for your organization.","tags":["linkedAccounts"],"parameters":[{"name":"category","in":"query","description":"Options: `hris`, `ats`, `accounting`, `ticketing`, `crm`, `mktg`, `filestorage`, `knowledgebase`, `chat`","required":false,"schema":{"$ref":"#/components/schemas/LinkedAccountsGetParametersCategory"}},{"name":"cursor","in":"query","description":"The pagination cursor value.","required":false,"schema":{"type":"string"}},{"name":"end_user_email_address","in":"query","description":"If provided, will only return linked accounts associated with the given email address.","required":false,"schema":{"type":"string"}},{"name":"end_user_organization_name","in":"query","description":"If provided, will only return linked accounts associated with the given organization name.","required":false,"schema":{"type":"string"}},{"name":"end_user_origin_id","in":"query","description":"If provided, will only return linked accounts associated with the given origin ID.","required":false,"schema":{"type":"string"}},{"name":"end_user_origin_ids","in":"query","description":"Comma-separated list of EndUser origin IDs, making it possible to specify multiple EndUsers at once.","required":false,"schema":{"type":"string"}},{"name":"id","in":"query","required":false,"schema":{"type":"string","format":"uuid"}},{"name":"ids","in":"query","description":"Comma-separated list of LinkedAccount IDs, making it possible to specify multiple LinkedAccounts at once.","required":false,"schema":{"type":"string"}},{"name":"include_duplicates","in":"query","description":"If `true`, will include complete production duplicates of the account specified by the `id` query parameter in the response. `id` must be for a complete production linked account.","required":false,"schema":{"type":"boolean"}},{"name":"integration_name","in":"query","description":"If provided, will only return linked accounts associated with the given integration name.","required":false,"schema":{"type":"string"}},{"name":"is_test_account","in":"query","description":"If included, will only include test linked accounts. If not included, will only include non-test linked accounts.","required":false,"schema":{"type":"string"}},{"name":"page_size","in":"query","description":"Number of results to return per page. The maximum limit is 100.","required":false,"schema":{"type":"integer"}},{"name":"status","in":"query","description":"Filter by status. Options: `COMPLETE`, `IDLE`, `INCOMPLETE`, `RELINK_NEEDED`","required":false,"schema":{"type":"string"}}],"responses":{"200":{"description":"","content":{"application/json":{"schema":{"$ref":"#/components/schemas/PaginatedAccountDetailsAndActionsList"}}}}},"security":[{"tokenAuth":[]}]}},"/filestorage/v1/link-token":{"post":{"operationId":"linkToken_create","summary":"Create","description":"Creates a link token to be used when linking a new end user. The link token expires after single use.","tags":["linkToken"],"responses":{"200":{"description":"","content":{"application/json":{"schema":{"$ref":"#/components/schemas/LinkToken"}}}}},"requestBody":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/EndUserDetailsRequest"}}}},"security":[{"tokenAuth":[]}]}},"/filestorage/v1/field-mappings":{"get":{"operationId":"fieldMapping_field_mappings_retrieve","summary":"Field Mappings Retrieve","description":"Get all Field Mappings for this Linked Account. Field Mappings are mappings between third-party Remote Fields and user defined Merge fields. [Learn more](https://docs.merge.dev/supplemental-data/field-mappings/overview/).","tags":["fieldMapping"],"parameters":[{"name":"exclude_remote_field_metadata","in":"query","description":"If `true`, remote fields metadata is excluded from each field mapping instance (i.e. `remote_fields.remote_key_name` and `remote_fields.schema` will be null). This will increase the speed of the request since these fields require some calculations.","required":false,"schema":{"type":"boolean"}},{"name":"X-Account-Token","in":"header","description":"Token identifying the end user.","required":true,"schema":{"type":"string"}}],"responses":{"200":{"description":"","content":{"application/json":{"schema":{"$ref":"#/components/schemas/FieldMappingApiInstanceResponse"}}}}},"security":[{"tokenAuth":[]}]},"post":{"operationId":"fieldMapping_field_mappings_create","summary":"Field Mappings Create","description":"Create new Field Mappings that will be available after the next scheduled sync. This will cause the next sync for this Linked Account to sync **ALL** data from start.","tags":["fieldMapping"],"parameters":[{"name":"exclude_remote_field_metadata","in":"query","description":"If `true`, remote fields metadata is excluded from each field mapping instance (i.e. `remote_fields.remote_key_name` and `remote_fields.schema` will be null). This will increase the speed of the request since these fields require some calculations.","required":false,"schema":{"type":"boolean"}},{"name":"remote_data_iteration_count","in":"query","description":"Number of common model instances to iterate through when fetching remote data for field mappings. Defaults to 250 if not provided.","required":false,"schema":{"type":"integer"}},{"name":"X-Account-Token","in":"header","description":"Token identifying the end user.","required":true,"schema":{"type":"string"}}],"responses":{"201":{"description":"","content":{"application/json":{"schema":{"$ref":"#/components/schemas/FieldMappingInstanceResponse"}}}}},"requestBody":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/CreateFieldMappingRequest"}}}},"security":[{"tokenAuth":[]}]}},"/filestorage/v1/field-mappings/{field_mapping_id}":{"delete":{"operationId":"fieldMapping_field_mappings_destroy","summary":"Field Mappings Destroy","description":"Deletes Field Mappings for a Linked Account. All data related to this Field Mapping will be deleted and these changes will be reflected after the next scheduled sync. This will cause the next sync for this Linked Account to sync **ALL** data from start.","tags":["fieldMapping"],"parameters":[{"name":"field_mapping_id","in":"path","required":true,"schema":{"type":"string","format":"uuid"}},{"name":"X-Account-Token","in":"header","description":"Token identifying the end user.","required":true,"schema":{"type":"string"}}],"responses":{"204":{"description":"","content":{"application/json":{"schema":{"$ref":"#/components/schemas/FieldMappingInstanceResponse"}}}}},"security":[{"tokenAuth":[]}]},"patch":{"operationId":"fieldMapping_field_mappings_partial_update","summary":"Field Mappings Partial Update","description":"Create or update existing Field Mappings for a Linked Account. Changes will be reflected after the next scheduled sync. This will cause the next sync for this Linked Account to sync **ALL** data from start.","tags":["fieldMapping"],"parameters":[{"name":"field_mapping_id","in":"path","required":true,"schema":{"type":"string","format":"uuid"}},{"name":"remote_data_iteration_count","in":"query","description":"Number of common model instances to iterate through when fetching remote data for field mappings. Defaults to 250 if not provided.","required":false,"schema":{"type":"integer"}},{"name":"X-Account-Token","in":"header","description":"Token identifying the end user.","required":true,"schema":{"type":"string"}}],"responses":{"200":{"description":"","content":{"application/json":{"schema":{"$ref":"#/components/schemas/FieldMappingInstanceResponse"}}}}},"requestBody":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/PatchedEditFieldMappingRequest"}}}},"security":[{"tokenAuth":[]}]}},"/filestorage/v1/remote-fields":{"get":{"operationId":"fieldMapping_remote_fields_retrieve","summary":"Remote Fields Retrieve","description":"Get all remote fields for a Linked Account. Remote fields are third-party fields that are accessible after initial sync if remote_data is enabled. You can use remote fields to override existing Merge fields or map a new Merge field. [Learn more](https://docs.merge.dev/supplemental-data/field-mappings/overview/).","tags":["fieldMapping"],"parameters":[{"name":"common_models","in":"query","description":"A comma seperated list of Common Model names. If included, will only return Remote Fields for those Common Models.","required":false,"schema":{"type":"string"}},{"name":"include_example_values","in":"query","description":"If true, will include example values, where available, for remote fields in the 3rd party platform. These examples come from active data from your customers.","required":false,"schema":{"type":"string"}},{"name":"X-Account-Token","in":"header","description":"Token identifying the end user.","required":true,"schema":{"type":"string"}}],"responses":{"200":{"description":"","content":{"application/json":{"schema":{"$ref":"#/components/schemas/RemoteFieldAPIResponse"}}}}},"security":[{"tokenAuth":[]}]}},"/filestorage/v1/target-fields":{"get":{"operationId":"fieldMapping_target_fields_retrieve","summary":"Target Fields Retrieve","description":"Get all organization-wide Target Fields, this will not include any Linked Account specific Target Fields. Organization-wide Target Fields are additional fields appended to the Merge Common Model for all Linked Accounts in a category. [Learn more](https://docs.merge.dev/supplemental-data/field-mappings/target-fields/).","tags":["fieldMapping"],"parameters":[{"name":"X-Account-Token","in":"header","description":"Token identifying the end user.","required":true,"schema":{"type":"string"}}],"responses":{"200":{"description":"","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ExternalTargetFieldAPIResponse"}}}}},"security":[{"tokenAuth":[]}]},"post":{"operationId":"fieldMapping_target_fields_create","summary":"Target Fields Create","description":"Create a new organization-wide Target Field. Target Fields are custom fields that your organization defines to collect supplemental data from integrations. [Learn more](https://docs.merge.dev/supplemental-data/field-mappings/target-fields/).","tags":["fieldMapping"],"parameters":[{"name":"X-Account-Token","in":"header","description":"Token identifying the end user.","required":true,"schema":{"type":"string"}}],"responses":{"200":{"description":"","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ExternalTargetFieldAPIResponse"}}}}},"requestBody":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/CreateTargetFieldRequest"}}}},"security":[{"tokenAuth":[]}]}},"/filestorage/v1/available-actions":{"get":{"operationId":"availableActions_retrieve","summary":"Retrieve","description":"Returns a list of models and actions available for an account.","tags":["availableActions"],"parameters":[{"name":"X-Account-Token","in":"header","description":"Token identifying the end user.","required":true,"schema":{"type":"string"}}],"responses":{"200":{"description":"","content":{"application/json":{"schema":{"$ref":"#/components/schemas/AvailableActions"}}}}},"security":[{"tokenAuth":[]}]}},"/filestorage/v1/default-scopes":{"get":{"operationId":"scopes_default_scopes_retrieve","summary":"Default Scopes Retrieve","description":"Get the default permissions for Merge Common Models and fields across all Linked Accounts of a given category. [Learn more](https://help.merge.dev/en/articles/5950052-common-model-and-field-scopes).","tags":["scopes"],"responses":{"200":{"description":"","content":{"application/json":{"schema":{"$ref":"#/components/schemas/CommonModelScopeAPI"}}}}},"security":[{"tokenAuth":[]}]}},"/filestorage/v1/linked-account-scopes":{"get":{"operationId":"scopes_linked_account_scopes_retrieve","summary":"Linked Account Scopes Retrieve","description":"Get all available permissions for Merge Common Models and fields for a single Linked Account. [Learn more](https://help.merge.dev/en/articles/5950052-common-model-and-field-scopes).","tags":["scopes"],"parameters":[{"name":"X-Account-Token","in":"header","description":"Token identifying the end user.","required":true,"schema":{"type":"string"}}],"responses":{"200":{"description":"","content":{"application/json":{"schema":{"$ref":"#/components/schemas/CommonModelScopeAPI"}}}}},"security":[{"tokenAuth":[]}]},"post":{"operationId":"scopes_linked_account_scopes_create","summary":"Linked Account Scopes Create","description":"Update permissions for any Common Model or field for a single Linked Account. Any Scopes not set in this POST request will inherit the default Scopes. [Learn more](https://help.merge.dev/en/articles/5950052-common-model-and-field-scopes)","tags":["scopes"],"parameters":[{"name":"X-Account-Token","in":"header","description":"Token identifying the end user.","required":true,"schema":{"type":"string"}}],"responses":{"200":{"description":"","content":{"application/json":{"schema":{"$ref":"#/components/schemas/CommonModelScopeAPI"}}}}},"requestBody":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/LinkedAccountCommonModelScopeDeserializerRequest"}}}},"security":[{"tokenAuth":[]}]}},"/filestorage/v1/sync-status/resync":{"post":{"operationId":"forceResync_sync_status_resync_create","summary":"Sync Status Resync Create","description":"Force re-sync of all models. This endpoint is available for monthly, quarterly, and highest sync frequency customers on the Professional or Enterprise plans. Doing so will consume a sync credit for the relevant linked account. Force re-syncs can also be triggered manually in the Merge Dashboard and is available for all customers.","tags":["forceResync"],"parameters":[{"name":"X-Account-Token","in":"header","description":"Token identifying the end user.","required":true,"schema":{"type":"string"}}],"responses":{"200":{"description":"","content":{"application/json":{"schema":{"type":"array","items":{"$ref":"#/components/schemas/SyncStatus"}}}}}},"security":[{"tokenAuth":[]}]}},"/filestorage/v1/passthrough":{"post":{"operationId":"passthrough_create","summary":"Create","description":"Pull data from an endpoint not currently supported by Merge.","tags":["passthrough"],"parameters":[{"name":"X-Account-Token","in":"header","description":"Token identifying the end user.","required":true,"schema":{"type":"string"}}],"responses":{"200":{"description":"","content":{"application/json":{"schema":{"$ref":"#/components/schemas/RemoteResponse"}}}}},"requestBody":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/DataPassthroughRequest"}}}},"security":[{"tokenAuth":[]}]}},"/filestorage/v1/async-passthrough":{"post":{"operationId":"asyncPassthrough_create","summary":"Create","description":"Asynchronously pull data from an endpoint not currently supported by Merge.","tags":["asyncPassthrough"],"parameters":[{"name":"X-Account-Token","in":"header","description":"Token identifying the end user.","required":true,"schema":{"type":"string"}}],"responses":{"200":{"description":"","content":{"application/json":{"schema":{"$ref":"#/components/schemas/AsyncPassthroughReciept"}}}}},"requestBody":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/DataPassthroughRequest"}}}},"security":[{"tokenAuth":[]}]}},"/filestorage/v1/async-passthrough/{async_passthrough_receipt_id}":{"get":{"operationId":"asyncPassthrough_retrieve","summary":"Retrieve","description":"Retrieves data from earlier async-passthrough POST request","tags":["asyncPassthrough"],"parameters":[{"name":"async_passthrough_receipt_id","in":"path","required":true,"schema":{"type":"string","format":"uuid"}},{"name":"X-Account-Token","in":"header","description":"Token identifying the end user.","required":true,"schema":{"type":"string"}}],"responses":{"200":{"description":"","content":{"application/json":{"schema":{"$ref":"#/components/schemas/RemoteResponse"}}}}},"security":[{"tokenAuth":[]}]}},"/filestorage/v1/sync-status":{"get":{"operationId":"syncStatus_list","summary":"List","description":"Get sync status for the current sync and the most recently finished sync. `last_sync_start` represents the most recent time any sync began. `last_sync_finished` represents the most recent time any sync completed. These timestamps may correspond to different sync instances which may result in a sync start time being later than a separate sync completed time. To ensure you are retrieving the latest available data reference the `last_sync_finished` timestamp where `last_sync_result` is `DONE`. Possible values for `status` and `last_sync_result` are `DISABLED`, `DONE`, `FAILED`, `PARTIALLY_SYNCED`, `PAUSED`, `SYNCING`. Learn more about sync status in our [Help Center](https://help.merge.dev/en/articles/8184193-merge-sync-statuses).","tags":["syncStatus"],"parameters":[{"name":"cursor","in":"query","description":"The pagination cursor value.","required":false,"schema":{"type":"string"}},{"name":"page_size","in":"query","description":"Number of results to return per page. The maximum limit is 100.","required":false,"schema":{"type":"integer"}},{"name":"X-Account-Token","in":"header","description":"Token identifying the end user.","required":true,"schema":{"type":"string"}}],"responses":{"200":{"description":"","content":{"application/json":{"schema":{"$ref":"#/components/schemas/PaginatedSyncStatusList"}}}}},"security":[{"tokenAuth":[]}]}},"/filestorage/v1/generate-key":{"post":{"operationId":"generateKey_create","summary":"Create","description":"Create a remote key.","tags":["generateKey"],"responses":{"200":{"description":"","content":{"application/json":{"schema":{"$ref":"#/components/schemas/RemoteKey"}}}}},"requestBody":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/GenerateRemoteKeyRequest"}}}},"security":[{"tokenAuth":[]}]}},"/filestorage/v1/regenerate-key":{"post":{"operationId":"regenerateKey_create","summary":"Create","description":"Exchange remote keys.","tags":["regenerateKey"],"responses":{"200":{"description":"","content":{"application/json":{"schema":{"$ref":"#/components/schemas/RemoteKey"}}}}},"requestBody":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/RemoteKeyForRegenerationRequest"}}}},"security":[{"tokenAuth":[]}]}},"/filestorage/v1/audit-trail":{"get":{"operationId":"auditTrail_list","summary":"List","description":"Gets a list of audit trail events.","tags":["auditTrail"],"parameters":[{"name":"cursor","in":"query","description":"The pagination cursor value.","required":false,"schema":{"type":"string"}},{"name":"end_date","in":"query","description":"If included, will only include audit trail events that occurred before this time","required":false,"schema":{"type":"string"}},{"name":"event_type","in":"query","description":"If included, will only include events with the given event type. Possible values include: `CREATED_REMOTE_PRODUCTION_API_KEY`, `DELETED_REMOTE_PRODUCTION_API_KEY`, `CREATED_TEST_API_KEY`, `DELETED_TEST_API_KEY`, `REGENERATED_PRODUCTION_API_KEY`, `REGENERATED_WEBHOOK_SIGNATURE`, `INVITED_USER`, `TWO_FACTOR_AUTH_ENABLED`, `TWO_FACTOR_AUTH_DISABLED`, `DELETED_LINKED_ACCOUNT`, `DELETED_ALL_COMMON_MODELS_FOR_LINKED_ACCOUNT`, `CREATED_DESTINATION`, `DELETED_DESTINATION`, `CHANGED_DESTINATION`, `CHANGED_SCOPES`, `CHANGED_PERSONAL_INFORMATION`, `CHANGED_ORGANIZATION_SETTINGS`, `ENABLED_INTEGRATION`, `DISABLED_INTEGRATION`, `ENABLED_CATEGORY`, `DISABLED_CATEGORY`, `CHANGED_PASSWORD`, `RESET_PASSWORD`, `ENABLED_REDACT_UNMAPPED_DATA_FOR_ORGANIZATION`, `ENABLED_REDACT_UNMAPPED_DATA_FOR_LINKED_ACCOUNT`, `DISABLED_REDACT_UNMAPPED_DATA_FOR_ORGANIZATION`, `DISABLED_REDACT_UNMAPPED_DATA_FOR_LINKED_ACCOUNT`, `CREATED_INTEGRATION_WIDE_FIELD_MAPPING`, `CREATED_LINKED_ACCOUNT_FIELD_MAPPING`, `CHANGED_INTEGRATION_WIDE_FIELD_MAPPING`, `CHANGED_LINKED_ACCOUNT_FIELD_MAPPING`, `DELETED_INTEGRATION_WIDE_FIELD_MAPPING`, `DELETED_LINKED_ACCOUNT_FIELD_MAPPING`, `CREATED_LINKED_ACCOUNT_COMMON_MODEL_OVERRIDE`, `CHANGED_LINKED_ACCOUNT_COMMON_MODEL_OVERRIDE`, `DELETED_LINKED_ACCOUNT_COMMON_MODEL_OVERRIDE`, `FORCED_LINKED_ACCOUNT_RESYNC`, `MUTED_ISSUE`, `GENERATED_MAGIC_LINK`, `ENABLED_MERGE_WEBHOOK`, `DISABLED_MERGE_WEBHOOK`, `MERGE_WEBHOOK_TARGET_CHANGED`, `END_USER_CREDENTIALS_ACCESSED`, `CHANGED_SELECTIVE_SYNC_FILTERS`, `ADDED_PARTNER_CREDENTIALS`, `UPDATED_PARTNER_CREDENTIALS`, `REMOVED_PARTNER_CREDENTIALS`","required":false,"schema":{"type":"string"}},{"name":"page_size","in":"query","description":"Number of results to return per page. The maximum limit is 100.","required":false,"schema":{"type":"integer"}},{"name":"start_date","in":"query","description":"If included, will only include audit trail events that occurred after this time","required":false,"schema":{"type":"string"}},{"name":"user_email","in":"query","description":"If provided, this will return events associated with the specified user email. Please note that the email address reflects the user's email at the time of the event, and may not be their current email.","required":false,"schema":{"type":"string"}}],"responses":{"200":{"description":"","content":{"application/json":{"schema":{"$ref":"#/components/schemas/PaginatedAuditLogEventList"}}}}},"security":[{"tokenAuth":[]}]}}},"tags":[{"name":"drives"},{"name":"files"},{"name":"folders"},{"name":"groups"},{"name":"users"},{"name":"accountDetails"},{"name":"accountToken"},{"name":"deleteAccount"},{"name":"issues"},{"name":"linkedAccounts"},{"name":"linkToken"},{"name":"fieldMapping"},{"name":"availableActions"},{"name":"scopes"},{"name":"forceResync"},{"name":"passthrough"},{"name":"asyncPassthrough"},{"name":"syncStatus"},{"name":"generateKey"},{"name":"regenerateKey"},{"name":"auditTrail"}],"servers":[{"url":"https://api.merge.dev/api","description":"Production"},{"url":"https://api-eu.merge.dev/api","description":"ProductionEU"},{"url":"https://api-ap.merge.dev/api","description":"ProductionAPSE1"}],"components":{"schemas":{"DriveFieldMappings":{"type":"object","properties":{"organization_defined_targets":{"type":"object","additionalProperties":{"description":"Any type"}},"linked_account_defined_targets":{"type":"object","additionalProperties":{"description":"Any type"}}},"title":"DriveFieldMappings"},"RemoteData":{"type":"object","properties":{"path":{"type":"string","description":"The third-party API path that is being called."},"data":{"description":"The data returned from the third-party for this object in its original, unnormalized format."}},"required":["path"],"description":"# The RemoteData Object\n### Description\nThe `RemoteData` object is used to represent the full data pulled from the third-party API for an object.\n\n### Usage Example\nTODO","title":"RemoteData"},"Drive":{"type":"object","properties":{"id":{"type":"string","format":"uuid"},"remote_id":{"type":["string","null"],"description":"The third-party API ID of the matching object."},"created_at":{"type":"string","format":"date-time","description":"The datetime that this object was created by Merge."},"modified_at":{"type":"string","format":"date-time","description":"The datetime that this object was modified by Merge."},"name":{"type":["string","null"],"maxLength":254,"description":"The drive's name."},"remote_created_at":{"type":["string","null"],"format":"date-time","description":"When the third party's drive was created."},"drive_url":{"type":["string","null"],"maxLength":2000,"description":"The drive's url."},"size":{"type":["integer","null"],"format":"int64","minimum":-9223372036854776000,"maximum":9223372036854776000,"description":"The drive's size, in bytes."},"remote_was_deleted":{"type":"boolean","description":"Indicates whether or not this object has been deleted in the third party platform. Full coverage deletion detection is a premium add-on. Native deletion detection is offered for free with limited coverage. [Learn more](https://docs.merge.dev/integrations/hris/supported-features/)."},"field_mappings":{"oneOf":[{"$ref":"#/components/schemas/DriveFieldMappings"},{"type":"null"}]},"remote_data":{"type":["array","null"],"items":{"$ref":"#/components/schemas/RemoteData"}}},"description":"# The Drive Object\n### Description\nThe `Drive` object is used to represent a drive that contains the folders and files in the user's workspace.\n### Usage Example\nFetch from the `GET /api/filestorage/v1/drives` endpoint and view their drives.","title":"Drive"},"PaginatedDriveList":{"type":"object","properties":{"next":{"type":["string","null"]},"previous":{"type":["string","null"]},"results":{"type":"array","items":{"$ref":"#/components/schemas/Drive"}}},"title":"PaginatedDriveList"},"FilesGetParametersExpandSchemaItems":{"type":"string","enum":["drive","folder","permissions"],"title":"FilesGetParametersExpandSchemaItems"},"FilesGetParametersOrderBy":{"type":"string","enum":["-created_at","-modified_at","created_at","modified_at"],"title":"FilesGetParametersOrderBy"},"TypeEnum":{"type":"string","enum":["USER","GROUP","COMPANY","ANYONE"],"title":"TypeEnum"},"RolesEnum":{"type":"string","enum":["READ","WRITE","OWNER"],"title":"RolesEnum"},"PermissionFieldMappings":{"type":"object","properties":{"organization_defined_targets":{"type":"object","additionalProperties":{"description":"Any type"}},"linked_account_defined_targets":{"type":"object","additionalProperties":{"description":"Any type"}}},"title":"PermissionFieldMappings"},"Permission":{"type":"object","properties":{"id":{"type":"string","format":"uuid"},"remote_id":{"type":["string","null"],"description":"The third-party API ID of the matching object."},"created_at":{"type":"string","format":"date-time","description":"The datetime that this object was created by Merge."},"modified_at":{"type":"string","format":"date-time","description":"The datetime that this object was modified by Merge."},"user":{"type":["string","null"],"format":"uuid","description":"The user that is granted this permission. This will only be populated if the type is `USER`."},"group":{"type":["string","null"],"format":"uuid","description":"The group that is granted this permission. This will only be populated if the type is `GROUP`."},"type":{"oneOf":[{"$ref":"#/components/schemas/TypeEnum"},{"type":"null"}],"description":"Denotes what type of people have access to the file."},"roles":{"type":["array","null"],"items":{"$ref":"#/components/schemas/RolesEnum"},"description":"The permissions that the user or group has for the File or Folder. It is possible for a user or group to have multiple roles, such as viewing & uploading. Possible values include: `READ`, `WRITE`, `OWNER`. In cases where there is no clear mapping, the original value passed through will be returned."},"remote_was_deleted":{"type":"boolean","description":"Indicates whether or not this object has been deleted in the third party platform. Full coverage deletion detection is a premium add-on. Native deletion detection is offered for free with limited coverage. [Learn more](https://docs.merge.dev/integrations/hris/supported-features/)."},"field_mappings":{"oneOf":[{"$ref":"#/components/schemas/PermissionFieldMappings"},{"type":"null"}]}},"description":"# The Permission Object\n### Description\nThe Permission object is used to represent a user's or group's access to a File or Folder. Permissions are unexpanded by default.\n\n### Usage Example\nFetch from the `GET Files` or `GET Folders` endpoint. Permissions are unexpanded by default. Use the query param `expand=permissions` to see more details.","title":"Permission"},"FileFieldMappings":{"type":"object","properties":{"organization_defined_targets":{"type":"object","additionalProperties":{"description":"Any type"}},"linked_account_defined_targets":{"type":"object","additionalProperties":{"description":"Any type"}}},"title":"FileFieldMappings"},"File":{"type":"object","properties":{"id":{"type":"string","format":"uuid"},"remote_id":{"type":["string","null"],"description":"The third-party API ID of the matching object."},"created_at":{"type":"string","format":"date-time","description":"The datetime that this object was created by Merge."},"modified_at":{"type":"string","format":"date-time","description":"The datetime that this object was modified by Merge."},"name":{"type":["string","null"],"maxLength":254,"description":"The file's name."},"file_url":{"type":["string","null"],"maxLength":2000,"description":"The URL to access the file."},"file_thumbnail_url":{"type":["string","null"],"maxLength":2000,"description":"The URL that produces a thumbnail preview of the file. Typically an image."},"size":{"type":["integer","null"],"format":"int64","minimum":-9223372036854776000,"maximum":9223372036854776000,"description":"The file's size, in bytes."},"mime_type":{"type":["string","null"],"maxLength":128,"description":"The file's mime type."},"description":{"type":["string","null"],"maxLength":2000,"description":"The file's description."},"folder":{"type":["string","null"],"format":"uuid","description":"The folder that the file belongs to."},"checksum":{"type":["object","null"],"additionalProperties":{"description":"Any type"},"description":"This field stores file checksum data. 'type' indicates the algorithm (e.g. crc_32, sha1, sha256, quickXor, or md5), and 'content_hash' is the unique hash used to verify file integrity and detect alterations."},"permissions":{"type":"array","items":{"$ref":"#/components/schemas/Permission"}},"drive":{"type":["string","null"],"format":"uuid","description":"The drive that the file belongs to."},"remote_created_at":{"type":["string","null"],"format":"date-time","description":"When the third party's file was created."},"remote_updated_at":{"type":["string","null"],"format":"date-time","description":"When the third party's file was updated."},"remote_was_deleted":{"type":"boolean","description":"Indicates whether or not this object has been deleted in the third party platform. Full coverage deletion detection is a premium add-on. Native deletion detection is offered for free with limited coverage. [Learn more](https://docs.merge.dev/integrations/hris/supported-features/)."},"field_mappings":{"oneOf":[{"$ref":"#/components/schemas/FileFieldMappings"},{"type":"null"}]},"remote_data":{"type":["array","null"],"items":{"$ref":"#/components/schemas/RemoteData"}}},"description":"# The File Object\n### Description\nThe `File` object is used to represent a file in the workspace. The Object typically exists under a folder or drive, if it exists.\n### Usage Example\nFetch from the `GET /api/filestorage/v1/files` endpoint and view their files.","title":"File"},"PaginatedFileList":{"type":"object","properties":{"next":{"type":["string","null"]},"previous":{"type":["string","null"]},"results":{"type":"array","items":{"$ref":"#/components/schemas/File"}}},"title":"PaginatedFileList"},"PermissionRequest":{"type":"object","properties":{"remote_id":{"type":["string","null"],"description":"The third-party API ID of the matching object."},"user":{"type":["string","null"],"format":"uuid","description":"The user that is granted this permission. This will only be populated if the type is `USER`."},"group":{"type":["string","null"],"format":"uuid","description":"The group that is granted this permission. This will only be populated if the type is `GROUP`."},"type":{"oneOf":[{"$ref":"#/components/schemas/TypeEnum"},{"type":"null"}],"description":"Denotes what type of people have access to the file."},"roles":{"type":["array","null"],"items":{"$ref":"#/components/schemas/RolesEnum"},"description":"The permissions that the user or group has for the File or Folder. It is possible for a user or group to have multiple roles, such as viewing & uploading. Possible values include: `READ`, `WRITE`, `OWNER`. In cases where there is no clear mapping, the original value passed through will be returned."},"integration_params":{"type":["object","null"],"additionalProperties":{"description":"Any type"}},"linked_account_params":{"type":["object","null"],"additionalProperties":{"description":"Any type"}}},"description":"# The Permission Object\n### Description\nThe Permission object is used to represent a user's or group's access to a File or Folder. Permissions are unexpanded by default.\n\n### Usage Example\nFetch from the `GET Files` or `GET Folders` endpoint. Permissions are unexpanded by default. Use the query param `expand=permissions` to see more details.","title":"PermissionRequest"},"FileRequest":{"type":"object","properties":{"name":{"type":["string","null"],"maxLength":254,"description":"The file's name."},"file_url":{"type":["string","null"],"maxLength":2000,"description":"The URL to access the file."},"file_thumbnail_url":{"type":["string","null"],"maxLength":2000,"description":"The URL that produces a thumbnail preview of the file. Typically an image."},"size":{"type":["integer","null"],"format":"int64","minimum":-9223372036854776000,"maximum":9223372036854776000,"description":"The file's size, in bytes."},"mime_type":{"type":["string","null"],"maxLength":128,"description":"The file's mime type."},"description":{"type":["string","null"],"maxLength":2000,"description":"The file's description."},"folder":{"type":["string","null"],"format":"uuid","description":"The folder that the file belongs to."},"checksum":{"type":["object","null"],"additionalProperties":{"description":"Any type"},"description":"This field stores file checksum data. 'type' indicates the algorithm (e.g. crc_32, sha1, sha256, quickXor, or md5), and 'content_hash' is the unique hash used to verify file integrity and detect alterations."},"permissions":{"type":"array","items":{"$ref":"#/components/schemas/PermissionRequest"}},"drive":{"type":["string","null"],"format":"uuid","description":"The drive that the file belongs to."},"integration_params":{"type":["object","null"],"additionalProperties":{"description":"Any type"}},"linked_account_params":{"type":["object","null"],"additionalProperties":{"description":"Any type"}}},"description":"# The File Object\n### Description\nThe `File` object is used to represent a file in the workspace. The Object typically exists under a folder or drive, if it exists.\n### Usage Example\nFetch from the `GET /api/filestorage/v1/files` endpoint and view their files.","title":"FileRequest"},"FileStorageFileEndpointRequest":{"type":"object","properties":{"model":{"$ref":"#/components/schemas/FileRequest"}},"required":["model"],"title":"FileStorageFileEndpointRequest"},"ValidationProblemSource":{"type":"object","properties":{"pointer":{"type":"string"}},"required":["pointer"],"title":"ValidationProblemSource"},"WarningValidationProblem":{"type":"object","properties":{"source":{"$ref":"#/components/schemas/ValidationProblemSource"},"title":{"type":"string"},"detail":{"type":"string"},"problem_type":{"type":"string"},"block_merge_link":{"type":"boolean"},"raw_error":{"type":"string"},"error_code":{"type":"integer"}},"required":["title","detail","problem_type"],"title":"WarningValidationProblem"},"ErrorValidationProblem":{"type":"object","properties":{"source":{"$ref":"#/components/schemas/ValidationProblemSource"},"title":{"type":"string"},"detail":{"type":"string"},"problem_type":{"type":"string"},"block_merge_link":{"type":"boolean"},"raw_error":{"type":"string"},"error_code":{"type":"integer"}},"required":["title","detail","problem_type"],"title":"ErrorValidationProblem"},"DebugModelLogSummary":{"type":"object","properties":{"url":{"type":"string"},"method":{"type":"string"},"status_code":{"type":"integer"}},"required":["url","method","status_code"],"title":"DebugModelLogSummary"},"DebugModeLog":{"type":"object","properties":{"log_id":{"type":"string"},"dashboard_view":{"type":"string"},"log_summary":{"$ref":"#/components/schemas/DebugModelLogSummary"}},"required":["log_id","dashboard_view","log_summary"],"title":"DebugModeLog"},"FileStorageFileResponse":{"type":"object","properties":{"model":{"$ref":"#/components/schemas/File"},"warnings":{"type":"array","items":{"$ref":"#/components/schemas/WarningValidationProblem"}},"errors":{"type":"array","items":{"$ref":"#/components/schemas/ErrorValidationProblem"}},"logs":{"type":"array","items":{"$ref":"#/components/schemas/DebugModeLog"}}},"required":["model","warnings","errors"],"title":"FileStorageFileResponse"},"FilesIdGetParametersExpandSchemaItems":{"type":"string","enum":["drive","folder","permissions"],"title":"FilesIdGetParametersExpandSchemaItems"},"DownloadRequestMeta":{"type":"object","properties":{"id":{"type":"string"},"url":{"type":"string"},"method":{"type":"string"},"headers":{"type":"object","additionalProperties":{"description":"Any type"}}},"required":["id","url","method","headers"],"title":"DownloadRequestMeta"},"FilesDownloadRequestMetaGetParametersOrderBy":{"type":"string","enum":["-created_at","-modified_at","created_at","modified_at"],"title":"FilesDownloadRequestMetaGetParametersOrderBy"},"PaginatedDownloadRequestMetaList":{"type":"object","properties":{"next":{"type":["string","null"]},"previous":{"type":["string","null"]},"results":{"type":"array","items":{"$ref":"#/components/schemas/DownloadRequestMeta"}}},"title":"PaginatedDownloadRequestMetaList"},"LinkedAccountStatus":{"type":"object","properties":{"linked_account_status":{"type":"string"},"can_make_request":{"type":"boolean"}},"required":["linked_account_status","can_make_request"],"title":"LinkedAccountStatus"},"MetaResponse":{"type":"object","properties":{"request_schema":{"type":"object","additionalProperties":{"description":"Any type"}},"status":{"$ref":"#/components/schemas/LinkedAccountStatus"},"has_conditional_params":{"type":"boolean"},"has_required_linked_account_params":{"type":"boolean"},"remote_fields":{"type":"array","items":{"type":"string","format":"uuid"},"description":"Remote field values to populate"}},"required":["request_schema","has_conditional_params","has_required_linked_account_params"],"title":"MetaResponse"},"FoldersGetParametersExpandSchemaItems":{"type":"string","enum":["drive","parent_folder","permissions"],"title":"FoldersGetParametersExpandSchemaItems"},"FolderFieldMappings":{"type":"object","properties":{"organization_defined_targets":{"type":"object","additionalProperties":{"description":"Any type"}},"linked_account_defined_targets":{"type":"object","additionalProperties":{"description":"Any type"}}},"title":"FolderFieldMappings"},"Folder":{"type":"object","properties":{"id":{"type":"string","format":"uuid"},"remote_id":{"type":["string","null"],"description":"The third-party API ID of the matching object."},"created_at":{"type":"string","format":"date-time","description":"The datetime that this object was created by Merge."},"modified_at":{"type":"string","format":"date-time","description":"The datetime that this object was modified by Merge."},"name":{"type":["string","null"],"maxLength":254,"description":"The folder's name."},"folder_url":{"type":["string","null"],"maxLength":2000,"description":"The URL to access the folder."},"size":{"type":["integer","null"],"format":"int64","minimum":-9223372036854776000,"maximum":9223372036854776000,"description":"The folder's size, in bytes."},"description":{"type":["string","null"],"maxLength":2000,"description":"The folder's description."},"parent_folder":{"type":["string","null"],"format":"uuid","description":"The folder that the folder belongs to."},"drive":{"type":["string","null"],"format":"uuid","description":"The drive that the folder belongs to."},"permissions":{"type":"array","items":{"$ref":"#/components/schemas/Permission"}},"remote_created_at":{"type":["string","null"],"format":"date-time","description":"When the third party's folder was created."},"remote_updated_at":{"type":["string","null"],"format":"date-time","description":"When the third party's folder was updated."},"remote_was_deleted":{"type":"boolean","description":"Indicates whether or not this object has been deleted in the third party platform. Full coverage deletion detection is a premium add-on. Native deletion detection is offered for free with limited coverage. [Learn more](https://docs.merge.dev/integrations/hris/supported-features/)."},"field_mappings":{"oneOf":[{"$ref":"#/components/schemas/FolderFieldMappings"},{"type":"null"}]},"remote_data":{"type":["array","null"],"items":{"$ref":"#/components/schemas/RemoteData"}}},"description":"# The Folder Object\n### Description\nThe `Folder` object is used to represent a collection of files and/or folders in the workspace. Could be within a drive, if it exists.\n### Usage Example\nFetch from the `GET /api/filestorage/v1/folders` endpoint and view their folders.","title":"Folder"},"PaginatedFolderList":{"type":"object","properties":{"next":{"type":["string","null"]},"previous":{"type":["string","null"]},"results":{"type":"array","items":{"$ref":"#/components/schemas/Folder"}}},"title":"PaginatedFolderList"},"FolderRequest":{"type":"object","properties":{"name":{"type":["string","null"],"maxLength":254,"description":"The folder's name."},"folder_url":{"type":["string","null"],"maxLength":2000,"description":"The URL to access the folder."},"size":{"type":["integer","null"],"format":"int64","minimum":-9223372036854776000,"maximum":9223372036854776000,"description":"The folder's size, in bytes."},"description":{"type":["string","null"],"maxLength":2000,"description":"The folder's description."},"parent_folder":{"type":["string","null"],"format":"uuid","description":"The folder that the folder belongs to."},"drive":{"type":["string","null"],"format":"uuid","description":"The drive that the folder belongs to."},"permissions":{"type":"array","items":{"$ref":"#/components/schemas/PermissionRequest"}},"integration_params":{"type":["object","null"],"additionalProperties":{"description":"Any type"}},"linked_account_params":{"type":["object","null"],"additionalProperties":{"description":"Any type"}}},"description":"# The Folder Object\n### Description\nThe `Folder` object is used to represent a collection of files and/or folders in the workspace. Could be within a drive, if it exists.\n### Usage Example\nFetch from the `GET /api/filestorage/v1/folders` endpoint and view their folders.","title":"FolderRequest"},"FileStorageFolderEndpointRequest":{"type":"object","properties":{"model":{"$ref":"#/components/schemas/FolderRequest"}},"required":["model"],"title":"FileStorageFolderEndpointRequest"},"FileStorageFolderResponse":{"type":"object","properties":{"model":{"$ref":"#/components/schemas/Folder"},"warnings":{"type":"array","items":{"$ref":"#/components/schemas/WarningValidationProblem"}},"errors":{"type":"array","items":{"$ref":"#/components/schemas/ErrorValidationProblem"}},"logs":{"type":"array","items":{"$ref":"#/components/schemas/DebugModeLog"}}},"required":["model","warnings","errors"],"title":"FileStorageFolderResponse"},"FoldersIdGetParametersExpandSchemaItems":{"type":"string","enum":["drive","parent_folder","permissions"],"title":"FoldersIdGetParametersExpandSchemaItems"},"GroupsGetParametersExpandSchemaItems":{"type":"string","enum":["child_groups","users"],"title":"GroupsGetParametersExpandSchemaItems"},"GroupFieldMappings":{"type":"object","properties":{"organization_defined_targets":{"type":"object","additionalProperties":{"description":"Any type"}},"linked_account_defined_targets":{"type":"object","additionalProperties":{"description":"Any type"}}},"title":"GroupFieldMappings"},"Group":{"type":"object","properties":{"id":{"type":"string","format":"uuid"},"remote_id":{"type":["string","null"],"description":"The third-party API ID of the matching object."},"created_at":{"type":"string","format":"date-time","description":"The datetime that this object was created by Merge."},"modified_at":{"type":"string","format":"date-time","description":"The datetime that this object was modified by Merge."},"name":{"type":["string","null"],"maxLength":254,"description":"The group's name."},"users":{"type":"array","items":{"type":"string","format":"uuid"},"description":"The users that belong in the group. If null, this typically means it's either a domain or the third-party platform does not surface this information."},"child_groups":{"type":"array","items":{"type":"string","format":"uuid"},"description":"Groups that inherit the permissions of the parent group."},"remote_was_deleted":{"type":"boolean","description":"Indicates whether or not this object has been deleted in the third party platform. Full coverage deletion detection is a premium add-on. Native deletion detection is offered for free with limited coverage. [Learn more](https://docs.merge.dev/integrations/hris/supported-features/)."},"field_mappings":{"oneOf":[{"$ref":"#/components/schemas/GroupFieldMappings"},{"type":"null"}]},"remote_data":{"type":["array","null"],"items":{"$ref":"#/components/schemas/RemoteData"}}},"required":["users"],"description":"# The Group Object\n### Description\nThe `Group` object is used to represent any subset of `Users`. This can extend to company domains as well.\n### Usage Example\nFetch from the `GET /api/filestorage/v1/groups` endpoint and view their groups.","title":"Group"},"PaginatedGroupList":{"type":"object","properties":{"next":{"type":["string","null"]},"previous":{"type":["string","null"]},"results":{"type":"array","items":{"$ref":"#/components/schemas/Group"}}},"title":"PaginatedGroupList"},"GroupsIdGetParametersExpandSchemaItems":{"type":"string","enum":["child_groups","users"],"title":"GroupsIdGetParametersExpandSchemaItems"},"UserFieldMappings":{"type":"object","properties":{"organization_defined_targets":{"type":"object","additionalProperties":{"description":"Any type"}},"linked_account_defined_targets":{"type":"object","additionalProperties":{"description":"Any type"}}},"title":"UserFieldMappings"},"User":{"type":"object","properties":{"id":{"type":"string","format":"uuid"},"remote_id":{"type":["string","null"],"description":"The third-party API ID of the matching object."},"created_at":{"type":"string","format":"date-time","description":"The datetime that this object was created by Merge."},"modified_at":{"type":"string","format":"date-time","description":"The datetime that this object was modified by Merge."},"name":{"type":["string","null"],"maxLength":254,"description":"The user's name."},"email_address":{"type":["string","null"],"maxLength":2000,"description":"The user's email address. This is typically used to identify a user across linked accounts."},"is_me":{"type":"boolean","description":"Whether the user is the one who linked this account."},"remote_was_deleted":{"type":"boolean","description":"Indicates whether or not this object has been deleted in the third party platform. Full coverage deletion detection is a premium add-on. Native deletion detection is offered for free with limited coverage. [Learn more](https://docs.merge.dev/integrations/hris/supported-features/)."},"field_mappings":{"oneOf":[{"$ref":"#/components/schemas/UserFieldMappings"},{"type":"null"}]},"remote_data":{"type":["array","null"],"items":{"$ref":"#/components/schemas/RemoteData"}}},"description":"# The User Object\n### Description\nThe `User` object is used to represent a user within the File Storage account.\n### Usage Example\nFetch from the `GET /api/filestorage/v1/users` endpoint and view their users.","title":"User"},"PaginatedUserList":{"type":"object","properties":{"next":{"type":["string","null"]},"previous":{"type":["string","null"]},"results":{"type":"array","items":{"$ref":"#/components/schemas/User"}}},"title":"PaginatedUserList"},"CategoryEnum":{"type":"string","enum":["hris","ats","accounting","ticketing","crm","mktg","filestorage","knowledgebase"],"title":"CategoryEnum"},"AccountDetails":{"type":"object","properties":{"id":{"type":"string","format":"uuid"},"integration":{"type":"string"},"integration_slug":{"type":"string"},"category":{"oneOf":[{"$ref":"#/components/schemas/CategoryEnum"},{"type":"null"}]},"end_user_origin_id":{"type":"string"},"end_user_organization_name":{"type":"string"},"end_user_email_address":{"type":"string","format":"email"},"status":{"type":"string"},"webhook_listener_url":{"type":"string","format":"uri"},"is_duplicate":{"type":["boolean","null"],"description":"Whether a Production Linked Account's credentials match another existing Production Linked Account. This field is `null` for Test Linked Accounts, incomplete Production Linked Accounts, and ignored duplicate Production Linked Account sets."},"account_type":{"type":"string"},"completed_at":{"type":["string","null"],"format":"date-time","description":"The time at which account completes the linking flow."},"instance_id":{"type":["string","null"]},"instance_display_value":{"type":["string","null"]}},"title":"AccountDetails"},"CategoriesEnum":{"type":"string","enum":["hris","ats","accounting","ticketing","crm","mktg","filestorage","knowledgebase"],"title":"CategoriesEnum"},"AccountIntegrationCategoryBetaStatus":{"type":"object","properties":{},"description":"Category or categories this integration is in beta status for.","title":"AccountIntegrationCategoryBetaStatus"},"AccountIntegration":{"type":"object","properties":{"name":{"type":"string","description":"Company name."},"abbreviated_name":{"type":["string","null"],"description":"Optional. This shortened name appears in places with limited space, usually in conjunction with the platform's logo (e.g., Merge Link menu).
Example: Workforce Now (in lieu of ADP Workforce Now), SuccessFactors (in lieu of SAP SuccessFactors)"},"categories":{"type":"array","items":{"$ref":"#/components/schemas/CategoriesEnum"},"description":"Category or categories this integration belongs to. Multiple categories should be comma separated, i.e. [ats, hris]."},"image":{"type":["string","null"],"format":"uri","description":"Company logo in rectangular shape."},"square_image":{"type":["string","null"],"format":"uri","description":"Company logo in square shape."},"color":{"type":"string","pattern":"^#([A-Fa-f0-9]{6}|[A-Fa-f0-9]{3})$","maxLength":18,"description":"The color of this integration used for buttons and text throughout the app and landing pages. Choose a darker, saturated color."},"slug":{"type":"string"},"api_endpoints_to_documentation_urls":{"type":"object","additionalProperties":{"description":"Any type"},"description":"Mapping of API endpoints to documentation urls for support. Example: {'GET': [['/common-model-scopes', 'https://docs.merge.dev/accounting/common-model-scopes/#common_model_scopes_retrieve'],['/common-model-actions', 'https://docs.merge.dev/accounting/common-model-actions/#common_model_actions_retrieve']], 'POST': []}"},"webhook_setup_guide_url":{"type":["string","null"],"description":"Setup guide URL for third party webhook creation. Exposed in Merge Docs."},"category_beta_status":{"$ref":"#/components/schemas/AccountIntegrationCategoryBetaStatus","description":"Category or categories this integration is in beta status for."}},"required":["name"],"title":"AccountIntegration"},"AccountToken":{"type":"object","properties":{"account_token":{"type":"string"},"integration":{"$ref":"#/components/schemas/AccountIntegration"},"id":{"type":"string"}},"required":["account_token","integration","id"],"title":"AccountToken"},"RegenerateAccountToken":{"type":"object","properties":{"linked_account_id":{"type":"string"},"account_token":{"type":"string"}},"required":["linked_account_id","account_token"],"description":"# The RegenerateAccountToken Object\n### Description\nThe `RegenerateAccountToken` object is used to exchange an old account token for a new one.\n\n### Usage Example\nPost to receive a new `RegenerateAccountToken`.","title":"RegenerateAccountToken"},"deleteAccount_delete_Response_200":{"type":"object","properties":{},"description":"Empty response body","title":"deleteAccount_delete_Response_200"},"IssuesGetParametersStatus":{"type":"string","enum":["ONGOING","RESOLVED"],"title":"IssuesGetParametersStatus"},"IssueStatusEnum":{"type":"string","enum":["ONGOING","RESOLVED"],"title":"IssueStatusEnum"},"Issue":{"type":"object","properties":{"id":{"type":"string","format":"uuid"},"status":{"$ref":"#/components/schemas/IssueStatusEnum","description":"Status of the issue."},"error_description":{"type":"string"},"end_user":{"type":"object","additionalProperties":{"description":"Any type"}},"first_incident_time":{"type":["string","null"],"format":"date-time"},"last_incident_time":{"type":["string","null"],"format":"date-time"},"is_muted":{"type":"boolean"},"error_details":{"type":"array","items":{"type":"string"}}},"required":["error_description"],"title":"Issue"},"PaginatedIssueList":{"type":"object","properties":{"next":{"type":["string","null"]},"previous":{"type":["string","null"]},"results":{"type":"array","items":{"$ref":"#/components/schemas/Issue"}}},"title":"PaginatedIssueList"},"LinkedAccountsGetParametersCategory":{"type":"string","enum":["accounting","ats","chat","crm","filestorage","hris","knowledgebase","mktg","ticketing"],"title":"LinkedAccountsGetParametersCategory"},"AccountDetailsAndActionsStatusEnum":{"type":"string","enum":["COMPLETE","INCOMPLETE","RELINK_NEEDED","IDLE"],"title":"AccountDetailsAndActionsStatusEnum"},"ModelOperation":{"type":"object","properties":{"model_name":{"type":"string"},"available_operations":{"type":"array","items":{"type":"string"}},"required_post_parameters":{"type":"array","items":{"type":"string"}},"supported_fields":{"type":"array","items":{"type":"string"}}},"required":["model_name","available_operations","required_post_parameters","supported_fields"],"description":"# The ModelOperation Object\n### Description\nThe `ModelOperation` object is used to represent the operations that are currently supported for a given model.\n\n### Usage Example\nView what operations are supported for the `Candidate` endpoint.","title":"ModelOperation"},"AccountDetailsAndActionsIntegration":{"type":"object","properties":{"name":{"type":"string"},"categories":{"type":"array","items":{"$ref":"#/components/schemas/CategoriesEnum"}},"image":{"type":"string"},"square_image":{"type":"string"},"color":{"type":"string"},"slug":{"type":"string"},"passthrough_available":{"type":"boolean"},"available_model_operations":{"type":"array","items":{"$ref":"#/components/schemas/ModelOperation"}}},"required":["name","categories","color","slug","passthrough_available"],"title":"AccountDetailsAndActionsIntegration"},"AccountDetailsAndActions":{"type":"object","properties":{"id":{"type":"string"},"category":{"$ref":"#/components/schemas/CategoryEnum"},"status":{"$ref":"#/components/schemas/AccountDetailsAndActionsStatusEnum"},"status_detail":{"type":"string"},"end_user_origin_id":{"type":"string"},"end_user_organization_name":{"type":"string"},"end_user_email_address":{"type":"string"},"subdomain":{"type":"string","description":"The tenant or domain the customer has provided access to."},"webhook_listener_url":{"type":"string"},"is_duplicate":{"type":["boolean","null"],"description":"Whether a Production Linked Account's credentials match another existing Production Linked Account. This field is `null` for Test Linked Accounts, incomplete Production Linked Accounts, and ignored duplicate Production Linked Account sets."},"integration":{"$ref":"#/components/schemas/AccountDetailsAndActionsIntegration"},"account_type":{"type":"string"},"completed_at":{"type":"string","format":"date-time"},"integration_specific_fields":{"type":"object","additionalProperties":{"description":"Any type"}}},"required":["id","status","end_user_organization_name","end_user_email_address","webhook_listener_url","account_type","completed_at"],"description":"# The LinkedAccount Object\n### Description\nThe `LinkedAccount` object is used to represent an end user's link with a specific integration.\n\n### Usage Example\nView a list of your organization's `LinkedAccount` objects.","title":"AccountDetailsAndActions"},"PaginatedAccountDetailsAndActionsList":{"type":"object","properties":{"next":{"type":["string","null"]},"previous":{"type":["string","null"]},"results":{"type":"array","items":{"$ref":"#/components/schemas/AccountDetailsAndActions"}}},"title":"PaginatedAccountDetailsAndActionsList"},"EnabledActionsEnum":{"type":"string","enum":["READ","WRITE"],"title":"EnabledActionsEnum"},"CommonModelScopesBodyRequest":{"type":"object","properties":{"model_id":{"type":"string","minLength":1},"enabled_actions":{"type":"array","items":{"$ref":"#/components/schemas/EnabledActionsEnum"}},"disabled_fields":{"type":"array","items":{"type":"string","minLength":1}}},"required":["model_id","enabled_actions","disabled_fields"],"title":"CommonModelScopesBodyRequest"},"ModelPermissionDeserializerRequest":{"type":"object","properties":{"is_enabled":{"type":"boolean"}},"title":"ModelPermissionDeserializerRequest"},"FieldPermissionDeserializerRequest":{"type":"object","properties":{"enabled_fields":{"type":"array","items":{"description":"Any type"}},"disabled_fields":{"type":"array","items":{"description":"Any type"}}},"title":"FieldPermissionDeserializerRequest"},"IndividualCommonModelScopeDeserializerRequest":{"type":"object","properties":{"model_name":{"type":"string","minLength":1},"model_permissions":{"type":"object","additionalProperties":{"$ref":"#/components/schemas/ModelPermissionDeserializerRequest"}},"field_permissions":{"$ref":"#/components/schemas/FieldPermissionDeserializerRequest"}},"required":["model_name"],"title":"IndividualCommonModelScopeDeserializerRequest"},"LanguageEnum":{"type":"string","enum":["en","de"],"title":"LanguageEnum"},"CompletedAccountInitialScreenEnum":{"type":"string","enum":["SELECTIVE_SYNC"],"title":"CompletedAccountInitialScreenEnum"},"EndUserDetailsRequest":{"type":"object","properties":{"end_user_email_address":{"type":"string","minLength":1,"maxLength":100,"description":"Your end user's email address. This is purely for identification purposes - setting this value will not cause any emails to be sent."},"end_user_organization_name":{"type":"string","minLength":1,"maxLength":100,"description":"Your end user's organization."},"end_user_origin_id":{"type":"string","minLength":1,"maxLength":100,"description":"This unique identifier typically represents the ID for your end user in your product's database. This value must be distinct from other Linked Accounts' unique identifiers."},"categories":{"type":"array","items":{"$ref":"#/components/schemas/CategoriesEnum"},"description":"The integration categories to show in Merge Link."},"integration":{"type":["string","null"],"minLength":1,"description":"The slug of a specific pre-selected integration for this linking flow token. For examples of slugs, see https://docs.merge.dev/guides/merge-link/single-integration/."},"link_expiry_mins":{"type":"integer","minimum":30,"maximum":10080,"default":30,"description":"An integer number of minutes between [30, 720 or 10080 if for a Magic Link URL] for how long this token is valid. Defaults to 30."},"should_create_magic_link_url":{"type":["boolean","null"],"default":false,"description":"Whether to generate a Magic Link URL. Defaults to false. For more information on Magic Link, see https://merge.dev/blog/integrations-fast-say-hello-to-magic-link."},"hide_admin_magic_link":{"type":["boolean","null"],"default":false,"description":"Whether to generate a Magic Link URL on the Admin Needed screen during the linking flow. Defaults to false. For more information on Magic Link, see https://merge.dev/blog/integrations-fast-say-hello-to-magic-link."},"common_models":{"type":["array","null"],"items":{"$ref":"#/components/schemas/CommonModelScopesBodyRequest"},"description":"An array of objects to specify the models and fields that will be disabled for a given Linked Account. Each object uses model_id, enabled_actions, and disabled_fields to specify the model, method, and fields that are scoped for a given Linked Account."},"category_common_model_scopes":{"type":["object","null"],"additionalProperties":{"type":"array","items":{"$ref":"#/components/schemas/IndividualCommonModelScopeDeserializerRequest"}},"description":"When creating a Link Token, you can set permissions for Common Models that will apply to the account that is going to be linked. Any model or field not specified in link token payload will default to existing settings."},"language":{"oneOf":[{"$ref":"#/components/schemas/LanguageEnum"},{"type":"null"}],"description":"The following subset of IETF language tags can be used to configure localization."},"are_syncs_disabled":{"type":["boolean","null"],"default":false,"description":"The boolean that indicates whether initial, periodic, and force syncs will be disabled."},"integration_specific_config":{"type":["object","null"],"additionalProperties":{"description":"Any type"},"description":"A JSON object containing integration-specific configuration options."},"completed_account_initial_screen":{"oneOf":[{"$ref":"#/components/schemas/CompletedAccountInitialScreenEnum"},{"type":"null"}],"description":"When creating a Link token, you can specifiy the initial screen of Linking Flow for a completed Linked Account."},"linked_destination_id":{"type":["string","null"],"format":"uuid","description":"The UUID of the linked destination that you want this Linked Account to be tied to."},"credential_id":{"type":["string","null"],"format":"uuid","description":"The id of the credential that you want this Linked Account to be tied to."},"ekm_enabled":{"type":"boolean","default":false,"description":"Whether to enable EKM (External Key Management) for this Linked Account."}},"required":["end_user_email_address","end_user_organization_name","end_user_origin_id","categories"],"title":"EndUserDetailsRequest"},"LinkToken":{"type":"object","properties":{"link_token":{"type":"string"},"integration_name":{"type":"string"},"magic_link_url":{"type":"string"}},"required":["link_token"],"title":"LinkToken"},"FieldMappingApiInstanceTargetField":{"type":"object","properties":{"name":{"type":"string"},"description":{"type":"string"},"is_organization_wide":{"type":"boolean"}},"required":["name","description","is_organization_wide"],"title":"FieldMappingApiInstanceTargetField"},"FieldMappingApiInstanceRemoteFieldRemoteEndpointInfo":{"type":"object","properties":{"method":{"type":["string","null"]},"url_path":{"type":["string","null"]},"field_traversal_path":{"type":["array","null"],"items":{"type":"string"}}},"required":["method","url_path","field_traversal_path"],"title":"FieldMappingApiInstanceRemoteFieldRemoteEndpointInfo"},"FieldMappingApiInstanceRemoteField":{"type":"object","properties":{"remote_key_name":{"type":["string","null"]},"schema":{"type":["object","null"],"additionalProperties":{"description":"Any type"}},"remote_endpoint_info":{"$ref":"#/components/schemas/FieldMappingApiInstanceRemoteFieldRemoteEndpointInfo"}},"required":["remote_key_name","schema","remote_endpoint_info"],"title":"FieldMappingApiInstanceRemoteField"},"FieldMappingApiInstance":{"type":"object","properties":{"id":{"type":"string","format":"uuid"},"is_integration_wide":{"type":"boolean"},"target_field":{"oneOf":[{"$ref":"#/components/schemas/FieldMappingApiInstanceTargetField"},{"type":"null"}]},"remote_field":{"oneOf":[{"$ref":"#/components/schemas/FieldMappingApiInstanceRemoteField"},{"type":"null"}]},"jmes_path":{"type":["string","null"]},"advanced_mapping_expression":{"type":["string","null"]}},"title":"FieldMappingApiInstance"},"FieldMappingApiInstanceResponse":{"type":"object","properties":{"File":{"type":"array","items":{"$ref":"#/components/schemas/FieldMappingApiInstance"}},"Folder":{"type":"array","items":{"$ref":"#/components/schemas/FieldMappingApiInstance"}},"Drive":{"type":"array","items":{"$ref":"#/components/schemas/FieldMappingApiInstance"}},"Group":{"type":"array","items":{"$ref":"#/components/schemas/FieldMappingApiInstance"}},"User":{"type":"array","items":{"$ref":"#/components/schemas/FieldMappingApiInstance"}}},"title":"FieldMappingApiInstanceResponse"},"CreateFieldMappingRequest":{"type":"object","properties":{"target_field_name":{"type":"string","minLength":1,"description":"The name of the target field you want this remote field to map to. Required if organization_wide_target_field is not provided."},"target_field_description":{"type":"string","minLength":1,"description":"The description of the target field you want this remote field to map to. Required if organization_wide_target_field is not provided."},"organization_wide_target_field":{"type":"string","minLength":1,"description":"The name or key of an existing Organization-wide target field to map to. When provided, target_field_name and target_field_description are optional."},"is_integration_wide":{"type":"boolean","default":false,"description":"If true, creates an integration-wide field mapping that applies to all Linked Accounts for the integration. Requires organization_wide_target_field."},"remote_field_traversal_path":{"type":"array","items":{"description":"Any type"},"description":"The field traversal path of the remote field listed when you hit the GET /remote-fields endpoint."},"remote_method":{"type":"string","minLength":1,"description":"The method of the remote endpoint where the remote field is coming from."},"remote_url_path":{"type":"string","minLength":1,"description":"The path of the remote endpoint where the remote field is coming from."},"common_model_name":{"type":"string","minLength":1,"description":"The name of the Common Model that the remote field corresponds to in a given category."},"jmes_path":{"type":"string","minLength":1,"description":"DEPRECATED: Use 'advanced_mapping_expression' instead."},"advanced_mapping_expression":{"type":"string","minLength":1,"description":"A JSONata expression used to transform the remote field data."}},"required":["remote_field_traversal_path","remote_method","remote_url_path","common_model_name"],"title":"CreateFieldMappingRequest"},"FieldMappingInstanceResponse":{"type":"object","properties":{"model":{"$ref":"#/components/schemas/FieldMappingApiInstance"},"warnings":{"type":"array","items":{"$ref":"#/components/schemas/WarningValidationProblem"}},"errors":{"type":"array","items":{"$ref":"#/components/schemas/ErrorValidationProblem"}},"logs":{"type":"array","items":{"$ref":"#/components/schemas/DebugModeLog"}}},"required":["model","warnings","errors"],"title":"FieldMappingInstanceResponse"},"PatchedEditFieldMappingRequest":{"type":"object","properties":{"remote_field_traversal_path":{"type":"array","items":{"description":"Any type"},"description":"The field traversal path of the remote field listed when you hit the GET /remote-fields endpoint."},"remote_method":{"type":"string","minLength":1,"description":"The method of the remote endpoint where the remote field is coming from."},"remote_url_path":{"type":"string","minLength":1,"description":"The path of the remote endpoint where the remote field is coming from."},"jmes_path":{"type":"string","minLength":1,"description":"DEPRECATED: Use 'advanced_mapping_expression' instead."},"advanced_mapping_expression":{"type":"string","minLength":1,"description":"A JSONata expression used to transform the remote field data."}},"title":"PatchedEditFieldMappingRequest"},"RemoteEndpointInfo":{"type":"object","properties":{"method":{"type":"string"},"url_path":{"type":"string"},"field_traversal_path":{"type":"array","items":{"description":"Any type"}}},"required":["method","url_path","field_traversal_path"],"title":"RemoteEndpointInfo"},"AdvancedMetadata":{"type":"object","properties":{"id":{"type":"string","format":"uuid"},"display_name":{"type":"string"},"description":{"type":"string"},"is_required":{"type":"boolean"},"is_custom":{"type":"boolean"},"field_choices":{"type":"array","items":{"description":"Any type"}}},"required":["id"],"title":"AdvancedMetadata"},"RemoteFieldApiCoverage":{"oneOf":[{"type":"integer"},{"type":"number","format":"double"}],"title":"RemoteFieldApiCoverage"},"RemoteFieldAPI":{"type":"object","properties":{"schema":{"type":"object","additionalProperties":{"description":"Any type"}},"remote_key_name":{"type":"string"},"remote_endpoint_info":{"$ref":"#/components/schemas/RemoteEndpointInfo"},"example_values":{"type":["array","null"],"items":{"description":"Any type"}},"advanced_metadata":{"oneOf":[{"$ref":"#/components/schemas/AdvancedMetadata"},{"type":"null"}]},"coverage":{"oneOf":[{"$ref":"#/components/schemas/RemoteFieldApiCoverage"},{"type":"null"}]}},"required":["schema","remote_key_name","remote_endpoint_info","advanced_metadata"],"title":"RemoteFieldAPI"},"RemoteFieldAPIResponse":{"type":"object","properties":{"File":{"type":"array","items":{"$ref":"#/components/schemas/RemoteFieldAPI"}},"Folder":{"type":"array","items":{"$ref":"#/components/schemas/RemoteFieldAPI"}},"Drive":{"type":"array","items":{"$ref":"#/components/schemas/RemoteFieldAPI"}},"Group":{"type":"array","items":{"$ref":"#/components/schemas/RemoteFieldAPI"}},"User":{"type":"array","items":{"$ref":"#/components/schemas/RemoteFieldAPI"}}},"title":"RemoteFieldAPIResponse"},"ExternalTargetFieldAPI":{"type":"object","properties":{"name":{"type":["string","null"]},"description":{"type":["string","null"]},"is_mapped":{"type":["string","null"]}},"title":"ExternalTargetFieldAPI"},"ExternalTargetFieldAPIResponse":{"type":"object","properties":{"File":{"type":"array","items":{"$ref":"#/components/schemas/ExternalTargetFieldAPI"}},"Folder":{"type":"array","items":{"$ref":"#/components/schemas/ExternalTargetFieldAPI"}},"Drive":{"type":"array","items":{"$ref":"#/components/schemas/ExternalTargetFieldAPI"}},"Group":{"type":"array","items":{"$ref":"#/components/schemas/ExternalTargetFieldAPI"}},"User":{"type":"array","items":{"$ref":"#/components/schemas/ExternalTargetFieldAPI"}}},"title":"ExternalTargetFieldAPIResponse"},"CreateTargetFieldRequest":{"type":"object","properties":{"name":{"type":"string","minLength":1,"description":"The name of the target field."},"description":{"type":"string","minLength":1,"default":"","description":"The description of the target field."},"common_model":{"type":"string","minLength":1,"description":"The name of the Common Model to associate the target field with."}},"required":["name","common_model"],"title":"CreateTargetFieldRequest"},"AvailableActions":{"type":"object","properties":{"integration":{"$ref":"#/components/schemas/AccountIntegration"},"passthrough_available":{"type":"boolean"},"available_model_operations":{"type":"array","items":{"$ref":"#/components/schemas/ModelOperation"}}},"required":["integration","passthrough_available"],"description":"# The AvailableActions Object\n### Description\nThe `Activity` object is used to see all available model/operation combinations for an integration.\n\n### Usage Example\nFetch all the actions available for the `Zenefits` integration.","title":"AvailableActions"},"ModelPermissionDeserializer":{"type":"object","properties":{"is_enabled":{"type":"boolean"}},"title":"ModelPermissionDeserializer"},"FieldPermissionDeserializer":{"type":"object","properties":{"enabled_fields":{"type":"array","items":{"description":"Any type"}},"disabled_fields":{"type":"array","items":{"description":"Any type"}}},"title":"FieldPermissionDeserializer"},"IndividualCommonModelScopeDeserializer":{"type":"object","properties":{"model_name":{"type":"string"},"model_permissions":{"type":"object","additionalProperties":{"$ref":"#/components/schemas/ModelPermissionDeserializer"}},"field_permissions":{"$ref":"#/components/schemas/FieldPermissionDeserializer"}},"required":["model_name"],"title":"IndividualCommonModelScopeDeserializer"},"CommonModelScopeAPI":{"type":"object","properties":{"common_models":{"type":"array","items":{"$ref":"#/components/schemas/IndividualCommonModelScopeDeserializer"},"description":"The common models you want to update the scopes for"}},"required":["common_models"],"title":"CommonModelScopeAPI"},"LinkedAccountCommonModelScopeDeserializerRequest":{"type":"object","properties":{"common_models":{"type":"array","items":{"$ref":"#/components/schemas/IndividualCommonModelScopeDeserializerRequest"},"description":"The common models you want to update the scopes for"}},"required":["common_models"],"title":"LinkedAccountCommonModelScopeDeserializerRequest"},"LastSyncResultEnum":{"type":"string","enum":["SYNCING","DONE","FAILED","DISABLED","PAUSED","PARTIALLY_SYNCED"],"title":"LastSyncResultEnum"},"StatusFd5Enum":{"type":"string","enum":["SYNCING","DONE","FAILED","DISABLED","PAUSED","PARTIALLY_SYNCED"],"title":"StatusFd5Enum"},"SyncStatusReasonEnum":{"type":"string","enum":["RATE_LIMITED","WAITING_ON_OTHER_MODELS"],"title":"SyncStatusReasonEnum"},"SelectiveSyncConfigurationsUsageEnum":{"type":"string","enum":["IN_NEXT_SYNC","IN_LAST_SYNC"],"title":"SelectiveSyncConfigurationsUsageEnum"},"SyncStatus":{"type":"object","properties":{"model_name":{"type":"string"},"model_id":{"type":"string"},"last_sync_start":{"type":"string","format":"date-time"},"next_sync_start":{"type":"string","format":"date-time"},"last_sync_result":{"$ref":"#/components/schemas/LastSyncResultEnum"},"last_sync_finished":{"type":"string","format":"date-time"},"data_fresh_as_of":{"type":["string","null"],"format":"date-time","description":"The point in time that this model's data is complete through. This is the start time of the most recent sync that completed successfully for the model. The data is current at least through this time and may be fresher. Null until the first sync completes."},"status":{"$ref":"#/components/schemas/StatusFd5Enum"},"sync_status_reason":{"oneOf":[{"$ref":"#/components/schemas/SyncStatusReasonEnum"},{"type":"null"}],"description":"Why a model is healthy but not actively progressing while its `status` stays `SYNCING`. Null when the model is progressing normally. `RATE_LIMITED` means the model is paused behind the data provider's rate limits. `WAITING_ON_OTHER_MODELS` means the model is on hold until other models finish syncing."},"is_initial_sync":{"type":"boolean"},"selective_sync_configurations_usage":{"$ref":"#/components/schemas/SelectiveSyncConfigurationsUsageEnum"}},"required":["model_name","model_id","status","sync_status_reason","is_initial_sync"],"description":"# The SyncStatus Object\n### Description\nThe `SyncStatus` object is used to represent the syncing state of an account\n\n### Usage Example\nView the `SyncStatus` for an account to see how recently its models were synced.","title":"SyncStatus"},"MethodEnum":{"type":"string","enum":["GET","OPTIONS","HEAD","POST","PUT","PATCH","DELETE"],"title":"MethodEnum"},"EncodingEnum":{"type":"string","enum":["RAW","BASE64","GZIP_BASE64"],"title":"EncodingEnum"},"MultipartFormFieldRequest":{"type":"object","properties":{"name":{"type":"string","minLength":1,"description":"The name of the form field"},"data":{"type":"string","minLength":1,"description":"The data for the form field."},"encoding":{"oneOf":[{"$ref":"#/components/schemas/EncodingEnum"},{"type":"null"}],"default":"RAW","description":"The encoding of the value of `data`. Defaults to `RAW` if not defined."},"file_name":{"type":["string","null"],"minLength":1,"description":"The file name of the form field, if the field is for a file."},"content_type":{"type":["string","null"],"minLength":1,"description":"The MIME type of the file, if the field is for a file."}},"required":["name","data"],"description":"# The MultipartFormField Object\n### Description\nThe `MultipartFormField` object is used to represent fields in an HTTP request using `multipart/form-data`.\n\n### Usage Example\nCreate a `MultipartFormField` to define a multipart form entry.","title":"MultipartFormFieldRequest"},"RequestFormatEnum":{"type":"string","enum":["JSON","XML","MULTIPART"],"title":"RequestFormatEnum"},"DataPassthroughRequest":{"type":"object","properties":{"method":{"$ref":"#/components/schemas/MethodEnum"},"path":{"type":"string","minLength":1,"description":"The path of the request in the third party's platform."},"base_url_override":{"type":["string","null"],"minLength":1,"description":"An optional override of the third party's base url for the request."},"data":{"type":["string","null"],"minLength":1,"description":"The data with the request. You must include a `request_format` parameter matching the data's format"},"multipart_form_data":{"type":["array","null"],"items":{"$ref":"#/components/schemas/MultipartFormFieldRequest"},"description":"Pass an array of `MultipartFormField` objects in here instead of using the `data` param if `request_format` is set to `MULTIPART`."},"headers":{"type":["object","null"],"additionalProperties":{"description":"Any type"},"description":"The headers to use for the request (Merge will handle the account's authorization headers). `Content-Type` header is required for passthrough. Choose content type corresponding to expected format of receiving server."},"request_format":{"oneOf":[{"$ref":"#/components/schemas/RequestFormatEnum"},{"type":"null"}]},"normalize_response":{"type":"boolean","description":"Optional. If true, the response will always be an object of the form `{\"type\": T, \"value\": ...}` where `T` will be one of `string, boolean, number, null, array, object`."}},"required":["method","path"],"description":"# The DataPassthrough Object\n### Description\nThe `DataPassthrough` object is used to send information to an otherwise-unsupported third-party endpoint.\n\n### Usage Example\nCreate a `DataPassthrough` to get team hierarchies from your Rippling integration.","title":"DataPassthroughRequest"},"ResponseTypeEnum":{"type":"string","enum":["JSON","BASE64_GZIP"],"title":"ResponseTypeEnum"},"RemoteResponse":{"type":"object","properties":{"method":{"type":"string"},"path":{"type":"string"},"status":{"type":"integer"},"response":{"description":"Any type"},"response_headers":{"type":"object","additionalProperties":{"description":"Any type"}},"response_type":{"$ref":"#/components/schemas/ResponseTypeEnum"},"headers":{"type":"object","additionalProperties":{"description":"Any type"}}},"required":["method","path","status","response"],"description":"# The RemoteResponse Object\n### Description\nThe `RemoteResponse` object is used to represent information returned from a third-party endpoint.\n\n### Usage Example\nView the `RemoteResponse` returned from your `DataPassthrough`.","title":"RemoteResponse"},"AsyncPassthroughReciept":{"type":"object","properties":{"async_passthrough_receipt_id":{"type":"string","format":"uuid"}},"required":["async_passthrough_receipt_id"],"title":"AsyncPassthroughReciept"},"PaginatedSyncStatusList":{"type":"object","properties":{"next":{"type":["string","null"]},"previous":{"type":["string","null"]},"results":{"type":"array","items":{"$ref":"#/components/schemas/SyncStatus"}}},"title":"PaginatedSyncStatusList"},"GenerateRemoteKeyRequest":{"type":"object","properties":{"name":{"type":"string","minLength":1,"description":"The name of the remote key"}},"required":["name"],"description":"# The GenerateRemoteKey Object\n### Description\nThe `GenerateRemoteKey` object is used to represent a request for a new remote key.\n\n### Usage Example\nPost a `GenerateRemoteKey` to create a new remote key.","title":"GenerateRemoteKeyRequest"},"RemoteKey":{"type":"object","properties":{"name":{"type":"string"},"key":{"type":"string"}},"required":["name","key"],"description":"# The RemoteKey Object\n### Description\nThe `RemoteKey` object is used to represent a request for a new remote key.\n\n### Usage Example\nPost a `GenerateRemoteKey` to receive a new `RemoteKey`.","title":"RemoteKey"},"RemoteKeyForRegenerationRequest":{"type":"object","properties":{"name":{"type":"string","minLength":1,"description":"The name of the remote key"}},"required":["name"],"description":"# The RemoteKeyForRegeneration Object\n### Description\nThe `RemoteKeyForRegeneration` object is used to exchange an old remote key for a new one\n\n### Usage Example\nPost a `RemoteKeyForRegeneration` to swap out an old remote key for a new one","title":"RemoteKeyForRegenerationRequest"},"RoleEnum":{"type":"string","enum":["ADMIN","DEVELOPER","MEMBER","API","SYSTEM","MERGE_TEAM","SUPPORT","END_USER"],"title":"RoleEnum"},"EventTypeEnum":{"type":"string","enum":["CREATED_REMOTE_PRODUCTION_API_KEY","DELETED_REMOTE_PRODUCTION_API_KEY","CREATED_TEST_API_KEY","DELETED_TEST_API_KEY","REGENERATED_PRODUCTION_API_KEY","REGENERATED_WEBHOOK_SIGNATURE","INVITED_USER","TWO_FACTOR_AUTH_ENABLED","TWO_FACTOR_AUTH_DISABLED","DELETED_LINKED_ACCOUNT","DELETED_ALL_COMMON_MODELS_FOR_LINKED_ACCOUNT","CREATED_DESTINATION","DELETED_DESTINATION","CHANGED_DESTINATION","CHANGED_SCOPES","CHANGED_PERSONAL_INFORMATION","CHANGED_ORGANIZATION_SETTINGS","ENABLED_INTEGRATION","DISABLED_INTEGRATION","ENABLED_CATEGORY","DISABLED_CATEGORY","CHANGED_PASSWORD","RESET_PASSWORD","ENABLED_REDACT_UNMAPPED_DATA_FOR_ORGANIZATION","ENABLED_REDACT_UNMAPPED_DATA_FOR_LINKED_ACCOUNT","DISABLED_REDACT_UNMAPPED_DATA_FOR_ORGANIZATION","DISABLED_REDACT_UNMAPPED_DATA_FOR_LINKED_ACCOUNT","CREATED_INTEGRATION_WIDE_FIELD_MAPPING","CREATED_LINKED_ACCOUNT_FIELD_MAPPING","CHANGED_INTEGRATION_WIDE_FIELD_MAPPING","CHANGED_LINKED_ACCOUNT_FIELD_MAPPING","DELETED_INTEGRATION_WIDE_FIELD_MAPPING","DELETED_LINKED_ACCOUNT_FIELD_MAPPING","CREATED_LINKED_ACCOUNT_COMMON_MODEL_OVERRIDE","CHANGED_LINKED_ACCOUNT_COMMON_MODEL_OVERRIDE","DELETED_LINKED_ACCOUNT_COMMON_MODEL_OVERRIDE","FORCED_LINKED_ACCOUNT_RESYNC","MUTED_ISSUE","GENERATED_MAGIC_LINK","ENABLED_MERGE_WEBHOOK","DISABLED_MERGE_WEBHOOK","MERGE_WEBHOOK_TARGET_CHANGED","END_USER_CREDENTIALS_ACCESSED","CHANGED_SELECTIVE_SYNC_FILTERS","ADDED_PARTNER_CREDENTIALS","UPDATED_PARTNER_CREDENTIALS","REMOVED_PARTNER_CREDENTIALS"],"title":"EventTypeEnum"},"AuditLogEvent":{"type":"object","properties":{"id":{"type":"string","format":"uuid"},"user_name":{"type":["string","null"],"maxLength":200,"description":"The User's full name at the time of this Event occurring."},"user_email":{"type":["string","null"],"format":"email","maxLength":254,"description":"The User's email at the time of this Event occurring."},"linked_account_id":{"type":["string","null"],"format":"uuid","description":"The id of the Linked Account this event was performed on, when the actor is an End User acting inside Merge Link."},"role":{"$ref":"#/components/schemas/RoleEnum","description":"Designates the role of the user (or SYSTEM/API if action not taken by a user) at the time of this Event occurring."},"ip_address":{"type":"string","maxLength":45},"event_type":{"$ref":"#/components/schemas/EventTypeEnum","description":"Designates the type of event that occurred."},"event_description":{"type":"string"},"created_at":{"type":"string","format":"date-time"}},"required":["role","ip_address","event_type","event_description"],"title":"AuditLogEvent"},"PaginatedAuditLogEventList":{"type":"object","properties":{"next":{"type":["string","null"]},"previous":{"type":["string","null"]},"results":{"type":"array","items":{"$ref":"#/components/schemas/AuditLogEvent"}}},"title":"PaginatedAuditLogEventList"}},"securitySchemes":{"tokenAuth":{"type":"http","scheme":"bearer","description":"Token-based authentication with required prefix \"Bearer\""}}}}