--- openapi: 3.0.3 info: title: Dataverse API description: Open source research data repository software. version: "6.11" tags: - name: Access description: "Download files, bundles, citations, metadata, and access-related file\ \ assets." - name: Admin description: Administrative Dataverse operations. - name: Dataset Fields description: "Dataset field type, controlled vocabulary, and metadata block loading\ \ operations." - name: Datasets description: "Dataset metadata, versions, files, and publishing operations." - name: Dataverse Featured Items description: Manage featured items displayed on dataverse pages. - name: Dataverses description: "Dataverse collection metadata, datasets, roles, groups, links, templates,\ \ storage, and featured content." - name: External Tools description: External tool registration and lookup operations. - name: Files description: "Data file metadata, upload, replacement, and editing operations." - name: Guestbooks description: Guestbook definitions and guestbook response operations. - name: Info description: General information about the Dataverse installation. - name: Licenses description: License lookup and administration operations. - name: Metadata description: Metadata block and metadata export operations. - name: Notifications description: User notification lookup and notification preference operations. - name: Roles description: Role definition and role selection operations. - name: Search description: Search and search service discovery operations. - name: Users description: User-specific data discovery and collection access operations. - name: Workflows description: Workflow administration operations. - name: addFileToDataset description: Uploads a file for a dataset - name: addFilesToDataset description: Uploads a set of files to a dataset - name: addGlobusFilesToDataset description: Uploads a Globus file for a dataset - name: replaceFilesInDataset description: Replace a file to a dataset - name: saveAuxiliaryFileWithVersion description: Save Auxiliary File With Version - name: uploadDatasetLogo description: Uploads a logo for a dataset paths: /access/datafile/bundle/{fileId}: get: tags: - Access summary: Build a file bundle description: "Streams a ZIP bundle for a data file, including citation exports\ \ and optional tabular metadata when available." operationId: Access_datafileBundle parameters: - name: fileId in: path description: Data file id or persistent identifier for the bundle. required: true schema: type: string - name: fileMetadataId in: query description: File metadata id used to select a specific file metadata record. schema: format: int64 type: integer - name: gbrecs in: query description: Whether guestbook records have already been written for this download. schema: type: boolean - name: gbrids in: query description: Guestbook response id list supplied by the user interface. schema: type: string responses: "200": description: "ZIP archive containing the data file bundle, citation files,\ \ and available metadata." content: application/zip: schema: format: binary type: string security: - DataverseApiKey: [] post: tags: - Access summary: Submit guestbook response for a file bundle description: Records the supplied guestbook response and then streams the ZIP bundle for a data file. operationId: Access_datafileBundleWithGuestbookResponse parameters: - name: fileId in: path description: Data file id or persistent identifier for the bundle. required: true schema: type: string - name: fileMetadataId in: query description: File metadata id used to select a specific file metadata record. schema: format: int64 type: integer - name: gbrecs in: query description: Whether guestbook records have already been written for this download. schema: type: boolean - name: gbrids in: query description: Guestbook response id list supplied by the user interface. schema: type: string responses: "200": description: "ZIP archive containing the data file bundle, citation files,\ \ and available metadata." content: application/zip: schema: format: binary type: string security: - DataverseApiKey: [] /access/datafile/{fileId}: get: tags: - Access summary: Downloads a data file description: Streams the requested data file after validating access and guestbook requirements. operationId: Access_datafile parameters: - name: fileId in: path description: "Data file id, persistent identifier, or path-style file reference." required: true schema: pattern: .+ type: string - name: gbrecs in: query description: Whether guestbook records have already been written for this download. schema: type: boolean - name: gbrids in: query description: Guestbook response id list supplied by the user interface. schema: type: string responses: "200": description: OK security: - DataverseApiKey: [] post: tags: - Access summary: Submit guestbook response for a data file description: Records the supplied guestbook response and returns access details for a data file download. operationId: Access_datafileWithGuestbookResponse parameters: - name: fileId in: path description: "Data file id, persistent identifier, or path-style file reference." required: true schema: pattern: .+ type: string - name: gbrecs in: query description: Whether guestbook records have already been written for this download. schema: type: boolean responses: "200": description: OK security: - DataverseApiKey: [] /access/datafile/{fileId}/auxiliary: get: tags: - Access summary: Lists auxiliary files description: Lists auxiliary files associated with the requested data file. operationId: Access_listDatafileMetadataAux parameters: - name: fileId in: path description: Data file id or persistent identifier. required: true schema: type: string responses: "200": description: OK security: - DataverseApiKey: [] /access/datafile/{fileId}/auxiliary/{formatTag}/{formatVersion}: get: tags: - Access summary: Downloads an auxiliary file description: Streams the requested auxiliary file format version after validating file access. operationId: Access_downloadAuxiliaryFile parameters: - name: fileId in: path description: Data file id or persistent identifier. required: true schema: type: string - name: formatTag in: path description: Auxiliary file format tag. required: true schema: type: string - name: formatVersion in: path description: Auxiliary file format version. required: true schema: type: string responses: "200": description: Auxiliary file bytes for the requested data file format. content: application/octet-stream: schema: format: binary type: string security: - DataverseApiKey: [] post: tags: - saveAuxiliaryFileWithVersion summary: Save auxiliary file with version description: Saves an auxiliary file operationId: Access_saveAuxiliaryFileWithVersion parameters: - name: fileId in: path description: Data file id for the auxiliary file. required: true schema: format: int64 type: integer - name: formatTag in: path description: Auxiliary file format tag. required: true schema: type: string - name: formatVersion in: path description: Auxiliary file format version. required: true schema: type: string requestBody: description: Multipart auxiliary file content and metadata to store for the data file format version. content: multipart/form-data: schema: type: string responses: "200": description: File saved response "403": description: User not authorized to edit the dataset. "400": description: File not found based on id. security: - DataverseApiKey: [] delete: tags: - Access summary: Deletes an auxiliary file description: Deletes the requested auxiliary file format version after validating edit permissions. operationId: Access_deleteAuxiliaryFileWithVersion parameters: - name: fileId in: path description: Data file id for the auxiliary file. required: true schema: format: int64 type: integer - name: formatTag in: path description: Auxiliary file format tag. required: true schema: type: string - name: formatVersion in: path description: Auxiliary file format version. required: true schema: type: string responses: "200": description: OK security: - DataverseApiKey: [] /access/datafile/{fileId}/auxiliary/{origin}: get: tags: - Access summary: Lists auxiliary files by origin description: Lists auxiliary files associated with the requested data file and origin. operationId: Access_listDatafileMetadataAuxByOrigin parameters: - name: fileId in: path description: Data file id or persistent identifier. required: true schema: type: string - name: origin in: path description: Auxiliary file origin to match. required: true schema: type: string responses: "200": description: OK security: - DataverseApiKey: [] /access/datafile/{fileId}/citation/{format}: get: tags: - Access summary: Returns a data file citation description: Formats the requested data file citation in the selected citation format after validating access. operationId: Access_datafileCitation parameters: - name: fileId in: path description: Data file id or persistent identifier. required: true schema: type: string - name: format in: path description: Citation format to return. required: true schema: type: string responses: "200": description: OK security: - DataverseApiKey: [] /access/datafile/{fileId}/metadata: get: tags: - Access summary: Export tabular file metadata description: Streams tabular data file metadata in the default DDI XML format. operationId: Access_tabularDatafileMetadata parameters: - name: fileId in: path description: Data file id or persistent identifier for the tabular file. required: true schema: type: string - name: exclude in: query description: Comma-separated metadata sections to exclude from the export. schema: type: string - name: fileMetadataId in: query description: File metadata id used to select a specific file metadata record. schema: format: int64 type: integer - name: include in: query description: Comma-separated metadata sections to include in the export. schema: type: string responses: "200": description: OK content: text/xml: schema: type: string security: - DataverseApiKey: [] /access/datafile/{fileId}/metadata/ddi: get: tags: - Access summary: Export tabular file metadata as DDI description: Streams DDI XML metadata for a tabular data file. operationId: Access_tabularDatafileMetadataDDI parameters: - name: fileId in: path description: Data file id or persistent identifier for the tabular file. required: true schema: type: string - name: exclude in: query description: Comma-separated metadata sections to exclude from the export. schema: type: string - name: fileMetadataId in: query description: File metadata id used to select a specific file metadata record. schema: format: int64 type: integer - name: include in: query description: Comma-separated metadata sections to include in the export. schema: type: string responses: "200": description: OK content: text/xml: schema: type: string security: - DataverseApiKey: [] /access/datafile/{id}/grantAccess/{identifier}: put: tags: - Access summary: Grants access to a data file description: Assigns the file downloader role to the requested assignee for a restricted data file. operationId: Access_grantFileAccess parameters: - name: id in: path description: Restricted data file id or persistent identifier. required: true schema: type: string - name: identifier in: path description: User or group identifier receiving file access. required: true schema: type: string responses: "200": description: OK security: - DataverseApiKey: [] /access/datafile/{id}/listRequests: get: tags: - Access summary: Lists data file access requests description: Lists active or historical access requests for a restricted data file. operationId: Access_listFileAccessRequests parameters: - name: id in: path description: Restricted data file id or persistent identifier. required: true schema: type: string - name: includeHistory in: query description: Includes historical access requests when true. schema: type: boolean - name: per_page in: query description: Number of historical access requests to include per page. schema: format: int32 type: integer - name: start in: query description: Pagination offset for historical access requests. schema: format: int32 type: integer responses: "200": description: OK security: - DataverseApiKey: [] /access/datafile/{id}/rejectAccess/{identifier}: put: tags: - Access summary: Rejects a data file access request description: Rejects the requested assignee's access request for a restricted data file. operationId: Access_rejectFileAccess parameters: - name: id in: path description: Restricted data file id or persistent identifier. required: true schema: type: string - name: identifier in: path description: User or group identifier whose access request is rejected. required: true schema: type: string responses: "200": description: OK security: - DataverseApiKey: [] /access/datafile/{id}/requestAccess: put: tags: - Access summary: Requests access to a restricted data file description: Creates a file access request for the authenticated user when requests are accepted and access has not already been granted. operationId: Access_requestFileAccess parameters: - name: id in: path description: Restricted data file id or persistent identifier. required: true schema: type: string responses: "200": description: OK security: - DataverseApiKey: [] /access/datafile/{id}/revokeAccess/{identifier}: delete: tags: - Access summary: Revokes access to a restricted data file description: Removes the file downloader role from the requested assignee for a restricted data file. operationId: Access_revokeFileAccess parameters: - name: id in: path description: Restricted data file id or persistent identifier. required: true schema: type: string - name: identifier in: path description: User or group identifier losing file access. required: true schema: type: string responses: "200": description: OK security: - DataverseApiKey: [] /access/datafile/{id}/userFileAccessRequested: get: tags: - Access summary: Checks whether file access was requested description: Returns whether the authenticated user has an access request recorded for the restricted data file. operationId: Access_getUserFileAccessRequested parameters: - name: id in: path description: Restricted data file id or persistent identifier. required: true schema: type: string responses: "200": description: OK security: - DataverseApiKey: [] /access/datafile/{id}/userPermissions: get: tags: - Access summary: Returns current user file permissions description: "Returns booleans indicating whether the current user may download\ \ the file, manage file permissions, or edit the owner dataset." operationId: Access_getUserPermissionsOnFile parameters: - name: id in: path description: Data file id or persistent identifier. required: true schema: type: string responses: "200": description: OK security: - DataverseApiKey: [] /access/datafiles: post: tags: - Access summary: Stream a ZIP for selected files description: Accepts a text list of data file ids and streams the selected files as a ZIP archive. operationId: Access_postDownloadDatafiles parameters: - name: gbrecs in: query description: Whether guestbook records have already been written for this download. schema: type: boolean - name: gbrids in: query description: Guestbook response id list supplied by the user interface. schema: type: string requestBody: description: Text list of data file ids to include in the ZIP archive. content: text/plain: schema: type: string responses: "200": description: OK security: - DataverseApiKey: [] /access/datafiles/{fileIds}: get: tags: - Access summary: Downloads selected data files description: Streams a ZIP archive containing the selected data files after validating access and guestbook requirements. operationId: Access_datafiles parameters: - name: fileIds in: path description: Comma-separated data file ids to include in the ZIP archive. required: true schema: type: string - name: gbrecs in: query description: Whether guestbook records have already been written for this download. schema: type: boolean - name: gbrids in: query description: Guestbook response id list supplied by the user interface. schema: type: string responses: "200": description: ZIP archive containing the selected data files. content: application/zip: schema: format: binary type: string security: - DataverseApiKey: [] post: tags: - Access summary: Submit guestbook response for selected data files description: Records a guestbook response and prepares a ZIP download for the selected data files. operationId: Access_datafilesWithGuestbookResponse parameters: - name: fileIds in: path description: Comma-separated data file ids to include in the ZIP archive. required: true schema: type: string - name: gbrecs in: query description: Whether guestbook records have already been written for this download. schema: type: boolean responses: "200": description: Signed URL details for downloading the selected data files. content: application/json: {} security: - DataverseApiKey: [] /access/dataset/{id}: get: tags: - Access summary: Downloads files from the latest dataset version description: "Streams a ZIP archive containing files from the draft version\ \ when the requester may view it, otherwise from the latest released version." operationId: Access_downloadAllFromLatest parameters: - name: id in: path description: Dataset id or persistent identifier. required: true schema: type: string - name: gbrecs in: query description: Whether guestbook records have already been written for this download. schema: type: boolean - name: gbrids in: query description: Guestbook response id list supplied by the user interface. schema: type: string responses: "200": description: ZIP archive containing files from the latest accessible dataset version. content: application/zip: schema: format: binary type: string security: - DataverseApiKey: [] post: tags: - Access summary: Submit guestbook response for latest dataset files description: Records a guestbook response and prepares a ZIP download for files in the latest accessible dataset version. operationId: Access_downloadAllFromLatestWithGuestbookResponse parameters: - name: id in: path description: Dataset id or persistent identifier. required: true schema: type: string - name: gbrecs in: query description: Whether guestbook records have already been written for this download. schema: type: boolean responses: "200": description: OK security: - DataverseApiKey: [] /access/dataset/{id}/versions/{versionId}: get: tags: - Access summary: Downloads files from a dataset version description: Streams a ZIP archive containing files from the requested dataset version after resolving version aliases such as draft or latest-published. operationId: Access_downloadAllFromVersion parameters: - name: id in: path description: Dataset id or persistent identifier. required: true schema: type: string - name: versionId in: path description: "Dataset version selector, such as draft, latest, latest-published,\ \ or a version number." required: true schema: type: string - name: gbrecs in: query description: Whether guestbook records have already been written for this download. schema: type: boolean - name: gbrids in: query description: Guestbook response id list supplied by the user interface. schema: type: string - name: key in: query description: Legacy API token query value. schema: type: string - name: signed in: query description: Whether the request URL was signed. schema: type: boolean responses: "200": description: ZIP archive containing files from the requested dataset version. content: application/zip: schema: format: binary type: string security: - DataverseApiKey: [] post: tags: - Access summary: Submit guestbook response for dataset version files description: Records a guestbook response and prepares a ZIP download for files in the requested dataset version. operationId: Access_downloadAllFromVersionWithGuestbookResponse parameters: - name: id in: path description: Dataset id or persistent identifier. required: true schema: type: string - name: versionId in: path description: "Dataset version selector, such as draft, latest, latest-published,\ \ or a version number." required: true schema: type: string - name: gbrecs in: query description: Whether guestbook records have already been written for this download. schema: type: boolean - name: key in: query description: Legacy API token query value. schema: type: string responses: "200": description: Signed URL details for downloading the requested dataset version files. content: application/json: {} security: - DataverseApiKey: [] /access/dataverseFeaturedItemImage/{itemId}: get: tags: - Access summary: Returns a featured item image description: Returns the image file associated with a dataverse featured item when the requester may view the item. operationId: Access_getDataverseFeatureItemImage parameters: - name: itemId in: path description: Dataverse featured item id. required: true schema: format: int64 type: integer responses: "200": description: PNG image associated with the dataverse featured item. content: image/png: schema: format: binary type: string security: - DataverseApiKey: [] /access/dvCardImage/{dataverseId}: get: tags: - Access summary: Returns a dataverse card image description: Returns a thumbnail image generated from the dataverse logo when one is configured. operationId: Access_dvCardImage parameters: - name: dataverseId in: path description: Dataverse id used to locate the card image. required: true schema: format: int64 type: integer responses: "200": description: PNG thumbnail image for the dataverse. content: image/png: schema: format: binary type: string security: - DataverseApiKey: [] /access/fileCardImage/{fileId}: get: tags: - Access summary: Returns a data file card image description: Returns a generated thumbnail image for a data file when the file type supports thumbnail generation. operationId: Access_fileCardImage parameters: - name: fileId in: path description: Data file id used to locate the card image. required: true schema: format: int64 type: integer responses: "200": description: PNG thumbnail image for the data file. content: image/png: schema: format: binary type: string security: - DataverseApiKey: [] /access/{id}/allowAccessRequest: put: tags: - Access summary: Updates dataset file access request settings description: Enables or disables file access requests for the dataset terms in the editable dataset version. operationId: Access_allowAccessRequest parameters: - name: id in: path description: Dataset id or persistent identifier. required: true schema: type: string responses: "200": description: OK security: - DataverseApiKey: [] /admin/archiveAllUnarchivedDatasetVersions: post: tags: - Admin summary: Archive unarchived dataset versions description: Lists or starts archival submission for published dataset versions that do not yet have archival copies. operationId: Admin_archiveAllUnarchivedDatasetVersions parameters: - name: latestonly in: query description: "When true, include only each dataset's latest version for archival\ \ submission." schema: type: boolean - name: limit in: query description: Maximum number of dataset versions to list or submit. schema: format: int32 type: integer - name: listonly in: query description: "When true, list matching dataset versions without submitting\ \ them." schema: type: boolean responses: "200": description: OK security: - DataverseApiKey: [] /admin/assignee/{idtf}: get: tags: - Admin summary: Read a role assignee description: Returns display information for a role assignee identifier. operationId: Admin_findRoleAssignee parameters: - name: idtf in: path description: Role assignee identifier. required: true schema: type: string responses: "200": description: OK /admin/assignments/assignees/{raIdtf}: get: tags: - Admin summary: Enumerate assignments for a role assignee description: Lists role assignments held by the supplied role assignee identifier. operationId: Admin_getAssignmentsFor parameters: - name: raIdtf in: path description: Role assignee identifier. required: true schema: pattern: .* type: string responses: "200": description: OK /admin/authenticatedUsers: get: tags: - Admin summary: Enumerate authenticated users description: Lists all authenticated users for a superuser. operationId: Admin_listAuthenticatedUsers responses: "200": description: OK deprecated: true security: - DataverseApiKey: [] post: tags: - Admin summary: Create an authenticated user description: "Creates an authenticated user account from provider id, persistent\ \ id, identifier, name, and email fields." operationId: Admin_createAuthenicatedUser requestBody: description: "User creation JSON containing authenticationProviderId, persistentUserId,\ \ identifier, firstName, lastName, and email." content: '*/*': schema: type: object responses: "200": description: OK /admin/authenticatedUsers/convert/builtin2oauth: put: tags: - Admin summary: Convert a built-in user to a remote account description: Converts a built-in authenticated user to a remote account using colon-separated conversion data. operationId: Admin_builtin2oauth requestBody: description: "Colon-separated email, password, replacement email, provider\ \ id, and persistent user id values." content: '*/*': schema: type: string responses: "200": description: OK security: - DataverseApiKey: [] /admin/authenticatedUsers/convert/builtin2shib: put: tags: - Admin summary: Convert a built-in user to a Shibboleth account description: Converts a built-in authenticated user to a Shibboleth account using colon-separated conversion data. operationId: Admin_builtin2shib requestBody: description: "Colon-separated email, password, and replacement email values\ \ for the conversion." content: '*/*': schema: type: string responses: "200": description: OK security: - DataverseApiKey: [] /admin/authenticatedUsers/id/{id}: delete: tags: - Admin summary: Remove an authenticated user by id description: Deletes an authenticated user by database id after checking that the account can be safely removed. operationId: Admin_deleteAuthenticatedUserById parameters: - name: id in: path description: Authenticated user database id. required: true schema: format: int64 type: integer responses: "200": description: OK /admin/authenticatedUsers/id/{id}/convertRemoteToBuiltIn: put: tags: - Admin summary: Convert a remote user to a built-in account description: Converts a remote authenticated user to a built-in account using a new email address. operationId: Admin_convertOAuthUserToBuiltin parameters: - name: id in: path description: Authenticated user database id. required: true schema: format: int64 type: integer requestBody: description: Email address for the converted built-in account. content: '*/*': schema: type: string responses: "200": description: OK security: - DataverseApiKey: [] /admin/authenticatedUsers/id/{id}/convertShibToBuiltIn: put: tags: - Admin summary: Convert a Shibboleth user to a built-in account description: Converts a remote Shibboleth authenticated user to a built-in account using a new email address. operationId: Admin_convertShibUserToBuiltin parameters: - name: id in: path description: Authenticated user database id. required: true schema: format: int64 type: integer requestBody: description: Email address for the converted built-in account. content: '*/*': schema: type: string responses: "200": description: OK deprecated: true security: - DataverseApiKey: [] /admin/authenticatedUsers/id/{id}/deactivate: post: tags: - Admin summary: Deactivate an authenticated user by id description: Disables an authenticated user account by database id. operationId: Admin_deactivateAuthenticatedUserById parameters: - name: id in: path description: Authenticated user database id. required: true schema: format: int64 type: integer responses: "200": description: OK /admin/authenticatedUsers/{identifier}: get: tags: - Admin summary: Read an authenticated user description: Returns account details for an authenticated user identifier. operationId: Admin_getAuthenticatedUserByIdentifier parameters: - name: identifier in: path description: Authenticated user identifier. required: true schema: type: string responses: "200": description: OK delete: tags: - Admin summary: Remove an authenticated user description: Deletes an authenticated user after checking that the account can be safely removed. operationId: Admin_deleteAuthenticatedUser parameters: - name: identifier in: path description: Authenticated user identifier. required: true schema: type: string responses: "200": description: OK /admin/authenticatedUsers/{identifier}/deactivate: post: tags: - Admin summary: Deactivate an authenticated user description: Disables an authenticated user account by identifier. operationId: Admin_deactivateAuthenticatedUser parameters: - name: identifier in: path description: Authenticated user identifier. required: true schema: type: string responses: "200": description: OK /admin/authenticationProviderFactories: get: tags: - Admin summary: Enumerate authentication provider factories description: Lists authentication provider factory aliases and provider information. operationId: Admin_listAuthProviderFactories responses: "200": description: OK /admin/authenticationProviders: get: tags: - Admin summary: Enumerate authentication providers description: Lists registered authentication provider rows. operationId: Admin_listAuthProviders responses: "200": description: OK post: tags: - Admin summary: Register an authentication provider description: Creates or updates an authentication provider row and registers the provider when it is enabled. operationId: Admin_addProvider requestBody: description: "Authentication provider row, including id, factory alias, enabled\ \ state, and factory configuration." content: '*/*': schema: $ref: '#/components/schemas/AuthenticationProviderRow' responses: "200": description: OK /admin/authenticationProviders/{id}: get: tags: - Admin summary: Read an authentication provider description: Returns the registered authentication provider row for the supplied provider id. operationId: Admin_showProvider parameters: - name: id in: path description: Authentication provider id. required: true schema: type: string responses: "200": description: OK delete: tags: - Admin summary: Remove an authentication provider description: Deletes an authentication provider row and deregisters the provider. operationId: Admin_deleteAuthenticationProvider parameters: - name: id in: path description: Authentication provider id. required: true schema: type: string responses: "200": description: OK /admin/authenticationProviders/{id}/:enabled: post: tags: - Admin summary: Set authentication provider enabled state through the deprecated route description: Enables or disables an authentication provider using the legacy route. operationId: Admin_enableAuthenticationProvider_deprecated parameters: - name: id in: path description: Authentication provider id. required: true schema: type: string responses: "200": description: OK /admin/authenticationProviders/{id}/enabled: get: tags: - Admin summary: Check authentication provider enabled state description: Returns whether a registered authentication provider is enabled. operationId: Admin_checkAuthenticationProviderEnabled parameters: - name: id in: path description: Authentication provider id. required: true schema: type: string responses: "200": description: OK put: tags: - Admin summary: Switch authentication provider enabled state description: Enables or disables a registered authentication provider. operationId: Admin_enableAuthenticationProvider parameters: - name: id in: path description: Authentication provider id. required: true schema: type: string responses: "200": description: OK /admin/bannerMessage: get: tags: - Admin summary: Enumerate banner messages description: Lists banner message ids and display values. operationId: Admin_getBannerMessages responses: "200": description: OK post: tags: - Admin summary: Publish a banner message description: Creates an active banner message with localized message text. operationId: Admin_addBannerMessage requestBody: description: Banner message JSON containing dismissibleByUser and messageTexts entries. content: '*/*': schema: type: object responses: "200": description: OK /admin/bannerMessage/{id}: delete: tags: - Admin summary: Remove a banner message description: Deletes a banner message by database id. operationId: Admin_deleteBannerMessage parameters: - name: id in: path description: Banner message database id. required: true schema: format: int64 type: integer responses: "200": description: OK /admin/bannerMessage/{id}/deactivate: put: tags: - Admin summary: Deactivate a banner message description: Marks a banner message inactive by database id. operationId: Admin_deactivateBannerMessage parameters: - name: id in: path description: Banner message database id. required: true schema: format: int64 type: integer responses: "200": description: OK /admin/batch/jobs: get: tags: - Admin summary: Lists batch jobs description: Returns JSON containing the execution records for all known batch job instances. operationId: BatchJobResource_listBatchJobs responses: "200": description: OK /admin/batch/jobs/name/{jobName}: get: tags: - Admin summary: Lists batch jobs by name description: Returns JSON containing execution records for batch job instances with the specified job name. operationId: BatchJobResource_listBatchJobsByName parameters: - name: jobName in: path description: Batch job name used to select job instances. required: true schema: type: string responses: "200": description: OK /admin/batch/jobs/{jobId}: get: tags: - Admin summary: Returns a batch job execution description: Returns the execution record for the specified batch job execution id as JSON. operationId: BatchJobResource_listBatchJobById parameters: - name: jobId in: path description: Numeric batch job execution id. required: true schema: type: string responses: "200": description: OK /admin/clearMetricsCache: delete: tags: - Admin summary: Clear all metrics cache entries description: Deletes every cached metric row. operationId: Admin_clearMetricsCache responses: "200": description: OK /admin/clearMetricsCache/{name}: delete: tags: - Admin summary: Clear metrics cache entries by name description: Deletes cached metric rows with the supplied metric name. operationId: Admin_clearMetricsCacheByName parameters: - name: name in: path description: Metric cache name to clear. required: true schema: type: string responses: "200": description: OK /admin/clearThumbnailFailureFlag: delete: tags: - Admin summary: Clear all thumbnail failure flags description: Resets thumbnail preview failure flags for all dataverse objects. operationId: Admin_clearThumbnailFailureFlag responses: "200": description: OK /admin/clearThumbnailFailureFlag/{id}: delete: tags: - Admin summary: Clear a data file thumbnail failure flag description: Resets the thumbnail preview failure flag for one data file. operationId: Admin_clearThumbnailFailureFlagByDatafile parameters: - name: id in: path description: Data file id or persistent identifier. required: true schema: type: string responses: "200": description: OK /admin/computeDataFileHashValue/{fileId}/algorithm/{alg}: post: tags: - Admin summary: Compute a data file hash value description: Calculates a new checksum for one non-harvested data file using the requested algorithm and saves it on the file. operationId: Admin_computeDataFileHashValue parameters: - name: alg in: path description: Checksum algorithm to calculate. required: true schema: type: string - name: fileId in: path description: Data file id or persistent identifier. required: true schema: type: string responses: "200": description: OK security: - DataverseApiKey: [] /admin/confirmEmail/{userId}: get: tags: - Admin summary: Read a confirm-email token description: Returns the active confirm-email token for an authenticated user. operationId: Admin_getConfirmEmailToken parameters: - name: userId in: path description: Authenticated user database id. required: true schema: format: int64 type: integer responses: "200": description: OK post: tags: - Admin summary: Start confirm-email processing description: Creates confirm-email data for an authenticated user and returns token metadata. operationId: Admin_startConfirmEmailProcess parameters: - name: userId in: path description: Authenticated user database id. required: true schema: format: int64 type: integer responses: "200": description: OK /admin/convertUserFromBcryptToSha1: post: tags: - Admin summary: Convert a test built-in password hash description: Rewrites a built-in user's password hash to the legacy SHA-1 test value. operationId: Admin_convertUserFromBcryptToSha1 requestBody: description: JSON object containing builtinUserId. content: '*/*': schema: type: string responses: "200": description: OK /admin/datafiles/auditFiles: get: tags: - Admin summary: Audit dataset file storage description: Checks selected datasets for missing physical files and missing file metadata. operationId: Admin_getAuditFiles parameters: - name: datasetIdentifierList in: query description: Comma-separated dataset persistent identifiers to audit instead of an id range. schema: type: string - name: firstId in: query description: Lowest dataset database id to audit. schema: format: int64 type: integer - name: lastId in: query description: Highest dataset database id to audit. schema: format: int64 type: integer responses: "200": description: OK security: - DataverseApiKey: [] /admin/datafiles/integrity/fixmissingoriginalsizes: get: tags: - Admin summary: Repair missing original file sizes description: Starts a background repair for tabular files missing original file size metadata. operationId: Admin_fixMissingOriginalSizes parameters: - name: limit in: query description: Maximum number of affected files to repair. schema: format: int32 type: integer responses: "200": description: OK /admin/datafiles/integrity/fixmissingoriginaltypes: get: tags: - Admin summary: Repair missing original file types description: Starts a background repair for tabular files missing original file type metadata. operationId: Admin_fixMissingOriginalTypes responses: "200": description: OK /admin/datasetfield: get: tags: - Dataset Fields summary: Lists dataset field groupings description: "Returns dataset field type names grouped by parent relationship,\ \ multiplicity, and required status." operationId: DatasetFieldServiceApi_getAll responses: "200": description: OK /admin/datasetfield/controlledVocabulary/subject: get: tags: - Dataset Fields summary: Lists subject vocabulary values description: Returns the configured controlled vocabulary display values for the subject dataset field. operationId: DatasetFieldServiceApi_showControlledVocabularyForSubject responses: "200": description: OK /admin/datasetfield/load: post: tags: - Dataset Fields summary: Loads dataset field definitions description: "Reads tab-separated metadata block, dataset field, and controlled\ \ vocabulary definitions from the uploaded file path and creates or updates\ \ those definitions." operationId: DatasetFieldServiceApi_loadDatasetFields requestBody: description: "Tab-separated definitions for metadata blocks, dataset fields,\ \ and controlled vocabulary values." content: text/tab-separated-values: schema: format: binary type: string responses: "200": description: OK /admin/datasetfield/loadNAControlledVocabularyValue: get: tags: - Dataset Fields summary: Creates the N/A controlled vocabulary value description: Creates the global N/A controlled vocabulary value when it is missing and reports whether it was created or already existed. operationId: DatasetFieldServiceApi_loadNAControlledVocabularyValue responses: "200": description: OK /admin/datasetfield/loadpropertyfiles: post: tags: - Dataset Fields summary: Loads language property files description: Extracts uploaded language property files into the configured Dataverse language directory while rejecting ZIP entries outside that directory. operationId: DatasetFieldServiceApi_loadLanguagePropertyFile requestBody: description: ZIP archive containing language property files to extract. content: application/zip: schema: format: binary type: string responses: "200": description: OK /admin/datasetfield/setDisplayOnCreate: post: tags: - Dataset Fields summary: Sets dataset field create-page display description: Updates whether the specified dataset field type is displayed on the dataset creation page. operationId: DatasetFieldServiceApi_setDisplayOnCreate parameters: - name: datasetFieldType in: query description: Dataset field type name to update. required: true schema: type: string - name: setDisplayOnCreate in: query description: New display-on-create setting for the dataset field type. required: true schema: type: boolean responses: "200": description: OK /admin/datasetfield/{name}: get: tags: - Dataset Fields summary: Returns a dataset field type description: "Returns a dataset field type with metadata block, Solr field names,\ \ parent relationship, multiplicity, required state, URI, and controlled vocabulary\ \ values." operationId: DatasetFieldServiceApi_getByName parameters: - name: name in: path description: Dataset field type name to return. required: true schema: type: string responses: "200": description: OK /admin/datasets/integrity/{datasetVersionId}/fixmissingunf: post: tags: - Admin summary: Repair missing UNF values description: Recalculates missing UNF values for a dataset version. operationId: Admin_fixUnf parameters: - name: datasetVersionId in: path description: Dataset version database id. required: true schema: type: string - name: forceRecalculate in: query description: "When true, recalculate UNF values even when existing values\ \ are present." schema: type: boolean responses: "200": description: OK /admin/datasets/thumbnailMetadata/{id}: get: tags: - Admin summary: Read dataset thumbnail metadata description: Returns thumbnail selection metadata and optional thumbnail image data for a dataset. operationId: Admin_getDatasetThumbnailMetadata parameters: - name: id in: path description: Dataset database id. required: true schema: format: int64 type: integer responses: "200": description: OK /admin/dataverse/curationLabelSets: get: tags: - Admin summary: Enumerate curation label sets description: Lists configured curation label sets and their labels. operationId: Admin_listCurationLabelSets responses: "200": description: OK security: - DataverseApiKey: [] /admin/dataverse/{alias}/addRoleAssignmentsToChildren: get: tags: - Admin summary: Propagate dataverse role assignments to children description: Copies configured inherited role assignments from a dataverse to its child dataverses and datasets. operationId: Admin_addRoleAssignementsToChildren parameters: - name: alias in: path description: Dataverse alias whose child objects receive role assignments. required: true schema: type: string responses: "200": description: OK security: - DataverseApiKey: [] /admin/dataverse/{alias}/curationLabelSet: get: tags: - Admin summary: Returns a dataverse curation label set description: Returns the curation label set configured on a dataverse when the requester is a superuser. operationId: Admin_getCurationLabelSet parameters: - name: alias in: path description: Dataverse alias. required: true schema: type: string responses: "200": description: OK security: - DataverseApiKey: [] put: tags: - Admin summary: Assign a dataverse curation label set description: Assigns a configured curation label set name to a dataverse. operationId: Admin_setCurationLabelSet parameters: - name: alias in: path description: Dataverse alias. required: true schema: type: string - name: name in: query description: Configured curation label set name. schema: type: string responses: "200": description: OK security: - DataverseApiKey: [] delete: tags: - Admin summary: Reset a dataverse curation label set description: Restores a dataverse to the default curation label set setting. operationId: Admin_resetCurationLabelSet parameters: - name: alias in: path description: Dataverse alias. required: true schema: type: string responses: "200": description: OK security: - DataverseApiKey: [] /admin/downloadTmpFile: get: tags: - Admin summary: Download a temporary file description: Streams a file from the local /tmp directory for superuser testing. operationId: Admin_downloadTmpFile parameters: - name: fullyQualifiedPathToFile in: query description: Absolute path under /tmp to stream. schema: type: string responses: "200": description: OK security: - DataverseApiKey: [] /admin/externalTools: get: tags: - External Tools summary: Lists external tools description: Returns all registered external tools as JSON. operationId: ExternalTools_getExternalTools responses: "200": description: OK post: tags: - External Tools summary: Registers an external tool description: "Parses an external tool manifest, saves the tool definition, and\ \ returns the saved tool as JSON." operationId: ExternalTools_addExternalTool requestBody: description: External tool manifest JSON to parse and register. content: '*/*': schema: type: string responses: "200": description: OK /admin/externalTools/{id}: get: tags: - External Tools summary: Returns an external tool description: Returns the registered external tool with the specified numeric id. operationId: ExternalTools_getExternalTool parameters: - name: id in: path description: Numeric id of the external tool to return. required: true schema: format: int64 type: integer responses: "200": description: OK delete: tags: - External Tools summary: Deletes an external tool description: Deletes the registered external tool with the specified numeric id. operationId: ExternalTools_deleteExternalTool parameters: - name: id in: path description: Numeric id of the external tool to delete. required: true schema: format: int64 type: integer responses: "200": description: OK /admin/featureFlags: get: tags: - Admin summary: Enumerate feature flags description: Lists feature flag names with enabled or disabled status. operationId: Admin_getFeatureFlags responses: "200": description: OK /admin/featureFlags/{flag}: get: tags: - Admin summary: Read a feature flag description: Returns enabled status for one feature flag. operationId: Admin_getFeatureFlag parameters: - name: flag in: path description: Feature flag enum name. required: true schema: type: string responses: "200": description: OK /admin/feedback: post: tags: - Admin summary: Submits administrative feedback description: Sends a feedback email to contacts for a target object or to the support address when no target is supplied. operationId: FeedbackApi_submitFeedback requestBody: description: "Feedback JSON with subject, body, sender email, and an optional\ \ target object id." content: '*/*': schema: type: object responses: "200": description: OK /admin/groups/domain: get: tags: - Admin summary: Lists mail-domain groups description: Returns all global mail-domain groups as JSON. operationId: Groups_listMailDomainGroups responses: "200": description: OK post: tags: - Admin summary: Creates a mail-domain group description: Creates a global mail-domain group from the supplied JSON and refreshes mail-domain group membership. operationId: Groups_createMailDomainGroup requestBody: description: Mail-domain group definition with alias and domain matching rules. content: '*/*': schema: type: object responses: "200": description: OK /admin/groups/domain/{groupAlias}: get: tags: - Admin summary: Returns a mail-domain group description: Returns the global mail-domain group with the specified alias. operationId: Groups_getMailDomainGroup parameters: - name: groupAlias in: path description: Mail-domain group alias to return. required: true schema: type: string responses: "200": description: OK put: tags: - Admin summary: Creates or replaces a mail-domain group description: Creates or replaces a global mail-domain group with the specified alias and refreshes mail-domain group membership. operationId: Groups_updateMailDomainGroups parameters: - name: groupAlias in: path description: Mail-domain group alias to create or replace. required: true schema: type: string requestBody: description: Mail-domain group definition with domain matching rules. content: '*/*': schema: type: object responses: "200": description: OK delete: tags: - Admin summary: Deletes a mail-domain group description: Deletes the global mail-domain group with the specified alias and refreshes mail-domain group membership. operationId: Groups_deleteMailDomainGroup parameters: - name: groupAlias in: path description: Mail-domain group alias to delete. required: true schema: type: string responses: "200": description: OK /admin/groups/ip: get: tags: - Admin summary: Lists IP groups description: Returns all global IP groups as JSON. operationId: Groups_listIpGroups responses: "200": description: OK post: tags: - Admin summary: Creates an IP group description: Creates a global IP group from the supplied JSON and assigns an available persisted group alias. operationId: Groups_postIpGroup requestBody: description: IP group definition with alias and IP address ranges. content: '*/*': schema: type: object responses: "200": description: OK /admin/groups/ip/{group}: get: tags: - Admin summary: Returns an IP group description: Returns a global IP group identified by numeric id or alias. operationId: Groups_getIpGroup parameters: - name: group in: path description: IP group numeric id or alias. required: true schema: type: string responses: "200": description: OK put: tags: - Admin summary: Creates or replaces an IP group description: Creates or replaces a global IP group with the specified group alias. operationId: Groups_putIpGroups parameters: - name: group in: path description: IP group alias to create or replace. required: true schema: type: string requestBody: description: IP group definition with IP address ranges. content: '*/*': schema: type: object responses: "200": description: OK delete: tags: - Admin summary: Deletes an IP group description: Deletes a global IP group identified by numeric id or alias. operationId: Groups_deleteIpGroup parameters: - name: group in: path description: IP group numeric id or alias. required: true schema: type: string responses: "200": description: OK /admin/groups/shib: get: tags: - Admin summary: Lists Shibboleth groups description: Returns all global Shibboleth groups as JSON. operationId: Groups_listShibGroups responses: "200": description: OK post: tags: - Admin summary: Creates a Shibboleth group description: "Creates a Shibboleth group from name, attribute, and pattern values\ \ in the supplied JSON." operationId: Groups_createShibGroup requestBody: description: "Shibboleth group JSON containing name, attribute, and pattern." content: '*/*': schema: type: object responses: "200": description: OK /admin/groups/shib/{primaryKey}: delete: tags: - Admin summary: Deletes a Shibboleth group description: Deletes the Shibboleth group with the specified primary key. operationId: Groups_deleteShibGroup parameters: - name: primaryKey in: path description: Primary key of the Shibboleth group to delete. required: true schema: type: string responses: "200": description: OK /admin/index: get: tags: - Admin summary: Starts indexing all content description: "Starts indexing all dataverses and datasets or one selected partition,\ \ with an option to preview the selected workload." operationId: Index_indexAllOrSubset parameters: - name: numPartitions in: query description: Number of index partitions to divide the workload into. schema: format: int64 type: integer - name: partitionIdToProcess in: query description: Partition id to process when the workload is divided into partitions. schema: format: int64 type: integer - name: previewOnly in: query description: Preview the selected indexing workload without starting indexing. schema: type: boolean responses: "200": description: OK /admin/index/clear: get: tags: - Admin summary: Clears the Solr index description: Clears all Solr documents and resets stored index timestamps. operationId: Index_clearSolrIndex responses: "200": description: OK /admin/index/clear-orphans: get: tags: - Admin summary: Clears orphaned index documents description: Removes Solr documents that no longer correspond to database records. operationId: Index_clearOrphans parameters: - name: sync in: query description: Whether to run the indexing task synchronously. schema: type: string responses: "200": description: OK /admin/index/continue: get: tags: - Admin summary: Continues indexing unindexed content description: "Starts indexing one selected partition while skipping content\ \ that has already been indexed, with an option to preview the selected workload." operationId: Index_indexAllOrSubsetContinue parameters: - name: numPartitions in: query description: Number of index partitions to divide the workload into. schema: format: int64 type: integer - name: partitionIdToProcess in: query description: Partition id to process when the workload is divided into partitions. schema: format: int64 type: integer - name: previewOnly in: query description: Preview the selected indexing workload without starting indexing. schema: type: boolean responses: "200": description: OK /admin/index/dataset: get: tags: - Admin summary: Starts indexing a dataset by PID description: "Looks up a dataset by persistent identifier, starts dataset indexing,\ \ and returns version identifiers for the dataset." operationId: Index_indexDatasetByPersistentId parameters: - name: persistentId in: query description: Persistent identifier of the dataset to index. required: true schema: type: string responses: "200": description: OK /admin/index/datasets/{id}: delete: tags: - Admin summary: Clears a dataset from the Solr index description: "Removes the Solr document for the specified dataset id, even when\ \ the dataset no longer exists in the database." operationId: Index_clearDatasetFromIndex parameters: - name: id in: path description: Numeric id of the dataset to remove from Solr. required: true schema: format: int64 type: integer responses: "200": description: OK /admin/index/filemetadata/{dataset_id}: get: tags: - Admin summary: Lists file metadata by dataset version description: Returns file metadata rows for a dataset version with optional result limit and sorting. operationId: Index_getFileMetadataByDatasetId parameters: - name: dataset_id in: path description: Dataset id. required: true schema: format: int64 type: integer - name: maxResults in: query description: Maximum number of results to return. schema: format: int32 type: integer - name: order in: query description: Sort order. schema: type: string - name: sort in: query description: Sort field. schema: type: string responses: "200": description: OK /admin/index/filesearch: get: tags: - Admin summary: Searches files in a dataset description: "Searches files within a dataset and returns file search results,\ \ facets, filters, and dataset version context." operationId: Index_filesearch parameters: - name: persistentId in: query description: Persistent identifier. schema: type: string - name: q in: query description: Search query string. schema: type: string - name: semanticVersion in: query description: Semantic version filter. schema: type: string responses: "200": description: OK security: - DataverseApiKey: [] /admin/index/mod: get: tags: - Admin summary: Tests index partition assignment description: Returns the object ids assigned to an indexing partition for a requested partition count and partition number. operationId: Index_indexMod parameters: - name: partitions in: query description: Number of indexing partitions. schema: format: int64 type: integer - name: which in: query description: Indexing partition to process. schema: format: int64 type: integer responses: "200": description: OK /admin/index/perms: post: tags: - Admin summary: Indexes all permissions description: Rebuilds Solr permission documents for all indexed dataverse objects. operationId: Index_indexAllPermissions responses: "200": description: OK security: - DataverseApiKey: [] /admin/index/perms/{id}: post: tags: - Admin summary: Indexes permissions for an object description: Rebuilds Solr permission documents for one dataverse object. operationId: Index_indexPermissions parameters: - name: id in: path description: Resource id required: true schema: format: int64 type: integer responses: "200": description: OK security: - DataverseApiKey: [] /admin/index/permsDebug: get: tags: - Admin summary: Returns permission index debug data description: "Returns Solr permission document, timestamp, and role assignment\ \ data for one dataverse object." operationId: Index_searchPermsDebug parameters: - name: id in: query description: Resource id or persistent identifier. schema: format: int64 type: integer - name: key in: query description: Legacy API token query value. schema: type: string responses: "200": description: OK /admin/index/solr/schema: get: tags: - Admin summary: Returns the Solr schema description: Generates the Solr schema definition from configured dataset field types. operationId: Index_getSolrSchema responses: "200": description: OK content: '*/*': schema: type: string /admin/index/status: get: tags: - Admin summary: Checks index status description: Checks consistency between the database and Solr index and returns status by content type. operationId: Index_indexStatus parameters: - name: sync in: query description: Whether to run the indexing task synchronously. schema: type: string responses: "200": description: OK /admin/index/test: get: tags: - Admin summary: Runs a search debug query description: Runs a search debug query for integration testing and returns matching result labels. operationId: Index_searchDebug parameters: - name: fq in: query description: Filter query. schema: type: array items: type: string - name: key in: query description: Legacy API token query value. schema: type: string - name: q in: query description: Search query string. schema: type: string responses: "200": description: OK /admin/index/timestamps: delete: tags: - Admin summary: Clears all index timestamps description: Clears index timestamp fields for all dataverse objects. operationId: Index_deleteAllTimestamps responses: "200": description: OK /admin/index/timestamps/{dvObjectId}: delete: tags: - Admin summary: Clears an index timestamp description: Clears index timestamp fields for one dataverse object. operationId: Index_deleteTimestamp parameters: - name: dvObjectId in: path description: Dataverse object id. required: true schema: format: int64 type: integer responses: "200": description: OK /admin/index/{type}/{id}: get: tags: - Admin summary: Starts indexing one object description: "Starts reindexing a dataverse, dataset, or file by numeric id,\ \ or removes a stale Solr document when the object is missing." operationId: Index_indexTypeById parameters: - name: id in: path description: Numeric id of the object to index. required: true schema: format: int64 type: integer - name: type in: path description: "Object type to index: dataverses, datasets, or files." required: true schema: type: string responses: "200": description: OK /admin/isOrcid: get: tags: - Admin summary: Check ORCID authentication support description: Returns whether ORCID authentication is enabled. operationId: Admin_isOrcidEnabled responses: "200": description: OK /admin/list-users: get: tags: - Admin summary: Search authenticated users description: Searches authenticated users for the dashboard user list and returns paged JSON results. operationId: Admin_filterAuthenticatedUsers parameters: - name: itemsPerPage in: query description: Number of users to include on each page. schema: format: int32 type: integer - name: searchTerm in: query description: Search text matched against authenticated users. schema: type: string - name: selectedPage in: query description: One-based result page to return. schema: format: int32 type: integer - name: sortKey in: query description: Sort field used for the user list. schema: type: string responses: "200": description: OK security: - DataverseApiKey: [] /admin/makeDataCount/addUsageMetricsFromSushiReport: post: tags: - Admin summary: Adds usage metrics from a SUSHI report for all datasets description: "Parses a SUSHI report from disk, saves usage metrics for all datasets\ \ represented in the report, and reports completion." operationId: MakeDataCountApi_addUsageMetricsFromSushiReportAll parameters: - name: reportOnDisk in: query description: Server-side path to the SUSHI report JSON file. required: true schema: type: string responses: "200": description: OK /admin/makeDataCount/sendToHub: post: tags: - Admin summary: Reports Make Data Count hub submission description: Returns a confirmation message for Make Data Count hub submission. operationId: MakeDataCountApi_sendDataToHub responses: "200": description: OK /admin/makeDataCount/{id}/addUsageMetricsFromSushiReport: post: tags: - Admin summary: Adds usage metrics from a SUSHI report description: "Parses a SUSHI report from disk, saves usage metrics for the specified\ \ dataset, and reports completion." operationId: MakeDataCountApi_addUsageMetricsFromSushiReport parameters: - name: id in: path description: Dataset id or persistent identifier that receives the usage metrics. required: true schema: type: string - name: reportOnDisk in: query description: Server-side path to the SUSHI report JSON file. required: true schema: type: string responses: "200": description: OK /admin/makeDataCount/{id}/updateCitationsForDataset: post: tags: - Admin summary: Queues citation updates for a dataset description: Validates that the dataset uses a DataCite DOI provider and queues a background citation update from DataCite EventData. operationId: MakeDataCountApi_updateCitationsForDataset parameters: - name: id in: path description: Dataset id or persistent identifier whose citation metrics are updated. required: true schema: type: string responses: "200": description: OK /admin/makeDataCount/{yearMonth}/processingState: get: tags: - Admin summary: Returns Make Data Count processing state description: "Returns the processing state, state-change timestamp, and server\ \ for the specified year and month." operationId: MakeDataCountApi_getProcessingState parameters: - name: yearMonth in: path description: "Year and month for the processing state, formatted as YYYY-MM." required: true schema: type: string responses: "200": description: OK post: tags: - Admin summary: Sets Make Data Count processing state description: Creates or updates the processing state for the specified year and month. operationId: MakeDataCountApi_updateProcessingState parameters: - name: yearMonth in: path description: "Year and month for the processing state, formatted as YYYY-MM." required: true schema: type: string - name: server in: query description: Server name associated with the processing state. schema: type: string - name: state in: query description: Processing state value to store. required: true schema: type: string responses: "200": description: OK delete: tags: - Admin summary: Deletes Make Data Count processing state description: Deletes the processing state for the specified year and month. operationId: MakeDataCountApi_deleteProcessingState parameters: - name: yearMonth in: path description: "Year and month for the processing state, formatted as YYYY-MM." required: true schema: type: string responses: "200": description: OK /admin/metadata/clearExportTimestamps: get: tags: - Admin summary: Clears metadata export timestamps description: Clears stored metadata export timestamps for all datasets without deleting cached metadata export files. operationId: Metadata_clearExportTimestamps responses: "200": description: OK /admin/metadata/exportAll: get: tags: - Admin summary: Starts metadata export jobs description: Starts background exports for published local datasets that have not been exported since their last publication. operationId: Metadata_exportAll responses: "200": description: OK /admin/metadata/exportOAI/{specname}: put: tags: - Admin summary: Starts an OAI set export description: Marks the specified OAI set as updating and starts its metadata export in the background. operationId: Metadata_exportOaiSet parameters: - name: specname in: path description: OAI set specification name to export. required: true schema: type: string responses: "200": description: OK /admin/metadata/reExportAll: get: tags: - Admin summary: Starts metadata re-export jobs description: "Starts background re-export jobs for published local datasets,\ \ optionally limited to datasets older than a supplied date." operationId: Metadata_reExportAll parameters: - name: olderThan in: query description: Optional cutoff date in YYYY-MM-DD format for selecting datasets to re-export. schema: type: string responses: "200": description: OK /admin/metadata/{id}/reExportDataset: get: tags: - Admin summary: Starts a dataset metadata re-export description: Starts a background metadata re-export for the specified dataset. operationId: Metadata_indexDatasetByPersistentId parameters: - name: id in: path description: Dataset id or persistent identifier to re-export. required: true schema: type: string responses: "200": description: OK /admin/permissions/{dvo}: get: tags: - Admin summary: Inspect permissions on a Dataverse object description: Returns the requesting user's permissions on the selected dataverse object. operationId: Admin_findPermissonsOn parameters: - name: dvo in: path description: Dataverse object id or persistent identifier. required: true schema: type: string responses: "200": description: OK security: - DataverseApiKey: [] /admin/publishDataverseAsCreator/{id}: post: tags: - Admin summary: Publish a dataverse as its creator description: Publishes a dataverse using the dataverse creator as the request user. operationId: Admin_publishDataverseAsCreator parameters: - name: id in: path description: Dataverse database id. required: true schema: format: int64 type: integer responses: "200": description: OK /admin/rateLimitStats: get: tags: - Admin summary: Download rate-limit statistics description: Streams cached rate-limit statistics as CSV for a superuser. operationId: Admin_rateLimitStats parameters: - name: deltaMinutesFilter in: query description: Limit statistics to entries within this many minutes. schema: format: int64 type: integer responses: "200": description: OK security: - DataverseApiKey: [] /admin/registerDataFileAll: get: tags: - Admin summary: Process PID assignment for all eligible data files description: "Scans all data files and assigns persistent identifiers to released,\ \ unregistered files in collections where file PIDs are enabled." operationId: Admin_registerDataFileAll responses: "200": description: OK security: - DataverseApiKey: [] /admin/registerDataFiles/{alias}: get: tags: - Admin summary: Process PID assignment for collection data files description: "Assigns persistent identifiers to released, unregistered files\ \ directly owned by a collection." operationId: Admin_registerDataFilesInCollection parameters: - name: alias in: path description: Dataverse alias for the collection whose files are processed. required: true schema: type: string - name: sleep in: query description: Seconds to wait between file registration attempts. schema: format: int32 type: integer responses: "200": description: OK security: - DataverseApiKey: [] /admin/requestSignedUrl: post: tags: - Admin summary: Sign a URL description: Creates a signed URL for a supplied URL and optional user token context. operationId: Admin_getSignedUrl requestBody: description: "JSON object containing url, optional user identifier, timeout,\ \ HTTP method, and optional credential key." content: application/json: schema: type: object responses: "200": description: OK security: - DataverseApiKey: [] /admin/roles: get: tags: - Admin summary: Enumerate built-in roles description: Lists built-in Dataverse roles. operationId: Admin_listBuiltinRoles responses: "200": description: OK post: tags: - Admin summary: Create a built-in role description: Creates a built-in Dataverse role from the supplied role definition. operationId: Admin_createNewBuiltinRole requestBody: description: "Role definition containing alias, name, description, and permissions." content: '*/*': schema: $ref: '#/components/schemas/RoleDTO' responses: "200": description: OK /admin/roles/{id}: put: tags: - Admin summary: Revise a built-in role description: Updates an existing built-in Dataverse role from the supplied role definition. operationId: Admin_updateBuiltinRole parameters: - name: id in: path description: Role database id. required: true schema: format: int64 type: integer requestBody: description: "Updated role definition containing alias, name, description,\ \ and permissions." content: '*/*': schema: $ref: '#/components/schemas/RoleDTO' responses: "200": description: OK delete: tags: - Admin summary: Remove a built-in role description: Deletes a Dataverse role by id or alias. operationId: Admin_deleteRole parameters: - name: id in: path description: Role id or alias. required: true schema: type: string responses: "200": description: OK security: - DataverseApiKey: [] /admin/savedsearches: get: tags: - Admin summary: Lists saved-search endpoints description: Returns a simple list of supported saved-search administration endpoint patterns. operationId: SavedSearches_meta responses: "200": description: OK post: tags: - Admin summary: Creates a saved search description: "Creates a saved search from query, creator id, definition point\ \ id, and optional filter queries." operationId: SavedSearches_add requestBody: description: "Saved-search JSON containing creatorId, query, definitionPointId,\ \ and optional filterQueries." content: '*/*': schema: type: object responses: "200": description: OK /admin/savedsearches/list: get: tags: - Admin summary: Lists saved searches description: "Returns all saved searches with query, filter queries, id, definition\ \ point, and creator id." operationId: SavedSearches_list responses: "200": description: OK /admin/savedsearches/makelinks/all: put: tags: - Admin summary: Creates links for all saved searches description: Processes all saved searches and creates links for matching results. operationId: SavedSearches_makeLinksForAllSavedSearches parameters: - name: debug in: query description: Include debug information in the link creation response. schema: type: boolean responses: "200": description: OK /admin/savedsearches/makelinks/{id}: put: tags: - Admin summary: Creates links for a saved search description: Processes one saved search and creates links for matching results. operationId: SavedSearches_makeLinksForSingleSavedSearch parameters: - name: id in: path description: Numeric id of the saved search to process. required: true schema: format: int64 type: integer - name: debug in: query description: Include debug information in the link creation response. schema: type: boolean responses: "200": description: OK /admin/savedsearches/{id}: get: tags: - Admin summary: Returns a saved search description: "Returns one saved search with query, filter queries, id, definition\ \ point, and creator id." operationId: SavedSearches_show parameters: - name: id in: path description: Numeric id of the saved search to return. required: true schema: format: int64 type: integer responses: "200": description: OK delete: tags: - Admin summary: Deletes a saved search description: Deletes the specified saved search and optionally unlinks generated links. operationId: SavedSearches_delete parameters: - name: id in: path description: Numeric id of the saved search to delete. required: true schema: format: int64 type: integer - name: unlink in: query description: Remove links created from the saved search. schema: type: boolean responses: "200": description: OK /admin/settings: get: tags: - Admin summary: Enumerate database settings description: Lists all Dataverse database settings as a JSON object. operationId: Admin_listAllSettings responses: "200": description: All database options successfully queried content: {} put: tags: - Admin summary: Replace database settings description: Creates or replaces multiple Dataverse database settings from a JSON object. operationId: Admin_putAllSettings requestBody: description: JSON object whose keys are setting names and whose values are setting values. content: application/json: schema: type: object responses: "200": description: All database options successfully updated /admin/settings/{name}: get: tags: - Admin summary: Read a database setting description: Returns the value for a Dataverse database setting. operationId: Admin_getSettingByName parameters: - name: name in: path description: Database setting name. required: true schema: type: string responses: "200": description: OK put: tags: - Admin summary: Store a database setting description: Creates or replaces a Dataverse database setting value. operationId: Admin_putSetting parameters: - name: name in: path description: Database setting name. required: true schema: type: string responses: "200": description: OK delete: tags: - Admin summary: Remove a database setting description: Deletes a Dataverse database setting by name. operationId: Admin_deleteSetting parameters: - name: name in: path description: Database setting name. required: true schema: type: string responses: "200": description: OK /admin/settings/{name}/lang/{lang}: get: tags: - Admin summary: Read a localized database setting description: Returns the language-specific value for a Dataverse database setting. operationId: Admin_getLocalizedSetting parameters: - name: lang in: path description: Language code for the localized value. required: true schema: type: string - name: name in: path description: Database setting name. required: true schema: type: string responses: "200": description: OK put: tags: - Admin summary: Store a localized database setting description: Creates or replaces a language-specific Dataverse database setting value. operationId: Admin_putSettingLang parameters: - name: lang in: path description: Language code for the localized value. required: true schema: type: string - name: name in: path description: Database setting name. required: true schema: type: string responses: "200": description: OK delete: tags: - Admin summary: Remove a localized database setting description: Deletes a language-specific Dataverse database setting value. operationId: Admin_deleteSettingLang parameters: - name: lang in: path description: Language code for the localized value. required: true schema: type: string - name: name in: path description: Database setting name. required: true schema: type: string responses: "200": description: OK /admin/sitemap: post: tags: - Admin summary: Starts a sitemap update description: Starts regeneration of the site map for all dataverses and datasets when no staged sitemap file is present. operationId: SiteMap_updateSiteMap responses: "200": description: OK /admin/storageSites: get: tags: - Admin summary: Lists storage sites description: Returns all configured storage sites as JSON. operationId: StorageSites_listAll responses: "200": description: OK post: tags: - Admin summary: Creates a storage site description: Parses and persists a storage site definition after validating that only one site is primary. operationId: StorageSites_addSite requestBody: description: Storage site definition to parse and persist. content: '*/*': schema: type: object responses: "200": description: OK /admin/storageSites/{id}: get: tags: - Admin summary: Returns a storage site description: Returns the configured storage site with the specified numeric id. operationId: StorageSites_get parameters: - name: id in: path description: Numeric id of the storage site to return. required: true schema: format: int64 type: integer responses: "200": description: OK delete: tags: - Admin summary: Deletes a storage site description: Deletes the configured storage site with the specified numeric id. operationId: StorageSites_delete parameters: - name: id in: path description: Numeric id of the storage site to delete. required: true schema: format: int64 type: integer responses: "200": description: OK /admin/storageSites/{id}/primaryStorage: put: tags: - Admin summary: Sets primary storage for a site description: Updates the primary-storage flag for the specified storage site after validating the primary-site constraint. operationId: StorageSites_setPrimary parameters: - name: id in: path description: Numeric id of the storage site to update. required: true schema: format: int64 type: integer requestBody: description: Boolean text indicating whether the storage site is primary. content: '*/*': schema: type: string responses: "200": description: OK /admin/submitDatasetVersionToArchive/{id}/{version}: post: tags: - Admin summary: Submit a dataset version to an archive description: Starts archival submission for a dataset version that has not already been archived. operationId: Admin_submitDatasetVersionToArchive parameters: - name: id in: path description: Dataset id or persistent identifier. required: true schema: type: string - name: version in: path description: Dataset version number. required: true schema: type: string responses: "200": description: OK security: - DataverseApiKey: [] /admin/superuser/{identifier}: put: tags: - Admin summary: Assign superuser status description: Sets whether an authenticated user has superuser privileges. operationId: Admin_setSuperuserStatus parameters: - name: identifier in: path description: Authenticated user identifier. required: true schema: type: string responses: "200": description: OK post: tags: - Admin summary: Toggle superuser status description: Switches an authenticated user between superuser and non-superuser status. operationId: Admin_toggleSuperuser parameters: - name: identifier in: path description: Authenticated user identifier. required: true schema: type: string responses: "200": description: OK deprecated: true /admin/template/{id}: delete: tags: - Admin summary: Remove a metadata template description: Deletes a metadata template and clears default-template references that point to it. operationId: Admin_deleteTemplate parameters: - name: id in: path description: Template database id. required: true schema: format: int64 type: integer responses: "200": description: OK /admin/templates: get: tags: - Admin summary: Enumerate metadata templates description: "Lists metadata templates with template id, name, and owner information." operationId: Admin_findAllTemplates responses: "200": description: OK /admin/templates/{alias}: get: tags: - Admin summary: Enumerate metadata templates for a dataverse description: Lists metadata templates owned by the dataverse with the supplied alias. operationId: Admin_findTemplates parameters: - name: alias in: path description: Dataverse alias whose templates are listed. required: true schema: type: string responses: "200": description: OK /admin/updateHashValues/{alg}: get: tags: - Admin summary: Updates file hash values description: Recalculates file hash values with the requested algorithm for eligible files when the requester is authorized. operationId: Admin_updateHashValues parameters: - name: alg in: path description: Checksum algorithm. required: true schema: type: string - name: num in: query description: Maximum number of objects to update. schema: format: int32 type: integer responses: "200": description: OK security: - DataverseApiKey: [] /admin/validate/dataset/files/{id}: get: tags: - Admin summary: Validate files in one dataset description: Streams checksum validation results for all data files in a dataset. operationId: Admin_validateDatasetDatafiles parameters: - name: id in: path description: Dataset id or persistent identifier. required: true schema: type: string responses: "200": description: OK /admin/validate/dataset/{id}: get: tags: - Admin summary: Validate one dataset description: Validates a dataset and returns either valid status or the first constraint violation. operationId: Admin_validateDataset parameters: - name: id in: path description: Dataset id or persistent identifier. required: true schema: type: string - name: variables in: query description: Whether to include variable-level validation details. schema: type: boolean responses: "200": description: OK /admin/validate/datasets: get: tags: - Admin summary: Validate all datasets description: Streams validation results for every local dataset. operationId: Admin_validateAllDatasets parameters: - name: variables in: query description: Whether to include variable-level validation details. schema: type: boolean responses: "200": description: OK /admin/validateDataFileHashValue/{fileId}: post: tags: - Admin summary: Validate a data file hash value description: Recalculates a data file checksum and compares it with the stored checksum. operationId: Admin_validateDataFileHashValue parameters: - name: fileId in: path description: Data file id or persistent identifier. required: true schema: type: string responses: "200": description: OK security: - DataverseApiKey: [] /admin/validatePassword: post: tags: - Admin summary: Validate a password description: Checks a password against the configured password policy and returns validation errors. operationId: Admin_validatePassword requestBody: description: Password text to validate. content: '*/*': schema: type: string responses: "200": description: OK /admin/workflows: get: tags: - Workflows summary: Lists workflows description: Returns brief JSON entries for all configured workflows. operationId: WorkflowsAdmin_listWorkflows responses: "200": description: OK post: tags: - Workflows summary: Creates a workflow description: "Parses a workflow definition, saves it, and returns the created\ \ workflow." operationId: WorkflowsAdmin_addWorkflow requestBody: description: Workflow definition to parse and persist. content: '*/*': schema: type: object responses: "200": description: OK /admin/workflows/default: get: tags: - Workflows summary: Lists default workflows description: Returns each workflow trigger type with its configured default workflow or null when no default is set. operationId: WorkflowsAdmin_listDefaults responses: "200": description: OK /admin/workflows/default/{triggerType}: get: tags: - Workflows summary: Returns a default workflow description: Returns the default workflow configured for the specified trigger type. operationId: WorkflowsAdmin_getDefault parameters: - name: triggerType in: path description: Workflow trigger type whose default workflow is requested. required: true schema: type: string responses: "200": description: OK put: tags: - Workflows summary: Sets a default workflow description: Sets the workflow id used by default for the specified workflow trigger type. operationId: WorkflowsAdmin_setDefault parameters: - name: triggerType in: path description: Workflow trigger type that receives the default workflow. required: true schema: type: string responses: "200": description: OK delete: tags: - Workflows summary: Clears a default workflow description: Removes the default workflow assignment for the specified trigger type. operationId: WorkflowsAdmin_deleteDefault parameters: - name: triggerType in: path description: Workflow trigger type whose default assignment is removed. required: true schema: type: string responses: "200": description: OK /admin/workflows/ip-whitelist: get: tags: - Workflows summary: Returns the workflow IP allowlist description: Returns the semicolon-separated IP addresses allowed to resume external workflow steps. operationId: WorkflowsAdmin_getIpWhitelist responses: "200": description: OK put: tags: - Workflows summary: Sets the workflow IP allowlist description: Validates and stores the semicolon-separated IP addresses allowed to resume external workflow steps. operationId: WorkflowsAdmin_setIpWhitelist requestBody: description: Semicolon-separated IP addresses allowed to resume external workflow steps. content: '*/*': schema: type: string responses: "200": description: OK delete: tags: - Workflows summary: Resets the workflow IP allowlist description: Deletes the configured workflow IP allowlist so the default localhost allowlist is used. operationId: WorkflowsAdmin_deleteIpWhitelist responses: "200": description: OK /admin/workflows/{id}: get: tags: - Workflows summary: Returns a workflow description: Returns the workflow with the specified numeric id. operationId: WorkflowsAdmin_getWorkflow parameters: - name: id in: path description: Numeric id of the workflow to return. required: true schema: type: string responses: "200": description: OK delete: tags: - Workflows summary: Deletes a workflow description: Deletes the workflow with the specified numeric id unless it is configured as a default workflow. operationId: WorkflowsAdmin_deleteWorkflow parameters: - name: id in: path description: Numeric id of the workflow to delete. required: true schema: type: string responses: "200": description: OK /admin/{id}/registerDataFile: get: tags: - Admin summary: Process PID assignment for a data file description: Attempts persistent identifier assignment for one published data file when file PIDs are enabled. operationId: Admin_registerDataFile parameters: - name: id in: path description: Data file id or persistent identifier. required: true schema: type: string responses: "200": description: OK security: - DataverseApiKey: [] /admin/{id}/reregisterHDLToPID: post: tags: - Admin summary: Migrate a dataset handle registration to DOI description: Registers a dataset PID again when migrating a released handle-based dataset to DOI. operationId: Admin_reregisterHdlToPID parameters: - name: id in: path description: Dataset id or persistent identifier. required: true schema: type: string responses: "200": description: OK security: - DataverseApiKey: [] /batch/harvest: get: tags: - Admin summary: Starts a harvest batch import description: Starts a background harvest import from a server-side file or directory into the specified dataverse. operationId: BatchImport_harvest parameters: - name: createDV in: query description: Create the target dataverse when it does not exist. schema: type: boolean - name: dv in: query description: Target dataverse id or alias; defaults to root when omitted. schema: type: string - name: path in: query description: Server-side file or directory path to import. required: true schema: type: string responses: "200": description: OK security: - DataverseApiKey: [] /batch/import: get: tags: - Admin summary: Starts a dataset batch import description: Starts a background import of one or more datasets from a server-side file or directory into the specified dataverse. operationId: BatchImport_getImport parameters: - name: createDV in: query description: Create the target dataverse when it does not exist. schema: type: boolean - name: dv in: query description: Target dataverse id or alias; defaults to root when omitted. schema: type: string - name: path in: query description: Server-side file or directory path to import. required: true schema: type: string responses: "200": description: OK security: - DataverseApiKey: [] post: tags: - Admin summary: Imports a dataset from DDI XML description: Imports a new dataset into the specified dataverse from DDI XML supplied in the request body. operationId: BatchImport_postImport parameters: - name: dv in: query description: Target dataverse id or alias; defaults to root when omitted. schema: type: string requestBody: description: DDI XML dataset metadata to import as a new dataset. content: '*/*': schema: type: string responses: "200": description: OK security: - DataverseApiKey: [] /batch/jobs/import/datasets/files/{identifier}: post: tags: - Admin summary: Starts a file-system import job description: Starts a background job that imports files from a server-side upload folder into the specified dataset and returns the job execution id. operationId: FileRecordJobResource_getFilesystemImport parameters: - name: identifier in: path description: Dataset id or persistent identifier that receives the imported files. required: true schema: type: string - name: mode in: query description: Import mode requested for the file-system import job. schema: default: MERGE type: string - name: totalSize in: query description: Total size in bytes expected for the imported files. schema: format: int64 type: integer - name: uploadFolder in: query description: Server-side upload folder containing files to import. schema: type: string responses: "200": description: OK security: - DataverseApiKey: [] /builtin-users: post: tags: - Users summary: Creates a builtin user description: "Creates a builtin user, matching authenticated user, and API token\ \ when the builtin-users management key is valid." operationId: BuiltinUsers_save parameters: - name: key in: query description: Builtin-users management key required to create the account. schema: type: string - name: password in: query description: Password assigned to the builtin user. schema: type: string - name: sendEmailNotification in: query description: Send a create-account email notification to the new user. schema: type: boolean requestBody: description: Builtin user account data used to create the builtin and authenticated user records. content: '*/*': schema: $ref: '#/components/schemas/BuiltinUser' responses: "200": description: OK /builtin-users/{password}/{key}: post: tags: - Users summary: Creates a builtin user with path credentials description: "Creates a builtin user, matching authenticated user, and API token\ \ using password and management key path values." operationId: BuiltinUsers_create parameters: - name: key in: path description: Builtin-users management key required to create the account. required: true schema: type: string - name: password in: path description: Password assigned to the builtin user. required: true schema: type: string requestBody: description: Builtin user account data used to create the builtin and authenticated user records. content: '*/*': schema: $ref: '#/components/schemas/BuiltinUser' responses: "200": description: OK /builtin-users/{password}/{key}/{sendEmailNotification}: post: tags: - Users summary: Creates a builtin user with notification control description: "Creates a builtin user, matching authenticated user, and API token\ \ while controlling whether a create-account notification is sent." operationId: BuiltinUsers_createWithNotification parameters: - name: key in: path description: Builtin-users management key required to create the account. required: true schema: type: string - name: password in: path description: Password assigned to the builtin user. required: true schema: type: string - name: sendEmailNotification in: path description: Send a create-account email notification to the new user. required: true schema: type: boolean requestBody: description: Builtin user account data used to create the builtin and authenticated user records. content: '*/*': schema: $ref: '#/components/schemas/BuiltinUser' responses: "200": description: OK /builtin-users/{username}/api-token: get: tags: - Users summary: Returns a builtin user's API token description: Returns the API token for a builtin user when token lookup is enabled and the supplied password is valid. operationId: BuiltinUsers_getApiToken parameters: - name: username in: path description: Builtin username whose API token is requested. required: true schema: type: string - name: password in: query description: Builtin account password used to verify token lookup. schema: type: string responses: "200": description: OK /datasetfields/facetables: get: tags: - Dataset Fields summary: Lists facetable dataset fields description: Lists all facetable dataset fields defined in the installation. operationId: DatasetFields_listAllFacetableDatasetFields responses: "200": description: OK /datasets/datasetTypes: get: tags: - Datasets summary: Present configured dataset types description: Provides all dataset types configured for datasets. operationId: Datasets_listDatasetTypes parameters: - name: Accept-Language in: header description: Language preference for localized dataset type labels. schema: type: string responses: "200": description: OK post: tags: - Datasets summary: Creates a dataset type description: "Creates a dataset type from its name, display name, description,\ \ linked metadata blocks, and available licenses." operationId: Datasets_addDatasetType requestBody: description: "Dataset type definition with name, displayName, optional description,\ \ linkedMetadataBlocks, and availableLicenses." content: '*/*': schema: type: string responses: "200": description: OK security: - DataverseApiKey: [] /datasets/datasetTypes/{idOrName}: get: tags: - Datasets summary: Present a dataset type description: Provides one dataset type by numeric id or name. operationId: Datasets_getDatasetType parameters: - name: idOrName in: path description: Dataset type numeric id or name. required: true schema: type: string - name: Accept-Language in: header description: Language preference for localized dataset type labels. schema: type: string responses: "200": description: OK put: tags: - Datasets summary: Link metadata blocks to a dataset type description: Replaces the metadata blocks linked to a dataset type. operationId: Datasets_updateDatasetTypeLinksWithMetadataBlocks parameters: - name: idOrName in: path description: Dataset type id or name. required: true schema: type: string responses: "200": description: OK security: - DataverseApiKey: [] /datasets/datasetTypes/{idOrName}/licenses: put: tags: - Datasets summary: Configure licenses for a dataset type description: Replaces the licenses available for a dataset type. operationId: Datasets_updateDatasetTypeWithLicenses parameters: - name: idOrName in: path description: Dataset type id or name. required: true schema: type: string responses: "200": description: OK security: - DataverseApiKey: [] /datasets/datasetTypes/{id}: delete: tags: - Datasets summary: Remove a dataset type description: Deletes a non-default dataset type by database id. operationId: Datasets_deleteDatasetType parameters: - name: id in: path description: Dataset type database id. required: true schema: type: string responses: "200": description: OK security: - DataverseApiKey: [] /datasets/export: get: tags: - Datasets summary: Export dataset metadata description: Exports dataset metadata by persistent id using the requested version and exporter. operationId: Datasets_exportDataset parameters: - name: exporter in: query description: Exporter option. schema: type: string - name: persistentId in: query description: Persistent identifier. schema: type: string - name: version in: query description: Dataset version selector. schema: type: string responses: "200": description: OK security: - DataverseApiKey: [] /datasets/listCurationStates: get: tags: - Datasets summary: Lists dataset curation states description: Returns a CSV report of draft dataset curation statuses and users who can publish datasets. operationId: Datasets_getCurationStates parameters: - name: includeHistory in: query description: Whether historical records are included. schema: default: false type: boolean responses: "200": description: OK security: - DataverseApiKey: [] /datasets/locks: get: tags: - Datasets summary: Lists dataset locks description: "Lists dataset locks visible to a superuser, optionally filtered\ \ by lock type and user identifier." operationId: Datasets_listLocks parameters: - name: type in: query description: Resource type filter. schema: type: string - name: userIdentifier in: query description: User identifier filter. schema: type: string responses: "200": description: OK security: - DataverseApiKey: [] /datasets/modifyRegistrationAll: post: tags: - Datasets summary: Refresh registration target URLs for all datasets description: Updates persistent identifier target URLs for every dataset. operationId: Datasets_updateDatasetTargetURLAll responses: "200": description: OK security: - DataverseApiKey: [] /datasets/modifyRegistrationPIDMetadataAll: post: tags: - Datasets summary: Refresh persistent identifier metadata for all datasets description: Updates provider metadata for persistent identifiers associated with all released datasets. operationId: Datasets_updateDatasetPIDMetadataAll responses: "200": description: OK security: - DataverseApiKey: [] /datasets/mpupload: put: tags: - Datasets summary: Completes a multipart upload description: Finalizes an active multipart upload from the supplied part ETags after checking that the requester may update the dataset. operationId: Datasets_completeMPUpload parameters: - name: globalid in: query description: Dataset persistent identifier. schema: type: string - name: storageidentifier in: query description: Storage identifier. schema: type: string - name: uploadid in: query description: Multipart upload id. schema: type: string requestBody: description: JSON object mapping uploaded part numbers to ETag values. content: '*/*': schema: type: string responses: "200": description: OK security: - DataverseApiKey: [] delete: tags: - Datasets summary: Aborts a multipart upload description: Cancels an active multipart upload after checking that the requester may update the dataset. operationId: Datasets_abortMPUpload parameters: - name: globalid in: query description: Dataset persistent identifier. schema: type: string - name: storageidentifier in: query description: Storage identifier. schema: type: string - name: uploadid in: query description: Multipart upload id. schema: type: string responses: "200": description: OK security: - DataverseApiKey: [] /datasets/previewUrlDatasetVersion/{previewUrlToken}: get: tags: - Datasets summary: Returns a preview URL dataset version description: "Returns draft dataset version metadata for a preview URL token,\ \ applying anonymized access rules when configured." operationId: Datasets_getPreviewUrlDatasetVersion parameters: - name: previewUrlToken in: path description: Preview URL token. required: true schema: type: string - name: returnOwners in: query description: Whether owner information is included in the response. schema: type: boolean responses: "200": description: OK /datasets/previewUrlDatasetVersion/{previewUrlToken}/citation: get: tags: - Datasets summary: Returns a preview URL citation description: Returns the internal draft dataset citation available through a preview URL token. operationId: Datasets_getPreviewUrlDatasetVersionCitation parameters: - name: previewUrlToken in: path description: Preview URL token. required: true schema: type: string responses: "200": description: OK /datasets/privateUrlDatasetVersion/{privateUrlToken}: get: tags: - Datasets summary: Returns a private URL dataset version description: "Returns draft dataset version metadata for a private URL token,\ \ applying anonymized access rules when configured." operationId: Datasets_getPrivateUrlDatasetVersion parameters: - name: privateUrlToken in: path description: Private URL token. required: true schema: type: string - name: returnOwners in: query description: Whether owner information is included in the response. schema: type: boolean responses: "200": description: OK /datasets/privateUrlDatasetVersion/{privateUrlToken}/citation: get: tags: - Datasets summary: Returns a private URL citation description: Returns the draft dataset citation available through a private URL token. operationId: Datasets_getPrivateUrlDatasetVersionCitation parameters: - name: privateUrlToken in: path description: Private URL token. required: true schema: type: string responses: "200": description: OK /datasets/summaryFieldNames: get: tags: - Datasets summary: Lists dataset summary fields description: Returns the dataset field names configured for dataset summary display. operationId: Datasets_getDatasetSummaryFieldNames responses: "200": description: OK /datasets/{datasetId}/deleteLink/{linkedDataverseId}: delete: tags: - Datasets summary: Deletes a dataset link description: Removes a link from a dataverse to a dataset and reindexes the dataset. operationId: Datasets_deleteDatasetLinkingDataverse parameters: - name: datasetId in: path description: Dataset id. required: true schema: type: string - name: linkedDataverseId in: path description: Dataverse id containing the dataset link. required: true schema: type: string responses: "200": description: OK security: - DataverseApiKey: [] /datasets/{identifier}/allowedCurationLabels: get: tags: - Datasets summary: Lists allowed curation labels description: Lists the curation labels allowed for a dataset when the requester may publish the dataset. operationId: Datasets_getAllowedCurationLabels parameters: - name: identifier in: path description: Dataset id or persistent identifier. required: true schema: type: string responses: "200": description: OK security: - DataverseApiKey: [] /datasets/{identifier}/assignments: get: tags: - Datasets summary: Lists dataset role assignments description: Lists role assignments directly applied to a dataset. operationId: Datasets_getAssignments parameters: - name: identifier in: path description: Dataset id or persistent identifier. required: true schema: type: string responses: "200": description: OK security: - DataverseApiKey: [] post: tags: - Datasets summary: Creates a dataset role assignment description: Assigns a role to a user or group on a dataset. operationId: Datasets_createAssignment parameters: - name: identifier in: path description: Dataset id or persistent identifier. required: true schema: type: string - name: key in: query description: Legacy API token query value. schema: type: string requestBody: description: Role assignment payload with assignee identifier and role alias. content: '*/*': schema: $ref: '#/components/schemas/RoleAssignmentDTO' responses: "200": description: OK security: - DataverseApiKey: [] /datasets/{identifier}/assignments/history: get: tags: - Datasets summary: Read dataset role assignment history description: Returns dataset role assignment history as JSON or CSV. operationId: Datasets_getRoleAssignmentHistory parameters: - name: identifier in: path description: Dataset id or persistent identifier. required: true schema: type: string responses: "200": description: OK security: - DataverseApiKey: [] /datasets/{identifier}/assignments/{id}: delete: tags: - Datasets summary: Deletes a dataset role assignment description: Revokes a role assignment from a dataset. operationId: Datasets_deleteAssignment parameters: - name: id in: path description: Resource id or persistent identifier. required: true schema: format: int64 type: integer - name: identifier in: path description: Dataset id or persistent identifier. required: true schema: type: string responses: "200": description: OK security: - DataverseApiKey: [] /datasets/{identifier}/curationLabelSet: get: tags: - Datasets summary: Returns the dataset curation label set description: Returns the effective curation label set name for a dataset when the requester is a superuser. operationId: Datasets_getCurationLabelSet parameters: - name: identifier in: path description: Dataset id or persistent identifier. required: true schema: type: string responses: "200": description: OK security: - DataverseApiKey: [] put: tags: - Datasets summary: Sets the dataset curation label set description: Sets the curation label set for a dataset when the requester is a superuser. operationId: Datasets_setCurationLabelSet parameters: - name: identifier in: path description: Dataset id or persistent identifier. required: true schema: type: string - name: name in: query description: Curation label set name. schema: type: string responses: "200": description: OK security: - DataverseApiKey: [] delete: tags: - Datasets summary: Resets the dataset curation label set description: Clears the dataset-specific curation label set so the dataset uses the effective default. operationId: Datasets_resetCurationLabelSet parameters: - name: identifier in: path description: Dataset id or persistent identifier. required: true schema: type: string responses: "200": description: OK security: - DataverseApiKey: [] /datasets/{identifier}/dataCaptureModule/checksumValidation: post: tags: - Datasets summary: Receives checksum validation results description: Processes Data Capture Module checksum validation results and creates a package file when validation succeeds. operationId: Datasets_receiveChecksumValidationResults parameters: - name: identifier in: path description: Dataset id or persistent identifier. required: true schema: type: string requestBody: description: JSON checksum validation result from the Data Capture Module. content: '*/*': schema: type: object responses: "200": description: OK security: - DataverseApiKey: [] /datasets/{identifier}/dataCaptureModule/rsync: get: tags: - Datasets summary: Returns an rsync upload script description: Returns an rsync upload script for a dataset and locks the dataset for Data Capture Module upload. operationId: Datasets_getRsync parameters: - name: identifier in: path description: Dataset id or persistent identifier. required: true schema: type: string responses: "200": description: OK deprecated: true security: - DataverseApiKey: [] /datasets/{identifier}/files/assignments/history: get: tags: - Datasets summary: Read file role assignment history description: Returns file-level role assignment history for a dataset as JSON or CSV. operationId: Datasets_getFilesRoleAssignmentHistory parameters: - name: identifier in: path description: Dataset id or persistent identifier. required: true schema: type: string responses: "200": description: OK security: - DataverseApiKey: [] /datasets/{identifier}/guestbook: put: tags: - Datasets summary: Assign a guestbook to a dataset description: Sets the guestbook used by the selected dataset. operationId: Datasets_updateDatasetGuestbook parameters: - name: identifier in: path description: Dataset id or persistent identifier. required: true schema: type: string responses: "200": description: OK security: - DataverseApiKey: [] delete: tags: - Datasets summary: Clear a dataset guestbook description: Removes the guestbook assignment from the selected dataset. operationId: Datasets_deleteDatasetGuestbook parameters: - name: identifier in: path description: Dataset id or persistent identifier. required: true schema: type: string responses: "200": description: OK security: - DataverseApiKey: [] /datasets/{identifier}/guestbookEntryAtRequest: get: tags: - Datasets summary: Returns the dataset guestbook-entry policy description: Returns whether a dataset requires guestbook entry at request time or falls back to the effective default. operationId: Datasets_getGuestbookEntryOption parameters: - name: identifier in: path description: Dataset id or persistent identifier. required: true schema: type: string responses: "200": description: OK security: - DataverseApiKey: [] put: tags: - Datasets summary: Sets the dataset guestbook-entry policy description: Sets whether a dataset requires guestbook entry at request time when the requester is a superuser. operationId: Datasets_setguestbookEntryAtRequest parameters: - name: identifier in: path description: Dataset id or persistent identifier. required: true schema: type: string requestBody: description: Boolean guestbook-entry-at-request value to store for the dataset. content: '*/*': schema: type: boolean responses: "200": description: OK security: - DataverseApiKey: [] delete: tags: - Datasets summary: Resets the dataset guestbook-entry policy description: Clears the dataset-specific guestbook-entry-at-request value so the dataset uses the effective default. operationId: Datasets_resetGuestbookEntryAtRequest parameters: - name: identifier in: path description: Dataset id or persistent identifier. required: true schema: type: string responses: "200": description: OK security: - DataverseApiKey: [] /datasets/{identifier}/lock/{type}: post: tags: - Datasets summary: Locks a dataset description: Adds a lock of the selected type to a dataset and reindexes the dataset. operationId: Datasets_lockDataset parameters: - name: identifier in: path description: Dataset id or persistent identifier. required: true schema: type: string - name: type in: path description: Resource type filter. required: true schema: $ref: '#/components/schemas/Reason' responses: "200": description: OK security: - DataverseApiKey: [] /datasets/{identifier}/locks: get: tags: - Datasets summary: Lists locks for a dataset description: "Lists current locks on a dataset, optionally filtered by lock\ \ type." operationId: Datasets_getLocksForDataset parameters: - name: identifier in: path description: Dataset id or persistent identifier. required: true schema: type: string - name: type in: query description: Resource type filter. schema: $ref: '#/components/schemas/Reason' responses: "200": description: OK security: - DataverseApiKey: [] delete: tags: - Datasets summary: Deletes dataset locks description: Removes all locks or a selected lock type from a dataset and reindexes the dataset when locks change. operationId: Datasets_deleteLocks parameters: - name: identifier in: path description: Dataset id or persistent identifier. required: true schema: type: string - name: type in: query description: Resource type filter. schema: $ref: '#/components/schemas/Reason' responses: "200": description: OK security: - DataverseApiKey: [] /datasets/{identifier}/pidGenerator: get: tags: - Datasets summary: Returns the dataset PID generator description: Returns the effective PID generator id for a dataset. operationId: Datasets_getPidGenerator parameters: - name: identifier in: path description: Dataset id or persistent identifier. required: true schema: type: string responses: "200": description: OK security: - DataverseApiKey: [] put: tags: - Datasets summary: Sets the dataset PID generator description: Sets a managed PID generator for a dataset when the requester is a superuser. operationId: Datasets_setPidGenerator parameters: - name: identifier in: path description: Dataset id or persistent identifier. required: true schema: type: string requestBody: description: Managed PID generator id to assign to the dataset. content: '*/*': schema: type: string responses: "200": description: OK security: - DataverseApiKey: [] delete: tags: - Datasets summary: Resets the dataset PID generator description: Clears the dataset-specific PID generator so the dataset uses the effective default. operationId: Datasets_resetPidGenerator parameters: - name: identifier in: path description: Dataset id or persistent identifier. required: true schema: type: string responses: "200": description: OK security: - DataverseApiKey: [] /datasets/{identifier}/pidReconcile: put: tags: - Datasets summary: Reconciles a dataset persistent identifier description: Reconciles a dataset persistent identifier with its effective PID provider when the requester is a superuser. operationId: Datasets_reconcilePid parameters: - name: identifier in: path description: Dataset id or persistent identifier. required: true schema: type: string responses: "200": description: OK security: - DataverseApiKey: [] /datasets/{identifier}/reviews: get: tags: - Datasets summary: Returns dataset reviews description: Returns review metadata stored for a dataset. operationId: Datasets_getReviews parameters: - name: identifier in: path description: Dataset id or persistent identifier. required: true schema: type: string responses: "200": description: OK security: - DataverseApiKey: [] /datasets/{identifier}/storage/quota: get: tags: - Datasets summary: Read dataset storage quota description: "Returns the storage quota for a dataset, optionally including\ \ inherited quota values." operationId: Datasets_getDatasetQuota parameters: - name: identifier in: path description: Dataset id or persistent identifier. required: true schema: type: string - name: showInherited in: query description: Whether to include inherited quota settings in the response. schema: type: boolean responses: "200": description: OK security: - DataverseApiKey: [] put: tags: - Datasets summary: Assign dataset storage quota description: Sets the dataset storage quota in bytes. operationId: Datasets_setDatasetQuota parameters: - name: identifier in: path description: Dataset id or persistent identifier. required: true schema: type: string responses: "200": description: OK security: - DataverseApiKey: [] delete: tags: - Datasets summary: Clear dataset storage quota description: Deletes the explicit storage quota for a dataset. operationId: Datasets_deleteDatasetQuota parameters: - name: identifier in: path description: Dataset id or persistent identifier. required: true schema: type: string responses: "200": description: OK security: - DataverseApiKey: [] /datasets/{identifier}/storage/use: get: tags: - Datasets summary: Read dataset storage use description: Returns the recorded storage use for a dataset. operationId: Datasets_getDatasetStorageUse parameters: - name: identifier in: path description: Dataset id or persistent identifier. required: true schema: type: string responses: "200": description: OK security: - DataverseApiKey: [] /datasets/{identifier}/storageDriver: get: tags: - Datasets summary: Returns the dataset storage driver description: Returns the effective storage driver configured for a dataset. operationId: Datasets_getFileStore parameters: - name: identifier in: path description: Dataset id or persistent identifier. required: true schema: type: string responses: "200": description: OK security: - DataverseApiKey: [] put: tags: - Datasets summary: Sets the dataset storage driver description: Sets a dataset-specific storage driver by label when the requester is a superuser. operationId: Datasets_setFileStore parameters: - name: identifier in: path description: Dataset id or persistent identifier. required: true schema: type: string requestBody: description: Storage driver label to assign to the dataset. content: '*/*': schema: type: string responses: "200": description: OK security: - DataverseApiKey: [] delete: tags: - Datasets summary: Resets the dataset storage driver description: Removes a dataset-specific storage driver so the dataset uses the default storage configuration. operationId: Datasets_resetFileStore parameters: - name: identifier in: path description: Dataset id or persistent identifier. required: true schema: type: string responses: "200": description: OK security: - DataverseApiKey: [] /datasets/{identifier}/storagesize: get: tags: - Datasets summary: Returns dataset storage size description: "Returns the storage size for files in a dataset, optionally including\ \ cached values." operationId: Datasets_getStorageSize parameters: - name: identifier in: path description: Dataset id or persistent identifier. required: true schema: type: string - name: includeCached in: query description: Whether cached values may be included. schema: type: boolean responses: "200": description: OK security: - DataverseApiKey: [] /datasets/{identifier}/timestamps: get: tags: - Datasets summary: Returns dataset timestamps description: "Returns creation, publication, export, index, and update timestamps\ \ visible to the requester for a dataset." operationId: Datasets_getTimestamps parameters: - name: identifier in: path description: Dataset id or persistent identifier. required: true schema: type: string responses: "200": description: OK security: - DataverseApiKey: [] /datasets/{identifier}/uploadlimits: get: tags: - Datasets summary: Read dataset upload limits description: Returns upload size limits that apply to the selected dataset. operationId: Datasets_getUploadLimits parameters: - name: identifier in: path description: Dataset id or persistent identifier. required: true schema: type: string responses: "200": description: OK security: - DataverseApiKey: [] /datasets/{identifier}/versions/{versionId}/downloadsize: get: tags: - Datasets summary: Returns dataset version download size description: Returns the calculated download size for files in a dataset version with optional file filters and calculation mode. operationId: Datasets_getDownloadSize parameters: - name: identifier in: path description: Dataset id or persistent identifier. required: true schema: type: string - name: versionId in: path description: Dataset version selector. required: true schema: type: string - name: accessStatus in: query description: File access status filter. schema: type: string - name: categoryName in: query description: File category name filter. schema: type: string - name: contentType in: query description: File content type filter. schema: type: string - name: includeDeaccessioned in: query description: Whether deaccessioned dataset versions are included. schema: type: boolean - name: mode in: query description: Download size calculation mode. schema: type: string - name: searchText in: query description: File search text filter. schema: type: string - name: tabularTagName in: query description: Tabular data tag filter. schema: type: string responses: "200": description: OK security: - DataverseApiKey: [] /datasets/{id}: get: tags: - Datasets summary: Read dataset details description: "Returns dataset metadata and the latest accessible version, and\ \ records metrics for released dataset access." operationId: Datasets_getDataset parameters: - name: id in: path description: Dataset id or persistent identifier. required: true schema: type: string - name: returnOwners in: query description: Whether to include owner information in the response. schema: type: boolean responses: "200": description: OK security: - DataverseApiKey: [] delete: tags: - Datasets summary: Deletes a dataset description: Deletes the latest draft version or destroys an unpublished single-version dataset after checking delete permissions. operationId: Datasets_deleteDataset parameters: - name: id in: path description: Resource id or persistent identifier. required: true schema: type: string responses: "200": description: OK security: - DataverseApiKey: [] /datasets/{id}/access: put: tags: - Datasets summary: Edit dataset terms of access description: Updates terms of use and access settings on the dataset draft. operationId: Datasets_editVersionTermsOfAccess parameters: - name: id in: path description: Dataset id or persistent identifier. required: true schema: type: string - name: sourceLastUpdateTime in: query description: Source last-update timestamp used by external integrations. schema: type: string requestBody: description: JSON terms-of-access payload for the dataset draft. content: '*/*': schema: type: string responses: "200": description: OK security: - DataverseApiKey: [] /datasets/{id}/actions/:publish: get: tags: - Datasets summary: Publish a dataset through the deprecated GET route description: Publishes a dataset version using the legacy GET endpoint retained for compatibility. operationId: Datasets_publishDataseUsingGetDeprecated parameters: - name: id in: path description: Dataset id or persistent identifier. required: true schema: type: string - name: type in: query description: "Publication type: major, minor, or updatecurrent." required: true schema: type: string responses: "200": description: OK deprecated: true security: - DataverseApiKey: [] post: tags: - Datasets summary: Publishes a dataset description: "Publishes a dataset version as a major, minor, or current-version\ \ update and optionally waits for indexing." operationId: Datasets_publishDataset parameters: - name: id in: path description: Dataset id or persistent identifier. required: true schema: type: string - name: assureIsIndexed in: query description: "When true, require the dataset to be indexed before publication\ \ completes." schema: type: boolean - name: type in: query description: "Publication type: major, minor, or updatecurrent." required: true schema: type: string responses: "200": description: OK security: - DataverseApiKey: [] /datasets/{id}/actions/:releasemigrated: post: tags: - Datasets summary: Publishes a migrated dataset description: Publishes a migrated dataset using supplied JSON-LD publication metadata when the requester is a superuser. operationId: Datasets_publishMigratedDataset parameters: - name: id in: path description: Resource id or persistent identifier. required: true schema: type: string - name: updatepidatprovider in: query description: Whether PID provider metadata should be updated. schema: default: false type: boolean requestBody: description: JSON-LD metadata containing the migrated dataset publication date. content: application/ld+json: schema: type: string application/json-ld: schema: type: string responses: "200": description: OK security: - DataverseApiKey: [] /datasets/{id}/add: post: tags: - addFileToDataset summary: Uploads a file for a dataset description: Uploads a file for a dataset operationId: Datasets_addFileToDataset parameters: - name: id in: path description: Resource id or persistent identifier. required: true schema: type: string requestBody: description: Multipart request containing one uploaded file and JSON metadata for the dataset. content: multipart/form-data: schema: type: string responses: "200": description: File uploaded successfully to dataset security: - DataverseApiKey: [] /datasets/{id}/addFiles: post: tags: - addFilesToDataset summary: Uploads a set of files to a dataset description: Uploads a set of files to a dataset operationId: Datasets_addFilesToDataset parameters: - name: id in: path description: Resource id or persistent identifier. required: true schema: type: string requestBody: description: Multipart request containing file content and JSON metadata for files to add. content: multipart/form-data: schema: type: string responses: "200": description: Files uploaded successfully to dataset security: - DataverseApiKey: [] /datasets/{id}/addGlobusFiles: post: tags: - addGlobusFilesToDataset summary: Uploads a Globus file for a dataset description: Uploads a Globus file for a dataset operationId: Datasets_addGlobusFilesToDataset parameters: - name: id in: path description: Resource id or persistent identifier. required: true schema: type: string requestBody: description: Multipart request containing Globus file metadata and transfer task information. content: multipart/form-data: schema: type: string responses: "200": description: Globus file uploaded successfully to dataset security: - DataverseApiKey: [] /datasets/{id}/availableFileCategories: get: tags: - Datasets summary: Lists available file categories description: Lists file category names already used by files in a dataset. operationId: Datasets_getAvailableFileCategories parameters: - name: id in: path description: Resource id or persistent identifier. required: true schema: type: string responses: "200": description: OK security: - DataverseApiKey: [] /datasets/{id}/citationdate: put: tags: - Datasets summary: Sets the dataset citation date field description: Sets the dataset field type used as the dataset citation date. operationId: Datasets_setCitationDate parameters: - name: id in: path description: Resource id or persistent identifier. required: true schema: type: string requestBody: description: "Dataset field type name to use as the citation date, or :publicationDate\ \ for the default publication date." content: '*/*': schema: type: string responses: "200": description: OK security: - DataverseApiKey: [] delete: tags: - Datasets summary: Restores the default citation date description: Restores the dataset citation date to use the default publication date. operationId: Datasets_useDefaultCitationDate parameters: - name: id in: path description: Resource id or persistent identifier. required: true schema: type: string responses: "200": description: OK security: - DataverseApiKey: [] /datasets/{id}/cleanStorage: get: tags: - Datasets summary: Cleans dataset storage description: Finds and optionally deletes storage objects that are no longer referenced by files in a dataset. operationId: Datasets_cleanStorage parameters: - name: id in: path description: Resource id or persistent identifier. required: true schema: type: string - name: dryrun in: query description: Whether to validate the request without applying changes. schema: type: boolean responses: "200": description: OK security: - DataverseApiKey: [] /datasets/{id}/curationStatus: get: tags: - Datasets summary: Returns dataset curation status description: Returns the current or historical curation status for a dataset when the requester may view it. operationId: Datasets_getCurationStatus parameters: - name: id in: path description: Resource id or persistent identifier. required: true schema: type: string - name: includeHistory in: query description: Whether historical records are included. schema: type: boolean responses: "200": description: OK security: - DataverseApiKey: [] put: tags: - Datasets summary: Sets dataset curation status description: Sets the curation status label for a dataset when the requester may publish the dataset. operationId: Datasets_setCurationStatus parameters: - name: id in: path description: Resource id or persistent identifier. required: true schema: type: string - name: label in: query description: Curation status label. schema: type: string responses: "200": description: OK security: - DataverseApiKey: [] delete: tags: - Datasets summary: Deletes dataset curation status description: Deletes the current curation status from a dataset when the requester may publish the dataset. operationId: Datasets_deleteCurationStatus parameters: - name: id in: path description: Resource id or persistent identifier. required: true schema: type: string responses: "200": description: OK security: - DataverseApiKey: [] /datasets/{id}/deleteFiles: put: tags: - Datasets summary: Remove files from a dataset draft description: Deletes selected files from the dataset draft and removes physical files that have never been released. operationId: Datasets_deleteDatasetFiles parameters: - name: id in: path description: Dataset id or persistent identifier. required: true schema: type: string requestBody: description: JSON array of data file ids to delete from the dataset draft. content: application/json: schema: type: array responses: "200": description: OK security: - DataverseApiKey: [] /datasets/{id}/deleteMetadata: put: tags: - Datasets summary: Remove metadata fields from a dataset draft description: Deletes metadata fields or field values from the dataset draft using the supplied JSON payload. operationId: Datasets_deleteVersionMetadata parameters: - name: id in: path description: Dataset id or persistent identifier. required: true schema: type: string requestBody: description: JSON metadata fields or values to remove from the dataset draft. content: '*/*': schema: type: string responses: "200": description: OK security: - DataverseApiKey: [] /datasets/{id}/destroy: delete: tags: - Datasets summary: Destroys a dataset description: Permanently destroys a dataset and finalizes physical file deletion when the requester is authorized. operationId: Datasets_destroyDataset parameters: - name: id in: path description: Resource id or persistent identifier. required: true schema: type: string responses: "200": description: OK security: - DataverseApiKey: [] /datasets/{id}/dirindex: get: tags: - Datasets summary: Returns a dataset folder listing description: "Returns an HTML folder listing for files in a dataset version,\ \ optionally scoped to a folder and original filenames." operationId: Datasets_getFileAccessFolderView parameters: - name: id in: path description: Resource id or persistent identifier. required: true schema: type: string - name: folder in: query description: Folder path filter. schema: type: string - name: original in: query description: Whether original file names are returned. schema: type: boolean - name: version in: query description: Dataset version selector. schema: type: string responses: "200": description: OK security: - DataverseApiKey: [] /datasets/{id}/download/count: get: tags: - Datasets summary: Returns dataset download count description: "Returns the download count for a dataset, with optional inclusion\ \ of Make Data Count values." operationId: Datasets_getDownloadCountByDatasetId parameters: - name: id in: path description: Resource id or persistent identifier. required: true schema: type: string - name: includeMDC in: query description: Whether Make Data Count values are included. schema: type: boolean responses: "200": description: OK security: - DataverseApiKey: [] /datasets/{id}/editMetadata: put: tags: - Datasets summary: Edit dataset draft metadata description: "Adds, merges, or replaces dataset metadata fields on the draft\ \ version." operationId: Datasets_editVersionMetadata parameters: - name: id in: path description: Dataset id or persistent identifier. required: true schema: type: string - name: replace in: query description: "When true, replace matching field values instead of merging." schema: type: boolean - name: sourceLastUpdateTime in: query description: Source last-update timestamp used by external integrations. schema: type: string requestBody: description: "JSON metadata fields to add, merge, or replace." content: '*/*': schema: type: string responses: "200": description: OK security: - DataverseApiKey: [] /datasets/{id}/externalTool/{tid}/toolUrl: post: tags: - Datasets summary: Creates a dataset external tool URL description: Returns launch URL details for a dataset-scoped external tool after checking tool configuration and dataset permissions. operationId: Datasets_getDatasetExternalToolUrl parameters: - name: id in: path description: Resource id or persistent identifier. required: true schema: type: string - name: tid in: path description: External tool id. required: true schema: format: int64 type: integer requestBody: description: External tool launch options such as preview mode and locale. content: application/json: schema: type: string responses: "200": description: OK security: - DataverseApiKey: [] /datasets/{id}/files/actions/:set-embargo: post: tags: - Datasets summary: Embargoes dataset files description: Applies embargo settings to the specified dataset files after checking dataset edit permissions. operationId: Datasets_createFileEmbargo parameters: - name: id in: path description: Resource id or persistent identifier. required: true schema: type: string requestBody: description: JSON payload identifying dataset files and embargo settings to apply. content: application/json: schema: type: string responses: "200": description: OK security: - DataverseApiKey: [] /datasets/{id}/files/actions/:set-retention: post: tags: - Datasets summary: Sets retention on dataset files description: Sets retention information on selected files in a dataset. operationId: Datasets_createFileRetention parameters: - name: id in: path description: Resource id or persistent identifier. required: true schema: type: string requestBody: description: JSON retention payload identifying files and retention settings. content: '*/*': schema: type: string responses: "200": description: OK security: - DataverseApiKey: [] /datasets/{id}/files/actions/:unset-embargo: post: tags: - Datasets summary: Removes file embargoes description: Removes embargoes from the specified dataset files after checking dataset edit permissions. operationId: Datasets_removeFileEmbargo parameters: - name: id in: path description: Resource id or persistent identifier. required: true schema: type: string requestBody: description: JSON payload identifying the dataset files whose embargoes should be removed. content: application/json: schema: type: string responses: "200": description: OK security: - DataverseApiKey: [] /datasets/{id}/files/actions/:unset-retention: post: tags: - Datasets summary: Removes file retention periods description: Removes retention periods from the specified dataset files after checking dataset edit permissions. operationId: Datasets_removeFileRetention parameters: - name: id in: path description: Resource id or persistent identifier. required: true schema: type: string requestBody: description: JSON payload identifying the dataset files whose retention periods should be removed. content: '*/*': schema: type: string responses: "200": description: OK security: - DataverseApiKey: [] /datasets/{id}/files/metadata: post: tags: - Datasets summary: Updates metadata for multiple files description: Updates file metadata entries in a dataset after checking dataset edit permissions. operationId: Datasets_updateMultipleFileMetadata parameters: - name: id in: path description: Resource id or persistent identifier. required: true schema: type: string requestBody: description: JSON metadata updates for one or more files in the dataset. content: application/json: schema: type: string responses: "200": description: OK security: - DataverseApiKey: [] /datasets/{id}/files/uploadlimit: delete: tags: - Datasets summary: Clears dataset file upload limit description: Removes the file count upload limit from a dataset when the requester is a superuser. operationId: Datasets_deleteDatasetFilesLimits parameters: - name: id in: path description: Resource id or persistent identifier. required: true schema: type: string responses: "200": description: OK security: - DataverseApiKey: [] /datasets/{id}/files/uploadlimit/{limit}: post: tags: - Datasets summary: Sets dataset file upload limit description: Sets the file count upload limit for a dataset when the requester is a superuser. operationId: Datasets_updateDatasetFilesLimits parameters: - name: id in: path description: Resource id or persistent identifier. required: true schema: type: string - name: limit in: path description: Maximum number of results or configured limit value. required: true schema: format: int32 type: integer responses: "200": description: OK security: - DataverseApiKey: [] /datasets/{id}/globusDownloadParameters: get: tags: - Datasets summary: Returns Globus download parameters description: Returns signed parameters and allowed callback URLs for a Globus download workflow for a dataset. operationId: Datasets_getGlobusDownloadParams parameters: - name: id in: path description: Resource id or persistent identifier. required: true schema: type: string - name: downloadId in: query description: Globus download request id. schema: type: string - name: locale in: query description: Locale for localized Globus metadata. schema: type: string responses: "200": description: OK security: - DataverseApiKey: [] /datasets/{id}/globusUploadParameters: get: tags: - Datasets summary: Returns Globus upload parameters description: Returns signed parameters and allowed callback URLs for a Globus upload or reference workflow for a dataset. operationId: Datasets_getGlobusUploadParams parameters: - name: id in: path description: Resource id or persistent identifier. required: true schema: type: string - name: locale in: query description: Locale for localized Globus metadata. schema: type: string responses: "200": description: OK security: - DataverseApiKey: [] /datasets/{id}/license: put: tags: - Datasets summary: Change a dataset license description: "Updates the dataset license by name or URI, or applies custom\ \ terms." operationId: Datasets_updateLicense parameters: - name: id in: path description: Dataset id or persistent identifier. required: true schema: type: string requestBody: description: "License update request containing a license name, URI, or custom\ \ terms." content: '*/*': schema: $ref: '#/components/schemas/LicenseUpdateRequest' responses: "200": description: OK security: - DataverseApiKey: [] /datasets/{id}/links: get: tags: - Datasets summary: Lists dataset links description: Lists dataverses that link to the dataset and are visible to the requester. operationId: Datasets_getLinks parameters: - name: id in: path description: Resource id or persistent identifier. required: true schema: type: string responses: "200": description: OK security: - DataverseApiKey: [] /datasets/{id}/logo: get: tags: - Datasets summary: Returns a dataset logo description: Returns the dataset logo image when one is available. operationId: Datasets_getDatasetLogo parameters: - name: id in: path description: Resource id or persistent identifier. required: true schema: type: string responses: "200": description: OK security: - DataverseApiKey: [] /datasets/{id}/makeDataCount/citations: get: tags: - Datasets summary: Lists dataset external citations description: Lists external citation URLs recorded for a dataset. operationId: Datasets_getMakeDataCountCitations parameters: - name: id in: path description: Resource id or persistent identifier. required: true schema: type: string responses: "200": description: OK security: - DataverseApiKey: [] /datasets/{id}/makeDataCount/{metric}: get: tags: - Datasets summary: Returns a current Make Data Count metric description: "Returns one Make Data Count metric for a dataset for the current\ \ reporting period, optionally filtered by country." operationId: Datasets_getMakeDataCountMetricCurrentMonth parameters: - name: id in: path description: Resource id or persistent identifier. required: true schema: type: string - name: metric in: path description: Make Data Count metric name. required: true schema: type: string - name: country in: query description: Country filter for metric results. schema: type: string responses: "200": description: OK security: - DataverseApiKey: [] /datasets/{id}/makeDataCount/{metric}/{yyyymm}: get: tags: - Datasets summary: Returns a monthly Make Data Count metric description: "Returns one Make Data Count metric for a dataset in a selected\ \ month, optionally filtered by country." operationId: Datasets_getMakeDataCountMetric parameters: - name: id in: path description: Resource id or persistent identifier. required: true schema: type: string - name: metric in: path description: Make Data Count metric name. required: true schema: type: string - name: yyyymm in: path description: Metric month in YYYYMM format. required: true schema: type: string - name: country in: query description: Country filter for metric results. schema: type: string responses: "200": description: OK security: - DataverseApiKey: [] /datasets/{id}/metadata: get: tags: - Datasets summary: Read latest JSON-LD metadata description: Exports JSON-LD metadata for the latest accessible dataset version. operationId: Datasets_getJsonLDMetadata parameters: - name: id in: path description: Dataset id or persistent identifier. required: true schema: type: string responses: "200": description: OK security: - DataverseApiKey: [] put: tags: - Datasets summary: Apply JSON-LD metadata to a dataset description: Updates or creates a draft dataset version from JSON-LD metadata. operationId: Datasets_updateVersionMetadata parameters: - name: id in: path description: Dataset id or persistent identifier. required: true schema: type: string - name: replace in: query description: "When true, replace existing terms instead of merging supplied\ \ values." schema: default: false type: boolean requestBody: description: JSON-LD metadata to apply to the dataset draft. content: application/ld+json: schema: type: string application/json-ld: schema: type: string responses: "200": description: OK security: - DataverseApiKey: [] /datasets/{id}/metadata/delete: put: tags: - Datasets summary: Remove JSON-LD metadata from a dataset description: Deletes dataset metadata values described by the supplied JSON-LD payload. operationId: Datasets_deleteMetadata parameters: - name: id in: path description: Dataset id or persistent identifier. required: true schema: type: string requestBody: description: JSON-LD metadata values to remove from the dataset draft. content: application/ld+json: schema: type: string application/json-ld: schema: type: string responses: "200": description: OK security: - DataverseApiKey: [] /datasets/{id}/modifyRegistration: post: tags: - Datasets summary: Refresh a dataset registration target URL description: Updates the target URL stored with the persistent identifier provider for one dataset. operationId: Datasets_updateDatasetTargetURL parameters: - name: id in: path description: Dataset id or persistent identifier. required: true schema: type: string responses: "200": description: OK security: - DataverseApiKey: [] /datasets/{id}/modifyRegistrationMetadata: post: tags: - Datasets summary: Refresh persistent identifier metadata for a dataset description: Updates provider metadata for the persistent identifier associated with one released dataset. operationId: Datasets_updateDatasetPIDMetadata parameters: - name: id in: path description: Dataset id or persistent identifier. required: true schema: type: string responses: "200": description: OK security: - DataverseApiKey: [] /datasets/{id}/monitorGlobusDownload: post: tags: - Datasets summary: Monitors a Globus download description: Starts monitoring a Globus transfer task and removes temporary permissions when the transfer completes. operationId: Datasets_monitorGlobusDownload parameters: - name: id in: path description: Resource id or persistent identifier. required: true schema: type: string requestBody: description: Globus transfer monitor request containing the task identifier. content: application/json: schema: type: string responses: "200": description: OK security: - DataverseApiKey: [] /datasets/{id}/move/{targetDataverseAlias}: post: tags: - Datasets summary: Moves a dataset description: Moves a dataset to another dataverse and reports warnings unless the move is forced. operationId: Datasets_moveDataset parameters: - name: id in: path description: Resource id or persistent identifier. required: true schema: type: string - name: targetDataverseAlias in: path description: Alias of the destination dataverse. required: true schema: type: string - name: forceMove in: query description: Whether to force moving the dataset when warnings exist. schema: type: boolean responses: "200": description: OK security: - DataverseApiKey: [] /datasets/{id}/previewUrl: get: tags: - Datasets summary: Returns preview URL data description: Returns preview URL data for a dataset. operationId: Datasets_getPreviewUrlData parameters: - name: id in: path description: Resource id or persistent identifier. required: true schema: type: string responses: "200": description: OK security: - DataverseApiKey: [] post: tags: - Datasets summary: Creates a preview URL description: "Creates a preview URL for a dataset draft, optionally with anonymized\ \ access when configured." operationId: Datasets_createPreviewUrl parameters: - name: id in: path description: Resource id or persistent identifier. required: true schema: type: string - name: anonymizedAccess in: query description: Whether the generated URL hides requester identity details. schema: default: false type: boolean responses: "200": description: OK security: - DataverseApiKey: [] delete: tags: - Datasets summary: Deletes a preview URL description: Deletes the preview URL for a dataset when one exists. operationId: Datasets_deletePreviewUrl parameters: - name: id in: path description: Resource id or persistent identifier. required: true schema: type: string responses: "200": description: OK security: - DataverseApiKey: [] /datasets/{id}/privateUrl: get: tags: - Datasets summary: Returns private URL data description: Returns private URL data for a dataset through the deprecated private URL route. operationId: Datasets_getPrivateUrlData parameters: - name: id in: path description: Resource id or persistent identifier. required: true schema: type: string responses: "200": description: OK deprecated: true security: - DataverseApiKey: [] post: tags: - Datasets summary: Creates a private URL description: Creates a private URL for a dataset through the deprecated private URL route. operationId: Datasets_createPrivateUrl parameters: - name: id in: path description: Resource id or persistent identifier. required: true schema: type: string - name: anonymizedAccess in: query description: Whether the generated URL hides requester identity details. schema: default: false type: boolean responses: "200": description: OK deprecated: true security: - DataverseApiKey: [] delete: tags: - Datasets summary: Deletes a private URL description: Deletes the private URL for a dataset through the deprecated private URL route. operationId: Datasets_deletePrivateUrl parameters: - name: id in: path description: Resource id or persistent identifier. required: true schema: type: string responses: "200": description: OK deprecated: true security: - DataverseApiKey: [] /datasets/{id}/replaceFiles: post: tags: - replaceFilesInDataset summary: Replace a set of files to a dataset description: Replace a set of files to a dataset operationId: Datasets_replaceFilesInDataset parameters: - name: id in: path description: Resource id or persistent identifier. required: true schema: type: string requestBody: description: Multipart request containing replacement file content and JSON metadata. content: multipart/form-data: schema: type: string responses: "200": description: Files replaced successfully to dataset security: - DataverseApiKey: [] /datasets/{id}/requestGlobusDownload: post: tags: - Datasets summary: Requests a Globus download description: Creates temporary Globus download permissions and returns endpoint path information for dataset files. operationId: Datasets_requestGlobusDownload parameters: - name: id in: path description: Resource id or persistent identifier. required: true schema: type: string - name: downloadId in: query description: Globus download request id. schema: type: string requestBody: description: Globus download request with transfer principal and optional file id list. content: application/json: schema: type: string responses: "200": description: OK security: - DataverseApiKey: [] /datasets/{id}/requestGlobusUploadPaths: post: tags: - Datasets summary: Requests Globus upload paths description: Creates upload path assignments and permissions for a Globus user to upload files to a dataset. operationId: Datasets_requestGlobusUpload parameters: - name: id in: path description: Resource id or persistent identifier. required: true schema: type: string requestBody: description: Globus upload request with the transfer principal and number of files. content: application/json: schema: type: string responses: "200": description: OK security: - DataverseApiKey: [] /datasets/{id}/returnToAuthor: post: tags: - Datasets summary: Returns a dataset to authors description: Returns a dataset under review to its authors with a supplied reason. operationId: Datasets_returnToAuthor parameters: - name: id in: path description: Resource id or persistent identifier. required: true schema: type: string requestBody: description: JSON payload containing the reason for returning the dataset to authors. content: '*/*': schema: type: string responses: "200": description: OK security: - DataverseApiKey: [] /datasets/{id}/submitForReview: post: tags: - Datasets summary: Submits a dataset for review description: Submits a dataset for review and returns the resulting review state. operationId: Datasets_submitForReview parameters: - name: id in: path description: Resource id or persistent identifier. required: true schema: type: string responses: "200": description: OK security: - DataverseApiKey: [] /datasets/{id}/thumbnail: get: tags: - Datasets summary: Returns a dataset thumbnail description: Returns the dataset thumbnail image when one is available. operationId: Datasets_getDatasetThumbnail parameters: - name: id in: path description: Resource id or persistent identifier. required: true schema: type: string responses: "200": description: OK security: - DataverseApiKey: [] post: tags: - uploadDatasetLogo summary: Uploads a logo for a dataset description: Uploads a logo for a dataset operationId: Datasets_uploadDatasetLogo parameters: - name: id in: path description: Resource id or persistent identifier. required: true schema: type: string requestBody: description: Multipart dataset logo upload containing the image file. content: multipart/form-data: schema: format: binary type: string responses: "200": description: Dataset logo uploaded successfully security: - DataverseApiKey: [] delete: tags: - Datasets summary: Removes a dataset thumbnail description: Removes the custom thumbnail or logo assigned to a dataset. operationId: Datasets_removeDatasetLogo parameters: - name: id in: path description: Resource id or persistent identifier. required: true schema: type: string responses: "200": description: OK security: - DataverseApiKey: [] /datasets/{id}/thumbnail/candidates: get: tags: - Datasets summary: Lists dataset thumbnail candidates description: Lists images that can be selected as the dataset thumbnail when the requester may update the thumbnail. operationId: Datasets_getDatasetThumbnailCandidates parameters: - name: id in: path description: Resource id or persistent identifier. required: true schema: type: string responses: "200": description: OK security: - DataverseApiKey: [] /datasets/{id}/thumbnail/{dataFileId}: post: tags: - Datasets summary: Sets a dataset thumbnail from a file description: Uses an existing data file image as the dataset thumbnail. operationId: Datasets_setDataFileAsThumbnail parameters: - name: dataFileId in: path description: Data file id. required: true schema: format: int64 type: integer - name: id in: path description: Resource id or persistent identifier. required: true schema: type: string responses: "200": description: OK security: - DataverseApiKey: [] /datasets/{id}/uploadurls: get: tags: - Datasets summary: Returns multipart upload URLs description: "Returns temporary direct-upload URLs for adding a file to a dataset\ \ after checking upload permissions, limits, and quotas." operationId: Datasets_getMPUploadUrls parameters: - name: id in: path description: Resource id or persistent identifier. required: true schema: type: string - name: size in: query description: Requested file size in bytes. schema: format: int64 type: integer responses: "200": description: OK security: - DataverseApiKey: [] /datasets/{id}/userPermissions: get: tags: - Datasets summary: Returns user permissions on a dataset description: Returns selected dataset permissions for the requesting user. operationId: Datasets_getUserPermissionsOnDataset parameters: - name: id in: path description: Resource id or persistent identifier. required: true schema: type: string responses: "200": description: OK security: - DataverseApiKey: [] /datasets/{id}/versions: get: tags: - Datasets summary: Lists dataset versions description: "Lists versions for a dataset with optional file, metadata block,\ \ limit, and offset controls." operationId: Datasets_listVersions parameters: - name: id in: path description: Resource id or persistent identifier. required: true schema: type: string - name: excludeFiles in: query description: Whether files are excluded from the returned dataset version metadata. schema: type: boolean - name: excludeMetadataBlocks in: query description: Whether metadata blocks are excluded from the returned dataset version metadata. schema: type: boolean - name: limit in: query description: Maximum number of results to return. schema: format: int32 type: integer - name: offset in: query description: Result offset. schema: format: int32 type: integer responses: "200": description: OK security: - DataverseApiKey: [] /datasets/{id}/versions/compareSummary: get: tags: - Datasets summary: Lists dataset version comparison summaries description: Lists comparison summaries for dataset versions with optional limit and offset controls. operationId: Datasets_getCompareVersionsSummary parameters: - name: id in: path description: Resource id or persistent identifier. required: true schema: type: string - name: limit in: query description: Maximum number of results or configured limit value. schema: format: int32 type: integer - name: offset in: query description: Result offset. schema: format: int32 type: integer responses: "200": description: OK security: - DataverseApiKey: [] /datasets/{id}/versions/{versionId1}/compare/{versionId2}: get: tags: - Datasets summary: Compares dataset versions description: Compares two dataset versions and returns the metadata and file differences between them. operationId: Datasets_getCompareVersions parameters: - name: id in: path description: Resource id or persistent identifier. required: true schema: type: string - name: versionId1 in: path description: First dataset version selector to compare. required: true schema: type: string - name: versionId2 in: path description: Second dataset version selector to compare. required: true schema: type: string - name: includeDeaccessioned in: query description: Whether deaccessioned dataset versions are included. schema: type: boolean responses: "200": description: OK security: - DataverseApiKey: [] /datasets/{id}/versions/{versionId}: get: tags: - Datasets summary: Returns a dataset version description: "Returns metadata for a selected dataset version with optional\ \ file, metadata block, owner, and deaccession controls." operationId: Datasets_getVersion parameters: - name: id in: path description: Resource id or persistent identifier. required: true schema: type: string - name: versionId in: path description: Dataset version selector. required: true schema: type: string - name: excludeFiles in: query description: Whether files are excluded from the returned dataset version metadata. schema: type: boolean - name: excludeMetadataBlocks in: query description: Whether metadata blocks are excluded from the returned dataset version metadata. schema: type: boolean - name: ignoreSettingExcludeEmailFromExport in: query description: Whether the configured email-exclusion setting is ignored for the export. schema: type: boolean - name: includeDeaccessioned in: query description: Whether deaccessioned dataset versions are included. schema: type: boolean - name: returnOwners in: query description: Whether owner information is included in the response. schema: type: boolean responses: "200": description: OK security: - DataverseApiKey: [] put: tags: - Datasets summary: Replace draft version metadata description: Updates the draft dataset version from the supplied JSON dataset-version payload. operationId: Datasets_updateDraftVersion parameters: - name: id in: path description: Dataset id or persistent identifier. required: true schema: type: string - name: versionId in: path description: Dataset version id; only :draft is accepted. required: true schema: type: string requestBody: description: Dataset version JSON used to replace draft metadata. content: application/json: schema: type: string responses: "200": description: OK security: - DataverseApiKey: [] delete: tags: - Datasets summary: Deletes a draft dataset version description: Deletes the draft version of a dataset and finalizes physical file deletion for removed files. operationId: Datasets_deleteDraftVersion parameters: - name: id in: path description: Resource id or persistent identifier. required: true schema: type: string - name: versionId in: path description: Dataset version selector. required: true schema: type: string responses: "200": description: OK security: - DataverseApiKey: [] /datasets/{id}/versions/{versionId}/canDownloadAtLeastOneFile: get: tags: - Datasets summary: Checks whether any file can be downloaded description: Returns whether the requester can download at least one file from a selected dataset version. operationId: Datasets_getCanDownloadAtLeastOneFile parameters: - name: id in: path description: Resource id or persistent identifier. required: true schema: type: string - name: versionId in: path description: Dataset version selector. required: true schema: type: string - name: includeDeaccessioned in: query description: Whether deaccessioned dataset versions are included. schema: type: boolean responses: "200": description: OK security: - DataverseApiKey: [] /datasets/{id}/versions/{versionId}/citation: get: tags: - Datasets summary: Returns an internal dataset version citation description: Returns the internal citation text for a selected dataset version. operationId: Datasets_getDatasetVersionInternalCitation parameters: - name: id in: path description: Resource id or persistent identifier. required: true schema: type: string - name: versionId in: path description: Dataset version selector. required: true schema: type: string - name: includeDeaccessioned in: query description: Whether deaccessioned dataset versions are included. schema: type: boolean responses: "200": description: OK security: - DataverseApiKey: [] /datasets/{id}/versions/{versionId}/citation/{format}: get: tags: - Datasets summary: Returns a formatted dataset version citation description: Returns citation text for a selected dataset version in the requested citation format. operationId: Datasets_getDatasetVersionCitation parameters: - name: format in: path description: Citation format to return. required: true schema: type: string - name: id in: path description: Resource id or persistent identifier. required: true schema: type: string - name: versionId in: path description: Dataset version selector. required: true schema: type: string - name: includeDeaccessioned in: query description: Whether deaccessioned dataset versions are included. schema: type: boolean responses: "200": description: OK security: - DataverseApiKey: [] /datasets/{id}/versions/{versionId}/customlicense: get: tags: - Datasets summary: Redirects to custom license terms description: Redirects to the dataset page terms tab for a dataset version that uses custom license terms. operationId: Datasets_getCustomTermsTab parameters: - name: id in: path description: Resource id or persistent identifier. required: true schema: type: string - name: versionId in: path description: Dataset version selector. required: true schema: type: string responses: "200": description: OK /datasets/{id}/versions/{versionId}/deaccession: post: tags: - Datasets summary: Deaccessions a dataset version description: Deaccessions a published dataset version using the supplied reason and optional forwarding URL. operationId: Datasets_deaccessionDataset parameters: - name: id in: path description: Resource id or persistent identifier. required: true schema: type: string - name: versionId in: path description: Dataset version selector. required: true schema: type: string requestBody: description: JSON deaccession payload containing deaccessionReason and optional deaccessionForwardURL. content: '*/*': schema: type: string responses: "200": description: OK security: - DataverseApiKey: [] /datasets/{id}/versions/{versionId}/files: get: tags: - Datasets summary: Lists files in a dataset version description: "Lists file metadata for a dataset version with pagination, text\ \ search, category, tag, content type, access status, and ordering filters." operationId: Datasets_getVersionFiles parameters: - name: id in: path description: Resource id or persistent identifier. required: true schema: type: string - name: versionId in: path description: Dataset version selector. required: true schema: type: string - name: accessStatus in: query description: File access status filter. schema: type: string - name: categoryName in: query description: File category name filter. schema: type: string - name: contentType in: query description: File content type filter. schema: type: string - name: includeDeaccessioned in: query description: Whether deaccessioned dataset versions are included. schema: type: boolean - name: limit in: query description: Maximum number of results to return. schema: format: int32 type: integer - name: offset in: query description: Result offset. schema: format: int32 type: integer - name: orderCriteria in: query description: File ordering criteria. schema: type: string - name: searchText in: query description: File search text filter. schema: type: string - name: tabularTagName in: query description: Tabular data tag filter. schema: type: string responses: "200": description: OK security: - DataverseApiKey: [] /datasets/{id}/versions/{versionId}/files/counts: get: tags: - Datasets summary: Counts files in a dataset version description: "Returns total file counts for a dataset version and count breakdowns\ \ by content type, category, tabular tag, and access status." operationId: Datasets_getVersionFileCounts parameters: - name: id in: path description: Resource id or persistent identifier. required: true schema: type: string - name: versionId in: path description: Dataset version selector. required: true schema: type: string - name: accessStatus in: query description: File access status filter. schema: type: string - name: categoryName in: query description: File category name filter. schema: type: string - name: contentType in: query description: File content type filter. schema: type: string - name: includeDeaccessioned in: query description: Whether deaccessioned dataset versions are included. schema: type: boolean - name: searchText in: query description: File search text filter. schema: type: string - name: tabularTagName in: query description: Tabular data tag filter. schema: type: string responses: "200": description: OK security: - DataverseApiKey: [] /datasets/{id}/versions/{versionId}/linkset: get: tags: - Datasets summary: Build a dataset version linkset description: Generates signposting linkset JSON for a released dataset version. operationId: Datasets_getLinkset parameters: - name: id in: path description: Dataset id or persistent identifier. required: true schema: type: string - name: versionId in: path description: Dataset version id or version label. required: true schema: type: string responses: "200": description: OK security: - DataverseApiKey: [] /datasets/{id}/versions/{versionId}/metadata: get: tags: - Datasets summary: Read JSON-LD metadata for a dataset version description: Exports JSON-LD metadata for the requested dataset version. operationId: Datasets_getVersionJsonLDMetadata parameters: - name: id in: path description: Dataset id or persistent identifier. required: true schema: type: string - name: versionId in: path description: Dataset version id or version label. required: true schema: type: string responses: "200": description: OK security: - DataverseApiKey: [] /datasets/{id}/versions/{versionId}/versionNote: get: tags: - Datasets summary: Read a dataset version note description: Returns the note stored on the requested dataset version. operationId: Datasets_getVersionCreationNote parameters: - name: id in: path description: Dataset id or persistent identifier. required: true schema: type: string - name: versionId in: path description: Dataset version id or version label. required: true schema: type: string responses: "200": description: OK security: - DataverseApiKey: [] put: tags: - Datasets summary: Store a dataset version note description: Adds or replaces the note on a draft or superuser-selected published dataset version. operationId: Datasets_addVersionNote parameters: - name: id in: path description: Dataset id or persistent identifier. required: true schema: type: string - name: versionId in: path description: Dataset version id or version label. required: true schema: type: string responses: "200": description: OK security: - DataverseApiKey: [] delete: tags: - Datasets summary: Clear a dataset version note description: Deletes the note from a draft or superuser-selected published dataset version. operationId: Datasets_deleteVersionNote parameters: - name: id in: path description: Dataset id or persistent identifier. required: true schema: type: string - name: versionId in: path description: Dataset version id or version label. required: true schema: type: string responses: "200": description: OK security: - DataverseApiKey: [] /datasets/{id}/versions/{versionNumber}/metadata/{block}: get: tags: - Datasets summary: Returns a metadata block for a dataset version description: Returns metadata fields from one named metadata block in a selected dataset version. operationId: Datasets_getVersionMetadataBlock parameters: - name: block in: path description: Metadata block name. required: true schema: type: string - name: id in: path description: Resource id or persistent identifier. required: true schema: type: string - name: versionNumber in: path description: Dataset version selector. required: true schema: type: string responses: "200": description: OK security: - DataverseApiKey: [] /datasets/{id}/versions/{version}/toolparams/{tid}: get: tags: - Datasets summary: Returns dataset external tool parameters description: Returns dataset-version parameters and allowed API calls for a dataset-scoped external tool. operationId: Datasets_getExternalToolDVParams parameters: - name: id in: path description: Resource id or persistent identifier. required: true schema: type: string - name: tid in: path description: External tool id. required: true schema: format: int64 type: integer - name: version in: path description: Dataset version selector. required: true schema: type: string - name: locale in: query description: Locale for localized Globus metadata. schema: type: string responses: "200": description: OK security: - DataverseApiKey: [] /datasets/{id}/{version}/archivalStatus: get: tags: - Datasets summary: Returns archival status for a dataset version description: Returns stored archival status information for a dataset version when the requester is a superuser. operationId: Datasets_getDatasetVersionArchivalStatus parameters: - name: id in: path description: Resource id or persistent identifier. required: true schema: type: string - name: version in: path description: Dataset version selector. required: true schema: type: string responses: "200": description: OK security: - DataverseApiKey: [] put: tags: - Datasets summary: Sets dataset version archival status description: Sets the archival status payload for a dataset version when the requester is a superuser. operationId: Datasets_setDatasetVersionArchivalStatus parameters: - name: id in: path description: Resource id or persistent identifier. required: true schema: type: string - name: version in: path description: Dataset version selector. required: true schema: type: string requestBody: description: JSON archival status payload to store for the dataset version. content: application/json: schema: type: string responses: "200": description: OK security: - DataverseApiKey: [] delete: tags: - Datasets summary: Deletes archival status for a dataset version description: Removes stored archival status information from a dataset version when the requester is a superuser. operationId: Datasets_deleteDatasetVersionArchivalStatus parameters: - name: id in: path description: Resource id or persistent identifier. required: true schema: type: string - name: version in: path description: Dataset version selector. required: true schema: type: string responses: "200": description: OK security: - DataverseApiKey: [] /datasets/{linkedDatasetId}/link/{linkingDataverseAlias}: put: tags: - Datasets summary: Links a dataset to a dataverse description: Creates a link from a dataverse to an existing dataset. operationId: Datasets_linkDataset parameters: - name: linkedDatasetId in: path description: Dataset id to link. required: true schema: type: string - name: linkingDataverseAlias in: path description: Alias of the dataverse that links to the dataset. required: true schema: type: string responses: "200": description: OK security: - DataverseApiKey: [] /datatags/receiveTags/{uniqueCacheId}: post: tags: - Datasets summary: Receives DataTags results description: Stores returned DataTags JSON in the callback cache and returns the Dataverse redirect URL. operationId: DataTagsAPI_receiveTags parameters: - name: uniqueCacheId in: path description: Callback cache identifier associated with the DataTags interview. required: true schema: type: string requestBody: description: DataTags result JSON returned by the external tagging interview. content: '*/*': schema: type: object responses: "200": description: OK /dataverseFeaturedItems/{id}: put: tags: - Dataverse Featured Items summary: Revise a dataverse featured item description: "Updates text, linked object, display order, and optional image\ \ content for a featured item." operationId: DataverseFeaturedItems_updateFeaturedItem parameters: - name: id in: path description: Database id of the featured item to update. required: true schema: format: int64 type: integer requestBody: description: "Multipart featured item update with text, ordering, optional\ \ linked object, and optional replacement image." content: multipart/form-data: schema: type: string responses: "200": description: OK security: - DataverseApiKey: [] delete: tags: - Dataverse Featured Items summary: Remove a dataverse featured item description: Deletes the featured item with the supplied database id. operationId: DataverseFeaturedItems_deleteFeaturedItem parameters: - name: id in: path description: Database id of the featured item to delete. required: true schema: format: int64 type: integer responses: "200": description: OK security: - DataverseApiKey: [] /dataverses: post: tags: - Dataverses summary: Create the root dataverse description: Creates the root dataverse from a Dataverse JSON payload. operationId: Dataverses_addRoot requestBody: description: Dataverse JSON for the root collection. content: '*/*': schema: type: string responses: "200": description: OK security: - DataverseApiKey: [] /dataverses/{dataverseId}/featuredItems: put: tags: - Dataverses summary: Replace dataverse featured items description: "Creates, updates, reorders, and removes featured items for a dataverse\ \ from multipart form lists." operationId: Dataverses_updateFeaturedItems parameters: - name: dataverseId in: path description: "Dataverse alias, id, or persistent identifier." required: true schema: type: string requestBody: description: "Multipart featured item list update with ids, text, ordering,\ \ linked objects, keep-image flags, and uploaded images." content: multipart/form-data: schema: type: array items: format: int64 type: integer responses: "200": description: OK security: - DataverseApiKey: [] /dataverses/{identifier}: get: tags: - Dataverses summary: Read a dataverse description: Returns dataverse metadata with optional owner and child-count information. operationId: Dataverses_getDataverse parameters: - name: identifier in: path description: "Dataverse alias, id, or persistent identifier." required: true schema: type: string - name: ignoreSettingExcludeEmailFromExport in: query description: Whether to include email fields when the caller has permission to ignore the email-exclusion setting. schema: type: boolean - name: returnChildCount in: query description: Whether to include the number of child objects. schema: type: boolean - name: returnOwners in: query description: Whether to include owner information. schema: type: boolean responses: "200": description: OK security: - DataverseApiKey: [] put: tags: - Dataverses summary: Revise a dataverse description: "Updates dataverse metadata and optional metadata block, input\ \ level, and facet settings." operationId: Dataverses_updateDataverse parameters: - name: identifier in: path description: "Dataverse alias, id, or persistent identifier." required: true schema: type: string requestBody: description: Dataverse update JSON with metadata and optional configuration sections. content: '*/*': schema: type: string responses: "200": description: OK security: - DataverseApiKey: [] post: tags: - Dataverses summary: Create a child dataverse description: Creates a dataverse under the selected parent and returns the created collection metadata. operationId: Dataverses_addDataverse parameters: - name: identifier in: path description: "Parent dataverse alias, id, or persistent identifier." required: true schema: type: string requestBody: description: "Dataverse JSON including alias, name, contact, metadata block,\ \ input level, and facet settings." content: '*/*': schema: type: string responses: "200": description: OK security: - DataverseApiKey: [] delete: tags: - Dataverses summary: Remove a dataverse description: Deletes the selected dataverse collection. operationId: Dataverses_deleteDataverse parameters: - name: identifier in: path description: "Dataverse alias, id, or persistent identifier." required: true schema: type: string responses: "200": description: OK security: - DataverseApiKey: [] /dataverses/{identifier}/actions/:publish: post: tags: - Dataverses summary: Publish a dataverse description: Publishes the selected dataverse collection. operationId: Dataverses_publishDataverse parameters: - name: identifier in: path description: "Dataverse alias, id, or persistent identifier." required: true schema: type: string responses: "200": description: OK security: - DataverseApiKey: [] /dataverses/{identifier}/allowedMetadataLanguages: get: tags: - Dataverses summary: Read allowed metadata language description: Returns the metadata language configured for a dataverse. operationId: Dataverses_getMetadataLanguage parameters: - name: identifier in: path description: "Dataverse alias, id, or persistent identifier." required: true schema: type: string responses: "200": description: OK security: - DataverseApiKey: [] /dataverses/{identifier}/allowedMetadataLanguages/{metadataLanguage}: put: tags: - Dataverses summary: Assign allowed metadata language description: Sets the metadata language configured for a dataverse. operationId: Dataverses_setMetadataLanguage parameters: - name: identifier in: path description: "Dataverse alias, id, or persistent identifier." required: true schema: type: string - name: metadataLanguage in: path description: Metadata language code to assign. required: true schema: type: string responses: "200": description: OK security: - DataverseApiKey: [] /dataverses/{identifier}/allowedStorageDrivers: get: tags: - Dataverses summary: Read allowed storage drivers description: Returns storage drivers available for the selected dataverse. operationId: Dataverses_listStorageDrivers parameters: - name: identifier in: path description: "Dataverse alias, id, or persistent identifier." required: true schema: type: string responses: "200": description: OK security: - DataverseApiKey: [] /dataverses/{identifier}/assignments: get: tags: - Dataverses summary: Read dataverse role assignments description: Lists role assignments defined on a dataverse. operationId: Dataverses_listAssignments parameters: - name: identifier in: path description: "Dataverse alias, id, or persistent identifier." required: true schema: type: string responses: "200": description: OK security: - DataverseApiKey: [] post: tags: - Dataverses summary: Grant a dataverse role assignment description: Assigns a role to a role assignee on a dataverse. operationId: Dataverses_createAssignment parameters: - name: identifier in: path description: "Dataverse alias, id, or persistent identifier." required: true schema: type: string requestBody: description: Role assignment containing assignee identifier and role alias. content: '*/*': schema: $ref: '#/components/schemas/RoleAssignmentDTO' responses: "200": description: OK security: - DataverseApiKey: [] /dataverses/{identifier}/assignments/history: get: tags: - Dataverses summary: Read dataverse role assignment history description: Returns dataverse role assignment history as JSON or CSV. operationId: Dataverses_getRoleAssignmentHistory parameters: - name: identifier in: path description: "Dataverse alias, id, or persistent identifier." required: true schema: type: string responses: "200": description: OK security: - DataverseApiKey: [] /dataverses/{identifier}/assignments/{id}: delete: tags: - Dataverses summary: Remove a dataverse role assignment description: Revokes a role assignment from the selected dataverse. operationId: Dataverses_deleteAssignment parameters: - name: id in: path description: Role assignment database id. required: true schema: format: int64 type: integer - name: identifier in: path description: "Dataverse alias, id, or persistent identifier." required: true schema: type: string responses: "200": description: OK security: - DataverseApiKey: [] /dataverses/{identifier}/attribute/{attribute}: put: tags: - Dataverses summary: Change a dataverse attribute description: Updates one supported dataverse attribute value. operationId: Dataverses_updateAttribute parameters: - name: attribute in: path description: Dataverse attribute name to change. required: true schema: type: string - name: identifier in: path description: "Dataverse alias, id, or persistent identifier." required: true schema: type: string - name: value in: query description: New attribute value. schema: type: string responses: "200": description: OK security: - DataverseApiKey: [] /dataverses/{identifier}/contents: get: tags: - Dataverses summary: Read dataverse contents description: Lists direct child dataverses and datasets for a dataverse. operationId: Dataverses_listContent parameters: - name: identifier in: path description: "Dataverse alias, id, or persistent identifier." required: true schema: type: string responses: "200": description: OK security: - DataverseApiKey: [] /dataverses/{identifier}/datasetSchema: get: tags: - Dataverses summary: Read dataset schema for a dataverse description: Returns the dataset JSON schema generated for the selected dataverse. operationId: Dataverses_getDatasetSchema parameters: - name: identifier in: path description: "Dataverse alias, id, or persistent identifier." required: true schema: type: string responses: "200": description: OK security: - DataverseApiKey: [] /dataverses/{identifier}/datasets: post: tags: - Dataverses summary: Create a dataset from JSON description: Creates a draft dataset in the selected dataverse and returns its id and persistent identifier. operationId: Dataverses_createDataset parameters: - name: identifier in: path description: "Dataverse alias, id, or persistent identifier for the dataset\ \ owner." required: true schema: type: string - name: doNotValidate in: query description: "When true and incomplete metadata is allowed, skip full metadata\ \ validation." schema: type: string requestBody: description: Dataset JSON containing at least one dataset version. content: application/ld+json: schema: type: string application/json-ld: schema: type: string application/json: schema: type: string responses: "200": description: OK security: - DataverseApiKey: [] /dataverses/{identifier}/datasets/:import: post: tags: - Dataverses summary: Import a dataset from JSON description: "Imports a dataset into the selected dataverse, optionally assigning\ \ a supplied PID and release state." operationId: Dataverses_importDataset parameters: - name: identifier in: path description: "Dataverse alias, id, or persistent identifier for the dataset\ \ owner." required: true schema: type: string - name: pid in: query description: Persistent identifier to assign to the imported dataset. schema: type: string - name: release in: query description: "When true, import the dataset as released." schema: type: string requestBody: description: Dataset JSON to import. content: '*/*': schema: type: string responses: "200": description: OK security: - DataverseApiKey: [] /dataverses/{identifier}/datasets/:importddi: post: tags: - Dataverses summary: Import a dataset from DDI XML description: Converts DDI XML to dataset metadata and imports it into the selected dataverse. operationId: Dataverses_importDatasetDdi parameters: - name: identifier in: path description: "Dataverse alias, id, or persistent identifier for the dataset\ \ owner." required: true schema: type: string - name: pid in: query description: Persistent identifier to assign to the imported dataset. schema: type: string - name: release in: query description: "When true, import the dataset as released." schema: type: string requestBody: description: DDI XML document to import. content: '*/*': schema: type: string responses: "200": description: OK security: - DataverseApiKey: [] /dataverses/{identifier}/datasets/:startmigration: post: tags: - Dataverses summary: Start migrated dataset recreation description: Creates a draft dataset from published JSON-LD metadata for a migration workflow. operationId: Dataverses_recreateDataset parameters: - name: identifier in: path description: "Dataverse alias, id, or persistent identifier for the dataset\ \ owner." required: true schema: type: string requestBody: description: Published dataset JSON-LD metadata to recreate as a draft. content: application/ld+json: schema: type: string application/json-ld: schema: type: string responses: "200": description: OK security: - DataverseApiKey: [] /dataverses/{identifier}/defaultContributorRole: get: tags: - Dataverses summary: Read the default contributor role description: Returns the default contributor role configured for a dataverse. operationId: Dataverses_getDefaultContributorRole parameters: - name: identifier in: path description: "Dataverse alias, id, or persistent identifier." required: true schema: type: string responses: "200": description: OK security: - DataverseApiKey: [] /dataverses/{identifier}/defaultContributorRole/{roleAlias}: put: tags: - Dataverses summary: Assign a default contributor role description: Sets the default contributor role used for datasets created in a dataverse. operationId: Dataverses_updateDefaultContributorRole parameters: - name: identifier in: path description: "Dataverse alias, id, or persistent identifier." required: true schema: type: string - name: roleAlias in: path description: "Role alias to use as the default contributor role, or none." required: true schema: type: string responses: "200": description: OK security: - DataverseApiKey: [] /dataverses/{identifier}/facets: get: tags: - Dataverses summary: Read dataverse facets description: "Lists dataset field facets configured for a dataverse, optionally\ \ including detailed facet metadata." operationId: Dataverses_listFacets parameters: - name: identifier in: path description: "Dataverse alias, id, or persistent identifier." required: true schema: type: string - name: returnDetails in: query description: Whether to include detailed facet metadata. schema: type: boolean responses: "200": description: OK security: - DataverseApiKey: [] post: tags: - Dataverses summary: Assign dataverse facets description: Replaces the dataset field facets configured directly on a dataverse. operationId: Dataverses_setFacets parameters: - name: identifier in: path description: "Dataverse alias, id, or persistent identifier." required: true schema: type: string responses: "200": description: OK security: - DataverseApiKey: [] /dataverses/{identifier}/featured: get: tags: - Dataverses summary: Read featured dataverses description: Lists aliases for dataverses featured by the selected dataverse. operationId: Dataverses_getFeaturedDataverses parameters: - name: identifier in: path description: "Dataverse alias, id, or persistent identifier." required: true schema: type: string responses: "200": description: OK security: - DataverseApiKey: [] post: tags: - Dataverses summary: Assign featured dataverses description: Adds eligible child or linked dataverses to the featured list for a dataverse. operationId: Dataverses_setFeaturedDataverses parameters: - name: identifier in: path description: "Dataverse alias, id, or persistent identifier." required: true schema: type: string responses: "200": description: OK security: - DataverseApiKey: [] delete: tags: - Dataverses summary: Clear featured dataverses description: Removes all featured dataverses from the selected dataverse. operationId: Dataverses_deleteFeaturedCollections parameters: - name: identifier in: path description: "Dataverse alias, id, or persistent identifier." required: true schema: type: string responses: "200": description: OK security: - DataverseApiKey: [] /dataverses/{identifier}/featuredItems: get: tags: - Dataverses summary: Read dataverse featured items description: Lists featured items configured on a dataverse. operationId: Dataverses_listFeaturedItems parameters: - name: identifier in: path description: "Dataverse alias, id, or persistent identifier." required: true schema: type: string responses: "200": description: OK security: - DataverseApiKey: [] post: tags: - Dataverses summary: Create a dataverse featured item description: "Creates a featured item with text, optional linked object, display\ \ order, and optional image." operationId: Dataverses_createFeaturedItem parameters: - name: identifier in: path description: "Dataverse alias, id, or persistent identifier." required: true schema: type: string requestBody: description: "Multipart featured item creation request with text, ordering,\ \ optional linked object, and optional image." content: multipart/form-data: schema: type: string responses: "200": description: OK security: - DataverseApiKey: [] delete: tags: - Dataverses summary: Clear dataverse featured items description: Removes all featured items from a dataverse. operationId: Dataverses_deleteFeaturedItems parameters: - name: identifier in: path description: "Dataverse alias, id, or persistent identifier." required: true schema: type: string responses: "200": description: OK security: - DataverseApiKey: [] /dataverses/{identifier}/groups: get: tags: - Dataverses summary: Read explicit groups description: Lists explicit groups owned by a dataverse. operationId: Dataverses_listGroups parameters: - name: identifier in: path description: "Dataverse alias, id, or persistent identifier." required: true schema: type: string responses: "200": description: OK security: - DataverseApiKey: [] post: tags: - Dataverses summary: Create an explicit group description: Creates an explicit group owned by a dataverse. operationId: Dataverses_createExplicitGroup parameters: - name: identifier in: path description: "Dataverse alias, id, or persistent identifier." required: true schema: type: string requestBody: description: Explicit group definition. content: '*/*': schema: $ref: '#/components/schemas/ExplicitGroupDTO' responses: "200": description: OK security: - DataverseApiKey: [] /dataverses/{identifier}/groups/{aliasInOwner}: get: tags: - Dataverses summary: Read an explicit group description: Returns one explicit group owned by a dataverse. operationId: Dataverses_getGroupByOwnerAndAliasInOwner parameters: - name: aliasInOwner in: path description: Group alias within the dataverse. required: true schema: type: string - name: identifier in: path description: "Dataverse alias, id, or persistent identifier." required: true schema: type: string responses: "200": description: OK security: - DataverseApiKey: [] put: tags: - Dataverses summary: Revise an explicit group description: Updates an explicit group owned by a dataverse. operationId: Dataverses_updateGroup parameters: - name: aliasInOwner in: path description: Group alias within the dataverse. required: true schema: type: string - name: identifier in: path description: "Dataverse alias, id, or persistent identifier." required: true schema: type: string requestBody: description: Explicit group definition to apply. content: '*/*': schema: $ref: '#/components/schemas/ExplicitGroupDTO' responses: "200": description: OK security: - DataverseApiKey: [] delete: tags: - Dataverses summary: Remove an explicit group description: Deletes an explicit group owned by a dataverse. operationId: Dataverses_deleteGroup parameters: - name: aliasInOwner in: path description: Group alias within the dataverse. required: true schema: type: string - name: identifier in: path description: "Dataverse alias, id, or persistent identifier." required: true schema: type: string responses: "200": description: OK security: - DataverseApiKey: [] /dataverses/{identifier}/groups/{aliasInOwner}/roleAssignees: post: tags: - Dataverses summary: Append role assignees to an explicit group description: Adds multiple role assignee identifiers to an explicit group. operationId: Dataverses_addRoleAssingees parameters: - name: aliasInOwner in: path description: Group alias within the dataverse. required: true schema: type: string - name: identifier in: path description: "Dataverse alias, id, or persistent identifier." required: true schema: type: string requestBody: description: JSON array of role assignee identifiers to add. content: application/json: schema: type: array items: type: string responses: "200": description: OK security: - DataverseApiKey: [] /dataverses/{identifier}/groups/{aliasInOwner}/roleAssignees/{roleAssigneeIdentifier}: put: tags: - Dataverses summary: Append one role assignee to an explicit group description: Adds one role assignee identifier to an explicit group. operationId: Dataverses_addRoleAssingee parameters: - name: aliasInOwner in: path description: Group alias within the dataverse. required: true schema: type: string - name: identifier in: path description: "Dataverse alias, id, or persistent identifier." required: true schema: type: string - name: roleAssigneeIdentifier in: path description: Role assignee identifier to add to the group. required: true schema: pattern: .* type: string responses: "200": description: OK security: - DataverseApiKey: [] delete: tags: - Dataverses summary: Remove one role assignee from an explicit group description: Removes one role assignee identifier from an explicit group. operationId: Dataverses_deleteRoleAssingee parameters: - name: aliasInOwner in: path description: Group alias within the dataverse. required: true schema: type: string - name: identifier in: path description: "Dataverse alias, id, or persistent identifier." required: true schema: type: string - name: roleAssigneeIdentifier in: path description: Role assignee identifier to remove from the group. required: true schema: pattern: .* type: string responses: "200": description: OK security: - DataverseApiKey: [] /dataverses/{identifier}/guestbookResponses: get: tags: - Dataverses summary: Export guestbook responses for a dataverse description: Streams guestbook response data for datasets in a dataverse as CSV. operationId: Dataverses_getGuestbookResponsesByDataverse parameters: - name: identifier in: path description: "Dataverse alias, id, or persistent identifier." required: true schema: type: string - name: guestbookId in: query description: Guestbook database id used to filter responses. schema: format: int64 type: integer responses: "200": description: OK security: - DataverseApiKey: [] /dataverses/{identifier}/inputLevels: get: tags: - Dataverses summary: Read dataverse input levels description: Returns dataset field input-level settings for a dataverse. operationId: Dataverses_getInputLevels parameters: - name: identifier in: path description: "Dataverse alias, id, or persistent identifier." required: true schema: type: string responses: "200": description: OK security: - DataverseApiKey: [] put: tags: - Dataverses summary: Assign dataverse input levels description: Replaces dataset field input-level settings for a dataverse. operationId: Dataverses_updateInputLevels parameters: - name: identifier in: path description: "Dataverse alias, id, or persistent identifier." required: true schema: type: string responses: "200": description: OK security: - DataverseApiKey: [] /dataverses/{identifier}/links: get: tags: - Dataverses summary: Read dataverse links description: Returns dataverses and datasets linked from a dataverse and dataverses linking to it. operationId: Dataverses_listLinks parameters: - name: identifier in: path description: "Dataverse alias, id, or persistent identifier." required: true schema: type: string responses: "200": description: OK security: - DataverseApiKey: [] /dataverses/{identifier}/locallyFairRoleAssignees: get: tags: - Dataverses summary: Lists locally FAIR role assignees description: Lists role assignee identifiers configured for locally FAIR metadata access in a dataverse. operationId: Dataverses_listLocallyFairRoleAssignees parameters: - name: identifier in: path description: "Dataverse alias, id, or persistent identifier." required: true schema: type: string responses: "200": description: OK security: - DataverseApiKey: [] put: tags: - Dataverses summary: Replaces locally FAIR role assignees description: Replaces the full locally FAIR role assignee identifier set for a dataverse and reindexes the dataverse. operationId: Dataverses_setLocallyFairRoleAssignees parameters: - name: identifier in: path description: "Dataverse alias, id, or persistent identifier." required: true schema: type: string requestBody: description: JSON array of role assignee identifiers to configure for locally FAIR metadata access. content: application/json: schema: type: array items: type: string responses: "200": description: OK security: - DataverseApiKey: [] /dataverses/{identifier}/locallyFairRoleAssignees/{roleAssigneeIdentifier}: put: tags: - Dataverses summary: Adds a locally FAIR role assignee description: Adds one role assignee identifier to the locally FAIR metadata access set for a dataverse and reindexes the dataverse. operationId: Dataverses_addLocallyFairRoleAssignee parameters: - name: identifier in: path description: "Dataverse alias, id, or persistent identifier." required: true schema: type: string - name: roleAssigneeIdentifier in: path description: "Role assignee identifier to add, such as a user or group identifier." required: true schema: pattern: .* type: string responses: "200": description: OK security: - DataverseApiKey: [] delete: tags: - Dataverses summary: Removes a locally FAIR role assignee description: Removes one role assignee identifier from the locally FAIR metadata access set for a dataverse and reindexes the dataverse. operationId: Dataverses_deleteLocallyFairRoleAssignee parameters: - name: identifier in: path description: "Dataverse alias, id, or persistent identifier." required: true schema: type: string - name: roleAssigneeIdentifier in: path description: Role assignee identifier to remove from locally FAIR metadata access. required: true schema: pattern: .* type: string responses: "200": description: OK security: - DataverseApiKey: [] /dataverses/{identifier}/metadatablockfacets: get: tags: - Dataverses summary: Read metadata block facets description: Returns metadata block facet settings for a dataverse. operationId: Dataverses_listMetadataBlockFacets parameters: - name: identifier in: path description: "Dataverse alias, id, or persistent identifier." required: true schema: type: string responses: "200": description: OK security: - DataverseApiKey: [] post: tags: - Dataverses summary: Assign metadata block facets description: Replaces metadata block facets on a dataverse that is a metadata-block-facet root. operationId: Dataverses_setMetadataBlockFacets parameters: - name: identifier in: path description: "Dataverse alias, id, or persistent identifier." required: true schema: type: string requestBody: description: JSON array of metadata block names to use as facets. content: application/json: schema: type: array items: type: string responses: "200": description: OK security: - DataverseApiKey: [] /dataverses/{identifier}/metadatablockfacets/isRoot: post: tags: - Dataverses summary: Assign metadata block facet root status description: Changes whether a dataverse is a metadata-block-facet root. operationId: Dataverses_updateMetadataBlockFacetsRoot parameters: - name: identifier in: path description: "Dataverse alias, id, or persistent identifier." required: true schema: type: string requestBody: description: Boolean text indicating whether the dataverse is a metadata-block-facet root. content: application/json: schema: type: string responses: "200": description: OK security: - DataverseApiKey: [] /dataverses/{identifier}/metadatablocks: get: tags: - Dataverses summary: Read dataverse metadata blocks description: "Lists metadata blocks configured for a dataverse, optionally including\ \ dataset field types." operationId: Dataverses_listMetadataBlocks parameters: - name: identifier in: path description: "Dataverse alias, id, or persistent identifier." required: true schema: type: string - name: datasetType in: query description: Dataset type name used to filter metadata blocks. schema: type: string - name: onlyDisplayedOnCreate in: query description: "When true, include only metadata blocks displayed on dataset\ \ creation." schema: type: boolean - name: returnDatasetFieldTypes in: query description: Whether to include dataset field type definitions. schema: type: boolean responses: "200": description: OK security: - DataverseApiKey: [] post: tags: - Dataverses summary: Assign metadata blocks to a dataverse description: Replaces the metadata blocks configured directly on a dataverse. operationId: Dataverses_setMetadataBlocks parameters: - name: identifier in: path description: "Dataverse alias, id, or persistent identifier." required: true schema: type: string responses: "200": description: OK security: - DataverseApiKey: [] /dataverses/{identifier}/metadatablocks/:isRoot: get: tags: - Dataverses summary: Read metadata-block root status through legacy route description: Returns whether a dataverse is a metadata-block root using the legacy route. operationId: Dataverses_getMetadataRoot_legacy parameters: - name: identifier in: path description: "Dataverse alias, id, or persistent identifier." required: true schema: type: string responses: "200": description: OK security: - DataverseApiKey: [] post: tags: - Dataverses summary: Set metadata-block root status through legacy route description: Changes whether a dataverse is a metadata-block root using the legacy route. operationId: Dataverses_setMetadataRoot_legacy parameters: - name: identifier in: path description: "Dataverse alias, id, or persistent identifier." required: true schema: type: string requestBody: description: Boolean text indicating whether the dataverse is a metadata-block root. content: '*/*': schema: type: string responses: "200": description: OK security: - DataverseApiKey: [] /dataverses/{identifier}/metadatablocks/isRoot: get: tags: - Dataverses summary: Read metadata-block root status description: Returns whether a dataverse is a metadata-block root. operationId: Dataverses_getMetadataRoot parameters: - name: identifier in: path description: "Dataverse alias, id, or persistent identifier." required: true schema: type: string responses: "200": description: OK security: - DataverseApiKey: [] put: tags: - Dataverses summary: Assign metadata-block root status description: Changes whether a dataverse is a metadata-block root. operationId: Dataverses_setMetadataRoot parameters: - name: identifier in: path description: "Dataverse alias, id, or persistent identifier." required: true schema: type: string requestBody: description: Boolean text indicating whether the dataverse is a metadata-block root. content: '*/*': schema: type: string responses: "200": description: OK security: - DataverseApiKey: [] /dataverses/{identifier}/roles: get: tags: - Dataverses summary: Read dataverse roles description: Lists roles available on a dataverse. operationId: Dataverses_listRoles parameters: - name: identifier in: path description: "Dataverse alias, id, or persistent identifier." required: true schema: type: string responses: "200": description: OK security: - DataverseApiKey: [] post: tags: - Dataverses summary: Create a dataverse role description: Creates a role scoped to the selected dataverse. operationId: Dataverses_createRole parameters: - name: identifier in: path description: "Dataverse alias, id, or persistent identifier." required: true schema: type: string requestBody: description: "Role definition containing alias, name, description, and permissions." content: '*/*': schema: $ref: '#/components/schemas/RoleDTO' responses: "200": description: OK security: - DataverseApiKey: [] /dataverses/{identifier}/storage/quota: get: tags: - Dataverses summary: Read dataverse storage quota description: "Returns the storage quota for a dataverse, optionally including\ \ inherited quota values." operationId: Dataverses_getCollectionQuota parameters: - name: identifier in: path description: "Dataverse alias, id, or persistent identifier." required: true schema: type: string - name: showInherited in: query description: Whether to include inherited quota settings in the response. schema: type: boolean responses: "200": description: OK security: - DataverseApiKey: [] put: tags: - Dataverses summary: Assign dataverse storage quota description: Sets the dataverse storage quota in bytes. operationId: Dataverses_setCollectionQuota parameters: - name: identifier in: path description: "Dataverse alias, id, or persistent identifier." required: true schema: type: string responses: "200": description: OK security: - DataverseApiKey: [] delete: tags: - Dataverses summary: Clear dataverse storage quota description: Deletes the explicit storage quota for a dataverse. operationId: Dataverses_deleteCollectionQuota parameters: - name: identifier in: path description: "Dataverse alias, id, or persistent identifier." required: true schema: type: string responses: "200": description: OK security: - DataverseApiKey: [] /dataverses/{identifier}/storage/use: get: tags: - Dataverses summary: Read dataverse storage use description: Returns the recorded storage use for a dataverse. operationId: Dataverses_getCollectionStorageUse parameters: - name: identifier in: path description: "Dataverse alias, id, or persistent identifier." required: true schema: type: string responses: "200": description: OK security: - DataverseApiKey: [] /dataverses/{identifier}/storageDriver: get: tags: - Dataverses summary: Read dataverse storage driver description: "Returns the storage driver configured for a dataverse, optionally\ \ resolving the effective inherited driver." operationId: Dataverses_getStorageDriver parameters: - name: identifier in: path description: "Dataverse alias, id, or persistent identifier." required: true schema: type: string - name: getEffective in: query description: Whether to resolve the effective inherited storage driver. schema: type: boolean responses: "200": description: OK security: - DataverseApiKey: [] put: tags: - Dataverses summary: Assign dataverse storage driver description: Sets the storage driver for a dataverse by driver label. operationId: Dataverses_setStorageDriver parameters: - name: identifier in: path description: "Dataverse alias, id, or persistent identifier." required: true schema: type: string responses: "200": description: OK security: - DataverseApiKey: [] delete: tags: - Dataverses summary: Reset dataverse storage driver description: Clears the explicit storage driver setting so the dataverse uses the default driver. operationId: Dataverses_resetStorageDriver parameters: - name: identifier in: path description: "Dataverse alias, id, or persistent identifier." required: true schema: type: string responses: "200": description: OK security: - DataverseApiKey: [] /dataverses/{identifier}/storagesize: get: tags: - Dataverses summary: Read dataverse storage size description: "Returns the storage size for a dataverse, optionally including\ \ cached size data." operationId: Dataverses_getStorageSize parameters: - name: identifier in: path description: "Dataverse alias, id, or persistent identifier." required: true schema: type: string - name: includeCached in: query description: Whether to include cached storage size values. schema: type: boolean responses: "200": description: OK security: - DataverseApiKey: [] /dataverses/{identifier}/template/default: delete: tags: - Dataverses summary: Clear the default metadata template description: Removes the default metadata template setting from a dataverse. operationId: Dataverses_removeDefaultTemplate parameters: - name: identifier in: path description: "Dataverse alias, id, or persistent identifier." required: true schema: type: string responses: "200": description: OK security: - DataverseApiKey: [] /dataverses/{identifier}/template/default/{templateId}: post: tags: - Dataverses summary: Assign the default metadata template description: Sets the default metadata template for a dataverse. operationId: Dataverses_setDefaultTemplate parameters: - name: identifier in: path description: "Dataverse alias, id, or persistent identifier." required: true schema: type: string - name: templateId in: path description: Template database id. required: true schema: format: int64 type: integer responses: "200": description: OK security: - DataverseApiKey: [] /dataverses/{identifier}/templates: get: tags: - Dataverses summary: Read dataverse templates description: Lists metadata templates available in a dataverse. operationId: Dataverses_getTemplates parameters: - name: identifier in: path description: "Dataverse alias, id, or persistent identifier." required: true schema: type: string responses: "200": description: OK security: - DataverseApiKey: [] post: tags: - Dataverses summary: Create a metadata template description: Creates a metadata template owned by a dataverse. operationId: Dataverses_createTemplate parameters: - name: identifier in: path description: "Dataverse alias, id, or persistent identifier." required: true schema: type: string requestBody: description: Template JSON containing template metadata fields and settings. content: '*/*': schema: type: string responses: "200": description: OK security: - DataverseApiKey: [] /dataverses/{identifier}/userPermissions: get: tags: - Dataverses summary: Read user permissions on a dataverse description: Returns booleans for the requesting user's key dataverse permissions. operationId: Dataverses_getUserPermissionsOnDataverse parameters: - name: identifier in: path description: "Dataverse alias, id, or persistent identifier." required: true schema: type: string responses: "200": description: OK security: - DataverseApiKey: [] /dataverses/{identifier}/validateDatasetJson: post: tags: - Dataverses summary: Validate dataset JSON description: Validates a dataset JSON payload against the selected dataverse. operationId: Dataverses_validateDatasetJson parameters: - name: identifier in: path description: "Dataverse alias, id, or persistent identifier." required: true schema: type: string requestBody: description: Dataset JSON to validate. content: application/json: schema: type: string responses: "200": description: OK security: - DataverseApiKey: [] /dataverses/{identifier}/{type}/linkingDataverses: get: tags: - Dataverses summary: Search dataverses for linking description: "Lists dataverses that can be linked to the selected dataverse\ \ object, optionally filtered by search text and existing link status." operationId: Dataverses_getLinkingDataverseList parameters: - name: identifier in: path description: Dataverse object id or persistent identifier. required: true schema: type: string - name: type in: path description: Dataverse object type used to resolve the identifier. required: true schema: type: string - name: alreadyLinking in: query description: Whether to return dataverses already linking to the object. schema: type: boolean - name: searchTerm in: query description: Search text used to filter dataverses. schema: type: string responses: "200": description: OK security: - DataverseApiKey: [] /dataverses/{id}/move/{targetDataverseAlias}: post: tags: - Dataverses summary: Move a dataverse description: Moves a dataverse collection to a different parent dataverse. operationId: Dataverses_moveDataverse parameters: - name: id in: path description: "Dataverse alias, id, or persistent identifier to move." required: true schema: type: string - name: targetDataverseAlias in: path description: Alias of the target parent dataverse. required: true schema: type: string - name: forceMove in: query description: Whether to force the move when warnings would otherwise block it. schema: type: boolean responses: "200": description: OK security: - DataverseApiKey: [] /dataverses/{id}/template: get: tags: - Dataverses summary: Read a metadata template description: Returns one metadata template by database id. operationId: Dataverses_getTemplate parameters: - name: id in: path description: Template database id. required: true schema: format: int64 type: integer responses: "200": description: OK security: - DataverseApiKey: [] delete: tags: - Dataverses summary: Remove a metadata template description: Deletes a metadata template and clears default-template references that point to it. operationId: Dataverses_deleteTemplate parameters: - name: id in: path description: Template database id. required: true schema: format: int64 type: integer responses: "200": description: OK security: - DataverseApiKey: [] /dataverses/{linkedDataverseAlias}/link/{linkingDataverseAlias}: put: tags: - Dataverses summary: Link one dataverse from another description: Creates a link from one dataverse to another dataverse. operationId: Dataverses_linkDataverse parameters: - name: linkedDataverseAlias in: path description: Alias of the dataverse being linked. required: true schema: type: string - name: linkingDataverseAlias in: path description: Alias of the dataverse that will contain the link. required: true schema: type: string responses: "200": description: OK security: - DataverseApiKey: [] /dataverses/{linkedDataverseId}/deleteLink/{linkingDataverseId}: delete: tags: - Dataverses summary: Remove a dataverse link description: Deletes a link from one dataverse to another linked dataverse. operationId: Dataverses_deleteDataverseLinkingDataverse parameters: - name: linkedDataverseId in: path description: Alias or id of the linked dataverse to remove. required: true schema: type: string - name: linkingDataverseId in: path description: Alias or id of the dataverse containing the link. required: true schema: type: string responses: "200": description: OK security: - DataverseApiKey: [] /dataverses/{templateId}/access: put: tags: - Dataverses summary: Revise metadata template terms of access description: Updates terms of use and access settings on a metadata template. operationId: Dataverses_updateTemplateTermsOfAccess parameters: - name: templateId in: path description: Template database id. required: true schema: format: int64 type: integer requestBody: description: JSON terms-of-access payload for the metadata template. content: '*/*': schema: type: string responses: "200": description: OK security: - DataverseApiKey: [] /dataverses/{templateId}/licenseTerms: put: tags: - Dataverses summary: Revise metadata template license terms description: Updates the license or custom terms configured on a metadata template. operationId: Dataverses_updateTemplateLicenseTerms parameters: - name: templateId in: path description: Template database id. required: true schema: format: int64 type: integer - name: replace in: query description: Unused replace flag accepted by the endpoint. schema: type: boolean requestBody: description: "License update request containing a license name, URI, or custom\ \ terms." content: '*/*': schema: $ref: '#/components/schemas/LicenseUpdateRequest' responses: "200": description: OK security: - DataverseApiKey: [] /dataverses/{templateId}/metadata: put: tags: - Dataverses summary: Revise metadata template fields description: "Updates a template name, field values, and field instructions." operationId: Dataverses_updateTemplateMetadata parameters: - name: templateId in: path description: Template database id. required: true schema: format: int64 type: integer - name: replace in: query description: "When true, replace matching field values instead of merging." schema: type: boolean requestBody: description: "Template metadata JSON containing name, fields, and optional\ \ instructions." content: '*/*': schema: type: string responses: "200": description: OK security: - DataverseApiKey: [] /edit/{fileId}: put: tags: - Files summary: Updates tabular file variable metadata description: "Parses DDI XML for a tabular data file and updates variable metadata\ \ on the draft dataset version, creating a draft when needed." operationId: EditDDI_edit parameters: - name: fileId in: path description: Data file id whose variable metadata is updated. required: true schema: type: string requestBody: description: DDI XML containing variable metadata and variable group updates for the tabular file. content: application/xml: schema: format: binary type: string responses: "200": description: OK security: - DataverseApiKey: [] /externalTools: get: tags: - External Tools summary: Lists external tools description: Returns all registered external tools. operationId: ExternalToolsApi_getExternalTools responses: "200": description: OK post: tags: - External Tools summary: Registers an external tool description: Registers an external tool from its manifest when the authenticated user is a superuser. operationId: ExternalToolsApi_addExternalTool requestBody: description: External tool manifest JSON to register. content: '*/*': schema: type: string responses: "200": description: OK security: - DataverseApiKey: [] /externalTools/{id}: get: tags: - External Tools summary: Returns an external tool description: Returns the registered external tool with the specified numeric id. operationId: ExternalToolsApi_getExternalTool parameters: - name: id in: path description: Numeric id of the external tool to return. required: true schema: format: int64 type: integer responses: "200": description: OK delete: tags: - External Tools summary: Deletes an external tool description: Deletes the registered external tool with the specified numeric id when the authenticated user is a superuser. operationId: ExternalToolsApi_deleteExternalTool parameters: - name: id in: path description: Numeric id of the external tool to delete. required: true schema: format: int64 type: integer responses: "200": description: OK security: - DataverseApiKey: [] /files/fixityAlgorithm: get: tags: - Files summary: Show the configured file fixity algorithm description: Reports the checksum algorithm configured for file fixity checks. operationId: Files_getFixityAlgorithm responses: "200": description: OK /files/{id}: get: tags: - Files summary: Returns file metadata description: "Returns file metadata for the latest accessible dataset version,\ \ optionally including dataset version and owner details." operationId: Files_getFileData parameters: - name: id in: path description: Resource id or persistent identifier. required: true schema: type: string - name: includeDeaccessioned in: query description: Whether deaccessioned dataset versions are included. schema: type: boolean - name: returnDatasetVersion in: query description: Whether dataset version information is included in the response. schema: type: boolean - name: returnOwners in: query description: Whether owner information is included in the response. schema: type: boolean responses: "200": description: OK security: - DataverseApiKey: [] delete: tags: - Files summary: Remove a file from its dataset description: Removes a data file from the dataset draft and deletes the physical file when the file has never been released. operationId: Files_deleteFileInDataset parameters: - name: id in: path description: Data file id or persistent identifier. required: true schema: type: string responses: "200": description: OK security: - DataverseApiKey: [] /files/{id}/dataTables: get: tags: - Files summary: Show tabular data tables description: Reports data table metadata associated with a tabular data file after checking file access when needed. operationId: Files_getFileDataTables parameters: - name: id in: path description: Data file id or persistent identifier. required: true schema: type: string responses: "200": description: OK security: - DataverseApiKey: [] /files/{id}/downloadCount: get: tags: - Files summary: Show file download count description: Reports the recorded download count for a data file. operationId: Files_getFileDownloadCount parameters: - name: id in: path description: Data file id or persistent identifier. required: true schema: type: string responses: "200": description: OK security: - DataverseApiKey: [] /files/{id}/externalTool/{tid}/toolUrl: post: tags: - Files summary: Creates a file external tool URL description: Returns launch URL details for a file-scoped external tool after checking tool configuration and file permissions. operationId: Files_getExternalToolUrl parameters: - name: id in: path description: Resource id or persistent identifier. required: true schema: type: string - name: tid in: path description: External tool id. required: true schema: format: int64 type: integer requestBody: description: External tool launch options such as preview mode and locale. content: application/json: schema: type: string responses: "200": description: OK security: - DataverseApiKey: [] /files/{id}/extractNcml: post: tags: - Files summary: Extracts NcML metadata description: Extracts NcML metadata from a data file when the requester is a superuser. operationId: Files_extractNcml parameters: - name: id in: path description: Resource id or persistent identifier. required: true schema: type: string responses: "200": description: OK security: - DataverseApiKey: [] /files/{id}/hasBeenDeleted: get: tags: - Files summary: Check whether a file was deleted description: Reports whether the selected data file has a deletion record. operationId: Files_getHasBeenDeleted parameters: - name: id in: path description: Data file id or persistent identifier. required: true schema: type: string responses: "200": description: OK security: - DataverseApiKey: [] /files/{id}/metadata: get: tags: - Files summary: Returns published file metadata description: Returns the latest published metadata for a data file as JSON text. operationId: Files_getFileMetadata parameters: - name: id in: path description: Resource id or persistent identifier. required: true schema: type: string responses: "200": description: OK security: - DataverseApiKey: [] post: tags: - Files summary: Revise file metadata description: Updates metadata for an existing data file using multipart JSON metadata. operationId: Files_updateFileMetadata parameters: - name: id in: path description: Data file id or persistent identifier. required: true schema: type: string - name: sourceLastUpdateTime in: query description: Source last-update timestamp used by external integrations. schema: type: string responses: "200": description: OK security: - DataverseApiKey: [] /files/{id}/metadata/categories: post: tags: - Files summary: Apply category labels to file metadata description: Adds or replaces category labels on the selected file metadata record. operationId: Files_setFileCategories parameters: - name: id in: path description: Data file id or persistent identifier. required: true schema: type: string - name: replace in: query description: "When true, replace existing categories before adding the supplied\ \ values." schema: type: boolean responses: "200": description: OK security: - DataverseApiKey: [] /files/{id}/metadata/draft: get: tags: - Files summary: Returns draft file metadata description: Returns draft metadata for a data file when the requester may access the draft. operationId: Files_getFileMetadataDraft parameters: - name: id in: path description: Resource id or persistent identifier. required: true schema: type: string responses: "200": description: OK security: - DataverseApiKey: [] /files/{id}/metadata/tabularTags: post: tags: - Files summary: Apply tabular tags to a file description: Adds or replaces tabular data tags on a tabular data file. operationId: Files_setFileTabularTags parameters: - name: id in: path description: Data file id or persistent identifier. required: true schema: type: string - name: replace in: query description: "When true, replace existing tabular tags before adding the supplied\ \ values." schema: type: boolean responses: "200": description: OK security: - DataverseApiKey: [] /files/{id}/metadata/{fmid}/toolparams/{tid}: get: tags: - Files summary: Resolve external tool parameters for file metadata description: Reports the parameter payload and allowed API calls for an external tool working with a specific file metadata record. operationId: Files_getExternalToolFMParams parameters: - name: fmid in: path description: File metadata database id. required: true schema: format: int64 type: integer - name: id in: path description: Data file id or persistent identifier. required: true schema: type: string - name: tid in: path description: External tool database id. required: true schema: format: int64 type: integer - name: locale in: query description: Locale used when creating the external tool parameter payload. schema: type: string responses: "200": description: OK security: - DataverseApiKey: [] /files/{id}/prov-freeform: get: tags: - Files summary: Returns free-form provenance for a data file description: Returns stored free-form provenance text for the specified data file. operationId: Prov_getProvFreeForm parameters: - name: id in: path description: Data file id or persistent identifier whose free-form provenance is returned. required: true schema: type: string requestBody: description: Unused request body accepted by the endpoint. content: '*/*': schema: type: string responses: "200": description: OK security: - DataverseApiKey: [] post: tags: - Files summary: Adds free-form provenance to a data file description: Stores free-form provenance text for a data file from the text field of the supplied JSON and updates the dataset draft version. operationId: Prov_addProvFreeForm parameters: - name: id in: path description: Data file id or persistent identifier whose free-form provenance is updated. required: true schema: type: string requestBody: description: JSON object containing a text field with free-form provenance. content: application/json: schema: type: string responses: "200": description: OK security: - DataverseApiKey: [] /files/{id}/prov-json: get: tags: - Files summary: Returns PROV JSON for a data file description: Returns stored PROV JSON for the specified data file. operationId: Prov_getProvJson parameters: - name: id in: path description: Data file id or persistent identifier whose PROV JSON is returned. required: true schema: type: string requestBody: description: Unused request body accepted by the endpoint. content: '*/*': schema: type: string responses: "200": description: OK security: - DataverseApiKey: [] post: tags: - Files summary: Adds PROV JSON to a data file description: Validates and stores PROV JSON for a data file after checking that the requested entity name exists in the provenance graph. operationId: Prov_addProvJson parameters: - name: id in: path description: Data file id or persistent identifier whose provenance is updated. required: true schema: type: string - name: entityName in: query description: Entity name in the PROV JSON graph that represents the data file. required: true schema: type: string requestBody: description: PROV JSON document to validate and store for the data file. content: application/json: schema: type: string responses: "200": description: OK security: - DataverseApiKey: [] delete: tags: - Files summary: Deletes PROV JSON from a data file description: Deletes stored PROV JSON from an unreleased data file. operationId: Prov_deleteProvJson parameters: - name: id in: path description: Data file id or persistent identifier whose PROV JSON is deleted. required: true schema: type: string requestBody: description: Unused request body accepted by the endpoint. content: '*/*': schema: type: string responses: "200": description: OK security: - DataverseApiKey: [] /files/{id}/redetect: post: tags: - Files summary: Re-evaluate file content type description: Runs content-type detection for a non-tabular data file and optionally reports the result without saving it. operationId: Files_redetectDatafile parameters: - name: id in: path description: Data file id or persistent identifier. required: true schema: type: string - name: dryRun in: query description: "When true, report the detected type without saving the change." schema: type: boolean responses: "200": description: OK security: - DataverseApiKey: [] /files/{id}/reingest: post: tags: - Files summary: Reingests a data file description: Starts ingest processing for a data file when the requester is a superuser. operationId: Files_reingest parameters: - name: id in: path description: Resource id or persistent identifier. required: true schema: type: string responses: "200": description: OK security: - DataverseApiKey: [] /files/{id}/replace: post: tags: - replaceFilesInDataset summary: Replace a file on a dataset description: Replace a file to a dataset operationId: Files_replaceFileInDataset parameters: - name: id in: path description: Data file id or persistent identifier for the file being replaced. required: true schema: type: string requestBody: description: Multipart request containing replacement file content and JSON replacement metadata. content: multipart/form-data: schema: type: string responses: "200": description: File replaced successfully on the dataset security: - DataverseApiKey: [] /files/{id}/restrict: put: tags: - Files summary: Change file restriction status description: "Applies restricted or unrestricted status to a data file, with\ \ optional access-request and terms-of-access settings." operationId: Files_restrictFileInDataset parameters: - name: id in: path description: Data file id or persistent identifier. required: true schema: type: string responses: "200": description: OK security: - DataverseApiKey: [] /files/{id}/uningest: post: tags: - Files summary: Uningests a data file description: Converts an ingested tabular data file back to a regular file when the requester is a superuser. operationId: Files_uningestDatafile parameters: - name: id in: path description: Resource id or persistent identifier. required: true schema: type: string responses: "200": description: OK security: - DataverseApiKey: [] /files/{id}/versionDifferences: get: tags: - Files summary: Compare file versions description: Reports metadata differences across versions for a data file. operationId: Files_getFileVersionsList parameters: - name: id in: path description: Data file id or persistent identifier. required: true schema: type: string - name: limit in: query description: Maximum number of version-difference records to return. schema: format: int32 type: integer - name: offset in: query description: Number of version-difference records to skip before returning results. schema: format: int32 type: integer responses: "200": description: OK security: - DataverseApiKey: [] /files/{id}/versions/{datasetVersionId}: get: tags: - Files summary: Returns file metadata for a version description: "Returns file metadata for the requested dataset version, optionally\ \ including dataset version and owner details." operationId: Files_getFileDataForVersion parameters: - name: datasetVersionId in: path description: Dataset version selector. required: true schema: type: string - name: id in: path description: Resource id or persistent identifier. required: true schema: type: string - name: includeDeaccessioned in: query description: Whether deaccessioned dataset versions are included. schema: type: boolean - name: returnDatasetVersion in: query description: Whether dataset version information is included in the response. schema: type: boolean - name: returnOwners in: query description: Whether owner information is included in the response. schema: type: boolean responses: "200": description: OK security: - DataverseApiKey: [] /files/{id}/versions/{dsVersionString}/citation: get: tags: - Files summary: Format a citation for a file version description: Reports the citation text for a data file in the requested dataset version. operationId: Files_getFileCitationByVersion parameters: - name: dsVersionString in: path description: "Dataset version label, such as 1.0, :draft, or :latest-published." required: true schema: type: string - name: id in: path description: Data file id or persistent identifier. required: true schema: type: string - name: includeDeaccessioned in: query description: Whether deaccessioned dataset versions may be used. schema: type: boolean responses: "200": description: OK security: - DataverseApiKey: [] /guestbooks/{identifier}: post: tags: - Guestbooks summary: Creates a guestbook description: Creates a guestbook in the specified dataverse when the requester can edit that dataverse. operationId: Guestbooks_createGuestbook parameters: - name: identifier in: path description: Dataverse alias where the guestbook is created. required: true schema: type: string responses: "200": description: OK security: - DataverseApiKey: [] /guestbooks/{identifier}/list: get: tags: - Guestbooks summary: Lists guestbooks for a dataverse description: "Returns guestbooks configured for a dataverse, optionally including\ \ inherited guestbooks and usage statistics." operationId: Guestbooks_getGuestbooks parameters: - name: identifier in: path description: Dataverse alias whose guestbooks are listed. required: true schema: type: string - name: includeInherited in: query description: Include guestbooks inherited from parent dataverses. schema: type: boolean - name: includeStats in: query description: Include guestbook usage and response counts. schema: type: boolean responses: "200": description: OK security: - DataverseApiKey: [] /guestbooks/{identifier}/{id}/enabled: put: tags: - Guestbooks summary: Sets guestbook enabled state description: Updates whether a guestbook in the specified dataverse is enabled. operationId: Guestbooks_enableGuestbook parameters: - name: id in: path description: Numeric id of the guestbook to update. required: true schema: type: string - name: identifier in: path description: Dataverse alias containing the guestbook. required: true schema: type: string responses: "200": description: OK security: - DataverseApiKey: [] /guestbooks/{id}: get: tags: - Guestbooks summary: Returns a guestbook description: Returns the guestbook with the specified numeric id. operationId: Guestbooks_getGuestbook parameters: - name: id in: path description: Numeric id of the guestbook to return. required: true schema: format: int64 type: integer responses: "200": description: OK security: - DataverseApiKey: [] put: tags: - Guestbooks summary: Updates a guestbook description: Updates a guestbook definition from JSON when the requester may edit the owning dataverse. operationId: Guestbooks_updateGuestbook parameters: - name: id in: path description: Numeric id of the guestbook to update. required: true schema: format: int64 type: integer requestBody: description: Guestbook JSON definition to parse and apply. content: '*/*': schema: type: string responses: "200": description: OK security: - DataverseApiKey: [] /guestbooks/{id}/responses: get: tags: - Guestbooks summary: Lists guestbook responses description: "Returns guestbook metadata and response records, with pagination\ \ links when a limit is supplied." operationId: Guestbooks_getResponses parameters: - name: id in: path description: Numeric id of the guestbook whose responses are listed. required: true schema: format: int64 type: integer - name: limit in: query description: Maximum number of response records to return. schema: format: int32 type: integer - name: offset in: query description: Response record offset. schema: format: int32 type: integer responses: "200": description: OK security: - DataverseApiKey: [] /harvest/clients: get: tags: - Admin summary: Lists harvesting clients description: Returns harvesting client configurations visible to the authenticated requester. operationId: HarvestingClients_harvestingClients responses: "200": description: OK security: - DataverseApiKey: [] /harvest/clients/{nickName}: get: tags: - Admin summary: Returns a harvesting client description: Returns the harvesting client configuration with the specified nickname when the requester is authorized to view it. operationId: HarvestingClients_harvestingClient parameters: - name: nickName in: path description: Harvesting client nickname to return. required: true schema: type: string responses: "200": description: OK security: - DataverseApiKey: [] put: tags: - Admin summary: Updates a harvesting client description: Updates editable harvesting client fields when the authenticated user is a superuser. operationId: HarvestingClients_modifyHarvestingClient parameters: - name: nickName in: path description: Nickname of the harvesting client to update. required: true schema: type: string requestBody: description: "Harvesting client update JSON containing editable fields such\ \ as harvest URL, archive URL, metadata format, set, and custom headers." content: '*/*': schema: type: string responses: "200": description: OK security: - DataverseApiKey: [] post: tags: - Admin summary: Creates a harvesting client description: Creates a harvesting client with the specified nickname when the authenticated user is a superuser. operationId: HarvestingClients_createHarvestingClient parameters: - name: nickName in: path description: Nickname assigned to the harvesting client. required: true schema: type: string requestBody: description: "Harvesting client JSON containing dataverse alias, harvest URL,\ \ archive URL, metadata format, and optional settings." content: '*/*': schema: type: string responses: "200": description: OK security: - DataverseApiKey: [] delete: tags: - Admin summary: Deletes a harvesting client description: Starts asynchronous deletion of a harvesting client when the authenticated user is a superuser and no harvest or delete is already in progress. operationId: HarvestingClients_deleteHarvestingClient parameters: - name: nickName in: path description: Nickname of the harvesting client to delete. required: true schema: type: string responses: "200": description: OK security: - DataverseApiKey: [] /harvest/clients/{nickName}/run: post: tags: - Admin summary: Starts a harvesting job description: Starts an asynchronous harvesting job for the specified client when the authenticated user is a superuser. operationId: HarvestingClients_startHarvestingJob parameters: - name: nickName in: path description: Nickname of the harvesting client to run. required: true schema: type: string responses: "200": description: OK security: - DataverseApiKey: [] /harvest/server/oaisets: get: tags: - Admin summary: Lists OAI sets description: "Returns all configured OAI sets with name, spec, description,\ \ definition, and version." operationId: HarvestingServer_oaiSets parameters: - name: key in: query description: Legacy key value accepted by the endpoint. schema: type: string responses: "200": description: OK /harvest/server/oaisets/add: post: tags: - Admin summary: Creates an OAI set description: "Creates an OAI set from name, definition, and optional description\ \ JSON when the authenticated user is a superuser." operationId: HarvestingServer_createOaiSet requestBody: description: "OAI set JSON containing name, definition, and optional description." content: '*/*': schema: type: string responses: "200": description: OK security: - DataverseApiKey: [] /harvest/server/oaisets/{specname}: get: tags: - Admin summary: Returns an OAI set description: Returns the OAI set with the specified set specification name. operationId: HarvestingServer_oaiSet parameters: - name: specname in: path description: OAI set specification name to return. required: true schema: type: string - name: key in: query description: Legacy key value accepted by the endpoint. schema: type: string responses: "200": description: OK put: tags: - Admin summary: Updates an OAI set description: Updates the definition or description of an OAI set when the authenticated user is a superuser. operationId: HarvestingServer_modifyOaiSet parameters: - name: specname in: path description: OAI set specification name to update. required: true schema: type: string requestBody: description: "OAI set update JSON containing definition, description, or both." content: '*/*': schema: type: string responses: "200": description: OK security: - DataverseApiKey: [] delete: tags: - Admin summary: Deletes an OAI set description: Marks an OAI set for deletion and removes it when the authenticated user is a superuser. operationId: HarvestingServer_deleteOaiSet parameters: - name: specname in: path description: OAI set specification name to delete. required: true schema: type: string responses: "200": description: OK security: - DataverseApiKey: [] /harvest/server/oaisets/{specname}/datasets: get: tags: - Admin summary: Lists datasets in an OAI set description: Validates that the specified OAI set exists and returns the current placeholder response for dataset listing. operationId: HarvestingServer_oaiSetListDatasets parameters: - name: specname in: path description: OAI set specification name whose datasets are requested. required: true schema: type: string - name: key in: query description: Legacy key value accepted by the endpoint. schema: type: string responses: "200": description: OK /inbox: post: summary: Accepts a Linked Data Notification description: Accepts a whitelisted Linked Data Notification inbox message and dispatches supported relationship announcements. operationId: LDNInbox_acceptMessage requestBody: description: Linked Data Notification message body encoded as JSON-LD. content: application/ld+json: schema: type: string application/json-ld: schema: type: string responses: "200": description: OK /info/apiTermsOfUse: get: tags: - Info summary: Returns API terms of use description: Returns the configured API terms of use for this Dataverse installation. operationId: Info_getTermsOfUse responses: "200": description: OK /info/applicationTermsOfUse: get: tags: - Info summary: Returns application terms of use description: "Returns the general application terms of use that users agree\ \ to during signup, optionally localized by language code." operationId: Info_getApplicationTermsOfUse parameters: - name: lang in: query description: Two-character language code. required: false schema: type: string example: en responses: "200": description: Application Terms of Use (General Terms of Use) that must be agreed to at signup. /info/exportFormats: get: tags: - Info summary: Lists export formats description: "Returns dataset export formats with display name, media type,\ \ harvestability, user-interface visibility, and XML metadata when available." operationId: Info_getExportFormats responses: "200": description: OK /info/metrics/accounts: get: tags: - Info summary: Calculates total account count description: Calculates the number of user accounts through the current month. operationId: Metrics_getAccountsAllTime responses: "200": description: OK /info/metrics/accounts/monthly: get: tags: - Info summary: Calculates monthly account counts description: Calculates a monthly time series of user account counts as JSON or CSV. operationId: Metrics_getAccountsTimeSeries responses: "200": description: OK /info/metrics/accounts/pastDays/{days}: get: tags: - Info summary: Calculates recent account count description: Calculates the number of user accounts created during the specified number of past days. operationId: Metrics_getAccountsPastDays parameters: - name: days in: path description: Positive number of past days included in the metric. required: true schema: format: int32 type: integer responses: "200": description: OK /info/metrics/accounts/toMonth/{yyyymm}: get: tags: - Info summary: Calculates account count through a month description: Calculates the number of user accounts through the specified month. operationId: Metrics_getAccountsToMonth parameters: - name: yyyymm in: path description: "Year and month cutoff for the metric, formatted as YYYYMM." required: true schema: type: string responses: "200": description: OK /info/metrics/datasets: get: tags: - Info summary: Calculates total dataset count description: "Calculates the number of released datasets through the current\ \ month, optionally filtered by storage location and parent dataverse." operationId: Metrics_getDatasetsAllTime parameters: - name: dataLocation in: query description: Storage location filter for the dataset metric. schema: type: string - name: parentAlias in: query description: Alias of a released parent dataverse used to scope the metric. schema: type: string responses: "200": description: OK /info/metrics/datasets/bySubject: get: tags: - Info summary: Calculates dataset counts by subject description: "Calculates released dataset counts grouped by subject through\ \ the current month as JSON or CSV, optionally filtered by storage location\ \ and parent dataverse." operationId: Metrics_getDatasetsBySubject parameters: - name: dataLocation in: query description: Storage location filter for the dataset metric. schema: type: string - name: parentAlias in: query description: Alias of a released parent dataverse used to scope the metric. schema: type: string responses: "200": description: OK /info/metrics/datasets/bySubject/toMonth/{yyyymm}: get: tags: - Info summary: Calculates dataset counts by subject through a month description: "Calculates released dataset counts grouped by subject through\ \ the specified month as JSON or CSV, optionally filtered by storage location\ \ and parent dataverse." operationId: Metrics_getDatasetsBySubjectToMonth parameters: - name: yyyymm in: path description: "Year and month cutoff for the metric, formatted as YYYYMM." required: true schema: type: string - name: dataLocation in: query description: Storage location filter for the dataset metric. schema: type: string - name: parentAlias in: query description: Alias of a released parent dataverse used to scope the metric. schema: type: string responses: "200": description: OK /info/metrics/datasets/monthly: get: tags: - Info summary: Calculates monthly dataset counts description: "Calculates a monthly time series of released dataset counts as\ \ JSON or CSV, optionally filtered by storage location and parent dataverse." operationId: Metrics_getDatasetsTimeSeriest parameters: - name: dataLocation in: query description: Storage location filter for the dataset metric. schema: type: string - name: parentAlias in: query description: Alias of a released parent dataverse used to scope the metric. schema: type: string responses: "200": description: OK /info/metrics/datasets/pastDays/{days}: get: tags: - Info summary: Calculates recent dataset count description: "Calculates the number of released datasets created during the\ \ specified number of past days, optionally filtered by storage location and\ \ parent dataverse." operationId: Metrics_getDatasetsPastDays parameters: - name: days in: path description: Positive number of past days included in the metric. required: true schema: format: int32 type: integer - name: dataLocation in: query description: Storage location filter for the dataset metric. schema: type: string - name: parentAlias in: query description: Alias of a released parent dataverse used to scope the metric. schema: type: string responses: "200": description: OK /info/metrics/datasets/toMonth/{yyyymm}: get: tags: - Info summary: Calculates dataset count through a month description: "Calculates the number of released datasets through the specified\ \ month, optionally filtered by storage location and parent dataverse." operationId: Metrics_getDatasetsToMonth parameters: - name: yyyymm in: path description: "Year and month cutoff for the metric, formatted as YYYYMM." required: true schema: type: string - name: dataLocation in: query description: Storage location filter for the dataset metric. schema: type: string - name: parentAlias in: query description: Alias of a released parent dataverse used to scope the metric. schema: type: string responses: "200": description: OK /info/metrics/dataverses: get: tags: - Info summary: Calculates total dataverse count description: "Calculates the number of released dataverses through the current\ \ month, optionally scoped to a released parent dataverse." operationId: Metrics_getDataversesAllTime parameters: - name: parentAlias in: query description: Alias of a released parent dataverse used to scope the metric. schema: type: string responses: "200": description: OK /info/metrics/dataverses/byCategory: get: tags: - Info summary: Calculates dataverse counts by category description: "Calculates released dataverse counts grouped by dataverse category\ \ as JSON or CSV, optionally scoped to a released parent dataverse." operationId: Metrics_getDataversesByCategory parameters: - name: parentAlias in: query description: Alias of a released parent dataverse used to scope the metric. schema: type: string responses: "200": description: OK /info/metrics/dataverses/bySubject: get: tags: - Info summary: Calculates dataverse counts by subject description: "Calculates released dataverse counts grouped by subject as JSON\ \ or CSV, optionally scoped to a released parent dataverse." operationId: Metrics_getDataversesBySubject parameters: - name: parentAlias in: query description: Alias of a released parent dataverse used to scope the metric. schema: type: string responses: "200": description: OK /info/metrics/dataverses/monthly: get: tags: - Info summary: Calculates monthly dataverse counts description: "Calculates a monthly time series of released dataverse counts\ \ as JSON or CSV, optionally scoped to a released parent dataverse." operationId: Metrics_getDataversesTimeSeries parameters: - name: parentAlias in: query description: Alias of a released parent dataverse used to scope the metric. schema: type: string responses: "200": description: OK /info/metrics/dataverses/pastDays/{days}: get: tags: - Info summary: Calculates recent dataverse count description: "Calculates the number of released dataverses created during the\ \ specified number of past days, optionally scoped to a released parent dataverse." operationId: Metrics_getDataversesPastDays parameters: - name: days in: path description: Positive number of past days included in the metric. required: true schema: format: int32 type: integer - name: parentAlias in: query description: Alias of a released parent dataverse used to scope the metric. schema: type: string responses: "200": description: OK /info/metrics/dataverses/toMonth/{yyyymm}: get: tags: - Info summary: Calculates dataverse count through a month description: "Calculates the number of released dataverses through the specified\ \ month, optionally scoped to a released parent dataverse." operationId: Metrics_getDataversesToMonth parameters: - name: yyyymm in: path description: "Year and month cutoff for the metric, formatted as YYYYMM." required: true schema: type: string - name: parentAlias in: query description: Alias of a released parent dataverse used to scope the metric. schema: type: string responses: "200": description: OK /info/metrics/downloads: get: tags: - Info summary: Calculates total download count description: "Calculates the number of file downloads through the current month,\ \ optionally scoped to a released parent dataverse." operationId: Metrics_getDownloadsAllTime parameters: - name: parentAlias in: query description: Alias of a released parent dataverse used to scope the metric. schema: type: string responses: "200": description: OK /info/metrics/downloads/monthly: get: tags: - Info summary: Calculates monthly download counts description: "Calculates a monthly time series of file download counts as JSON\ \ or CSV, optionally scoped to a released parent dataverse." operationId: Metrics_getDownloadsTimeSeries parameters: - name: parentAlias in: query description: Alias of a released parent dataverse used to scope the metric. schema: type: string responses: "200": description: OK /info/metrics/downloads/pastDays/{days}: get: tags: - Info summary: Calculates recent download count description: "Calculates the number of file downloads during the specified number\ \ of past days, optionally scoped to a released parent dataverse." operationId: Metrics_getDownloadsPastDays parameters: - name: days in: path description: Positive number of past days included in the metric. required: true schema: format: int32 type: integer - name: parentAlias in: query description: Alias of a released parent dataverse used to scope the metric. schema: type: string responses: "200": description: OK /info/metrics/downloads/toMonth/{yyyymm}: get: tags: - Info summary: Calculates download count through a month description: "Calculates the number of file downloads through the specified\ \ month, optionally scoped to a released parent dataverse." operationId: Metrics_getDownloadsToMonth parameters: - name: yyyymm in: path description: "Year and month cutoff for the metric, formatted as YYYYMM." required: true schema: type: string - name: parentAlias in: query description: Alias of a released parent dataverse used to scope the metric. schema: type: string responses: "200": description: OK /info/metrics/filedownloads: get: tags: - Info summary: Calculates file download counts description: "Calculates file download counts by file through the current month\ \ as JSON or CSV, optionally scoped to a released parent dataverse." operationId: Metrics_getFileDownloadsAllTime parameters: - name: parentAlias in: query description: Alias of a released parent dataverse used to scope the metric. schema: type: string responses: "200": description: OK /info/metrics/filedownloads/monthly: get: tags: - Info summary: Calculates monthly file download counts description: "Calculates a monthly time series of file download counts by file\ \ as JSON or CSV, optionally scoped to a released parent dataverse." operationId: Metrics_getFileDownloadsTimeSeries parameters: - name: parentAlias in: query description: Alias of a released parent dataverse used to scope the metric. schema: type: string responses: "200": description: OK /info/metrics/filedownloads/toMonth/{yyyymm}: get: tags: - Info summary: Calculates file download counts through a month description: "Calculates file download counts by file through the specified\ \ month as JSON or CSV, optionally scoped to a released parent dataverse." operationId: Metrics_getFileDownloadsToMonth parameters: - name: yyyymm in: path description: "Year and month cutoff for the metric, formatted as YYYYMM." required: true schema: type: string - name: parentAlias in: query description: Alias of a released parent dataverse used to scope the metric. schema: type: string responses: "200": description: OK /info/metrics/files: get: tags: - Info summary: Calculates total file count description: "Calculates the number of released files through the current month,\ \ optionally scoped to a released parent dataverse." operationId: Metrics_getFilesAllTime parameters: - name: parentAlias in: query description: Alias of a released parent dataverse used to scope the metric. schema: type: string responses: "200": description: OK /info/metrics/files/byType: get: tags: - Info summary: Calculates file counts by type description: "Calculates released file counts and sizes grouped by content type\ \ as JSON or CSV, optionally scoped to a released parent dataverse." operationId: Metrics_getFilesByType parameters: - name: parentAlias in: query description: Alias of a released parent dataverse used to scope the metric. schema: type: string responses: "200": description: OK /info/metrics/files/byType/monthly: get: tags: - Info summary: Calculates monthly file counts by type description: "Calculates a monthly time series of released file counts and sizes\ \ grouped by content type as JSON or CSV, optionally scoped to a released\ \ parent dataverse." operationId: Metrics_getFilesByTypeTimeSeries parameters: - name: parentAlias in: query description: Alias of a released parent dataverse used to scope the metric. schema: type: string responses: "200": description: OK /info/metrics/files/monthly: get: tags: - Info summary: Calculates monthly file counts description: "Calculates a monthly time series of released file counts as JSON\ \ or CSV, optionally scoped to a released parent dataverse." operationId: Metrics_getFilesTimeSeries parameters: - name: parentAlias in: query description: Alias of a released parent dataverse used to scope the metric. schema: type: string responses: "200": description: OK /info/metrics/files/pastDays/{days}: get: tags: - Info summary: Calculates recent file count description: "Calculates the number of released files created during the specified\ \ number of past days, optionally scoped to a released parent dataverse." operationId: Metrics_getFilesPastDays parameters: - name: days in: path description: Positive number of past days included in the metric. required: true schema: format: int32 type: integer - name: parentAlias in: query description: Alias of a released parent dataverse used to scope the metric. schema: type: string responses: "200": description: OK /info/metrics/files/toMonth/{yyyymm}: get: tags: - Info summary: Calculates file count through a month description: "Calculates the number of released files through the specified\ \ month, optionally scoped to a released parent dataverse." operationId: Metrics_getFilesToMonth parameters: - name: yyyymm in: path description: "Year and month cutoff for the metric, formatted as YYYYMM." required: true schema: type: string - name: parentAlias in: query description: Alias of a released parent dataverse used to scope the metric. schema: type: string responses: "200": description: OK /info/metrics/makeDataCount/{metric}: get: tags: - Info summary: Calculates a Make Data Count metric description: "Calculates the requested Make Data Count metric through the current\ \ month, optionally filtered by country and parent dataverse." operationId: Metrics_getMakeDataCountMetricCurrentMonth parameters: - name: metric in: path description: Make Data Count metric name to return. required: true schema: type: string - name: country in: query description: ISO country code used to filter the metric. schema: type: string - name: parentAlias in: query description: Alias of a released parent dataverse used to scope the metric. schema: type: string responses: "200": description: OK /info/metrics/makeDataCount/{metric}/monthly: get: tags: - Info summary: Calculates monthly Make Data Count metrics description: "Calculates a monthly time series for the requested Make Data Count\ \ metric as JSON or CSV, optionally filtered by country and parent dataverse." operationId: Metrics_getMakeDataCountMetricTimeSeries parameters: - name: metric in: path description: Make Data Count metric name to return. required: true schema: type: string - name: country in: query description: ISO country code used to filter the metric. schema: type: string - name: parentAlias in: query description: Alias of a released parent dataverse used to scope the metric. schema: type: string responses: "200": description: OK /info/metrics/makeDataCount/{metric}/toMonth/{yyyymm}: get: tags: - Info summary: Calculates a Make Data Count metric through a month description: "Calculates the requested Make Data Count metric through the specified\ \ month, optionally filtered by country and parent dataverse." operationId: Metrics_getMakeDataCountMetricToMonth parameters: - name: metric in: path description: Make Data Count metric name to return. required: true schema: type: string - name: yyyymm in: path description: "Year and month cutoff for the metric, formatted as YYYYMM." required: true schema: type: string - name: country in: query description: ISO country code used to filter the metric. schema: type: string - name: parentAlias in: query description: Alias of a released parent dataverse used to scope the metric. schema: type: string responses: "200": description: OK /info/metrics/tree: get: tags: - Info summary: Calculates the dataverse tree metric description: "Calculates the released dataverse tree metric through the current\ \ month, optionally scoped to a released parent dataverse." operationId: Metrics_getDataversesTree parameters: - name: parentAlias in: query description: Alias of a released parent dataverse used to scope the metric. schema: type: string responses: "200": description: OK /info/metrics/tree/toMonth/{yyyymm}: get: tags: - Info summary: Calculates the dataverse tree metric through a month description: "Calculates the released dataverse tree metric through the specified\ \ month, optionally scoped to a released parent dataverse." operationId: Metrics_getDataversesTreeToMonth parameters: - name: yyyymm in: path description: "Year and month cutoff for the metric, formatted as YYYYMM." required: true schema: type: string - name: parentAlias in: query description: Alias of a released parent dataverse used to scope the metric. schema: type: string responses: "200": description: OK /info/metrics/uniquedownloads: get: tags: - Info summary: Calculates unique dataset download counts description: "Calculates unique dataset download counts through the current\ \ month as JSON or CSV, optionally scoped to a released parent dataverse." operationId: Metrics_getUniqueDownloadsAllTime parameters: - name: parentAlias in: query description: Alias of a released parent dataverse used to scope the metric. schema: type: string responses: "200": description: OK /info/metrics/uniquedownloads/monthly: get: tags: - Info summary: Calculates monthly unique dataset download counts description: "Calculates a monthly time series of unique dataset download counts\ \ as JSON or CSV, optionally scoped to a released parent dataverse." operationId: Metrics_getUniqueDownloadsTimeSeries parameters: - name: parentAlias in: query description: Alias of a released parent dataverse used to scope the metric. schema: type: string responses: "200": description: OK /info/metrics/uniquedownloads/toMonth/{yyyymm}: get: tags: - Info summary: Calculates unique dataset download counts through a month description: "Calculates unique dataset download counts through the specified\ \ month as JSON or CSV, optionally scoped to a released parent dataverse." operationId: Metrics_getUniqueDownloadsToMonth parameters: - name: yyyymm in: path description: "Year and month cutoff for the metric, formatted as YYYYMM." required: true schema: type: string - name: parentAlias in: query description: Alias of a released parent dataverse used to scope the metric. schema: type: string responses: "200": description: OK /info/metrics/uniquefiledownloads: get: tags: - Info summary: Calculates unique file download counts description: "Calculates unique file download counts by file through the current\ \ month as JSON or CSV, optionally scoped to a released parent dataverse." operationId: Metrics_getUniqueFileDownloadsAllTime parameters: - name: parentAlias in: query description: Alias of a released parent dataverse used to scope the metric. schema: type: string responses: "200": description: OK /info/metrics/uniquefiledownloads/monthly: get: tags: - Info summary: Calculates monthly unique file download counts description: "Calculates a monthly time series of unique file download counts\ \ by file as JSON or CSV, optionally scoped to a released parent dataverse." operationId: Metrics_getUniqueFileDownloadsTimeSeries parameters: - name: parentAlias in: query description: Alias of a released parent dataverse used to scope the metric. schema: type: string responses: "200": description: OK /info/metrics/uniquefiledownloads/toMonth/{yyyymm}: get: tags: - Info summary: Calculates unique file download counts through a month description: "Calculates unique file download counts by file through the specified\ \ month as JSON or CSV, optionally scoped to a released parent dataverse." operationId: Metrics_getUniqueFileDownloadsToMonth parameters: - name: yyyymm in: path description: "Year and month cutoff for the metric, formatted as YYYYMM." required: true schema: type: string - name: parentAlias in: query description: Alias of a released parent dataverse used to scope the metric. schema: type: string responses: "200": description: OK /info/server: get: tags: - Info summary: Returns the server name description: Returns the configured fully qualified domain name for this Dataverse installation. operationId: Info_getServer responses: "200": description: OK /info/settings/:DatasetPublishPopupCustomText: get: tags: - Info summary: Returns dataset publish popup text description: Returns the custom text shown in the dataset publish popup when the setting is configured. operationId: Info_getDatasetPublishPopupCustomText responses: "200": description: OK /info/settings/:DatasetSubmitForReviewPopupCustomText: get: tags: - Info summary: Returns dataset review popup text description: Returns the custom text shown when a dataset is submitted for review and the setting is configured. operationId: Info_DatasetSubmitForReviewPopupCustomText responses: "200": description: OK /info/settings/:MaxEmbargoDurationInMonths: get: tags: - Info summary: Returns the maximum embargo duration description: Returns the configured maximum embargo duration in months when the setting is configured. operationId: Info_getMaxEmbargoDurationInMonths responses: "200": description: OK /info/settings/:PublishDatasetDisclaimerText: get: tags: - Info summary: Returns dataset publish disclaimer text description: Returns the disclaimer text shown during dataset publication when the setting is configured. operationId: Info_getPublishDatasetDisclaimerText responses: "200": description: OK /info/settings/:SubmitForReviewDatasetDisclaimerText: get: tags: - Info summary: Returns dataset review disclaimer text description: Returns the disclaimer text shown when a dataset is submitted for review and the setting is configured. operationId: Info_getSubmitForReviewDatasetDisclaimerText responses: "200": description: OK /info/settings/customization/{customizationFileType}: get: tags: - Info summary: Returns a customization file description: Returns the configured customization file for the requested customization type. operationId: Info_getCustomizationFile parameters: - name: customizationFileType in: path description: Customization file type to retrieve. required: true schema: type: string responses: "200": description: OK /info/settings/incompleteMetadataViaApi: get: tags: - Info summary: Returns incomplete metadata API policy description: Returns whether API requests may create or update datasets with incomplete metadata. operationId: Info_getAllowsIncompleteMetadata responses: "200": description: OK /info/version: get: tags: - Info summary: Returns version and build information description: Returns the Dataverse application version and build identifier. operationId: Info_getInfo responses: "200": description: Version and build information /info/zipDownloadLimit: get: tags: - Info summary: Returns the ZIP download limit description: Returns the configured maximum size for ZIP downloads in bytes. operationId: Info_getZipDownloadLimit responses: "200": description: OK /licenses: get: tags: - Licenses summary: Lists licenses description: Returns all configured licenses as JSON. operationId: Licenses_getLicenses responses: "200": description: OK post: tags: - Licenses summary: Creates a license description: Creates a license when the authenticated user is a superuser and returns the created license location. operationId: Licenses_addLicense requestBody: description: "License definition to persist, including name, URI, active state,\ \ and sort order." content: application/json: schema: description: License definition accepted by the license administration API. type: object responses: "201": description: License created with a Location header pointing to the new license. security: - DataverseApiKey: [] /licenses/default: get: tags: - Licenses summary: Returns the default license description: Returns the numeric id of the configured default license. operationId: Licenses_getDefault responses: "200": description: OK /licenses/default/{id}: put: tags: - Licenses summary: Sets the default license description: Sets the specified license as the default when the authenticated user is a superuser. operationId: Licenses_setDefault parameters: - name: id in: path description: Numeric id of the license to make default. required: true schema: format: int64 type: integer responses: "200": description: OK security: - DataverseApiKey: [] /licenses/{id}: get: tags: - Licenses summary: Returns a license description: Returns the configured license with the specified numeric id. operationId: Licenses_getLicenseById parameters: - name: id in: path description: Numeric id of the license to return. required: true schema: format: int64 type: integer responses: "200": description: OK delete: tags: - Licenses summary: Deletes a license description: Deletes a non-default license when the authenticated user is a superuser. operationId: Licenses_deleteLicenseById parameters: - name: id in: path description: Numeric id of the license to delete. required: true schema: format: int64 type: integer responses: "200": description: OK security: - DataverseApiKey: [] /licenses/{id}/:active/{activeState}: put: tags: - Licenses summary: Sets license active state description: Updates whether the specified license is active when the authenticated user is a superuser. operationId: Licenses_setActiveState parameters: - name: activeState in: path description: New active state for the license. required: true schema: type: boolean - name: id in: path description: Numeric id of the license to update. required: true schema: format: int64 type: integer responses: "200": description: OK security: - DataverseApiKey: [] /licenses/{id}/:sortOrder/{sortOrder}: put: tags: - Licenses summary: Sets license sort order description: Updates the sort order for the specified license when the authenticated user is a superuser. operationId: Licenses_setSortOrder parameters: - name: id in: path description: Numeric id of the license to update. required: true schema: format: int64 type: integer - name: sortOrder in: path description: New sort order value for the license. required: true schema: format: int64 type: integer responses: "200": description: OK security: - DataverseApiKey: [] /localcontexts/datasets/{id}: get: tags: - Datasets summary: Finds Local Contexts projects for a dataset description: Queries the configured Local Contexts service by dataset DOI and returns matching project information when the requester is allowed to inspect the dataset. operationId: LocalContexts_getDatasetLocalContexts parameters: - name: id in: path description: Dataset id or persistent identifier whose DOI is sent to Local Contexts. required: true schema: type: string responses: "200": description: OK security: - DataverseApiKey: [] /localcontexts/datasets/{id}/{projectId}: get: tags: - Datasets summary: Returns a Local Contexts project description: Returns a Local Contexts project only when the project response includes a DOI matching the specified dataset. operationId: LocalContexts_searchLocalContexts parameters: - name: id in: path description: Dataset id or persistent identifier used to validate the Local Contexts project DOI. required: true schema: type: string - name: projectId in: path description: Local Contexts project id to retrieve. required: true schema: type: string responses: "200": description: OK /logout: post: tags: - Users summary: Logs out the current session description: Clears the authenticated session-cookie user when API session authentication is enabled. operationId: Logout_logout responses: "200": description: OK /mail/notifications: get: tags: - Admin summary: Reports deprecated bulk notification status description: Logs the deprecated bulk notification request and returns a message indicating that bulk notification sending is deprecated. operationId: Mail_sendMail responses: "200": description: OK /metadatablocks: get: tags: - Metadata summary: Lists metadata blocks description: "Returns metadata blocks as JSON, optionally limited to blocks\ \ displayed during dataset creation and optionally including dataset field\ \ types." operationId: MetadataBlocks_listMetadataBlocks parameters: - name: onlyDisplayedOnCreate in: query description: Limit results to metadata blocks displayed during dataset creation. schema: type: boolean - name: returnDatasetFieldTypes in: query description: Include dataset field type definitions in each metadata block. schema: type: boolean responses: "200": description: OK /metadatablocks/{identifier}: get: tags: - Metadata summary: Returns a metadata block description: "Returns the metadata block identified by id, name, or display\ \ name." operationId: MetadataBlocks_getMetadataBlock parameters: - name: identifier in: path description: "Metadata block id, name, or display name." required: true schema: type: string responses: "200": description: OK /mydata/retrieve: get: tags: - Users summary: Retrieves My Data results description: "Returns datasets, files, and collections visible to the requester\ \ with filters for object type, publication state, role, validity, search\ \ text, and pagination." operationId: DataRetrieverAPI_retrieveMyDataAsJsonString parameters: - name: dataset_valid in: query description: Dataset validity filter. schema: type: array items: type: boolean - name: dvobject_types in: query description: Dataverse object type filters. schema: type: array items: $ref: '#/components/schemas/DType' - name: filter_validities in: query description: Validity filters for My Data results. schema: type: boolean - name: fq in: query description: Filter query. schema: type: array items: type: string - name: metadata_fields in: query description: Metadata fields to include. schema: type: array items: type: string - name: mydata_search_term in: query description: Search term for My Data results. schema: type: string - name: order in: query description: Sort order. schema: type: string - name: published_states in: query description: Publication state filters. schema: type: array items: type: string - name: role_ids in: query description: Role id filters. schema: type: array items: format: int64 type: integer - name: selected_page in: query description: Selected results page. schema: format: int32 type: integer - name: show_collections in: query description: Whether collection results are included. schema: type: boolean - name: sort in: query description: Sort field. schema: type: string - name: userIdentifier in: query description: User identifier filter. schema: type: string responses: "200": description: OK content: application/json: schema: type: string security: - DataverseApiKey: [] /mydata/retrieve/collectionList: get: tags: - Users summary: Lists collections for My Data description: Returns collections where the requester or selected user may add datasets. operationId: DataRetrieverAPI_retrieveMyCollectionList parameters: - name: userIdentifier in: query description: User identifier filter. schema: type: string responses: "200": description: OK security: - DataverseApiKey: [] /notifications/all: get: tags: - Notifications summary: Lists user notifications description: "Returns notifications for the authenticated user with optional\ \ unread filtering, formatting, and pagination." operationId: Notifications_getAllNotificationsForUser parameters: - name: inAppNotificationFormat in: query description: Format notifications for in-app display. schema: type: boolean - name: limit in: query description: Maximum number of notifications to return. schema: format: int32 type: integer - name: offset in: query description: Number of notifications to skip before returning results. schema: format: int32 type: integer - name: onlyUnread in: query description: Limit results to unread notifications. schema: type: boolean responses: "200": description: OK security: - DataverseApiKey: [] /notifications/mutedEmails: get: tags: - Notifications summary: Lists muted notification emails description: Returns notification types whose emails are muted for the authenticated user. operationId: Notifications_getMutedEmailsForUser responses: "200": description: OK security: - DataverseApiKey: [] /notifications/mutedEmails/{typeName}: put: tags: - Notifications summary: Mutes notification emails description: Adds the specified notification type to the authenticated user's muted email preferences. operationId: Notifications_muteEmailsForUser parameters: - name: typeName in: path description: Notification type name whose emails are muted. required: true schema: type: string responses: "200": description: OK security: - DataverseApiKey: [] delete: tags: - Notifications summary: Unmutes notification emails description: Removes the specified notification type from the authenticated user's muted email preferences. operationId: Notifications_unmuteEmailsForUser parameters: - name: typeName in: path description: Notification type name whose emails are unmuted. required: true schema: type: string responses: "200": description: OK security: - DataverseApiKey: [] /notifications/mutedNotifications: get: tags: - Notifications summary: Lists muted in-app notifications description: Returns notification types whose in-app notifications are muted for the authenticated user. operationId: Notifications_getMutedNotificationsForUser responses: "200": description: OK security: - DataverseApiKey: [] /notifications/mutedNotifications/{typeName}: put: tags: - Notifications summary: Mutes in-app notifications description: Adds the specified notification type to the authenticated user's muted in-app notification preferences. operationId: Notifications_muteNotificationsForUser parameters: - name: typeName in: path description: Notification type name whose in-app notifications are muted. required: true schema: type: string responses: "200": description: OK security: - DataverseApiKey: [] delete: tags: - Notifications summary: Unmutes in-app notifications description: Removes the specified notification type from the authenticated user's muted in-app notification preferences. operationId: Notifications_unmuteNotificationsForUser parameters: - name: typeName in: path description: Notification type name whose in-app notifications are unmuted. required: true schema: type: string responses: "200": description: OK security: - DataverseApiKey: [] /notifications/unreadCount: get: tags: - Notifications summary: Returns unread notification count description: Returns the number of unread notifications for the authenticated user. operationId: Notifications_getUnreadNotificationsCountForUser responses: "200": description: OK security: - DataverseApiKey: [] /notifications/{id}: delete: tags: - Notifications summary: Deletes a notification description: Deletes one notification when it belongs to the authenticated user. operationId: Notifications_deleteNotificationForUser parameters: - name: id in: path description: Notification id to delete. required: true schema: format: int64 type: integer responses: "200": description: OK security: - DataverseApiKey: [] /notifications/{id}/markAsRead: put: tags: - Notifications summary: Marks a notification as read description: Marks one notification as read when it belongs to the authenticated user. operationId: Notifications_markNotificationAsReadForUser parameters: - name: id in: path description: Notification id to mark as read. required: true schema: format: int64 type: integer responses: "200": description: OK security: - DataverseApiKey: [] /pids: get: tags: - Admin summary: Returns PID provider metadata description: Queries configured DataCite metadata for the supplied persistent identifier when the requester is a superuser. operationId: Pids_getPid parameters: - name: persistentId in: query description: Persistent identifier to query. schema: type: string responses: "200": description: OK security: - DataverseApiKey: [] /pids/providers: get: tags: - Admin summary: Lists PID providers description: Returns the configured persistent identifier providers. operationId: Pids_getPidProviders responses: "200": description: OK security: - DataverseApiKey: [] /pids/providers/{persistentId}: get: tags: - Admin summary: Returns the provider for a PID description: Parses a persistent identifier and returns the managed provider id or reports that the PID belongs to an unmanaged provider. operationId: Pids_getPidProviderId parameters: - name: persistentId in: path description: Persistent identifier whose provider is requested. required: true schema: pattern: .+ type: string responses: "200": description: OK security: - DataverseApiKey: [] /pids/unreserved: get: tags: - Admin summary: Lists unreserved dataset PIDs description: Returns draft datasets whose persistent identifiers have not been reserved when the requester is a superuser. operationId: Pids_getUnreserved parameters: - name: persistentId in: query description: Optional persistent identifier value accepted by the endpoint. schema: type: string responses: "200": description: OK security: - DataverseApiKey: [] /pids/{id}/delete: delete: tags: - Admin summary: Deletes a draft dataset PID description: Deletes the persistent identifier for an unpublished dataset. operationId: Pids_deletePid parameters: - name: id in: path description: Dataset id or persistent identifier whose PID is deleted. required: true schema: type: string responses: "200": description: OK security: - DataverseApiKey: [] /pids/{id}/reserve: post: tags: - Admin summary: Reserves a dataset PID description: Reserves the persistent identifier for the specified dataset. operationId: Pids_reservePid parameters: - name: id in: path description: Dataset id or persistent identifier whose PID is reserved. required: true schema: type: string responses: "200": description: OK security: - DataverseApiKey: [] /roles: post: tags: - Roles summary: Creates a role description: Creates a role definition in the specified dataverse and returns the saved role. operationId: Roles_createNewRole parameters: - name: dvo in: query description: Dataverse identifier where the role is created. required: true schema: type: string requestBody: description: "Role definition containing alias, name, permissions, and role\ \ metadata." content: '*/*': schema: $ref: '#/components/schemas/RoleDTO' responses: "200": description: OK security: - DataverseApiKey: [] /roles/userSelectable: get: tags: - Roles summary: Lists selectable roles description: Returns dataverse roles that the authenticated requester can select for role assignment. operationId: Roles_getUserSelectableRoles responses: "200": description: OK security: - DataverseApiKey: [] /roles/{id}: get: tags: - Roles summary: Returns a role description: Returns a role definition when the authenticated user can manage permissions on the role owner. operationId: Roles_viewRole parameters: - name: id in: path description: Role id or alias to return. required: true schema: type: string responses: "200": description: OK security: - DataverseApiKey: [] delete: tags: - Roles summary: Deletes a role description: Deletes a non-builtin role definition from its owner dataverse. operationId: Roles_deleteRole parameters: - name: id in: path description: Role id or alias to delete. required: true schema: type: string responses: "200": description: OK security: - DataverseApiKey: [] /search: get: tags: - Search summary: Searches Dataverse content description: "Searches dataverses, datasets, and files using query text, type\ \ filters, subtree filters, facets, sorting, and pagination options." operationId: Search_search parameters: - name: fq in: query description: Filter query. schema: type: array items: type: string - name: geo_point in: query description: Geographic point used for spatial search. schema: type: string - name: geo_radius in: query description: Geographic radius used for spatial search. schema: type: string - name: metadata_fields in: query description: Metadata fields to include. schema: type: array items: type: string - name: order in: query description: Sort order. schema: type: string - name: per_page in: query description: Number of results to return per page. schema: format: int32 type: integer - name: q in: query description: Search query string. schema: type: string - name: query_entities in: query description: Whether search queries entity fields. schema: default: true type: boolean - name: search_service in: query description: Search service name to use. schema: type: string - name: show_api_urls in: query description: Whether API URLs are included. schema: type: boolean - name: show_collections in: query description: Whether collection results are included. schema: type: boolean - name: show_entity_ids in: query description: Whether entity ids are included. schema: type: boolean - name: show_facets in: query description: Whether facet counts are included. schema: type: boolean - name: show_relevance in: query description: Whether relevance scores are included. schema: type: boolean - name: show_type_counts in: query description: Whether object type counts are included. schema: type: boolean - name: sort in: query description: Sort field. schema: type: string - name: start in: query description: Result offset. schema: format: int32 type: integer - name: subtree in: query description: Dataverse subtree alias filter. schema: type: array items: type: string - name: type in: query description: Resource type filter. schema: type: array items: type: string responses: "200": description: OK security: - DataverseApiKey: [] /search/services: get: tags: - Search summary: Lists search services description: "Returns the configured search service names, display names, and\ \ the default search service." operationId: Search_getSearchEngines responses: "200": description: OK /sendfeedback: post: tags: - Users summary: Submits feedback description: Sends a feedback email to contacts for a target object or to the support address after validating the sender and message body. operationId: SendFeedbackAPI_submitFeedback requestBody: description: "Feedback JSON with subject, body, optional sender email, and\ \ an optional target id or identifier." content: '*/*': schema: type: string responses: "200": description: OK security: - DataverseApiKey: [] /users/:me: get: tags: - Users summary: Returns the authenticated user description: Returns the authenticated user associated with the supplied API token or active API session. operationId: Users_getAuthenticatedUserByToken responses: "200": description: OK security: - DataverseApiKey: [] /users/register: post: tags: - Users summary: Registers an OIDC user description: Registers an OIDC user from the supplied user JSON when API bearer authentication is enabled and a bearer token is present. operationId: Users_registerOIDCUser requestBody: description: User JSON parsed into a new authenticated OIDC user registration. content: '*/*': schema: type: string responses: "200": description: OK /users/token: get: tags: - Users summary: Returns the current user's API token expiration description: Returns the authenticated user's API token string and expiration time. operationId: Users_getTokenExpirationDate responses: "200": description: OK security: - DataverseApiKey: [] delete: tags: - Users summary: Deletes the current user's API token description: Removes the API token for the authenticated user. operationId: Users_deleteToken responses: "200": description: OK security: - DataverseApiKey: [] /users/token/recreate: post: tags: - Users summary: Recreates the current user's API token description: "Deletes the authenticated user's existing API token, creates a\ \ new token, and optionally includes its expiration time in the response." operationId: Users_recreateToken parameters: - name: returnExpiration in: query description: Include the new token expiration time in the response. schema: type: boolean responses: "200": description: OK security: - DataverseApiKey: [] /users/{consumedIdentifier}/mergeIntoUser/{baseIdentifier}: post: tags: - Users summary: Merges one user account into another description: Moves account data from one authenticated user into another when the requester is a superuser. operationId: Users_mergeInAuthenticatedUser parameters: - name: baseIdentifier in: path description: Identifier of the authenticated user account that receives the merged account data. required: true schema: type: string - name: consumedIdentifier in: path description: Identifier of the authenticated user account whose data is merged into another account. required: true schema: type: string responses: "200": description: OK security: - DataverseApiKey: [] /users/{identifier}/allowedCollections/{permission}: get: tags: - Users summary: Lists collections permitted for a user description: Returns collections where the specified user has the requested permission when the requester is that user or a superuser. operationId: Users_getUserPermittedCollections parameters: - name: identifier in: path description: Authenticated user identifier whose permitted collections are returned. required: true schema: type: string - name: permission in: path description: Permission name used to select permitted collections. required: true schema: type: string responses: "200": description: OK security: - DataverseApiKey: [] /users/{identifier}/changeIdentifier/{newIdentifier}: post: tags: - Users summary: Changes a user identifier description: Changes an authenticated user's identifier when the requester is a superuser. operationId: Users_changeAuthenticatedUserIdentifier parameters: - name: identifier in: path description: Current authenticated user identifier. required: true schema: type: string - name: newIdentifier in: path description: New authenticated user identifier to assign. required: true schema: type: string responses: "200": description: OK security: - DataverseApiKey: [] /users/{identifier}/removeRoles: post: tags: - Users summary: Removes all roles from a user description: Revokes all role assignments for the specified authenticated user. operationId: Users_removeUserRoles parameters: - name: identifier in: path description: Authenticated user identifier whose role assignments are removed. required: true schema: type: string responses: "200": description: OK security: - DataverseApiKey: [] /users/{identifier}/traces: get: tags: - Users summary: Returns user traces description: "Returns trace information showing where the specified authenticated\ \ user appears across role assignments, groups, datasets, files, guestbooks,\ \ and saved searches." operationId: Users_getTraces parameters: - name: identifier in: path description: Authenticated user identifier whose traces are returned. required: true schema: type: string responses: "200": description: OK security: - DataverseApiKey: [] /users/{identifier}/traces/{element}: get: tags: - Users summary: Returns a user trace element description: Returns one category of trace information for the specified authenticated user as JSON or CSV. operationId: Users_getTracesElement parameters: - name: element in: path description: "Trace category to return, such as roleAssignments, explicitGroups,\ \ guestbookEntries, or savedSearches." required: true schema: type: string - name: identifier in: path description: Authenticated user identifier whose trace element is returned. required: true schema: type: string responses: "200": description: OK security: - DataverseApiKey: [] /workflows/{invocationId}: post: tags: - Workflows summary: Resumes a pending workflow description: Accepts the result body from an external workflow step and resumes the pending workflow invocation when the caller IP address is allowed. operationId: Workflows_resumeWorkflow parameters: - name: invocationId in: path description: Identifier of the pending workflow invocation to resume. required: true schema: type: string responses: "200": description: OK components: schemas: AuthenticatedUserDisplayInfo: description: "Display profile for an authenticated user, including name, contact,\ \ affiliation, position, and ORCID information." required: - lastName - firstName type: object properties: title: type: string emailAddress: type: string affiliation: type: string lastName: pattern: \S type: string firstName: pattern: \S type: string position: type: string orcid: type: string orcidForDisplay: type: string AuthenticationProviderRow: description: "Persisted authentication provider configuration, including provider\ \ id, display text, factory alias, enabled state, and factory data." type: object properties: id: type: string title: type: string subtitle: type: string factoryAlias: type: string enabled: type: boolean factoryData: type: string BuiltinUser: description: Built-in Dataverse user account payload used for local username and password authentication. type: object properties: id: format: int64 type: integer userName: type: string passwordEncryptionVersion: format: int32 type: integer passwordResetData: $ref: '#/components/schemas/PasswordResetData' encryptedPassword: type: string email: type: string firstName: type: string lastName: type: string affiliation: type: string position: type: string displayInfoForApiCreation: type: object allOf: - $ref: '#/components/schemas/AuthenticatedUserDisplayInfo' deprecated: true CustomTermsDTO: description: "Custom dataset terms of access payload, including use terms, restrictions,\ \ citation requirements, conditions, and disclaimer text." type: object properties: termsOfUse: type: string confidentialityDeclaration: type: string specialPermissions: type: string restrictions: type: string citationRequirements: type: string depositorRequirements: type: string conditions: type: string disclaimer: type: string DType: description: "Dataverse object type discriminator for dataverses, datasets,\ \ and data files." enum: - Dataverse - Dataset - DataFile type: string ExplicitGroupDTO: description: "Explicit group update payload with display name, description,\ \ and owner-local alias." type: object properties: description: type: string displayName: type: string aliasInOwner: type: string LicenseUpdateRequest: description: Dataset or template license update payload with either a license name or custom terms. type: object properties: name: type: string customTerms: $ref: '#/components/schemas/CustomTermsDTO' PasswordResetData: description: Password reset token data used during built-in user account recovery and password compliance flows. type: object properties: id: format: int64 type: integer token: type: string created: type: object expires: type: object reason: $ref: '#/components/schemas/Reason1' expired: type: boolean Reason: description: Dataset lock reason indicating why dataset editing or publication is blocked. enum: - Ingest - Workflow - InReview - DcmUpload - GlobusUpload - finalizePublication - EditInProgress - FileValidationFailed type: string Reason1: description: Reason a password reset token was created. enum: - FORGOT_PASSWORD - NON_COMPLIANT_PASSWORD - UPGRADE_REQUIRED type: string RoleAssignmentDTO: description: Role assignment payload identifying the assignee and the role alias. type: object properties: assignee: type: string role: type: string RoleDTO: description: "Dataverse role definition payload with alias, display name, description,\ \ owner, and permissions." type: object properties: alias: type: string name: type: string description: type: string ownerId: type: string permissions: type: array items: type: string securitySchemes: DataverseApiKey: type: apiKey description: Dataverse API token. name: X-Dataverse-key in: header