Book a demo

View and Respond to Access Requests

Public preview: The Marketplace app is available to select accounts. Contact your Immuta representative for details.

Data stewards are able to make determinations on access requests.

Respond to an access request

With the UI

In the Marketplace app,

  1. Navigate to the Access Requests page.

  2. Click the request you want to approve or deny.

  3. Review the request details, data sources, and data use agreement.

  4. Select Continue to determination, and opt to view the determination history tab.

  5. 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.

  6. Click Submit determination.

AI-powered feature

When available, review assist will offer a recommended determination for the access request and provide a reasoning for its recommendation. Opt to accept the recommendation or override it with your own.

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.

Approve or reject an approval record

put

Modify a pending approval record as an approver

Authorizations
Path parameters
idstringRequired
Body
statusstring · enumRequiredExample: PENDINGPossible values:
reasonstringOptional
durationnumber · min: 1Optional
durationUnitstring · enumOptionalPossible values:
Responses
200Success
application/json
put
PUT /marketplace/api/approval-record/{id} HTTP/1.1
Host: na.api.immutacloud.com
Authorization: Bearer JWT
Content-Type: application/json
Accept: */*
Content-Length: 72

{
  "status": "PENDING",
  "reason": "text",
  "duration": 1,
  "durationUnit": "HOURS"
}
200Success
{
  "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-07-12T03:24:13.169Z",
  "updatedAt": "2025-07-12T03:24:13.169Z"
}

View access requests

With the UI

In the Marketplace app,

  1. Navigate to the Access Requests page.

  2. Opt to filter by status or sort the table by data product, status, 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 access requests

get

Search and filter access requests the current user can manage

Authorizations
Query parameters
dataProductIdstring · cuidOptional

The ID of the data product to filter requests by

searchTextstringOptional
userIdsstring[]Optional
historicalbooleanOptional

Whether to include historical access requests

Default: true
includeTemporarybooleanOptional

Whether to include temporary access requests

Default: false
offsetnumberOptionalDefault: 0
limitnumber · min: 1OptionalDefault: 10
sortOrderstring · enumOptionalDefault: descPossible values:
sortBystring · enumOptionalDefault: createdAtPossible values:
Responses
200Success
application/json
get
GET /marketplace/api/access-request HTTP/1.1
Host: na.api.immutacloud.com
Authorization: Bearer JWT
Accept: */*
200Success
{
  "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,
      "status": "PENDING",
      "expiration": "2025-07-12T03:24:13.169Z",
      "createdAt": "2025-07-12T03:24:13.169Z",
      "updatedAt": "2025-07-12T03:24:13.169Z",
      "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

In the Marketplace app,

  1. Navigate to the Data product you want to view requests for.

  2. Click the Access requests tab.

  3. Opt to filter by status or sort the table by data product, status, 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

get

Search all access requests for the data product using the provided filters

Authorizations
Path parameters
idstringRequired
Query parameters
searchTextstringOptional
userIdsstring[]Optional
historicalbooleanOptional

Whether to include historical access requests

Default: true
includeTemporarybooleanOptional

Whether to include temporary access requests

Default: false
offsetnumberOptionalDefault: 0
limitnumber · min: 1OptionalDefault: 10
sortOrderstring · enumOptionalDefault: descPossible values:
sortBystring · enumOptionalDefault: createdAtPossible values:
Responses
200Success
application/json
get
GET /marketplace/api/data-product/{id}/request HTTP/1.1
Host: na.api.immutacloud.com
Authorization: Bearer JWT
Accept: */*
200Success
{
  "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,
      "status": "PENDING",
      "expiration": "2025-07-12T03:24:13.169Z",
      "createdAt": "2025-07-12T03:24:13.169Z",
      "updatedAt": "2025-07-12T03:24:13.169Z",
      "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,

  1. Navigate to the Access Requests page.

  2. 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.

Get individual access request

get

Returns specific details for a specific access request

Authorizations
Path parameters
idstringRequired
Responses
200Success
application/json
get
GET /marketplace/api/access-request/{id} HTTP/1.1
Host: na.api.immutacloud.com
Authorization: Bearer JWT
Accept: */*
200Success
{
  "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,
  "status": "PENDING",
  "expiration": "2025-07-12T03:24:13.169Z",
  "createdAt": "2025-07-12T03:24:13.169Z",
  "updatedAt": "2025-07-12T03:24:13.169Z",
  "dataProduct": {
    "id": "text",
    "name": "text",
    "description": "All sales records from the current fiscal year"
  }
}
PreviousHow-to GuidesNextManage Request Forms

Last updated

Was this helpful?