kythene.v1.KytheneService

CreateCollection

Publish creates a collection from one or more artifacts (new content and/or references to existing artifacts), tagged, visible in the caller's space. This is the core write: "kythe it".

post/kythene.v1.KytheneService/CreateCollection

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/CreateCollection
  • 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

titlestring

title names the collection; defaults to the first artifact's name.

tagsstring[]

tags to attach (created in the space if they do not exist yet).

existingArtifactIdsstring[]

existing_artifact_ids references already-published artifacts into this collection (curation/re-bundling).

producerstring

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

reviewRequestedboolean

review_requested opts this collection into the approval flow, so the space sees approve/reject controls; otherwise it is shared content with comments.

idempotencyKeystring

idempotency_key makes a publish safe to retry: if a publish times out on the client (a large body embeds synchronously and can outlast the client timeout, even though the write has already committed) but the same key is sent again, the server returns the collection already created for that key instead of creating a duplicate. Optional; a client should generate one per publish attempt and reuse it across retries of that attempt.

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

Example response

{
  "collection": {
    "createdAt": "2023-01-15T01:30:15.01Z",
    "artifacts": [
      {
        "createdAt": "2023-01-15T01:30:15.01Z",
        "updatedAt": "2023-01-15T01:30:15.01Z"
      }
    ]
  }
}

Changes

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