https://manage.kontent.ai/v2/projects/{environment_id}/custom-appshttps://manage.kontent.ai/v2/projects/{environment_id}/custom-appshttps://manage.kontent.ai/v2/projects/{environment_id}/custom-apps/{custom_app_identifier}https://manage.kontent.ai/v2/projects/{environment_id}/custom-apps/{custom_app_identifier}https://manage.kontent.ai/v2/projects/{environment_id}/custom-apps/{custom_app_identifier}environment_idThe custom app to be added.
namecodenamesource_urlidnamecodenameenvironment_idx-continuationcustom_apps[]environment_idcustom_app_identifieridnamecodenameenvironment_idcustom_app_identifierThe operations to perform on the specified custom app object.
idnamecodenameenvironment_idcustom_app_identifierconfigallowed_roles[]source_urlconfigallowed_roles[]paginationsource_urlconfigallowed_roles[]opvalueproperty_namesource_urlconfigallowed_roles[]x-continuation header parameter to the value of the continuation_token property.f4b3fc05-e988-4dae-9ac1-a94aba566474) or codename (e.g., codename/custom_app_codename).f4b3fc05-e988-4dae-9ac1-a94aba566474) or codename (e.g., codename/custom_app_codename).f4b3fc05-e988-4dae-9ac1-a94aba566474) or codename (e.g., codename/custom_app_codename).[], any user can use the custom app.If you want to allow a role to manage the custom app's settings, adjust role permissions so they have the Manage custom apps permission.[], any user can use the custom app.If you want to allow a role to manage the custom app's settings, adjust role permissions so they have the Manage custom apps permission.[], any user can use the custom app.If you want to allow a role to manage the custom app's settings, adjust role permissions so they have the Manage custom apps permission.[], any user can use the custom app.If you want to allow a role to manage the custom app's settings, adjust role permissions so they have the Manage custom apps permission.idnamecodenamesource_urlconfigallowed_roles[][], any user can use the custom app.If you want to allow a role to manage the custom app's settings, adjust role permissions so they have the Manage custom apps permission.{"id": "f8f0b5cb-f5b7-42e8-af85-fbdab3ddfacf","name": "Custom App Name","codename": "custom_app_codename","source_url": "https://customapp.net","config": ""{\"theme\":{\"color\":\"#007BFF\",\"logo_url\":\"https://assets.customapp.net/logo.png\"},\"features\":{\"enable_notifications\":true,\"enable_advanced_mode\":false}}"","allowed_roles": [
{
"id": "7740a768-bfa5-4f64-bab4-d77cc0791d4c"
},
{
"id": "7a51d721-7302-4a85-b4ce-a6a3f3cce4a6"
}
]}{
"custom_apps": [
{
"id": "f8f0b5cb-f5b7-42e8-af85-fbdab3ddfacf",
"name": "Custom App Name",
"codename": "custom_app_codename",
"source_url": "https://customapp.net",
"config": "\"{\"theme\":{\"color\":\"#007BFF\",\"logo_url\":\"https://assets.customapp.net/logo.png\"},\"features\":{\"enable_notifications\":true,\"enable_advanced_mode\":false}}\"",
"allowed_roles": [
{
"id": "7740a768-bfa5-4f64-bab4-d77cc0791d4c"
},
{
"id": "7a51d721-7302-4a85-b4ce-a6a3f3cce4a6"
}
]
}
],
"pagination": {
"continuation_token": "W3sidG9rZW4iOiIrUklEOn...",
"next_page": null
}
}{
"request_id": "00000000-0000-0000-8918-0080000000cd",
"error_code": 100,
"message": "The requested custom app 'f4b3fc05-e988-4dae-9ac1-a94aba566474' was not found."
}{"id": "f8f0b5cb-f5b7-42e8-af85-fbdab3ddfacf","name": "Custom App Name","codename": "custom_app_codename","source_url": "https://customapp.net","config": ""{\"theme\":{\"color\":\"#007BFF\",\"logo_url\":\"https://assets.customapp.net/logo.png\"},\"features\":{\"enable_notifications\":true,\"enable_advanced_mode\":false}}"","allowed_roles": [
{
"id": "7740a768-bfa5-4f64-bab4-d77cc0791d4c"
},
{
"id": "7a51d721-7302-4a85-b4ce-a6a3f3cce4a6"
}
]}// Tip: Find more about .NET SDKs at https://kontent.ai/learn/net
using Kontent.Ai.Management;
var client = new ManagementClient(new ManagementOptions
{
ApiKey = "KONTENT_AI_MANAGEMENT_API_KEY",
EnvironmentId = "KONTENT_AI_ENVIRONMENT_ID"
});
var response = await client.ListCustomAppsAsync();// Tip: Find more about .NET SDKs at https://kontent.ai/learn/net
using Kontent.Ai.Management;
var client = new ManagementClient(new ManagementOptions
{
ApiKey = "KONTENT_AI_MANAGEMENT_API_KEY",
EnvironmentId = "KONTENT_AI_ENVIRONMENT_ID"
});
var identifier = Reference.ById(Guid.Parse("f4b3fc05-e988-4dae-9ac1-a94aba566474"));
//var identifier = Reference.ByCodename("custom_app_codename");
var response = await client.GetCustomAppAsync(identifier);{"id": "f8f0b5cb-f5b7-42e8-af85-fbdab3ddfacf","name": "Custom App Name","codename": "custom_app_codename","source_url": "https://customapp.net","config": ""{\"theme\":{\"color\":\"#007BFF\",\"logo_url\":\"https://assets.customapp.net/logo.png\"},\"features\":{\"enable_notifications\":true,\"enable_advanced_mode\":false}}"","allowed_roles": [
{
"id": "7740a768-bfa5-4f64-bab4-d77cc0791d4c"
},
{
"id": "7a51d721-7302-4a85-b4ce-a6a3f3cce4a6"
}
]}// Tip: Find more about .NET SDKs at https://kontent.ai/learn/net
using Kontent.Ai.Management;
var client = new ManagementClient(new ManagementOptions
{
ApiKey = "KONTENT_AI_MANAGEMENT_API_KEY",
EnvironmentId = "KONTENT_AI_ENVIRONMENT_ID"
});
var identifier = Reference.ById(Guid.Parse("f4b3fc05-e988-4dae-9ac1-a94aba566474"));
//var identifier = Reference.ByCodename("my_custom_app");
var response = await client.DeleteCustomAppAsync(identifier);{
"name": "My custom app",
"codename": "custom_app_codename",
"source_url": "https://customapp.net",
"config": "{\"theme\":{\"color\":\"#007BFF\",\"logo_url\":\"https://assets.customapp.net/logo.png\"},\"features\":{\"enable_notifications\":true,\"enable_advanced_mode\":false}}",
"allowed_roles": [
{
"id": "f47e5241-9b34-4586-9ef7-caac6d2f2ebe"
},
{
"codename": "project-manager"
}
]
}[
{
"op": "addInto",
"property_name": "allowed_roles",
"value": [
{
"codename": "new_allowed_role_codename_to_add"
}
]
},
{
"op": "remove",
"property_name": "allowed_roles",
"value": [
{
"codename": "allowed_role_codename_to_remove"
}
]
},
{
"op": "replace",
"property_name": "name",
"value": "New Custom App Name"
},
{
"op": "replace",
"property_name": "codename",
"value": "new_custom_app_codename"
},
{
"op": "replace",
"property_name": "source_url",
"value": "https://newcustomapplication.net"
},
{
"op": "replace",
"property_name": "config",
"value": null
},
{
"op": "replace",
"property_name": "allowed_roles",
"value": [
{
"codename": "allowed_role_codename"
},
{
"id": "f8f0b5cb-f5b7-42e8-af85-fbdab3ddfacf"
}
]
}
]{
"id": "dd1439d5-4ee2-4895-a4e4-5b0d9d8c754e",
"name": "New Custom App Name",
"codename": "new_custom_app_codename",
"source_url": "https://newcustomapplication.net",
"config": null,
"allowed_roles": [
{
"id": "dadc778e-83e4-4386-a4da-719b9456a099"
},
{
"id": "f8f0b5cb-f5b7-42e8-af85-fbdab3ddfacf"
},
{
"id": "a650d86c-3691-4c54-8771-d2f86e244475"
}
]
}