Skip to main content
API docs by Redocly

Daikoku Admin API (16.3.0)

Download OpenAPI specification:Download

MAIF open source team: oss@maif.fr License: Apache 2.0

Admin API of Daikoku

Find out more about Daikoku

tenant

delete a tenant

path Parameters
id
required
string

The ID of the tenant to delete

Responses

Response samples

Content type
application/json
{
  • "done": true
}

update a tenant with JSON patch or by merging JSON object

path Parameters
id
required
string

The tenant ID to update

Request Body schema: application/json
required

the patch to update the tenant or a JSON object

One of
Array
op
required
string
Enum: "add" "replace" "remove" "copy" "test"
path
required
string
value
any

Responses

Request samples

Content type
application/json
Example
[ ]

Response samples

Content type
application/json
{
  • "error": "string"
}

update a tenant

path Parameters
id
required
string

The ID of the tenant to update

Request Body schema: application/json
required

the ID of the tenant to update

_id
required
string
enabled
required
boolean
_deleted
boolean or null
name
required
string
domain
string or null
contact
required
string
object (DaikokuStyle)

DaikokuStyle

defaultLanguage
string or null
Array of objects or null (OtoroshiSettings)
(MailerSettings.ConsoleMailerSettings (object or null)) or (MailerSettings.MailgunSettings (object or null)) or (MailerSettings.MailjetSettings (object or null)) or (MailerSettings.SimpleSMTPSettings (object or null)) or (MailerSettings.SendgridSettings (object or null))
object (S3Configuration)

S3Configuration

authProvider
string or null
Enum: "local" "otoroshi" "ldap" "oauth2"
authProviderSettings
object
object (AuditTrailConfig)

AuditTrailConfig

isPrivate
boolean or null
adminApi
required
string
adminSubscriptions
Array of strings
creationSecurity
boolean or null
subscriptionSecurity
boolean or null
apiReferenceHideForGuest
boolean or null
defaultMessage
string or null
tenantMode
string or null
Enum: "default" "maintenance" "construction" "translation"
aggregationApiKeysSecurity
boolean or null
robotTxt
string or null
Array of ThirdPartyPaymentSettings.StripeSettings (object) or null
display
string or null
Enum: "default" "environment"
environments
Array of strings or null

Responses

Request samples

Content type
application/json
{
  • "_id": "string",
  • "enabled": true,
  • "_deleted": true,
  • "name": "string",
  • "domain": "string",
  • "contact": "string",
  • "style": {
    },
  • "defaultLanguage": "string",
  • "otoroshiSettings": [
    ],
  • "mailerSettings": {
    },
  • "bucketSettings": {
    },
  • "authProvider": "local",
  • "authProviderSettings": { },
  • "auditTrailConfig": {
    },
  • "isPrivate": true,
  • "adminApi": "string",
  • "adminSubscriptions": [
    ],
  • "creationSecurity": true,
  • "subscriptionSecurity": true,
  • "apiReferenceHideForGuest": true,
  • "defaultMessage": "string",
  • "tenantMode": "default",
  • "aggregationApiKeysSecurity": true,
  • "robotTxt": "string",
  • "thirdPartyPaymentSettings": [
    ],
  • "display": "default",
  • "environments": [
    ]
}

Response samples

Content type
application/json
{
  • "error": "string"
}

read a tenant

path Parameters
id
required
string

The ID of the tenant to retrieve

Responses

Response samples

Content type
application/json
{ }

read all tenant

Responses

Response samples

Content type
application/json
[
  • {
    }
]

create a tenant

Request Body schema: application/json
required

the tenant to create

_id
required
string
enabled
required
boolean
_deleted
boolean or null
name
required
string
domain
string or null
contact
required
string
object (DaikokuStyle)

DaikokuStyle

defaultLanguage
string or null
Array of objects or null (OtoroshiSettings)
(MailerSettings.ConsoleMailerSettings (object or null)) or (MailerSettings.MailgunSettings (object or null)) or (MailerSettings.MailjetSettings (object or null)) or (MailerSettings.SimpleSMTPSettings (object or null)) or (MailerSettings.SendgridSettings (object or null))
object (S3Configuration)

S3Configuration

authProvider
string or null
Enum: "local" "otoroshi" "ldap" "oauth2"
authProviderSettings
object
object (AuditTrailConfig)

AuditTrailConfig

isPrivate
boolean or null
adminApi
required
string
adminSubscriptions
Array of strings
creationSecurity
boolean or null
subscriptionSecurity
boolean or null
apiReferenceHideForGuest
boolean or null
defaultMessage
string or null
tenantMode
string or null
Enum: "default" "maintenance" "construction" "translation"
aggregationApiKeysSecurity
boolean or null
robotTxt
string or null
Array of ThirdPartyPaymentSettings.StripeSettings (object) or null
display
string or null
Enum: "default" "environment"
environments
Array of strings or null

Responses

Request samples

Content type
application/json
{
  • "_id": "string",
  • "enabled": true,
  • "_deleted": true,
  • "name": "string",
  • "domain": "string",
  • "contact": "string",
  • "style": {
    },
  • "defaultLanguage": "string",
  • "otoroshiSettings": [
    ],
  • "mailerSettings": {
    },
  • "bucketSettings": {
    },
  • "authProvider": "local",
  • "authProviderSettings": { },
  • "auditTrailConfig": {
    },
  • "isPrivate": true,
  • "adminApi": "string",
  • "adminSubscriptions": [
    ],
  • "creationSecurity": true,
  • "subscriptionSecurity": true,
  • "apiReferenceHideForGuest": true,
  • "defaultMessage": "string",
  • "tenantMode": "default",
  • "aggregationApiKeysSecurity": true,
  • "robotTxt": "string",
  • "thirdPartyPaymentSettings": [
    ],
  • "display": "default",
  • "environments": [
    ]
}

