Get the state history of an organization

Returns the state history of an organization sorted in reverse chronological order.
Possible states include active, inactive, deleting, and deleted. An organization state
will be transitioned to the deleting state if the organization remains inactive for 90 days.
After deletion is complete, the state will be transitioned to the final deleted state.

get
https://global.api.konghq.com/v3/organizations/state/history

Response

application/json

A paginated list response for a collection of organization state changes.

Organizations State History.

metaobject

returns the pagination information

Show Child Parameters
dataarray[object]
Show Child Parameters
get/organizations/state/history
 
application/json

Update Deletion Config

Sets the deletion configs for a specified organization. The retention period
is the number of days an organization can remain in the inactive state before
being permanently deleted.

patch
https://global.api.konghq.com/v3/organizations/{organizationId}/deletion-config

Path Parameters

organizationIdstring(uuid)required

The ID of the organization being patched.

Example:d32d905a-ed33-46a3-a093-d8f536af9a8a

Body

application/json

The request schema to set an organization’s retention period.

Deletion Config

retention_period_daysinteger

The retention period in days.

>= 1<= 365

Example:90

Response

application/json

The response schema for setting an organization’s retention period.

Deletion Config

retention_period_daysinteger

The retention period in days.

>= 1<= 365

Example:90

patch/organizations/{organizationId}/deletion-config

Body

{ "retention_period_days": 90 }
 
application/json

Organization State

object
idstring(uuid)read-only

UUID of the organization.

Example:d99c041a-c7cf-46a2-bf3a-44bb5f75400e

statestring

State of the organization.

Allowed values:activeinactivedeletingdeleted

Example:active

reasonstring

The reason for the organization’s state.

Example:invoice overdue (30 days)

servicestring

The service that modified the state.

Example:kbilling

changed_bystring

The ID of the Konger who modified the state.

Example:00uerwcs8eC4ifanR256

created_atstring(date-time)read-only

Date the organization state was created.

Example:2023-01-23T17:22:52.150Z

Example

Deletion Config

object
retention_period_daysinteger

The retention period in days.

>= 1<= 365

Example:90

Example

Error

object

standard error

statusintegerrequiredread-only

The HTTP status code of the error. Useful when passing the response
body to child properties in a frontend UI. Must be returned as an integer.

titlestringrequiredread-only

A short, human-readable summary of the problem. It should not
change between occurences of a problem, except for localization.
Should be provided as “Sentence case” for direct use in the UI.

typestringread-only

The error type.

instancestringrequiredread-only

Used to return the correlation ID back to the user, in the format
kong:trace:<correlation_id>. This helps us find the relevant logs
when a customer reports an issue.

detailstringrequiredread-only

A human readable explanation specific to this occurence of the problem.
This field may contain request/entity data to help the user understand
what went wrong. Enclose variable values in square brackets. Should be
provided as “Sentence case” for direct use in the UI.

Example