delete__organization_{orgId}_key

DELETE /organization/{idOrg}/key

Delete Organization Keys

Permanently delete all organization keys for the specified organization. This operation is irreversible and will remove all keys and their associated node relationships.

Important Notes:

  • This operation deletes ALL keys for the organization, not just a specific key

  • All associated node-key relationships are also removed (cascade delete)

  • This operation is irreversible - keys cannot be recovered

  • System events are logged for audit purposes

  • Any nodes using these keys will need to re-register with new keys

Access Control:

  • Requires ADMINISTRATOR or OWNER role within the organization

  • Users can only delete keys for their own organization

  • No authentication required for node operations (uses cryptographic signatures)

Security:

  • All key deletions are logged with detailed audit information

  • System events are published for monitoring and alerting

  • Private keys are permanently removed from the system

TypeScript Client Library

public deleteOrgKeys = async (idOrg: string): Promise<{ success: boolean; message: string }> => {
  return this.makeRequest<{ success: boolean; message: string }>(`organization/${idOrg}/key`, 'DELETE');
};

Code Samples

# You can also use wget
curl -X DELETE https://backend.flashback.tech/organization/{idOrg}/key \
  -H 'Accept: application/json' \
  -H 'Authorization: Bearer {access-token}'

Parameters

Name
In
Type
Required
Description

idOrg

path

string

true

Organization ID for which to delete all keys

Example responses

200 Response

{
  "success": true,
  "message": "Successfully deleted 3 organization key(s)"
}

403 Response

{
  "success": false,
  "message": "Access denied: you can only manage keys for your own organization"
}

500 Response

{
  "success": false,
  "message": "Internal server error"
}

Responses

Status
Meaning
Description
Schema

200

Keys deleted successfully

Inline

403

Insufficient permissions or access denied

Inline

500

Failed to delete keys

Inline

Response Schema

Status Code 200

Name
Type
Required
Restrictions
Description

» success

boolean

false

none

Operation success status

» message

string

false

none

Success message with count of deleted keys

Status Code 403

Name
Type
Required
Restrictions
Description

» success

boolean

false

none

Operation success status

» message

string

false

none

Error message describing the permission issue

Status Code 500

Name
Type
Required
Restrictions
Description

» success

boolean

false

none

Operation success status

» message

string

false

none

Error message describing the internal error

To perform this operation, you must be authenticated by means of one of the following methods: BearerAuth

Last updated

Was this helpful?