Response samples

Content type
application/json
{
  • "_id": "string",
  • "enabled": true,
  • "_deleted": true,
  • "name": "string",
  • "domain": "string",
  • "contact": "string",
  • "style": {
    },
  • "defaultLanguage": "string",
  • "otoroshiSettings": [
    ],
  • "mailerSettings": {
    },
  • "bucketSettings": {
    },
  • "authProvider": "local",
  • "authProviderSettings": { },
  • "auditTrailConfig": {
    },
  • "isPrivate": true,
  • "adminApi": "string",
  • "adminSubscriptions": [
    ],
  • "creationSecurity": true,
  • "subscriptionSecurity": true,
  • "apiReferenceHideForGuest": true,
  • "defaultMessage": "string",
  • "tenantMode": "default",
  • "aggregationApiKeysSecurity": true,
  • "robotTxt": "string",
  • "thirdPartyPaymentSettings": [
    ],
  • "display": "default",
  • "environments": [
    ]
}

user

delete a user

path Parameters
id
required
string

Responses

Response samples

Content type
application/json
{
  • "done": true
}

update a user with JSON patch or by merging JSON object

path Parameters
id
required
string
Request Body schema: application/json
required

the patch to update the user or a JSON object

One of
Array
op
required
string
Enum: "add" "replace" "remove" "copy" "test"
path
required
string
value
any

Responses

Request samples

Content type
application/json
Example
[ ]

Response samples

Content type
application/json
{
  • "error": "string"
}

update a user

path Parameters
id
required
string
Request Body schema: application/json
required

the user to update

_id
required
string
_deleted
boolean
tenants
Array of strings or null
origins
Array of strings or null
Enum: "local" "otoroshi" "ldap" "oauth2"
name
required
string
email
required
string
picture
string or null
pictureFromProvider
boolean or null
isDaikokuAdmin
boolean or null
password
string or null

optionnal value but required in case of tenant has a Local AuthProvider

hardwareKeyRegistrations
Array of objects or null
lastTenant
string or null
metadata
object or null
defaultLanguage
string or null
starredApis
Array of strings or null
object (TwoFactorAuthentication)

TwoFactorAuthentication

object (UserInvitation)

UserInvitation

Responses

Request samples

Content type
application/json
{
  • "_id": "string",
  • "_deleted": true,
  • "tenants": [
    ],
  • "origins": [
    ],
  • "name": "string",
  • "email": "string",
  • "picture": "string",
  • "pictureFromProvider": true,
  • "isDaikokuAdmin": true,
  • "password": "string",
  • "hardwareKeyRegistrations": [
    ],
  • "lastTenant": "string",
  • "metadata": { },
  • "defaultLanguage": "string",
  • "starredApis": [
    ],
  • "twoFactorAuthentication": {
    },
  • "invitation": {
    }
}

Response samples

Content type
application/json
{
  • "error": "string"
}

read a user

path Parameters
id
required
string

Responses

Response samples

Content type
application/json
{ }

read all user

Responses

Response samples

Content type
application/json
[
  • {
    }
]

creates a user

Request Body schema: application/json
required

the user to create

_id
required
string
_deleted
boolean
tenants
Array of strings or null
origins
Array of strings or null
Enum: "local" "otoroshi" "ldap" "oauth2"
name
required
string
email
required
string
picture
string or null
pictureFromProvider
boolean or null
isDaikokuAdmin
boolean or null
password
string or null

optionnal value but required in case of tenant has a Local AuthProvider

hardwareKeyRegistrations
Array of objects or null
lastTenant
string or null
metadata
object or null
defaultLanguage
string or null
starredApis
Array of strings or null
object (TwoFactorAuthentication)

TwoFactorAuthentication

object (UserInvitation)

UserInvitation

Responses

Request samples

Content type
application/json
{
  • "_id": "string",
  • "_deleted": true,
  • "tenants": [
    ],
  • "origins": [
    ],
  • "name": "string",
  • "email": "string",
  • "picture": "string",
  • "pictureFromProvider": true,
  • "isDaikokuAdmin": true,
  • "password": "string",
  • "hardwareKeyRegistrations": [
    ],
  • "lastTenant": "string",
  • "metadata": { },
  • "defaultLanguage": "string",
  • "starredApis": [
    ],
  • "twoFactorAuthentication": {
    },
  • "invitation": {
    }
}

Response samples

Content type
application/json
{
  • "_id": "string",
  • "_deleted": true,
  • "tenants": [
    ],
  • "origins": [
    ],
  • "name": "string",
  • "email": "string",
  • "picture": "string",
  • "pictureFromProvider": true,
  • "isDaikokuAdmin": true,
  • "password": "string",
  • "hardwareKeyRegistrations": [
    ],
  • "lastTenant": "string",
  • "metadata": { },
  • "defaultLanguage": "string",
  • "starredApis": [
    ],
  • "twoFactorAuthentication": {
    },
  • "invitation": {
    }
}

team

delete a team

path Parameters
id
required
string

Responses

Response samples

Content type
application/json
{
  • "done": true
}

update a team with JSON patch or by merging JSON object

path Parameters
id
required
string
Request Body schema: application/json
required

the patch to update the team or a JSON object

One of
Array
op
required
string
Enum: "add" "replace" "remove" "copy" "test"
path
required
string
value
any

Responses

Request samples

Content type
application/json
Example
[ ]

Response samples

Content type
application/json
{
  • "error": "string"
}

update a team

path Parameters
id
required
string
Request Body schema: application/json
required

the team to update

_id
required
string
_tenant
required
string
_deleted
boolean or null
type
required
string
Enum: "Personal" "Organization" "Admin"
name
string
description
string or null
contact
required
string
avatar
string or null
Array of objects (UserWithPermission)
Array of objects or null
apiKeyVisibility
string
Enum: "administrator" "apiEditor" "user"
metadata
object or null
apisCreationPermission
boolean or null
verified
required
boolean

