---
title: "Konnect Sliver DCR"
url: "https://nov18-dev.movespot.fyi/apis/konnect-sliver-dcr-dev-0/versions/f13250cb-053c-4f2d-b0e4-ed0e59c34cec"
---

# Konnect Sliver DCR

OpenAPI specification document.

```json
{"openapi":"3.0.3","info":{"title":"Konnect Sliver DCR","version":"0.0.1"},"servers":[{"url":"https://us.api.konghq.com/oauth2/v1","description":"United-States Production region"},{"url":"https://eu.api.konghq.com/oauth2/v1","description":"Europe Production region"},{"url":"https://au.api.konghq.com/oauth2/v1","description":"Australia Production region"},{"url":"https://me.api.konghq.com/oauth2/v1","description":"Middle-East Production region"},{"url":"https://in.api.konghq.com/oauth2/v1","description":"India Production region"},{"url":"https://sg.api.konghq.com/oauth2/v1","description":"Singapore Production region"}],"paths":{"/clients":{"get":{"operationId":"listClients","summary":"List all clients the auth server","description":"List all clients for the auth server","parameters":[{"$ref":"#/components/parameters/PageSize"},{"$ref":"#/components/parameters/PageNumber"}],"responses":{"200":{"$ref":"#/components/responses/DCRClientList"}},"tags":["dcrmanagement"]},"post":{"operationId":"createClient","summary":"Create a new client in the auth server","description":"Create a new client in the auth server","requestBody":{"$ref":"#/components/requestBodies/CreateDCRClient"},"responses":{"201":{"$ref":"#/components/responses/DCRClient"},"400":{"$ref":"#/components/responses/BadRequest"}},"tags":["dcrmanagement"]}},"/clients/{clientId}":{"parameters":[{"$ref":"#/components/parameters/clientId"}],"get":{"operationId":"getClient","summary":"Get a client for given auth server","description":"Get a client for given auth server","responses":{"200":{"$ref":"#/components/responses/DCRClient"},"404":{"$ref":"#/components/responses/NotFound"}},"tags":["dcrmanagement"]},"put":{"operationId":"replaceClient","summary":"Replace a client","description":"Replace a client","requestBody":{"$ref":"#/components/requestBodies/CreateDCRClient"},"responses":{"200":{"$ref":"#/components/responses/DCRClient"},"400":{"$ref":"#/components/responses/BadRequest"}},"tags":["dcrmanagement"]},"delete":{"operationId":"deleteClient","summary":"Delete a client for a given auth server","description":"Delete a client for a given auth server","responses":{"204":{"description":"Success"},"404":{"$ref":"#/components/responses/NotFound"}},"tags":["dcrmanagement"]}},"/clients/{clientId}/secrets":{"parameters":[{"$ref":"#/components/parameters/clientId"}],"get":{"operationId":"listClientSecrets","summary":"List client secrets","description":"List all secrets for a given client.","parameters":[{"$ref":"#/components/parameters/PageSize"},{"$ref":"#/components/parameters/PageNumber"},{"name":"sort","in":"query","description":"Sorts a collection of secrets. Supported sort attributes are:\n- created_at\n- updated_at\n","required":false,"schema":{"$ref":"#/components/schemas/SortQuery"}},{"name":"filter","in":"query","description":"Filter secrets returned in the response.","required":false,"schema":{"type":"object","properties":{"id":{"$ref":"#/components/schemas/StringFieldEqualsFilter"},"enabled":{"$ref":"#/components/schemas/BooleanFieldFilter"}}},"style":"deepObject"}],"responses":{"200":{"$ref":"#/components/responses/ClientSecretList"},"404":{"$ref":"#/components/responses/NotFound"}},"tags":["dcrmanagement"]},"post":{"operationId":"createClientSecret","summary":"Create a client secret","description":"Create a new client secret for a given client. Multiple secrets can be active simultaneously for a single client.","requestBody":{"$ref":"#/components/requestBodies/CreateSecretPayload"},"responses":{"201":{"$ref":"#/components/responses/ClientSecretBody"},"400":{"$ref":"#/components/responses/BadRequest"},"404":{"$ref":"#/components/responses/NotFound"}},"tags":["dcrmanagement"]}},"/clients/{clientId}/secrets/{clientSecretId}":{"parameters":[{"$ref":"#/components/parameters/clientId"},{"$ref":"#/components/parameters/clientSecretId"}],"get":{"operationId":"getClientSecret","summary":"Get a client secret","description":"Get a specific client secret for a given client.","responses":{"200":{"$ref":"#/components/responses/ClientSecretBody"},"404":{"$ref":"#/components/responses/NotFound"}},"tags":["dcrmanagement"]},"delete":{"operationId":"deleteClientSecret","summary":"Delete a client secret","description":"Delete a client secret for a given client. This action is irreversible.","responses":{"204":{"description":"Success"},"404":{"$ref":"#/components/responses/NotFound"}},"tags":["dcrmanagement"]}},"/clients/{clientId}/lifecycle/new-secret":{"parameters":[{"$ref":"#/components/parameters/clientId"}],"post":{"operationId":"refreshClientSecret","summary":"Refresh the secret of a client","description":"Refresh the secret of a client","responses":{"200":{"$ref":"#/components/responses/DCRClient"}},"tags":["dcrmanagement"]}}},"components":{"parameters":{"clientId":{"schema":{"$ref":"#/components/schemas/ClientId"},"name":"clientId","in":"path","required":true,"description":"The OAuth 2.0 client ID"},"clientSecretId":{"schema":{"type":"string","format":"uuid","example":"07d05309-45cc-4b37-92fb-1524846deec3"},"name":"clientSecretId","in":"path","required":true,"description":"The client secret ID"},"PageNumber":{"name":"page[number]","description":"Determines which page of the entities to retrieve.","required":false,"in":"query","allowEmptyValue":true,"schema":{"type":"integer","example":1}},"PageSize":{"name":"page[size]","description":"The maximum number of items to include per page. The last page of a collection may include fewer items.","required":false,"in":"query","allowEmptyValue":true,"schema":{"type":"integer","example":10}}},"schemas":{"ApplicationType":{"description":"Type of the application","type":"string","enum":["machine"]},"TokenEndpointAuthMethod":{"description":"Requested authentication method for OAuth 2.0 endpoints.","type":"string","enum":["client_secret_post","none"]},"ResponseTypes":{"description":"OAUTH 2.0 response type","type":"string","enum":["code","id_token","token"]},"DCRClient":{"type":"object","properties":{"client_id":{"description":"The OAuth 2.0 client ID","type":"string","example":"kYa9iQFU5xPDSIUH9z1z","readOnly":true},"client_id_issued_at":{"description":"unix-epoch time when the client got issued","type":"integer","readOnly":true},"client_name":{"description":"name of the client","type":"string"},"client_secret":{"description":"secret of the client. This will be set only at client creation.","type":"string","nullable":true,"readOnly":true},"client_secret_expires_at":{"description":"unix-epoch time when the secret expires. If = 0 it never expires.","type":"integer","readOnly":true},"application_type":{"$ref":"#/components/schemas/ApplicationType"},"grant_types":{"$ref":"#/components/schemas/GrantTypes"},"token_endpoint_auth_method":{"$ref":"#/components/schemas/TokenEndpointAuthMethod"},"response_types":{"type":"array","items":{"$ref":"#/components/schemas/ResponseTypes"}},"labels":{"$ref":"#/components/schemas/Labels"},"redirect_uris":{"description":"Array of redirection URI strings for use in redirect-based flows","type":"array","items":{"type":"string"}}},"required":["client_id","client_id_issued_at","client_name","client_secret_expires_at","client_secret","application_type","grant_types","token_endpoint_auth_method","response_types","redirect_uris","labels"]},"DCRClientList":{"type":"object","properties":{"data":{"type":"array","items":{"$ref":"#/components/schemas/DCRClient"}},"meta":{"$ref":"#/components/schemas/PaginatedMeta"}},"required":["data","meta"]},"CreateDCRClientPayload":{"type":"object","properties":{"client_name":{"description":"name of the client","type":"string"},"application_type":{"$ref":"#/components/schemas/ApplicationType"},"grant_types":{"$ref":"#/components/schemas/GrantTypes"},"token_endpoint_auth_method":{"$ref":"#/components/schemas/TokenEndpointAuthMethod"},"response_types":{"type":"array","items":{"$ref":"#/components/schemas/ResponseTypes"}},"redirect_uris":{"description":"Array of redirection URI strings for use in redirect-based flows","type":"array","items":{"type":"string"}},"labels":{"$ref":"#/components/schemas/Labels"}},"required":["client_name","application_type","grant_types","token_endpoint_auth_method","response_types","redirect_uris"]},"GrantType":{"description":"OAuth 2.0 grant type","type":"string","enum":["authorization_code","implicit","client_credentials","refresh_token"]},"GrantTypes":{"description":"List of OAuth 2.0 grant types","type":"array","items":{"$ref":"#/components/schemas/GrantType"},"nullable":false,"uniqueItems":true},"Labels":{"description":"Labels store metadata of an entity that can be used for filtering an entity list or for searching across entity types. \n\nKeys must be of length 1-63 characters, and cannot start with \"kong\", \"konnect\", \"mesh\", \"kic\", or \"_\".\n","type":"object","example":{"env":"test"},"additionalProperties":{"type":"string","pattern":"^[a-z0-9A-Z]{1}([a-z0-9A-Z-._]*[a-z0-9A-Z]+)?$","minLength":1,"maxLength":63},"maxProperties":50,"title":"Labels"},"PageMeta":{"description":"Contains pagination query parameters and the total number of objects returned.","type":"object","properties":{"number":{"type":"number","example":1},"size":{"type":"number","example":10},"total":{"type":"number","example":100}},"required":["number","size","total"]},"PaginatedMeta":{"description":"returns the pagination information","type":"object","properties":{"page":{"$ref":"#/components/schemas/PageMeta"}},"required":["page"],"title":"PaginatedMeta"},"BaseError":{"description":"standard error","type":"object","properties":{"status":{"description":"The HTTP status code of the error. Useful when passing the response\nbody to child properties in a frontend UI. Must be returned as an integer.\n","type":"integer","readOnly":true},"title":{"description":"A short, human-readable summary of the problem. It should not\nchange between occurences of a problem, except for localization.\nShould be provided as \"Sentence case\" for direct use in the UI.\n","type":"string","readOnly":true},"type":{"description":"The error type.","type":"string","readOnly":true},"instance":{"description":"Used to return the correlation ID back to the user, in the format\nkong:trace:<correlation_id>. This helps us find the relevant logs\nwhen a customer reports an issue.\n","type":"string","readOnly":true},"detail":{"description":"A human readable explanation specific to this occurence of the problem.\nThis field may contain request/entity data to help the user understand\nwhat went wrong. Enclose variable values in square brackets. Should be\nprovided as \"Sentence case\" for direct use in the UI.\n","type":"string","readOnly":true}},"required":["status","title","instance","detail"],"title":"Error"},"InvalidRules":{"description":"invalid parameters rules","type":"string","enum":["required","is_array","is_base64","is_boolean","is_date_time","is_integer","is_null","is_number","is_object","is_string","is_uuid","is_fqdn","is_arn","unknown_property","missing_reference","is_label","matches_regex","invalid","is_supported_network_availability_zone_list","is_supported_network_cidr_block","is_supported_provider_region","type"],"nullable":true,"readOnly":true},"InvalidParameterStandard":{"type":"object","properties":{"field":{"type":"string","example":"name","readOnly":true},"rule":{"$ref":"#/components/schemas/InvalidRules"},"source":{"type":"string","example":"body"},"reason":{"type":"string","example":"is a required field","readOnly":true}},"additionalProperties":false,"required":["field","reason"]},"InvalidParameterMinimumLength":{"type":"object","properties":{"field":{"type":"string","example":"name","readOnly":true},"rule":{"description":"invalid parameters rules","type":"string","enum":["min_length","min_digits","min_lowercase","min_uppercase","min_symbols","min_items","min"],"nullable":false,"readOnly":true},"minimum":{"type":"integer","example":8},"source":{"type":"string","example":"body"},"reason":{"type":"string","example":"must have at least 8 characters","readOnly":true}},"additionalProperties":false,"required":["field","reason","rule","minimum"]},"InvalidParameterMaximumLength":{"type":"object","properties":{"field":{"type":"string","example":"name","readOnly":true},"rule":{"description":"invalid parameters rules","type":"string","enum":["max_length","max_items","max"],"nullable":false,"readOnly":true},"maximum":{"type":"integer","example":8},"source":{"type":"string","example":"body"},"reason":{"type":"string","example":"must not have more than 8 characters","readOnly":true}},"additionalProperties":false,"required":["field","reason","rule","maximum"]},"InvalidParameterChoiceItem":{"type":"object","properties":{"field":{"type":"string","example":"name","readOnly":true},"rule":{"description":"invalid parameters rules","type":"string","enum":["enum"],"nullable":false,"readOnly":true},"reason":{"type":"string","example":"is a required field","readOnly":true},"choices":{"type":"array","items":{},"minItems":1,"nullable":false,"readOnly":true,"uniqueItems":true},"source":{"type":"string","example":"body"}},"additionalProperties":false,"required":["field","reason","rule","choices"]},"InvalidParameterDependentItem":{"type":"object","properties":{"field":{"type":"string","example":"name","readOnly":true},"rule":{"description":"invalid parameters rules","type":"string","enum":["dependent_fields"],"nullable":true,"readOnly":true},"reason":{"type":"string","example":"is a required field","readOnly":true},"dependents":{"type":"array","items":{},"nullable":true,"readOnly":true,"uniqueItems":true},"source":{"type":"string","example":"body"}},"additionalProperties":false,"required":["field","rule","reason","dependents"]},"InvalidParameters":{"description":"invalid parameters","type":"array","items":{"oneOf":[{"$ref":"#/components/schemas/InvalidParameterStandard"},{"$ref":"#/components/schemas/InvalidParameterMinimumLength"},{"$ref":"#/components/schemas/InvalidParameterMaximumLength"},{"$ref":"#/components/schemas/InvalidParameterChoiceItem"},{"$ref":"#/components/schemas/InvalidParameterDependentItem"}]},"minItems":1,"nullable":false,"uniqueItems":true},"BadRequestError":{"allOf":[{"$ref":"#/components/schemas/BaseError"},{"type":"object","required":["invalid_parameters"],"properties":{"invalid_parameters":{"$ref":"#/components/schemas/InvalidParameters"}}}]},"ClientId":{"description":"The OAuth 2.0 client ID","type":"string","example":"kYa9iQFU5xPDSIUH9z1z","maxLength":36,"minLength":1,"pattern":"[-_\\w]+","readOnly":true},"NotFoundError":{"allOf":[{"$ref":"#/components/schemas/BaseError"},{"type":"object","properties":{"status":{"example":404},"title":{"example":"Not Found"},"type":{"example":"https://httpstatuses.com/404"},"instance":{"example":"kong:trace:1234567890"},"detail":{"example":"Not found"}}}]},"SortQuery":{"description":"The `asc` suffix is optional as the default sort order is ascending.\nThe `desc` suffix is used to specify a descending order.\nMultiple sort attributes may be provided via a comma separated list.\nJSONPath notation may be used to specify a sub-attribute (eg: 'foo.bar desc').\n","type":"string","example":"created_at desc","title":"SortQuery"},"StringFieldEqualsFilter":{"description":"Filters on the given string field value by exact match.","oneOf":[{"type":"string"},{"type":"object","title":"StringFieldEqualsComparison","additionalProperties":false,"properties":{"eq":{"type":"string"}},"required":["eq"]}],"title":"StringFieldEqualsFilter","x-examples":{"example-1":"equals-some-value","example-2":{"eq":"some-value"}}},"BooleanFieldFilter":{"description":"Filter by a boolean value (true/false).","type":"boolean","title":"BooleanFieldFilter","x-examples":{"example-1":true}},"SecretEnabled":{"description":"Specifies whether the secret is enabled. If the secret is not enabled, it will not be usable during authentication phase.","type":"boolean","default":true},"ClientSecret":{"description":"The OAuth 2.0 client secret","type":"string","example":"YAzsyUlNZ5gNGeKS9H3VAdxVPzhPo4ae"},"CreatedAt":{"description":"An ISO-8601 timestamp representation of entity creation date.","type":"string","format":"date-time","example":"2022-11-04T20:10:06.927Z","readOnly":true},"UpdatedAt":{"description":"An ISO-8601 timestamp representation of entity update date.","type":"string","format":"date-time","example":"2022-11-04T20:10:06.927Z","readOnly":true},"ClientSecretItem":{"description":"The client secret. The secret value is only returned when creating a new secret item.","type":"object","properties":{"id":{"description":"The ID of the client secret","type":"string","format":"uuid"},"enabled":{"$ref":"#/components/schemas/SecretEnabled"},"secret":{"$ref":"#/components/schemas/ClientSecret"},"created_at":{"$ref":"#/components/schemas/CreatedAt"},"updated_at":{"$ref":"#/components/schemas/UpdatedAt"}},"required":["id","enabled","created_at","updated_at"]},"ClientSecretList":{"type":"object","properties":{"data":{"type":"array","items":{"$ref":"#/components/schemas/ClientSecretItem"}},"meta":{"$ref":"#/components/schemas/PaginatedMeta"}},"required":["data","meta"]},"CreateSecretPayload":{"type":"object","properties":{"secret":{"$ref":"#/components/schemas/ClientSecret"},"enabled":{"$ref":"#/components/schemas/SecretEnabled"}}}},"examples":{"DCRClientList":{"value":{"data":[{"client_id":"kYa9iQFU5xPDSIUH9z1z","client_name":"Client 1","client_id_issued_at":1742314963,"client_secret":"$€cr€T","client_secret_expires_at":0,"application_type":"machine","grant_types":["client_credentials"],"token_endpoint_auth_method":"client_secret_post","response_types":["code"],"redirect_uris":["https://mycompany.com/"],"labels":{"env":"production"}},{"client_id":"ZYa9iQFU5xPDSIUH9z1z","client_name":"Client 2","client_id_issued_at":1742314963,"client_secret":"$€cr€T2","client_secret_expires_at":0,"application_type":"machine","grant_types":["client_credentials"],"token_endpoint_auth_method":"client_secret_post","response_types":["code"],"labels":{"env":"production"},"redirect_uris":["https://mylogo.com/"]}],"meta":{"page":{"number":1,"size":2,"total":2}}}},"DCRClient":{"value":{"client_id":"kYa9iQFU5xPDSIUH9z1z","client_name":"Client 1","client_id_issued_at":1742314963,"client_secret":"$€cr€T","client_secret_expires_at":0,"application_type":"machine","grant_types":["client_credentials"],"token_endpoint_auth_method":"client_secret_post","response_types":["code"],"labels":{"env":"production"},"redirect_uris":["https://mycompany.com/"]}},"CreateDCRClientPayload":{"value":{"client_name":"kYa9iQFU5xPDSIUH9z1z","application_type":"machine","grant_types":["client_credentials"],"token_endpoint_auth_method":"client_secret_post","response_types":["code"],"redirect_uris":["https://mycompany.com/"]}},"NotFoundExample":{"value":{"status":404,"title":"Not Found","instance":"kong:trace:6816496025408232265","detail":"Not Found"}},"ClientSecretList":{"value":{"data":[{"id":"f44567da-a0b1-4eef-86c9-b27ab2e22048","enabled":true,"created_at":"2023-03-20T09:29:14.52Z","updated_at":"2023-03-21T09:29:14.52Z"},{"id":"5e051473-3b98-45c9-aa99-75b18c158bbf","enabled":false,"created_at":"2023-03-19T09:29:14.52Z","updated_at":"2023-03-20T09:29:14.52Z"}],"meta":{"page":{"number":1,"size":2,"total":2}}}},"ClientSecretBody":{"value":{"id":"f44567da-a0b1-4eef-86c9-b27ab2e22048","enabled":true,"secret":"YAzsyUlNZ5gNGeKS9H3VAdxVPzhPo4ae","created_at":"2023-03-20T09:29:14.52Z","updated_at":"2023-03-21T09:29:14.52Z"}}},"requestBodies":{"CreateDCRClient":{"description":"Client to be created","required":true,"content":{"application/json":{"schema":{"$ref":"#/components/schemas/CreateDCRClientPayload"},"examples":{"CreateDCRClientPayload":{"$ref":"#/components/examples/CreateDCRClientPayload"}}}}},"CreateSecretPayload":{"description":"Secret to be created","required":true,"content":{"application/json":{"schema":{"$ref":"#/components/schemas/CreateSecretPayload"}}}}},"responses":{"DCRClient":{"description":"client","content":{"application/json":{"schema":{"$ref":"#/components/schemas/DCRClient"},"examples":{"DCRClient":{"$ref":"#/components/examples/DCRClient"}}}}},"DCRClientList":{"description":"List of clients","content":{"application/json":{"schema":{"$ref":"#/components/schemas/DCRClientList"},"examples":{"DCRClientList":{"$ref":"#/components/examples/DCRClientList"}}}}},"BadRequest":{"description":"Bad Request","content":{"application/problem+json":{"schema":{"$ref":"#/components/schemas/BadRequestError"}}}},"NotFound":{"description":"Not Found","content":{"application/problem+json":{"schema":{"$ref":"#/components/schemas/NotFoundError"},"examples":{"NotFoundExample":{"$ref":"#/components/examples/NotFoundExample"}}}}},"ClientSecretList":{"description":"List of client Secrets","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ClientSecretList"},"examples":{"ClientSecretList":{"$ref":"#/components/examples/ClientSecretList"}}}}},"ClientSecretBody":{"description":"A Client Secret item","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ClientSecretItem"},"examples":{"ClientSecretBody":{"$ref":"#/components/examples/ClientSecretBody"}}}}}},"securitySchemes":{"systemAccountAccessToken":{"type":"http","scheme":"bearer","bearerFormat":"Token","description":"The system account access token is meant for automations and integrations that are not directly associated with a human identity.\nYou can generate a system account Access Token by creating a system account and then obtaining a system account access token for that account.\nThe access token must be passed in the header of a request, for example:\n`curl -X GET 'https://global.api.konghq.com/v2/users/' --header 'Authorization: Bearer spat_i2Ej...'`\n"},"personalAccessToken":{"type":"http","scheme":"bearer","bearerFormat":"Token","description":"The personal access token is meant to be used as an alternative to basic-auth when accessing Konnect via APIs.\nYou can generate a Personal Access Token (PAT) from the [personal access token page](https://cloud.konghq.com/global/account/tokens/) in the Konnect dashboard.\nThe PAT token must be passed in the header of a request, for example:\n`curl -X GET 'https://global.api.konghq.com/v2/users/' --header 'Authorization: Bearer kpat_xgfT...'`\n"},"konnectAccessToken":{"type":"http","scheme":"bearer","bearerFormat":"JWT","description":"The Konnect access token is meant to be used by the Konnect dashboard and the decK CLI authenticate with.\n"}}},"tags":[{"name":"dcrmanagement","description":"Auth server Dynamic Client Registration management API"}],"security":[{"systemAccountAccessToken":[]},{"personalAccessToken":[]},{"konnectAccessToken":[]}]}
```
