Skip to main content
POST
/
access_grants
Create access grant
curl --request POST \
  --url https://api.vantage.sh/v2/access_grants \
  --header 'Authorization: Bearer <token>' \
  --header 'Content-Type: application/json' \
  --data '
{
  "resource_token": "<string>",
  "team_token": "<string>",
  "access": "denied"
}
'
{
  "token": "rsrc_accss_grnt_9f8aeb3cedda3831",
  "resource_token": "rprt_3b935d26cba36fb0",
  "access": "denied",
  "team_token": "team_26865e16e46028ae",
  "created_at": "2024-01-18T17:39:37Z",
  "created_by": "usr_2fc38883da3726b9"
}

Authorizations

​
Authorization
string
header
required

The access token received from the authorization server in the OAuth 2.0 flow.

Body

application/json

Create an Access Grant.

​
resource_token
string
required

The token of the resource for which you are granting access.

​
team_token
string
required

The token of the Team you want to grant access to.

​
access
enum<string>

The access level you want to grant. Defaults to 'allowed'.

Available options:
denied,
allowed

Response

AccessGrant model

​
token
string
​
resource_token
string

The token for any resource the AccessGrant is applied to.

Example:

"rprt_abcd1234"

​
access
string

The access status of the AccessGrant.

​
team_token
string

The Team token for which an AccessGrant is applied to.

​
created_at
string

The date and time, in UTC, the AccessGrant was created. ISO 8601 Formatted.

Example:

"2023-08-04T00:00:00Z"

​
created_by
string

The token for the User who created the AccessGrant.