Responses

Request samples

Content type
application/json
{
  • "_id": "string",
  • "_tenant": "string",
  • "_deleted": true,
  • "type": "Personal",
  • "name": "string",
  • "description": "string",
  • "contact": "string",
  • "avatar": "string",
  • "users": [
    ],
  • "authorizedEntities": [
    ],
  • "apiKeyVisibility": "administrator",
  • "metadata": { },
  • "apisCreationPermission": true,
  • "verified": true
}

Response samples

Content type
application/json
{
  • "error": "string"
}

read a team

path Parameters
id
required
string

Responses

Response samples

Content type
application/json
{ }

read all team

Responses

Response samples

Content type
application/json
[
  • {
    }
]

creates a team

Request Body schema: application/json
required

the team to create

_id
required
string
_tenant
required
string
_deleted
boolean or null
type
required
string
Enum: "Personal" "Organization" "Admin"
name
string
description
string or null
contact
required
string
avatar
string or null
Array of objects (UserWithPermission)
Array of objects or null
apiKeyVisibility
string
Enum: "administrator" "apiEditor" "user"
metadata
object or null
apisCreationPermission
boolean or null
verified
required
boolean

Responses

Request samples

Content type
application/json
{
  • "_id": "string",
  • "_tenant": "string",
  • "_deleted": true,
  • "type": "Personal",
  • "name": "string",
  • "description": "string",
  • "contact": "string",
  • "avatar": "string",
  • "users": [
    ],
  • "authorizedEntities": [
    ],
  • "apiKeyVisibility": "administrator",
  • "metadata": { },
  • "apisCreationPermission": true,
  • "verified": true
}

Response samples

Content type
application/json
{
  • "_id": "string",
  • "_tenant": "string",
  • "_deleted": true,
  • "type": "Personal",
  • "name": "string",
  • "description": "string",
  • "contact": "string",
  • "avatar": "string",
  • "users": [
    ],
  • "authorizedEntities": [
    ],
  • "apiKeyVisibility": "administrator",
  • "metadata": { },
  • "apisCreationPermission": true,
  • "verified": true
}

api

delete a api

path Parameters
id
required
string

Responses

Response samples

Content type
application/json
{
  • "done": true
}

update a api with JSON patch or by merging JSON object

path Parameters
id
required
string
Request Body schema: application/json
required

the patch to update the api or a JSON object

One of
Array
op
required
string
Enum: "add" "replace" "remove" "copy" "test"
path
required
string
value
any

Responses

Request samples

Content type
application/json
Example
[ ]

Response samples

Content type
application/json
{
  • "error": "string"
}

update a api

path Parameters
id
required
string
Request Body schema: application/json
required

the api to update

_id
required
string
_tenant
required
string
_deleted
boolean or null
team
required
string
name
required
string
lastUpdate
required
integer <timestamp>
description
string or null
smallDescription
string or null
header
string or null
image
string or null
currentVersion
required
string
supportedVersions
Array of strings
isDefault
boolean or null
object (Testing)

Testing

required
object (ApiDocumentation)

ApiDocumentation

object (SwaggerAccess)

SwaggerAccess

tags
Array of strings or null
categories
Array of strings or null
visibility
required
string
Enum: "Public" "Private" "PublicWithAuthorizations" "AdminOnly"
possibleUsagePlans
required
Array of strings
defaultUsagePlan
string or null
authorizedTeams
Array of strings or null
posts
Array of strings or null
issues
Array of strings or null
Array of objects or null (ApiIssueTag)
stars
integer <int32>
parent
string
apis
Array of strings
state
required
string
Enum: "created" "published" "blocked" "deprecated"

Responses

Request samples

Content type
application/json
{
  • "_id": "string",
  • "_tenant": "string",
  • "_deleted": true,
  • "team": "string",
  • "name": "string",
  • "lastUpdate": 0,
  • "description": "string",
  • "smallDescription": "string",
  • "header": "string",
  • "image": "string",
  • "currentVersion": "string",
  • "supportedVersions": [
    ],
  • "isDefault": true,
  • "testing": {
    },
  • "documentation": {
    },
  • "swagger": {
    },
  • "tags": [
    ],
  • "categories": [
    ],
  • "visibility": "Public",
  • "possibleUsagePlans": [
    ],
  • "defaultUsagePlan": "string",
  • "authorizedTeams": [
    ],
  • "posts": [
    ],
  • "issues": [
    ],
  • "issuesTags": [
    ],
  • "stars": 0,
  • "parent": "string",
  • "apis": [
    ],
  • "state": "created"
}

Response samples

Content type
application/json
{
  • "error": "string"
}

read a api

path Parameters
id
required
string

Responses

Response samples

Content type
application/json
{ }

read all api

Responses

Response samples

Content type
application/json
[
  • {
    }
]

creates a api

Request Body schema: application/json
required

the api to create

_id
required
string
_tenant
required
string
_deleted
boolean or null
team
required
string
name
required
string
lastUpdate
required
integer <timestamp>
description
string or null
smallDescription
string or null
header
string or null
image
string or null
currentVersion
required
string
supportedVersions
Array of strings
isDefault
boolean or null
object (Testing)

Testing

required
object (ApiDocumentation)

ApiDocumentation

object (SwaggerAccess)

SwaggerAccess

tags
Array of strings or null
categories
Array of strings or null
visibility
required
string
Enum: "Public" "Private" "PublicWithAuthorizations" "AdminOnly"
possibleUsagePlans
required
Array of strings
defaultUsagePlan
string or null
authorizedTeams
Array of strings or null
posts
Array of strings or null
issues
Array of strings or null
Array of objects or null (ApiIssueTag)
stars
integer <int32>
parent
string
apis
Array of strings
state
required
string
Enum: "created" "published" "blocked" "deprecated"

