Common types

Error

Field	Type	Required	Notes
reason	BadRequest | NotFound | TooLarge | Unauthorized | Forbidden | Conflict | Internal | Unavailable	Yes	Machine-readable category
message	string	Yes	Human-readable explanation

The following table maps HTTP codes to their respective reason:

HTTP code	Reason
400 Bad Request	BadRequest
401 Unauthorized	Unauthorized
403 Forbidden	Forbidden
404 Not Found	NotFound
409 Conflict	Conflict
413 Entity Too Large	TooLarge
500 Internal Server Error	Internal
503 Service Unavailable	Unavailable

ObjectMeta

Field	Type	Required	Notes
name	string	Yes	Object name
workspace	string	Yes	Owning workspace
namePrefix	string		Used only on create to auto-generate name
rev	int		Revision for optimistic concurrency
createdAt	string (RFC 3339)		Creation timestamp
updatedAt	string (RFC 3339)		Last-update timestamp
ownerID	string		User ID that created the object

ListMeta

cursor - optional string

Field	Type	Required	Notes
cursor	string		Opaque cursor token for the next page

ListOptions

Field	Type	Required	Notes
limit	int		Soft page-size cap; server may return fewer
cursor	string		Cursor from a previous list response
selector	string		Selector expression (see filtering)

LocalObjectReference

Field	Type	Required	Notes
name	string		Name of the referenced object within the same workspace