Skip to main content
DELETE
/
api
/
disks
/
{id}
/
users
/
{userType}
Remove user from disk
curl --request DELETE \
  --url https://control.green.us-east-1.aws.prod.archil.com/api/disks/{id}/users/{userType} \
  --header 'Authorization: <api-key>'
{
  "success": true,
  "data": {
    "message": "<string>"
  }
}

Authorizations

Authorization
string
header
required

API key (format key-{API_KEY})

Path Parameters

id
string
required

Disk ID (format dsk-{16 hex chars})

Pattern: ^dsk-[0-9a-f]{16}$
Example:

"dsk-0123456789abcdef"

userType
enum<string>
required

The type of user authentication

Available options:
token,
awssts

Query Parameters

identifier
string

Identifier of the user to remove, as returned in the creation or list response. For awssts users, this is the IAM ARN.

principal
string

Use identifier instead.

Response

User removed successfully

success
boolean
required
Example:

true

data
object
required