Container¶
-
GET
/
(db)/
(container)¶ Retrieves serialization of resource
- Permission: guillotina.ViewContent
- Context: guillotina.interfaces.content.IResource
GET /db/container HTTP/1.1 Accept: application/json Authorization: Basic cm9vdDpyb290
curl -i http://nohost/db/container -H 'Accept: application/json' --user root:root
http http://nohost/db/container Accept:application/json -a root:root
HTTP/1.1 200 OK Content-Length: 512 Content-Type: application/json { "@id": "http://127.0.0.1:56609/db/container", "@type": "Container", "@name": "container", "@uid": "94fdd84ea52a4e49afca09073ec7f0a9", "@static_behaviors": [], "parent": {}, "is_folderish": true, "creation_date": "2019-08-24T12:41:21.224751+00:00", "modification_date": "2019-08-24T12:41:21.224751+00:00", "UID": "94fdd84ea52a4e49afca09073ec7f0a9", "type_name": "Container", "title": "container", "uuid": "94fdd84ea52a4e49afca09073ec7f0a9", "__behaviors__": [], "__name__": "container", "items": [], "length": 0 }
Query Parameters: - include (string) –
- omit (string) –
Status Codes: - 200 OK – Resource data
- 401 Unauthorized – You are not authorized to perform the operation
- 404 Not Found – The resource does not exist
Types¶
-
GET
/
(db)/
(container)/@types
¶ Read information on available types
- Permission: guillotina.AccessContent
- Context: guillotina.interfaces.content.IContainer
GET /db/container/@types HTTP/1.1 Accept: application/json Authorization: Basic cm9vdDpyb290
curl -i http://nohost/db/container/@types -H 'Accept: application/json' --user root:root
http http://nohost/db/container/@types Accept:application/json -a root:root
HTTP/1.1 200 OK Content-Length: 6047 Content-Type: application/json [ { "title": "Item", "$schema": "http://json-schema.org/draft-04/schema#", "type": "object", "required": [ "type_name", "uuid" ], "definitions": { "guillotina.behaviors.dublincore.IDublinCore": { "type": "object", "properties": { "title": { "type": "string", "description": "The first unqualified Dublin Core 'Title' element value.", "title": "Title" }, "description": { "type": "string", "description": "The first unqualified Dublin Core 'Description' element value.", "title": "Description" }, "creation_date": { "type": "datetime", "description": "The date and time that an object is created. \nThis is normally set automatically.", "title": "Creation Date" }, "modification_date": { "type": "datetime", "description": "The date and time that the object was last modified in a\nmeaningful way.", "title": "Modification Date" }, "effective_date": { "type": "datetime", "description": "The date and time that an object should be published. ", "title": "Effective Date" }, "expiration_date": { "type": "datetime", "description": "The date and time that the object should become unpublished.", "title": "Expiration Date" }, "creators": { "type": "array", "description": "The unqualified Dublin Core 'Creator' element values", "title": "Creators", "items": { "type": "string" } }, "tags": { "type": "array", "description": "The unqualified Dublin Core 'Tags' element values", "title": "Tags", "items": { "type": "string" } }, "publisher": { "type": "string", "description": "The first unqualified Dublin Core 'Publisher' element value.", "title": "Publisher" }, "contributors": { "type": "array", "description": "The unqualified Dublin Core 'Contributor' element values", "title": "Contributors", "items": { "type": "string" } } }, "required": [], "invariants": [], "title": "Dublin Core fields", "description": "" } }, "properties": { "__name__": { "type": "string", "description": "The object can be looked up from the parent's sublocations using this name.", "readonly": true, "title": "The name within the parent" }, "type_name": { "type": "string", "readonly": true }, "title": { "type": "string", "description": "Title of the Resource", "title": "Title" }, "uuid": { "type": "string", "readonly": true, "title": "UUID" }, "modification_date": { "type": "datetime", "title": "Modification date" }, "creation_date": { "type": "datetime", "title": "Creation date" }, "__behaviors__": { "type": "array", "description": "Dynamic behaviors for the content type", "readonly": true, "title": "Enabled behaviors" }, "guillotina.behaviors.dublincore.IDublinCore": [ { "$ref": "#/definitions/guillotina.behaviors.dublincore.IDublinCore" } ] }, "invariants": [] }, { "title": "Folder", "$schema": "http://json-schema.org/draft-04/schema#", "type": "object", "required": [ "type_name", "uuid" ], "definitions": { "guillotina.behaviors.dublincore.IDublinCore": { "type": "object", "properties": { "title": { "type": "string", "description": "The first unqualified Dublin Core 'Title' element value.", "title": "Title" }, "description": { "type": "string", "description": "The first unqualified Dublin Core 'Description' element value.", "title": "Description" }, "creation_date": { "type": "datetime", "description": "The date and time that an object is created. \nThis is normally set automatically.", "title": "Creation Date" }, "modification_date": { "type": "datetime", "description": "The date and time that the object was last modified in a\nmeaningful way.", "title": "Modification Date" }, "effective_date": { "type": "datetime", "description": "The date and time that an object should be published. ", "title": "Effective Date" }, "expiration_date": { "type": "datetime", "description": "The date and time that the object should become unpublished.", "title": "Expiration Date" }, "creators": { "type": "array", "description": "The unqualified Dublin Core 'Creator' element values", "title": "Creators", "items": { "type": "string" } }, "tags": { "type": "array", "description": "The unqualified Dublin Core 'Tags' element values", "title": "Tags", "items": { "type": "string" } }, "publisher": { "type": "string", "description": "The first unqualified Dublin Core 'Publisher' element value.", "title": "Publisher" }, "contributors": { "type": "array", "description": "The unqualified Dublin Core 'Contributor' element values", "title": "Contributors", "items": { "type": "string" } } }, "required": [], "invariants": [], "title": "Dublin Core fields", "description": "" } }, "properties": { "__name__": { "type": "string", "description": "The object can be looked up from the parent's sublocations using this name.", "readonly": true, "title": "The name within the parent" }, "type_name": { "type": "string", "readonly": true }, "title": { "type": "string", "description": "Title of the Resource", "title": "Title" }, "uuid": { "type": "string", "readonly": true, "title": "UUID" }, "modification_date": { "type": "datetime", "title": "Modification date" }, "creation_date": { "type": "datetime", "title": "Creation date" }, "__behaviors__": { "type": "array", "description": "Dynamic behaviors for the content type", "readonly": true, "title": "Enabled behaviors" }, "guillotina.behaviors.dublincore.IDublinCore": [ { "$ref": "#/definitions/guillotina.behaviors.dublincore.IDublinCore" } ] }, "invariants": [] }, { "title": "Container", "$schema": "http://json-schema.org/draft-04/schema#", "type": "object", "required": [ "type_name", "uuid" ], "definitions": {}, "properties": { "__name__": { "type": "string", "description": "The object can be looked up from the parent's sublocations using this name.", "readonly": true, "title": "The name within the parent" }, "type_name": { "type": "string", "readonly": true }, "title": { "type": "string", "description": "Title of the Resource", "title": "Title" }, "uuid": { "type": "string", "readonly": true, "title": "UUID" }, "modification_date": { "type": "datetime", "title": "Modification date" }, "creation_date": { "type": "datetime", "title": "Creation date" }, "__behaviors__": { "type": "array", "description": "Dynamic behaviors for the content type", "readonly": true, "title": "Enabled behaviors" } }, "invariants": [] } ]
Status Codes: - 200 OK – Result results on types
- 401 Unauthorized – You are not authorized to perform the operation
- 404 Not Found – The resource does not exist
-
GET
/
(db)/
(container)/@types/
(type_name)¶ Read information on available types
- Permission: guillotina.AccessContent
- Context: guillotina.interfaces.content.IContainer
GET /db/container/@types/Item HTTP/1.1 Accept: application/json Authorization: Basic cm9vdDpyb290
curl -i http://nohost/db/container/@types/Item -H 'Accept: application/json' --user root:root
http http://nohost/db/container/@types/Item Accept:application/json -a root:root
HTTP/1.1 200 OK Content-Length: 2597 Content-Type: application/json { "title": "Item", "$schema": "http://json-schema.org/draft-04/schema#", "type": "object", "required": [ "type_name", "uuid" ], "definitions": { "guillotina.behaviors.dublincore.IDublinCore": { "type": "object", "properties": { "title": { "type": "string", "description": "The first unqualified Dublin Core 'Title' element value.", "title": "Title" }, "description": { "type": "string", "description": "The first unqualified Dublin Core 'Description' element value.", "title": "Description" }, "creation_date": { "type": "datetime", "description": "The date and time that an object is created. \nThis is normally set automatically.", "title": "Creation Date" }, "modification_date": { "type": "datetime", "description": "The date and time that the object was last modified in a\nmeaningful way.", "title": "Modification Date" }, "effective_date": { "type": "datetime", "description": "The date and time that an object should be published. ", "title": "Effective Date" }, "expiration_date": { "type": "datetime", "description": "The date and time that the object should become unpublished.", "title": "Expiration Date" }, "creators": { "type": "array", "description": "The unqualified Dublin Core 'Creator' element values", "title": "Creators", "items": { "type": "string" } }, "tags": { "type": "array", "description": "The unqualified Dublin Core 'Tags' element values", "title": "Tags", "items": { "type": "string" } }, "publisher": { "type": "string", "description": "The first unqualified Dublin Core 'Publisher' element value.", "title": "Publisher" }, "contributors": { "type": "array", "description": "The unqualified Dublin Core 'Contributor' element values", "title": "Contributors", "items": { "type": "string" } } }, "required": [], "invariants": [], "title": "Dublin Core fields", "description": "" } }, "properties": { "__name__": { "type": "string", "description": "The object can be looked up from the parent's sublocations using this name.", "readonly": true, "title": "The name within the parent" }, "type_name": { "type": "string", "readonly": true }, "title": { "type": "string", "description": "Title of the Resource", "title": "Title" }, "uuid": { "type": "string", "readonly": true, "title": "UUID" }, "modification_date": { "type": "datetime", "title": "Modification date" }, "creation_date": { "type": "datetime", "title": "Creation date" }, "__behaviors__": { "type": "array", "description": "Dynamic behaviors for the content type", "readonly": true, "title": "Enabled behaviors" }, "guillotina.behaviors.dublincore.IDublinCore": [ { "$ref": "#/definitions/guillotina.behaviors.dublincore.IDublinCore" } ] }, "invariants": [] }
Status Codes: - 200 OK – Result results on types
- 401 Unauthorized – You are not authorized to perform the operation
- 404 Not Found – The resource does not exist
User¶
-
GET
/
(db)/
(container)/@user
¶ Get information on the currently logged in user
- Permission: guillotina.AccessContent
- Context: guillotina.interfaces.content.IContainer
GET /db/container/@user HTTP/1.1 Accept: application/json Authorization: Basic cm9vdDpyb290
curl -i http://nohost/db/container/@user -H 'Accept: application/json' --user root:root
http http://nohost/db/container/@user Accept:application/json -a root:root
HTTP/1.1 200 OK Content-Length: 302 Content-Type: application/json { "root": { "roles": { "guillotina.Authenticated": 1 }, "groups": [ "Managers" ], "permissions": {}, "properties": {} }, "groups": { "Managers": { "roles": { "guillotina.ContainerAdmin": 1, "guillotina.ContainerDeleter": 1, "guillotina.Owner": 1, "guillotina.Member": 1, "guillotina.Manager": 1 }, "groups": [] } } }
Status Codes: - 200 OK – Get information on the user
- 401 Unauthorized – You are not authorized to perform the operation
- 404 Not Found – The resource does not exist
Registry¶
-
GET
/
(db)/
(container)/@registry
¶ Read container registry settings
- Permission: guillotina.ReadConfiguration
- Context: guillotina.interfaces.content.IContainer
GET /db/container/@registry HTTP/1.1 Accept: application/json Authorization: Basic cm9vdDpyb290
curl -i http://nohost/db/container/@registry -H 'Accept: application/json' --user root:root
http http://nohost/db/container/@registry Accept:application/json -a root:root
HTTP/1.1 200 OK Content-Length: 125 Content-Type: application/json { "value": { "guillotina.interfaces.registry.ILayers.active_layers": [], "guillotina.interfaces.registry.IAddons.enabled": [] } }
Status Codes: - 200 OK – Successfully registered interface
- 401 Unauthorized – You are not authorized to perform the operation
- 404 Not Found – The resource does not exist
-
POST
/
(db)/
(container)/@registry
¶ Register a new interface to for registry settings
- Permission: guillotina.RegisterConfigurations
- Context: guillotina.interfaces.content.IContainer
POST /db/container/@registry HTTP/1.1 Accept: application/json Authorization: Basic cm9vdDpyb290 { "interface": "guillotina.documentation.IRegistryData" }
curl -i -X POST http://nohost/db/container/@registry -H 'Accept: application/json' --data-raw '{ "interface": "guillotina.documentation.IRegistryData" }' --user root:root
echo '{ "interface": "guillotina.documentation.IRegistryData" }' | http POST http://nohost/db/container/@registry Accept:application/json -a root:root
HTTP/1.1 201 OK Content-Length: 2 Content-Type: application/json {}
Status Codes: - 200 OK – Successfully registered interface
- 401 Unauthorized – You are not authorized to perform the operation
- 404 Not Found – The resource does not exist
-
PATCH
/
(db)/
(container)/@registry/
(key)¶ Update registry setting
- Permission: guillotina.WriteConfiguration
- Context: guillotina.interfaces.content.IContainer
PATCH /db/container/@registry/guillotina.documentation.IRegistryData.foobar HTTP/1.1 Accept: application/json Authorization: Basic cm9vdDpyb290 { "value": "something" }
curl -i -X PATCH http://nohost/db/container/@registry/guillotina.documentation.IRegistryData.foobar -H 'Accept: application/json' --data-raw '{ "value": "something" }' --user root:root
echo '{ "value": "something" }' | http PATCH http://nohost/db/container/@registry/guillotina.documentation.IRegistryData.foobar Accept:application/json -a root:root
HTTP/1.1 204 OK Content-Length: 0 Content-Type: application/json
Query Parameters: - name (string) –
- in (string) –
- type (string) –
- schema (string) –
Status Codes: - 200 OK – Successfully wrote configuration
- 401 Unauthorized – You are not authorized to perform the operation
- 404 Not Found – The resource does not exist
-
GET
/
(db)/
(container)/@registry/
(key)¶ Read container registry settings
- Permission: guillotina.ReadConfiguration
- Context: guillotina.interfaces.content.IContainer
GET /db/container/@registry/guillotina.documentation.IRegistryData.foobar HTTP/1.1 Accept: application/json Authorization: Basic cm9vdDpyb290
curl -i http://nohost/db/container/@registry/guillotina.documentation.IRegistryData.foobar -H 'Accept: application/json' --user root:root
http http://nohost/db/container/@registry/guillotina.documentation.IRegistryData.foobar Accept:application/json -a root:root
HTTP/1.1 200 OK Content-Length: 22 Content-Type: application/json { "value": "something" }
Status Codes: - 200 OK – Successfully registered interface
- 401 Unauthorized – You are not authorized to perform the operation
- 404 Not Found – The resource does not exist
Addons¶
-
GET
/
(db)/
(container)/@addons
¶ List available addons
- Permission: guillotina.ManageAddons
- Context: guillotina.interfaces.content.IContainer
GET /db/container/@addons HTTP/1.1 Accept: application/json Authorization: Basic cm9vdDpyb290
curl -i http://nohost/db/container/@addons -H 'Accept: application/json' --user root:root
http http://nohost/db/container/@addons Accept:application/json -a root:root
HTTP/1.1 200 OK Content-Length: 94 Content-Type: application/json { "available": [ { "id": "docaddon", "title": "Doc addon", "dependencies": [] } ], "installed": [] }
Status Codes: - 200 OK – Get list of available and installed addons
- 401 Unauthorized – You are not authorized to perform the operation
- 404 Not Found – The resource does not exist
-
POST
/
(db)/
(container)/@addons
¶ Install addon to container
- Permission: guillotina.ManageAddons
- Context: guillotina.interfaces.content.IContainer
POST /db/container/@addons HTTP/1.1 Accept: application/json Authorization: Basic cm9vdDpyb290 { "id": "docaddon" }
curl -i -X POST http://nohost/db/container/@addons -H 'Accept: application/json' --data-raw '{ "id": "docaddon" }' --user root:root
echo '{ "id": "docaddon" }' | http POST http://nohost/db/container/@addons Accept:application/json -a root:root
HTTP/1.1 200 OK Content-Length: 104 Content-Type: application/json { "available": [ { "id": "docaddon", "title": "Doc addon", "dependencies": [] } ], "installed": [ "docaddon" ] }
Status Codes: - 401 Unauthorized – You are not authorized to perform the operation
- 404 Not Found – The resource does not exist
-
DELETE
/
(db)/
(container)/@addons
¶ Uninstall an addon from container
- Permission: guillotina.ManageAddons
- Context: guillotina.interfaces.content.IContainer
DELETE /db/container/@addons HTTP/1.1 Accept: application/json Authorization: Basic cm9vdDpyb290 { "id": "docaddon" }
curl -i -X DELETE http://nohost/db/container/@addons -H 'Accept: application/json' --data-raw '{ "id": "docaddon" }' --user root:root
echo '{ "id": "docaddon" }' | http DELETE http://nohost/db/container/@addons Accept:application/json -a root:root
HTTP/1.1 200 OK Content-Length: 0 Content-Type: application/json
Status Codes: - 401 Unauthorized – You are not authorized to perform the operation
- 404 Not Found – The resource does not exist
Dynamic Fields¶
Dynamic fields are done with the IDynamicFields behavior so first we add the behavior.
-
PATCH
/
(db)/
(container)/@behaviors
¶ Add behavior to resource
- Permission: guillotina.ModifyContent
- Context: guillotina.interfaces.content.IResource
PATCH /db/container/@behaviors HTTP/1.1 Accept: application/json Authorization: Basic cm9vdDpyb290 { "behavior": "guillotina.behaviors.dynamic.IDynamicFields" }
curl -i -X PATCH http://nohost/db/container/@behaviors -H 'Accept: application/json' --data-raw '{ "behavior": "guillotina.behaviors.dynamic.IDynamicFields" }' --user root:root
echo '{ "behavior": "guillotina.behaviors.dynamic.IDynamicFields" }' | http PATCH http://nohost/db/container/@behaviors Accept:application/json -a root:root
HTTP/1.1 200 OK Content-Length: 2 Content-Type: application/json {}
Status Codes: - 200 OK – Successfully added behavior
- 401 Unauthorized – You are not authorized to perform the operation
- 404 Not Found – The resource does not exist
- 412 Precondition Failed – Behavior already assigned here
Then, we can add a field.
-
PATCH
/
(db)/
(container)¶ Modify the content of this resource
- Permission: guillotina.ModifyContent
- Context: guillotina.interfaces.content.IResource
PATCH /db/container HTTP/1.1 Accept: application/json Authorization: Basic cm9vdDpyb290 { "guillotina.behaviors.dynamic.IDynamicFields": { "fields": { "foobar": { "title": "Hello field", "type": "text" } } } }
curl -i -X PATCH http://nohost/db/container -H 'Accept: application/json' --data-raw '{ "guillotina.behaviors.dynamic.IDynamicFields": { "fields": { "foobar": { "title": "Hello field", "type": "text" } } } }' --user root:root
echo '{ "guillotina.behaviors.dynamic.IDynamicFields": { "fields": { "foobar": { "title": "Hello field", "type": "text" } } } }' | http PATCH http://nohost/db/container Accept:application/json -a root:root
HTTP/1.1 204 OK Content-Length: 0 Content-Type: application/json
Status Codes: - 200 OK – Resource data
- 401 Unauthorized – You are not authorized to perform the operation
- 404 Not Found – The resource does not exist
To inspect the dynamic fields available on content
-
GET
/
(db)/
(container)/@dynamic-fields
¶ Get a list of available fields
- Permission: guillotina.ModifyContent
- Context: guillotina.interfaces.content.IResource
GET /db/container/@dynamic-fields HTTP/1.1 Accept: application/json Authorization: Basic cm9vdDpyb290
curl -i http://nohost/db/container/@dynamic-fields -H 'Accept: application/json' --user root:root
http http://nohost/db/container/@dynamic-fields Accept:application/json -a root:root
HTTP/1.1 200 OK Content-Length: 104 Content-Type: application/json { "foobar": { "title": "Hello field", "description": null, "type": "text", "required": false, "meta": {} } }
Status Codes: - 401 Unauthorized – You are not authorized to perform the operation
- 404 Not Found – The resource does not exist
Update dynamic field values
-
POST
/
(db)/
(container)/
(id)¶ Add new resouce inside this container resource
- Permission: guillotina.AddContent
- Context: guillotina.interfaces.content.IResource
POST /db/container HTTP/1.1 Accept: application/json Authorization: Basic cm9vdDpyb290 { "@type": "Item", "id": "foobar-fields", "@behaviors": [ "guillotina.behaviors.dynamic.IDynamicFieldValues" ] }
curl -i -X POST http://nohost/db/container -H 'Accept: application/json' --data-raw '{ "@type": "Item", "id": "foobar-fields", "@behaviors": [ "guillotina.behaviors.dynamic.IDynamicFieldValues" ] }' --user root:root
echo '{ "@type": "Item", "id": "foobar-fields", "@behaviors": [ "guillotina.behaviors.dynamic.IDynamicFieldValues" ] }' | http POST http://nohost/db/container Accept:application/json -a root:root
HTTP/1.1 201 OK Content-Length: 198 Content-Type: application/json Location: http://127.0.0.1:56609/db/container/foobar-fields { "@id": "http://127.0.0.1:56609/db/container/foobar-fields", "@name": "foobar-fields", "@type": "Item", "@uid": "94f|01ab11c3ced543b9a22ec61a2ab74774", "UID": "94f|01ab11c3ced543b9a22ec61a2ab74774" }
Status Codes: - 200 OK – Resource data
- 401 Unauthorized – You are not authorized to perform the operation
- 404 Not Found – The resource does not exist
-
PATCH
/
(db)/
(container)/
(id)¶ Modify the content of this resource
- Permission: guillotina.ModifyContent
- Context: guillotina.interfaces.content.IResource
PATCH /db/container/foobar-fields HTTP/1.1 Accept: application/json Authorization: Basic cm9vdDpyb290 { "guillotina.behaviors.dynamic.IDynamicFieldValues": { "values": { "op": "update", "value": [ { "key": "foobar", "value": "value" } ] } } }
curl -i -X PATCH http://nohost/db/container/foobar-fields -H 'Accept: application/json' --data-raw '{ "guillotina.behaviors.dynamic.IDynamicFieldValues": { "values": { "op": "update", "value": [ { "key": "foobar", "value": "value" } ] } } }' --user root:root
echo '{ "guillotina.behaviors.dynamic.IDynamicFieldValues": { "values": { "op": "update", "value": [ { "key": "foobar", "value": "value" } ] } } }' | http PATCH http://nohost/db/container/foobar-fields Accept:application/json -a root:root
HTTP/1.1 204 OK Content-Length: 0 Content-Type: application/json
Status Codes: - 200 OK – Resource data
- 401 Unauthorized – You are not authorized to perform the operation
- 404 Not Found – The resource does not exist
-
GET
/
(db)/
(container)/
(id)¶ Retrieves serialization of resource
- Permission: guillotina.ViewContent
- Context: guillotina.interfaces.content.IResource
GET /db/container/foobar-fields?include=guillotina.behaviors.dynamic.IDynamicFieldValues HTTP/1.1 Accept: application/json Authorization: Basic cm9vdDpyb290
curl -i 'http://nohost/db/container/foobar-fields?include=guillotina.behaviors.dynamic.IDynamicFieldValues' -H 'Accept: application/json' --user root:root
http 'http://nohost/db/container/foobar-fields?include=guillotina.behaviors.dynamic.IDynamicFieldValues' Accept:application/json -a root:root
HTTP/1.1 200 OK Content-Length: 675 Content-Type: application/json { "@id": "http://127.0.0.1:56609/db/container/foobar-fields", "@type": "Item", "@name": "foobar-fields", "@uid": "94f|01ab11c3ced543b9a22ec61a2ab74774", "@static_behaviors": [ "guillotina.behaviors.dublincore.IDublinCore" ], "parent": { "@id": "http://127.0.0.1:56609/db/container", "@name": "container", "@type": "Container", "@uid": "94fdd84ea52a4e49afca09073ec7f0a9", "UID": "94fdd84ea52a4e49afca09073ec7f0a9" }, "is_folderish": false, "creation_date": "2019-08-24T12:41:22.447713+00:00", "modification_date": "2019-08-24T12:41:22.447713+00:00", "UID": "94f|01ab11c3ced543b9a22ec61a2ab74774", "guillotina.behaviors.dynamic.IDynamicFieldValues": { "values": { "foobar": "value" } } }
Query Parameters: - include (string) –
- omit (string) –
Status Codes: - 200 OK – Resource data
- 401 Unauthorized – You are not authorized to perform the operation
- 404 Not Found – The resource does not exist