Subscription API reference guide
This page describes the subscription
endpoint, which allows you to view and manage access requests.
Additional fields may be included in some responses you receive; however, these attributes are for internal purposes and are therefore undocumented.
GET
/subscription/getPendingRequestsForUser
Get pending access requests the calling user can approve.
The following request gets pending access requests the calling user can approve.
GET
/subscription/requestInfo/{modelType}/{modelId}
Get pending request information for specified model and requesting user (or specified entity).
The following request gets pending access requests for the data source with the ID 6
for the current user.
POST
/subscription/approve
Approve specified access requests.
The following request approves the subscription request.
POST
/subscription/approve/bulk
Bulk approve access requests.
The following request approves all of the subscription requests.
POST
/subscription/deny
Deny specified access requests.
The following request denies the subscription request.
POST
/subscription/deny/bulk
Bulk deny access requests.
The following request with the payload below denies the subscription requests with the IDs 40
and 41
.
Method | Path | Purpose |
---|---|---|
Attribute | Description | Required |
---|---|---|
Attribute | Description |
---|---|
Attribute | Description | Required |
---|---|---|
Attribute | Description |
---|---|
Method | Path | Purpose |
---|---|---|
Attribute | Description | Required |
---|---|---|
Attribute | Description |
---|---|
Attribute | Description | Required |
---|---|---|
Attribute | Description |
---|---|
Method | Path | Purpose |
---|---|---|
Attribute | Description | Required |
---|---|---|
Attribute | Description |
---|---|
Attribute | Description | Required |
---|---|---|
Attribute | Description |
---|---|
GET
Get pending access requests the calling user can approve.
GET
Get pending request information for specified model and requesting user (or specified entity).
groupByEntity
boolean
If true
, group request results by user/group.
No
profileId
integer
Match against profile ID.
No
groupId
integer
Match against group ID.
No
name
string
A partial name to match against user or group names.
No
string
A partial email address to match against user or group email addresses.
No
modelName
string
A partial name to match against model names.
No
modelTypes
array[string]
Model types to include.
No
size
integer
The max number of matches to return. Default 15.
No
sortField
string
The field to sort results on. Defaults to name.
No
sortOrder
string
The order that the results will be sorted in. Default asc
.
No
offset
integer
Offset to start returning values.
No
hits
array
Metadata details regarding the access requests.
count
integer
The number of access requests.
modelType
string
The model that a pending request is out for. Options are datasource
or project
.
Yes
modelId
integer
The data source or project ID.
Yes
profileId
integer
A user ID if you want to get pending requests for another user.
No
groupId
integer
A group ID if you want to get pending requests for a whole group.
No
records
array
Details about each of the pending access requests, including subscriptionId
, requiredPermission
, state
, approverId
, ownerModelId
, approver
, and ownerModelName
.
POST
Approve specified access requests.
POST
Bulk approve access requests.
id
integer
The subscription ID of the request to approve.
Yes
expiration
date
The date to expire this user's access.
No
id
integer
If the request fails, the response includes the ID of the access request.
model
array[object]
If the request fails, the response includes details about the data source or project.
entity
array[object]
If the request fails, the response includes details about the user making the subscription request.
requestIds
integer
A list of the access request IDs to be approved. If requestIds
is provided, jobs will only be created for the IDs listed. Otherwise, the id
and type
values will be used to find and create jobs for all approval requests.
Yes
id
integer
The ID for the type
. If requestIds
is provided, jobs will only be created for the IDs listed. Otherwise, the id
and type
values will be used to find and create jobs for all approval requests.
Yes
type
string
The type of ID: profile
. If requestIds
is provided, jobs will only be created for the IDs listed. Otherwise, the id
and type
values will be used to find and create jobs for all approval requests.
Yes
success
boolean
If true
, all of the access requests have been successfully approved.
POST
Deny specified access requests.
POST
Bulk deny access requests.
id
integer
The subscription ID of the request to deny.
Yes
denialReasoning
string
The reason the user is denied access to the data source or project.
Yes
id
integer
If the request fails, the response includes the ID of the access request.
model
array[object]
If the request fails, the response includes details about the data source or project.
entity
array[object]
If the request fails, the response includes details about the user making the subscription request.
requestIds
integer
A list of the access request IDs to be approved. If requestIds
is provided, jobs will only be created for the IDs listed. Otherwise, the id
and type
values will be used to find and create jobs for all denial requests.
Yes
id
integer
The ID for the type
you select. If requestIds
is provided, jobs will only be created for the IDs listed. Otherwise, the id
and type
values will be used to find and create jobs for all denial requests.
Yes
type
string
The type of ID: profile
. If requestIds
is provided, jobs will only be created for the IDs listed. Otherwise, the id
and type
values will be used to find and create jobs for all denial requests.
Yes
denialReasoning
string
The reason that you are denying the access requests.
Yes
success
boolean
If true
, all of the access requests have been successfully denied.