Collections | Directus Docs

List Collections

Returns a list of the collections available in the project.

Query Parameters

offset

integer

How many items to skip when fetching data.

meta

string

What metadata to return in the response.

Response

Successful request

data

array

GET /collections

Response Example

{
  "data": [
    {
      "collection": "customers",
      "translations": [],
      "item_duplication_fields": []
    }
  ]
}

Create a new collection in Directus. The `collection` and `schema` properties are required. To create a collection folder that doesn't have an underlying table, you can set `schema` to `null`. You are able to provide an array of `fields` to be created during the creation of the collection. See the fields object for more information on what properties are available in a field.

Query Parameters

meta

string

What metadata to return in the response.

Request Body

collection

string

Unique name of the collection.

fields

array

The fields contained in this collection. See the fields reference for more information. Each individual field requires field, type, and interface to be provided.

icon

string

Name of a Google Material Design Icon that's assigned to this collection.

note

string

A note describing the collection.

display_template

string

Text representation of how items from this collection are shown across the system.

hidden

boolean

Whether or not the collection is hidden from the navigation in the admin app.

singleton

boolean

Whether or not the collection is treated as a single object.

translation

string

Key value pairs of how to show this collection's name in different languages in the admin app.

versioning

boolean

Whether or not Content Versioning is enabled for this collection.

archive_field

string

What field holds the archive value.

archive_app_filter

string

What value to use for "archived" items.

archive_value

string

What value to use to "unarchive" items.

unarchive_value

string

Whether or not to show the "archived" filter.

sort_field

string

The sort field in the collection.

Response

Successful request

data

object

POST /collections

Response Example

{
  "data": {
    "collection": "customers",
    "translations": [],
    "item_duplication_fields": []
  }
}

Retrieve a Collection

Retrieves the details of a single collection by its table name.

Query Parameters

string

Unique identifier of the collection.

meta

string

What metadata to return in the response.

Response

Successful request

data

object

GET /collections/{id}

Response Example

{
  "data": {
    "collection": "customers",
    "translations": [],
    "item_duplication_fields": []
  }
}

Delete a Collection

Delete an existing collection. Warning: This will delete the whole collection, including the items within. Proceed with caution.

Query Parameters

string

Unique identifier of the collection.

DELETE /collections/{id}

Update a Collection

Update the metadata for an existing collection. You can only update the `meta` values of the collection object. Updating the collection name is not supported at this time.

Query Parameters

string

Unique identifier of the collection.

meta

string

What metadata to return in the response.

Request Body

meta

object

Metadata of the collection.

Response

Successful request

data

object

PATCH /collections/{id}

Response Example

{
  "data": {
    "collection": "customers",
    "translations": [],
    "item_duplication_fields": []
  }
}