Why Go
- Case Studies
  
  Common problems companies solve with Go
- Use Cases
  
  Stories about how and why companies use Go
- Security
  
  How Go can help keep you secure by default
Learn
Docs
- Effective Go
  
  Tips for writing clear, performant, and idiomatic Go code
- Go User Manual
  
  A complete introduction to building software with Go
- Standard library
  
  Reference documentation for Go's standard library
- Release Notes
  
  Learn what's new in each Go release
- API
  
  Reference documentation for the pkg.go.dev API
Packages
Community
- Recorded Talks
  
  Videos from prior events
- Meetups
  
  Meet other local Go developers
- Conferences
  
  Learn and network with Go developers from around the world
- Go blog
  
  The Go project's official blog.
- Go project
  
  Get help and stay informed from Go
- Get connected

api

package

Go to main page

Versions in this module

v0

v0.2.0

Sep 16, 2026

Changes in this version

+ var BlogCategories = []string

+ var FeedKinds = []string

+ var ListingCategories = []string

+ var PostKinds = []string

type APIError

+ Body []byte

+ type AdminPost struct

+ Source string

+ type BotData struct

+ Integrations []string

+ Platforms []string

+ Prompt string

+ Schedule string

+ SoulSlug string

type Client

+ func (c *Client) AdminFeed(ctx context.Context, id string) (*FeedSource, error)

+ func (c *Client) AdminPost(ctx context.Context, id string) (*AdminPost, error)

+ func (c *Client) AdminPosts(ctx context.Context) ([]AdminPost, error)

+ func (c *Client) CreateFeed(ctx context.Context, fields map[string]any) (*FeedSource, error)

+ func (c *Client) CreatePost(ctx context.Context, fields map[string]any) (*AdminPost, error)

+ func (c *Client) Feeds(ctx context.Context) ([]FeedSource, error)

+ func (c *Client) Post(ctx context.Context, slug string) (*Post, error)

+ func (c *Client) PostMarkdown(ctx context.Context, slug string) (string, error)

+ func (c *Client) Posts(ctx context.Context, kind string) ([]PostCard, error)

+ func (c *Client) Research(ctx context.Context, q ResearchQuery) (*ResearchResult, error)

+ func (c *Client) SkillMarkdown(ctx context.Context, slug string) (string, error)

+ func (c *Client) SyncFeed(ctx context.Context, id string) (*FeedSyncSummary, error)

+ func (c *Client) UpdateFeed(ctx context.Context, id string, patch map[string]any) (*FeedSource, error)

+ func (c *Client) UpdatePost(ctx context.Context, id string, patch map[string]any) (*AdminPost, bool, error)

+ type FeedSource struct

+ AuthorHandle *string

+ AuthorProfileID *string

+ AutoPublish bool

+ CreatedAt string

+ DefaultCategory string

+ DefaultTags []string

+ Enabled bool

+ FeedURL string

+ ID string

+ Kind string

+ Label string

+ LastFetchedAt *string

+ LastStatus *string

+ ListingID *string

+ ListingSlug *string

+ UpdatedAt string

+ type FeedSyncSummary struct

+ Created int

+ Error string

+ FeedID string

+ Fetched int

+ ItemErrors []string

+ Label string

+ Skipped int

+ Updated int

type Listing

+ AssetContentHash *string

+ AssetVersion *string

+ ChargeCount int

+ HasAsset bool

+ ProfileTier *string

+ func (l *Listing) BotData() (BotData, error)

+ func (l *Listing) SkillData() (SkillData, error)

type LoopData

+ Bundles []string

+ type Post struct

+ Content string

+ type PostCard struct

+ AuthorAvatar *string

+ AuthorHandle *string

+ AuthorName *string

+ AuthorTier *string

+ CanonicalURL *string

+ Category string

+ ContentHash string

+ CreatedAt string

+ Description *string

+ Excerpt string

+ ID string

+ Kind string

+ ListingName *string

+ ListingSlug *string

+ PublishedAt *string

+ Slug string

+ SlugHistory []string

+ Status string

+ Tags []string

+ Title string

+ UpdatedAt string

+ Version string

+ ViewCount int

+ type ResearchItem struct

+ CanonicalURL *string

+ Category string

+ ContentHash string

+ Excerpt string

+ Kind string

+ MdURL string

+ PublishedAt *string

+ Slug string

+ Tags []string

+ Title string

+ URL string

+ type ResearchQuery struct

+ Category string

+ Kind string

+ Limit int

+ Q string

+ Since string

+ Tag string

+ type ResearchResult struct

+ Latest *string

