Organisations

Read an organisation's approval settings

"Publishing needs approval", "Public sharing needs approval", and for the owner and admins the chosen approvers.

GET/orgs/{org}/approval

TL;DR

Question	Answer
What does it do?	Read an organisation's approval settings.
What does it take?	`org` in the path.
What does it return?	Status 200 with a body of type `OrganisationApproval`.
What can go wrong?	`401` not signed in; `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.

"Publishing needs approval", "Public sharing needs approval", and for the owner and admins the chosen approvers. Any member may read the switches.

Field	Type	Required	Description
`org`	`string`	yes	The organisation's id or its slug.

Status	Meaning	Body
200	The settings.	`OrganisationApproval`
401	Not signed in.	`ErrorResponse`
404	No such organisation, or the caller is not a member of it.	`ErrorResponse`
429	Too many requests.	`ErrorResponse`
503	Organisations are not set up on this server.	`ErrorResponse`

A 200 answer has the type OrganisationApproval.

Field	Type	Required	Description
`publish`	`"off" \| "folders" \| "all"`	yes
`folders`	`string[]`	yes	The folders "Publishing needs approval" covers when it is `folders`.
`share`	`boolean`	yes
`holdKeys`	`boolean`	yes	"Hold organisation keys for approval too": while false, a publish or a new version made with an organisation key from the Keys tab goes in directly. An agent connection is held as its person is. The owner's setting.
`approvers`	`array \| null`	yes	The members chosen to approve besides the owner and the admins. Null for a caller who may not manage them.

Doc	Why
API reference	Every endpoint, and the error envelope
Schemas	Every request and response type
Tool reference	The operations as callable tools