Delete a company, with every project in it
DELETE
/v1/companies/{id}
const url = 'https://beta-api.plune.ai/v1/companies/2489E9AD-2EE2-8E00-8EC9-32D5F69181C0';const options = {method: 'DELETE', headers: {Authorization: 'Bearer <token>'}};
try { const response = await fetch(url, options); const data = await response.json(); console.log(data);} catch (error) { console.error(error);}curl --request DELETE \ --url https://beta-api.plune.ai/v1/companies/2489E9AD-2EE2-8E00-8EC9-32D5F69181C0 \ --header 'Authorization: Bearer <token>'Owner only. The company and every project in it go into the bin together, in one transaction: gone from every list, and a request into one of the projects answers the 404 a project nobody has gets. Six months on the purge empties the projects and removes the company; each project’s audit feed is kept, and records who deleted it. Answers how many projects went with it.
Authorizations
Section titled “Authorizations ”Parameters
Section titled “ Parameters ”Path Parameters
Section titled “Path Parameters ” id
required
string format: uuid
Responses
Section titled “ Responses ”Deleted — how many projects went with it
Media type application/json
object
projects
required
integer
Example
{ "projects": 2}No / invalid token or session
An admin, a member or a reader asked
Media type application/json
object
error
required
string
Example
{ "error": "company owner only"}No such company among yours
Media type application/json
object
error
required
string
Example generated
{ "error": "example"}Rate-limited: either the per-route throttle or a tenant quota. Retry-After carries the seconds until the window rolls over.
Media type application/json
object
error
required
string
Example generated
{ "error": "example"}Headers
Section titled “Headers ” Retry-After
integer
Seconds until the window rolls over