Redivis Documentation
API DocumentationRedivis Home
  • Introduction
  • Redivis for open science
    • FAIR data practices
    • Open access
    • Data repository characteristics
    • Data retention policy
    • Citations
  • Guides
    • Getting started
    • Discover & access data
      • Discover datasets
      • Apply to access restricted data
      • Create a study
    • Analyze data in a workflow
      • Reshape data in transforms
      • Work with data in notebooks
      • Running ML workloads
      • Example workflows
        • Analyzing large tabular data
        • Create an image classification model
        • Fine tuning a Large Language Model (LLM)
        • No-code visualization
        • Continuous enrollment
        • Select first/last encounter
    • Export & publish your work
      • Export to other environments
      • Build your own site with Observable
    • Create & manage datasets
      • Create and populate a dataset
      • Upload tabular data as tables
      • Upload unstructured data as files
      • Cleaning tabular data
    • Administer an organization
      • Configure access systems
      • Grant access to data
      • Generate a report
      • Example tasks
        • Emailing subsets of members
    • Video guides
  • Reference
    • Your account
      • Creating an account
      • Managing logins
      • Single Sign-On (SSO)
      • Workspace
      • Studies
      • Compute credits and billing
    • Datasets
      • Documentation
      • Tables
      • Variables
      • Files
      • Creating & editing datasets
      • Uploading data
        • Tabular data
        • Geospatial data
        • Unstructured data
        • Metadata
        • Data sources
        • Programmatic uploads
      • Version control
      • Sampling
      • Exporting data
        • Download
        • Programmatic
        • Google Data Studio
        • Google Cloud Storage
        • Google BigQuery
        • Embedding tables
    • Workflows
      • Workflow concepts
      • Documentation
      • Data sources
      • Tables
      • Transforms
        • Transform concepts
        • Step: Aggregate
        • Step: Create variables
        • Step: Filter
        • Step: Join
        • Step: Limit
        • Step: Stack
        • Step: Order
        • Step: Pivot
        • Step: Rename
        • Step: Retype
        • Step: SQL query
        • Variable selection
        • Value lists
        • Optimization and errors
        • Variable creation methods
          • Common elements
          • Aggregate
          • Case (if/else)
          • Date
          • DateTime
          • Geography
          • JSON
          • Math
          • Navigation
          • Numbering
          • Other
          • Statistical
          • String
          • Time
      • Notebooks
        • Notebook concepts
        • Compute resources
        • Python notebooks
        • R notebooks
        • Stata notebooks
        • SAS notebooks
        • Using the Jupyter interface
      • Access and privacy
    • Data access
      • Access levels
      • Configuring access
      • Requesting access
      • Approving access
      • Usage rules
      • Data access in workflows
    • Organizations
      • Administrator panel
      • Members
      • Studies
      • Workflows
      • Datasets
      • Permission groups
      • Requirements
      • Reports
      • Logs
      • Billing
      • Settings and branding
        • Account
        • Public profile
        • Membership
        • Export environments
        • Advanced: DOI configuration
        • Advanced: Stata & SAS setup
        • Advanced: Data storage locations
        • Advanced: Data egress configuration
    • Institutions
      • Administrator panel
      • Organizations
      • Members
      • Datasets
      • Reports
      • Settings and branding
    • Quotas and limits
    • Glossary
  • Additional Resources
    • Events and press
    • API documentation
    • Redivis Labs
    • Office hours
    • Contact us
    • More information
      • Product updates
      • Roadmap
      • System status
      • Security
      • Feature requests
      • Report a bug
Powered by GitBook
On this page
  • Overview
  • Viewing access steps
  • Applying for membership
  • Applying for direct access
  • Member requirement approval
  • Study requirement approval
  • Notifications

Was this helpful?

Export as PDF
  1. Reference
  2. Data access

Requesting access

Last updated 5 months ago

Was this helpful?

Overview

