Skip to Content
OpenETL
ReferenceAPIAccess Service

Disable principal

Its keys stop working until it's enabled again. Fails with FAILED_PRECONDITION for the org's last owner.

POST
/v1/principals/{principal}:disable

Its keys stop working until it's enabled again. Fails with FAILED_PRECONDITION for the org's last owner.

Path Parameters

principal*string

The principal id.

Request Body

application/json
  1. body
name?string

Response Body

OK

application/json
  1. response
principal?

A user or a service account, which calls the API with its keys.

Example Request
curl -X POST 'http://localhost:8080/v1/principals/string:disable' \  -H 'Content-Type: application/json' \  -d '{}'
Example Response
{  "principal": {    "name": "string",    "type": "PRINCIPAL_TYPE_UNSPECIFIED",    "displayName": "string",    "email": "string",    "disabled": true,    "roleBindings": [      {        "role": "ROLE_UNSPECIFIED",        "workspace": "string"      }    ],    "createTime": "2019-08-24T14:15:22Z"  }}