Craft
App · 20 actions
Organize Craft documents and folders, append Markdown, search notes, and manage tasks.
Actions
| Action | What it does |
|---|---|
| Add task | Create a task in your inbox, a document, or a daily note. |
| Append Markdown | Append formatted text to a document or daily note. |
| Create collection | Add a structured table at the end of a document. |
| Create document | Create a document in the space or in a folder. |
| Create folder | Create a folder at the root of the space or inside another folder. |
| Delete blocks | Remove the specified blocks from a document. |
| Delete folders | Delete the selected folders. |
| Delete tasks | Delete the tasks identified by the supplied IDs. |
| Get connection details | Get the connected space, its time zone, and link templates. |
| Get document content | Read a document or page and its nested blocks. |
| List collection items | Read the rows and their properties from a collection. |
| List collections | Find the collections available in selected documents or across the space. |
| List documents | List documents in the connected space, a folder, or a built-in location. |
| List folders | Get the space's folder tree and built-in document locations. |
| List tasks | List tasks in a document, the inbox, the logbook, or the space. |
| Move documents | Move documents to a folder, Unsorted, or Templates. |
| Move documents to trash | Move the selected documents into the space's trash. |
| Search in document | Find text in one document, with optional surrounding blocks. |
| Update block text | Replace the text of an existing block and keep its other settings. |
| Update task | Change the task's text, state, schedule date, or deadline. |
Add task
Create a task in your inbox, a document, or a daily note.
Inputs
- Markdown
markdowntextRequired - Enter the text or Markdown.
- Location
locationtextRequired - Choose where to create the task.One of:
inbox,dailyNote,document. - Document
document_idtext - Choose the document when using document location.
- Daily note date
daily_note_datedate - Choose the date when using daily note location.
- Schedule date
schedule_datedate - Choose the date to work on the task.
- Deadline date
deadline_datedate - Choose when the task is due.
Outputs
dataobject- The response from Craft.
Example output
{
"data": {
"items": [
{
"id": "example",
"location": {},
"markdown": "example",
"taskInfo": {}
}
]
}
}Append Markdown
Append formatted text to a document or daily note.
Inputs
- Markdown
markdowntextRequired - Enter the text or Markdown.
- Document
document_idtext - Choose the document or page to append to.
- Daily note date
daily_note_datedate - Choose a daily note date instead of a document.
Outputs
dataobject- The response from Craft.
Example output
{
"data": {
"items": [
{
"id": "example",
"markdown": "example",
"type": "example"
}
]
}
}Create collection
Add a structured table at the end of a document.
Inputs
- Document
document_idtextRequired - Choose the document to hold the collection.
- Name
nametextRequired - Enter a name for the collection.
- Column names
column_nameslist - Enter names for additional columns.
- Column type
column_typetext - Choose the field type for the additional columns.One of:
text,date,number,checkbox. Default:text.
Outputs
dataobject- The response from Craft.
Example output
{
"data": {
"collectionBlockId": "example",
"name": "example",
"schema": {}
}
}Create document
Create a document in the space or in a folder.
Inputs
- Title
titletextRequired - Enter the document title.
- Folder
folder_idtext - Choose a folder, or leave empty to create it in Unsorted.
Outputs
dataobject- The response from Craft.
Example output
{
"data": {
"items": [
{
"clickableLink": "example",
"id": "example",
"title": "example"
}
]
}
}Create folder
Create a folder at the root of the space or inside another folder.
Inputs
- Name
nametextRequired - Enter the folder name.
- Parent folder
parent_folder_idtext - Choose the parent folder.
Outputs
dataobject- The response from Craft.
Example output
{
"data": {
"items": [
{
"id": "example",
"name": "example"
}
]
}
}Delete blocks
Remove the specified blocks from a document.
Inputs
- Block IDS
block_idslistRequired - Enter the IDs of the blocks to delete.
Outputs
dataobject- The response from Craft.
Example output
{
"data": {
"items": [
{
"id": "example"
}
]
}
}Delete folders
Delete the selected folders. Use empty folders for test runs.
Inputs
- Folder IDS
folder_idslistRequired - Choose the folders to delete.
Outputs
dataobject- The response from Craft.
Example output
{
"data": {
"items": [
{
"id": "example"
}
]
}
}Delete tasks
Delete the tasks identified by the supplied IDs.
Inputs
- Task IDS
task_idslistRequired - Enter the IDs from Add task or List tasks.
Outputs
dataobject- The response from Craft.
Example output
{
"data": {
"items": [
{
"id": "example"
}
]
}
}Get connection details
Get the connected space, its time zone, and link templates.
Inputs
None.
Outputs
dataobject- The response from Craft.
Example output
{
"data": {
"space": {
"id": "example",
"name": "example",
"timezone": "example"
},
"urlTemplates": {},
"utc": {}
}
}Get document content
Read a document or page and its nested blocks.
Inputs
- Document
document_idtextRequired - Choose a document or enter the ID of a nested page.
- Max depth
max_depthnumber - Limit how deeply nested blocks are included.At least -1.
- Fetch metadata
fetch_metadatatrue/false - Include block creation and edit information.
Outputs
dataobject- The response from Craft.
Example output
{
"data": {
"content": [
{}
],
"id": "example",
"markdown": "example",
"title": "example",
"type": "example"
}
}List collection items
Read the rows and their properties from a collection.
Inputs
- Collection ID
collection_idtextRequired - Enter an ID from List collections.
Outputs
dataobject- The response from Craft.
Example output
{
"data": {
"items": [
{
"properties": {},
"title": "example"
}
]
}
}List collections
Find the collections available in selected documents or across the space.
Inputs
- Document IDS
document_idslist - Limit the search to these documents.
Outputs
dataobject- The response from Craft.
Example output
{
"data": {
"items": [
{
"id": "example",
"name": "example"
}
]
}
}List documents
List documents in the connected space, a folder, or a built-in location.
Inputs
- Location
locationtext - Choose a built-in document location.One of:
unsorted,trash,templates,daily_notes(Daily notes). - Folder
folder_idtext - Choose a folder to list.
- Fetch metadata
fetch_metadatatrue/false - Include creation and last-modified information.
- Start date
start_datedate - Include documents created on or after this date.
- End date
end_datedate - Include documents created on or before this date.
Outputs
dataobject- The response from Craft.
Example output
{
"data": {
"items": [
{
"createdAt": "example",
"dailyNoteDate": "example",
"id": "example",
"lastModifiedAt": "example",
"title": "example"
}
]
}
}List folders
Get the space's folder tree and built-in document locations.
Inputs
None.
Outputs
dataobject- The response from Craft.
Example output
{
"data": {
"items": [
{
"folders": [
{}
],
"id": "example",
"name": "example"
}
]
}
}List tasks
List tasks in a document, the inbox, the logbook, or the space.
Inputs
- Scope
scopetextRequired - Choose where to look for tasks.One of:
active,upcoming,inbox,logbook,document,all. - Document
document_idtext - Choose a document when looking in a document.
Outputs
dataobject- The response from Craft.
Example output
{
"data": {
"items": [
{
"id": "example",
"location": {},
"markdown": "example",
"taskInfo": {}
}
]
}
}Move documents
Move documents to a folder, Unsorted, or Templates. This can restore documents from the trash.
Inputs
- Document IDS
document_idslistRequired - Choose the documents to move or trash.
- Folder
folder_idtext - Choose the destination folder.
- Location
locationtext - Choose a built-in destination instead of a folder.One of:
unsorted,templates.
Outputs
dataobject- The response from Craft.
Example output
{
"data": {
"items": [
{
"destination": {},
"id": "example"
}
]
}
}Move documents to trash
Move the selected documents into the space's trash.
Inputs
- Document IDS
document_idslistRequired - Choose the documents to move or trash.
Outputs
dataobject- The response from Craft.
Example output
{
"data": {
"items": [
{
"id": "example"
}
]
}
}Search in document
Find text in one document, with optional surrounding blocks.
Inputs
- Document
document_idtextRequired - Choose the document to search.
- Pattern
patterntextRequired - Enter a search pattern. Regular expressions are supported.
- Case sensitive
case_sensitivetrue/false - Match uppercase and lowercase exactly.
Outputs
dataobject- The response from Craft.
Example output
{
"data": {
"items": [
{}
]
}
}Update block text
Replace the text of an existing block and keep its other settings.
Inputs
- Block ID
block_idtextRequired - Enter the block ID from Append Markdown or Get document content.
- Markdown
markdowntextRequired - Enter the text or Markdown.
Outputs
dataobject- The response from Craft.
Example output
{
"data": {
"items": [
{
"id": "example",
"markdown": "example",
"type": "example"
}
]
}
}Update task
Change the task's text, state, schedule date, or deadline.
Inputs
- Task ID
task_idtextRequired - Enter the ID from Add task or List tasks.
- Markdown
markdowntext - Enter the text or Markdown.
- State
statetext - Choose the new task state.One of:
todo,done,canceled. - Schedule date
schedule_datedate - Choose the date to work on the task.
- Deadline date
deadline_datedate - Choose when the task is due.
Outputs
dataobject- The response from Craft.
Example output
{
"data": {
"items": [
{
"id": "example"
}
]
}
}