Responses

Request samples

Content type
application/json
{
  • "_id": "string",
  • "_tenant": "string",
  • "_deleted": true,
  • "team": "string",
  • "name": "string",
  • "lastUpdate": 0,
  • "description": "string",
  • "smallDescription": "string",
  • "header": "string",
  • "image": "string",
  • "currentVersion": "string",
  • "supportedVersions": [
    ],
  • "isDefault": true,
  • "testing": {
    },
  • "documentation": {
    },
  • "swagger": {
    },
  • "tags": [
    ],
  • "categories": [
    ],
  • "visibility": "Public",
  • "possibleUsagePlans": [
    ],
  • "defaultUsagePlan": "string",
  • "authorizedTeams": [
    ],
  • "posts": [
    ],
  • "issues": [
    ],
  • "issuesTags": [
    ],
  • "stars": 0,
  • "parent": "string",
  • "apis": [
    ],
  • "state": "created"
}

Response samples

Content type
application/json
{
  • "_id": "string",
  • "_tenant": "string",
  • "_deleted": true,
  • "team": "string",
  • "name": "string",
  • "lastUpdate": 0,
  • "description": "string",
  • "smallDescription": "string",
  • "header": "string",
  • "image": "string",
  • "currentVersion": "string",
  • "supportedVersions": [
    ],
  • "isDefault": true,
  • "testing": {
    },
  • "documentation": {
    },
  • "swagger": {
    },
  • "tags": [
    ],
  • "categories": [
    ],
  • "visibility": "Public",
  • "possibleUsagePlans": [
    ],
  • "defaultUsagePlan": "string",
  • "authorizedTeams": [
    ],
  • "posts": [
    ],
  • "issues": [
    ],
  • "issuesTags": [
    ],
  • "stars": 0,
  • "parent": "string",
  • "apis": [
    ],
  • "state": "created"
}

api-subscription

delete a api-subscription

path Parameters
id
required
string

Responses

Response samples

Content type
application/json
{
  • "done": true
}

update a api-subscription with JSON patch or by merging JSON object

path Parameters
id
required
string
Request Body schema: application/json
required

the patch to update the api-subscription or a JSON object

One of
Array
op
required
string
Enum: "add" "replace" "remove" "copy" "test"
path
required
string
value
any

Responses

Request samples

Content type
application/json
Example
[ ]

Response samples

Content type
application/json
{
  • "error": "string"
}

update a api-subscription

path Parameters
id
required
string
Request Body schema: application/json
required

the api-subscription to update

_id
required
string
_tenant
required
string
_deleted
boolean or null
required
object (OtoroshiApiKey)

OtoroshiApiKey

plan
required
string
team
required
string
api
required
string
createdAt
required
integer <timestamp>
by
required
string
customName
string or null
adminCustomName
string or null
enabled
boolean or null
object (ApiSubscriptionRotation)

ApiSubscriptionRotation

integrationToken
required
string
customMetadata
object
metadata
object or null
tags
Array of strings
customMaxPerSecond
integer or null <int64>
customMaxPerDay
integer or null <int64>
customMaxPerMonth
integer or null <int64>
customReadOnly
boolean or null
parent
string or null
ThirdPartySubscriptionInformations.Stripe (object)

Responses

Request samples

Content type
application/json
{
  • "_id": "string",
  • "_tenant": "string",
  • "_deleted": true,
  • "apiKey": {
    },
  • "plan": "string",
  • "team": "string",
  • "api": "string",
  • "createdAt": 0,
  • "by": "string",
  • "customName": "string",
  • "adminCustomName": "string",
  • "enabled": true,
  • "rotation": {
    },
  • "integrationToken": "string",
  • "customMetadata": { },
  • "metadata": { },
  • "tags": [
    ],
  • "customMaxPerSecond": 0,
  • "customMaxPerDay": 0,
  • "customMaxPerMonth": 0,
  • "customReadOnly": true,
  • "parent": "string",
  • "thirdPartySubscriptionInformations": {
    }
}

Response samples

Content type
application/json
{
  • "error": "string"
}

read a api-subscription

path Parameters
id
required
string

Responses

Response samples

Content type
application/json
{ }

read all api-subscription

Responses

Response samples

Content type
application/json
[
  • {
    }
]

creates a api-subscription

Request Body schema: application/json
required

the api-subscription to create

_id
required
string
_tenant
required
string
_deleted
boolean or null
required
object (OtoroshiApiKey)

OtoroshiApiKey

plan
required
string
team
required
string
api
required
string
createdAt
required
integer <timestamp>
by
required
string
customName
string or null
adminCustomName
string or null
enabled
boolean or null
object (ApiSubscriptionRotation)

ApiSubscriptionRotation

integrationToken
required
string
customMetadata
object
metadata
object or null
tags
Array of strings
customMaxPerSecond
integer or null <int64>
customMaxPerDay
integer or null <int64>
customMaxPerMonth
integer or null <int64>
customReadOnly
boolean or null
parent
string or null
ThirdPartySubscriptionInformations.Stripe (object)

Responses

Request samples

Content type
application/json
{
  • "_id": "string",
  • "_tenant": "string",
  • "_deleted": true,
  • "apiKey": {
    },
  • "plan": "string",
  • "team": "string",
  • "api": "string",
  • "createdAt": 0,
  • "by": "string",
  • "customName": "string",
  • "adminCustomName": "string",
  • "enabled": true,
  • "rotation": {
    },
  • "integrationToken": "string",
  • "customMetadata": { },
  • "metadata": { },
  • "tags": [
    ],
  • "customMaxPerSecond": 0,
  • "customMaxPerDay": 0,
  • "customMaxPerMonth": 0,
  • "customReadOnly": true,
  • "parent": "string",
  • "thirdPartySubscriptionInformations": {
    }
}

