REST Resource: projects.locations.skills.revisions

Resource: SkillRevision

Represents an immutable, versioned snapshot of a Skill package.

JSON representation 
{
  "name": string,
  "state": enum (State),
  "sha256Hash": string,
  "frontmatter": {
    object (Frontmatter)
  },
  "createTime": string,
  "sizeBytes": string,
  "uid": string,

  // Union field source can be only one of the following:
  "gcsSource": {
    object (GcsSource)
  },
  "archiveUploadSource": {
    object (ArchiveUploadSource)
  }
  // End of list of possible types for union field source.
}
Fields
name

string

Identifier. Resource name of the SkillRevision. Format: projects/{project}/locations/{location}/skills/{skill}/revisions/{revision}
state

enum (State)

Output only. The system-managed lifecycle state of this revision.
sha256Hash

string

Output only. Cryptographic SHA-256 integrity and deduplication digest of the payload zip.
frontmatter

object (Frontmatter)

Output only. Extracted YAML frontmatter configuration snapshot.
createTime

string (Timestamp format)

Output only. Revision creation timestamp.

Uses RFC 3339, where generated output will always be Z-normalized and use 0, 3, 6 or 9 fractional digits. Offsets other than "Z" are also accepted. Examples: "2014-10-02T15:01:23Z", "2014-10-02T15:01:23.045123456Z" or "2014-10-02T15:01:23+05:30".
sizeBytes

string (int64 format)

Output only. Size of the compiled zip payload in bytes (assists client download progress).
uid

string

Output only. Universally unique identifier (UUID4) for the skill revision.

Union field source. Output only. The storage location pointer. In standard listing, the raw zip bytes are completely excluded. They are streamed separately via a dedicated GetSkillRevision request with ?alt=media. The physical source pointing to the executable payload. Exactly one source must be provided during creation; otherwise, the server will return an INVALID_ARGUMENT error.

Size constraints: - Maximum compressed ZIP size: 500 KB - Maximum total uncompressed size: 10 MB - Maximum individual uncompressed file size: 1 MB source can be only one of the following:
gcsSource

object (GcsSource)

Optional. Immutable. Cloud Storage object generation URI.
archiveUploadSource

object (ArchiveUploadSource)

Optional. Immutable. Direct write-only raw archive upload source.

GcsSource

Specifications for Cloud Storage objects.

JSON representation 
{
  "uri": string,
  "generation": string
}
Fields
uri

string

Required. Cloud Storage object URI. Format: gs://{bucketName}/{objectName}
generation

string (int64 format)

Optional. Cloud Storage object generation ID. If not specified, the latest generation is used.

ArchiveUploadSource

Direct write-only raw archive payload upload.

JSON representation 
{
  "archiveContent": string
}
Fields
archiveContent

string (bytes format)

Required. Input only. Write-only raw ZIP/TAR archive payload bytes containing the skill package.

A base64-encoded string.

State

System-managed computed state.

Enums
STATE_UNSPECIFIED Default value. This value is unused.
CREATING The revision is being created.
ACTIVE The revision is active.
FAILED The revision failed to compile or ingest.
DELETING The revision is being deleted.

Methods

create

 Creates a new immutable revision and triggers validation pipelines.

delete

 Deletes a specific revision (restricted to admins to purge accidentally committed secrets).

get

 Gets details of a single immutable Revision.

list

 Lists all revisions belonging to a parent Skill.