@directus/app 9.15.0 → 9.16.1

package/dist/assets/files.97dd14f6.js

@@ -1,189 +0,0 @@
-import{a as i,o as c,b as h,w as a,g as s,e as l,B as e}from"./runtime-core.esm-bundler.e3d5f5b7.js";const d={class:"markdown-body"},u=s("div",{class:"two-up"},[s("div",{class:"left"},[s("blockquote",null,[s("p",null,[e("Every file managed by the platform is uploaded to the configured storage adapter, and its associated metadata is tracked within the "),s("code",null,"directus_files"),e(" system collection. Any requested file transformations are handled on the fly, and are only saved to storage.")])])]),s("div",{class:"right"},[s("p",null,[s("div",{class:"table-of-contents"},[s("ul",null,[s("li",null,[s("a",{href:"#accessing-a-file"}," Accessing a File")]),s("li",null,[s("a",{href:"#downloading-a-file"}," Downloading a File")]),s("li",null,[s("a",{href:"#requesting-a-thumbnail"}," Requesting a Thumbnail")]),s("li",null,[s("a",{href:"#the-file-object"}," The File Object")]),s("li",null,[s("a",{href:"#list-files"}," List Files")]),s("li",null,[s("a",{href:"#retrieve-a-file"}," Retrieve a File")]),s("li",null,[s("a",{href:"#upload-a-file"}," Upload a File")]),s("li",null,[s("a",{href:"#import-a-file"}," Import a File")]),s("li",null,[s("a",{href:"#update-a-file"}," Update a File")]),s("li",null,[s("a",{href:"#update-multiple-files"}," Update Multiple Files")]),s("li",null,[s("a",{href:"#delete-a-file"}," Delete a File")]),s("li",null,[s("a",{href:"#delete-multiple-files"}," Delete Multiple Files")])])])])])],-1),p=s("hr",null,null,-1),f=s("h2",{id:"accessing-a-file",tabindex:"-1"},[s("a",{class:"header-anchor",href:"#accessing-a-file"},"#"),e(" Accessing a File")],-1),_=s("div",{class:"two-up"},[s("div",{class:"left"},[s("p",null,"The location of your actual file originals is based on the project\u2019s configuration, but you can consistently access them via the API using the following URL."),s("pre",null,[s("code",null,`example.com/assets/<file-id>
-example.com/assets/1ac73658-8b62-4dea-b6da-529fbc9d01a4
-`)]),s("div",{class:"tip hint"},[s("div",{class:"hint-title"},"SEO"),s("p",null,"You can provide an optional filename after the UUID to optimize for SEO, for example:"),s("pre",null,[s("code",null,`example.com/assets/<file-id>/<filename>
-example.com/assets/1ac73658-8b62-4dea-b6da-529fbc9d01a4/directus-logo.png
-`)]),s("p",null,[e("This optional filename is also used in the Content-Disposition header when the "),s("code",null,"?download"),e(" query parameter is used.")])]),s("div",{class:"warning hint"},[s("div",{class:"hint-title"},"Direct File Access"),s("p",null,[e("While you may "),s("em",null,"technically"),e(" be able to expose your storage adapters root filesystem and access your raw files through there, it is recommended that you always use the Directus API. This is the only way that you can take advantage of file permissions and other built-in features.")])])]),s("div",{class:"right"},[s("p",null,[s("img",{src:"https://cdn.directus.io/docs/v9/reference/files/original-20220216A.jpg",alt:"Original File"}),e(),s("em",null,"Original File Used \u2014 602KB and 1800x1200")])])],-1),m=s("hr",null,null,-1),g=s("h2",{id:"downloading-a-file",tabindex:"-1"},[s("a",{class:"header-anchor",href:"#downloading-a-file"},"#"),e(" Downloading a File")],-1),j=s("div",{class:"two-up"},[s("div",{class:"left"},[s("p",null,[e("To download an asset with the correct filename, you need to add the "),s("code",null,"?download"),e(" query parameter to the request and the "),s("code",null,"download"),e(" attribute to your anchor tag. This will ensure the appropriate "),s("a",{href:"https://www.w3.org/Protocols/rfc2616/rfc2616-sec19.html",target:"_blank",rel:"noopener noreferrer"},"Content-Disposition"),e(" headers are added. Without this, the download will work on the "),s("em",null,"same"),e(" domain, however it will have the file\u2019s \u201Cid\u201D as the filename for cross-origin requests.")])]),s("div",{class:"right"},[s("h3",{id:"example",tabindex:"-1"},[s("a",{class:"header-anchor",href:"#example"},"#"),e(" Example")]),s("pre",null,[s("code",{class:"language-html"},[s("span",{class:"hljs-tag"},[e("<"),s("span",{class:"hljs-name"},"a"),e(),s("span",{class:"hljs-attr"},"href"),e("="),s("span",{class:"hljs-string"},'"https://your-directus.com/assets/<file-id>?download"'),e(),s("span",{class:"hljs-attr"},"target"),e("="),s("span",{class:"hljs-string"},'"_blank"'),e(),s("span",{class:"hljs-attr"},"download"),e("="),s("span",{class:"hljs-string"},'"Your File.pdf"'),e(">")]),e("Download"),s("span",{class:"hljs-tag"},[e("</"),s("span",{class:"hljs-name"},"a"),e(">")]),e(`
-`)])])])],-1),b=s("hr",null,null,-1),y=s("h2",{id:"requesting-a-thumbnail",tabindex:"-1"},[s("a",{class:"header-anchor",href:"#requesting-a-thumbnail"},"#"),e(" Requesting a Thumbnail")],-1),x={class:"two-up"},v={class:"left"},w=s("p",null,[e("Fetching thumbnails is as easy as adding a "),s("code",null,"key"),e(" query parameter to the original file\u2019s URL. In the Admin App, you can configure different asset presets that control the output of any given image. If a requested thumbnail doesn\u2019t yet exist, it is dynamically generated and immediately returned.")],-1),q=s("h3",{id:"preset-transformations",tabindex:"-1"},[s("a",{class:"header-anchor",href:"#preset-transformations"},"#"),e(" Preset Transformations")],-1),T=s("strong",null,[s("code",null,"key")],-1),k=e(" \u2014 This "),R=s("strong",null,"key",-1),E=e(" of the "),A=e("Storage Asset Preset"),D=e(", a shortcut for the below parameters"),S=s("h3",{id:"custom-transformations",tabindex:"-1"},[s("a",{class:"header-anchor",href:"#custom-transformations"},"#"),e(" Custom Transformations")],-1),F=s("p",null,"Alternatively, if you have \u201CStorage Asset Transform\u201D set to all, you can use the following parameters for more fine grained control:",-1),P=s("ul",null,[s("li",null,[s("strong",null,[s("code",null,"fit")]),e(" \u2014 The "),s("strong",null,"fit"),e(" of the thumbnail while always preserving the aspect ratio, can be any of the following options: "),s("ul",null,[s("li",null,[s("code",null,"cover"),e(" \u2014 Covers both width/height by cropping/clipping to fit")]),s("li",null,[s("code",null,"contain"),e(" \u2014 Contain within both width/height using \u201Cletterboxing\u201D as needed")]),s("li",null,[s("code",null,"inside"),e(" \u2014 Resize to be as large as possible, ensuring dimensions are less than or equal to the requested width and height")]),s("li",null,[s("code",null,"outside"),e(" \u2014 Resize to be as small as possible, ensuring dimensions are greater than or equal to the requested width and height")])])]),s("li",null,[s("strong",null,[s("code",null,"width")]),e(" \u2014 The "),s("strong",null,"width"),e(" of the thumbnail in pixels")]),s("li",null,[s("strong",null,[s("code",null,"height")]),e(" \u2014 The "),s("strong",null,"height"),e(" of the thumbnail in pixels")]),s("li",null,[s("strong",null,[s("code",null,"quality")]),e(" \u2014 The optional "),s("strong",null,"quality"),e(" of the thumbnail ("),s("code",null,"1"),e(" to "),s("code",null,"100"),e(")")]),s("li",null,[s("strong",null,[s("code",null,"withoutEnlargement")]),e(" \u2014 Disable image up-scaling")]),s("li",null,[s("strong",null,[s("code",null,"format")]),e(" \u2014 What file format to return the thumbnail in. One of "),s("code",null,"jpg"),e(", "),s("code",null,"png"),e(", "),s("code",null,"webp"),e(", "),s("code",null,"tiff")])],-1),C=s("h3",{id:"advanced-transformations",tabindex:"-1"},[s("a",{class:"header-anchor",href:"#advanced-transformations"},"#"),e(" Advanced Transformations")],-1),I=s("p",null,[e("For even more advanced control over the file generation, Directus exposes "),s("a",{href:"https://sharp.pixelplumbing.com/api-operation",target:"_blank",rel:"noopener noreferrer"},[e("the full "),s("code",null,"sharp"),e(" API")]),e(" through the "),s("code",null,"transforms"),e(" query parameter. This parameter accepts a two-dimensional array with the format "),s("code",null,"[Operation, ...arguments]"),e(".")],-1),O=s("h3",{id:"quality-vs-filesize",tabindex:"-1"},[s("a",{class:"header-anchor",href:"#quality-vs-filesize"},"#"),e(" Quality vs Filesize")],-1),Q=s("p",null,[e("The quality parameter can be any integer from "),s("code",null,"0-100"),e(". Qualities closer to "),s("code",null,"0"),e(" have lower filesizes, but also poor image quality due to compression artifacts. Values closer to "),s("code",null,"100"),e(" have larger filesizes, but better image quality. Below are four possible qualities (200x200 cover) to visually compare the balance between compression and filesize.")],-1),U=s("table",null,[s("thead",null,[s("tr",null,[s("th",null,"25%"),s("th",null,"50%"),s("th",null,"75%"),s("th",null,"100%")])]),s("tbody",null,[s("tr",null,[s("td",null,[s("img",{src:"https://cdn.directus.io/docs/v9/reference/files/200-200-cover-25-20220216A.jpg",alt:"25%"}),s("br"),s("em",null,"4KB")]),s("td",null,[s("img",{src:"https://cdn.directus.io/docs/v9/reference/files/200-200-cover-50-20220216A.jpg",alt:"50%"}),s("br"),s("em",null,"6KB")]),s("td",null,[s("img",{src:"https://cdn.directus.io/docs/v9/reference/files/200-200-cover-75-20220216A.jpg",alt:"75%"}),s("br"),s("em",null,"8KB")]),s("td",null,[s("img",{src:"https://cdn.directus.io/docs/v9/reference/files/200-200-cover-100-20220216A.jpg",alt:"100%"}),s("br"),s("em",null,"38KB")])])])],-1),B=s("div",{class:"right"},[s("h3",{id:"preset",tabindex:"-1"},[s("a",{class:"header-anchor",href:"#preset"},"#"),e(" Preset")]),s("pre",null,[s("code",null,`example.com/assets/<file-id>?key=<key>
-`)]),s("h3",{id:"custom",tabindex:"-1"},[s("a",{class:"header-anchor",href:"#custom"},"#"),e(" Custom")]),s("pre",null,[s("code",null,`example.com/assets/<file-id>?fit=<fit>&width=<width>&height=<height>&quality=<quality>
-example.com/assets/1ac73658-8b62-4dea-b6da-529fbc9d01a4?fit=cover&width=200&height=200&quality=80
-`)]),s("h3",{id:"advanced",tabindex:"-1"},[s("a",{class:"header-anchor",href:"#advanced"},"#"),e(" Advanced")]),s("pre",null,[s("code",null,`?transforms=[
-	["blur", 45],
-	["tint", "rgb(255, 0, 0)"],
-	["expand", { "right": 200, "bottom": 150 }]
-]
-`)])],-1),L=s("hr",null,null,-1),X=s("h2",{id:"the-file-object",tabindex:"-1"},[s("a",{class:"header-anchor",href:"#the-file-object"},"#"),e(" The File Object")],-1),Y={class:"two-up"},M={class:"left"},z={class:"definitions"},G=s("p",null,[s("code",null,"id"),e(),s("strong",null,"uuid"),s("br"),e(" Primary key of the file")],-1),N=s("p",null,[s("code",null,"storage"),e(),s("strong",null,"string"),s("br"),e(" Storage adapter used for the file.")],-1),Z=s("p",null,[s("code",null,"filename_disk"),e(),s("strong",null,"string"),s("br"),e(" Name of the file as saved on the storage adapter.")],-1),H=s("p",null,[s("code",null,"filename_download"),e(),s("strong",null,"string"),s("br"),e(" Preferred filename when file is downloaded.")],-1),W=s("p",null,[s("code",null,"title"),e(),s("strong",null,"string"),s("br"),e(" Title for the file.")],-1),K=s("p",null,[s("code",null,"type"),e(),s("strong",null,"string"),s("br"),e(" Mimetype of the file.")],-1),J=s("code",null,"folder",-1),V=e(),$=s("strong",null,"many-to-one",-1),ss=s("br",null,null,-1),es=e(" What (virtual) folder the file is in. Many-to-one to "),as=e("folders"),ts=e("."),ls=s("code",null,"uploaded_by",-1),ns=e(),is=s("strong",null,"many-to-one",-1),os=s("br",null,null,-1),rs=e(" Who uploaded the file. Many-to-one to "),cs=e("users"),hs=e("."),ds=s("p",null,[s("code",null,"uploaded_on"),e(),s("strong",null,"datetime"),s("br"),e(" When the file was uploaded.")],-1),us=s("code",null,"modified_by",-1),ps=e(),fs=s("strong",null,"many-to-one",-1),_s=s("br",null,null,-1),ms=e(" Who updated the file last. Many-to-one to "),gs=e("users"),js=e("."),bs=s("p",null,[s("code",null,"filesize"),e(),s("strong",null,"number"),s("br"),e(" Size of the file in bytes.")],-1),ys=s("p",null,[s("code",null,"width"),e(),s("strong",null,"number"),s("br"),e(" If the file is a(n) image/video, it\u2019s the width in px.")],-1),xs=s("p",null,[s("code",null,"height"),e(),s("strong",null,"number"),s("br"),e(" If the file is a(n) image/video, it\u2019s the height in px.")],-1),vs=s("p",null,[s("code",null,"duration"),e(),s("strong",null,"number"),s("br"),e(" If the file contains audio/video, it\u2019s the duration in milliseconds.")],-1),ws=s("p",null,[s("code",null,"description"),e(),s("strong",null,"string"),s("br"),e(" Description of the file.")],-1),qs=s("p",null,[s("code",null,"location"),e(),s("strong",null,"string"),s("br"),e(" Location of the file.")],-1),Ts=s("p",null,[s("code",null,"tags"),e(),s("strong",null,"array"),s("br"),e(" Tags for the file.")],-1),ks=s("p",null,[s("code",null,"metadata"),e(),s("strong",null,"object"),s("br"),e(" Any additional metadata Directus was able to scrape from the file. For images, this includes EXIF, IPTC, and ICC information.")],-1),Rs=s("div",{class:"right"},[s("pre",null,[s("code",{class:"language-json"},[s("span",{class:"hljs-punctuation"},"{"),e(`
-	`),s("span",{class:"hljs-attr"},'"id"'),s("span",{class:"hljs-punctuation"},":"),e(),s("span",{class:"hljs-string"},'"4f4b14fa-a43a-46d0-b7ad-90af5919bebb"'),s("span",{class:"hljs-punctuation"},","),e(`
-	`),s("span",{class:"hljs-attr"},'"storage"'),s("span",{class:"hljs-punctuation"},":"),e(),s("span",{class:"hljs-string"},'"local"'),s("span",{class:"hljs-punctuation"},","),e(`
-	`),s("span",{class:"hljs-attr"},'"filename_disk"'),s("span",{class:"hljs-punctuation"},":"),e(),s("span",{class:"hljs-string"},'"4f4b14fa-a43a-46d0-b7ad-90af5919bebb.jpeg"'),s("span",{class:"hljs-punctuation"},","),e(`
-	`),s("span",{class:"hljs-attr"},'"filename_download"'),s("span",{class:"hljs-punctuation"},":"),e(),s("span",{class:"hljs-string"},'"paulo-silva-vSRgXtQuns8-unsplash.jpg"'),s("span",{class:"hljs-punctuation"},","),e(`
-	`),s("span",{class:"hljs-attr"},'"title"'),s("span",{class:"hljs-punctuation"},":"),e(),s("span",{class:"hljs-string"},'"Paulo Silva (via Unsplash)"'),s("span",{class:"hljs-punctuation"},","),e(`
-	`),s("span",{class:"hljs-attr"},'"type"'),s("span",{class:"hljs-punctuation"},":"),e(),s("span",{class:"hljs-string"},'"image/jpeg"'),s("span",{class:"hljs-punctuation"},","),e(`
-	`),s("span",{class:"hljs-attr"},'"folder"'),s("span",{class:"hljs-punctuation"},":"),e(),s("span",{class:"hljs-literal"},[s("span",{class:"hljs-keyword"},"null")]),s("span",{class:"hljs-punctuation"},","),e(`
-	`),s("span",{class:"hljs-attr"},'"uploaded_by"'),s("span",{class:"hljs-punctuation"},":"),e(),s("span",{class:"hljs-string"},'"0bc7b36a-9ba9-4ce0-83f0-0a526f354e07"'),s("span",{class:"hljs-punctuation"},","),e(`
-	`),s("span",{class:"hljs-attr"},'"uploaded_on"'),s("span",{class:"hljs-punctuation"},":"),e(),s("span",{class:"hljs-string"},'"2021-02-04T11:37:41-05:00"'),s("span",{class:"hljs-punctuation"},","),e(`
-	`),s("span",{class:"hljs-attr"},'"modified_by"'),s("span",{class:"hljs-punctuation"},":"),e(),s("span",{class:"hljs-literal"},[s("span",{class:"hljs-keyword"},"null")]),s("span",{class:"hljs-punctuation"},","),e(`
-	`),s("span",{class:"hljs-attr"},'"modified_on"'),s("span",{class:"hljs-punctuation"},":"),e(),s("span",{class:"hljs-string"},'"2021-02-04T11:37:42-05:00"'),s("span",{class:"hljs-punctuation"},","),e(`
-	`),s("span",{class:"hljs-attr"},'"filesize"'),s("span",{class:"hljs-punctuation"},":"),e(),s("span",{class:"hljs-number"},"3442252"),s("span",{class:"hljs-punctuation"},","),e(`
-	`),s("span",{class:"hljs-attr"},'"width"'),s("span",{class:"hljs-punctuation"},":"),e(),s("span",{class:"hljs-number"},"3456"),s("span",{class:"hljs-punctuation"},","),e(`
-	`),s("span",{class:"hljs-attr"},'"height"'),s("span",{class:"hljs-punctuation"},":"),e(),s("span",{class:"hljs-number"},"5184"),s("span",{class:"hljs-punctuation"},","),e(`
-	`),s("span",{class:"hljs-attr"},'"duration"'),s("span",{class:"hljs-punctuation"},":"),e(),s("span",{class:"hljs-literal"},[s("span",{class:"hljs-keyword"},"null")]),s("span",{class:"hljs-punctuation"},","),e(`
-	`),s("span",{class:"hljs-attr"},'"description"'),s("span",{class:"hljs-punctuation"},":"),e(),s("span",{class:"hljs-literal"},[s("span",{class:"hljs-keyword"},"null")]),s("span",{class:"hljs-punctuation"},","),e(`
-	`),s("span",{class:"hljs-attr"},'"location"'),s("span",{class:"hljs-punctuation"},":"),e(),s("span",{class:"hljs-literal"},[s("span",{class:"hljs-keyword"},"null")]),s("span",{class:"hljs-punctuation"},","),e(`
-	`),s("span",{class:"hljs-attr"},'"tags"'),s("span",{class:"hljs-punctuation"},":"),e(),s("span",{class:"hljs-punctuation"},"["),s("span",{class:"hljs-string"},'"photo"'),s("span",{class:"hljs-punctuation"},","),e(),s("span",{class:"hljs-string"},'"pretty"'),s("span",{class:"hljs-punctuation"},"]"),s("span",{class:"hljs-punctuation"},","),e(`
-	`),s("span",{class:"hljs-attr"},'"metadata"'),s("span",{class:"hljs-punctuation"},":"),e(),s("span",{class:"hljs-punctuation"},"{"),e(`
-		`),s("span",{class:"hljs-attr"},'"icc"'),s("span",{class:"hljs-punctuation"},":"),e(),s("span",{class:"hljs-punctuation"},"{"),e(`
-			`),s("span",{class:"hljs-attr"},'"version"'),s("span",{class:"hljs-punctuation"},":"),e(),s("span",{class:"hljs-string"},'"2.1"'),s("span",{class:"hljs-punctuation"},","),e(`
-			`),s("span",{class:"hljs-attr"},'"intent"'),s("span",{class:"hljs-punctuation"},":"),e(),s("span",{class:"hljs-string"},'"Perceptual"'),s("span",{class:"hljs-punctuation"},","),e(`
-			`),s("span",{class:"hljs-attr"},'"cmm"'),s("span",{class:"hljs-punctuation"},":"),e(),s("span",{class:"hljs-string"},'"lcms"'),s("span",{class:"hljs-punctuation"},","),e(`
-			`),s("span",{class:"hljs-attr"},'"deviceClass"'),s("span",{class:"hljs-punctuation"},":"),e(),s("span",{class:"hljs-string"},'"Monitor"'),s("span",{class:"hljs-punctuation"},","),e(`
-			`),s("span",{class:"hljs-attr"},'"colorSpace"'),s("span",{class:"hljs-punctuation"},":"),e(),s("span",{class:"hljs-string"},'"RGB"'),s("span",{class:"hljs-punctuation"},","),e(`
-			`),s("span",{class:"hljs-attr"},'"connectionSpace"'),s("span",{class:"hljs-punctuation"},":"),e(),s("span",{class:"hljs-string"},'"XYZ"'),s("span",{class:"hljs-punctuation"},","),e(`
-			`),s("span",{class:"hljs-attr"},'"platform"'),s("span",{class:"hljs-punctuation"},":"),e(),s("span",{class:"hljs-string"},'"Apple"'),s("span",{class:"hljs-punctuation"},","),e(`
-			`),s("span",{class:"hljs-attr"},'"creator"'),s("span",{class:"hljs-punctuation"},":"),e(),s("span",{class:"hljs-string"},'"lcms"'),s("span",{class:"hljs-punctuation"},","),e(`
-			`),s("span",{class:"hljs-attr"},'"description"'),s("span",{class:"hljs-punctuation"},":"),e(),s("span",{class:"hljs-string"},'"c2"'),s("span",{class:"hljs-punctuation"},","),e(`
-			`),s("span",{class:"hljs-attr"},'"copyright"'),s("span",{class:"hljs-punctuation"},":"),e(),s("span",{class:"hljs-string"},'""'),e(`
-		`),s("span",{class:"hljs-punctuation"},"}"),e(`
-	`),s("span",{class:"hljs-punctuation"},"}"),e(`
-`),s("span",{class:"hljs-punctuation"},"}"),e(`
-`)])])],-1),Es=s("hr",null,null,-1),As=s("h2",{id:"list-files",tabindex:"-1"},[s("a",{class:"header-anchor",href:"#list-files"},"#"),e(" List Files")],-1),Ds=s("p",null,"List all files that exist in Directus.",-1),Ss={class:"two-up"},Fs={class:"left"},Ps=s("h3",{id:"query-parameters",tabindex:"-1"},[s("a",{class:"header-anchor",href:"#query-parameters"},"#"),e(" Query Parameters")],-1),Cs=e("Supports all "),Is=e("global query parameters"),Os=e("."),Qs=s("h3",{id:"returns",tabindex:"-1"},[s("a",{class:"header-anchor",href:"#returns"},"#"),e(" Returns")],-1),Us=e("An array of up to "),Bs=e("limit"),Ls=e(),Xs=s("a",{href:"#the-file-object"},"file objects",-1),Ys=e(". If no items are available, data will be an empty array."),Ms={class:"right"},zs=s("h3",{id:"rest-api",tabindex:"-1"},[s("a",{class:"header-anchor",href:"#rest-api"},"#"),e(" REST API")],-1),Gs=s("pre",null,[s("code",null,`GET /files
-SEARCH /files
-`)],-1),Ns=e("Learn more about SEARCH ->"),Zs=s("h3",{id:"graphql",tabindex:"-1"},[s("a",{class:"header-anchor",href:"#graphql"},"#"),e(" GraphQL")],-1),Hs=s("pre",null,[s("code",null,`POST /graphql/system
-`)],-1),Ws=s("pre",null,[s("code",{class:"language-graphql"},[s("span",{class:"hljs-keyword"},"type"),s("span",{class:"hljs-type"}," Query"),e(` {
-	files: [directus_files]
-}
-`)])],-1),Ks=s("h5",{id:"example-1",tabindex:"-1"},[s("a",{class:"header-anchor",href:"#example-1"},"#"),e(" Example")],-1),Js=s("pre",null,[s("code",{class:"language-graphql"},[s("span",{class:"hljs-keyword"},"query"),e(` {
-	files {
-		id
-		filename_disk
-	}
-}
-`)])],-1),Vs=s("hr",null,null,-1),$s=s("h2",{id:"retrieve-a-file",tabindex:"-1"},[s("a",{class:"header-anchor",href:"#retrieve-a-file"},"#"),e(" Retrieve a File")],-1),se=s("p",null,"Retrieve a single file by primary key.",-1),ee={class:"two-up"},ae={class:"left"},te=s("h3",{id:"query-parameters-1",tabindex:"-1"},[s("a",{class:"header-anchor",href:"#query-parameters-1"},"#"),e(" Query Parameters")],-1),le=e("Supports all "),ne=e("global query parameters"),ie=e("."),oe=s("h3",{id:"returns-1",tabindex:"-1"},[s("a",{class:"header-anchor",href:"#returns-1"},"#"),e(" Returns")],-1),re=s("p",null,[e("Returns a "),s("a",{href:"#the-file-object"},"file object"),e(" if a valid primary key was provided.")],-1),ce=s("div",{class:"right"},[s("h3",{id:"rest-api-1",tabindex:"-1"},[s("a",{class:"header-anchor",href:"#rest-api-1"},"#"),e(" REST API")]),s("pre",null,[s("code",null,`GET /files/:id
-`)]),s("h5",{id:"example-2",tabindex:"-1"},[s("a",{class:"header-anchor",href:"#example-2"},"#"),e(" Example")]),s("pre",null,[s("code",null,`GET /files/0fca80c4-d61c-4404-9fd7-6ba86b64154d
-`)]),s("h3",{id:"graphql-1",tabindex:"-1"},[s("a",{class:"header-anchor",href:"#graphql-1"},"#"),e(" GraphQL")]),s("pre",null,[s("code",null,`POST /graphql/system
-`)]),s("pre",null,[s("code",{class:"language-graphql"},[s("span",{class:"hljs-keyword"},"type"),s("span",{class:"hljs-type"}," Query"),e(` {
-	files_by_id(id:`),s("span",{class:"hljs-literal"}," ID"),e(`!): directus_files
-}
-`)])]),s("h5",{id:"example-3",tabindex:"-1"},[s("a",{class:"header-anchor",href:"#example-3"},"#"),e(" Example")]),s("pre",null,[s("code",{class:"language-graphql"},[s("span",{class:"hljs-keyword"},"query"),e(` {
-	files_by_id(id: `),s("span",{class:"hljs-string"},'"0fca80c4-d61c-4404-9fd7-6ba86b64154d"'),e(`) {
-		id
-		filename_disk
-	}
-}
-`)])])],-1),he=s("h2",{id:"upload-a-file",tabindex:"-1"},[s("a",{class:"header-anchor",href:"#upload-a-file"},"#"),e(" Upload a File")],-1),de=s("p",null,"Upload/create a new file.",-1),ue={class:"two-up"},pe={class:"left"},fe=s("p",null,[e("To upload a file, use "),s("code",null,"multipart/form-data"),e(" as the encoding type, instead of JSON.")],-1),_e=s("p",null,[e("The file contents has to be provided in a part called "),s("code",null,"file"),e(". All other properties of "),s("a",{href:"#the-file-object"},"the file object"),e(" can be provided as parts as well.")],-1),me=s("div",{class:"tip hint"},[s("div",{class:"hint-title"},"Order Matters"),s("p",null,[e("Make sure to define the non-file properties "),s("em",null,"first"),e(". This ensures that the file metadata is associated with the correct file.")])],-1),ge=s("p",null,"You can upload multiple files at a time by repeating the payload with different contents, for example:",-1),je=s("pre",null,[s("code",null,`--__X_BOUNDARY__
-Content-Disposition: form-data; name="title"
-
-Example
---__X_BOUNDARY__
-Content-Disposition: form-data; name="file"; filename="paulo-silva-vSRgXtQuns8-unsplash.jpg"
-Content-Type: image/jpeg
-
-// binary data
-
---__X_BOUNDARY__
-Content-Disposition: form-data; name="title"
-
-Another Title
---__X_BOUNDARY__
-Content-Disposition: form-data; name="file"; filename="mae-mu-GFhqNX1gE9E-unsplash.jpg"
-Content-Type: image/jpeg
-
-// binary data
-`)],-1),be=s("p",null,[e("In JavaScript, this can be achieved using the native "),s("code",null,"FormData"),e(" class:")],-1),ye=s("pre",null,[s("code",{class:"language-js"},[s("span",{class:"hljs-keyword"},"import"),e(" axios "),s("span",{class:"hljs-keyword"},"from"),e(),s("span",{class:"hljs-string"},"'axios'"),e(`;
-
-`),s("span",{class:"hljs-keyword"},"const"),e(" fileInput = "),s("span",{class:"hljs-variable language_"},"document"),e("."),s("span",{class:"hljs-title function_"},"querySelector"),e("("),s("span",{class:"hljs-string"},`'input[type="file"]'`),e(`);
-`),s("span",{class:"hljs-keyword"},"const"),e(" formData = "),s("span",{class:"hljs-keyword"},"new"),e(),s("span",{class:"hljs-title class_"},"FormData"),e(`();
-
-formData.`),s("span",{class:"hljs-title function_"},"append"),e("("),s("span",{class:"hljs-string"},"'title'"),e(", "),s("span",{class:"hljs-string"},"'My First File'"),e(`);
-formData.`),s("span",{class:"hljs-title function_"},"append"),e("("),s("span",{class:"hljs-string"},"'file'"),e(", fileInput."),s("span",{class:"hljs-property"},"files"),e("["),s("span",{class:"hljs-number"},"0"),e(`]);
-
-`),s("span",{class:"hljs-keyword"},"await"),e(" axios."),s("span",{class:"hljs-title function_"},"post"),e("("),s("span",{class:"hljs-string"},"'/files'"),e(`, formData);
-`)])],-1),xe=s("h3",{id:"query-parameters-2",tabindex:"-1"},[s("a",{class:"header-anchor",href:"#query-parameters-2"},"#"),e(" Query Parameters")],-1),ve=e("Supports all "),we=e("global query parameters"),qe=e("."),Te=s("h3",{id:"returns-2",tabindex:"-1"},[s("a",{class:"header-anchor",href:"#returns-2"},"#"),e(" Returns")],-1),ke=s("p",null,[e("Returns the "),s("a",{href:"#the-file-object"},"file object"),e(" for the uploaded file, or an array of "),s("a",{href:"#the-file-object"},"file objects"),e(" if multiple files were uploaded at once.")],-1),Re=s("div",{class:"right"},[s("pre",null,[s("code",null,`POST /files
-`)]),s("pre",null,[s("code",null,`// Request
-
-Content-Type: multipart/form-data; charset=utf-8; boundary=__X_BOUNDARY__
-Content-Length: 3442422
-
---__X_BOUNDARY__
-Content-Disposition: form-data; name="file"; filename="paulo-silva-vSRgXtQuns8-unsplash.jpg"
-Content-Type: image/jpeg
-
-\xFF\xD8\xFF\xE0JFIF


HH\xFF\xE2ICC_PROFILE

\flcmsmntrRGB XYZ \x07\xDC
)9acspAPPL\xF6\xD6
\xD3-lcms
-desc\xFC^cprt
\\\vwtpt
hbkpt
|rXYZ
\x90gXYZ
\xA4bXYZ
\xB8rTRC
\xCC@gTRC
\xCC@bTRC
\xCC@descc2textIXXYZ \xF6\xD6
\xD3-XYZ 3\xA4XYZ o\xA28\xF5\x90XYZ b\x99\xB7\x85\xDAXYZ $\xA0\x84\xB6\xCFcurv\xCB
\xC9c\x92\bk\v\xF6?Q\x1B4!\xF1)\x902;\x92FQw]\xEDkpz\x89\xB1\x9A|\xACi\xBF}\xD3\xC3\xE90\xFF\xFF\xFF\xDB\x84\b\b\x07\x07
-`)])],-1),Ee=s("hr",null,null,-1),Ae=s("h2",{id:"import-a-file",tabindex:"-1"},[s("a",{class:"header-anchor",href:"#import-a-file"},"#"),e(" Import a File")],-1),De=s("p",null,"Import a file from the web",-1),Se={class:"two-up"},Fe={class:"left"},Pe=s("h3",{id:"query-parameters-3",tabindex:"-1"},[s("a",{class:"header-anchor",href:"#query-parameters-3"},"#"),e(" Query Parameters")],-1),Ce=e("Supports all "),Ie=e("global query parameters"),Oe=e("."),Qe=s("h3",{id:"request-body",tabindex:"-1"},[s("a",{class:"header-anchor",href:"#request-body"},"#"),e(" Request Body")],-1),Ue=s("div",{class:"definitions"},[s("p",null,[s("code",null,"url"),e(),s("strong",null,"Required"),s("br"),e(" The URL to download the file from.")]),s("p",null,[s("code",null,"data"),s("br"),e(" Any of "),s("a",{href:"#the-file-object"},"the file object"),e("\u2019s properties.")])],-1),Be=s("h3",{id:"returns-3",tabindex:"-1"},[s("a",{class:"header-anchor",href:"#returns-3"},"#"),e(" Returns")],-1),Le=s("p",null,[e("Returns the "),s("a",{href:"#the-file-object"},"file object"),e(" for the imported file.")],-1),Xe=s("div",{class:"right"},[s("h3",{id:"rest-api-2",tabindex:"-1"},[s("a",{class:"header-anchor",href:"#rest-api-2"},"#"),e(" REST API")]),s("pre",null,[s("code",null,`POST /files/import
-`)]),s("h5",{id:"example-4",tabindex:"-1"},[s("a",{class:"header-anchor",href:"#example-4"},"#"),e(" Example")]),s("pre",null,[s("code",{class:"language-json"},[s("span",{class:"hljs-comment"},"// POST /files/import"),e(`
-
-`),s("span",{class:"hljs-punctuation"},"{"),e(`
-	`),s("span",{class:"hljs-attr"},'"url"'),s("span",{class:"hljs-punctuation"},":"),e(),s("span",{class:"hljs-string"},'"https://source.unsplash.com/random"'),s("span",{class:"hljs-punctuation"},","),e(`
-	`),s("span",{class:"hljs-attr"},'"data"'),s("span",{class:"hljs-punctuation"},":"),e(),s("span",{class:"hljs-punctuation"},"{"),e(`
-		`),s("span",{class:"hljs-attr"},'"title"'),s("span",{class:"hljs-punctuation"},":"),e(),s("span",{class:"hljs-string"},'"Example"'),e(`
-	`),s("span",{class:"hljs-punctuation"},"}"),e(`
-`),s("span",{class:"hljs-punctuation"},"}"),e(`
-`)])]),s("h3",{id:"graphql-2",tabindex:"-1"},[s("a",{class:"header-anchor",href:"#graphql-2"},"#"),e(" GraphQL")]),s("pre",null,[s("code",null,`POST /graphql/system
-`)]),s("pre",null,[s("code",{class:"language-graphql"},[s("span",{class:"hljs-keyword"},"type"),s("span",{class:"hljs-type"}," Mutation"),e(` {
-	import_file(url:`),s("span",{class:"hljs-type"}," String"),e(`!, data: create_directus_files_input!): directus_files
-}
-`)])]),s("h5",{id:"example-5",tabindex:"-1"},[s("a",{class:"header-anchor",href:"#example-5"},"#"),e(" Example")]),s("pre",null,[s("code",{class:"language-graphql"},[s("span",{class:"hljs-keyword"},"mutation"),e(` {
-	import_file(url: `),s("span",{class:"hljs-string"},'"https://source.unsplash.com/random"'),e(", data: { title: "),s("span",{class:"hljs-string"},'"Example"'),e(` }) {
-		id
-	}
-}
-`)])])],-1),Ye=s("hr",null,null,-1),Me=s("h2",{id:"update-a-file",tabindex:"-1"},[s("a",{class:"header-anchor",href:"#update-a-file"},"#"),e(" Update a File")],-1),ze=s("p",null,"Update an existing file, and/or replace it\u2019s file contents.",-1),Ge={class:"two-up"},Ne={class:"left"},Ze=s("h3",{id:"query-parameters-4",tabindex:"-1"},[s("a",{class:"header-anchor",href:"#query-parameters-4"},"#"),e(" Query Parameters")],-1),He=e("Supports all "),We=e("global query parameters"),Ke=e("."),Je=s("h3",{id:"request-body-1",tabindex:"-1"},[s("a",{class:"header-anchor",href:"#request-body-1"},"#"),e(" Request Body")],-1),Ve=s("p",null,[e("You can either submit a JSON object consisting of a partial "),s("a",{href:"#the-file-object"},"file object"),e(" to update the file meta, or send a multipart/form-data request to replace the file contents on disk. See "),s("a",{href:"#upload-a-file"},"Upload a File"),e(" for more information on the structure of this "),s("code",null,"multipart/form-data"),e(" request.")],-1),$e=s("h3",{id:"returns-4",tabindex:"-1"},[s("a",{class:"header-anchor",href:"#returns-4"},"#"),e(" Returns")],-1),sa=s("p",null,[e("Returns the "),s("a",{href:"#the-file-object"},"file object"),e(" for the updated file.")],-1),ea=s("div",{class:"right"},[s("h3",{id:"rest-api-3",tabindex:"-1"},[s("a",{class:"header-anchor",href:"#rest-api-3"},"#"),e(" REST API")]),s("pre",null,[s("code",null,`PATCH /files/:id
-`)]),s("h5",{id:"example-6",tabindex:"-1"},[s("a",{class:"header-anchor",href:"#example-6"},"#"),e(" Example")]),s("pre",null,[s("code",{class:"language-json"},[s("span",{class:"hljs-comment"},"// PATCH /files/0fca80c4-d61c-4404-9fd7-6ba86b64154d"),e(`
-
-`),s("span",{class:"hljs-punctuation"},"{"),e(`
-	`),s("span",{class:"hljs-attr"},'"title"'),s("span",{class:"hljs-punctuation"},":"),e(),s("span",{class:"hljs-string"},'"Example"'),e(`
-`),s("span",{class:"hljs-punctuation"},"}"),e(`
-`)])]),s("h3",{id:"graphql-3",tabindex:"-1"},[s("a",{class:"header-anchor",href:"#graphql-3"},"#"),e(" GraphQL")]),s("pre",null,[s("code",null,`POST /graphql/system
-`)]),s("pre",null,[s("code",{class:"language-graphql"},[s("span",{class:"hljs-keyword"},"type"),s("span",{class:"hljs-type"}," Mutation"),e(` {
-	update_files_item(id:`),s("span",{class:"hljs-literal"}," ID"),e(`!, data: update_directus_files_input!): directus_files
-}
-`)])]),s("h5",{id:"example-7",tabindex:"-1"},[s("a",{class:"header-anchor",href:"#example-7"},"#"),e(" Example")]),s("pre",null,[s("code",{class:"language-graphql"},[s("span",{class:"hljs-keyword"},"mutation"),e(` {
-	update_files_item(id: `),s("span",{class:"hljs-string"},'"0fca80c4-d61c-4404-9fd7-6ba86b64154d"'),e(", data: { title: "),s("span",{class:"hljs-string"},'"Example"'),e(` }) {
-		id
-		title
-	}
-}
-`)])])],-1),aa=s("hr",null,null,-1),ta=s("h2",{id:"update-multiple-files",tabindex:"-1"},[s("a",{class:"header-anchor",href:"#update-multiple-files"},"#"),e(" Update Multiple Files")],-1),la=s("p",null,"Update multiple files at the same time.",-1),na={class:"two-up"},ia={class:"left"},oa=s("h3",{id:"query-parameters-5",tabindex:"-1"},[s("a",{class:"header-anchor",href:"#query-parameters-5"},"#"),e(" Query Parameters")],-1),ra=e("Supports all "),ca=e("global query parameters"),ha=e("."),da=s("h3",{id:"request-body-2",tabindex:"-1"},[s("a",{class:"header-anchor",href:"#request-body-2"},"#"),e(" Request Body")],-1),ua=s("div",{class:"definitions"},[s("p",null,[s("code",null,"keys"),e(),s("strong",null,"Required"),s("br"),e(" Array of primary keys of the files you\u2019d like to update.")]),s("p",null,[s("code",null,"data"),e(),s("strong",null,"Required"),s("br"),e(" Any of "),s("a",{href:"#the-file-object"},"the file object"),e("\u2019s properties.")])],-1),pa=s("h3",{id:"returns-5",tabindex:"-1"},[s("a",{class:"header-anchor",href:"#returns-5"},"#"),e(" Returns")],-1),fa=s("p",null,[e("Returns the "),s("a",{href:"#the-file-object"},"file objects"),e(" for the updated files.")],-1),_a=s("div",{class:"right"},[s("h3",{id:"rest-api-4",tabindex:"-1"},[s("a",{class:"header-anchor",href:"#rest-api-4"},"#"),e(" REST API")]),s("pre",null,[s("code",null,`PATCH /files
-`)]),s("h5",{id:"example-8",tabindex:"-1"},[s("a",{class:"header-anchor",href:"#example-8"},"#"),e(" Example")]),s("pre",null,[s("code",{class:"language-json"},[s("span",{class:"hljs-comment"},"// PATCH /files"),e(`
-
-`),s("span",{class:"hljs-punctuation"},"{"),e(`
-	`),s("span",{class:"hljs-attr"},'"keys"'),s("span",{class:"hljs-punctuation"},":"),e(),s("span",{class:"hljs-punctuation"},"["),s("span",{class:"hljs-string"},'"b6123925-2fc0-4a30-9d86-863eafc0a6e7"'),s("span",{class:"hljs-punctuation"},","),e(),s("span",{class:"hljs-string"},'"d17c10aa-0bad-4864-9296-84f522c753e5"'),s("span",{class:"hljs-punctuation"},"]"),s("span",{class:"hljs-punctuation"},","),e(`
-	`),s("span",{class:"hljs-attr"},'"data"'),s("span",{class:"hljs-punctuation"},":"),e(),s("span",{class:"hljs-punctuation"},"{"),e(`
-		`),s("span",{class:"hljs-attr"},'"tags"'),s("span",{class:"hljs-punctuation"},":"),e(),s("span",{class:"hljs-punctuation"},"["),s("span",{class:"hljs-string"},'"cities"'),s("span",{class:"hljs-punctuation"},"]"),e(`
-	`),s("span",{class:"hljs-punctuation"},"}"),e(`
-`),s("span",{class:"hljs-punctuation"},"}"),e(`
-`)])]),s("h3",{id:"graphql-4",tabindex:"-1"},[s("a",{class:"header-anchor",href:"#graphql-4"},"#"),e(" GraphQL")]),s("pre",null,[s("code",null,`POST /graphql/system
-`)]),s("pre",null,[s("code",{class:"language-graphql"},[s("span",{class:"hljs-keyword"},"type"),s("span",{class:"hljs-type"}," Mutation"),e(` {
-	update_files_items(ids: `),s("span",{class:"hljs-literal"},"[ID"),e(`!]!, data: update_directus_files!): [directus_files]
-}
-`)])]),s("h5",{id:"example-9",tabindex:"-1"},[s("a",{class:"header-anchor",href:"#example-9"},"#"),e(" Example")]),s("pre",null,[s("code",{class:"language-graphql"},[s("span",{class:"hljs-keyword"},"mutation"),e(` {
-	update_files_items(
-		ids: [`),s("span",{class:"hljs-string"},'"b6123925-2fc0-4a30-9d86-863eafc0a6e7"'),e(", "),s("span",{class:"hljs-string"},'"d17c10aa-0bad-4864-9296-84f522c753e5"'),e(`]
-		data: { tags: [`),s("span",{class:"hljs-string"},'"cities"'),e(`] }
-	)
-}
-`)])])],-1),ma=s("hr",null,null,-1),ga=s("h2",{id:"delete-a-file",tabindex:"-1"},[s("a",{class:"header-anchor",href:"#delete-a-file"},"#"),e(" Delete a File")],-1),ja=s("p",null,"Delete an existing file.",-1),ba={class:"two-up"},ya={class:"left"},xa=s("div",{class:"danger hint"},[s("div",{class:"hint-title"},"Destructive"),s("p",null,"This will also delete the file from disk.")],-1),va=s("h3",{id:"query-parameters-6",tabindex:"-1"},[s("a",{class:"header-anchor",href:"#query-parameters-6"},"#"),e(" Query Parameters")],-1),wa=e("Supports all "),qa=e("global query parameters"),Ta=e("."),ka=s("h3",{id:"returns-6",tabindex:"-1"},[s("a",{class:"header-anchor",href:"#returns-6"},"#"),e(" Returns")],-1),Ra=s("p",null,"Empty response.",-1),Ea=s("div",{class:"right"},[s("h3",{id:"rest-api-5",tabindex:"-1"},[s("a",{class:"header-anchor",href:"#rest-api-5"},"#"),e(" REST API")]),s("pre",null,[s("code",null,`DELETE /files/:id
-`)]),s("h5",{id:"example-10",tabindex:"-1"},[s("a",{class:"header-anchor",href:"#example-10"},"#"),e(" Example")]),s("pre",null,[s("code",null,`DELETE /files/0fca80c4-d61c-4404-9fd7-6ba86b64154d
-`)]),s("h3",{id:"graphql-5",tabindex:"-1"},[s("a",{class:"header-anchor",href:"#graphql-5"},"#"),e(" GraphQL")]),s("pre",null,[s("code",null,`POST /graphql/system
-`)]),s("pre",null,[s("code",{class:"language-graphql"},[s("span",{class:"hljs-keyword"},"type"),s("span",{class:"hljs-type"}," Mutation"),e(` {
-	delete_files_item(id:`),s("span",{class:"hljs-literal"}," ID"),e(`!): delete_one
-}
-`)])]),s("pre",null,[s("code",{class:"language-graphql"},[s("span",{class:"hljs-keyword"},"mutation"),e(` {
-	delete_files_item(id: `),s("span",{class:"hljs-string"},'"0fca80c4-d61c-4404-9fd7-6ba86b64154d"'),e(`) {
-		id
-	}
-}
-`)])])],-1),Aa=s("hr",null,null,-1),Da=s("h2",{id:"delete-multiple-files",tabindex:"-1"},[s("a",{class:"header-anchor",href:"#delete-multiple-files"},"#"),e(" Delete Multiple Files")],-1),Sa=s("p",null,"Delete multiple files at once.",-1),Fa=s("div",{class:"two-up"},[s("div",{class:"left"},[s("div",{class:"danger hint"},[s("div",{class:"hint-title"},"Destructive"),s("p",null,"This will also delete the files from disk.")]),s("h3",{id:"request-body-3",tabindex:"-1"},[s("a",{class:"header-anchor",href:"#request-body-3"},"#"),e(" Request Body")]),s("p",null,"Array of file primary keys"),s("h3",{id:"returns-7",tabindex:"-1"},[s("a",{class:"header-anchor",href:"#returns-7"},"#"),e(" Returns")]),s("p",null,"Empty response.")]),s("div",{class:"right"},[s("h3",{id:"rest-api-6",tabindex:"-1"},[s("a",{class:"header-anchor",href:"#rest-api-6"},"#"),e(" REST API")]),s("pre",null,[s("code",null,`DELETE /files
-`)]),s("h5",{id:"example-11",tabindex:"-1"},[s("a",{class:"header-anchor",href:"#example-11"},"#"),e(" Example")]),s("pre",null,[s("code",{class:"language-json"},[s("span",{class:"hljs-comment"},"// DELETE /files"),e(`
-
-`),s("span",{class:"hljs-punctuation"},"["),s("span",{class:"hljs-string"},'"d17c10aa-0bad-4864-9296-84f522c753e5"'),s("span",{class:"hljs-punctuation"},","),e(),s("span",{class:"hljs-string"},'"b6123925-2fc0-4a30-9d86-863eafc0a6e7"'),s("span",{class:"hljs-punctuation"},"]"),e(`
-`)])]),s("h3",{id:"graphql-6",tabindex:"-1"},[s("a",{class:"header-anchor",href:"#graphql-6"},"#"),e(" GraphQL")]),s("pre",null,[s("code",null,`POST /graphql/system
-`)]),s("pre",null,[s("code",{class:"language-graphql"},[s("span",{class:"hljs-keyword"},"type"),s("span",{class:"hljs-type"}," Mutation"),e(` {
-	delete_files_items(ids: `),s("span",{class:"hljs-literal"},"[ID"),e(`!]!): delete_many
-}
-`)])]),s("h5",{id:"example-12",tabindex:"-1"},[s("a",{class:"header-anchor",href:"#example-12"},"#"),e(" Example")]),s("pre",null,[s("code",{class:"language-graphql"},[s("span",{class:"hljs-keyword"},"mutation"),e(` {
-	delete_files_items(ids: [`),s("span",{class:"hljs-string"},'"d17c10aa-0bad-4864-9296-84f522c753e5"'),e(", "),s("span",{class:"hljs-string"},'"b6123925-2fc0-4a30-9d86-863eafc0a6e7"'),e(`]) {
-		ids
-	}
-}
-`)])])])],-1),Qa="Accessing Files",Ua=!1,Ba="page-reference",La={name:"files",setup(Pa,{expose:o}){const n={title:"Accessing Files",modularExtension:!1,pageClass:"page-reference"};return o({frontmatter:n}),(Ca,Ia)=>{const t=i("router-link"),r=i("docs-wrapper");return c(),h(r,{frontmatter:n},{default:a(()=>[s("div",d,[u,p,f,_,m,g,j,b,y,s("div",x,[s("div",v,[w,q,s("ul",null,[s("li",null,[T,k,R,E,l(t,{to:"/docs/configuration/project-settings/#files-thumbnails"},{default:a(()=>[A]),_:1}),D])]),S,F,P,C,I,O,Q,U]),B]),L,X,s("div",Y,[s("div",M,[s("div",z,[G,N,Z,H,W,K,s("p",null,[J,V,$,ss,es,l(t,{to:"/docs/reference/system/folders/"},{default:a(()=>[as]),_:1}),ts]),s("p",null,[ls,ns,is,os,rs,l(t,{to:"/docs/reference/system/users/"},{default:a(()=>[cs]),_:1}),hs]),ds,s("p",null,[us,ps,fs,_s,ms,l(t,{to:"/docs/reference/system/users/"},{default:a(()=>[gs]),_:1}),js]),bs,ys,xs,vs,ws,qs,Ts,ks])]),Rs]),Es,As,Ds,s("div",Ss,[s("div",Fs,[Ps,s("p",null,[Cs,l(t,{to:"/docs/reference/query"},{default:a(()=>[Is]),_:1}),Os]),Qs,s("p",null,[Us,l(t,{to:"/docs/reference/query/#limit"},{default:a(()=>[Bs]),_:1}),Ls,Xs,Ys])]),s("div",Ms,[zs,Gs,s("p",null,[l(t,{to:"/docs/reference/introduction/#search-http-method"},{default:a(()=>[Ns]),_:1})]),Zs,Hs,Ws,Ks,Js])]),Vs,$s,se,s("div",ee,[s("div",ae,[te,s("p",null,[le,l(t,{to:"/docs/reference/query"},{default:a(()=>[ne]),_:1}),ie]),oe,re]),ce]),he,de,s("div",ue,[s("div",pe,[fe,_e,me,ge,je,be,ye,xe,s("p",null,[ve,l(t,{to:"/docs/reference/query"},{default:a(()=>[we]),_:1}),qe]),Te,ke]),Re]),Ee,Ae,De,s("div",Se,[s("div",Fe,[Pe,s("p",null,[Ce,l(t,{to:"/docs/reference/query"},{default:a(()=>[Ie]),_:1}),Oe]),Qe,Ue,Be,Le]),Xe]),Ye,Me,ze,s("div",Ge,[s("div",Ne,[Ze,s("p",null,[He,l(t,{to:"/docs/reference/query"},{default:a(()=>[We]),_:1}),Ke]),Je,Ve,$e,sa]),ea]),aa,ta,la,s("div",na,[s("div",ia,[oa,s("p",null,[ra,l(t,{to:"/docs/reference/query"},{default:a(()=>[ca]),_:1}),ha]),da,ua,pa,fa]),_a]),ma,ga,ja,s("div",ba,[s("div",ya,[xa,va,s("p",null,[wa,l(t,{to:"/docs/reference/query"},{default:a(()=>[qa]),_:1}),Ta]),ka,Ra]),Ea]),Aa,Da,Sa,Fa])]),_:1})}}};export{La as default,Ua as modularExtension,Ba as pageClass,Qa as title};

