packages

Load one saved package metadata record for the signed-in user, including community-fork source listing provenance, th...

Load one saved package metadata record for the signed-in user, including community-fork source listing provenance, the full export array, callable export contracts, and FYI metadata for associated package-scoped secrets (names and package_id, never values), and its credential needs with how each resolves for you (credentials.needs). For a single export contract, prefer search({ entity: "package:{kodyId}#{subpath}" }). Does not return README, AGENTS.md, or source files; use repoOpenSession + repoReadFile (or packageGetGitRemote) for those.

Org permission: package:read.

get/v1/packages/{package_id}

Request

  • Base URL: https://api.kody.codes
  • URL: https://api.kody.codes/v1/packages/{package_id}
  • Auth: HTTP bearer

Path parameters

package_idstring required

Response

Success.

package_idstring required
kody_idstring required

Package name leaf (same value as slug). Kept as a compatibility alias; prefer slug or name.

slugstring required

Package name leaf (the path segment after the scope). Same value as kody_id.

namestring required
descriptionstring required
tagsstring[] required
has_appboolean required
hiddenboolean required
visibility'public' | 'private' required

Repo visibility / forkable. Public means default-branch HEAD is world-readable and forkable and the package appears on /community. Private is owner-only. Independent of internet_visible.

internet_visibleboolean required

When true, the hosted package app may be served on the public internet after capability approval. Independent of visibility/forkable. Defaults false.

locked_atstring nullable required

When set, publishes require a website click at /@{username}/{kodyId}/approve-publish?commit=<full 40-character SHA>. Agents may lock via packageUpdate (changes.locked: true). Unlocking is website-only at /@{username}/{kodyId}/settings. Do not abbreviate the commit.

source_idstring required
created_atstring required
updated_atstring required
source_listing_idstring nullable required

Catalog entry id this package was forked from, or null for a self-authored package.

listing_currentboolean nullable required

Whether the source catalog entry currently resolves to an active public package, or null for a self-authored package.

listing_kody_idstring nullable required

Original public package name leaf recorded when this package was forked, or null for a self-authored package.

listing_namestring nullable required

Current source listing package name when the listing is active, or null when this package is self-authored or the listing is gone.

origin_commitstring nullable required

Listing pinned commit this fork last absorbed. Starts as the fork-time snapshot and moves when a later publish passes absorbed_upstream_commit.

listing_pinned_commitstring nullable required

Current pinned commit of the source listing, or null when this package is self-authored or the listing is gone.

listing_published_atstring nullable required

Last community publish time of the source listing, or null when this package is self-authored or the listing is gone.

listing_aheadboolean nullable required

True only when this community fork is outdated: the listing pin is not an ancestor of the fork tip. Null for a self-authored package. Otherwise false.

published_commitstring nullable required

Current published Artifacts commit for this package source (same field as repoShowPublishNote defaults to). Null when nothing has been published yet.

Changes

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