Reference
Reference
Quick reference for all resources, branded ID types, enums, and utility functions in the Go SDK.
Content Resources
| Resource | Type | Key Methods | Description |
|---|---|---|---|
ContentData |
*Resource[ContentData, CreateContentDataParams, UpdateContentDataParams, ContentID] |
CRUD, ListPaginated, Count | Content data nodes in the published content tree. |
ContentFields |
*Resource[ContentField, CreateContentFieldParams, UpdateContentFieldParams, ContentFieldID] |
CRUD, ListPaginated, Count | Field values attached to content data nodes. |
ContentRelations |
*Resource[ContentRelation, CreateContentRelationParams, UpdateContentRelationParams, ContentRelationID] |
CRUD, ListPaginated, Count | Relations between content data nodes. |
ContentTree |
*ContentTreeResource |
Save, GetByRoute | Bulk tree operations: create, update, delete nodes atomically. |
ContentReorder |
*ContentReorderResource |
Reorder, Move | Reorder children within a parent or move nodes between parents. |
ContentBatch |
*ContentBatchResource |
Update | Batch content updates in a single request. |
ContentHeal |
*ContentHealResource |
Heal | Detect and repair broken sibling pointers in content trees. |
ContentVersions |
*ContentVersionsResource |
ListByContent | List version snapshots for a content item. |
ContentComposite |
*ContentCompositeResource |
CreateWithFields, DeleteRecursive | Atomic composite operations: create with fields, recursive delete. |
Content |
*ContentDeliveryResource |
GetPage | Public content delivery by slug, format, and locale. |
Query |
*QueryResource |
Query | Filtered, sorted, paginated content queries by datatype name. |
Schema Resources
| Resource | Type | Key Methods | Description |
|---|---|---|---|
Datatypes |
*Resource[Datatype, CreateDatatypeParams, UpdateDatatypeParams, DatatypeID] |
CRUD, ListPaginated, Count | Content type definitions. |
Fields |
*Resource[Field, CreateFieldParams, UpdateFieldParams, FieldID] |
CRUD, ListPaginated, Count | Field definitions on datatypes. |
FieldTypes |
*Resource[FieldTypeInfo, CreateFieldTypeParams, UpdateFieldTypeParams, FieldTypeID] |
CRUD, ListPaginated, Count | Field type registry (text, number, boolean, etc.). |
DatatypeFields |
*Resource[DatatypeField, CreateDatatypeFieldParams, UpdateDatatypeFieldParams, DatatypeFieldID] |
CRUD, ListPaginated, Count | Junction between datatypes and fields. |
DatatypesExtra |
*DatatypesExtraResource |
UpdateSortOrder, MaxSortOrder | Sort order management for datatypes. |
FieldsExtra |
*FieldsExtraResource |
UpdateSortOrder, MaxSortOrder | Sort order management for fields. |
DatatypeComposite |
*DatatypeCompositeResource |
DeleteCascade | Cascade delete a datatype and all dependent content. |
Media Resources
| Resource | Type | Key Methods | Description |
|---|---|---|---|
Media |
*Resource[Media, any, UpdateMediaParams, MediaID] |
Get, Update, Delete, List, ListPaginated, Count | Media file metadata. Create via MediaUpload. Responses include DownloadURL field (/api/v1/media/{id}/download). |
MediaDimensions |
*Resource[MediaDimension, CreateMediaDimensionParams, UpdateMediaDimensionParams, MediaDimensionID] |
CRUD, ListPaginated, Count | Image dimension presets. |
MediaUpload |
*MediaUploadResource |
Upload, UploadWithProgress | Multipart file upload with optional progress tracking. |
MediaAdmin |
*MediaAdminResource |
Health, Cleanup | Media storage health check and orphan cleanup. |
MediaFolders |
*MediaFoldersResource |
Tree, ListMedia, MoveMedia | Media folder hierarchy management. |
MediaComposite |
*MediaCompositeResource |
GetReferences, DeleteWithCleanup | Reference scanning and safe delete with cleanup. |
Auth and User Resources
| Resource | Type | Key Methods | Description |
|---|---|---|---|
Auth |
*AuthResource |
Login, Logout, Me, Register, RequestPasswordReset, ConfirmPasswordReset | Authentication and user registration. |
Users |
*Resource[User, CreateUserParams, UpdateUserParams, UserID] |
CRUD, ListPaginated, Count | User accounts. |
UsersFull |
*UsersFullResource |
List, Get | Users with expanded role and session data. |
Roles |
*Resource[Role, CreateRoleParams, UpdateRoleParams, RoleID] |
CRUD, ListPaginated, Count | RBAC roles. |
Permissions |
*Resource[Permission, CreatePermissionParams, UpdatePermissionParams, PermissionID] |
CRUD, ListPaginated, Count | RBAC permissions. |
RolePermissions |
*RolePermissionsResource |
List, Get, Create, Delete, ListByRole | Role-permission junction management. |
Tokens |
*Resource[Token, CreateTokenParams, UpdateTokenParams, TokenID] |
CRUD, ListPaginated, Count | API tokens. |
UsersOauth |
*Resource[UserOauth, CreateUserOauthParams, UpdateUserOauthParams, UserOauthID] |
CRUD, ListPaginated, Count | OAuth provider links. |
SSHKeys |
*SSHKeysResource |
List, Create, GetByFingerprint, Delete | SSH key management for TUI access. |
Sessions |
*SessionsResource |
List, Get, Update, Remove | Active session management. |
UserComposite |
*UserCompositeResource |
ReassignDelete | Reassign content ownership then delete user. |
Admin Resources
Admin resources mirror their public counterparts but operate on admin content. They share the same method signatures.
Good to know: Generic
Resource[E,C,U,ID]types provideList,Get,Create,Update,Delete,ListPaginated,Count, andRawListmethods unless noted otherwise.
| Resource | Type | Key Methods | Description |
|---|---|---|---|
AdminContentData |
*Resource[AdminContentData, ...] |
CRUD, ListPaginated, Count | Admin content data nodes. |
AdminContentFields |
*Resource[AdminContentField, ...] |
CRUD, ListPaginated, Count | Admin content field values. |
AdminDatatypes |
*Resource[AdminDatatype, ...] |
CRUD, ListPaginated, Count | Admin datatype definitions. |
AdminFields |
*Resource[AdminField, ...] |
CRUD, ListPaginated, Count | Admin field definitions. |
AdminFieldTypes |
*Resource[AdminFieldTypeInfo, ...] |
CRUD, ListPaginated, Count | Admin field type registry. |
AdminDatatypeFields |
*Resource[AdminDatatypeField, ...] |
CRUD, ListPaginated, Count | Admin datatype-field junctions. |
AdminRoutes |
*Resource[AdminRoute, ...] |
CRUD, ListPaginated, Count | Admin route definitions. |
AdminTree |
*AdminTreeResource |
Get | Admin content tree by slug and format. |
AdminContentReorder |
*AdminContentReorderResource |
Reorder, Move | Reorder and move admin content nodes. |
AdminPublishing |
*PublishingResource |
Publish, Unpublish, Schedule, Restore, ListVersions, GetVersion, CreateVersion, DeleteVersion | Publishing lifecycle for admin content. |
AdminDatatypesExtra |
*AdminDatatypesExtraResource |
UpdateSortOrder, MaxSortOrder | Sort order management for admin datatypes. |
AdminMedia |
*Resource[AdminMedia, any, UpdateAdminMediaParams, AdminMediaID] |
Get, Update, Delete, List, ListPaginated, Count | Admin media file metadata. Create via AdminMediaUpload. |
AdminMediaUpload |
*AdminMediaUploadResource |
Upload | Multipart file upload to admin media bucket. |
AdminMediaFolders |
*AdminMediaFoldersResource |
Tree, ListMedia, MoveMedia | Admin media folder hierarchy management. |
Publishing Resources
| Resource | Type | Key Methods | Description |
|---|---|---|---|
Publishing |
*PublishingResource |
Publish, Unpublish, Schedule, Restore, ListVersions, GetVersion, CreateVersion, DeleteVersion | Content publishing, versioning, and restore. |
AdminPublishing |
*PublishingResource |
(same as above) | Admin content publishing. |
Routing Resources
| Resource | Type | Key Methods | Description |
|---|---|---|---|
Routes |
*Resource[Route, CreateRouteParams, UpdateRouteParams, RouteID] |
CRUD, ListPaginated, Count | URL route definitions. |
Operational Resources
| Resource | Type | Key Methods | Description |
|---|---|---|---|
Health |
*HealthResource |
Check | Server health check with subsystem status. |
Config |
*ConfigResource |
Get, Update, Meta | Server configuration read/write and field metadata. |
Deploy |
*DeployResource |
Health, Export, Import, DryRunImport | Content sync between environments. |
Import |
*ImportResource |
Contentful, Sanity, Strapi, WordPress, Clean, Bulk | Import content from external CMS formats. |
Tables |
*Resource[Table, CreateTableParams, UpdateTableParams, TableID] |
CRUD, ListPaginated, Count | Database table metadata. |
Plugin Resources
| Resource | Type | Key Methods | Description |
|---|---|---|---|
Plugins |
*PluginsResource |
List, Get, Reload, Enable, Disable, CleanupDryRun, CleanupDrop | Plugin lifecycle management. |
PluginRoutes |
*PluginRoutesResource |
List, Approve, Revoke | Plugin route approval management. |
PluginHooks |
*PluginHooksResource |
List, Approve, Revoke | Plugin hook approval management. |
Localization Resources
| Resource | Type | Key Methods | Description |
|---|---|---|---|
Locales |
*LocaleResource |
List, Get, Create, Update, Delete, ListPaginated, Count, ListEnabled, CreateTranslation | Locale management and content translation. |
Webhook Resources
| Resource | Type | Key Methods | Description |
|---|---|---|---|
Webhooks |
*WebhookResource |
List, Get, Create, Update, Delete, ListPaginated, Count, Test, ListDeliveries, RetryDelivery | Webhook CRUD plus testing and delivery management. |
Branded ID Types
All entity IDs are distinct string-based types. Each provides String() string and IsZero() bool methods.
| Type | Used by |
|---|---|
ContentID |
ContentData |
ContentFieldID |
ContentFields |
ContentRelationID |
ContentRelations |
AdminContentID |
AdminContentData |
AdminContentFieldID |
AdminContentFields |
AdminContentRelationID |
Admin content relations |
DatatypeID |
Datatypes |
FieldID |
Fields |
FieldTypeID |
FieldTypes |
DatatypeFieldID |
DatatypeFields |
AdminDatatypeID |
AdminDatatypes |
AdminFieldID |
AdminFields |
AdminFieldTypeID |
AdminFieldTypes |
AdminDatatypeFieldID |
AdminDatatypeFields |
MediaID |
Media |
MediaDimensionID |
MediaDimensions |
MediaFolderID |
MediaFolders |
AdminMediaID |
AdminMedia |
AdminMediaFolderID |
AdminMediaFolders |
UserID |
Users |
RoleID |
Roles |
SessionID |
Sessions |
TokenID |
Tokens |
UserOauthID |
UsersOauth |
UserSshKeyID |
SSHKeys |
PermissionID |
Permissions |
RolePermissionID |
RolePermissions |
RouteID |
Routes |
AdminRouteID |
AdminRoutes |
TableID |
Tables |
EventID |
Change events (audit log) |
BackupID |
Backups |
LocaleID |
Locales |
ContentVersionID |
Content versions |
AdminContentVersionID |
Admin content versions |
WebhookID |
Webhooks |
WebhookDeliveryID |
Webhook deliveries |
Value Types
These are branded string types for domain-specific values, not entity IDs:
| Type | Purpose |
|---|---|
Slug |
URL path slugs |
Email |
Email addresses |
URL |
URLs |
Timestamp |
ISO 8601 timestamps. Provides Time() (time.Time, error), NewTimestamp(time.Time), and TimestampNow(). |
Enums
ContentStatus
| Constant | Value |
|---|---|
ContentStatusDraft |
"draft" |
ContentStatusPublished |
"published" |
FieldType
| Constant | Value |
|---|---|
FieldTypeText |
"text" |
FieldTypeTextarea |
"textarea" |
FieldTypeNumber |
"number" |
FieldTypeDate |
"date" |
FieldTypeDatetime |
"datetime" |
FieldTypeBoolean |
"boolean" |
FieldTypeSelect |
"select" |
FieldTypeMedia |
"media" |
FieldTypeID |
"_id" |
FieldTypeJSON |
"json" |
FieldTypeRichtext |
"richtext" |
FieldTypeSlug |
"slug" |
FieldTypeEmail |
"email" |
FieldTypeURL |
"url" |
RouteType
| Constant | Value |
|---|---|
RouteTypeStatic |
"static" |
RouteTypeDynamic |
"dynamic" |
RouteTypeAPI |
"api" |
RouteTypeRedirect |
"redirect" |
Utility Functions
| Function | Signature | Description |
|---|---|---|
NewClient |
(ClientConfig) (*Client, error) |
Create a new API client. |
IsNotFound |
(error) bool |
Check if error is HTTP 404. |
IsUnauthorized |
(error) bool |
Check if error is HTTP 401. |
IsDuplicateMedia |
(error) bool |
Check if error is HTTP 409 (duplicate upload). |
IsInvalidMediaPath |
(error) bool |
Check if error is HTTP 400 (path traversal). |
StringPtr |
(string) *string |
Create a *string from a string value. |
NewTimestamp |
(time.Time) Timestamp |
Create a Timestamp from a time.Time. |
TimestampNow |
() Timestamp |
Create a Timestamp for the current time. |