Import Configuration
POST
/config-ops/import/
const url = 'https://example.com/api/config-ops/import/?mode=merge';const options = { method: 'POST', headers: {Authorization: 'Bearer <token>', 'Content-Type': 'application/json'}, body: '{"settings":{},"oauth_providers":[{}]}'};
try { const response = await fetch(url, options); const data = await response.json(); console.log(data);} catch (error) { console.error(error);}curl --request POST \ --url 'https://example.com/api/config-ops/import/?mode=merge' \ --header 'Authorization: Bearer <token>' \ --header 'Content-Type: application/json' \ --data '{ "settings": {}, "oauth_providers": [ {} ] }'Import configuration in merge or overwrite mode.
Merge mode: updates existing settings and OAuth providers, adds new ones. Overwrite mode: replaces all settings and OAuth providers.
Authorizations
Section titled “Authorizations ”Parameters
Section titled “ Parameters ”Query Parameters
Section titled “Query Parameters ” mode
Mode
string
Request Body required
Section titled “Request Body required ” Media type application/json
ConfigImportRequest
Payload for importing configuration.
object
oauth_providers
Any of:
Array<object>
object
key
additional properties
any
null
Example generated
{ "settings": {}, "oauth_providers": [ {} ]}Responses
Section titled “ Responses ”Successful Response
Media type application/json
ImportResult
Summary of what was applied during an import.
object
settings_applied
required
Settings Applied
Number of settings successfully updated.
integer
settings_skipped
required
Settings Skipped
Number of settings skipped (no change or unknown key).
integer
oauth_created
required
Oauth Created
Number of new OAuth providers created.
integer
oauth_updated
required
Oauth Updated
Number of existing OAuth providers updated.
integer
oauth_deleted
required
Oauth Deleted
Number of OAuth providers deleted (overwrite mode only).
integer
Example generated
{ "settings_applied": 1, "settings_skipped": 1, "oauth_created": 1, "oauth_updated": 1, "oauth_deleted": 1}Bad request — invalid query parameters or payload
ProblemDetail
object
type
Type
string
title
required
Title
string
status
required
Status
integer
detail
required
Detail
string
Example
{ "type": "about:blank"}Unauthorized — missing or invalid credentials
ProblemDetail
object
type
Type
string
title
required
Title
string
status
required
Status
integer
detail
required
Detail
string
Example
{ "type": "about:blank"}Forbidden — caller lacks access to this resource
ProblemDetail
object
type
Type
string
title
required
Title
string
status
required
Status
integer
detail
required
Detail
string
Example
{ "type": "about:blank"}Not found
ProblemDetail
object
type
Type
string
title
required
Title
string
status
required
Status
integer
detail
required
Detail
string
Example
{ "type": "about:blank"}Validation error
ProblemDetail
object
type
Type
string
title
required
Title
string
status
required
Status
integer
detail
required
Detail
string
Example
{ "type": "about:blank"}Internal server error
ProblemDetail
object
type
Type
string
title
required
Title
string
status
required
Status
integer
detail
required
Detail
string
Example
{ "type": "about:blank"}