Folder¶

POST /(db)/(container)¶

Add new resouce inside this container resource

Permission: guillotina.AddContent
Context: guillotina.interfaces.content.IResource

http

POST /db/container HTTP/1.1
Accept: application/json
Authorization: Basic cm9vdDpyb290
Content-Type: application/json

{
    "@type": "Folder",
    "id": "foobar"
}

curl

curl -i -X POST http://nohost/db/container -H "Accept: application/json" -H "Content-Type: application/json" --data-raw '{"@type": "Folder", "id": "foobar"}' --user root:root

httpie

echo '{
  "@type": "Folder",
  "id": "foobar"
}' | http POST http://nohost/db/container Accept:application/json Content-Type:application/json -a root:root

response

HTTP/1.1 201 OK
Content-Type: application/json
Location: http://localhost/db/container/foobar

{
    "@id": "http://localhost/db/container/foobar",
    "@name": "foobar",
    "@type": "Folder",
    "@uid": "f16|15f3f72bb2af4b5ca40aeecb2cd8ff40"
}

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

http

PATCH /db/container/foobar HTTP/1.1
Accept: application/json
Authorization: Basic cm9vdDpyb290
Content-Type: application/json

{
    "title": "foobar"
}

curl

curl -i -X PATCH http://nohost/db/container/foobar -H "Accept: application/json" -H "Content-Type: application/json" --data-raw '{"title": "foobar"}' --user root:root

httpie

echo '{
  "title": "foobar"
}' | http PATCH http://nohost/db/container/foobar Accept:application/json Content-Type:application/json -a root:root

response

HTTP/1.1 204 OK
Content-Type: application/octet-stream

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

http

GET /db/container/foobar HTTP/1.1
Accept: application/json
Authorization: Basic cm9vdDpyb290

curl

curl -i -X GET http://nohost/db/container/foobar -H "Accept: application/json" --user root:root

httpie

http http://nohost/db/container/foobar Accept:application/json -a root:root

response

HTTP/1.1 200 OK
Content-Type: application/json

{
    "@id": "http://localhost/db/container/foobar",
    "@type": "Folder",
    "@name": "foobar",
    "@uid": "f16|15f3f72bb2af4b5ca40aeecb2cd8ff40",
    "@static_behaviors": [
        "guillotina.behaviors.dublincore.IDublinCore"
    ],
    "parent": {
        "@id": "http://localhost/db/container",
        "@name": "container",
        "@type": "Container",
        "@uid": "f16b113d40b24e6795ea9117fe91efac"
    },
    "is_folderish": true,
    "creation_date": "2026-06-09T10:34:21.192744+00:00",
    "modification_date": "2026-06-09T10:34:21.201417+00:00",
    "type_name": "Folder",
    "title": "foobar",
    "uuid": "f16|15f3f72bb2af4b5ca40aeecb2cd8ff40",
    "__behaviors__": [],
    "guillotina.behaviors.dublincore.IDublinCore": {
        "title": "foobar",
        "description": null,
        "creation_date": "2026-06-09T10:34:21.192744+00:00",
        "modification_date": "2026-06-09T10:34:21.201417+00:00",
        "effective_date": null,
        "expiration_date": null,
        "creators": [
            "root"
        ],
        "tags": null,
        "publisher": null,
        "contributors": [
            "root"
        ]
    },
    "items": [],
    "length": 0
}

Query Parameters:

include (string) -- (required) (required) (required) (required)
omit (string) -- (required) (required) (required) (required)

Status Codes:

200 OK -- Resource data
401 Unauthorized -- You are not authorized to perform the operation
404 Not Found -- The resource does not exist

DELETE /(db)/(container)/(id)¶

Delete resource

Permission: guillotina.DeleteContent
Context: guillotina.interfaces.content.IResource

http

DELETE /db/container/foobar HTTP/1.1
Accept: application/json
Authorization: Basic cm9vdDpyb290

curl

curl -i -X DELETE http://nohost/db/container/foobar -H "Accept: application/json" --user root:root

