Get a Permission by Id

Get a specific permission by its permissionId.

caution

This endpoint has been deprecated and will be phased out at the end of 2023. Please update any existing usages of it to use the Get Object endpoint instead.

Endpoint

GET /v1/permissions/:permissionId

Parameters

Parameter	Description	Type	Required
permissionId	Id of the permission to retrieve.	URL param	yes

Request

cURL

curl "https://api.warrant.dev/v1/permissions/view-self-service-dashboard" \
    -H "Authorization: ApiKey YOUR_KEY"

Go

permission, err := permission.Get("view-self-service-dashboard")
if err != nil {
    // handle error
}

Java

Permission permission = client.getPermission("view-self-service-dashboard");

Node.js

const permission = await warrantClient.Permission.get(
  "view-self-service-dashboard"
);

Python

permission = warrant.Permission.get("view-self-service-dashboard")

Ruby

permission = Warrant::Permission.get("view-self-service-dashboard")

PHP

$permission = $warrant->getPermission("view-self-service-dashboard");

Response

{
  "permissionId": "view-self-service-dashboard",
  "name": "View Self Service Dashboard",
  "description": "Grants a user access to view the self service permissions dashboard for their tenant"
}