Organisations

Disconnect Azure DevOps

Deletes the sealed sign-in; trusted publishers already added are kept.

DELETE/orgs/{org}/connectors/azure-devops

TL;DR

Question	Answer
What does it do?	Disconnect Azure DevOps.
What does it take?	`org` in the path.
What does it return?	Status 200 with a body of type `OrgAzureDevopsConnector`.
What can go wrong?	`401` not signed in; `403` not the owner or an admin (`orgs.forbidden`), or the plan has no trusted publishers (`plan.trusted_publishers_not_included`); `404` no such organisation, or the caller is not a member of it; `409` azure DevOps is not connected (`azure_devops.not_connected`); `429` too many requests; `503` organisations are not available on this server (`orgs.unavailable`), or it has no Microsoft Entra app for the connector (`azure_devops.not_configured`). Every failure uses the one error envelope.

Deletes the sealed sign-in; trusted publishers already added are kept. Works on any plan.

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

Status	Meaning	Body
200	The connector now.	`OrgAzureDevopsConnector`
401	Not signed in.	`ErrorResponse`
403	Not the owner or an admin (`orgs.forbidden`), or the plan has no trusted publishers (`plan.trusted_publishers_not_included`).	`ErrorResponse`
404	No such organisation, or the caller is not a member of it.	`ErrorResponse`
409	Azure DevOps is not connected (`azure_devops.not_connected`).	`ErrorResponse`
429	Too many requests.	`ErrorResponse`
503	Organisations are not available on this server (`orgs.unavailable`), or it has no Microsoft Entra app for the connector (`azure_devops.not_configured`).	`ErrorResponse`

A 200 answer has the type OrgAzureDevopsConnector.

Field	Type	Required	Description
`configured`	`boolean`	yes	Whether this server has the Microsoft Entra app the connector signs in with. When false, the trusted publisher form keeps its typed fields.
`available`	`boolean`	yes	Whether the plan has trusted publishers, which the connector serves: Pro and Enterprise.
`plan`	`string`	yes
`connection`	`object \| null`	yes	The sign-in, or null when nobody has connected Azure DevOps. The token is never answered.
`connection.accountLabel`	`string \| null`	yes	The Microsoft account's address or display name, whose access the lists use.
`connection.connectedBy`	`object \| null`	yes	The Plotwork account that connected it, or null when that account is gone.
`connection.connectedBy.id`	`string`	yes
`connection.connectedBy.email`	`string`	yes
`connection.connectedBy.name`	`string \| null`	yes
`connection.connectedAt`	`integer`	yes

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