httpie

http DELETE http://nohost/db/container/foobar Accept:application/json -a root:root

response

HTTP/1.1 200 OK
Content-Type: application/json

{}

Status Codes:

200 OK -- Successfully deleted resource
401 Unauthorized -- You are not authorized to perform the operation
404 Not Found -- The resource does not exist

Behaviors¶

GET /(db)/(container)/(id)/@behaviors¶

Get information on behaviors for this resource

Permission: guillotina.AccessContent
Context: guillotina.interfaces.content.IResource

http

GET /db/container/foobar/@behaviors HTTP/1.1
Accept: application/json
Authorization: Basic cm9vdDpyb290

curl

curl -i -X GET http://nohost/db/container/foobar/@behaviors -H "Accept: application/json" --user root:root

httpie

http http://nohost/db/container/foobar/@behaviors Accept:application/json -a root:root

response

HTTP/1.1 200 OK
Content-Type: application/json

{
    "static": [
        "guillotina.behaviors.dublincore.IDublinCore"
    ],
    "dynamic": [],
    "available": [
        "guillotina.behaviors.attachment.IAttachment",
        "guillotina.behaviors.attachment.IMultiAttachment",
        "guillotina.behaviors.dynamic.IDynamicFields",
        "guillotina.behaviors.dynamic.IDynamicFieldValues"
    ],
    "guillotina.behaviors.attachment.IAttachment": {
        "type": "object",
        "properties": {
            "file": {
                "type": "object",
                "widget": "file",
                "properties": {
                    "type": "object",
                    "properties": {
                        "content_type": {
                            "type": "string",
                            "widget": "input",
                            "description": "The content type identifies the type of data.",
                            "title": "Content Type"
                        },
                        "filename": {
                            "type": "string",
                            "widget": "input",
                            "title": "Filename"
                        },
                        "extension": {
                            "type": "string",
                            "widget": "input",
                            "title": "Extension of the file"
                        },
                        "md5": {
                            "type": "string",
                            "widget": "input",
                            "title": "MD5"
                        },
                        "size": {
                            "type": "integer",
                            "title": "Size"
                        }
                    },
                    "required": [],
                    "invariants": []
                }
            }
        },
        "required": [],
        "invariants": []
    },
    "guillotina.behaviors.attachment.IMultiAttachment": {
        "type": "object",
        "properties": {
            "files": {
                "type": "object",
                "max_length": 1000,
                "properties": {},
                "additionalProperties": {
                    "type": "object",
                    "widget": "file",
                    "properties": {
                        "type": "object",
                        "properties": {
                            "content_type": {
                                "type": "string",
                                "widget": "input",
                                "description": "The content type identifies the type of data.",
                                "title": "Content Type"
                            },
                            "filename": {
                                "type": "string",
                                "widget": "input",
                                "title": "Filename"
                            },
                            "extension": {
                                "type": "string",
                                "widget": "input",
                                "title": "Extension of the file"
                            },
                            "md5": {
                                "type": "string",
                                "widget": "input",
                                "title": "MD5"
                            },
                            "size": {
                                "type": "integer",
                                "title": "Size"
                            }
                        },
                        "required": [],
                        "invariants": []
                    }
                }
            }
        },
        "required": [],
        "invariants": []
    },
    "guillotina.behaviors.dublincore.IDublinCore": {
        "type": "object",
        "properties": {
            "title": {
                "type": "string",
                "widget": "input",
                "description": "The first unqualified Dublin Core 'Title' element value.",
                "title": "Title"
            },
            "description": {
                "type": "string",
                "widget": "textarea",
                "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",
                "max_length": 1000,
                "title": "Creators",
                "items": {
                    "type": "string",
                    "widget": "input"
                }
            },
            "tags": {
                "type": "array",
                "description": "The unqualified Dublin Core 'Tags' element values",
                "max_length": 10000,
                "title": "Tags",
                "items": {
                    "type": "string",
                    "widget": "input"
                }
            },
            "publisher": {
                "type": "string",
                "widget": "textarea",
                "description": "The first unqualified Dublin Core 'Publisher' element value.",
                "title": "Publisher"
            },
            "contributors": {
                "type": "array",
                "description": "The unqualified Dublin Core 'Contributor' element values",
                "max_length": 10000,
                "title": "Contributors",
                "items": {
                    "type": "string",
                    "widget": "input"
                }
            }
        },
        "required": [],
        "invariants": []
    },
    "guillotina.behaviors.dynamic.IDynamicFields": {
        "type": "object",
        "properties": {
            "fields": {
                "type": "object",
                "max_length": 1000,
                "properties": {},
                "additionalProperties": {
                    "type": "object",
                    "properties": {
                        "type": "object",
                        "properties": {
                            "title": {
                                "type": "string",
                                "widget": "textarea"
                            },
                            "description": {
                                "type": "string",
                                "widget": "textarea"
                            },
                            "type": {
                                "type": "string",
                                "widget": "select",
                                "vocabulary": [
                                    "date",
                                    "integer",
                                    "text",
                                    "float",
                                    "keyword",
                                    "boolean"
                                ]
                            },
                            "required": {
                                "type": "boolean"
                            },
                            "meta": {
                                "type": "object",
                                "title": "Additional information on field",
                                "properties": {}
                            }
                        },
                        "required": [
                            "type"
                        ],
                        "invariants": []
                    }
                }
            }
        },
        "required": [
            "fields"
        ],
        "invariants": []
    },
    "guillotina.behaviors.dynamic.IDynamicFieldValues": {
        "type": "object",
        "properties": {
            "values": {
                "type": "object",
                "max_length": 1000,
                "properties": {},
                "additionalProperties": true
            }
        },
        "required": [
            "values"
        ],
        "invariants": []
    }
}

