Reads a pack's recorded source again.

POST

/v1/m/skills/packs/{id}/update

curl --request POST \
  --url https://example.com/v1/m/skills/packs/example/update \
  --header 'Authorization: Bearer <token>' \
  --header 'Content-Type: application/json' \
  --data '{ "apply": true, "expected_digest": "example", "ref": "example", "subdir": "example" }'

• this engine

Reads a pack’s recorded source again. Without apply it answers current or available, with the diff of what a new revision would change and the manifest digest of the bytes read; nothing is published.

Authorizations

• bearerAuth
• browserSession

Parameters

Path Parameters

id

required

string

Path parameter id.

Header Parameters

Idempotency-Key

string

>= 1 characters <= 128 characters /^[!-~]+$/

Required with apply.

X-Olivares-Tenant

string format: uuid

Target tenant id; required when the principal can act in more than one tenant.

Request Body ^required

Media type application/json

object

apply

Publish the source’s current content as the next revision. Requires expected_digest and an Idempotency-Key header.

boolean

expected_digest

The candidate manifest digest (candidate.manifest_digest of the check) the caller reviewed. Required with apply; refused otherwise.

string

/^[0-9a-f]{64}$/

ref

Git packs only: follow this branch, tag or commit from now on. Defaults to the recorded ref.

string

subdir

Git packs only: the selected directory, for a revision recorded before directories were kept.

string

Example ^generated

{
  "apply": true,
  "expected_digest": "example",
  "ref": "example",
  "subdir": "example"
}

Responses

200

Update check or idempotent replay of a published revision.

Media type application/json

object

Example ^generated

{}

201

Reviewed update published as a new pack revision.

Media type application/json

object

Example ^generated

{}

400

Bad request

Media type application/json

object

Example ^generated

{}

401

Unauthenticated

Media type application/json

object

Example ^generated

{}

403

Forbidden

Media type application/json

object

Example ^generated

{}

404

Not found

Media type application/json

object

Example ^generated

{}

409

Conflict / setup required

Media type application/json

object

Example ^generated

{}

429

Rate limited

Media type application/json

object

Example ^generated

{}