Response samples

Content type
application/json
{
  • "_id": "string",
  • "_tenant": "string",
  • "_deleted": true,
  • "apiKey": {
    },
  • "plan": "string",
  • "team": "string",
  • "api": "string",
  • "createdAt": 0,
  • "by": "string",
  • "customName": "string",
  • "adminCustomName": "string",
  • "enabled": true,
  • "rotation": {
    },
  • "integrationToken": "string",
  • "customMetadata": { },
  • "metadata": { },
  • "tags": [
    ],
  • "customMaxPerSecond": 0,
  • "customMaxPerDay": 0,
  • "customMaxPerMonth": 0,
  • "customReadOnly": true,
  • "parent": "string",
  • "thirdPartySubscriptionInformations": {
    }
}

api-documentation-page

delete a api-documentation-page

path Parameters
id
required
string

Responses

Response samples

Content type
application/json
{
  • "done": true
}

update a api-documentation-page with JSON patch or by merging JSON object

path Parameters
id
required
string
Request Body schema: application/json
required

the patch to update the api-documentation-page or a JSON object

One of
Array
op
required
string
Enum: "add" "replace" "remove" "copy" "test"
path
required
string
value
any

Responses

Request samples

Content type
application/json
Example
[ ]

Response samples

Content type
application/json
{
  • "error": "string"
}

update a api-documentation-page

path Parameters
id
required
string
Request Body schema: application/json
required

the api-documentation-page to update

_id
required
string
_tenant
required
string
_deleted
boolean or null
title
required
string
lastModificationAt
required
integer <timestamp>
content
string or null
contentType
string or null
remoteContentEnabled
boolean or null
remoteContentUrl
string or null
remoteContentHeaders
object or null

Responses

Request samples

Content type
application/json
{
  • "_id": "string",
  • "_tenant": "string",
  • "_deleted": true,
  • "title": "string",
  • "lastModificationAt": 0,
  • "content": "string",
  • "contentType": "string",
  • "remoteContentEnabled": true,
  • "remoteContentUrl": "string",
  • "remoteContentHeaders": { }
}

Response samples

Content type
application/json
{
  • "error": "string"
}

read a api-documentation-page

path Parameters
id
required
string

Responses

Response samples

Content type
application/json
{ }

read all api-documentation-page

Responses

Response samples

Content type
application/json
[
  • {
    }
]

creates a api-documentation-page

Request Body schema: application/json
required

the api-documentation-page to create

_id
required
string
_tenant
required
string
_deleted
boolean or null
title
required
string
lastModificationAt
required
integer <timestamp>
content
string or null
contentType
string or null
remoteContentEnabled
boolean or null
remoteContentUrl
string or null
remoteContentHeaders
object or null

Responses

Request samples

Content type
application/json
{
  • "_id": "string",
  • "_tenant": "string",
  • "_deleted": true,
  • "title": "string",
  • "lastModificationAt": 0,
  • "content": "string",
  • "contentType": "string",
  • "remoteContentEnabled": true,
  • "remoteContentUrl": "string",
  • "remoteContentHeaders": { }
}

Response samples

Content type
application/json
{
  • "_id": "string",
  • "_tenant": "string",
  • "_deleted": true,
  • "title": "string",
  • "lastModificationAt": 0,
  • "content": "string",
  • "contentType": "string",
  • "remoteContentEnabled": true,
  • "remoteContentUrl": "string",
  • "remoteContentHeaders": { }
}

notification

delete a notification

path Parameters
id
required
string

Responses

Response samples

Content type
application/json
{
  • "done": true
}

read a notification

path Parameters
id
required
string

Responses

Response samples

Content type
application/json
{ }

read all notification

Responses

Response samples

Content type
application/json
[
  • {
    }
]

user-session

delete a user-session

path Parameters
id
required
string

Responses

Response samples

Content type
application/json
{
  • "done": true
}

read a user-session

path Parameters
id
required
string

Responses

Response samples

Content type
application/json
{ }

read all user-session

Responses

Response samples

Content type
application/json
[
  • {
    }
]

api-key-consumption

delete a api-key-consumption

path Parameters
id
required
string

Responses

Response samples

Content type
application/json
{
  • "done": true
}

read a api-key-consumption

path Parameters
id
required
string

Responses

Response samples

Content type
application/json
{ }

read all api-key-consumption

Responses

Response samples

Content type
application/json
[
  • {
    }
]

audit-event

delete a audit-event

path Parameters
id
required
string

Responses

Response samples

Content type
application/json
{
  • "done": true
}

read a audit-event

path Parameters
id
required
string

Responses

Response samples

Content type
application/json
{ }

read all audit-event

Responses

Response samples

Content type
application/json
[
  • { }
]

message

delete a message

path Parameters
id
required
string

Responses

Response samples

Content type
application/json
{
  • "done": true
}

read a message

path Parameters
id
required
string

Responses

Response samples

Content type
application/json
{ }

read all message

Responses

Response samples

Content type
application/json
[
  • {
    }
]

issue

delete a issue

path Parameters
id
required
string

Responses

Response samples

Content type
application/json
{
  • "done": true
}

update a issue with JSON patch or by merging JSON object

path Parameters
id
required
string
Request Body schema: application/json
required

the patch to update the issue or a JSON object

One of
Array
op
required
string
Enum: "add" "replace" "remove" "copy" "test"
path
required
string
value
any

Responses

Request samples

Content type
application/json
Example
[ ]

Response samples

Content type
application/json
{
  • "error": "string"
}

update a issue

path Parameters
id
required
string
Request Body schema: application/json
required

the issue to update

_id
required
string
seqId
integer or null <int32>
_tenant
required
string
_deleted
boolean or null
title
required
string
tags
Array of strings or null
open
boolean or null
createdAt
integer or null <timestamp>
closedAt
integer or null <timestamp>
by
required
string
Array of objects (ApiIssueComment)
lastModificationAt
integer or null <timestamp>
apiVersion
string or null

