@directus/app 9.18.1 → 9.19.1

package/dist/assets/roles.d860a4ba.js

@@ -0,0 +1,171 @@
+import{a as r,o as h,b as i,w as a,l as s,E as e,e as n}from"./runtime-core.esm-bundler.fe249c5c.js";const d={class:"markdown-body"},p=s("hr",null,null,-1),u=s("h2",{id:"the-role-object",tabindex:"-1"},[s("a",{class:"header-anchor",href:"#the-role-object"},"#"),e(" The Role Object")],-1),_=s("p",null,[s("code",null,"id"),e(),s("strong",null,"uuid"),s("br"),e(" Primary key of the role.")],-1),j=s("p",null,[s("code",null,"name"),e(),s("strong",null,"string"),s("br"),e(" Name of the role.")],-1),m=s("p",null,[s("code",null,"icon"),e(),s("strong",null,"string"),s("br"),e(" Icon for the role. Displayed in the Admin App.")],-1),f=s("p",null,[s("code",null,"description"),e(),s("strong",null,"string"),s("br"),e(" Description for the role. Displayed in the Admin App.")],-1),b=s("p",null,[s("code",null,"ip_access"),e(),s("strong",null,"csv"),s("br"),e(" A CSV of IP addresses that have access to this role. Allows you to configure an allowlist of IP addresses.")],-1),g=s("p",null,[s("code",null,"enforce_tfa"),e(),s("strong",null,"boolean"),s("br"),e(" Whether or not Two-Factor Authentication is required for users in this role.")],-1),y=s("p",null,[s("code",null,"admin_access"),e(),s("strong",null,"boolean"),s("br"),e(" If this role is considered an admin role. This means that users in this role have full permissions to everything.")],-1),x=s("p",null,[s("code",null,"app_access"),e(),s("strong",null,"boolean"),s("br"),e(" Whether or not users in this role have access to use the Admin App.")],-1),q=s("code",null,"users",-1),R=s("strong",null,"one-to-many",-1),E=s("br",null,null,-1),k=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"},'"653925a9-970e-487a-bfc0-ab6c96affcdc"'),s("span",{class:"hljs-punctuation"},","),e(`
+	`),s("span",{class:"hljs-attr"},'"name"'),s("span",{class:"hljs-punctuation"},":"),e(),s("span",{class:"hljs-string"},'"Admin"'),s("span",{class:"hljs-punctuation"},","),e(`
+	`),s("span",{class:"hljs-attr"},'"icon"'),s("span",{class:"hljs-punctuation"},":"),e(),s("span",{class:"hljs-string"},'"supervised_user_circle"'),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"},'"ip_access"'),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"},'"enforce_tfa"'),s("span",{class:"hljs-punctuation"},":"),e(),s("span",{class:"hljs-literal"},[s("span",{class:"hljs-keyword"},"false")]),s("span",{class:"hljs-punctuation"},","),e(`
+	`),s("span",{class:"hljs-attr"},'"admin_access"'),s("span",{class:"hljs-punctuation"},":"),e(),s("span",{class:"hljs-literal"},[s("span",{class:"hljs-keyword"},"true")]),s("span",{class:"hljs-punctuation"},","),e(`
+	`),s("span",{class:"hljs-attr"},'"app_access"'),s("span",{class:"hljs-punctuation"},":"),e(),s("span",{class:"hljs-literal"},[s("span",{class:"hljs-keyword"},"true")]),s("span",{class:"hljs-punctuation"},","),e(`
+	`),s("span",{class:"hljs-attr"},'"users"'),s("span",{class:"hljs-punctuation"},":"),e(),s("span",{class:"hljs-punctuation"},"["),s("span",{class:"hljs-string"},'"0bc7b36a-9ba9-4ce0-83f0-0a526f354e07"'),s("span",{class:"hljs-punctuation"},"]"),e(`
+`),s("span",{class:"hljs-punctuation"},"}"),e(`
+`)])],-1),w=s("hr",null,null,-1),T=s("h2",{id:"list-roles",tabindex:"-1"},[s("a",{class:"header-anchor",href:"#list-roles"},"#"),e(" List Roles")],-1),P=s("p",null,"List all roles that exist in Directus.",-1),A=s("h3",{id:"query-parameters",tabindex:"-1"},[s("a",{class:"header-anchor",href:"#query-parameters"},"#"),e(" Query Parameters")],-1),S=s("h3",{id:"returns",tabindex:"-1"},[s("a",{class:"header-anchor",href:"#returns"},"#"),e(" Returns")],-1),I=s("a",{href:"#the-role-object"},"role objects",-1),D=s("h3",{id:"rest-api",tabindex:"-1"},[s("a",{class:"header-anchor",href:"#rest-api"},"#"),e(" REST API")],-1),L=s("pre",null,[s("code",null,`GET /roles
+SEARCH /roles
+`)],-1),Q=s("h3",{id:"graphql",tabindex:"-1"},[s("a",{class:"header-anchor",href:"#graphql"},"#"),e(" GraphQL")],-1),C=s("pre",null,[s("code",null,`POST /graphql/system
+`)],-1),v=s("pre",null,[s("code",{class:"language-graphql"},[s("span",{class:"hljs-keyword"},"type"),s("span",{class:"hljs-type"}," Query"),e(` {
+	roles: [directus_roles]
+}
+`)])],-1),O=s("h5",{id:"example",tabindex:"-1"},[s("a",{class:"header-anchor",href:"#example"},"#"),e(" Example")],-1),G=s("pre",null,[s("code",{class:"language-graphql"},[s("span",{class:"hljs-keyword"},"query"),e(` {
+	roles {
+		id
+		name
+		users {
+			email
+		}
+	}
+}
+`)])],-1),M=s("hr",null,null,-1),B=s("h2",{id:"retrieve-a-role",tabindex:"-1"},[s("a",{class:"header-anchor",href:"#retrieve-a-role"},"#"),e(" Retrieve a Role")],-1),H=s("p",null,"List an existing role by primary key.",-1),U=s("h3",{id:"query-parameters-1",tabindex:"-1"},[s("a",{class:"header-anchor",href:"#query-parameters-1"},"#"),e(" Query Parameters")],-1),N=s("h3",{id:"returns-1",tabindex:"-1"},[s("a",{class:"header-anchor",href:"#returns-1"},"#"),e(" Returns")],-1),V=s("p",null,[e("Returns the requested "),s("a",{href:"#the-role-object"},"role object"),e(".")],-1),W=s("h3",{id:"rest-api-1",tabindex:"-1"},[s("a",{class:"header-anchor",href:"#rest-api-1"},"#"),e(" REST API")],-1),z=s("pre",null,[s("code",null,`GET /roles/:id
+`)],-1),F=s("h5",{id:"example-1",tabindex:"-1"},[s("a",{class:"header-anchor",href:"#example-1"},"#"),e(" Example")],-1),J=s("pre",null,[s("code",null,`GET /roles/b4cb3b64-8580-4ad9-a099-eade6da24302
+`)],-1),K=s("h3",{id:"graphql-1",tabindex:"-1"},[s("a",{class:"header-anchor",href:"#graphql-1"},"#"),e(" GraphQL")],-1),X=s("pre",null,[s("code",null,`POST /graphql/system
+`)],-1),Y=s("pre",null,[s("code",{class:"language-graphql"},[s("span",{class:"hljs-keyword"},"type"),s("span",{class:"hljs-type"}," Query"),e(` {
+	roles_by_id(id:`),s("span",{class:"hljs-literal"}," ID"),e(`!): directus_roles
+}
+`)])],-1),Z=s("h5",{id:"example-2",tabindex:"-1"},[s("a",{class:"header-anchor",href:"#example-2"},"#"),e(" Example")],-1),$=s("pre",null,[s("code",{class:"language-graphql"},[s("span",{class:"hljs-keyword"},"query"),e(` {
+	roles_by_id(id: `),s("span",{class:"hljs-number"},"2"),e(`) {
+		id
+		name
+		users {
+			email
+		}
+	}
+}
+`)])],-1),ss=s("hr",null,null,-1),es=s("h2",{id:"create-a-role",tabindex:"-1"},[s("a",{class:"header-anchor",href:"#create-a-role"},"#"),e(" Create a Role")],-1),as=s("p",null,"Create a new role.",-1),ts=s("h3",{id:"query-parameters-2",tabindex:"-1"},[s("a",{class:"header-anchor",href:"#query-parameters-2"},"#"),e(" Query Parameters")],-1),ns=s("h3",{id:"request-body",tabindex:"-1"},[s("a",{class:"header-anchor",href:"#request-body"},"#"),e(" Request Body")],-1),ls=s("p",null,[e("A partial "),s("a",{href:"#the-role-object"},"role object"),e(".")],-1),rs=s("h3",{id:"returns-2",tabindex:"-1"},[s("a",{class:"header-anchor",href:"#returns-2"},"#"),e(" Returns")],-1),os=s("p",null,[e("Returns the "),s("a",{href:"#the-role-object"},"role object"),e(" for the created role.")],-1),cs=s("h3",{id:"rest-api-2",tabindex:"-1"},[s("a",{class:"header-anchor",href:"#rest-api-2"},"#"),e(" REST API")],-1),hs=s("pre",null,[s("code",null,`POST /roles
+`)],-1),is=s("h5",{id:"example-3",tabindex:"-1"},[s("a",{class:"header-anchor",href:"#example-3"},"#"),e(" Example")],-1),ds=s("pre",null,[s("code",{class:"language-json"},[s("span",{class:"hljs-comment"},"// POST /roles"),e(`
+
+`),s("span",{class:"hljs-punctuation"},"{"),e(`
+	`),s("span",{class:"hljs-attr"},'"name"'),s("span",{class:"hljs-punctuation"},":"),e(),s("span",{class:"hljs-string"},'"Interns"'),s("span",{class:"hljs-punctuation"},","),e(`
+	`),s("span",{class:"hljs-attr"},'"icon"'),s("span",{class:"hljs-punctuation"},":"),e(),s("span",{class:"hljs-string"},'"verified_user"'),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"},'"admin_access"'),s("span",{class:"hljs-punctuation"},":"),e(),s("span",{class:"hljs-literal"},[s("span",{class:"hljs-keyword"},"false")]),s("span",{class:"hljs-punctuation"},","),e(`
+	`),s("span",{class:"hljs-attr"},'"app_access"'),s("span",{class:"hljs-punctuation"},":"),e(),s("span",{class:"hljs-literal"},[s("span",{class:"hljs-keyword"},"true")]),e(`
+`),s("span",{class:"hljs-punctuation"},"}"),e(`
+`)])],-1),ps=s("h3",{id:"graphql-2",tabindex:"-1"},[s("a",{class:"header-anchor",href:"#graphql-2"},"#"),e(" GraphQL")],-1),us=s("pre",null,[s("code",null,`POST /graphql/system
+`)],-1),_s=s("pre",null,[s("code",{class:"language-graphql"},[s("span",{class:"hljs-keyword"},"type"),s("span",{class:"hljs-type"}," Mutation"),e(` {
+	create_roles_item(data: create_directus_roles_input!): directus_roles
+}
+`)])],-1),js=s("h5",{id:"example-4",tabindex:"-1"},[s("a",{class:"header-anchor",href:"#example-4"},"#"),e(" Example")],-1),ms=s("pre",null,[s("code",{class:"language-graphql"},[s("span",{class:"hljs-keyword"},"mutation"),e(` {
+	create_roles_item(
+		data: { name: `),s("span",{class:"hljs-string"},'"Interns"'),e(", icon: "),s("span",{class:"hljs-string"},'"verified_user"'),e(", description: "),s("span",{class:"hljs-literal"},"null"),e(", admin_access: "),s("span",{class:"hljs-literal"},"false"),e(", app_access: "),s("span",{class:"hljs-literal"},"true"),e(` }
+	) {
+		id
+		name
+		users {
+			email
+		}
+	}
+}
+`)])],-1),fs=s("hr",null,null,-1),bs=s("h2",{id:"create-multiple-roles",tabindex:"-1"},[s("a",{class:"header-anchor",href:"#create-multiple-roles"},"#"),e(" Create Multiple Roles")],-1),gs=s("p",null,"Create multiple new roles.",-1),ys=s("h3",{id:"query-parameters-3",tabindex:"-1"},[s("a",{class:"header-anchor",href:"#query-parameters-3"},"#"),e(" Query Parameters")],-1),xs=s("h3",{id:"request-body-1",tabindex:"-1"},[s("a",{class:"header-anchor",href:"#request-body-1"},"#"),e(" Request Body")],-1),qs=s("p",null,[e("An array of partial "),s("a",{href:"#the-role-object"},"role objects"),e(".")],-1),Rs=s("h3",{id:"returns-3",tabindex:"-1"},[s("a",{class:"header-anchor",href:"#returns-3"},"#"),e(" Returns")],-1),Es=s("p",null,[e("Returns the "),s("a",{href:"#the-role-object"},"role objects"),e(" for the created roles.")],-1),ks=s("h3",{id:"rest-api-3",tabindex:"-1"},[s("a",{class:"header-anchor",href:"#rest-api-3"},"#"),e(" REST API")],-1),ws=s("pre",null,[s("code",null,`POST /roles
+`)],-1),Ts=s("h5",{id:"example-5",tabindex:"-1"},[s("a",{class:"header-anchor",href:"#example-5"},"#"),e(" Example")],-1),Ps=s("pre",null,[s("code",{class:"language-json"},[s("span",{class:"hljs-comment"},"// POST /roles"),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"},'"Interns"'),s("span",{class:"hljs-punctuation"},","),e(`
+		`),s("span",{class:"hljs-attr"},'"icon"'),s("span",{class:"hljs-punctuation"},":"),e(),s("span",{class:"hljs-string"},'"verified_user"'),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"},'"admin_access"'),s("span",{class:"hljs-punctuation"},":"),e(),s("span",{class:"hljs-literal"},[s("span",{class:"hljs-keyword"},"false")]),s("span",{class:"hljs-punctuation"},","),e(`
+		`),s("span",{class:"hljs-attr"},'"app_access"'),s("span",{class:"hljs-punctuation"},":"),e(),s("span",{class:"hljs-literal"},[s("span",{class:"hljs-keyword"},"true")]),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"},'"Customers"'),s("span",{class:"hljs-punctuation"},","),e(`
+		`),s("span",{class:"hljs-attr"},'"icon"'),s("span",{class:"hljs-punctuation"},":"),e(),s("span",{class:"hljs-string"},'"person"'),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"},'"admin_access"'),s("span",{class:"hljs-punctuation"},":"),e(),s("span",{class:"hljs-literal"},[s("span",{class:"hljs-keyword"},"false")]),s("span",{class:"hljs-punctuation"},","),e(`
+		`),s("span",{class:"hljs-attr"},'"app_access"'),s("span",{class:"hljs-punctuation"},":"),e(),s("span",{class:"hljs-literal"},[s("span",{class:"hljs-keyword"},"false")]),e(`
+	`),s("span",{class:"hljs-punctuation"},"}"),e(`
+`),s("span",{class:"hljs-punctuation"},"]"),e(`
+`)])],-1),As=s("h3",{id:"graphql-3",tabindex:"-1"},[s("a",{class:"header-anchor",href:"#graphql-3"},"#"),e(" GraphQL")],-1),Ss=s("pre",null,[s("code",null,`POST /graphql/system
+`)],-1),Is=s("pre",null,[s("code",{class:"language-graphql"},[s("span",{class:"hljs-keyword"},"type"),s("span",{class:"hljs-type"}," Mutation"),e(` {
+	create_roles_items(data: [create_directus_roles_input!]!): [directus_roles]
+}
+`)])],-1),Ds=s("h5",{id:"example-6",tabindex:"-1"},[s("a",{class:"header-anchor",href:"#example-6"},"#"),e(" Example")],-1),Ls=s("pre",null,[s("code",{class:"language-graphql"},[s("span",{class:"hljs-keyword"},"mutation"),e(` {
+	create_roles_items(
+		data: [
+			{ name: `),s("span",{class:"hljs-string"},'"Interns"'),e(", icon: "),s("span",{class:"hljs-string"},'"verified_user"'),e(", description: "),s("span",{class:"hljs-literal"},"null"),e(", admin_access: "),s("span",{class:"hljs-literal"},"false"),e(", app_access: "),s("span",{class:"hljs-literal"},"true"),e(` }
+			{ name: `),s("span",{class:"hljs-string"},'"Customers"'),e(", icon: "),s("span",{class:"hljs-string"},'"person"'),e(", description: "),s("span",{class:"hljs-literal"},"null"),e(", admin_access: "),s("span",{class:"hljs-literal"},"false"),e(", app_access: "),s("span",{class:"hljs-literal"},"false"),e(` }
+		]
+	) {
+		id
+		name
+		users {
+			email
+		}
+	}
+}
+`)])],-1),Qs=s("hr",null,null,-1),Cs=s("h2",{id:"update-a-role",tabindex:"-1"},[s("a",{class:"header-anchor",href:"#update-a-role"},"#"),e(" Update a Role")],-1),vs=s("p",null,"Update an existing role.",-1),Os=s("h3",{id:"query-parameters-4",tabindex:"-1"},[s("a",{class:"header-anchor",href:"#query-parameters-4"},"#"),e(" Query Parameters")],-1),Gs=s("h3",{id:"request-body-2",tabindex:"-1"},[s("a",{class:"header-anchor",href:"#request-body-2"},"#"),e(" Request Body")],-1),Ms=s("p",null,[e("A partial "),s("a",{href:"#the-role-object"},"role object"),e(".")],-1),Bs=s("h3",{id:"returns-4",tabindex:"-1"},[s("a",{class:"header-anchor",href:"#returns-4"},"#"),e(" Returns")],-1),Hs=s("p",null,[e("Returns the "),s("a",{href:"#the-role-object"},"role object"),e(" for the updated role.")],-1),Us=s("h3",{id:"rest-api-4",tabindex:"-1"},[s("a",{class:"header-anchor",href:"#rest-api-4"},"#"),e(" REST API")],-1),Ns=s("pre",null,[s("code",null,`PATCH /roles/:id
+`)],-1),Vs=s("h5",{id:"example-7",tabindex:"-1"},[s("a",{class:"header-anchor",href:"#example-7"},"#"),e(" Example")],-1),Ws=s("pre",null,[s("code",{class:"language-json"},[s("span",{class:"hljs-comment"},"// PATCH /roles/c86c2761-65d3-43c3-897f-6f74ad6a5bd7"),e(`
+
+`),s("span",{class:"hljs-punctuation"},"{"),e(`
+	`),s("span",{class:"hljs-attr"},'"icon"'),s("span",{class:"hljs-punctuation"},":"),e(),s("span",{class:"hljs-string"},'"attractions"'),e(`
+`),s("span",{class:"hljs-punctuation"},"}"),e(`
+`)])],-1),zs=s("h3",{id:"graphql-4",tabindex:"-1"},[s("a",{class:"header-anchor",href:"#graphql-4"},"#"),e(" GraphQL")],-1),Fs=s("pre",null,[s("code",null,`POST /graphql/system
+`)],-1),Js=s("pre",null,[s("code",{class:"language-graphql"},[s("span",{class:"hljs-keyword"},"type"),s("span",{class:"hljs-type"}," Mutation"),e(` {
+	update_roles_item(id:`),s("span",{class:"hljs-literal"}," ID"),e(`!, data: update_directus_roles_input): directus_roles
+}
+`)])],-1),Ks=s("h5",{id:"example-8",tabindex:"-1"},[s("a",{class:"header-anchor",href:"#example-8"},"#"),e(" Example")],-1),Xs=s("pre",null,[s("code",{class:"language-graphql"},[s("span",{class:"hljs-keyword"},"mutation"),e(` {
+	update_roles_item(id: `),s("span",{class:"hljs-string"},'"c86c2761-65d3-43c3-897f-6f74ad6a5bd7"'),e(", data: { icon: "),s("span",{class:"hljs-string"},'"attractions"'),e(` }) {
+		id
+		name
+		users {
+			email
+		}
+	}
+}
+`)])],-1),Ys=s("hr",null,null,-1),Zs=s("h2",{id:"update-multiple-roles",tabindex:"-1"},[s("a",{class:"header-anchor",href:"#update-multiple-roles"},"#"),e(" Update Multiple Roles")],-1),$s=s("p",null,"Update multiple existing roles.",-1),se=s("h3",{id:"query-parameters-5",tabindex:"-1"},[s("a",{class:"header-anchor",href:"#query-parameters-5"},"#"),e(" Query Parameters")],-1),ee=s("h3",{id:"request-body-3",tabindex:"-1"},[s("a",{class:"header-anchor",href:"#request-body-3"},"#"),e(" Request Body")],-1),ae=s("p",null,[s("code",null,"keys"),e(),s("strong",null,"Required"),s("br"),e(" Array of primary keys of the roles you\u2019d like to update.")],-1),te=s("p",null,[s("code",null,"data"),e(),s("strong",null,"Required"),s("br"),e(" Any of "),s("a",{href:"#the-role-object"},"the role object"),e("\u2019s properties.")],-1),ne=s("h3",{id:"returns-5",tabindex:"-1"},[s("a",{class:"header-anchor",href:"#returns-5"},"#"),e(" Returns")],-1),le=s("p",null,[e("Returns the "),s("a",{href:"#the-role-object"},"role objects"),e(" for the updated roles.")],-1),re=s("h3",{id:"rest-api-5",tabindex:"-1"},[s("a",{class:"header-anchor",href:"#rest-api-5"},"#"),e(" REST API")],-1),oe=s("pre",null,[s("code",null,`PATCH /roles
+`)],-1),ce=s("h5",{id:"example-9",tabindex:"-1"},[s("a",{class:"header-anchor",href:"#example-9"},"#"),e(" Example")],-1),he=s("pre",null,[s("code",{class:"language-json"},[s("span",{class:"hljs-comment"},"// PATCH /roles"),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"},'"c86c2761-65d3-43c3-897f-6f74ad6a5bd7"'),s("span",{class:"hljs-punctuation"},","),e(),s("span",{class:"hljs-string"},'"6fc3d5d3-a37b-4da8-a2f4-ed62ad5abe03"'),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"},'"icon"'),s("span",{class:"hljs-punctuation"},":"),e(),s("span",{class:"hljs-string"},'"attractions"'),e(`
+	`),s("span",{class:"hljs-punctuation"},"}"),e(`
+`),s("span",{class:"hljs-punctuation"},"}"),e(`
+`)])],-1),ie=s("h3",{id:"graphql-5",tabindex:"-1"},[s("a",{class:"header-anchor",href:"#graphql-5"},"#"),e(" GraphQL")],-1),de=s("pre",null,[s("code",null,`POST /graphql/system
+`)],-1),pe=s("pre",null,[s("code",{class:"language-graphql"},[s("span",{class:"hljs-keyword"},"type"),s("span",{class:"hljs-type"}," Mutation"),e(` {
+	update_roles_items(ids: `),s("span",{class:"hljs-literal"},"[ID"),e(`!]!, data: update_directus_roles_input): [directus_roles]
+}
+`)])],-1),ue=s("h5",{id:"example-10",tabindex:"-1"},[s("a",{class:"header-anchor",href:"#example-10"},"#"),e(" Example")],-1),_e=s("pre",null,[s("code",{class:"language-graphql"},[s("span",{class:"hljs-keyword"},"mutation"),e(` {
+	update_roles_items(
+		ids: [`),s("span",{class:"hljs-string"},'"c86c2761-65d3-43c3-897f-6f74ad6a5bd7"'),e(", "),s("span",{class:"hljs-string"},'"6fc3d5d3-a37b-4da8-a2f4-ed62ad5abe03"'),e(`]
+		data: { icon: `),s("span",{class:"hljs-string"},'"attractions"'),e(` }
+	) {
+		id
+		name
+		users {
+			email
+		}
+	}
+}
+`)])],-1),je=s("hr",null,null,-1),me=s("h2",{id:"delete-a-role",tabindex:"-1"},[s("a",{class:"header-anchor",href:"#delete-a-role"},"#"),e(" Delete a Role")],-1),fe=s("p",null,"Delete an existing role.",-1),be=s("h3",{id:"returns-6",tabindex:"-1"},[s("a",{class:"header-anchor",href:"#returns-6"},"#"),e(" Returns")],-1),ge=s("p",null,"Empty body.",-1),ye=s("h3",{id:"rest-api-6",tabindex:"-1"},[s("a",{class:"header-anchor",href:"#rest-api-6"},"#"),e(" REST API")],-1),xe=s("pre",null,[s("code",null,`DELETE /roles/:id
+`)],-1),qe=s("h5",{id:"example-11",tabindex:"-1"},[s("a",{class:"header-anchor",href:"#example-11"},"#"),e(" Example")],-1),Re=s("pre",null,[s("code",null,`DELETE /roles/c86c2761-65d3-43c3-897f-6f74ad6a5bd7
+`)],-1),Ee=s("h3",{id:"graphql-6",tabindex:"-1"},[s("a",{class:"header-anchor",href:"#graphql-6"},"#"),e(" GraphQL")],-1),ke=s("pre",null,[s("code",null,`POST /graphql/system
+`)],-1),we=s("pre",null,[s("code",{class:"language-graphql"},[s("span",{class:"hljs-keyword"},"type"),s("span",{class:"hljs-type"}," Mutation"),e(` {
+	delete_roles_item(id:`),s("span",{class:"hljs-literal"}," ID"),e(`!): delete_one
+}
+`)])],-1),Te=s("h5",{id:"example-12",tabindex:"-1"},[s("a",{class:"header-anchor",href:"#example-12"},"#"),e(" Example")],-1),Pe=s("pre",null,[s("code",{class:"language-graphql"},[s("span",{class:"hljs-keyword"},"mutation"),e(` {
+	delete_roles_item(id: `),s("span",{class:"hljs-string"},'"c86c2761-65d3-43c3-897f-6f74ad6a5bd7"'),e(`) {
+		id
+	}
+}
+`)])],-1),Ae=s("hr",null,null,-1),Se=s("h2",{id:"delete-multiple-roles",tabindex:"-1"},[s("a",{class:"header-anchor",href:"#delete-multiple-roles"},"#"),e(" Delete Multiple Roles")],-1),Ie=s("p",null,"Delete multiple existing roles.",-1),De=s("h3",{id:"request-body-4",tabindex:"-1"},[s("a",{class:"header-anchor",href:"#request-body-4"},"#"),e(" Request Body")],-1),Le=s("p",null,"An array of role primary keys",-1),Qe=s("h3",{id:"returns-7",tabindex:"-1"},[s("a",{class:"header-anchor",href:"#returns-7"},"#"),e(" Returns")],-1),Ce=s("p",null,"Empty body.",-1),ve=s("h3",{id:"rest-api-7",tabindex:"-1"},[s("a",{class:"header-anchor",href:"#rest-api-7"},"#"),e(" REST API")],-1),Oe=s("pre",null,[s("code",null,`DELETE /roles
+`)],-1),Ge=s("h5",{id:"example-13",tabindex:"-1"},[s("a",{class:"header-anchor",href:"#example-13"},"#"),e(" Example")],-1),Me=s("pre",null,[s("code",{class:"language-json"},[s("span",{class:"hljs-comment"},"// DELETE /roles"),e(`
+`),s("span",{class:"hljs-punctuation"},"["),s("span",{class:"hljs-string"},'"653925a9-970e-487a-bfc0-ab6c96affcdc"'),s("span",{class:"hljs-punctuation"},","),e(),s("span",{class:"hljs-string"},'"c86c2761-65d3-43c3-897f-6f74ad6a5bd7"'),s("span",{class:"hljs-punctuation"},"]"),e(`
+`)])],-1),Be=s("h3",{id:"graphql-7",tabindex:"-1"},[s("a",{class:"header-anchor",href:"#graphql-7"},"#"),e(" GraphQL")],-1),He=s("pre",null,[s("code",null,`POST /graphql/system
+`)],-1),Ue=s("pre",null,[s("code",{class:"language-graphql"},[s("span",{class:"hljs-keyword"},"type"),s("span",{class:"hljs-type"}," Mutation"),e(` {
+	delete_roles_items(ids: `),s("span",{class:"hljs-literal"},"[ID"),e(`!]!): delete_many
+}
+`)])],-1),Ne=s("h5",{id:"example-14",tabindex:"-1"},[s("a",{class:"header-anchor",href:"#example-14"},"#"),e(" Example")],-1),Ve=s("pre",null,[s("code",{class:"language-graphql"},[s("span",{class:"hljs-keyword"},"mutation"),e(` {
+	delete_roles_items(ids: [`),s("span",{class:"hljs-string"},'"653925a9-970e-487a-bfc0-ab6c96affcdc"'),e(", "),s("span",{class:"hljs-string"},'"c86c2761-65d3-43c3-897f-6f74ad6a5bd7"'),e(`]) {
+		ids
+	}
+}
+`)])],-1),We=s("hr",null,null,-1),Xe="Roles",Ye=!1,Ze="REST and GraphQL API documentation on the Roles collection in Directus.",$e="5 min read",sa="page-reference",ea={__name:"roles",setup(ze,{expose:o}){const l={title:"Roles",modularExtension:!1,description:"REST and GraphQL API documentation on the Roles collection in Directus.",readTime:"5 min read",pageClass:"page-reference"};return o({frontmatter:l}),(Fe,Je)=>{const t=r("router-link"),c=r("docs-wrapper");return h(),i(c,{frontmatter:l},{default:a(()=>[s("div",d,[s("blockquote",null,[s("p",null,[e("Roles define a specific set of access permissions, and are the primary organizational structure for Users within the platform. "),n(t,{to:"/docs/getting-started/glossary#roles"},{default:a(()=>[e("Learn more about Roles")]),_:1}),e(".")])]),p,u,_,j,m,f,b,g,y,x,s("p",null,[q,e(),R,E,e(" The users in this role. One-to-many to "),n(t,{to:"/docs/reference/system/users"},{default:a(()=>[e("users")]),_:1}),e(".")]),k,w,T,P,A,s("p",null,[e("Supports all "),n(t,{to:"/docs/reference/query"},{default:a(()=>[e("global query parameters")]),_:1}),e(".")]),S,s("p",null,[e("An array of up to "),n(t,{to:"/docs/reference/query#limit"},{default:a(()=>[e("limit")]),_:1}),e(),I,e(". If no items are available, data will be an empty array.")]),D,L,s("p",null,[n(t,{to:"/docs/reference/introduction#search-http-method"},{default:a(()=>[e("Learn more about SEARCH ->")]),_:1})]),Q,C,v,O,G,M,B,H,U,s("p",null,[e("Supports all "),n(t,{to:"/docs/reference/query"},{default:a(()=>[e("global query parameters")]),_:1}),e(".")]),N,V,W,z,F,J,K,X,Y,Z,$,ss,es,as,ts,s("p",null,[e("Supports all "),n(t,{to:"/docs/reference/query"},{default:a(()=>[e("global query parameters")]),_:1}),e(".")]),ns,ls,rs,os,cs,hs,is,ds,ps,us,_s,js,ms,fs,bs,gs,ys,s("p",null,[e("Supports all "),n(t,{to:"/docs/reference/query"},{default:a(()=>[e("global query parameters")]),_:1}),e(".")]),xs,qs,Rs,Es,ks,ws,Ts,Ps,As,Ss,Is,Ds,Ls,Qs,Cs,vs,Os,s("p",null,[e("Supports all "),n(t,{to:"/docs/reference/query"},{default:a(()=>[e("global query parameters")]),_:1}),e(".")]),Gs,Ms,Bs,Hs,Us,Ns,Vs,Ws,zs,Fs,Js,Ks,Xs,Ys,Zs,$s,se,s("p",null,[e("Supports all "),n(t,{to:"/docs/reference/query"},{default:a(()=>[e("global query parameters")]),_:1}),e(".")]),ee,ae,te,ne,le,re,oe,ce,he,ie,de,pe,ue,_e,je,me,fe,be,ge,ye,xe,qe,Re,Ee,ke,we,Te,Pe,Ae,Se,Ie,De,Le,Qe,Ce,ve,Oe,Ge,Me,Be,He,Ue,Ne,Ve,We])]),_:1})}}};export{ea as default,Ze as description,Ye as modularExtension,sa as pageClass,$e as readTime,Xe as title};

package/dist/assets/rpm.d6838f23.js

@@ -0,0 +1 @@
+import{y as d}from"./index.31f94193.entry.js";function s(a,f){for(var e=0;e<f.length;e++){const n=f[e];if(typeof n!="string"&&!Array.isArray(n)){for(const t in n)if(t!=="default"&&!(t in a)){const c=Object.getOwnPropertyDescriptor(n,t);c&&Object.defineProperty(a,t,c.get?c:{enumerable:!0,get:()=>n[t]})}}}return Object.freeze(Object.defineProperty(a,Symbol.toStringTag,{value:"Module"}))}var p={exports:{}};(function(a,f){(function(e){e(d.exports)})(function(e){e.defineMode("rpm-changes",function(){var n=/^-+$/,t=/^(Mon|Tue|Wed|Thu|Fri|Sat|Sun) (Jan|Feb|Mar|Apr|May|Jun|Jul|Aug|Sep|Oct|Nov|Dec)  ?\d{1,2} \d{2}:\d{2}(:\d{2})? [A-Z]{3,4} \d{4} - /,c=/^[\w+.-]+@[\w.-]+/;return{token:function(i){return i.sol()&&(i.match(n)||i.match(t))?"tag":i.match(c)?"string":(i.next(),null)}}}),e.defineMIME("text/x-rpm-changes","rpm-changes"),e.defineMode("rpm-spec",function(){var n=/^(i386|i586|i686|x86_64|ppc64le|ppc64|ppc|ia64|s390x|s390|sparc64|sparcv9|sparc|noarch|alphaev6|alpha|hppa|mipsel)/,t=/^[a-zA-Z0-9()]+:/,c=/^%(debug_package|package|description|prep|build|install|files|clean|changelog|preinstall|preun|postinstall|postun|pretrans|posttrans|pre|post|triggerin|triggerun|verifyscript|check|triggerpostun|triggerprein|trigger)/,i=/^%(ifnarch|ifarch|if)/,l=/^%(else|endif)/,u=/^(\!|\?|\<\=|\<|\>\=|\>|\=\=|\&\&|\|\|)/;return{startState:function(){return{controlFlow:!1,macroParameters:!1,section:!1}},token:function(r,o){var h=r.peek();if(h=="#")return r.skipToEnd(),"comment";if(r.sol()){if(r.match(t))return"header";if(r.match(c))return"atom"}if(r.match(/^\$\w+/)||r.match(/^\$\{\w+\}/))return"def";if(r.match(l))return"keyword";if(r.match(i))return o.controlFlow=!0,"keyword";if(o.controlFlow){if(r.match(u))return"operator";if(r.match(/^(\d+)/))return"number";r.eol()&&(o.controlFlow=!1)}if(r.match(n))return r.eol()&&(o.controlFlow=!1),"number";if(r.match(/^%[\w]+/))return r.match("(")&&(o.macroParameters=!0),"keyword";if(o.macroParameters){if(r.match(/^\d+/))return"number";if(r.match(")"))return o.macroParameters=!1,"keyword"}return r.match(/^%\{\??[\w \-\:\!]+\}/)?(r.eol()&&(o.controlFlow=!1),"def"):(r.next(),null)}}}),e.defineMIME("text/x-rpm-spec","rpm-spec")})})();const g=p.exports,w=s({__proto__:null,default:g},[p.exports]);export{w as r};

package/dist/assets/rst.84696a6a.js

@@ -0,0 +1 @@
+import{y as ie}from"./index.31f94193.entry.js";import{a as oe}from"./python.8be69c13.js";import{r as ae}from"./stex.89b6b9d8.js";import{r as le}from"./overlay.0c3756d2.js";function fe(s,P){for(var f=0;f<P.length;f++){const t=P[f];if(typeof t!="string"&&!Array.isArray(t)){for(const o in t)if(o!=="default"&&!(o in s)){const p=Object.getOwnPropertyDescriptor(t,o);p&&Object.defineProperty(s,o,p.get?p:{enumerable:!0,get:()=>t[o]})}}}return Object.freeze(Object.defineProperty(s,Symbol.toStringTag,{value:"Module"}))}var M={exports:{}};(function(s,P){(function(f){f(ie.exports,oe.exports,ae(),le())})(function(f){f.defineMode("rst",function(t,o){var p=/^\*\*[^\*\s](?:[^\*]*[^\*\s])?\*\*/,b=/^\*[^\*\s](?:[^\*]*[^\*\s])?\*/,w=/^``[^`\s](?:[^`]*[^`\s])``/,u=/^(?:[\d]+(?:[\.,]\d+)*)/,E=/^(?:\s\+[\d]+(?:[\.,]\d+)*)/,k=/^(?:\s\-[\d]+(?:[\.,]\d+)*)/,T="[Hh][Tt][Tt][Pp][Ss]?://",j="(?:[\\d\\w.-]+)\\.(?:\\w{2,6})",x="(?:/[\\d\\w\\#\\%\\&\\-\\.\\,\\/\\:\\=\\?\\~]+)*",y=new RegExp("^"+T+j+x),R={token:function(l){if(l.match(p)&&l.match(/\W+|$/,!1))return"strong";if(l.match(b)&&l.match(/\W+|$/,!1))return"em";if(l.match(w)&&l.match(/\W+|$/,!1))return"string-2";if(l.match(u))return"number";if(l.match(E))return"positive";if(l.match(k))return"negative";if(l.match(y))return"link";for(;l.next()!=null&&!(l.match(p,!1)||l.match(b,!1)||l.match(w,!1)||l.match(u,!1)||l.match(E,!1)||l.match(k,!1)||l.match(y,!1)););return null}},W=f.getMode(t,o.backdrop||"rst-base");return f.overlayMode(W,R,!0)},"python","stex"),f.defineMode("rst-base",function(t){function o(n){var e=Array.prototype.slice.call(arguments,1);return n.replace(/{(\d+)}/g,function(r,N){return typeof e[N]<"u"?e[N]:r})}var p=f.getMode(t,"python"),b=f.getMode(t,"stex"),w="\\s+",u="(?:\\s*|\\W|$)",E=new RegExp(o("^{0}",u)),k=`(?:[^\\W\\d_](?:[\\w!"#$%&'()\\*\\+,\\-\\./:;<=>\\?]*[^\\W_])?)`,T=new RegExp(o("^{0}",k)),j=`(?:[^\\W\\d_](?:[\\w\\s!"#$%&'()\\*\\+,\\-\\./:;<=>\\?]*[^\\W_])?)`,x=o("(?:{0}|`{1}`)",k,j),y="(?:[^\\s\\|](?:[^\\|]*[^\\s\\|])?)",R="(?:[^\\`]+)",W=new RegExp(o("^{0}",R)),l=new RegExp("^([!'#$%&\"()*+,-./:;<=>?@\\[\\\\\\]^_`{|}~])\\1{3,}\\s*$"),z=new RegExp(o("^\\.\\.{0}",w)),q=new RegExp(o("^_{0}:{1}|^__:{1}",x,u)),A=new RegExp(o("^{0}::{1}",x,u)),S=new RegExp(o("^\\|{0}\\|{1}{2}::{3}",y,w,x,u)),D=new RegExp(o("^\\[(?:\\d+|#{0}?|\\*)]{1}",x,u)),F=new RegExp(o("^\\[{0}\\]{1}",x,u)),O=new RegExp(o("^\\|{0}\\|",y)),H=new RegExp(o("^\\[(?:\\d+|#{0}?|\\*)]_",x)),B=new RegExp(o("^\\[{0}\\]_",x)),G=new RegExp(o("^{0}__?",x)),g=new RegExp(o("^`{0}`_",R)),_=new RegExp(o("^:{0}:`{1}`{2}",k,R,u)),m=new RegExp(o("^`{1}`:{0}:{2}",k,R,u)),$=new RegExp(o("^:{0}:{1}",k,u)),J=new RegExp(o("^{0}",x)),K=new RegExp(o("^::{0}",u)),X=new RegExp(o("^\\|{0}\\|",y)),Q=new RegExp(o("^{0}",w)),U=new RegExp(o("^{0}",x)),V=new RegExp(o("^::{0}",u)),Y=new RegExp("^_"),Z=new RegExp(o("^{0}|_",x)),C=new RegExp(o("^:{0}",u)),ee=new RegExp("^::\\s*$"),ne=new RegExp("^\\s+(?:>>>|In \\[\\d+\\]:)\\s");function i(n,e){var r=null;if(n.sol()&&n.match(ne,!1))c(e,I,{mode:p,local:f.startState(p)});else if(n.sol()&&n.match(z))c(e,h),r="meta";else if(n.sol()&&n.match(l))c(e,i),r="header";else if(v(e)==_||n.match(_,!1))switch(d(e)){case 0:c(e,i,a(_,1)),n.match(/^:/),r="meta";break;case 1:c(e,i,a(_,2)),n.match(T),r="keyword",n.current().match(/^(?:math|latex)/)&&(e.tmp_stex=!0);break;case 2:c(e,i,a(_,3)),n.match(/^:`/),r="meta";break;case 3:if(e.tmp_stex&&(e.tmp_stex=void 0,e.tmp={mode:b,local:f.startState(b)}),e.tmp){if(n.peek()=="`"){c(e,i,a(_,4)),e.tmp=void 0;break}r=e.tmp.mode.token(n,e.tmp.local);break}c(e,i,a(_,4)),n.match(W),r="string";break;case 4:c(e,i,a(_,5)),n.match(/^`/),r="meta";break;case 5:c(e,i,a(_,6)),n.match(E);break;default:c(e,i)}else if(v(e)==m||n.match(m,!1))switch(d(e)){case 0:c(e,i,a(m,1)),n.match(/^`/),r="meta";break;case 1:c(e,i,a(m,2)),n.match(W),r="string";break;case 2:c(e,i,a(m,3)),n.match(/^`:/),r="meta";break;case 3:c(e,i,a(m,4)),n.match(T),r="keyword";break;case 4:c(e,i,a(m,5)),n.match(/^:/),r="meta";break;case 5:c(e,i,a(m,6)),n.match(E);break;default:c(e,i)}else if(v(e)==$||n.match($,!1))switch(d(e)){case 0:c(e,i,a($,1)),n.match(/^:/),r="meta";break;case 1:c(e,i,a($,2)),n.match(T),r="keyword";break;case 2:c(e,i,a($,3)),n.match(/^:/),r="meta";break;case 3:c(e,i,a($,4)),n.match(E);break;default:c(e,i)}else if(v(e)==O||n.match(O,!1))switch(d(e)){case 0:c(e,i,a(O,1)),n.match(X),r="variable-2";break;case 1:c(e,i,a(O,2)),n.match(/^_?_?/)&&(r="link");break;default:c(e,i)}else if(n.match(H))c(e,i),r="quote";else if(n.match(B))c(e,i),r="quote";else if(n.match(G))c(e,i),(!n.peek()||n.peek().match(/^\W$/))&&(r="link");else if(v(e)==g||n.match(g,!1))switch(d(e)){case 0:!n.peek()||n.peek().match(/^\W$/)?c(e,i,a(g,1)):n.match(g);break;case 1:c(e,i,a(g,2)),n.match(/^`/),r="link";break;case 2:c(e,i,a(g,3)),n.match(W);break;case 3:c(e,i,a(g,4)),n.match(/^`_/),r="link";break;default:c(e,i)}else n.match(ee)?c(e,re):n.next()&&c(e,i);return r}function h(n,e){var r=null;if(v(e)==S||n.match(S,!1))switch(d(e)){case 0:c(e,h,a(S,1)),n.match(X),r="variable-2";break;case 1:c(e,h,a(S,2)),n.match(Q);break;case 2:c(e,h,a(S,3)),n.match(U),r="keyword";break;case 3:c(e,h,a(S,4)),n.match(V),r="meta";break;default:c(e,i)}else if(v(e)==A||n.match(A,!1))switch(d(e)){case 0:c(e,h,a(A,1)),n.match(J),r="keyword",n.current().match(/^(?:math|latex)/)?e.tmp_stex=!0:n.current().match(/^python/)&&(e.tmp_py=!0);break;case 1:c(e,h,a(A,2)),n.match(K),r="meta",(n.match(/^latex\s*$/)||e.tmp_stex)&&(e.tmp_stex=void 0,c(e,I,{mode:b,local:f.startState(b)}));break;case 2:c(e,h,a(A,3)),(n.match(/^python\s*$/)||e.tmp_py)&&(e.tmp_py=void 0,c(e,I,{mode:p,local:f.startState(p)}));break;default:c(e,i)}else if(v(e)==q||n.match(q,!1))switch(d(e)){case 0:c(e,h,a(q,1)),n.match(Y),n.match(Z),r="link";break;case 1:c(e,h,a(q,2)),n.match(C),r="meta";break;default:c(e,i)}else n.match(D)||n.match(F)?(c(e,i),r="quote"):(n.eatSpace(),n.eol()?c(e,i):(n.skipToEnd(),c(e,ce),r="comment"));return r}function ce(n,e){return L(n,e,"comment")}function re(n,e){return L(n,e,"meta")}function L(n,e,r){return n.eol()||n.eatSpace()?(n.skipToEnd(),r):(c(e,i),null)}function I(n,e){return e.ctx.mode&&e.ctx.local?n.sol()?(n.eatSpace()||c(e,i),null):e.ctx.mode.token(n,e.ctx.local):(c(e,i),null)}function a(n,e,r,N){return{phase:n,stage:e,mode:r,local:N}}function c(n,e,r){n.tok=e,n.ctx=r||{}}function d(n){return n.ctx.stage||0}function v(n){return n.ctx.phase}return{startState:function(){return{tok:i,ctx:a(void 0,0)}},copyState:function(n){var e=n.ctx,r=n.tmp;return e.local&&(e={mode:e.mode,local:f.copyState(e.mode,e.local)}),r&&(r={mode:r.mode,local:f.copyState(r.mode,r.local)}),{tok:n.tok,ctx:e,tmp:r}},innerMode:function(n){return n.tmp?{state:n.tmp.local,mode:n.tmp.mode}:n.ctx.mode?{state:n.ctx.local,mode:n.ctx.mode}:null},token:function(n,e){return e.tok(n,e)}}},"python","stex"),f.defineMIME("text/x-rst","rst")})})();const ue=M.exports,_e=fe({__proto__:null,default:ue},[M.exports]);export{_e as r};