Status Codes:

200 OK -- A listing of behaviors for content
401 Unauthorized -- You are not authorized to perform the operation
404 Not Found -- The resource does not exist

PATCH /(db)/(container)/(id)/@behaviors¶

Add behavior to resource

Permission: guillotina.ModifyContent
Context: guillotina.interfaces.content.IResource

http

PATCH /db/container/foobar/@behaviors HTTP/1.1
Accept: application/json
Authorization: Basic cm9vdDpyb290
Content-Type: application/json

{
    "behavior": "guillotina.behaviors.attachment.IAttachment"
}

curl

curl -i -X PATCH http://nohost/db/container/foobar/@behaviors -H "Accept: application/json" -H "Content-Type: application/json" --data-raw '{"behavior": "guillotina.behaviors.attachment.IAttachment"}' --user root:root

httpie

echo '{
  "behavior": "guillotina.behaviors.attachment.IAttachment"
}' | http PATCH http://nohost/db/container/foobar/@behaviors Accept:application/json Content-Type:application/json -a root:root

response

HTTP/1.1 200 OK
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

DELETE /(db)/(container)/(id)/@behaviors¶

Remove behavior from resource

Permission: guillotina.ModifyContent
Context: guillotina.interfaces.content.IResource

http

DELETE /db/container/foobar/@behaviors HTTP/1.1
Accept: application/json
Authorization: Basic cm9vdDpyb290
Content-Type: application/json

{
    "behavior": "guillotina.behaviors.attachment.IAttachment"
}

curl

curl -i -X DELETE http://nohost/db/container/foobar/@behaviors -H "Accept: application/json" -H "Content-Type: application/json" --data-raw '{"behavior": "guillotina.behaviors.attachment.IAttachment"}' --user root:root

httpie

echo '{
  "behavior": "guillotina.behaviors.attachment.IAttachment"
}' | http DELETE http://nohost/db/container/foobar/@behaviors Accept:application/json Content-Type:application/json -a root:root

response

HTTP/1.1 200 OK
Content-Type: application/json

{}

Status Codes:

