Delete API Client Credentials
  • 12 Dec 2023
  • 1 Minute to read
  • Dark
    Light
  • PDF

Delete API Client Credentials

  • Dark
    Light
  • PDF

Article Summary

Delete
/env-mgmt/1.0/api-key/clients/{id}

This API enables users to delete an API Client Credentials by ID.

Notice

Accessing the Policy Management APIs is through a dedicated domain/URL according to your PlainID Tenant Location:
`https://api.{REGION}.plainid.io`

United States (US) - `https://api.us1.plainid.io`
Canada (US) - `https://api.ca1.plainid.io`
Europe (US) - `https://api.eu1.plainid.io`
Replace`{REGION}` with your PlainID Tenant region (e.g. us1, eu1, ca1, etc.).
Security
Http
Type bearer
For more details about Management API Authentication, check out the Management APIs Authentication Article
Provide your bearer token in the Authorization header when making requests to protected resources.
Example: `Authorization: Bearer 123`
Path parameters
id
stringRequired

Client ID to delete

Responses
204

Client deleted

403

Forbidden

forbidden environment
{
  "id": {
    "type": "string",
    "example": "EW43XA",
    "description": "ID for Error Instance"
  },
  "status": {
    "enum": [
      "403"
    ]
  },
  "name": {
    "type": "string",
    "enum": [
      "forbiddenEnvironment"
    ]
  },
  "message": {
    "type": "string",
    "enum": [
      "operation get for resource Environment {ownerId} is not allowed because the current user does not have the appropriate permissions"
    ]
  }
}
forbidden tenant
{
  "id": {
    "type": "string",
    "example": "EW44XA",
    "description": "ID for Error Instance"
  },
  "status": {
    "enum": [
      "403"
    ]
  },
  "name": {
    "type": "string",
    "enum": [
      "forbiddenTenant"
    ]
  },
  "message": {
    "type": "string",
    "enum": [
      "operation get for resource Environment {ownerId} is not allowed because the current user does not have the appropriate permissions"
    ]
  }
}
Expand All
object
code
string
id
string
status
integer
name
string
message
string
args
object
path
string
404

Client not found

client not found
{
  "id": {
    "type": "string",
    "example": "EW45XA",
    "description": "ID for Error Instance"
  },
  "status": {
    "enum": [
      "404"
    ]
  },
  "name": {
    "type": "string",
    "enum": [
      "clientNotFoundError"
    ]
  },
  "message": {
    "type": "string",
    "enum": [
      "Client {name} not found"
    ]
  }
}
Expand All
object
code
string
id
string
status
integer
name
string
message
string
args
object
path
string

Was this article helpful?