Responses

Request samples

Content type
application/json
{
  • "_id": "string",
  • "seqId": 0,
  • "_tenant": "string",
  • "_deleted": true,
  • "title": "string",
  • "tags": [
    ],
  • "open": true,
  • "createdAt": 0,
  • "closedAt": 0,
  • "by": "string",
  • "comments": [
    ],
  • "lastModificationAt": 0,
  • "apiVersion": "string"
}

Response samples

Content type
application/json
{
  • "error": "string"
}

read a issue

path Parameters
id
required
string

Responses

Response samples

Content type
application/json
{ }

read all issue

Responses

Response samples

Content type
application/json
[
  • {
    }
]

creates a issue

Request Body schema: application/json
required

the issue to create

_id
required
string
seqId
integer or null <int32>
_tenant
required
string
_deleted
boolean or null
title
required
string
tags
Array of strings or null
open
boolean or null
createdAt
integer or null <timestamp>
closedAt
integer or null <timestamp>
by
required
string
Array of objects (ApiIssueComment)
lastModificationAt
integer or null <timestamp>
apiVersion
string or null

Responses

Request samples

Content type
application/json
{
  • "_id": "string",
  • "seqId": 0,
  • "_tenant": "string",
  • "_deleted": true,
  • "title": "string",
  • "tags": [
    ],
  • "open": true,
  • "createdAt": 0,
  • "closedAt": 0,
  • "by": "string",
  • "comments": [
    ],
  • "lastModificationAt": 0,
  • "apiVersion": "string"
}

Response samples

Content type
application/json
{
  • "_id": "string",
  • "seqId": 0,
  • "_tenant": "string",
  • "_deleted": true,
  • "title": "string",
  • "tags": [
    ],
  • "open": true,
  • "createdAt": 0,
  • "closedAt": 0,
  • "by": "string",
  • "comments": [
    ],
  • "lastModificationAt": 0,
  • "apiVersion": "string"
}

post

delete a post

path Parameters
id
required
string

Responses

Response samples

Content type
application/json
{
  • "done": true
}

update a post with JSON patch or by merging JSON object

path Parameters
id
required
string
Request Body schema: application/json
required

the patch to update the post or a JSON object

One of
Array
op
required
string
Enum: "add" "replace" "remove" "copy" "test"
path
required
string
value
any

Responses

Request samples

Content type
application/json
Example
[ ]

Response samples

Content type
application/json
{
  • "error": "string"
}

update a post

path Parameters
id
required
string
Request Body schema: application/json
required

the post to update

_id
required
string
_tenant
required
string
_deleted
boolean or null
title
required
string
lastModificationAt
required
integer <timestamp>
content
string or null

Responses

Request samples

Content type
application/json
{
  • "_id": "string",
  • "_tenant": "string",
  • "_deleted": true,
  • "title": "string",
  • "lastModificationAt": 0,
  • "content": "string"
}

Response samples

Content type
application/json
{
  • "error": "string"
}

read a post

path Parameters
id
required
string

Responses

Response samples

Content type
application/json
{ }

read all post

Responses

Response samples

Content type
application/json
[
  • {
    }
]

creates a post

Request Body schema: application/json
required

the post to create

_id
required
string
_tenant
required
string
_deleted
boolean or null
title
required
string
lastModificationAt
required
integer <timestamp>
content
string or null

Responses

Request samples

Content type
application/json
{
  • "_id": "string",
  • "_tenant": "string",
  • "_deleted": true,
  • "title": "string",
  • "lastModificationAt": 0,
  • "content": "string"
}

Response samples

Content type
application/json
{
  • "_id": "string",
  • "_tenant": "string",
  • "_deleted": true,
  • "title": "string",
  • "lastModificationAt": 0,
  • "content": "string"
}

translation

delete a translation

path Parameters
id
required
string

Responses

Response samples

Content type
application/json
{
  • "done": true
}

update a translation with JSON patch or by merging JSON object

path Parameters
id
required
string
Request Body schema: application/json
required

the patch to update the translation or a JSON object

One of
Array
op
required
string
Enum: "add" "replace" "remove" "copy" "test"
path
required
string
value
any

Responses

Request samples

Content type
application/json
Example
[ ]

Response samples

Content type
application/json
{
  • "error": "string"
}

update a translation

path Parameters
id
required
string
Request Body schema: application/json
required

the translation to update

_id
required
string
_tenant
required
string
language
required
string
key
required
string
value
required
string
lastModificationAt
integer or null <timestamp>

Responses

Request samples

Content type
application/json
{
  • "_id": "string",
  • "_tenant": "string",
  • "language": "string",
  • "key": "string",
  • "value": "string",
  • "lastModificationAt": 0
}

Response samples

Content type
application/json
{
  • "error": "string"
}

read a translation

path Parameters
id
required
string

Responses

Response samples

Content type
application/json
{ }

read all translation

Responses

Response samples

Content type
application/json
[
  • {
    }
]

creates a translation

Request Body schema: application/json
required

the translation to create

_id
required
string
_tenant
required
string
language
required
string
key
required
string
value
required
string
lastModificationAt
integer or null <timestamp>

Responses

Request samples

Content type
application/json
{
  • "_id": "string",
  • "_tenant": "string",
  • "language": "string",
  • "key": "string",
  • "value": "string",
  • "lastModificationAt": 0
}

Response samples

Content type
application/json
{
  • "_id": "string",
  • "_tenant": "string",
  • "language": "string",
  • "key": "string",
  • "value": "string",
  • "lastModificationAt": 0
}

usage-plan

delete a usage-plan

path Parameters
id
required
string

Responses

Response samples

Content type
application/json
{
  • "done": true
}

update a usage-plan with JSON patch or by merging JSON object