200 OK -- Successfully removed behavior
401 Unauthorized -- You are not authorized to perform the operation
404 Not Found -- The resource does not exist
412 Precondition Failed -- Behavior not assigned here

Files¶

PATCH /(db)/(container)/(id)/@upload/(field_name)¶

Permission: guillotina.ModifyContent
Context: guillotina.interfaces.content.IResource

http

PATCH /db/container/foobar/@upload/file HTTP/1.1
Accept: application/json
Authorization: Basic cm9vdDpyb290

foobar data

curl

curl -i -X PATCH http://nohost/db/container/foobar/@upload/file -H "Accept: application/json" --data-raw 'foobar data' --user root:root

httpie

echo 'foobar data' | http PATCH http://nohost/db/container/foobar/@upload/file Accept:application/json -a root:root

response

HTTP/1.1 200 OK
Content-Type: application/json

{}

Status Codes:

401 Unauthorized -- You are not authorized to perform the operation
404 Not Found -- The resource does not exist

GET /(db)/(container)/(id)/@download/(field_name)¶

Permission: guillotina.ViewContent
Context: guillotina.interfaces.content.IResource

http

GET /db/container/foobar/@download/file HTTP/1.1
Accept: application/json
Authorization: Basic cm9vdDpyb290

curl

curl -i -X GET http://nohost/db/container/foobar/@download/file -H "Accept: application/json" --user root:root

httpie

http http://nohost/db/container/foobar/@download/file Accept:application/json -a root:root

response

HTTP/1.1 200 OK
Accept-Ranges: bytes
Content-Disposition: attachment; filename="8c6118004bfa4c2d8118b8cecdc08cd9"
Content-Length: 11
Content-Type: application/octet-stream

foobar data

Status Codes:

401 Unauthorized -- You are not authorized to perform the operation
404 Not Found -- The resource does not exist

Security¶

GET /(db)/(container)/(id)/@all_permissions¶

See all permission settings for this resource

Permission: guillotina.SeePermissions
Context: guillotina.interfaces.content.IResource

http

GET /db/container/foobar/@all_permissions HTTP/1.1
Accept: application/json
Authorization: Basic cm9vdDpyb290

curl

curl -i -X GET http://nohost/db/container/foobar/@all_permissions -H "Accept: application/json" --user root:root

httpie

http http://nohost/db/container/foobar/@all_permissions Accept:application/json -a root:root

response

HTTP/1.1 200 OK
Content-Type: application/json

