Delete an osquery extension

DELETE

/api/v1/extensions/{id}

curl --request DELETE \
  --url https://example.com/api/v1/extensions/1 \
  --header 'Authorization: <Authorization>'

Removes an extension and its files. Refused while it is assigned to any environment or node, or, for a command-execution extension, while a host reports it kept (osctrld could not remove it). Super admins only.

Authorizations

• ApiKeyAuth

Parameters

Path Parameters

id

required

integer

Extension ID

Responses

204

No content

400

Bad request

Media typeapplication/json

object

code

string

error

string

Example^generated

{
  "code": "example",
  "error": "example"
}

401

Unauthorized

Media typeapplication/json

object

code

string

error

string

Example^generated

{
  "code": "example",
  "error": "example"
}

403

Forbidden

Media typeapplication/json

object

code

string

error

string

Example^generated

{
  "code": "example",
  "error": "example"
}

404

Not found

Media typeapplication/json

object

code

string

error

string

Example^generated

{
  "code": "example",
  "error": "example"
}

409

Extension is assigned, or still on a host that could not remove it

Media typeapplication/json

object

code

string

error

string

Example^generated

{
  "code": "example",
  "error": "example"
}

500

Internal server error

Media typeapplication/json

object

code

string

error

string

Example^generated

{
  "code": "example",
  "error": "example"
}