View and Respond to Access Requests
Data stewards are able to make determinations on access requests for access to data products and masking exceptions.
Respond to an access request
With the UI
In the Marketplace app,
Navigate to the Access Requests page.
Click the request you want to approve or deny.
Review the requiest details depending on the request type:
Data access request: Review the request details, data sources, and data use agreement.
Masking exception request: Review the request details, columns the user wants unmasked access to, and data use agreement.
Select Continue to determination, and opt to view the Determination history tab for data access requests.
Select the determination for access:
Temporarily approve: Approve the access request for a specific period of time. If the request form had an access duration question, the requesters response will be presented as a recommendation.
Enter your reason to approve access to the data product.
Use the dropdowns to select how long the user should have access to the data product. If entering a custom time range, you must enter a whole, positive number.
Approve: Approve the access request indefinitely.
Enter your reason to approve access to the data product.
Deny: Deny the access request.
Enter your reason to deny access to the data product.
Click Submit determination. Your determination cannot be edited after it is submitted, even if the request remains open for other data stewards to approve.
With the API
Ensure you set the correct global segment and use a Marketplace-specific personal access token (PAT) when using the Marketplace API. See the Marketplace API docs for additional guidance or to download the OpenAPI YAML for your own client generation.
Modify a pending approval record as an approver
PENDING
Possible values: PUT /marketplace/api/approval-record/{id} HTTP/1.1
Host: na.api.immutacloud.com
Authorization: Bearer YOUR_SECRET_TOKEN
Content-Type: application/json
Accept: */*
Content-Length: 72
{
"status": "PENDING",
"reason": "text",
"duration": 1,
"durationUnit": "HOURS"
}
{
"id": "text",
"dataAccessRequestId": "text",
"approvers": [
{
"type": "USER",
"id": "text",
"displayName": "text"
}
],
"prerequisites": [
"text"
],
"actionBy": {
"id": 1,
"iamId": "text",
"globalUserId": "123e4567-e89b-12d3-a456-426614174000",
"username": "text",
"name": "text",
"email": "text"
},
"status": "PENDING",
"reason": "text",
"createdAt": "2025-10-03T20:12:15.799Z",
"updatedAt": "2025-10-03T20:12:15.799Z"
}
View access requests
With the UI
In the Marketplace app,
Navigate to the Access Requests page.
Opt to filter by status, type, or date.
With the API
Ensure you set the correct global segment and use a Marketplace-specific personal access token (PAT) when using the Marketplace API. See the Marketplace API docs for additional guidance or to download the OpenAPI YAML for your own client generation.
Search and filter access requests the current user can manage
Whether to include historical access requests
true
Whether to include temporary access requests
false
The ID of the data product to filter requests by
The ID of the data product to filter requests by
0
10
desc
Possible values: createdAt
Possible values: GET /marketplace/api/access-request HTTP/1.1
Host: na.api.immutacloud.com
Authorization: Bearer YOUR_SECRET_TOKEN
Accept: */*
{
"data": [
{
"id": "text",
"requestingUser": {
"id": 1,
"iamId": "text",
"globalUserId": "123e4567-e89b-12d3-a456-426614174000",
"username": "text",
"name": "text",
"email": "text"
},
"user": {
"id": 1,
"iamId": "text",
"globalUserId": "123e4567-e89b-12d3-a456-426614174000",
"username": "text",
"name": "text",
"email": "text"
},
"formVersion": "text",
"form": null,
"type": "DATA_ACCESS",
"metadata": null,
"status": "PENDING",
"expiration": "2025-10-03T20:12:15.799Z",
"createdAt": "2025-10-03T20:12:15.799Z",
"updatedAt": "2025-10-03T20:12:15.799Z",
"dataProduct": {
"id": "text",
"name": "text",
"description": "All sales records from the current fiscal year"
}
}
],
"meta": {
"offset": 0,
"limit": 10,
"totalCount": 1,
"pageCount": 1,
"currentPage": 1,
"totalPages": 1
}
}
View the access requests of a specific data product
With the UI
Navigate to the Data product you want to view requests for.
Click the Access requests tab.
Opt to filter by status, type, or date.
With the API
Ensure you set the correct global segment and use a Marketplace-specific personal access token (PAT) when using the Marketplace API. See the Marketplace API docs for additional guidance or to download the OpenAPI YAML for your own client generation.
Search all access requests for the data product using the provided filters
Whether to include historical access requests
true
Whether to include temporary access requests
false
The ID of the data product to filter requests by
The ID of the data product to filter requests by
0
10
desc
Possible values: createdAt
Possible values: GET /marketplace/api/data-product/{id}/request HTTP/1.1
Host: na.api.immutacloud.com
Authorization: Bearer YOUR_SECRET_TOKEN
Accept: */*
{
"data": [
{
"id": "text",
"requestingUser": {
"id": 1,
"iamId": "text",
"globalUserId": "123e4567-e89b-12d3-a456-426614174000",
"username": "text",
"name": "text",
"email": "text"
},
"user": {
"id": 1,
"iamId": "text",
"globalUserId": "123e4567-e89b-12d3-a456-426614174000",
"username": "text",
"name": "text",
"email": "text"
},
"formVersion": "text",
"form": null,
"type": "DATA_ACCESS",
"metadata": null,
"status": "PENDING",
"expiration": "2025-10-03T20:12:15.799Z",
"createdAt": "2025-10-03T20:12:15.799Z",
"updatedAt": "2025-10-03T20:12:15.799Z",
"dataProduct": {
"id": "text",
"name": "text",
"description": "All sales records from the current fiscal year"
}
}
],
"meta": {
"offset": 0,
"limit": 10,
"totalCount": 1,
"pageCount": 1,
"currentPage": 1,
"totalPages": 1
}
}
View the approval record for a request
With the UI
In the Marketplace app,
Navigate to the Access Requests page.
Click the request you want the details for.
With the API
Ensure you set the correct global segment and use a Marketplace-specific personal access token (PAT) when using the Marketplace API. See the Marketplace API docs for additional guidance or to download the OpenAPI YAML for your own client generation.
Returns specific details for a specific access request
GET /marketplace/api/access-request/{id} HTTP/1.1
Host: na.api.immutacloud.com
Authorization: Bearer YOUR_SECRET_TOKEN
Accept: */*
{
"id": "text",
"requestingUser": {
"id": 1,
"iamId": "text",
"globalUserId": "123e4567-e89b-12d3-a456-426614174000",
"username": "text",
"name": "text",
"email": "text"
},
"user": {
"id": 1,
"iamId": "text",
"globalUserId": "123e4567-e89b-12d3-a456-426614174000",
"username": "text",
"name": "text",
"email": "text"
},
"formVersion": "text",
"form": null,
"type": "DATA_ACCESS",
"metadata": null,
"status": "PENDING",
"expiration": "2025-10-03T20:12:15.799Z",
"createdAt": "2025-10-03T20:12:15.799Z",
"updatedAt": "2025-10-03T20:12:15.799Z",
"dataProduct": {
"id": "text",
"name": "text",
"description": "All sales records from the current fiscal year"
}
}
Revoke access
Revoking access to a data product depends on the type of access granted:
Data access: To revoke a user's data access to a data product, remove them as a member from the data product, or revoke access through the access request (see below).
Masking exception: To revoke a user's unmasked access to a masked column, revoke access through the access request (see below).
With the UI
In the Marketplace app,
Navigate to the Access Requests page.
Click the request that originally granted the user access to the data product.
Click Revoke Access, and then Confirm revoke access.
Last updated
Was this helpful?