[
    {
        "foobar": {
            "prinperm": [],
            "prinrole": [
                {
                    "principal": "root",
                    "role": "guillotina.Owner",
                    "setting": "Allow"
                }
            ],
            "roleperm": [],
            "perminhe": []
        }
    },
    {
        "container": {
            "prinperm": [],
            "prinrole": [
                {
                    "principal": "root",
                    "role": "guillotina.ContainerAdmin",
                    "setting": "Allow"
                },
                {
                    "principal": "root",
                    "role": "guillotina.Owner",
                    "setting": "Allow"
                }
            ],
            "roleperm": [],
            "perminhe": []
        }
    },
    {
        "(no name)": {
            "prinperm": [
                {
                    "principal": "root",
                    "permission": "guillotina.AccessContent",
                    "setting": "Allow"
                },
                {
                    "principal": "root",
                    "permission": "guillotina.AddContainer",
                    "setting": "Allow"
                },
                {
                    "principal": "root",
                    "permission": "guillotina.DeleteContainers",
                    "setting": "Allow"
                },
                {
                    "principal": "root",
                    "permission": "guillotina.GetAPIDefinition",
                    "setting": "Allow"
                },
                {
                    "principal": "root",
                    "permission": "guillotina.GetContainers",
                    "setting": "Allow"
                },
                {
                    "principal": "root",
                    "permission": "guillotina.GetDatabases",
                    "setting": "Allow"
                },
                {
                    "principal": "root",
                    "permission": "guillotina.MountDatabase",
                    "setting": "Allow"
                },
                {
                    "principal": "root",
                    "permission": "guillotina.UmountDatabase",
                    "setting": "Allow"
                }
            ],
            "perminhe": []
        }
    },
    {
        "system": {
            "prinperm": [],
            "prinrole": [],
            "roleperm": [
                {
                    "permission": "guillotina.AccessPreflight",
                    "role": "guillotina.Anonymous",
                    "setting": "Allow"
                },
                {
                    "permission": "guillotina.AccessPreflight",
                    "role": "guillotina.Authenticated",
                    "setting": "Allow"
                },
                {
                    "permission": "guillotina.Public",
                    "role": "guillotina.Anonymous",
                    "setting": "Allow"
                },
                {
                    "permission": "guillotina.Public",
                    "role": "guillotina.Authenticated",
                    "setting": "Allow"
                },
                {
                    "permission": "guillotina.RefreshToken",
                    "role": "guillotina.Authenticated",
                    "setting": "Allow"
                },
                {
                    "permission": "guillotina.SeeSession",
                    "role": "guillotina.Authenticated",
                    "setting": "Allow"
                },
                {
                    "permission": "guillotina.Logout",
                    "role": "guillotina.Authenticated",
                    "setting": "Allow"
                },
                {
                    "permission": "guillotina.UseWebSockets",
                    "role": "guillotina.Authenticated",
                    "setting": "Allow"
                },
                {
                    "permission": "guillotina.ViewContent",
                    "role": "guillotina.Reader",
                    "setting": "Allow"
                },
                {
                    "permission": "guillotina.ViewContent",
                    "role": "guillotina.Reviewer",
                    "setting": "Allow"
                },
                {
                    "permission": "guillotina.ViewContent",
                    "role": "guillotina.Owner",
                    "setting": "Allow"
                },
                {
                    "permission": "guillotina.ViewContent",
                    "role": "guillotina.Editor",
                    "setting": "Allow"
                },
                {
                    "permission": "guillotina.AccessContent",
                    "role": "guillotina.Reader",
                    "setting": "Allow"
                },
                {
                    "permission": "guillotina.AccessContent",
                    "role": "guillotina.Reviewer",
                    "setting": "Allow"
                },
                {
                    "permission": "guillotina.AccessContent",
                    "role": "guillotina.Owner",
                    "setting": "Allow"
                },
                {
                    "permission": "guillotina.AccessContent",
                    "role": "guillotina.Editor",
                    "setting": "Allow"
                },
                {
                    "permission": "guillotina.AccessContent",
                    "role": "guillotina.ContainerAdmin",
                    "setting": "Allow"
                },
                {
                    "permission": "guillotina.DuplicateContent",
                    "role": "guillotina.Reader",
                    "setting": "Allow"
                },
                {
                    "permission": "guillotina.DuplicateContent",
                    "role": "guillotina.Owner",
                    "setting": "Allow"
                },
                {
                    "permission": "guillotina.DuplicateContent",
                    "role": "guillotina.Editor",
                    "setting": "Allow"
                },
                {
                    "permission": "guillotina.DeleteContent",
                    "role": "guillotina.Owner",
                    "setting": "Allow"
                },
                {
                    "permission": "guillotina.AddContent",
                    "role": "guillotina.Owner",
                    "setting": "Allow"
                },
                {
                    "permission": "guillotina.MoveContent",
                    "role": "guillotina.Owner",
                    "setting": "Allow"
                },
                {
                    "permission": "guillotina.MoveContent",
                    "role": "guillotina.Editor",
                    "setting": "Allow"
                },
                {
                    "permission": "guillotina.ModifyContent",
                    "role": "guillotina.Owner",
                    "setting": "Allow"
                },
                {
                    "permission": "guillotina.ModifyContent",
                    "role": "guillotina.Editor",
                    "setting": "Allow"
                },
                {
                    "permission": "guillotina.ChangePermissions",
                    "role": "guillotina.Owner",
                    "setting": "Allow"
                },
                {
                    "permission": "guillotina.SeePermissions",
                    "role": "guillotina.Owner",
                    "setting": "Allow"
                },
                {
                    "permission": "guillotina.ReindexContent",
                    "role": "guillotina.Owner",
                    "setting": "Allow"
                },
                {
                    "permission": "guillotina.ReindexContent",
                    "role": "guillotina.Editor",
                    "setting": "Allow"
                },
                {
                    "permission": "guillotina.ManageAddons",
                    "role": "guillotina.ContainerAdmin",
                    "setting": "Allow"
                },
                {
                    "permission": "guillotina.ReadConfiguration",
                    "role": "guillotina.ContainerAdmin",
                    "setting": "Allow"
                },
                {
                    "permission": "guillotina.WriteConfiguration",
                    "role": "guillotina.ContainerAdmin",
                    "setting": "Allow"
                },
                {
                    "permission": "guillotina.RegisterConfigurations",
                    "role": "guillotina.ContainerAdmin",
                    "setting": "Allow"
                },
                {
                    "permission": "guillotina.ManageCatalog",
                    "role": "guillotina.ContainerAdmin",
                    "setting": "Allow"
                },
                {
                    "permission": "guillotina.RawSearchContent",
                    "role": "guillotina.ContainerAdmin",
                    "setting": "Allow"
                },
                {
                    "permission": "guillotina.CacheManage",
                    "role": "guillotina.Manager",
                    "setting": "Allow"
                },
                {
                    "permission": "guillotina.Manage",
                    "role": "guillotina.Manager",
                    "setting": "Allow"
                },
                {
                    "permission": "guillotina.DeleteContainers",
                    "role": "guillotina.ContainerDeleter",
                    "setting": "Allow"
                },
                {
                    "permission": "guillotina.SearchContent",
                    "role": "guillotina.Member",
                    "setting": "Allow"
                }
            ]
        }
    }
]

