API Guide
Contents:
- Introduction
- Getting Started with APIs
- API Tokens and Authentication
- Search API
- Data Access API
- Native API
- Dataverse Collections
- Create a Dataverse Collection
- Update a Dataverse Collection
- View a Dataverse Collection
- Delete a Dataverse Collection
- Show Contents of a Dataverse Collection
- Report the data (file) size of a Dataverse Collection
- List Roles Defined in a Dataverse Collection
- List Facets Configured for a Dataverse Collection
- Set Facets for a Dataverse Collection
- List Metadata Block Facets Configured for a Dataverse Collection
- List Field Type Input Levels Configured for a Dataverse Collection
- Set Metadata Block Facets for a Dataverse Collection
- Configure a Dataverse Collection to Inherit Its Metadata Block Facets from Its Parent
- Create a New Role in a Dataverse Collection
- List Role Assignments in a Dataverse Collection
- Assign Default Role to User Creating a Dataset in a Dataverse Collection
- Assign a New Role on a Dataverse Collection
- Delete Role Assignment from a Dataverse Collection
- List Metadata Blocks Defined on a Dataverse Collection
- Define Metadata Blocks for a Dataverse Collection
- Determine if a Dataverse Collection Inherits Its Metadata Blocks from Its Parent
- Configure a Dataverse Collection to Inherit Its Metadata Blocks from Its Parent
- Retrieve a Dataset JSON Schema for a Collection
- Validate Dataset JSON File for a Collection
- List Featured Collections for a Dataverse Collection
- Set Featured Collections for a Dataverse Collection
- Remove Featured Collections from a Dataverse Collection
- Get User Permissions on a Dataverse
- Create a Dataset in a Dataverse Collection
- Import a Dataset into a Dataverse Collection
- Import a Dataset into a Dataverse Installation with a DDI file
- Publish a Dataverse Collection
- Retrieve Guestbook Responses for a Dataverse Collection
- Change Collection Attributes
- Update Collection Input Levels
- Collection Storage Quotas
- Datasets
- Dataset Version Specifiers
- Get JSON Representation of a Dataset
- List Versions of a Dataset
- Get Version of a Dataset
- Export Metadata of a Dataset in Various Formats
- List Files in a Dataset
- Get File Counts in a Dataset
- View Dataset Files and Folders as a Directory Index
- List All Metadata Blocks for a Dataset
- List Single Metadata Block for a Dataset
- Compare Versions of a Dataset
- Update Metadata For a Dataset
- Edit Dataset Metadata
- Delete Dataset Metadata
- Publish a Dataset
- Delete Dataset Draft
- Deaccession Dataset
- Set Citation Date Field Type for a Dataset
- Revert Citation Date Field Type to Default for Dataset
- List Role Assignments in a Dataset
- Assign a New Role on a Dataset
- Delete Role Assignment from a Dataset
- Create a Preview URL for a Dataset
- Get the Preview URL for a Dataset
- Delete the Preview URL from a Dataset
- Add a File to a Dataset
- Add a Remote File to a Dataset
- Cleanup Storage of a Dataset
- Adding Files To a Dataset via Other Tools
- Report the data (file) size of a Dataset
- Get the size of Downloading all the files of a Dataset Version
- Submit a Dataset for Review
- Return a Dataset to Author
- Link a Dataset
- Dataset Locks
- Dataset Metrics
- Delete Unpublished Dataset
- Delete Published Dataset
- Configure a Dataset to Use a Specific File Store
- View the Timestamps on a Dataset
- Set an Embargo on Files in a Dataset
- Remove an Embargo on Files in a Dataset
- Set a Retention Period on Files in a Dataset
- Remove a Retention Period on Files in a Dataset
- Get the Archival Status of a Dataset By Version
- Set the Archival Status of a Dataset By Version
- Delete the Archival Status of a Dataset By Version
- Get External Tool Parameters
- Retrieve Signposting Information
- Get Dataset By Preview URL Token
- Get Citation
- Get Citation by Preview URL Token
- Get Summary Field Names
- Configure When a Dataset Guestbook Appears (If Enabled)
- Get User Permissions on a Dataset
- Know If a User Can Download at Least One File from a Dataset Version
- Configure The PID Generator a Dataset Uses (If Enabled)
- Dataset Types
- Files
- Get JSON Representation of a File
- Get JSON Representation of a File given a Dataset Version
- Adding Files
- Accessing (downloading) files
- Restrict Files
- Uningest a File
- Reingest a File
- Redetect File Type
- Extract NcML
- Replacing Files
- Deleting Files
- Getting File Metadata
- Getting File Data Tables
- Getting File Download Count
- File Has Been Deleted
- Updating File Metadata
- Updating File Metadata Categories
- Updating File Tabular Tags
- Editing Variable Level Metadata
- Get File Citation as JSON
- Provenance
- Datafile Integrity
- Get External Tool Parameters
- Get Fixity Algorithm
- Users Token Management
- Builtin Users
- Roles
- Explicit Groups
- Create New Explicit Group
- List Explicit Groups in a Dataverse Collection
- Show Single Group in a Dataverse Collection
- Update Group in a Dataverse Collection
- Delete Group from a Dataverse Collection
- Add Multiple Role Assignees to an Explicit Group
- Add a Role Assignee to an Explicit Group
- Remove a Role Assignee from an Explicit Group
- Shibboleth Groups
- Info
- Metadata Blocks
- Dataset Fields
- Notifications
- User Information
- Managing Harvesting Server and Sets
- Managing Harvesting Clients
- PIDs
- Admin
- List All Database Settings
- Configure Database Setting
- Get Single Database Setting
- Delete Database Setting
- List All Feature Flags
- Show Feature Flag Status
- Manage Banner Messages
- List Authentication Provider Factories
- List Authentication Providers
- Add Authentication Provider
- Show Authentication Provider
- Enable or Disable an Authentication Provider
- Check If an Authentication Provider is Enabled
- Delete an Authentication Provider
- List Global Roles
- Create Global Role
- Delete Global Role
- List Users
- List Single User
- Create an Authenticated User
- Merge User Accounts
- Change User Identifier
- Toggle Superuser Status
- Set Superuser Status
- Delete a User
- Deactivate a User
- Show User Traces
- Remove All Roles from a User
- List Role Assignments of a Role Assignee
- List Permissions a User Has on a Dataverse Collection or Dataset
- Show Role Assignee
- Saved Search
- Dataset Integrity
- Datafile Integrity
- Physical Files Validation in a Dataset
- Update Checksums To Use New Algorithm
- Dataset Validation
- Datafile Audit
- Workflows
- Metrics
- Inherit Dataverse Collection Role Assignments
- Manage Available Standard License Terms
- List Dataset Templates
- Delete Dataset Template
- Request Signed URL
- Send Feedback To Contact(s)
- Reset Thumbnail Failure Flags
- Download File from /tmp
- MyData
- Dataverse Collections
- Metrics API
- SWORD API
- About
- Authentication for SWORD
- Backward incompatible changes
- New features as of v1.1
- curl examples
- Retrieve SWORD service document
- Create a dataset with an Atom entry
- List datasets in a Dataverse Collection
- Add files to a dataset with a zip file
- Display a dataset atom entry
- Display a dataset statement
- Delete a file by database id
- Replacing metadata for a dataset
- Delete a dataset
- Determine if a Dataverse Collection has been published
- Publish a Dataverse Collection
- Publish a dataset
- Known issues
- Bug fixes in v1.1
- Client libraries
- Client Libraries
- Building External Tools
- Dataset Curation Label API
- Linked Data Notification API
- Apps
- Frequently Asked Questions
- What is an API?
- What Are Common Use Cases for Dataverse Software APIs?
- Where Can I Find Examples of Using Dataverse Software APIs?
- When Should I Use the Native API vs. the SWORD API?
- To Operate on a Dataset Should I Use Its DOI (or Handle) or Its Database ID?
- Where is the Comprehensive List of All API Functionality?
- Is There a Changelog of API Functionality That Has Been Added Over Time?
- What Functionality is GUI Only and Not Available Via API
- Why Are the Return Values (HTTP Status Codes) Not Documented?
- What If My Question Is Not Answered Here?
- API Changelog (Breaking Changes)