Skip to content
Connect an agent

Organisations

Remove one of an organisation's patterns

Removes the pattern; agents stop being offered it within a minute.

DELETE/orgs/{org}/patterns/{name}

TL;DR

QuestionAnswer
What does it do?Remove one of an organisation's patterns.
What does it take?org, name in the path.
What does it return?Status 204 with no body.
What can go wrong?401 not signed in; 403 the role may not (orgs.forbidden), or the request came from an origin that may not make changes; 404 no such organisation or pattern, 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 pattern; agents stop being offered it within a minute. Diagrams drawn from it are not touched. The owner and admins.

Path parameters

FieldTypeRequiredDescription
orgstringyesThe organisation's id or slug.
namestringyesThe name after org:.

Responses

StatusMeaningBody
204Removed.none
401Not signed in.ErrorResponse
403The role may not (orgs.forbidden), or the request came from an origin that may not make changes.ErrorResponse
404No such organisation or pattern, 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