Status Codes:

200 OK -- All the permissions defined on this resource
401 Unauthorized -- You are not authorized to perform the operation
404 Not Found -- The resource does not exist

GET /(db)/(container)/(id)/@canido¶

Check if user has permissions on context

Permission: guillotina.AccessContent
Context: guillotina.interfaces.content.IResource

http

GET /db/container/foobar/@canido?permissions=guillotina.ModifyContent%2Cguillotina.AccessContent HTTP/1.1
Accept: application/json
Authorization: Basic cm9vdDpyb290

curl

curl -i -X GET 'http://nohost/db/container/foobar/@canido?permissions=guillotina.ModifyContent%2Cguillotina.AccessContent' -H "Accept: application/json" --user root:root

httpie

http 'http://nohost/db/container/foobar/@canido?permissions=guillotina.ModifyContent%2Cguillotina.AccessContent' Accept:application/json -a root:root

response

HTTP/1.1 200 OK
Content-Type: application/json

{
    "guillotina.ModifyContent": true,
    "guillotina.AccessContent": true
}

Query Parameters:

permission (string) -- (required)

Status Codes:

200 OK -- Successfully changed permission
401 Unauthorized -- You are not authorized to perform the operation
404 Not Found -- The resource does not exist

GET /(db)/(container)/(id)/@sharing¶

Get sharing settings for this resource

Permission: guillotina.SeePermissions
Context: guillotina.interfaces.content.IResource

http

GET /db/container/foobar/@sharing HTTP/1.1
Accept: application/json
Authorization: Basic cm9vdDpyb290

curl

curl -i -X GET http://nohost/db/container/foobar/@sharing -H "Accept: application/json" --user root:root

httpie

http http://nohost/db/container/foobar/@sharing Accept:application/json -a root:root

response

HTTP/1.1 200 OK
Content-Type: application/json

{
    "local": {
        "roleperm": {},
        "prinperm": {},
        "prinrole": {
            "root": {
                "guillotina.Owner": "Allow"
            }
        }
    },
    "inherit": [
        {
            "@id": "http://localhost/db/container",
            "roleperm": {},
            "prinperm": {},
            "prinrole": {
                "root": {
                    "guillotina.ContainerAdmin": "Allow",
                    "guillotina.Owner": "Allow"
                }
            }
        }
    ]
}

