After connecting your Drupal account, the following nodes become available in Profound Agents.
The nodes work with Drupal’s JSON:API module. Content is accessed by a resource type (the entity type, such as Basic, Image, or Article) and by a resource UUID .
Available nodes
Create Item
Update Item
Get Item
List Items
Create Item Create a new item of a resource type.
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.
A request with neither Attributes nor Relationships is rejected, include at least one.
Update Item Update an existing item.
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.
Only the attributes and relationships you provide are modified.
Get Item Retrieve a single item.
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. List Items List items of a given resource type.
Drupal Site — Select a site from the dropdown
Resource type — The JSON:API resource type, such as node--article
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 )
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--articleArticle content type nodes node--pageBasic page nodes taxonomy_term--tagsTags taxonomy terms
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:
{
"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:
{
"field_tags" : {
"data" : [
{ "type" : "taxonomy_term--tags" ,
"id" : "9b2c3d4e-5f6a-7b8c-9d0e-1f2a3b4c5d6e"
}
]
}
}
Additional resources