Extensions

Directus can easily be extended through the addition of several types of extensions, including layouts, interfaces, and modules.

List Extensions

List the installed extensions and their configuration in the project.

Responses

Successful request
data
array
import { createDirectus, rest, readExtensions } from '@directus/sdk';

const client = createDirectus('directus_project_url').with(rest());

const result = await client.request(readExtensions());
Response Example
{
  "data": [
    {
      "bundle": "my-bundle"
    }
  ]
}

Delete an Extension

Delete an installed extension by its unique identifier.

Query Parameters

id
string

Unique identifier for the object.

Responses

No Content
// Not supported in Directus SDK

Update an Extension

Update the configuration of an installed extension (e.g. enable or disable it).

Query Parameters

id
string

Unique identifier for the object.

Request Body

meta
object

Directus metadata for the extension. Where the configuration for the extension in the current project is stored.

Responses

Successful request
data
object
// Not supported in Directus SDK
Response Example
{
  "data": {
    "bundle": "my-bundle"
  }
}

List Registry Extensions

Search the Directus extension marketplace registry. Admin only.

Query Parameters

search
string

Filter by items that contain the given search query in one of their fields.

limit
integer

A limit on the number of objects that are returned.

offset
integer

How many items to skip when fetching data.

sort
array

How to sort the returned items. sort is a CSV of fields used to sort the fetched items. Sorting defaults to ascending (ASC) order but a minus sign (-) can be used to reverse this to descending (DESC) order. Fields are prioritized by their order in the CSV.

filter

Select items in collection by given conditions.

Responses

Successful request
data
array
// Not supported in Directus SDK
Response Example
{
  "data": [
    {}
  ]
}

Install Extension from Registry

Install an extension from the Directus marketplace registry by its ID and version. Admin only.

Request Body

extension
string

Registry extension UUID.

version
string

Version string to install (e.g. 1.2.3).

Responses

Extension installed successfully.
// Not supported in Directus SDK

Reinstall Extension from Registry

Reinstall a previously installed registry extension, fetching the latest files for its current version. Admin only.

Request Body

extension
string

Registry extension UUID.

Responses

Extension reinstalled successfully.
// Not supported in Directus SDK

Uninstall Extension from Registry

Uninstall a registry-installed extension by its unique identifier. Admin only.

Query Parameters

id
string

Unique identifier for the object.

Responses

No Content
// Not supported in Directus SDK