As you explore Redivis, you will likely encounter restricted datasets that require approval before you can access their data. Data owners are provided broad flexibility in how they can configure dataset access — some datasets may be completely public, others might be hidden for almost everybody, and others will have a gradation of controls for .

Redivis aims to make it easy for administrators to make their data as open as possible, while making it the access application process transparent and straightforward for researchers.

For a guided walkthrough of applying for access, check out the .

Viewing access steps

Your current access level to any given dataset will be displayed prominently wherever you interact with the dataset, whether in search results, your workflows, or on the dataset's page. If you don't currently have data access, navigate to the dataset page and click the Apply for access button.

If a dataset is hidden (that is, it is restricted at the ), the dataset owner will need to first grant you overview access before you can request further access. You cannot apply for access to datasets which you cannot see.

If a dataset is unpublished, only dataset will be able to see its existence, and other users cannot apply for access until it is released.

Applying for membership

To apply for access to datasets hosted by a Redivis organization, you will first need to become a member of the organization.

Depending on the organization's configuration, your membership application will either be auto-approved or sent to an administrator for approval (you will receive an email as soon as an administrator has responded).

Applying for direct access

Direct access is the simplest access paradigm, and the only option available for datasets owned by a user (as opposed to an organization). To request direct access at a particular level, simply click Request and an administrator / owner of that dataset will respond to your request.

Member requirement approval

Member requirements must be approved once for the context of your relationship with an organization. Data administrators can create requirements with various types of form inputs to collect information about your access application — for example, whether you've completed the relevant trainings, or meet the institutional qualifications to work with the dataset. These requirements can also be set to auto-expire after a period of time (e.g., to re-up your training credentials).

To apply for a requirement, click the Apply button and fill out the fields in the requirement. When you submit the requirement, it will either be auto-approved or sent to an administrator for approval, depending on its configuration.

Study requirement approval

In order to apply for a requirement on behalf of a study, you must first select the study with which you want to apply. You can also create a new study, or if your collaborators already have study, you should ask them to add you to their study.

Once you have selected your study, you can apply for any study requirements just as you would for member requirements.

Notifications

As soon as someone responds to your request (e.g., approves, rejects, or comments on it), you will receive a notification on Redivis. You will also receive notifications whenever an approval is about to expire or when an approval is revoked.

Datasets owners have wide flexibility in how they can configure their dataset access controls, with the ability to mix various across different . However, when you begin the access application process, you will be provided with a clear series of steps necessary to gain each level of access. Note that you will need to access levels are cumulative — e.g., you will need to be approved for metadata access in order to gain data access, etc.

On this particular dataset, we need to request direct access to view metadata, fulfill a DUA requirement to gain access to the 1% sample, and be on a with an approved "IRB Approval" requirement to gain access to the complete data. Other datasets will likely look different, and can even have multiple requirements for each access level.

In becoming a member of the organization, you will need to provide about your institutional affiliation — it is through these credentials that you will be able to access restricted datasets within the organization. The organization will also be able to see certain public information from your Redivis account, including your name, ORCID iD, and link to publications, which can be configured in your .

Some requirements are fulfilled on behalf of a , rather than by each individual member of an organization. This allows data administrators to collect information only once for a particular research effort — for example, to gather information about grant funding or IRB approval.

If you are approved for a dataset in the context of a study, any workflows that use that dataset must also be assigned to the corresponding study.

As soon as you submit your access request, an for all administrators of that dataset's organization (if the dataset is owned by a user, an alert will appear on their workspace). If email alerts have been configured, the data owner(s) will also receive an email notification.

By default, you will also receive email alerts for these notifications at your primary email address, though these notifications can be turned off in your .

study
study
alert will appear
different levels of access
Applying for access guide
access levels
authentication information
overview access level
editors and owners
Learn more >
access paradigms
workspace settings
workspace settings
View the steps necessary to gain access in the access modal