path Parameters
id
required
string
Request Body schema: application/json
required

the patch to update the usage-plan or a JSON object

One of
Array
op
required
string
Enum: "add" "replace" "remove" "copy" "test"
path
required
string
value
any

Responses

Request samples

Content type
application/json
Example
[ ]

Response samples

Content type
application/json
{
  • "error": "string"
}

update a usage-plan

path Parameters
id
required
string
Request Body schema: application/json
required

the usage-plan to update

_id
required
string
_tenant
required
string
_deleted
boolean or null
object (Currency)

Currency

customName
required
string
customDescription
string or null
object (OtoroshiTarget)

Otoroshi target

object (BillingDuration)

BillingDuration

allowMultipleKeys
boolean or null
visibility
string
Enum: "Public" "Private" "Admin"
authorizedTeams
Array of strings
autoRotation
boolean or null
required
Array of SubscriptionDemandStep.Email (object) or SubscriptionDemandStep.TeamAdmin (object) or SubscriptionDemandStep.Payment (object) or SubscriptionDemandStep.HttpRequest (object)
integrationProcess
required
string
Enum: "Automatic" "ApiKey"
aggregationApiKeysSecurity
boolean or null
object (SwaggerAccess)

SwaggerAccess

object (Testing)

Testing

object (ApiDocumentation)

ApiDocumentation

maxPerSecond
integer or null <int64>
maxPerDay
integer or null <int64>
maxPerMonth
integer or null <int64>
costPerMonth
integer or null <float64>
costPerRequest
integer or null <float64>
object (BillingDuration)

BillingDuration

(PaymentSettings.Stripe (object or null))

Responses

Request samples

Content type
application/json
{
  • "_id": "string",
  • "_tenant": "string",
  • "_deleted": true,
  • "currency": {
    },
  • "customName": "string",
  • "customDescription": "string",
  • "otoroshiTarget": {
    },
  • "billingDuration": {
    },
  • "allowMultipleKeys": true,
  • "visibility": "Public",
  • "authorizedTeams": [
    ],
  • "autoRotation": true,
  • "subscriptionProcess": [
    ],
  • "integrationProcess": "Automatic",
  • "aggregationApiKeysSecurity": true,
  • "swagger": {
    },
  • "testing": {
    },
  • "documentation": {
    },
  • "maxPerSecond": 0,
  • "maxPerDay": 0,
  • "maxPerMonth": 0,
  • "costPerMonth": 0,
  • "costPerRequest": 0,
  • "trialPeriod": {
    },
  • "paymentSettings": {
    }
}

Response samples

Content type
application/json
{
  • "error": "string"
}

read a usage-plan

path Parameters
id
required
string

Responses

Response samples

Content type
application/json
{
  • "_id": "string",
  • "_tenant": "string",
  • "_deleted": true,
  • "currency": {
    },
  • "customName": "string",
  • "customDescription": "string",
  • "otoroshiTarget": {
    },
  • "billingDuration": {
    },
  • "allowMultipleKeys": true,
  • "visibility": "Public",
  • "authorizedTeams": [
    ],
  • "autoRotation": true,
  • "subscriptionProcess": [
    ],
  • "integrationProcess": "Automatic",
  • "aggregationApiKeysSecurity": true,
  • "swagger": {
    },
  • "testing": {
    },
  • "documentation": {
    },
  • "maxPerSecond": 0,
  • "maxPerDay": 0,
  • "maxPerMonth": 0,
  • "costPerMonth": 0,
  • "costPerRequest": 0,
  • "trialPeriod": {
    },
  • "paymentSettings": {
    }
}

read all usage-plan

Responses

Response samples

Content type
application/json
[
  • {
    }
]

creates a usage-plan

Request Body schema: application/json
required

the usage-plan to create

_id
required
string
_tenant
required
string
_deleted
boolean or null
object (Currency)

Currency

customName
required
string
customDescription
string or null
object (OtoroshiTarget)

Otoroshi target

object (BillingDuration)

BillingDuration

allowMultipleKeys
boolean or null
visibility
string
Enum: "Public" "Private" "Admin"
authorizedTeams
Array of strings
autoRotation
boolean or null
required
Array of SubscriptionDemandStep.Email (object) or SubscriptionDemandStep.TeamAdmin (object) or SubscriptionDemandStep.Payment (object) or SubscriptionDemandStep.HttpRequest (object)
integrationProcess
required
string
Enum: "Automatic" "ApiKey"
aggregationApiKeysSecurity
boolean or null
object (SwaggerAccess)

SwaggerAccess

object (Testing)

Testing

object (ApiDocumentation)

ApiDocumentation

maxPerSecond
integer or null <int64>
maxPerDay
integer or null <int64>
maxPerMonth
integer or null <int64>
costPerMonth
integer or null <float64>
costPerRequest
integer or null <float64>
object (BillingDuration)

BillingDuration

(PaymentSettings.Stripe (object or null))

Responses

Request samples

Content type
application/json
{
  • "_id": "string",
  • "_tenant": "string",
  • "_deleted": true,
  • "currency": {
    },
  • "customName": "string",
  • "customDescription": "string",
  • "otoroshiTarget": {
    },
  • "billingDuration": {
    },
  • "allowMultipleKeys": true,
  • "visibility": "Public",
  • "authorizedTeams": [
    ],
  • "autoRotation": true,
  • "subscriptionProcess": [
    ],
  • "integrationProcess": "Automatic",
  • "aggregationApiKeysSecurity": true,
  • "swagger": {
    },
  • "testing": {
    },
  • "documentation": {
    },
  • "maxPerSecond": 0,
  • "maxPerDay": 0,
  • "maxPerMonth": 0,
  • "costPerMonth": 0,
  • "costPerRequest": 0,
  • "trialPeriod": {
    },
  • "paymentSettings": {
    }
}