package/dist/assets/filters.b1397c95.js

@@ -1 +0,0 @@
-import{a as n,o as d,b as c,w as o,g as e,e as i,B as t}from"./runtime-core.esm-bundler.e3d5f5b7.js";const u={class:"markdown-body"},h=e("blockquote",null,[e("p",null,"Filters allow you to conditionally select Items from a Collection. Use-cases include customizing Item search results, restricting Item access permissions for specific Users or Roles, building dashboard analytics with the Insights module, and more.")],-1),_=e("p",null,[e("img",{src:"https://cdn.directus.io/docs/v9/app-guide/filters/filters-20220303A/filters-20220303A.webp",alt:"Filters"})],-1),p=e("p",null,[e("div",{class:"table-of-contents"},[e("ul",null,[e("li",null,[e("a",{href:"#how-it-works"}," How it Works")]),e("li",null,[e("a",{href:"#and%2For-groups"}," AND/OR Groups")]),e("li",null,[e("a",{href:"#dynamic-variables"}," Dynamic Variables")]),e("li",null,[e("a",{href:"#filtering-by-related-collections"}," Filtering by Related Collections")]),e("li",null,[e("a",{href:"#unfilterable-fields"}," Unfilterable Fields")]),e("li",null,[e("a",{href:"#extensibility-options"}," Extensibility Options")]),e("li",null,[e("a",{href:"#more-help"}," More Help")])])])],-1),f={class:"warning hint"},m=e("div",{class:"hint-title"},"There Are Two Filters Documents",-1),b=t("This page is a non-technical guide to using Filters. For more technical info, see "),y=t("Filter-Rules"),g=t("."),w=e("h2",{id:"how-it-works",tabindex:"-1"},[e("a",{class:"header-anchor",href:"#how-it-works"},"#"),t(" How it Works")],-1),F={class:"tip hint"},v=e("div",{class:"hint-title"},"Assumed Knowledge",-1),A=t("Filters are intuitive to use, but get quite nuanced as complexity increases. In order to use Filters effectively, you will need to understand the Field "),k=t("(aka "),C=t("data model"),x=t(")"),O=t(" being filtered as well as any relevant "),R=t("Users, Roles and Permissions"),D=t("."),N=t("A basic filter is composed of 3 parts: A "),G=e("strong",null,"Field",-1),I=t(" from the Collection being Filtered, a logical "),V=t("Operator"),E=t(", and some specified "),H=e("strong",null,"Value",-1),T=t(" to filter for within each Item\u2019s Field."),U=e("video",{autoplay:"",muted:"",loop:"",controls:"",title:"How Filters Work"},[e("source",{src:"https://cdn.directus.io/docs/v9/app-guide/filters/filters-20220303A/how-filters-work-20220303A.mp4",type:"video/mp4"})],-1),W=e("ol",{start:"2"},[e("li",null,[t("Click "),e("span",{mi:"",icon:""},"filter_list"),t(" or "),e("strong",null,"\u201CAdd Filter\u201D"),t(".")]),e("li",null,"Select the Field to filter by."),e("li",null,"Select the Operator as desired."),e("li",null,"Define the Value to filter for.")],-1),S=e("p",null,[t("From here, you can set multiple Filters at once, filter by "),e("a",{href:"#filtering-by-related-collections"},"Fields in related Collections"),t(", set Values with "),e("a",{href:"#dynamic-variables"},"Dynamic Variables"),t(", as well as apply "),e("a",{href:"#and-or-groups"},"AND/OR Groups"),t(".")],-1),B={class:"tip hint"},$=e("div",{class:"hint-title"},"Operators",-1),j=t("The Field type will determine the kinds of Operators that can be used on it. In fact, some Fields cannot be filtered at all (read more in "),P=e("a",{href:"#unfilterable-fields"},"Unfilterable Fields",-1),q=t("). Once a Field is selected, the permitted operators will automatically display. An exhaustive list of Operators and what they do can be found in the more technical "),L=t("Filter Rules"),M=t(" document."),Y=e("h2",{id:"and%2For-groups",tabindex:"-1"},[e("a",{class:"header-anchor",href:"#and%2For-groups"},"#"),t(" AND/OR Groups")],-1),z=e("p",null,[e("code",null,"AND"),t(" Groups give the option to filter for Items that meet "),e("em",null,"all of several criteria"),t(". On the other hand, "),e("code",null,"OR"),t(" Groups filter for Items that meet "),e("em",null,"any one of several criteria"),t(".")],-1),K=e("p",null,[e("img",{src:"https://cdn.directus.io/docs/v9/app-guide/filters/filters-20220303A/and-or-groups-20220303A.webp",alt:"AND/OR Groups"})],-1),J=e("ol",null,[e("li",null,"Click \u201CAdd Filter\u201D."),e("li",null,"Click \u201CAnd/OR Group\u201D at the very top of the dropdown menu."),e("li",null,[t("Click the AND/OR text to toggle: "),e("ul",null,[e("li",null,[e("code",null,"AND"),t(" \u2013 Selects Items that meet every single criteria.")]),e("li",null,[e("code",null,"OR"),t(" \u2013 Selects Items that meet one of several criteria.")])])]),e("li",null,"Click \u201CAdd Filter\u201D again."),e("li",null,"Configure the Field, Operator, and Value as desired."),e("li",null,[t("Click and hold "),e("span",{mi:"",icon:""},"drag_indicator"),t(" to drag a Filter and nest it under an AND/OR Group.")])],-1),Q=e("div",{class:"tip hint"},[e("div",{class:"hint-title"},"Why do we need AND Groups?"),e("p",null,[t("Filters actually default to "),e("code",null,"AND"),t(" Group behavior automatically. However, when Filters are nested inside of an OR Group, they of course switch to "),e("code",null,"OR"),t(" Group behavior. So an AND Group is necessary in cases where you want to meet multiple conditions inside of OR Groups.")])],-1),X=e("h2",{id:"dynamic-variables",tabindex:"-1"},[e("a",{class:"header-anchor",href:"#dynamic-variables"},"#"),t(" Dynamic Variables")],-1),Z=e("p",null,"The following video shows how to filter for Blog posts written within the past 60 days.",-1),ee=e("video",{autoplay:"",muted:"",loop:"",controls:"",title:"How Filters Work"},[e("source",{src:"https://cdn.directus.io/docs/v9/app-guide/filters/filters-20220303A/dynamic-variables-20220307A.mp4",type:"video/mp4"})],-1),te=t("The following Dynamic Variables are built into Directus to make Filtering easier: "),oe=e("code",null,"$CURRENT_USER",-1),le=t(", "),ie=e("code",null,"$CURRENT_ROLE",-1),se=t(", "),ne=e("code",null,"$NOW",-1),re=t(" and "),ae=e("code",null,"$NOW(<adjustment>)",-1),de=t(". For more information, please see the Dynamic Variables section in "),ce=t("Filter Rules"),ue=t("."),he=e("h2",{id:"filtering-by-related-collections",tabindex:"-1"},[e("a",{class:"header-anchor",href:"#filtering-by-related-collections"},"#"),t(" Filtering by Related Collections")],-1),_e=e("p",null,[t("You may need to run filters on one Collection "),e("em",null,"based on information in another related Collection"),t(". Here are a few examples of when that might happen:")],-1),pe=e("ul",null,[e("li",null,[t("Book authors that also wrote screenplays (filters "),e("code",null,"authors"),t(", uses "),e("code",null,"screenplays"),t(").")]),e("li",null,[t("Products with a 5 star customer review (filters "),e("code",null,"products"),t(", uses "),e("code",null,"reviews"),t(").")]),e("li",null,[t("Accounts with active user login within the last 12 months (filters "),e("code",null,"accounts"),t(", uses "),e("code",null,"logins"),t(").")])],-1),fe=e("p",null,[t("This can span across any number of relationally linked Collections. For example, you could filter for customers that bought rock songs, where the "),e("code",null,"customers"),t(" and "),e("code",null,"genres"),t(" Collections are linked by "),e("code",null,"customers"),t(" -> "),e("code",null,"invoices"),t(" -> "),e("code",null,"invoice-items"),t(" -> "),e("code",null,"tracks"),t(" -> "),e("code",null,"genres"),t(".")],-1),me=t("You will notice a "),be=e("span",{mi:"",icon:""},"chevron_right",-1),ye=t(" icon beside relational Fields. When you click on any "),ge=t("Alias"),we=t(" Field, all the Fields for that associated Collection pop down. If you select one of these Fields, you can run Filters on the current Collection by Field values in a related Collection."),Fe=e("p",null,"Here are step-by-step instructions on how to filter by Fields in other Collections:",-1),ve=e("video",{autoplay:"",muted:"",loop:"",controls:"",title:"How Filters Work"},[e("source",{src:"https://cdn.directus.io/docs/v9/app-guide/filters/filters-20220303A/filtering-by-related-collections-20220303A.mp4",type:"video/mp4"})],-1),Ae=e("ol",null,[e("li",null,"Click \u201CAdd Filter\u201D."),e("li",null,"Click the desired relational Field. This will pop down and display the related Collection Fields."),e("li",null,"Select a Field from this related Collection."),e("li",null,"Set the Operator and Value as desired.")],-1),ke=e("h2",{id:"unfilterable-fields",tabindex:"-1"},[e("a",{class:"header-anchor",href:"#unfilterable-fields"},"#"),t(" Unfilterable Fields")],-1),Ce=e("p",null,[e("img",{src:"https://cdn.directus.io/docs/v9/app-guide/filters/filters-20220303A/unfilterable-fields-20220303A.webp",alt:"Unfilterable Fields"})],-1),xe=e("p",null,[t("Not all Fields can be filtered. As seen above in "),e("a",{href:"#filtering-by-related-collections"},"Filtering by Related Collections"),t(", Alias Fields cannot be filtered; they instead provide a dropdown menu to access Fields from a related Collection. Additionally, the \u201CPresentation\u201D and \u201CGroup\u201D Fields cannot be filtered at all and will not appear as an option in Filters.")],-1),Oe=e("h2",{id:"extensibility-options",tabindex:"-1"},[e("a",{class:"header-anchor",href:"#extensibility-options"},"#"),t(" Extensibility Options")],-1),Re=e("p",null,"Directus Core is completely open-source, modular and extensible. Extensions allow you to expand or modify any part of Directus to fit your needs. Here are some great resources to get started down that track.",-1),De=t("Extensions > Introduction"),Ne=t("Extensions > Creating Extensions"),Ge=t("Contributing > Introduction"),Ie=t("Contributing > Codebase Overview"),Ve=e("div",{class:"tip hint"},[e("div",{class:"hint-title"},"Accelerated Development"),e("p",null,[t("Working on an enterprise project and looking to outsource or financially sponsor the development of a Shares extension? Contact "),e("a",{href:"https://directus.io/contact/",target:"_blank",rel:"noopener noreferrer"},"our team")])],-1),Ee=e("h2",{id:"more-help",tabindex:"-1"},[e("a",{class:"header-anchor",href:"#more-help"},"#"),t(" More Help")],-1),He=e("p",null,[t("Looking for technical support for your non-enterprise project? Chat with thousands of engineers within our growing "),e("a",{href:"https://discord.com/invite/directus",target:"_blank",rel:"noopener noreferrer"},"Community on Discord")],-1),Be="Filters",$e=!1,je={name:"filters",setup(Te,{expose:r}){const s={title:"Filters",modularExtension:!1};return r({frontmatter:s}),(Ue,We)=>{const l=n("router-link"),a=n("docs-wrapper");return d(),c(a,{frontmatter:s},{default:o(()=>[e("div",u,[h,_,p,e("div",f,[m,e("p",null,[b,i(l,{to:"/docs/reference/filter-rules/"},{default:o(()=>[y]),_:1}),g])]),w,e("div",F,[v,e("p",null,[A,e("em",null,[k,i(l,{to:"/docs/configuration/data-model/"},{default:o(()=>[C]),_:1}),x]),O,i(l,{to:"/docs/configuration/users-roles-permissions.md"},{default:o(()=>[R]),_:1}),D])]),e("p",null,[N,G,I,i(l,{to:"/docs/reference/filter-rules/#filter-operators"},{default:o(()=>[V]),_:1}),E,H,T]),U,W,S,e("div",B,[$,e("p",null,[j,P,q,i(l,{to:"/docs/reference/filter-rules/#filter-operators"},{default:o(()=>[L]),_:1}),M])]),Y,z,K,J,Q,X,Z,ee,e("p",null,[te,oe,le,ie,se,ne,re,ae,de,i(l,{to:"/docs/reference/filter-rules/"},{default:o(()=>[ce]),_:1}),ue]),he,_e,pe,fe,e("p",null,[me,be,ye,i(l,{to:"/docs/getting-started/glossary/#alias"},{default:o(()=>[ge]),_:1}),we]),Fe,ve,Ae,ke,Ce,xe,Oe,Re,e("ul",null,[e("li",null,[i(l,{to:"/docs/extensions/introduction/"},{default:o(()=>[De]),_:1})]),e("li",null,[i(l,{to:"/docs/extensions/creating-extensions/"},{default:o(()=>[Ne]),_:1})]),e("li",null,[i(l,{to:"/docs/contributing/introduction/"},{default:o(()=>[Ge]),_:1})]),e("li",null,[i(l,{to:"/docs/contributing/codebase-overview/"},{default:o(()=>[Ie]),_:1})])]),Ve,Ee,He])]),_:1})}}};export{je as default,$e as modularExtension,Be as title};

