data-repository-service-schemas
Data Repository Service (DRS) API
develop branch status: 
The Global Alliance for Genomics and Health (GA4GH) is an international coalition, formed to enable the sharing of genomic and clinical data.
About the GA4GH Cloud Work Stream
The GA4GH Cloud Work Stream helps the genomics and health communities take full advantage of modern cloud environments. Our initial focus is on “bringing the algorithms to the data”, by creating standards for defining, sharing, and executing portable workflows.
We work with platform development partners and industry leaders to develop standards that will facilitate interoperability.
What is DRS?
The Data Repository Service (DRS) API provides a generic interface to data repositories so data consumers, including workflow systems, can access data in a single, standardized way regardless of where it’s stored or how it’s managed. The primary functionality of DRS is to map a logical ID to a means for physically retrieving the data represented by the ID.
For more information see our HTML documentation links in the table below.
API Definition
| Branch | Reference Documentation | Swagger Editor |
|---|---|---|
| develop: the stable development branch, into which feature branches are merged | HTML | Swagger Editor |
| release 1.5.0: The 1.5.0 release of DRS adds fields for indicating cold storage, explict cloud locations, object count and size metadata, and best practice guidance for using GA4GH Data Connect with DRS. | HTML | Swagger Editor |
| release 1.4.0: The 1.4.0 release of DRS adds bulk operations. | HTML | Swagger Editor |
| release 1.3.0: The 1.3.0 release of DRS adds the ability to use the options request method to return the auth issuers for a specific DRS object. | HTML | Swagger Editor |
release 1.2.0: The 1.2.0 release of DRS adds the standardized /service-info endpoint, and 2 POST endpoints that are functionally equivalent to the current GET endpoints, but they enable the submission of large passport tokens in the request body. |
HTML | Swagger Editor |
| release 1.1.0: The 1.1.0 release of DRS that includes no API changes only documentation changes. This introduces a new URI convention using compact identifiers along with clear directions on how to use identifiers.org/n2t.net to resolve them. | HTML | Swagger Editor |
| release 1.0.0: The 1.0.0 release of DRS that is now an approved GA4GH standard | HTML | Swagger Editor |
| release 0.1: Simplifying DRS to core functionality | HTML | Swagger Editor |
| release 0.0.1: The initial DRS after the rename from DOS | HTML | Swagger Editor |
To monitor development work on various branches, add ‘preview/<branch-name>’ to the master URLs above (e.g., https://ga4gh.github.io/data-repository-service-schemas/preview/<branch-name>/docs).
How to Contribute Changes
See CONTRIBUTING.md.
If a security issue is identified with the specification, please send an email to security-notification@ga4gh.org detailing your concerns.
License
See the LICENSE.