Set osquery version digests

PUT

/api/v1/osquery/versions/{version}

curl --request PUT \
  --url https://example.com/api/v1/osquery/versions/example \
  --header 'Authorization: <Authorization>' \
  --header 'Content-Type: application/json' \
  --data '{ "entries": [ { "arch": "example", "format": "example", "platform": "example", "sha256": "example" } ] }'

Adds or replaces the package SHA-256 digests of a version (linux deb/rpm amd64/arm64, darwin pkg universal, windows msi amd64), each combination at most once. Unknown body fields are refused. Changing a digest of a version used by a target or pin is refused with 409. Super admins only.

Authorizations

• ApiKeyAuth

Parameters

Path Parameters

version

required

string

Osquery version, for example 5.13.0

Request Body^required

Digests

Media typeapplication/json

object

entries

Array<object>

object

arch

string

format

string

platform

string

sha256

string

Example^generated

{
  "entries": [
    {
      "arch": "example",
      "format": "example",
      "platform": "example",
      "sha256": "example"
    }
  ]
}

Responses

200

OK

Media typeapplication/json

object

entries

Array<object>

object

arch

string

created_at

string

created_by

string

format

string

platform

string

sha256

string

in_use

boolean

version

string

Example^generated

{
  "entries": [
    {
      "arch": "example",
      "created_at": "example",
      "created_by": "example",
      "format": "example",
      "platform": "example",
      "sha256": "example"
    }
  ],
  "in_use": true,
  "version": "example"
}

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"
}

409

Version in use

Media typeapplication/json

object

code

string

error

string

Example^generated

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

413

Request body too large

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"
}