Account Tenant Key Management

Account Tenant Key Management operations

Get Account Tenant Keys

Role Requirements

account-tenant-read or account-admin

Description

Gets the Keys for a Tenant by the tenantId.

Securitybearer
Request
path Parameters
tenantId
required
string <uuid>

The Tenant Id.

header Parameters
x-account-id
required
string

The Account Id.

x-correlation-id
string

Correlation Id for the request.

Responses
200

OK - Returns the Tenant Keys response.

401

Unauthorized

403

Forbidden

get/v1/account/tenants/{tenantId}/keys
Request samples
Response samples
application/json
{
  • "tenantKeys": [
    • {
      • "identity": "string",
      • "name": "string",
      • "publicKey": "string",
      • "roles": [
        • "string"
        ]
      }
    ]
}

Create Account Tenant Key

Role Requirements

account-tenant-write or account-admin

Description

Create a new Tenant Key for tenantId.

Securitybearer
Request
path Parameters
tenantId
required
string <uuid>

The Tenant Id.

header Parameters
x-account-id
required
string

The Account Id.

x-correlation-id
string

Correlation Id for the request.

Request Body schema:
name
string or null

A friendly name for this Key.

roles
Array of strings or null

The roles this Key should have.

Responses
201

Created - Returns the Vaulted Key response.

401

Unauthorized

403

Forbidden

post/v1/account/tenants/{tenantId}/keys
Request samples
{
  • "name": "string",
  • "roles": [
    • "string"
    ]
}
Response samples
application/json
{
  • "identity": "string",
  • "name": "string",
  • "publicKey": "string",
  • "privateKey": "string",
  • "roles": [
    • "string"
    ]
}

Get Account Tenant Key

Role Requirements

account-tenant-read or account-admin

Description

Gets a Tenant Key by the tenantId and publicKey.

Securitybearer
Request
path Parameters
tenantId
required
string <uuid>

The Tenant Id.

publicKey
required
string <uuid>

The Public Key.

header Parameters
x-account-id
required
string

The Account Id.

x-correlation-id
string

Correlation Id for the request.

Responses
200

OK - Returns the Key response.

401

Unauthorized

403

Forbidden

get/v1/account/tenants/{tenantId}/keys/{publicKey}
Request samples
Response samples
application/json
{
  • "identity": "string",
  • "name": "string",
  • "publicKey": "string",
  • "roles": [
    • "string"
    ]
}

Update Account Tenant Key

Role Requirements

account-tenant-write or account-admin

Description

Updates a Tenant Key by the tenantId and publicKey.

Securitybearer
Request
path Parameters
tenantId
required
string <uuid>

The Tenant Id.

publicKey
required
string <uuid>

The Public Key.

header Parameters
x-account-id
required
string

The Account Id.

x-correlation-id
string

Correlation Id for the request.

Request Body schema:
name
string or null

A friendly name for this Key.

roles
Array of strings or null

The roles this Key should have.

Responses
204

No Content.

401

Unauthorized

403

Forbidden

put/v1/account/tenants/{tenantId}/keys/{publicKey}
Request samples
{
  • "name": "string",
  • "roles": [
    • "string"
    ]
}

Delete Account Tenant Key

Role Requirements

account-tenant-write or account-admin

Description

Deletes a Tenant Key by the tenantId and publicKey.

Securitybearer
Request
path Parameters
tenantId
required
string <uuid>

The Tenant Id.

publicKey
required
string <uuid>

The Public Key.

header Parameters
x-account-id
required
string

The Account Id.

x-correlation-id
string

Correlation Id for the request.

Responses
204

No Content.

401

Unauthorized

403

Forbidden

delete/v1/account/tenants/{tenantId}/keys/{publicKey}
Request samples
Copyright 2024 Duck Creek Technologies. All Rights Reserved.