Skip to content
Connect an agent
Organisations

Remove a folder's rule

Removes the rule for the folder in the folder query, so the folder is open again.

DELETE/orgs/{org}/folder-rules

TL;DR

QuestionAnswer
What does it do?Remove a folder's rule.
What does it take?org in the path, and folder in the query string.
What does it return?Status 204 with no body.
What can go wrong?400 the folder path breaks the rules (orgs.rule_invalid; details.reason is bad_folder); 401 not signed in; 403 only the owner may (orgs.forbidden), or the request came from an origin that may not make changes; 404 no such organisation, or the caller is not a member of it; 429 too many requests; 503 organisations are not set up on this server. Every failure uses the one error envelope.

What it does

Removes the rule for the folder in the folder query, so the folder is open again. A folder with no rule answers the same, 204. Only the owner may.

Path parameters

FieldTypeRequiredDescription
orgstringyesThe organisation's id or its slug.

Query parameters

FieldTypeRequiredDescription
folderstringyesThe folder the rule restricts, with every folder inside it: names from the outermost in, joined with a slash, with no slash at either end.

Responses

StatusMeaningBody
204The rule is gone, or there was none.none
400The folder path breaks the rules (orgs.rule_invalid; details.reason is bad_folder).ErrorResponse
401Not signed in.ErrorResponse
403Only the owner may (orgs.forbidden), or the request came from an origin that may not make changes.ErrorResponse
404No such organisation, or the caller is not a member of it.ErrorResponse
429Too many requests.ErrorResponse
503Organisations are not set up on this server.ErrorResponse

See also

DocWhy
API referenceEvery endpoint, and the error envelope
SchemasEvery request and response type
Tool referenceThe operations as callable tools