Status Codes:

200 OK -- All the sharing defined on this resource
401 Unauthorized -- You are not authorized to perform the operation
404 Not Found -- The resource does not exist

POST /(db)/(container)/(id)/@sharing¶

Change permissions for a resource

Permission: guillotina.ChangePermissions
Context: guillotina.interfaces.content.IResource

http

POST /db/container/foobar/@sharing HTTP/1.1
Accept: application/json
Authorization: Basic cm9vdDpyb290
Content-Type: application/json

{
    "prinrole": [
        {
            "principal": "foobar",
            "role": "guillotina.Owner",
            "setting": "Allow"
        }
    ]
}

curl

curl -i -X POST http://nohost/db/container/foobar/@sharing -H "Accept: application/json" -H "Content-Type: application/json" --data-raw '{"prinrole": [{"principal": "foobar", "role": "guillotina.Owner", "setting": "Allow"}]}' --user root:root

httpie

echo '{
  "prinrole": [
    {
      "principal": "foobar",
      "role": "guillotina.Owner",
      "setting": "Allow"
    }
  ]
}' | http POST http://nohost/db/container/foobar/@sharing Accept:application/json Content-Type:application/json -a root:root

response

HTTP/1.1 200 OK
Content-Type: application/json

{}

Status Codes:

200 OK -- Successfully changed permission
401 Unauthorized -- You are not authorized to perform the operation
404 Not Found -- The resource does not exist

PUT /(db)/(container)/(id)/@sharing¶

Replace permissions for a resource

Permission: guillotina.ChangePermissions
Context: guillotina.interfaces.content.IResource

http

PUT /db/container/foobar/@sharing HTTP/1.1
Accept: application/json
Authorization: Basic cm9vdDpyb290
Content-Type: application/json

{
    "prinrole": [
        {
            "principal": "foobar",
            "role": "guillotina.Owner",
            "setting": "Allow"
        }
    ]
}

curl

curl -i -X PUT http://nohost/db/container/foobar/@sharing -H "Accept: application/json" -H "Content-Type: application/json" --data-raw '{"prinrole": [{"principal": "foobar", "role": "guillotina.Owner", "setting": "Allow"}]}' --user root:root

httpie

echo '{
  "prinrole": [
    {
      "principal": "foobar",
      "role": "guillotina.Owner",
      "setting": "Allow"
    }
  ]
}' | http PUT http://nohost/db/container/foobar/@sharing Accept:application/json Content-Type:application/json -a root:root

response

HTTP/1.1 200 OK
Content-Type: application/json

{}

Status Codes:

200 OK -- Successfully replaced permissions
401 Unauthorized -- You are not authorized to perform the operation
404 Not Found -- The resource does not exist

Content¶

POST /(db)/(container)/(id)/@move¶

Move resource

Permission: guillotina.MoveContent
Context: guillotina.interfaces.content.IResource

http

POST /db/container/foobar/@move HTTP/1.1
Accept: application/json
Authorization: Basic cm9vdDpyb290
Content-Type: application/json

{
    "destination": "",
    "new_id": "foobar2"
}

curl

curl -i -X POST http://nohost/db/container/foobar/@move -H "Accept: application/json" -H "Content-Type: application/json" --data-raw '{"destination": "", "new_id": "foobar2"}' --user root:root

httpie

echo '{
  "destination": "",
  "new_id": "foobar2"
}' | http POST http://nohost/db/container/foobar/@move Accept:application/json Content-Type:application/json -a root:root

response

HTTP/1.1 412 OK
Content-Type: application/json

{
    "reason": "preconditionFailed",
    "details": "",
    "type": "PreconditionFailed",
    "eid": "239475e773a54947bc4be6601ad3cc2b",
    "message": "Precondition Failed Could not find destination object on < Folder at /container/foobar by 126401386815552 >"
}

