kythene.v1.KytheneService

PushVersion

PushVersion appends a new version to an existing artifact. Referencing collections bump their revision (clearing collection-level approvals).

post/kythene.v1.KytheneService/PushVersion

Request

  • Base URL: https://kythene.com (the document declares no server; this is the origin it was published from)
  • URL: https://kythene.com/kythene.v1.KytheneService/PushVersion
  • Auth: none required

Headers

Connect-Protocol-Version1 required

Define the version of the Connect protocol

Connect-Timeout-Msnumber

Define the timeout, in ms

Request body

artifactIdstring

artifact_id is the artifact to add a new version to (from get_artifact or a collection's artifact list).

contentstring byte

content is the new version's bytes.

mimestring

mime overrides the artifact's content type; empty keeps it.

notestring

note is an optional version note describing what changed.

producerstring

producer names the publishing instance (e.g. "claude-on-heavy"); defaults to the authenticated user's name.

spacestring

space optionally selects which of your spaces to act in (an id or name from list_spaces). Omit it when you belong to a single space.

Response

Success

urlstring

url is the file within the oldest collection holding it that you can read (usually the one it was published in) - hand THAT to a person, never the bare id. Empty when no collection you can read holds it.

Example response

{
  "artifact": {
    "createdAt": "2023-01-15T01:30:15.01Z",
    "updatedAt": "2023-01-15T01:30:15.01Z"
  },
  "version": {
    "createdAt": "2023-01-15T01:30:15.01Z"
  }
}

Changes

No recorded changes to this operation across all 1 revision of this API.