package/dist/assets/flows.0173f6d4.js

@@ -1,172 +0,0 @@
-import{a as o,o as h,b as i,w as a,g as s,e as l,B as e}from"./runtime-core.esm-bundler.e3d5f5b7.js";const d={class:"markdown-body"},p=s("div",{class:"two-up"},[s("div",{class:"left"},[s("blockquote",null,[s("p",null,"Flows enable custom, event-driven data processing and task automation within Directus.")])]),s("div",{class:"right"},[s("p",null,[s("div",{class:"table-of-contents"},[s("ul",null,[s("li",null,[s("a",{href:"#the-flow-object"}," The Flow Object")]),s("li",null,[s("a",{href:"#list-flows"}," List Flows")]),s("li",null,[s("a",{href:"#retrieve-a-flow"}," Retrieve a flow")]),s("li",null,[s("a",{href:"#create-a-flow"}," Create a Flow")]),s("li",null,[s("a",{href:"#create-multiple-flows"}," Create Multiple Flows")]),s("li",null,[s("a",{href:"#update-a-flow"}," Update a Flow")]),s("li",null,[s("a",{href:"#update-multiple-flows"}," Update Multiple Flows")]),s("li",null,[s("a",{href:"#delete-a-flow"}," Delete a Flow")]),s("li",null,[s("a",{href:"#delete-multiple-flows"}," Delete Multiple Flows")]),s("li",null,[s("a",{href:"#flow-with-get-webhook-trigger"}," Flow with GET webhook trigger")]),s("li",null,[s("a",{href:"#flow-with-post-webhook-trigger"}," Flow with POST webhook trigger")])])])])])],-1),u=s("hr",null,null,-1),f=s("h2",{id:"the-flow-object",tabindex:"-1"},[s("a",{class:"header-anchor",href:"#the-flow-object"},"#"),e(" The Flow Object")],-1),_={class:"two-up"},g={class:"left"},w={class:"definitions"},j=s("p",null,[s("code",null,"id"),e(),s("strong",null,"uuid"),s("br"),e(" Primary key of the flow.")],-1),b=s("p",null,[s("code",null,"name"),e(),s("strong",null,"string"),s("br"),e(" Name for the flow.")],-1),m=s("p",null,[s("code",null,"icon"),e(),s("strong",null,"string"),s("br"),e(" Icon displayed in the Admin App for the flow.")],-1),y=s("p",null,[s("code",null,"color"),e(),s("strong",null,"string"),s("br"),e(" Color of the icon displayed in the Admin App for the flow.")],-1),x=s("p",null,[s("code",null,"note"),e(),s("strong",null,"text"),s("br"),e(" Short description displayed in the Admin App.")],-1),q=s("p",null,[s("code",null,"status"),e(),s("strong",null,"string"),s("br"),e(" Current status of the flow. One of "),s("code",null,"active"),e(", "),s("code",null,"inactive"),e(". Defaults to "),s("code",null,"active"),e(" when not specified.")],-1),v=s("p",null,[s("code",null,"trigger"),e(),s("strong",null,"string"),s("br"),e(" Type of trigger for the flow. One of "),s("code",null,"hook"),e(", "),s("code",null,"webhook"),e(", "),s("code",null,"operation"),e(", "),s("code",null,"schedule"),e(", "),s("code",null,"manual"),e(".")],-1),E=s("p",null,[s("code",null,"options"),e(),s("strong",null,"json"),s("br"),e(" Options of the selected trigger for the flow.")],-1),T=s("p",null,[s("code",null,"accountability"),e(),s("strong",null,"string"),s("br"),e(" The permission used during the flow. One of "),s("code",null,"$public"),e(", "),s("code",null,"$trigger"),e(", "),s("code",null,"$full"),e(", or UUID of a role.")],-1),k=s("p",null,[s("code",null,"date_created"),e(),s("strong",null,"timestamp"),s("br"),e(" Timestamp in ISO8601 when the flow was created.")],-1),P=s("code",null,"user_created",-1),S=e(),R=s("strong",null,"many-to-one",-1),F=s("br",null,null,-1),A=e(" The user who created the flow. Many-to-one to "),O=e("users"),D=e("."),I=s("p",null,[s("code",null,"operation"),e(),s("strong",null,"string"),s("br"),e(" UUID of the operation connected to the trigger in the flow.")],-1),M=s("div",{class:"right"},[s("pre",null,[s("code",{class:"language-json"},[s("span",{class:"hljs-punctuation"},"{"),e(`
-	`),s("span",{class:"hljs-attr"},'"id"'),s("span",{class:"hljs-punctuation"},":"),e(),s("span",{class:"hljs-string"},'"2fab3b9d-0543-4b87-8a30-3c5ee66fedf1"'),s("span",{class:"hljs-punctuation"},","),e(`
-	`),s("span",{class:"hljs-attr"},'"name"'),s("span",{class:"hljs-punctuation"},":"),e(),s("span",{class:"hljs-string"},'"My Flow"'),s("span",{class:"hljs-punctuation"},","),e(`
-	`),s("span",{class:"hljs-attr"},'"icon"'),s("span",{class:"hljs-punctuation"},":"),e(),s("span",{class:"hljs-string"},'"bolt"'),s("span",{class:"hljs-punctuation"},","),e(`
-	`),s("span",{class:"hljs-attr"},'"color"'),s("span",{class:"hljs-punctuation"},":"),e(),s("span",{class:"hljs-string"},'"#112233"'),s("span",{class:"hljs-punctuation"},","),e(`
-	`),s("span",{class:"hljs-attr"},'"note"'),s("span",{class:"hljs-punctuation"},":"),e(),s("span",{class:"hljs-string"},'"Note for my flow"'),s("span",{class:"hljs-punctuation"},","),e(`
-	`),s("span",{class:"hljs-attr"},'"status"'),s("span",{class:"hljs-punctuation"},":"),e(),s("span",{class:"hljs-string"},'"active"'),s("span",{class:"hljs-punctuation"},","),e(`
-	`),s("span",{class:"hljs-attr"},'"trigger"'),s("span",{class:"hljs-punctuation"},":"),e(),s("span",{class:"hljs-string"},'"manual"'),s("span",{class:"hljs-punctuation"},","),e(`
-	`),s("span",{class:"hljs-attr"},'"accountability"'),s("span",{class:"hljs-punctuation"},":"),e(),s("span",{class:"hljs-string"},'"$trigger"'),s("span",{class:"hljs-punctuation"},","),e(`
-	`),s("span",{class:"hljs-attr"},'"date_created"'),s("span",{class:"hljs-punctuation"},":"),e(),s("span",{class:"hljs-string"},'"2022-05-11T13:14:52Z"'),s("span",{class:"hljs-punctuation"},","),e(`
-	`),s("span",{class:"hljs-attr"},'"user_created"'),s("span",{class:"hljs-punctuation"},":"),e(),s("span",{class:"hljs-string"},'"12e62fd0-29c7-4fd3-b3d3-c7a39933e8af"'),s("span",{class:"hljs-punctuation"},","),e(`
-	`),s("span",{class:"hljs-attr"},'"operation"'),s("span",{class:"hljs-punctuation"},":"),e(),s("span",{class:"hljs-string"},'"92e82998-e421-412f-a513-13701e83e4ce"'),e(`
-`),s("span",{class:"hljs-punctuation"},"}"),e(`
-`)])])],-1),C=s("hr",null,null,-1),L=s("h2",{id:"list-flows",tabindex:"-1"},[s("a",{class:"header-anchor",href:"#list-flows"},"#"),e(" List Flows")],-1),G=s("p",null,"List all flows that exist in Directus.",-1),Q={class:"two-up"},U={class:"left"},B=s("h3",{id:"query-parameters",tabindex:"-1"},[s("a",{class:"header-anchor",href:"#query-parameters"},"#"),e(" Query Parameters")],-1),H=e("Supports all "),N=e("global query parameters"),$=e("."),V=s("h3",{id:"returns",tabindex:"-1"},[s("a",{class:"header-anchor",href:"#returns"},"#"),e(" Returns")],-1),Z=e("An array of up to "),z=e("limit"),J=e(),K=s("a",{href:"#the-flow-object"},"flow objects",-1),W=e(". If no items are available, data will be an empty array."),X={class:"right"},Y=s("h3",{id:"rest-api",tabindex:"-1"},[s("a",{class:"header-anchor",href:"#rest-api"},"#"),e(" REST API")],-1),ss=s("pre",null,[s("code",null,`GET /flows
-SEARCH /flows
-`)],-1),es=e("Learn more about SEARCH ->"),as=s("h3",{id:"graphql",tabindex:"-1"},[s("a",{class:"header-anchor",href:"#graphql"},"#"),e(" GraphQL")],-1),ts=s("pre",null,[s("code",null,`POST /graphql/system
-`)],-1),ls=s("pre",null,[s("code",{class:"language-graphql"},[s("span",{class:"hljs-keyword"},"type"),s("span",{class:"hljs-type"}," Query"),e(` {
-	flows: [directus_flows]
-}
-`)])],-1),ns=s("h5",{id:"example",tabindex:"-1"},[s("a",{class:"header-anchor",href:"#example"},"#"),e(" Example")],-1),os=s("pre",null,[s("code",{class:"language-graphql"},[s("span",{class:"hljs-keyword"},"query"),e(` {
-	flows {
-		id
-		name
-		status
-	}
-}
-`)])],-1),rs=s("hr",null,null,-1),cs=s("h2",{id:"retrieve-a-flow",tabindex:"-1"},[s("a",{class:"header-anchor",href:"#retrieve-a-flow"},"#"),e(" Retrieve a flow")],-1),hs=s("p",null,"List an existing flow by primary key.",-1),is={class:"two-up"},ds={class:"left"},ps=s("h3",{id:"query-parameters-1",tabindex:"-1"},[s("a",{class:"header-anchor",href:"#query-parameters-1"},"#"),e(" Query Parameters")],-1),us=e("Supports all "),fs=e("global query parameters"),_s=e("."),gs=s("h3",{id:"returns-1",tabindex:"-1"},[s("a",{class:"header-anchor",href:"#returns-1"},"#"),e(" Returns")],-1),ws=s("p",null,[e("Returns the requested "),s("a",{href:"#the-flow-object"},"flow object"),e(".")],-1),js=s("div",{class:"right"},[s("h3",{id:"rest-api-1",tabindex:"-1"},[s("a",{class:"header-anchor",href:"#rest-api-1"},"#"),e(" REST API")]),s("pre",null,[s("code",null,`GET /flows/:id
-`)]),s("h5",{id:"example-1",tabindex:"-1"},[s("a",{class:"header-anchor",href:"#example-1"},"#"),e(" Example")]),s("pre",null,[s("code",null,`GET /flows/2fc325fb-299b-4d20-a9e7-a34349dee8b2
-`)]),s("h3",{id:"graphql-1",tabindex:"-1"},[s("a",{class:"header-anchor",href:"#graphql-1"},"#"),e(" GraphQL")]),s("pre",null,[s("code",null,`POST /graphql/system
-`)]),s("pre",null,[s("code",{class:"language-graphql"},[s("span",{class:"hljs-keyword"},"type"),s("span",{class:"hljs-type"}," Query"),e(` {
-	flows_by_id(id:`),s("span",{class:"hljs-literal"}," ID"),e(`!): directus_flows
-}
-`)])]),s("h5",{id:"example-2",tabindex:"-1"},[s("a",{class:"header-anchor",href:"#example-2"},"#"),e(" Example")]),s("pre",null,[s("code",{class:"language-graphql"},[s("span",{class:"hljs-keyword"},"query"),e(` {
-	flows_by_id(id: `),s("span",{class:"hljs-string"},'"2fc325fb-299b-4d20-a9e7-a34349dee8b2"'),e(`) {
-		id
-		name
-		status
-	}
-}
-`)])])],-1),bs=s("hr",null,null,-1),ms=s("h2",{id:"create-a-flow",tabindex:"-1"},[s("a",{class:"header-anchor",href:"#create-a-flow"},"#"),e(" Create a Flow")],-1),ys=s("p",null,"Create a new flow.",-1),xs={class:"two-up"},qs={class:"left"},vs=s("h3",{id:"query-parameters-2",tabindex:"-1"},[s("a",{class:"header-anchor",href:"#query-parameters-2"},"#"),e(" Query Parameters")],-1),Es=e("Supports all "),Ts=e("global query parameters"),ks=e("."),Ps=s("h3",{id:"request-body",tabindex:"-1"},[s("a",{class:"header-anchor",href:"#request-body"},"#"),e(" Request Body")],-1),Ss=s("p",null,[e("A partial "),s("a",{href:"#the-flow-object"},"flow object"),e(".")],-1),Rs=s("h3",{id:"returns-2",tabindex:"-1"},[s("a",{class:"header-anchor",href:"#returns-2"},"#"),e(" Returns")],-1),Fs=s("p",null,[e("Returns the "),s("a",{href:"#the-flow-object"},"flow object"),e(" for the created flow.")],-1),As=s("div",{class:"right"},[s("h3",{id:"rest-api-2",tabindex:"-1"},[s("a",{class:"header-anchor",href:"#rest-api-2"},"#"),e(" REST API")]),s("pre",null,[s("code",null,`POST /flows
-`)]),s("h5",{id:"example-3",tabindex:"-1"},[s("a",{class:"header-anchor",href:"#example-3"},"#"),e(" Example")]),s("pre",null,[s("code",{class:"language-json"},[s("span",{class:"hljs-comment"},"// POST /flows"),e(`
-
-`),s("span",{class:"hljs-punctuation"},"{"),e(`
-	`),s("span",{class:"hljs-attr"},'"name"'),s("span",{class:"hljs-punctuation"},":"),e(),s("span",{class:"hljs-string"},'"My Flow"'),s("span",{class:"hljs-punctuation"},","),e(`
-	`),s("span",{class:"hljs-attr"},'"status"'),s("span",{class:"hljs-punctuation"},":"),e(),s("span",{class:"hljs-string"},'"active"'),s("span",{class:"hljs-punctuation"},","),e(`
-	`),s("span",{class:"hljs-attr"},'"trigger"'),s("span",{class:"hljs-punctuation"},":"),e(),s("span",{class:"hljs-string"},'"manual"'),e(`
-`),s("span",{class:"hljs-punctuation"},"}"),e(`
-`)])]),s("h3",{id:"graphql-2",tabindex:"-1"},[s("a",{class:"header-anchor",href:"#graphql-2"},"#"),e(" GraphQL")]),s("pre",null,[s("code",null,`POST /graphql/system
-`)]),s("pre",null,[s("code",{class:"language-graphql"},[s("span",{class:"hljs-keyword"},"type"),s("span",{class:"hljs-type"}," Mutation"),e(` {
-	create_flows_item(data: create_directus_flows_input!): directus_flows
-}
-`)])]),s("h5",{id:"example-4",tabindex:"-1"},[s("a",{class:"header-anchor",href:"#example-4"},"#"),e(" Example")]),s("pre",null,[s("code",{class:"language-graphql"},[s("span",{class:"hljs-keyword"},"mutation"),e(` {
-	create_flows_item(data: { name: `),s("span",{class:"hljs-string"},'"My Flow"'),e(", status: "),s("span",{class:"hljs-string"},'"active"'),e(", trigger: "),s("span",{class:"hljs-string"},'"manual"'),e(` }) {
-		id
-		name
-		status
-	}
-}
-`)])])],-1),Os=s("hr",null,null,-1),Ds=s("h2",{id:"create-multiple-flows",tabindex:"-1"},[s("a",{class:"header-anchor",href:"#create-multiple-flows"},"#"),e(" Create Multiple Flows")],-1),Is=s("p",null,"Create multiple new flows.",-1),Ms={class:"two-up"},Cs={class:"left"},Ls=s("h3",{id:"query-parameters-3",tabindex:"-1"},[s("a",{class:"header-anchor",href:"#query-parameters-3"},"#"),e(" Query Parameters")],-1),Gs=e("Supports all "),Qs=e("global query parameters"),Us=e("."),Bs=s("h3",{id:"request-body-1",tabindex:"-1"},[s("a",{class:"header-anchor",href:"#request-body-1"},"#"),e(" Request Body")],-1),Hs=s("p",null,[e("An array of partial "),s("a",{href:"#the-flow-object"},"flow objects"),e(".")],-1),Ns=s("h3",{id:"returns-3",tabindex:"-1"},[s("a",{class:"header-anchor",href:"#returns-3"},"#"),e(" Returns")],-1),$s=s("p",null,[e("Returns the "),s("a",{href:"#the-flow-object"},"flow object"),e(" for the created flow.")],-1),Vs=s("div",{class:"right"},[s("h3",{id:"rest-api-3",tabindex:"-1"},[s("a",{class:"header-anchor",href:"#rest-api-3"},"#"),e(" REST API")]),s("pre",null,[s("code",null,`POST /flows
-`)]),s("h5",{id:"example-5",tabindex:"-1"},[s("a",{class:"header-anchor",href:"#example-5"},"#"),e(" Example")]),s("pre",null,[s("code",{class:"language-json"},[s("span",{class:"hljs-comment"},"// POST /flows"),e(`
-
-`),s("span",{class:"hljs-punctuation"},"["),e(`
-	`),s("span",{class:"hljs-punctuation"},"{"),e(`
-		`),s("span",{class:"hljs-attr"},'"name"'),s("span",{class:"hljs-punctuation"},":"),e(),s("span",{class:"hljs-string"},'"My Flow"'),s("span",{class:"hljs-punctuation"},","),e(`
-		`),s("span",{class:"hljs-attr"},'"status"'),s("span",{class:"hljs-punctuation"},":"),e(),s("span",{class:"hljs-string"},'"active"'),s("span",{class:"hljs-punctuation"},","),e(`
-		`),s("span",{class:"hljs-attr"},'"trigger"'),s("span",{class:"hljs-punctuation"},":"),e(),s("span",{class:"hljs-string"},'"manual"'),e(`
-	`),s("span",{class:"hljs-punctuation"},"}"),s("span",{class:"hljs-punctuation"},","),e(`
-	`),s("span",{class:"hljs-punctuation"},"{"),e(`
-		`),s("span",{class:"hljs-attr"},'"name"'),s("span",{class:"hljs-punctuation"},":"),e(),s("span",{class:"hljs-string"},'"Another Flow"'),s("span",{class:"hljs-punctuation"},","),e(`
-		`),s("span",{class:"hljs-attr"},'"status"'),s("span",{class:"hljs-punctuation"},":"),e(),s("span",{class:"hljs-string"},'"active"'),s("span",{class:"hljs-punctuation"},","),e(`
-		`),s("span",{class:"hljs-attr"},'"trigger"'),s("span",{class:"hljs-punctuation"},":"),e(),s("span",{class:"hljs-string"},'"webhook"'),e(`
-	`),s("span",{class:"hljs-punctuation"},"}"),e(`
-`),s("span",{class:"hljs-punctuation"},"]"),e(`
-`)])]),s("h3",{id:"graphql-3",tabindex:"-1"},[s("a",{class:"header-anchor",href:"#graphql-3"},"#"),e(" GraphQL")]),s("pre",null,[s("code",null,`POST /graphql/system
-`)]),s("pre",null,[s("code",{class:"language-graphql"},[s("span",{class:"hljs-keyword"},"type"),s("span",{class:"hljs-type"}," Mutation"),e(` {
-	create_flows_items(data: [create_directus_flows_input!]!): [directus_flows]
-}
-`)])]),s("h5",{id:"example-6",tabindex:"-1"},[s("a",{class:"header-anchor",href:"#example-6"},"#"),e(" Example")]),s("pre",null,[s("code",{class:"language-graphql"},[s("span",{class:"hljs-keyword"},"mutation"),e(` {
-	create_flows_items(
-		data: [
-			{
-				`),s("span",{class:"hljs-string"},'"name"'),e(": "),s("span",{class:"hljs-string"},'"My Flow"'),e(`,
-				`),s("span",{class:"hljs-string"},'"status"'),e(": "),s("span",{class:"hljs-string"},'"active"'),e(`,
-				`),s("span",{class:"hljs-string"},'"trigger"'),e(": "),s("span",{class:"hljs-string"},'"manual"'),e(`
-			},
-			{
-				`),s("span",{class:"hljs-string"},'"name"'),e(": "),s("span",{class:"hljs-string"},'"Another Flow"'),e(`,
-				`),s("span",{class:"hljs-string"},'"status"'),e(": "),s("span",{class:"hljs-string"},'"active"'),e(`,
-				`),s("span",{class:"hljs-string"},'"trigger"'),e(": "),s("span",{class:"hljs-string"},'"webhook"'),e(`
-			}
-		]
-	) {
-		id
-		name
-		status
-	}
-}
-`)])])],-1),Zs=s("hr",null,null,-1),zs=s("h2",{id:"update-a-flow",tabindex:"-1"},[s("a",{class:"header-anchor",href:"#update-a-flow"},"#"),e(" Update a Flow")],-1),Js=s("p",null,"Update an existing flow.",-1),Ks={class:"two-up"},Ws={class:"left"},Xs=s("h3",{id:"query-parameters-4",tabindex:"-1"},[s("a",{class:"header-anchor",href:"#query-parameters-4"},"#"),e(" Query Parameters")],-1),Ys=e("Supports all "),se=e("global query parameters"),ee=e("."),ae=s("h3",{id:"request-body-2",tabindex:"-1"},[s("a",{class:"header-anchor",href:"#request-body-2"},"#"),e(" Request Body")],-1),te=s("p",null,[e("A partial "),s("a",{href:"#the-flow-object"},"flow object"),e(".")],-1),le=s("h3",{id:"returns-4",tabindex:"-1"},[s("a",{class:"header-anchor",href:"#returns-4"},"#"),e(" Returns")],-1),ne=s("p",null,[e("Returns the "),s("a",{href:"#the-flow-object"},"flow object"),e(" for the updated flow.")],-1),oe=s("div",{class:"right"},[s("h3",{id:"rest-api-4",tabindex:"-1"},[s("a",{class:"header-anchor",href:"#rest-api-4"},"#"),e(" REST API")]),s("pre",null,[s("code",null,`PATCH /flows/:id
-`)]),s("h5",{id:"example-7",tabindex:"-1"},[s("a",{class:"header-anchor",href:"#example-7"},"#"),e(" Example")]),s("pre",null,[s("code",{class:"language-json"},[s("span",{class:"hljs-comment"},"// PATCH /flows/2fc325fb-299b-4d20-a9e7-a34349dee8b2"),e(`
-
-`),s("span",{class:"hljs-punctuation"},"{"),e(`
-	`),s("span",{class:"hljs-attr"},'"name"'),s("span",{class:"hljs-punctuation"},":"),e(),s("span",{class:"hljs-string"},'"My Updated Flow"'),e(`
-`),s("span",{class:"hljs-punctuation"},"}"),e(`
-`)])]),s("h3",{id:"graphql-4",tabindex:"-1"},[s("a",{class:"header-anchor",href:"#graphql-4"},"#"),e(" GraphQL")]),s("pre",null,[s("code",null,`POST /graphql/system
-`)]),s("pre",null,[s("code",{class:"language-graphql"},[s("span",{class:"hljs-keyword"},"type"),s("span",{class:"hljs-type"}," Mutation"),e(` {
-	update_flows_item(id:`),s("span",{class:"hljs-literal"}," ID"),e(`!, data: update_directus_flows_input): directus_flows
-}
-`)])]),s("h5",{id:"example-8",tabindex:"-1"},[s("a",{class:"header-anchor",href:"#example-8"},"#"),e(" Example")]),s("pre",null,[s("code",{class:"language-graphql"},[s("span",{class:"hljs-keyword"},"mutation"),e(` {
-	update_flows_item(id: `),s("span",{class:"hljs-string"},'"2fc325fb-299b-4d20-a9e7-a34349dee8b2"'),e(", data: { name: "),s("span",{class:"hljs-string"},'"My Updated Flow"'),e(` }) {
-		id
-		name
-	}
-}
-`)])])],-1),re=s("hr",null,null,-1),ce=s("h2",{id:"update-multiple-flows",tabindex:"-1"},[s("a",{class:"header-anchor",href:"#update-multiple-flows"},"#"),e(" Update Multiple Flows")],-1),he=s("p",null,"Update multiple existing flows.",-1),ie={class:"two-up"},de={class:"left"},pe=s("h3",{id:"query-parameters-5",tabindex:"-1"},[s("a",{class:"header-anchor",href:"#query-parameters-5"},"#"),e(" Query Parameters")],-1),ue=e("Supports all "),fe=e("global query parameters"),_e=e("."),ge=s("h3",{id:"request-body-3",tabindex:"-1"},[s("a",{class:"header-anchor",href:"#request-body-3"},"#"),e(" Request Body")],-1),we=s("div",{class:"definitions"},[s("p",null,[s("code",null,"keys"),e(),s("strong",null,"Required"),s("br"),e(" Array of primary keys of the flows you\u2019d like to update.")]),s("p",null,[s("code",null,"data"),e(),s("strong",null,"Required"),s("br"),e(" Any of "),s("a",{href:"#the-flow-object"},"the flow object"),e("\u2019s properties.")])],-1),je=s("h3",{id:"returns-5",tabindex:"-1"},[s("a",{class:"header-anchor",href:"#returns-5"},"#"),e(" Returns")],-1),be=s("p",null,[e("Returns the "),s("a",{href:"#the-flow-object"},"flow objects"),e(" for the updated flows.")],-1),me=s("div",{class:"right"},[s("h3",{id:"rest-api-5",tabindex:"-1"},[s("a",{class:"header-anchor",href:"#rest-api-5"},"#"),e(" REST API")]),s("pre",null,[s("code",null,`PATCH /flows
-`)]),s("h5",{id:"example-9",tabindex:"-1"},[s("a",{class:"header-anchor",href:"#example-9"},"#"),e(" Example")]),s("pre",null,[s("code",{class:"language-json"},[s("span",{class:"hljs-comment"},"// PATCH /flows"),e(`
-
-`),s("span",{class:"hljs-punctuation"},"{"),e(`
-	`),s("span",{class:"hljs-attr"},'"keys"'),s("span",{class:"hljs-punctuation"},":"),e(),s("span",{class:"hljs-punctuation"},"["),s("span",{class:"hljs-string"},'"3f2facab-7f05-4ee8-a7a3-d8b9c634a1fc"'),s("span",{class:"hljs-punctuation"},","),e(),s("span",{class:"hljs-string"},'"7259bfa8-3786-45c6-8c08-cc688e7ba229"'),s("span",{class:"hljs-punctuation"},"]"),s("span",{class:"hljs-punctuation"},","),e(`
-	`),s("span",{class:"hljs-attr"},'"data"'),s("span",{class:"hljs-punctuation"},":"),e(),s("span",{class:"hljs-punctuation"},"{"),e(`
-		`),s("span",{class:"hljs-attr"},'"status"'),s("span",{class:"hljs-punctuation"},":"),e(),s("span",{class:"hljs-string"},'"inactive"'),e(`
-	`),s("span",{class:"hljs-punctuation"},"}"),e(`
-`),s("span",{class:"hljs-punctuation"},"}"),e(`
-`)])]),s("h3",{id:"graphql-5",tabindex:"-1"},[s("a",{class:"header-anchor",href:"#graphql-5"},"#"),e(" GraphQL")]),s("pre",null,[s("code",null,`POST /graphql/system
-`)]),s("pre",null,[s("code",{class:"language-graphql"},[s("span",{class:"hljs-keyword"},"type"),s("span",{class:"hljs-type"}," Mutation"),e(` {
-	update_flows_items(ids: `),s("span",{class:"hljs-literal"},"[ID"),e(`!]!, data: update_directus_flows_input): [directus_flows]
-}
-`)])]),s("h5",{id:"example-10",tabindex:"-1"},[s("a",{class:"header-anchor",href:"#example-10"},"#"),e(" Example")]),s("pre",null,[s("code",{class:"language-graphql"},[s("span",{class:"hljs-keyword"},"mutation"),e(` {
-	update_flows_items(
-		ids: [`),s("span",{class:"hljs-string"},'"3f2facab-7f05-4ee8-a7a3-d8b9c634a1fc"'),e(", "),s("span",{class:"hljs-string"},'"7259bfa8-3786-45c6-8c08-cc688e7ba229"'),e(`]
-		data: { status: `),s("span",{class:"hljs-string"},'"inactive"'),e(` }
-	) {
-		id
-		name
-		status
-	}
-}
-`)])])],-1),ye=s("hr",null,null,-1),xe=s("h2",{id:"delete-a-flow",tabindex:"-1"},[s("a",{class:"header-anchor",href:"#delete-a-flow"},"#"),e(" Delete a Flow")],-1),qe=s("p",null,"Delete an existing flow.",-1),ve=s("div",{class:"two-up"},[s("div",{class:"left"},[s("h3",{id:"returns-6",tabindex:"-1"},[s("a",{class:"header-anchor",href:"#returns-6"},"#"),e(" Returns")]),s("p",null,"Empty body.")]),s("div",{class:"right"},[s("h3",{id:"rest-api-6",tabindex:"-1"},[s("a",{class:"header-anchor",href:"#rest-api-6"},"#"),e(" REST API")]),s("pre",null,[s("code",null,`DELETE /flows/:id
-`)]),s("h5",{id:"example-11",tabindex:"-1"},[s("a",{class:"header-anchor",href:"#example-11"},"#"),e(" Example")]),s("pre",null,[s("code",null,`DELETE /flows/12204ee2-2c82-4d9a-b044-2f4842a11dba
-`)]),s("h3",{id:"graphql-6",tabindex:"-1"},[s("a",{class:"header-anchor",href:"#graphql-6"},"#"),e(" GraphQL")]),s("pre",null,[s("code",null,`POST /graphql/system
-`)]),s("pre",null,[s("code",{class:"language-graphql"},[s("span",{class:"hljs-keyword"},"type"),s("span",{class:"hljs-type"}," Mutation"),e(` {
-	delete_flows_item(id:`),s("span",{class:"hljs-literal"}," ID"),e(`!): delete_one
-}
-`)])]),s("h5",{id:"example-12",tabindex:"-1"},[s("a",{class:"header-anchor",href:"#example-12"},"#"),e(" Example")]),s("pre",null,[s("code",{class:"language-graphql"},[s("span",{class:"hljs-keyword"},"mutation"),e(` {
-	delete_flows_item(id: `),s("span",{class:"hljs-string"},'"12204ee2-2c82-4d9a-b044-2f4842a11dba"'),e(`) {
-		id
-	}
-}
-`)])])])],-1),Ee=s("hr",null,null,-1),Te=s("h2",{id:"delete-multiple-flows",tabindex:"-1"},[s("a",{class:"header-anchor",href:"#delete-multiple-flows"},"#"),e(" Delete Multiple Flows")],-1),ke=s("p",null,"Delete multiple existing flows.",-1),Pe=s("div",{class:"two-up"},[s("div",{class:"left"},[s("h3",{id:"request-body-4",tabindex:"-1"},[s("a",{class:"header-anchor",href:"#request-body-4"},"#"),e(" Request Body")]),s("p",null,"An array of flows primary keys"),s("h3",{id:"returns-7",tabindex:"-1"},[s("a",{class:"header-anchor",href:"#returns-7"},"#"),e(" Returns")]),s("p",null,"Empty body.")]),s("div",{class:"right"},[s("h3",{id:"rest-api-7",tabindex:"-1"},[s("a",{class:"header-anchor",href:"#rest-api-7"},"#"),e(" REST API")]),s("pre",null,[s("code",null,`DELETE /flows
-`)]),s("h5",{id:"example-13",tabindex:"-1"},[s("a",{class:"header-anchor",href:"#example-13"},"#"),e(" Example")]),s("pre",null,[s("code",{class:"language-json"},[s("span",{class:"hljs-comment"},"// DELETE /flows"),e(`
-`),s("span",{class:"hljs-punctuation"},"["),s("span",{class:"hljs-string"},'"25821236-8c2a-4f89-8fdc-c7d01f35877d"'),s("span",{class:"hljs-punctuation"},","),e(),s("span",{class:"hljs-string"},'"02b9486e-4273-4fd5-b94b-e18fd923d1ed"'),s("span",{class:"hljs-punctuation"},","),e(),s("span",{class:"hljs-string"},'"7d62f1e9-a83f-407b-84f8-1c184f014501"'),s("span",{class:"hljs-punctuation"},"]"),e(`
-`)])]),s("h3",{id:"graphql-7",tabindex:"-1"},[s("a",{class:"header-anchor",href:"#graphql-7"},"#"),e(" GraphQL")]),s("pre",null,[s("code",null,`POST /graphql/system
-`)]),s("pre",null,[s("code",{class:"language-graphql"},[s("span",{class:"hljs-keyword"},"type"),s("span",{class:"hljs-type"}," Mutation"),e(` {
-	delete_flows_items(ids: `),s("span",{class:"hljs-literal"},"[ID"),e(`!]!): delete_many
-}
-`)])]),s("h5",{id:"example-14",tabindex:"-1"},[s("a",{class:"header-anchor",href:"#example-14"},"#"),e(" Example")]),s("pre",null,[s("code",{class:"language-graphql"},[s("span",{class:"hljs-keyword"},"mutation"),e(` {
-	delete_flows_items(
-		ids: [
-			`),s("span",{class:"hljs-string"},'"25821236-8c2a-4f89-8fdc-c7d01f35877d"'),e(`
-			`),s("span",{class:"hljs-string"},'"02b9486e-4273-4fd5-b94b-e18fd923d1ed"'),e(`
-			`),s("span",{class:"hljs-string"},'"7d62f1e9-a83f-407b-84f8-1c184f014501"'),e(`
-		]
-	) {
-		ids
-	}
-}
-`)])])])],-1),Se=s("h2",{id:"flow-with-get-webhook-trigger",tabindex:"-1"},[s("a",{class:"header-anchor",href:"#flow-with-get-webhook-trigger"},"#"),e(" Flow with GET webhook trigger")],-1),Re=s("p",null,"Start a flow with GET webhook trigger.",-1),Fe=s("div",{class:"two-up"},[s("div",{class:"left"},[s("h3",{id:"returns-8",tabindex:"-1"},[s("a",{class:"header-anchor",href:"#returns-8"},"#"),e(" Returns")]),s("p",null,"Result of the flow, if any.")]),s("div",{class:"right"},[s("h3",{id:"rest-api-8",tabindex:"-1"},[s("a",{class:"header-anchor",href:"#rest-api-8"},"#"),e(" REST API")]),s("pre",null,[s("code",null,`GET /flows/trigger/:flow_uuid
-`)]),s("h5",{id:"example-15",tabindex:"-1"},[s("a",{class:"header-anchor",href:"#example-15"},"#"),e(" Example")]),s("pre",null,[s("code",{class:"language-json"},[s("span",{class:"hljs-comment"},"// GET /flows/trigger/202a940b-a00b-47df-b832-369c53f13122"),e(`
-`),s("span",{class:"hljs-comment"},"// Payload here"),e(`
-`)])])])],-1),Ae=s("h2",{id:"flow-with-post-webhook-trigger",tabindex:"-1"},[s("a",{class:"header-anchor",href:"#flow-with-post-webhook-trigger"},"#"),e(" Flow with POST webhook trigger")],-1),Oe=s("p",null,"Start a flow with POST webhook trigger.",-1),De=s("div",{class:"two-up"},[s("div",{class:"left"},[s("h3",{id:"request-body-5",tabindex:"-1"},[s("a",{class:"header-anchor",href:"#request-body-5"},"#"),e(" Request Body")]),s("p",null,"Payload for the POST request."),s("h3",{id:"returns-9",tabindex:"-1"},[s("a",{class:"header-anchor",href:"#returns-9"},"#"),e(" Returns")]),s("p",null,"Result of the flow, if any.")]),s("div",{class:"right"},[s("h3",{id:"rest-api-9",tabindex:"-1"},[s("a",{class:"header-anchor",href:"#rest-api-9"},"#"),e(" REST API")]),s("pre",null,[s("code",null,`POST /flows/trigger/:flow_uuid
-`)]),s("h5",{id:"example-16",tabindex:"-1"},[s("a",{class:"header-anchor",href:"#example-16"},"#"),e(" Example")]),s("pre",null,[s("code",{class:"language-json"},[s("span",{class:"hljs-comment"},"// POST /flows/trigger/202a940b-a00b-47df-b832-369c53f13122"),e(`
-`),s("span",{class:"hljs-comment"},"// Payload here"),e(`
-`)])])])],-1),Ge="Flows",Qe=!1,Ue="page-reference",Be={name:"flows",setup(Ie,{expose:r}){const n={title:"Flows",modularExtension:!1,pageClass:"page-reference"};return r({frontmatter:n}),(Me,Ce)=>{const t=o("router-link"),c=o("docs-wrapper");return h(),i(c,{frontmatter:n},{default:a(()=>[s("div",d,[p,u,f,s("div",_,[s("div",g,[s("div",w,[j,b,m,y,x,q,v,E,T,k,s("p",null,[P,S,R,F,A,l(t,{to:"/docs/reference/system/users/#the-users-object"},{default:a(()=>[O]),_:1}),D]),I])]),M]),C,L,G,s("div",Q,[s("div",U,[B,s("p",null,[H,l(t,{to:"/docs/reference/query"},{default:a(()=>[N]),_:1}),$]),V,s("p",null,[Z,l(t,{to:"/docs/reference/query/#limit"},{default:a(()=>[z]),_:1}),J,K,W])]),s("div",X,[Y,ss,s("p",null,[l(t,{to:"/docs/reference/introduction/#search-http-method"},{default:a(()=>[es]),_:1})]),as,ts,ls,ns,os])]),rs,cs,hs,s("div",is,[s("div",ds,[ps,s("p",null,[us,l(t,{to:"/docs/reference/query"},{default:a(()=>[fs]),_:1}),_s]),gs,ws]),js]),bs,ms,ys,s("div",xs,[s("div",qs,[vs,s("p",null,[Es,l(t,{to:"/docs/reference/query"},{default:a(()=>[Ts]),_:1}),ks]),Ps,Ss,Rs,Fs]),As]),Os,Ds,Is,s("div",Ms,[s("div",Cs,[Ls,s("p",null,[Gs,l(t,{to:"/docs/reference/query"},{default:a(()=>[Qs]),_:1}),Us]),Bs,Hs,Ns,$s]),Vs]),Zs,zs,Js,s("div",Ks,[s("div",Ws,[Xs,s("p",null,[Ys,l(t,{to:"/docs/reference/query"},{default:a(()=>[se]),_:1}),ee]),ae,te,le,ne]),oe]),re,ce,he,s("div",ie,[s("div",de,[pe,s("p",null,[ue,l(t,{to:"/docs/reference/query"},{default:a(()=>[fe]),_:1}),_e]),ge,we,je,be]),me]),ye,xe,qe,ve,Ee,Te,ke,Pe,Se,Re,Fe,Ae,Oe,De])]),_:1})}}};export{Be as default,Qe as modularExtension,Ue as pageClass,Ge as title};