apikey

type ApiKey struct {
	ID          string            `json:"id" doc:"Unique identifier of the API key"`
	Name        string            `json:"name" doc:"Name of the API key"`
	Description *string           `json:"description,omitempty" doc:"Description of the API key"`
	KeyPrefix   string            `json:"keyPrefix" doc:"Prefix of the API key for identification"`
	UserID      *string           `json:"userId,omitempty" doc:"ID of the user who owns the API key"`
	Kind        string            `` /* 127-byte string literal not displayed */
	IsStatic    bool              `json:"isStatic" doc:"Whether the API key is environment-managed and protected from deletion"`
	IsBootstrap bool              `` /* 140-byte string literal not displayed */
	ExpiresAt   *time.Time        `json:"expiresAt,omitempty" doc:"Expiration date of the API key"`
	LastUsedAt  *time.Time        `json:"lastUsedAt,omitempty" doc:"Last time the API key was used"`
	CreatedAt   time.Time         `json:"createdAt" doc:"Creation timestamp"`
	UpdatedAt   *time.Time        `json:"updatedAt,omitempty" doc:"Last update timestamp"`
	Permissions []PermissionGrant `json:"permissions" doc:"Permissions held by this key"`
}

type ApiKeyCreatedDto struct {
	ApiKey

	Key string `json:"key" doc:"The full API key secret (only shown once)"`
}

type CreateApiKey struct {
	Name        string            `json:"name" minLength:"1" maxLength:"255" doc:"Name of the API key" example:"My API Key" unorm:"nfc" trim:"true"`
	Description *string           `json:"description,omitempty" maxLength:"1000" doc:"Optional description of the API key" unorm:"nfc" trim:"true"`
	ExpiresAt   *time.Time        `json:"expiresAt,omitempty" doc:"Optional expiration date for the API key"`
	Permissions []PermissionGrant `json:"permissions" minItems:"1" doc:"Permissions granted to this key. Cannot exceed the creator's own permissions."`
}

type CreateUserApiKey struct {
	Name        string     `json:"name" minLength:"1" maxLength:"255" doc:"Name of the API key" example:"My API Key" unorm:"nfc" trim:"true"`
	Description *string    `json:"description,omitempty" maxLength:"1000" doc:"Optional description of the API key" unorm:"nfc" trim:"true"`
	ExpiresAt   *time.Time `json:"expiresAt,omitempty" doc:"Optional expiration date for the API key"`
}

type PermissionGrant struct {
	Permission    string  `json:"permission" minLength:"1" doc:"Permission string" example:"containers:list"`
	EnvironmentID *string `json:"environmentId,omitempty" doc:"Environment ID to scope the grant to; omit for a global grant"`
}

type UpdateApiKey struct {
	Name        *string           `json:"name,omitzero" maxLength:"255" doc:"New name for the API key" unorm:"nfc" trim:"true"`
	Description *string           `json:"description,omitzero" maxLength:"1000" doc:"New description for the API key" unorm:"nfc" trim:"true"`
	ExpiresAt   *time.Time        `json:"expiresAt,omitzero" doc:"New expiration date for the API key"`
	Permissions []PermissionGrant `` /* 141-byte string literal not displayed */
}