> ## Documentation Index
> Fetch the complete documentation index at: https://docs.tryprofound.com/llms.txt
> Use this file to discover all available pages before exploring further.

# Using Drupal in Workflows

After connecting your Drupal account, the following nodes become available in Profound Workflows.

The nodes work with Drupal's [JSON:API](https://www.drupal.org/docs/core-modules-and-themes/core-modules/jsonapi-module) module. Content is accessed by a **resource type** (the entity type, such as Basic, Image, or Article) and by a **resource UUID**.

## Available nodes

> [tab] Create Item
>
> ### Create Item
>
> Create a new item of a resource type.
>
> #### Required inputs
>
> * **Drupal Site** — Select a site from the dropdown
>
> * **Resource type** — The JSON:API resource type, such as `node--article`
>
> * **Attributes** or **Relationships** (or both) — A JSON object of field values or references to other resources.
>
> > [!WARNING]
> >
> > A request with neither Attributes nor Relationships is rejected; include at least one.

> [tab] Update Item
>
> ### Update Item
>
> Update an existing item.
>
> #### Required inputs
>
> * **Drupal Site** — Select a site from the dropdown
>
> * **Resource type** — The JSON:API resource type, such as `node--article`
>
> * **Resource UUID**
>
> * **Attributes** or **Relationships** (or both) — A JSON object of field values or references to update. At least one is required.
>
> > [!NOTE]
> >
> > Only the attributes and relationships you provide are modified.

> [tab] Get Item
>
> ### Get Item
>
> Retrieve a single item.
>
> #### Required inputs
>
> * **Drupal Site** — Select a site from the dropdown
> * **Resource type** — The JSON:API resource type, such as `node--article`
> * **Resource UUID**
>
> The output includes the item's full content with attributes, relationships, and metadata from the JSON:API response.

> [tab] List Items
>
> ### List Items
>
> List items of a given resource type.
>
> #### Required inputs
>
> * **Drupal Site** — Select a site from the dropdown
> * **Resource type** — The JSON:API resource type, such as `node--article`
>
> #### Optional inputs: Query options
>
> * **Filter** — A JSON object using Drupal JSON:API filter syntax
> * **Fields** — The fields to return per object in the node output; if nothing is specified, all fields are returned
> * **Include** — A list of the related entities to include in the output (learn more in the [JSON:API documentation](https://www.drupal.org/docs/core-modules-and-themes/core-modules/jsonapi-module/includes))
> * **Sort** — Sort expression for the result set
> * **Limit** — Number of items to return (default 25, up to 50)
> * **Offset** — Pagination offset (default 0)
>
> The output is a structured list of items that can be used in downstream workflow steps.

***

## Key concepts

### Resource types

Resource types follow Drupal's JSON:API naming convention: the entity type and bundle joined by two hyphens.

| Resource type | Description |
| - | - |
| `node--article` | Article content type nodes |
| `node--page` | Basic page nodes |
| `taxonomy_term--tags` | Tags taxonomy terms |

> [!TIP]
>
> Use **List Items** to discover available resource types and inspect the structure of items returned for your Drupal site.

### Resource UUIDs

Items are referenced by **UUID**. When you create or list items, use the UUID from the JSON:API response as the **Resource UUID** in later steps.

### Attributes and relationships

**Create Item** and **Update Item** require at least one of **Attributes** or **Relationships**.

* **Attributes** — Field values for the item, such as title, body, or status. Example attributes for a `node--article`:
  ```json theme={null}
  {
    "title": "My new article",
    "body": {
      "value": "<p>Article content here.</p>",
      "format": "basic_html"
    },
    "status": true
  }
  ```
* **Relationships** — References to other resources, such as taxonomy terms, authors, or related nodes.

  Example relationships linking tags to an article:

  ```json theme={null}
  {
    "field_tags": {
      "data": [
        { "type": "taxonomy_term--tags",
          "id": "9b2c3d4e-5f6a-7b8c-9d0e-1f2a3b4c5d6e"
        }
      ]
    }
  }
  ```

***

## Additional resources

* [Drupal's JSON:API module documentation](https://www.drupal.org/docs/core-modules-and-themes/core-modules/jsonapi-module)
* [JSON:API specification](https://jsonapi.org/format/)