Response samples

Content type
application/json
{
  • "_id": "string",
  • "_tenant": "string",
  • "_deleted": true,
  • "currency": {
    },
  • "customName": "string",
  • "customDescription": "string",
  • "otoroshiTarget": {
    },
  • "billingDuration": {
    },
  • "allowMultipleKeys": true,
  • "visibility": "Public",
  • "authorizedTeams": [
    ],
  • "autoRotation": true,
  • "subscriptionProcess": [
    ],
  • "integrationProcess": "Automatic",
  • "aggregationApiKeysSecurity": true,
  • "swagger": {
    },
  • "testing": {
    },
  • "documentation": {
    },
  • "maxPerSecond": 0,
  • "maxPerDay": 0,
  • "maxPerMonth": 0,
  • "costPerMonth": 0,
  • "costPerRequest": 0,
  • "trialPeriod": {
    },
  • "paymentSettings": {
    }
}

subscription-demand

delete a subscription-demand

path Parameters
id
required
string

Responses

Response samples

Content type
application/json
{
  • "done": true
}

update a subscription-demand with JSON patch or by merging JSON object

path Parameters
id
required
string
Request Body schema: application/json
required

the patch to update the subscription-demand or a JSON object

One of
Array
op
required
string
Enum: "add" "replace" "remove" "copy" "test"
path
required
string
value
any

Responses

Request samples

Content type
application/json
Example
[ ]

Response samples

Content type
application/json
{
  • "error": "string"
}

update a subscription-demand

path Parameters
id
required
string
Request Body schema: application/json
required

the subscription-demand to update

_id
required
string
_tenant
required
string
_deleted
boolean
api
required
string
plan
required
string
required
Array of SubscriptionDemandStep.Email (object) or SubscriptionDemandStep.TeamAdmin (object) or SubscriptionDemandStep.Payment (object) or SubscriptionDemandStep.HttpRequest (object)
required
object (SubscriptionDemandState)

SubscriptionDemandStep

team
required
string
from
required
string
date
required
integer <timestamp>
motivation
string or null
parentSubscriptionId
string or null
customReadOnly
boolean or null
customMetadata
object
customMaxPerSecond
integer or null <int64>
customMaxPerDay
integer or null <int64>
customMaxPerMonth
integer or null <int64>
adminCustomName
string or null

Responses

Request samples

Content type
application/json
{
  • "_id": "string",
  • "_tenant": "string",
  • "_deleted": true,
  • "api": "string",
  • "plan": "string",
  • "steps": [
    ],
  • "state": {
    },
  • "team": "string",
  • "from": "string",
  • "date": 0,
  • "motivation": "string",
  • "parentSubscriptionId": "string",
  • "customReadOnly": true,
  • "customMetadata": { },
  • "customMaxPerSecond": 0,
  • "customMaxPerDay": 0,
  • "customMaxPerMonth": 0,
  • "adminCustomName": "string"
}

Response samples

Content type
application/json
{
  • "error": "string"
}

read a subscription-demand

path Parameters
id
required
string

Responses

Response samples

Content type
application/json
{ }

read all subscription-demand

Responses

Response samples

Content type
application/json
[
  • {
    }
]

creates a subscription-demand

Request Body schema: application/json
required

the subscription-demand to create

_id
required
string
_tenant
required
string
_deleted
boolean
api
required
string
plan
required
string
required
Array of SubscriptionDemandStep.Email (object) or SubscriptionDemandStep.TeamAdmin (object) or SubscriptionDemandStep.Payment (object) or SubscriptionDemandStep.HttpRequest (object)
required
object (SubscriptionDemandState)

SubscriptionDemandStep

team
required
string
from
required
string
date
required
integer <timestamp>
motivation
string or null
parentSubscriptionId
string or null
customReadOnly
boolean or null
customMetadata
object
customMaxPerSecond
integer or null <int64>
customMaxPerDay
integer or null <int64>
customMaxPerMonth
integer or null <int64>
adminCustomName
string or null

Responses

Request samples

Content type
application/json
{
  • "_id": "string",
  • "_tenant": "string",
  • "_deleted": true,
  • "api": "string",
  • "plan": "string",
  • "steps": [
    ],
  • "state": {
    },
  • "team": "string",
  • "from": "string",
  • "date": 0,
  • "motivation": "string",
  • "parentSubscriptionId": "string",
  • "customReadOnly": true,
  • "customMetadata": { },
  • "customMaxPerSecond": 0,
  • "customMaxPerDay": 0,
  • "customMaxPerMonth": 0,
  • "adminCustomName": "string"
}

Response samples

Content type
application/json
{
  • "_id": "string",
  • "_tenant": "string",
  • "_deleted": true,
  • "api": "string",
  • "plan": "string",
  • "steps": [
    ],
  • "state": {
    },
  • "team": "string",
  • "from": "string",
  • "date": 0,
  • "motivation": "string",
  • "parentSubscriptionId": "string",
  • "customReadOnly": true,
  • "customMetadata": { },
  • "customMaxPerSecond": 0,
  • "customMaxPerDay": 0,
  • "customMaxPerMonth": 0,
  • "adminCustomName": "string"
}

GraphQL

search with GraphQL

Request Body schema: application/json
required

GraphQL query

One of
query
string

Responses

Request samples

Content type
application/json
{
  • "query": "string"
}

Response samples

Content type
application/json
{
  • "data": { }
}

search with GraphQL

Request Body schema: application/json
required

get GraphQL schema

One of
query
string

Responses

Request samples

Content type
application/json
{
  • "query": "string"
}

Response samples

Content type
application/json
{ }

Integration ApiKey

get apikey from integration token

path Parameters
token
required
string

integration token

Responses

Response samples

Content type
application/json
{
  • "clientName": "string",
  • "clientId": "string",
  • "clientSecret": "string"
}