4.0 KiB
pageClass
| pageClass |
|---|
| page-reference |
Settings
Settings are key-value pairs that are stored in the database, and control different aspects of the project. Only administrators have access to manage Settings.
The Settings Object
id uuid
Primary key of the setting.
project_name string
Name of the project, shown in the Admin App.
project_descriptor string
Descriptor of the project, shown in the Admin App.
project_url string
Link to the (public) website that goes with this project.
project_color string
Brand color for the current project.
project_logo many-to-one
Primary logo for the current project. Many-to-one to files.
public_foreground many-to-one
Foreground image for the Admin App's public pages. Many-to-one to files.
public_background many-to-one
Background image for the Admin App's public pages. Many-to-one to files.
public_note string
Note shown on the Admin App's public pages. Supports Markdown.
auth_login_attempts integer
How often a user is allowed to try to login. After which times the user will be suspended.
auth_password_policy RegEx
What regex passwords must pass in order to be valid.
storage_asset_transform string
If the transform endpoints are allowed to be used on the assets endpoint. One
of all, none or presets.
storage_asset_presets array
What preset keys exist in the assets endpoint.
custom_css string
CSS rules to override the App's default styling.
storage_default_folder uuid
Folder for uploaded files. Does not affect existing files.
basemaps array
Custom tiles to overriding the Mapbox defaults.
mapbox_key string
Mapbox Access Token.
module_bar array
What modules are enabled/added globally.
{
"data": {
"id": 1,
"project_name": "Directus",
"project_descriptor": "Application",
"project_url": null,
"project_color": null,
"project_logo": null,
"public_foreground": null,
"public_background": null,
"public_note": null,
"auth_login_attempts": 25,
"auth_password_policy": null,
"storage_asset_transform": "all",
"storage_asset_presets": [
{ "key": "small", "fit": "cover", "width": 200, "height": 161, "quality": 80, "withoutEnlargement": false }
],
"custom_css": null,
"storage_default_folder": null,
"basemaps": null,
"mapbox_key": null,
"module_bar": null
}
}
Retrieve Settings
REST API
GET /settings
GraphQL
POST /graphql/system
type Query {
settings: directus_settings
}
Example
query {
settings {
project_name
}
}
Update Settings
Query Parameters
Supports all global query parameters.
Request Body
A partial settings object.
Returns
Returns the settings object.
REST API
PATCH /settings
Example
// PATCH /settings
{
"project_url": "https://example.com/"
}
GraphQL
POST /graphql/system
type Mutation {
update_settings(data: update_directus_settings_input!): directus_settings
}
Example
mutation {
update_settings(data: { project_url: "https://example.com" }) {
project_name
project_url
}
}