+ Results []ResearchItem

+ type SkillData struct

+ Bundles []string

type SoulCard

+ ChargeCount int

v0.1.2

Jun 16, 2026

Changes in this version

+ type AdminProfile struct

+ Source string

type Client

+ func (c *Client) CreateProfile(ctx context.Context, fields map[string]any) (*AdminProfile, error)

+ func (c *Client) Profiles(ctx context.Context) ([]AdminProfile, error)

+ type Profile struct

+ AvatarURL *string

+ Bio *string

+ CreatedAt string

+ GithubURL *string

+ GithubUserID *string

+ Handle string

+ ID string

+ Kind string

+ Name string

+ Official bool

+ Socials []string

+ UpdatedAt string

+ Verified bool

+ Website *string

v0.1.1

Jun 11, 2026

v0.1.0

Jun 11, 2026

Changes in this version

+ var ListingTypes = []string

+ func IsAuthError(err error) bool

+ func IsNotFound(err error) bool

+ type APIError struct

+ Code string

+ Message string

+ Status int

+ func (e *APIError) Error() string

+ type APIKey struct

+ ExpiresAt *string

+ ID string

+ Key string

+ Name string

+ Prefix *string

+ Start *string

+ type AdminListing struct

+ Source string

+ type AdminSoul struct

+ Source string

+ type Anonymous struct

+ func (Anonymous) Get() (Credentials, error)

+ type Client struct

+ func New(baseURL string, creds CredentialsProvider, opts ...Option) (*Client, error)

+ func (c *Client) AdminListing(ctx context.Context, id string) (*AdminListing, error)

+ func (c *Client) AdminSoul(ctx context.Context, id string) (*AdminSoul, error)

+ func (c *Client) CreateAPIKey(ctx context.Context, name string, expiresIn int) (*APIKey, error)

+ func (c *Client) CreateListing(ctx context.Context, fields map[string]any) (*AdminListing, error)

+ func (c *Client) CreateSoul(ctx context.Context, fields map[string]any) (*AdminSoul, error)

+ func (c *Client) Listing(ctx context.Context, slug string) (*Listing, error)

+ func (c *Client) Listings(ctx context.Context, listingType string) ([]Listing, error)

+ func (c *Client) Me(ctx context.Context) (*Me, error)

+ func (c *Client) Soul(ctx context.Context, slug string) (*Soul, error)

+ func (c *Client) SoulMarkdown(ctx context.Context, slug string) (string, error)

+ func (c *Client) Souls(ctx context.Context) ([]SoulCard, error)

+ func (c *Client) UpdateListing(ctx context.Context, id string, patch map[string]any) (*AdminListing, bool, error)

+ func (c *Client) UpdateSoul(ctx context.Context, id string, patch map[string]any) (*AdminSoul, bool, error)

+ type Credentials struct

+ APIKey string

+ Bearer string

+ type CredentialsProvider interface

+ Get func() (Credentials, error)

+ type EnvCredentials struct

+ func (EnvCredentials) Get() (Credentials, error)

+ type Listing struct

+ Category string

+ Confidence string

+ CreatedAt string

+ Data map[string]any

+ Description *string

+ DownloadCount int

+ ID string

+ InstallCmd *string

+ Name string

+ Official bool

+ ProfileHandle string

+ ProfileName string

+ RepoURL *string

+ Slug string

+ SourceURL string

+ Status string

+ Tagline string

+ Tags []string

+ Type string

+ UpdatedAt string

+ func (l *Listing) LoopData() (LoopData, error)

+ type LoopData struct

+ CheckCommand string

+ CompatibleTools []string

+ ExitCondition string

+ Goal string

+ Kickoff string

+ MaxIterations int

+ type Me struct

+ IsAdmin bool

+ User User

+ type Option func(*Client)

+ func WithHTTPClient(h *http.Client) Option

+ func WithSleep(fn func(time.Duration)) Option

+ type Soul struct

+ Content string

+ type SoulCard struct

+ ArenaRank *int

+ AuthorHandle string

+ AuthorName *string

+ AuthorURL *string

+ Category string

+ ContentHash string

+ CreatedAt string

+ Description *string

+ DownloadCount int

+ Frameworks []string

+ ID string

+ License string

+ Models []string

+ Name string

+ RatingAvg *float64

+ RatingCount int

+ RepoURL *string

+ Slug string

+ SlugHistory []string

+ Status string

+ Tagline string

+ Tags []string

+ UpdatedAt string

+ Version string

+ type User struct

+ Email string

+ GithubLogin *string

+ ID string

+ Image *string

+ Name string