Status Codes:

200 OK -- Successfully moved resource
401 Unauthorized -- You are not authorized to perform the operation
404 Not Found -- The resource does not exist

POST /(db)/(container)/(id)/@duplicate¶

Permission: ****
Context: ****

http

POST /db/container/foobar2/@duplicate HTTP/1.1
Accept: application/json
Authorization: Basic cm9vdDpyb290
Content-Type: application/json

{
    "destination": "",
    "new_id": "foobar3"
}

curl

curl -i -X POST http://nohost/db/container/foobar2/@duplicate -H "Accept: application/json" -H "Content-Type: application/json" --data-raw '{"destination": "", "new_id": "foobar3"}' --user root:root

httpie

echo '{
  "destination": "",
  "new_id": "foobar3"
}' | http POST http://nohost/db/container/foobar2/@duplicate Accept:application/json Content-Type:application/json -a root:root

response

HTTP/1.1 404 OK
Content-Type: application/json

{
    "reason": "object and/or route not found"
}

Status Codes:

401 Unauthorized -- You are not authorized to perform the operation
404 Not Found -- The resource does not exist

GET /(db)/(container)/(id)/@addable-types¶

Permission: ****
Context: ****

http

GET /db/container/foobar3/@addable-types HTTP/1.1
Accept: application/json
Authorization: Basic cm9vdDpyb290

curl

curl -i -X GET http://nohost/db/container/foobar3/@addable-types -H "Accept: application/json" --user root:root

httpie

http http://nohost/db/container/foobar3/@addable-types Accept:application/json -a root:root

response

HTTP/1.1 404 OK
Content-Type: application/json

{
    "reason": "object and/or route not found"
}

Status Codes:

401 Unauthorized -- You are not authorized to perform the operation
404 Not Found -- The resource does not exist

GET /(db)/(container)/(id)/@ids¶

Permission: ****
Context: ****

http

GET /db/container/foobar3/@ids HTTP/1.1
Accept: application/json
Authorization: Basic cm9vdDpyb290

curl

curl -i -X GET http://nohost/db/container/foobar3/@ids -H "Accept: application/json" --user root:root

httpie

http http://nohost/db/container/foobar3/@ids Accept:application/json -a root:root

response

HTTP/1.1 404 OK
Content-Type: application/json

{
    "reason": "object and/or route not found"
}

Status Codes:

401 Unauthorized -- You are not authorized to perform the operation
404 Not Found -- The resource does not exist

GET /(db)/(container)/(id)/@items¶

Permission: ****
Context: ****

http

GET /db/container/foobar3/@items HTTP/1.1
Accept: application/json
Authorization: Basic cm9vdDpyb290

curl

curl -i -X GET http://nohost/db/container/foobar3/@items -H "Accept: application/json" --user root:root

httpie

http http://nohost/db/container/foobar3/@items Accept:application/json -a root:root

response

HTTP/1.1 404 OK
Content-Type: application/json

{
    "reason": "object and/or route not found"
}

Status Codes:

401 Unauthorized -- You are not authorized to perform the operation
404 Not Found -- The resource does not exist

GET /(db)/(container)/(id)/@invalidate-cache¶

Permission: ****
Context: ****

http

GET /db/container/foobar3/@invalidate-cache HTTP/1.1
Accept: application/json
Authorization: Basic cm9vdDpyb290

curl

curl -i -X GET http://nohost/db/container/foobar3/@invalidate-cache -H "Accept: application/json" --user root:root

httpie

http http://nohost/db/container/foobar3/@invalidate-cache Accept:application/json -a root:root

response

HTTP/1.1 404 OK
Content-Type: application/json

{
    "reason": "object and/or route not found"
}

Status Codes:

401 Unauthorized -- You are not authorized to perform the operation
404 Not Found -- The resource does not exist

On this page

Next topic

Previous topic

Folder¶

Behaviors¶

Files¶

Security¶

Content¶