> For the complete documentation index, see [llms.txt](https://docs.kognitos.com/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://docs.kognitos.com/guides/api-reference/work-items.md).

# Work Items

Track work items and work units that need human input.

## List Work Items

> ListWorkItems lists the items in a workspace, with filtering, ordering and\
> pagination. Every view a surface offers is composed from this one method.\
> \
> input\_form is left unset on every item here to avoid repeating potentially\
> large schemas. Surfaces rendering forms alongside queue rows fetch\
> GetWorkItem for the items being reviewed.

```json
{"openapi":"3.0.0","info":{"title":"Kognitos API","version":"1.0.0"},"tags":[{"name":"Work Items","description":"Track work items and work units that need human input."}],"servers":[{"url":"https://app.us-1.kognitos.com"}],"security":[{"BearerAuth":[]}],"components":{"securitySchemes":{"BearerAuth":{"type":"http","scheme":"bearer","description":"Personal Access Token."}},"schemas":{"v1ListWorkItemsResponse":{"type":"object","properties":{"work_items":{"type":"array","items":{"$ref":"#/components/schemas/v1WorkItem"},"description":"Matching items, each returned once with counts of all attached units.\nUnit reads expose individual states and final submissions."},"next_page_token":{"type":"string","description":"A token to retrieve the next page, or empty if there are no more."},"total_size":{"type":"integer","format":"int32","description":"The total number of items matching the filter, so a view can show a count."}},"description":"ListWorkItemsResponse contains a page of items and the total matching the\nfilter."},"v1WorkItem":{"type":"object","properties":{"name":{"type":"string","title":"The resource name of the work item.\nFormat: organizations/{organization_id}/workspaces/{workspace_id}/workItems/{work_item_id}"},"kind":{"type":"string","description":"The registered kind of work, as an opaque dotted id\n(for example \"astral.automation_exception\").\n\nThis is a string rather than an enum so that registering a kind is not a\nproto change. It is validated against the registered kind descriptors, so\nthe set is closed at runtime. No behaviour in this contract branches on it.","readOnly":true},"agg_labels":{"$ref":"#/components/schemas/commonv1Value"},"question":{"type":"string","description":"The question in business language: the summary of the unit that\nmaterialised this item, verbatim.\n\nThe pointer and source summary are fixed for the item's life. Per-unit\nquestions remain available on the units; this is a queue summary.\n\nIt is one unit's words about a set. Clients use unit_counts to show the\nnumber of occurrences relevant to their view.","readOnly":true},"assignee":{"type":"string","title":"The person this item is assigned to. The empty value means unassigned,\nwhich is an ordinary state of a queue and not a missing value.\nFormat: users/{user_id}"},"declined_by":{"type":"string","title":"The person who last handed this item back. Current state rather than\nhistory; the history is in the audit log.\nFormat: users/{user_id}","readOnly":true},"decline_reason":{"type":"string","description":"Why the item was last handed back. Current state rather than history.","readOnly":true},"create_time":{"type":"string","format":"date-time","description":"The time the item was materialised. This is the item's age.","readOnly":true},"update_time":{"type":"string","format":"date-time","description":"The time the item last changed.","readOnly":true},"input_form":{"$ref":"#/components/schemas/v1FormSpec"},"input_form_etag":{"type":"string","description":"Concurrency token for input_form, present even before the first form is set.\nChanges only when the form changes. Returned by Get and List.","readOnly":true},"archive_time":{"type":"string","format":"date-time","description":"When the item was explicitly archived. Absence means not archived.\nUnarchive clears this field. Archival locally dismisses unresolved units\nand future arrivals; answered and withdrawn units retain their outcomes.","readOnly":true},"unit_counts":{"type":"array","items":{"$ref":"#/components/schemas/v1WorkUnitStatusCount"},"description":"Counts of all attached units, independent of any ListWorkItems filter.\nReturned by Get and List. Exactly one entry for every defined WorkUnitStatus\nexcept UNSPECIFIED, including zero counts; no duplicate statuses.\nSum all entries for the total, or selected statuses for a view's count.","readOnly":true},"preparation_required":{"type":"boolean","description":"Whether the UI should offer preparation before opening chat.\nSet for preparation-enabled kinds when unresolved membership changes from\nzero to nonzero, including initial arrival, unarchive and rekey. Further\narrivals while unresolved units remain do not set it again. Suppress the\ngate when no unresolved units remain, regardless of this stored flag.\nMarkWorkItemPreparationStarted clears it after Rain accepts a prompt.\nAutomatic invocation also clears it on message acceptance while its unit\nstill belongs to the item and the item is not archived.\nClearing this flag does not change unit status or indicate preparation has\nfinished. This is not execution state or an authorization boundary. Returned by Get and List.","readOnly":true},"revision":{"type":"string","format":"int64","description":"Monotonically increasing version of this resource's mutable state.\nCompare only revisions of the same resource. Includes changes to unit_counts.\nIndependent of form and draft etags; never a mutation precondition.","readOnly":true}},"description":"WorkItem groups related occurrences that can be resolved independently.\n\nAn item is not a container a source puts things in. It is materialised by\nthis service from the work units that share the labels the workspace groups\non, so its identity is those label values.\n\nEach unit records its lifecycle independently of delivery.\nA submission settles one unit; delivery records whether the source applied it.\nOne item persists for each workspace, kind and grouping identity. New units\nattach to the same item; archived items locally dismiss new arrivals. Existing\nsubmissions and assignment survive new arrivals. Rekey never changes this identity."},"commonv1Value":{"type":"object","properties":{"null_value":{"type":"string","title":"Represents the absence of a value (None/null/undefined)"},"bool_value":{"type":"boolean","title":"Boolean true/false value"},"number":{"$ref":"#/components/schemas/v1Number"},"text":{"type":"string","title":"UTF-8 encoded text string"},"date":{"$ref":"#/components/schemas/typeDate"},"timeofday":{"$ref":"#/components/schemas/typeTimeOfDay"},"datetime":{"$ref":"#/components/schemas/typeDateTime"},"time_zone":{"$ref":"#/components/schemas/typeTimeZone"},"duration":{"type":"string","title":"Signed duration representing a span of time"},"list":{"$ref":"#/components/schemas/v1List"},"dictionary":{"$ref":"#/components/schemas/v1Dictionary"},"file":{"$ref":"#/components/schemas/v1FileValue"},"table":{"$ref":"#/components/schemas/v1TableValue"},"set":{"$ref":"#/components/schemas/v1Set"},"text_value":{"$ref":"#/components/schemas/v1TextValue"},"list_value":{"$ref":"#/components/schemas/commonv1ListValue"},"set_value":{"$ref":"#/components/schemas/v1SetValue"},"dictionary_value":{"$ref":"#/components/schemas/v1DictionaryValue"}},"description":"Represents a runtime value that can be produced by the Jarvis interpreter.\n\nThis message provides a type-safe way to serialize and transmit values between\nthe Jarvis interpreter and other services via gRPC. It supports all the basic\ndata types that can be represented in the Jarvis language runtime.\n\nThe oneof structure ensures that exactly one value type is set at a time,\nproviding both type safety and efficient serialization."},"v1Number":{"type":"object","properties":{"lo":{"type":"integer","format":"int64","description":"Low 32 bits of the 96-bit mantissa."},"mid":{"type":"integer","format":"int64","description":"Middle 32 bits of the 96-bit mantissa."},"hi":{"type":"integer","format":"int64","description":"High 32 bits of the 96-bit mantissa."},"flags":{"type":"integer","format":"int64","description":"Flags word:\n - Bits 16–23: scale (0–28)\n - Bit 31: sign (0 = positive, 1 = negative)\n - Other bits must be zero."}},"description":"A fixed-precision decimal number with up to 28 fractional digits.\n\nThis message represents decimal numbers with exact precision, avoiding\nfloating-point rounding errors. It's particularly useful for financial\ncalculations, measurements, and any scenario where exact decimal\nrepresentation is required.\n\nThe value is calculated as: m / 10^e, where:\n - m is an unsigned 96-bit integer composed of (lo, mid, hi)\n - e is the scale (0–28) stored in flags bits 16–23\n - sign is encoded in flags bit 31 (0 = positive, 1 = negative)\n\nExamples:\n - 123.45 would have m=12345, e=2\n - -0.001 would have m=1, e=3, with sign bit set\n"},"typeDate":{"type":"object","properties":{"year":{"type":"integer","format":"int32","description":"Year of the date. Must be from 1 to 9999, or 0 to specify a date without\na year."},"month":{"type":"integer","format":"int32","description":"Month of a year. Must be from 1 to 12, or 0 to specify a year without a\nmonth and day."},"day":{"type":"integer","format":"int32","description":"Day of a month. Must be from 1 to 31 and valid for the year and month, or 0\nto specify a year by itself or a year and month where the day isn't\nsignificant."}},"description":"* A full date, with non-zero year, month, and day values\n* A month and day value, with a zero year, such as an anniversary\n* A year on its own, with zero month and day values\n* A year and month value, with a zero day, such as a credit card expiration\ndate\n\nRelated types are [google.type.TimeOfDay][google.type.TimeOfDay] and\n`google.protobuf.Timestamp`.","title":"Represents a whole or partial calendar date, such as a birthday. The time of\nday and time zone are either specified elsewhere or are insignificant. The\ndate is relative to the Gregorian Calendar. This can represent one of the\nfollowing:"},"typeTimeOfDay":{"type":"object","properties":{"hours":{"type":"integer","format":"int32","description":"Hours of day in 24 hour format. Should be from 0 to 23. An API may choose\nto allow the value \"24:00:00\" for scenarios like business closing time."},"minutes":{"type":"integer","format":"int32","description":"Minutes of hour of day. Must be from 0 to 59."},"seconds":{"type":"integer","format":"int32","description":"Seconds of minutes of the time. Must normally be from 0 to 59. An API may\nallow the value 60 if it allows leap-seconds."},"nanos":{"type":"integer","format":"int32","description":"Fractions of seconds in nanoseconds. Must be from 0 to 999,999,999."}},"description":"Represents a time of day. The date and time zone are either not significant\nor are specified elsewhere. An API may choose to allow leap seconds. Related\ntypes are [google.type.Date][google.type.Date] and\n`google.protobuf.Timestamp`."},"typeDateTime":{"type":"object","properties":{"year":{"type":"integer","format":"int32","description":"Optional. Year of date. Must be from 1 to 9999, or 0 if specifying a\ndatetime without a year."},"month":{"type":"integer","format":"int32","description":"Required. Month of year. Must be from 1 to 12."},"day":{"type":"integer","format":"int32","description":"Required. Day of month. Must be from 1 to 31 and valid for the year and\nmonth."},"hours":{"type":"integer","format":"int32","description":"Required. Hours of day in 24 hour format. Should be from 0 to 23. An API\nmay choose to allow the value \"24:00:00\" for scenarios like business\nclosing time."},"minutes":{"type":"integer","format":"int32","description":"Required. Minutes of hour of day. Must be from 0 to 59."},"seconds":{"type":"integer","format":"int32","description":"Required. Seconds of minutes of the time. Must normally be from 0 to 59. An\nAPI may allow the value 60 if it allows leap-seconds."},"nanos":{"type":"integer","format":"int32","description":"Required. Fractions of seconds in nanoseconds. Must be from 0 to\n999,999,999."},"utc_offset":{"type":"string","description":"UTC offset. Must be whole seconds, between -18 hours and +18 hours.\nFor example, a UTC offset of -4:00 would be represented as\n{ seconds: -14400 }."},"time_zone":{"$ref":"#/components/schemas/typeTimeZone"}},"description":"Represents civil time (or occasionally physical time).\n\nThis type can represent a civil time in one of a few possible ways:\n\n * When utc_offset is set and time_zone is unset: a civil time on a calendar\n   day with a particular offset from UTC.\n * When time_zone is set and utc_offset is unset: a civil time on a calendar\n   day in a particular time zone.\n * When neither time_zone nor utc_offset is set: a civil time on a calendar\n   day in local time.\n\nThe date is relative to the Proleptic Gregorian Calendar.\n\nIf year is 0, the DateTime is considered not to have a specific year. month\nand day must have valid, non-zero values.\n\nThis type may also be used to represent a physical time if all the date and\ntime fields are set and either case of the `time_offset` oneof is set.\nConsider using `Timestamp` message for physical time instead. If your use\ncase also would like to store the user's timezone, that can be done in\nanother field.\n\nThis type is more flexible than some applications may want. Make sure to\ndocument and validate your application's limitations."},"typeTimeZone":{"type":"object","properties":{"id":{"type":"string","description":"IANA Time Zone Database time zone, e.g. \"America/New_York\"."},"version":{"type":"string","description":"Optional. IANA Time Zone Database version number, e.g. \"2019a\"."}},"description":"Represents a time zone from the\n[IANA Time Zone Database](https://www.iana.org/time-zones)."},"v1List":{"type":"object","properties":{"items":{"type":"array","items":{"$ref":"#/components/schemas/commonV1Value"},"title":"The ordered sequence of values in this list"}},"description":"Represents an ordered collection of values (similar to arrays or lists).\n\nThis message can contain any number of Value elements in a specific order.\nLists are mutable and can grow or shrink during runtime. Elements can be\naccessed by their zero-based index position.\n\nExamples:\n - [1, 2, 3] - list of numbers\n - [\"hello\", \"world\"] - list of strings\n - [true, 42, \"mixed\"] - list with mixed types\n - [[1, 2], [3, 4]] - nested lists"},"commonV1Value":{"type":"object","properties":{"null_value":{"type":"string","title":"Represents the absence of a value (None/null/undefined)"},"bool_value":{"type":"boolean","title":"Boolean true/false value"},"number":{"$ref":"#/components/schemas/v1Number"},"text":{"type":"string","title":"UTF-8 encoded text string"},"date":{"$ref":"#/components/schemas/typeDate"},"timeofday":{"$ref":"#/components/schemas/typeTimeOfDay"},"datetime":{"$ref":"#/components/schemas/typeDateTime"},"time_zone":{"$ref":"#/components/schemas/typeTimeZone"},"duration":{"type":"string","title":"Signed duration representing a span of time"},"list":{"$ref":"#/components/schemas/v1List"},"dictionary":{"$ref":"#/components/schemas/v1Dictionary"},"file":{"$ref":"#/components/schemas/v1FileValue"},"table":{"$ref":"#/components/schemas/v1TableValue"},"set":{"$ref":"#/components/schemas/v1Set"},"text_value":{"$ref":"#/components/schemas/v1TextValue"},"list_value":{"$ref":"#/components/schemas/commonv1ListValue"},"set_value":{"$ref":"#/components/schemas/v1SetValue"},"dictionary_value":{"$ref":"#/components/schemas/v1DictionaryValue"}},"description":"Represents a runtime value that can be produced by the Jarvis interpreter.\n\nThis message provides a type-safe way to serialize and transmit values between\nthe Jarvis interpreter and other services via gRPC. It supports all the basic\ndata types that can be represented in the Jarvis language runtime.\n\nThe oneof structure ensures that exactly one value type is set at a time,\nproviding both type safety and efficient serialization."},"v1Dictionary":{"type":"object","properties":{"entries":{"type":"array","items":{"$ref":"#/components/schemas/v1DictionaryEntry"},"title":"The key-value pairs stored in this dictionary"}},"description":"Represents a key-value mapping (similar to hash maps or dictionaries).\n\nThis message stores associations between keys and values, where keys must be\nhashable types (null, bool, Number, string, Date, TimeOfDay, DateTime, TimeZone). Keys are\nunique within a dictionary - duplicate keys will overwrite previous values.\n\nThe dictionary maintains insertion order for consistent iteration behavior.\n\nExamples:\n - {\"name\": \"John\", \"age\": 30} - string keys with mixed values\n - {1: \"one\", 2: \"two\"} - number keys with string values\n - {\"nested\": {\"inner\": \"value\"}} - nested dictionaries"},"v1DictionaryEntry":{"type":"object","properties":{"key":{"$ref":"#/components/schemas/v1HashableValue"},"value":{"$ref":"#/components/schemas/commonV1Value"}},"description":"Represents a single key-value pair within a Dictionary.\n\nBoth key and value can be any Value type, though keys should be\nhashable types for proper dictionary behavior. Non-hashable keys\n(like lists or dictionaries) may cause runtime errors."},"v1HashableValue":{"type":"object","properties":{"bool_value":{"type":"boolean","title":"Boolean true/false value"},"number":{"$ref":"#/components/schemas/v1Number"},"text":{"type":"string","title":"UTF-8 encoded text string"},"date":{"$ref":"#/components/schemas/typeDate"},"timeofday":{"$ref":"#/components/schemas/typeTimeOfDay"},"datetime":{"$ref":"#/components/schemas/typeDateTime"},"duration":{"type":"string","title":"Signed duration representing a span of time"},"text_value":{"$ref":"#/components/schemas/v1TextValue"}},"description":"Represents a hashable value that can be used as a dictionary key.\n\nThis message contains only the hashable types from the Value message,\ncorresponding to Python's hashable types. These types can be safely\nused as keys in maps and dictionaries.\n\nHashable types include: bool, Number, string, Date, TimeOfDay, DateTime\nand Duration."},"v1TextValue":{"type":"object","properties":{"remote":{"type":"string","title":"Reference to remote text content via URL or file path"},"inline":{"type":"string","title":"Text content embedded directly in the message"}},"description":"Represents a text value that can be either stored inline or referenced remotely.\n\nThis message provides flexibility for handling text strings in the Jarvis interpreter:\n- Small strings can be embedded directly using the inline option\n- Large strings can be referenced by URL using the remote option\n- The choice depends on string size, network constraints, and access patterns"},"v1FileValue":{"type":"object","properties":{"remote":{"type":"string","title":"Reference to a remote file via URL or file path"},"inline":{"$ref":"#/components/schemas/v1File"}},"description":"Represents a file value that can be either stored inline or referenced remotely.\n\nThis message provides flexibility for handling files in the Jarvis interpreter:\n- Small files can be embedded directly using the inline option\n- Large files can be referenced by URL/path using the remote option\n- The choice depends on file size, network constraints, and access patterns"},"v1File":{"type":"object","properties":{"content":{"type":"string","format":"byte","title":"The raw binary content of the file"},"name":{"type":"string","title":"The name of the file, including extension if applicable"}},"description":"Represents a file with its name and binary content.\n\nThis message contains the complete file data including both metadata\n(filename) and the actual file content as raw bytes. It's used for\nembedding files directly within messages when the file size is\nmanageable and immediate access is required.\n\nExamples:\n - Configuration files\n - Small text or binary files\n - Generated reports or documents\n - Temporary files created during execution\n"},"v1TableValue":{"type":"object","properties":{"remote":{"type":"string","title":"Reference to a remote table via URL or file path (feather-v2 format)"},"inline":{"$ref":"#/components/schemas/v1Table"}},"description":"Represents a table value that can be either stored inline or referenced remotely."},"v1Table":{"type":"object","properties":{"data":{"type":"string","format":"byte","title":"The table data serialized in feather-v2 format"}},"description":"Represents a table with data in feather-v2 format.\n\nThis message contains the complete table data serialized using the\nfeather-v2 format, which provides efficient columnar storage and\nfast serialization/deserialization for tabular data."},"v1Set":{"type":"object","properties":{"items":{"type":"array","items":{"$ref":"#/components/schemas/v1HashableValue"},"title":"The unique elements stored in this set\nAll elements must be hashable types"}},"description":"Represents an unordered collection of unique values.\n\nThis message stores a collection of unique elements, where duplicate values\nare automatically removed. Only hashable types can be stored in sets.\nSets are useful for membership testing, removing duplicates, and mathematical\nset operations like union, intersection, and difference.\n\nThe set does not maintain insertion order - elements may appear in any order\nduring iteration.\n\nExamples:\n - {1, 2, 3} - set of numbers\n - {\"apple\", \"banana\", \"cherry\"} - set of strings\n - {true, false} - set of booleans\n - {1, \"hello\", true} - set with mixed hashable types"},"commonv1ListValue":{"type":"object","properties":{"remote":{"type":"string","title":"Reference to remote list data via URL or file path"},"inline":{"$ref":"#/components/schemas/v1List"}},"description":"Represents a list value that can be either stored inline or referenced remotely.\n\nThis message provides flexibility for handling large lists:\n- Small lists can be embedded directly using the inline option\n- Large lists can be referenced by URL using the remote option"},"v1SetValue":{"type":"object","properties":{"remote":{"type":"string","title":"Reference to remote set data via URL or file path"},"inline":{"$ref":"#/components/schemas/v1Set"}},"description":"Represents a set value that can be either stored inline or referenced remotely.\n\nThis message provides flexibility for handling large sets:\n- Small sets can be embedded directly using the inline option\n- Large sets can be referenced by URL using the remote option"},"v1DictionaryValue":{"type":"object","properties":{"remote":{"type":"string","title":"Reference to remote dictionary data via URL or file path"},"inline":{"$ref":"#/components/schemas/v1Dictionary"}},"description":"Represents a dictionary value that can be either stored inline or referenced remotely.\n\nThis message provides flexibility for handling large dictionaries:\n- Small dictionaries can be embedded directly using the inline option\n- Large dictionaries can be referenced by URL using the remote option"},"v1FormSpec":{"type":"object","properties":{"fields":{"type":"array","items":{"$ref":"#/components/schemas/v1FormField"},"description":"At least one question, with unique nonempty keys. Order is the semantic\nreading sequence, not a prescribed screen layout."}},"description":"A set of typed questions for human input or source answers (R6, R13, R14).\nField types derive the returned record type. The platform selects controls\nand layout; there are no widgets, scripts, URLs, or executable expressions.\nShared human input may reference options in each unit's immutable evidence.\nWorkbench resolves those references into the unit's InputContext before use.\nSource answer forms must already be resolved. Filled values are separate messages.\nSources persist their answer form with the pending invocation for recovery.","required":["fields"]},"v1FormField":{"type":"object","properties":{"key":{"type":"string","description":"Stable record key. Unique within its field set; nonempty."},"label":{"type":"string","description":"Business-facing wording, independent of the programmatic key; nonempty."},"help_text":{"type":"string","description":"Optional guidance displayed with the question."},"value_type":{"$ref":"#/components/schemas/v1ValueType"},"initial_value":{"$ref":"#/components/schemas/commonv1Value"},"text":{"$ref":"#/components/schemas/v1TextConstraints"},"number":{"$ref":"#/components/schemas/v1NumberConstraints"},"input_spec":{"$ref":"#/components/schemas/v1InputSpec"}},"description":"One named question, its answer type and its input behavior.","required":["key","label","value_type"]},"v1ValueType":{"type":"object","properties":{"scalar_type":{"$ref":"#/components/schemas/v1ValueScalarType"},"optional_type":{"$ref":"#/components/schemas/v1ValueOptionalType"},"list_type":{"$ref":"#/components/schemas/v1ValueListType"},"dictionary_type":{"$ref":"#/components/schemas/v1ValueDictionaryType"},"table_type":{"$ref":"#/components/schemas/v1ValueTableType"},"opaque_type":{"$ref":"#/components/schemas/v1ValueOpaqueType"},"any_type":{"$ref":"#/components/schemas/v1ValueAnyType"},"union_type":{"$ref":"#/components/schemas/v1ValueUnionType"},"sensitive_type":{"$ref":"#/components/schemas/v1ValueSensitiveType"},"enum_type":{"$ref":"#/components/schemas/v1ValueEnumType"},"generic_dictionary_type":{"$ref":"#/components/schemas/v1ValueGenericDictionaryType"},"none_type":{"$ref":"#/components/schemas/v1ValueNoneType"}},"title":"Represents a complete value type definition using a discriminated union"},"v1ValueScalarType":{"type":"string","enum":["VALUE_SCALAR_TYPE_UNSPECIFIED","VALUE_SCALAR_TYPE_TEXT","VALUE_SCALAR_TYPE_NUMBER","VALUE_SCALAR_TYPE_BOOLEAN","VALUE_SCALAR_TYPE_DATETIME","VALUE_SCALAR_TYPE_DATE","VALUE_SCALAR_TYPE_TIME","VALUE_SCALAR_TYPE_FILE","VALUE_SCALAR_TYPE_TIMEDELTA"],"default":"VALUE_SCALAR_TYPE_UNSPECIFIED","description":"- VALUE_SCALAR_TYPE_UNSPECIFIED: Unspecified value type\n - VALUE_SCALAR_TYPE_TEXT: A text value type\n - VALUE_SCALAR_TYPE_NUMBER: A number value type\n - VALUE_SCALAR_TYPE_BOOLEAN: A boolean value type\n - VALUE_SCALAR_TYPE_DATETIME: A datetime value type\n - VALUE_SCALAR_TYPE_DATE: A date value type\n - VALUE_SCALAR_TYPE_TIME: A time value type\n - VALUE_SCALAR_TYPE_FILE: A file value type\n - VALUE_SCALAR_TYPE_TIMEDELTA: A timedelta value type","title":"Supported Value Scalar Types"},"v1ValueOptionalType":{"type":"object","properties":{"inner":{"$ref":"#/components/schemas/v1ValueType"}},"title":"Represents a value type that can be optional (nullable)"},"v1ValueListType":{"type":"object","properties":{"inner":{"$ref":"#/components/schemas/v1ValueType"}},"title":"Represents a list/array value type containing elements of a specific type"},"v1ValueDictionaryType":{"type":"object","properties":{"is_a":{"type":"string","title":"Semantic classification of what this dictionary represents"},"fields":{"type":"array","items":{"$ref":"#/components/schemas/v1ValueDictionaryTypeField"},"title":"The named fields contained in this dictionary"},"description":{"type":"string","title":"Optional human-readable description of this dictionary type"}},"title":"Represents a dictionary/object value type with named fields"},"v1ValueDictionaryTypeField":{"type":"object","properties":{"key":{"type":"string","title":"The name/key of this field"},"value":{"$ref":"#/components/schemas/v1ValueType"},"description":{"type":"string","title":"Optional human-readable description of this field"}},"title":"Represents a single field within a dictionary value type"},"v1ValueTableType":{"type":"object","properties":{"is_a":{"type":"string","title":"Semantic classification of what this table represents"},"columns":{"type":"array","items":{"$ref":"#/components/schemas/v1ValueTableTypeColumn"},"title":"The columns that make up this table"},"description":{"type":"string","title":"Optional human-readable description of this table type"}},"title":"Represents a table value type with structured columns"},"v1ValueTableTypeColumn":{"type":"object","properties":{"key":{"type":"string","title":"The name/key of this column"},"value":{"$ref":"#/components/schemas/v1ValueType"},"description":{"type":"string","title":"Optional human-readable description of this column"}},"title":"Represents a single column within a table value type"},"v1ValueOpaqueType":{"type":"object","properties":{"is_a":{"type":"string","title":"Semantic classification of what this opaque type represents"},"description":{"type":"string","title":"Optional human-readable description of this opaque type"}},"title":"Represents an opaque value type with semantic meaning but unknown internal structure"},"v1ValueAnyType":{"type":"object","title":"Represents a value type that can hold any kind of value"},"v1ValueUnionType":{"type":"object","properties":{"inners":{"type":"array","items":{"$ref":"#/components/schemas/v1ValueType"},"title":"The possible value types in this union"}},"title":"Represents a union value type that can be one of several possible types"},"v1ValueSensitiveType":{"type":"object","properties":{"inner":{"$ref":"#/components/schemas/v1ValueType"}},"title":"Represents a value type that contains sensitive information"},"v1ValueEnumType":{"type":"object","properties":{"is_a":{"type":"string","title":"Semantic classification of what this enum represents"},"members":{"type":"array","items":{"$ref":"#/components/schemas/v1ValueEnumTypeMember"},"title":"The available options/members of this enum"},"description":{"type":"string","title":"Optional human-readable description of this enum type"}},"title":"Represents an enumeration value type with predefined options"},"v1ValueEnumTypeMember":{"type":"object","properties":{"name":{"type":"string","title":"The programmatic name of this enum member"},"description":{"type":"string","title":"Optional human-readable description of this enum member"}},"title":"Represents a single member/option within an enum value type"},"v1ValueGenericDictionaryType":{"type":"object","properties":{"key_type":{"$ref":"#/components/schemas/v1ValueType"},"value_type":{"$ref":"#/components/schemas/v1ValueType"}},"title":"Represent a generic dictionary that can hold any entry of a particular key and value type"},"v1ValueNoneType":{"type":"object","title":"Represents a none value type that can hold no value"},"v1TextConstraints":{"type":"object","properties":{"min_length":{"type":"integer","format":"int64","description":"Unicode scalar-value counts, not bytes or UTF-16 code units. No implicit\ntrimming, normalization, pattern evaluation or text transformation."},"max_length":{"type":"integer","format":"int64","description":"Inclusive maximum length, measured in Unicode scalar values."}},"description":"Length restrictions on a text answer."},"v1NumberConstraints":{"type":"object","properties":{"minimum":{"$ref":"#/components/schemas/v1Number"},"maximum":{"$ref":"#/components/schemas/v1Number"},"integer_only":{"type":"boolean","description":"Require a value with no fractional component."}},"description":"Exact decimal restrictions on a numeric answer."},"v1InputSpec":{"type":"object","properties":{"selection":{"$ref":"#/components/schemas/v1SelectionInput"}},"description":"How a person supplies a typed answer. Concrete controls and layout belong\nto the renderer. No option carries follow-up fields or executable behavior."},"v1SelectionInput":{"type":"object","properties":{"options":{"type":"array","items":{"$ref":"#/components/schemas/v1SelectionOption"},"description":"Distinct typed values with nonempty labels. May be empty. Each value must\nsatisfy the scalar/element type and applicable field constraints. Numeric\nequality is decimal equality, so 1 and 1.0 are the same option."},"min_selections":{"type":"integer","format":"int64","description":"Only for list fields. Omitted minimum means zero; omitted maximum means the\noption count. Bounds must be ordered and, for nonempty option sets, no greater\nthan that count. Empty selections retain bounds for answer validation.\nUnknown or repeated selections fail. Persist selections in option order,\nusing the declared option values, not user click order or numeric encoding."},"max_selections":{"type":"integer","format":"int64","description":"Inclusive maximum number of selected options."},"options_ref":{"type":"string","description":"Exact nonempty top-level WorkUnit.evidence key, not a path or expression.\nAllowed only in shared human input, mutually exclusive with inline options.\nValid evidence is an inline list of distinct scalar values matching\nthe field's scalar/element type and constraints. Inline text wrappers are\nnormalized to text. No remote reads, record projections or coercion occur.\nEach value is both the displayed choice and the submitted value: text is\nunchanged, numbers use exact decimal text, booleans use true/false, and dates\nuse YYYY-MM-DD. Empty text has no display label and is invalid as an option.\nMissing, empty or invalid choices produce an empty selection, not an input\nerror or free entry. Other fields remain usable. Initial values incompatible\nwith the resolved selection are omitted for that unit."}},"description":"A finite set of offered values. A scalar field selects one value; a list\nfield selects distinct values of its element type. Optional None is absence,\nnever an option. Use inline options or options_ref, not both. Empty selections\noffer no choices and never enable free entry. Resolved unit input and source\nanswer forms use inline options only."},"v1SelectionOption":{"type":"object","properties":{"label":{"type":"string","description":"Nonempty display wording, independent of the submitted value."},"value":{"$ref":"#/components/schemas/commonv1Value"}},"description":"Display wording and the typed value returned when this option is selected.","required":["label","value"]},"v1WorkUnitStatusCount":{"type":"object","properties":{"status":{"$ref":"#/components/schemas/v1WorkUnitStatus"},"count":{"type":"integer","format":"int32","description":"Number of attached units in this status. Always nonnegative."}},"description":"WorkUnitStatusCount counts the attached units in one lifecycle status."},"v1WorkUnitStatus":{"type":"string","enum":["WORK_UNIT_STATUS_UNSPECIFIED","WORK_UNIT_STATUS_WAITING_FOR_INPUT","WORK_UNIT_STATUS_ANSWERED","WORK_UNIT_STATUS_DISMISSED","WORK_UNIT_STATUS_WITHDRAWN","WORK_UNIT_STATUS_PROCESSING"],"default":"WORK_UNIT_STATUS_UNSPECIFIED","description":"WorkUnitStatus records attention and final resolution independently of delivery.\n\n - WORK_UNIT_STATUS_UNSPECIFIED: Default value; not returned for an existing resource.\n - WORK_UNIT_STATUS_WAITING_FOR_INPUT: Waiting for intermediate input or a direct final answer: an item input_form\nexists and input is unaccepted, or no input_form exists and the kind does\nnot require preparation. Saving either draft leaves status unchanged.\n - WORK_UNIT_STATUS_ANSWERED: Final submission and its delivery obligation are durable.\n - WORK_UNIT_STATUS_DISMISSED: Locally dismissed by item archival, arrival or rekey into an archived item.\nUnarchive restores it unless the source or operator has withdrawn it.\n - WORK_UNIT_STATUS_WITHDRAWN: Source or operator ended the occurrence without an answer.\n - WORK_UNIT_STATUS_PROCESSING: Analysis or decision preparation is pending; no current human request.\nIncludes work without an input_form whose kind requires preparation, and\nfinal-answer preparation after intermediate input acceptance."},"rpcStatus":{"type":"object","properties":{"code":{"type":"integer","format":"int32"},"message":{"type":"string"},"details":{"type":"array","items":{"$ref":"#/components/schemas/protobufAny"}}}},"protobufAny":{"type":"object","properties":{"@type":{"type":"string"}},"additionalProperties":{}}}},"paths":{"/api/v1/organizations/{organization_id}/workspaces/{workspace_id}/workItems":{"get":{"summary":"List Work Items","description":"ListWorkItems lists the items in a workspace, with filtering, ordering and\npagination. Every view a surface offers is composed from this one method.\n\ninput_form is left unset on every item here to avoid repeating potentially\nlarge schemas. Surfaces rendering forms alongside queue rows fetch\nGetWorkItem for the items being reviewed.","operationId":"ListWorkItems","responses":{"200":{"description":"A successful response.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/v1ListWorkItemsResponse"}}}},"default":{"description":"An unexpected error response.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/rpcStatus"}}}}},"parameters":[{"name":"organization_id","in":"path","required":true,"schema":{"type":"string"}},{"name":"workspace_id","in":"path","required":true,"schema":{"type":"string"}},{"name":"page_size","description":"The maximum number of items to return. The service may return fewer.\nIf unspecified, at most 50 items are returned. The maximum is 1000; values\nabove 1000 are coerced to 1000.","in":"query","required":false,"schema":{"type":"integer","format":"int32"}},{"name":"page_token","description":"The page token received from a previous ListWorkItems call. When\npaginating, all other parameters must match the call that provided it.","in":"query","required":false,"schema":{"type":"string"}},{"name":"filter","description":"An AIP-160 filter expression.\n\nFilterable fields, with the operators each admits:\n\n  kind                                       =  !=\n  assignee, labels.*                         =  !=  :*\n  create_time, update_time                   =  !=  <  <=  >  >=\n\nhas_units_with_status(STATUS, ...) is true when every supplied status has\nat least one attached unit. Different units satisfy different statuses.\nAccepts one or more WorkUnitStatus names without the WORK_UNIT_STATUS_\nprefix, excluding UNSPECIFIED. Repeated statuses are deduplicated. Empty\narguments, unknown statuses and non-status expressions are INVALID_ARGUMENT.\nUse OR between calls to match either status, for example:\n  has_units_with_status(WAITING_FOR_INPUT) OR has_units_with_status(PROCESSING)\nMixed work can be selected with has_units_with_status(WAITING_FOR_INPUT, ANSWERED).\nThe function composes with AND, OR and NOT. An item with no units matches\nno positive call. Nested functions and count comparisons are unsupported.\nFiltering selects items, never narrows their returned unit_counts.\n\nAnything else is INVALID_ARGUMENT, including an ordered comparison on a\nlabel and any field not listed. Unassigned is `NOT assignee:*`.\n\nassignee takes a resource name — `users/{user_id}`, the value this API\nreturns — and a bare identifier is INVALID_ARGUMENT rather than a filter\nthat matches nothing.\n\nA label filter matches the grouping labels recorded when the item was\ncreated, not a unit's labels as they stand now; the two can differ, and\n`ListWorkUnits` is where the current ones are. `labels.k:*` matches only an\nitem whose first unit supplied k, and an item whose first unit supplied\nnone of the kind's grouping keys matches no label filter at all. An item\nwhose grouping key was omitted matches neither `labels.k = \"v\"` nor\n`labels.k != \"v\"`; use `NOT labels.k:*` for absence.\n\nA label filter names one of the kind's grouping labels, which is what an\nitem is identified by, and is served by an index. Any other label belongs\nto a unit rather than to the item: it is not projected onto the item and no\nitem filter reaches it, so such a filter selects nothing. Filter a unit's\nown labels through ListWorkUnits.","in":"query","required":false,"schema":{"type":"string"}},{"name":"order_by","description":"Comma-separated ordering by create_time or update_time, each ascending\n(asc, the default) or descending (desc). Defaults to create_time ascending,\noldest item first. Ties break by item name ascending. Other fields, including\narchive_time, unit_count and settle_time, are INVALID_ARGUMENT.","in":"query","required":false,"schema":{"type":"string"}}],"tags":["Work Items"]}}}}
```

## Get Work Item

> GetWorkItem retrieves one item: its question, the shared human-input form,\
> the labels that define it and how much it covers. Final submissions belong\
> to units; delivery outcomes are independent of unit settlement.

```json
{"openapi":"3.0.0","info":{"title":"Kognitos API","version":"1.0.0"},"tags":[{"name":"Work Items","description":"Track work items and work units that need human input."}],"servers":[{"url":"https://app.us-1.kognitos.com"}],"security":[{"BearerAuth":[]}],"components":{"securitySchemes":{"BearerAuth":{"type":"http","scheme":"bearer","description":"Personal Access Token."}},"schemas":{"v1WorkItem":{"type":"object","properties":{"name":{"type":"string","title":"The resource name of the work item.\nFormat: organizations/{organization_id}/workspaces/{workspace_id}/workItems/{work_item_id}"},"kind":{"type":"string","description":"The registered kind of work, as an opaque dotted id\n(for example \"astral.automation_exception\").\n\nThis is a string rather than an enum so that registering a kind is not a\nproto change. It is validated against the registered kind descriptors, so\nthe set is closed at runtime. No behaviour in this contract branches on it.","readOnly":true},"agg_labels":{"$ref":"#/components/schemas/commonv1Value"},"question":{"type":"string","description":"The question in business language: the summary of the unit that\nmaterialised this item, verbatim.\n\nThe pointer and source summary are fixed for the item's life. Per-unit\nquestions remain available on the units; this is a queue summary.\n\nIt is one unit's words about a set. Clients use unit_counts to show the\nnumber of occurrences relevant to their view.","readOnly":true},"assignee":{"type":"string","title":"The person this item is assigned to. The empty value means unassigned,\nwhich is an ordinary state of a queue and not a missing value.\nFormat: users/{user_id}"},"declined_by":{"type":"string","title":"The person who last handed this item back. Current state rather than\nhistory; the history is in the audit log.\nFormat: users/{user_id}","readOnly":true},"decline_reason":{"type":"string","description":"Why the item was last handed back. Current state rather than history.","readOnly":true},"create_time":{"type":"string","format":"date-time","description":"The time the item was materialised. This is the item's age.","readOnly":true},"update_time":{"type":"string","format":"date-time","description":"The time the item last changed.","readOnly":true},"input_form":{"$ref":"#/components/schemas/v1FormSpec"},"input_form_etag":{"type":"string","description":"Concurrency token for input_form, present even before the first form is set.\nChanges only when the form changes. Returned by Get and List.","readOnly":true},"archive_time":{"type":"string","format":"date-time","description":"When the item was explicitly archived. Absence means not archived.\nUnarchive clears this field. Archival locally dismisses unresolved units\nand future arrivals; answered and withdrawn units retain their outcomes.","readOnly":true},"unit_counts":{"type":"array","items":{"$ref":"#/components/schemas/v1WorkUnitStatusCount"},"description":"Counts of all attached units, independent of any ListWorkItems filter.\nReturned by Get and List. Exactly one entry for every defined WorkUnitStatus\nexcept UNSPECIFIED, including zero counts; no duplicate statuses.\nSum all entries for the total, or selected statuses for a view's count.","readOnly":true},"preparation_required":{"type":"boolean","description":"Whether the UI should offer preparation before opening chat.\nSet for preparation-enabled kinds when unresolved membership changes from\nzero to nonzero, including initial arrival, unarchive and rekey. Further\narrivals while unresolved units remain do not set it again. Suppress the\ngate when no unresolved units remain, regardless of this stored flag.\nMarkWorkItemPreparationStarted clears it after Rain accepts a prompt.\nAutomatic invocation also clears it on message acceptance while its unit\nstill belongs to the item and the item is not archived.\nClearing this flag does not change unit status or indicate preparation has\nfinished. This is not execution state or an authorization boundary. Returned by Get and List.","readOnly":true},"revision":{"type":"string","format":"int64","description":"Monotonically increasing version of this resource's mutable state.\nCompare only revisions of the same resource. Includes changes to unit_counts.\nIndependent of form and draft etags; never a mutation precondition.","readOnly":true}},"description":"WorkItem groups related occurrences that can be resolved independently.\n\nAn item is not a container a source puts things in. It is materialised by\nthis service from the work units that share the labels the workspace groups\non, so its identity is those label values.\n\nEach unit records its lifecycle independently of delivery.\nA submission settles one unit; delivery records whether the source applied it.\nOne item persists for each workspace, kind and grouping identity. New units\nattach to the same item; archived items locally dismiss new arrivals. Existing\nsubmissions and assignment survive new arrivals. Rekey never changes this identity."},"commonv1Value":{"type":"object","properties":{"null_value":{"type":"string","title":"Represents the absence of a value (None/null/undefined)"},"bool_value":{"type":"boolean","title":"Boolean true/false value"},"number":{"$ref":"#/components/schemas/v1Number"},"text":{"type":"string","title":"UTF-8 encoded text string"},"date":{"$ref":"#/components/schemas/typeDate"},"timeofday":{"$ref":"#/components/schemas/typeTimeOfDay"},"datetime":{"$ref":"#/components/schemas/typeDateTime"},"time_zone":{"$ref":"#/components/schemas/typeTimeZone"},"duration":{"type":"string","title":"Signed duration representing a span of time"},"list":{"$ref":"#/components/schemas/v1List"},"dictionary":{"$ref":"#/components/schemas/v1Dictionary"},"file":{"$ref":"#/components/schemas/v1FileValue"},"table":{"$ref":"#/components/schemas/v1TableValue"},"set":{"$ref":"#/components/schemas/v1Set"},"text_value":{"$ref":"#/components/schemas/v1TextValue"},"list_value":{"$ref":"#/components/schemas/commonv1ListValue"},"set_value":{"$ref":"#/components/schemas/v1SetValue"},"dictionary_value":{"$ref":"#/components/schemas/v1DictionaryValue"}},"description":"Represents a runtime value that can be produced by the Jarvis interpreter.\n\nThis message provides a type-safe way to serialize and transmit values between\nthe Jarvis interpreter and other services via gRPC. It supports all the basic\ndata types that can be represented in the Jarvis language runtime.\n\nThe oneof structure ensures that exactly one value type is set at a time,\nproviding both type safety and efficient serialization."},"v1Number":{"type":"object","properties":{"lo":{"type":"integer","format":"int64","description":"Low 32 bits of the 96-bit mantissa."},"mid":{"type":"integer","format":"int64","description":"Middle 32 bits of the 96-bit mantissa."},"hi":{"type":"integer","format":"int64","description":"High 32 bits of the 96-bit mantissa."},"flags":{"type":"integer","format":"int64","description":"Flags word:\n - Bits 16–23: scale (0–28)\n - Bit 31: sign (0 = positive, 1 = negative)\n - Other bits must be zero."}},"description":"A fixed-precision decimal number with up to 28 fractional digits.\n\nThis message represents decimal numbers with exact precision, avoiding\nfloating-point rounding errors. It's particularly useful for financial\ncalculations, measurements, and any scenario where exact decimal\nrepresentation is required.\n\nThe value is calculated as: m / 10^e, where:\n - m is an unsigned 96-bit integer composed of (lo, mid, hi)\n - e is the scale (0–28) stored in flags bits 16–23\n - sign is encoded in flags bit 31 (0 = positive, 1 = negative)\n\nExamples:\n - 123.45 would have m=12345, e=2\n - -0.001 would have m=1, e=3, with sign bit set\n"},"typeDate":{"type":"object","properties":{"year":{"type":"integer","format":"int32","description":"Year of the date. Must be from 1 to 9999, or 0 to specify a date without\na year."},"month":{"type":"integer","format":"int32","description":"Month of a year. Must be from 1 to 12, or 0 to specify a year without a\nmonth and day."},"day":{"type":"integer","format":"int32","description":"Day of a month. Must be from 1 to 31 and valid for the year and month, or 0\nto specify a year by itself or a year and month where the day isn't\nsignificant."}},"description":"* A full date, with non-zero year, month, and day values\n* A month and day value, with a zero year, such as an anniversary\n* A year on its own, with zero month and day values\n* A year and month value, with a zero day, such as a credit card expiration\ndate\n\nRelated types are [google.type.TimeOfDay][google.type.TimeOfDay] and\n`google.protobuf.Timestamp`.","title":"Represents a whole or partial calendar date, such as a birthday. The time of\nday and time zone are either specified elsewhere or are insignificant. The\ndate is relative to the Gregorian Calendar. This can represent one of the\nfollowing:"},"typeTimeOfDay":{"type":"object","properties":{"hours":{"type":"integer","format":"int32","description":"Hours of day in 24 hour format. Should be from 0 to 23. An API may choose\nto allow the value \"24:00:00\" for scenarios like business closing time."},"minutes":{"type":"integer","format":"int32","description":"Minutes of hour of day. Must be from 0 to 59."},"seconds":{"type":"integer","format":"int32","description":"Seconds of minutes of the time. Must normally be from 0 to 59. An API may\nallow the value 60 if it allows leap-seconds."},"nanos":{"type":"integer","format":"int32","description":"Fractions of seconds in nanoseconds. Must be from 0 to 999,999,999."}},"description":"Represents a time of day. The date and time zone are either not significant\nor are specified elsewhere. An API may choose to allow leap seconds. Related\ntypes are [google.type.Date][google.type.Date] and\n`google.protobuf.Timestamp`."},"typeDateTime":{"type":"object","properties":{"year":{"type":"integer","format":"int32","description":"Optional. Year of date. Must be from 1 to 9999, or 0 if specifying a\ndatetime without a year."},"month":{"type":"integer","format":"int32","description":"Required. Month of year. Must be from 1 to 12."},"day":{"type":"integer","format":"int32","description":"Required. Day of month. Must be from 1 to 31 and valid for the year and\nmonth."},"hours":{"type":"integer","format":"int32","description":"Required. Hours of day in 24 hour format. Should be from 0 to 23. An API\nmay choose to allow the value \"24:00:00\" for scenarios like business\nclosing time."},"minutes":{"type":"integer","format":"int32","description":"Required. Minutes of hour of day. Must be from 0 to 59."},"seconds":{"type":"integer","format":"int32","description":"Required. Seconds of minutes of the time. Must normally be from 0 to 59. An\nAPI may allow the value 60 if it allows leap-seconds."},"nanos":{"type":"integer","format":"int32","description":"Required. Fractions of seconds in nanoseconds. Must be from 0 to\n999,999,999."},"utc_offset":{"type":"string","description":"UTC offset. Must be whole seconds, between -18 hours and +18 hours.\nFor example, a UTC offset of -4:00 would be represented as\n{ seconds: -14400 }."},"time_zone":{"$ref":"#/components/schemas/typeTimeZone"}},"description":"Represents civil time (or occasionally physical time).\n\nThis type can represent a civil time in one of a few possible ways:\n\n * When utc_offset is set and time_zone is unset: a civil time on a calendar\n   day with a particular offset from UTC.\n * When time_zone is set and utc_offset is unset: a civil time on a calendar\n   day in a particular time zone.\n * When neither time_zone nor utc_offset is set: a civil time on a calendar\n   day in local time.\n\nThe date is relative to the Proleptic Gregorian Calendar.\n\nIf year is 0, the DateTime is considered not to have a specific year. month\nand day must have valid, non-zero values.\n\nThis type may also be used to represent a physical time if all the date and\ntime fields are set and either case of the `time_offset` oneof is set.\nConsider using `Timestamp` message for physical time instead. If your use\ncase also would like to store the user's timezone, that can be done in\nanother field.\n\nThis type is more flexible than some applications may want. Make sure to\ndocument and validate your application's limitations."},"typeTimeZone":{"type":"object","properties":{"id":{"type":"string","description":"IANA Time Zone Database time zone, e.g. \"America/New_York\"."},"version":{"type":"string","description":"Optional. IANA Time Zone Database version number, e.g. \"2019a\"."}},"description":"Represents a time zone from the\n[IANA Time Zone Database](https://www.iana.org/time-zones)."},"v1List":{"type":"object","properties":{"items":{"type":"array","items":{"$ref":"#/components/schemas/commonV1Value"},"title":"The ordered sequence of values in this list"}},"description":"Represents an ordered collection of values (similar to arrays or lists).\n\nThis message can contain any number of Value elements in a specific order.\nLists are mutable and can grow or shrink during runtime. Elements can be\naccessed by their zero-based index position.\n\nExamples:\n - [1, 2, 3] - list of numbers\n - [\"hello\", \"world\"] - list of strings\n - [true, 42, \"mixed\"] - list with mixed types\n - [[1, 2], [3, 4]] - nested lists"},"commonV1Value":{"type":"object","properties":{"null_value":{"type":"string","title":"Represents the absence of a value (None/null/undefined)"},"bool_value":{"type":"boolean","title":"Boolean true/false value"},"number":{"$ref":"#/components/schemas/v1Number"},"text":{"type":"string","title":"UTF-8 encoded text string"},"date":{"$ref":"#/components/schemas/typeDate"},"timeofday":{"$ref":"#/components/schemas/typeTimeOfDay"},"datetime":{"$ref":"#/components/schemas/typeDateTime"},"time_zone":{"$ref":"#/components/schemas/typeTimeZone"},"duration":{"type":"string","title":"Signed duration representing a span of time"},"list":{"$ref":"#/components/schemas/v1List"},"dictionary":{"$ref":"#/components/schemas/v1Dictionary"},"file":{"$ref":"#/components/schemas/v1FileValue"},"table":{"$ref":"#/components/schemas/v1TableValue"},"set":{"$ref":"#/components/schemas/v1Set"},"text_value":{"$ref":"#/components/schemas/v1TextValue"},"list_value":{"$ref":"#/components/schemas/commonv1ListValue"},"set_value":{"$ref":"#/components/schemas/v1SetValue"},"dictionary_value":{"$ref":"#/components/schemas/v1DictionaryValue"}},"description":"Represents a runtime value that can be produced by the Jarvis interpreter.\n\nThis message provides a type-safe way to serialize and transmit values between\nthe Jarvis interpreter and other services via gRPC. It supports all the basic\ndata types that can be represented in the Jarvis language runtime.\n\nThe oneof structure ensures that exactly one value type is set at a time,\nproviding both type safety and efficient serialization."},"v1Dictionary":{"type":"object","properties":{"entries":{"type":"array","items":{"$ref":"#/components/schemas/v1DictionaryEntry"},"title":"The key-value pairs stored in this dictionary"}},"description":"Represents a key-value mapping (similar to hash maps or dictionaries).\n\nThis message stores associations between keys and values, where keys must be\nhashable types (null, bool, Number, string, Date, TimeOfDay, DateTime, TimeZone). Keys are\nunique within a dictionary - duplicate keys will overwrite previous values.\n\nThe dictionary maintains insertion order for consistent iteration behavior.\n\nExamples:\n - {\"name\": \"John\", \"age\": 30} - string keys with mixed values\n - {1: \"one\", 2: \"two\"} - number keys with string values\n - {\"nested\": {\"inner\": \"value\"}} - nested dictionaries"},"v1DictionaryEntry":{"type":"object","properties":{"key":{"$ref":"#/components/schemas/v1HashableValue"},"value":{"$ref":"#/components/schemas/commonV1Value"}},"description":"Represents a single key-value pair within a Dictionary.\n\nBoth key and value can be any Value type, though keys should be\nhashable types for proper dictionary behavior. Non-hashable keys\n(like lists or dictionaries) may cause runtime errors."},"v1HashableValue":{"type":"object","properties":{"bool_value":{"type":"boolean","title":"Boolean true/false value"},"number":{"$ref":"#/components/schemas/v1Number"},"text":{"type":"string","title":"UTF-8 encoded text string"},"date":{"$ref":"#/components/schemas/typeDate"},"timeofday":{"$ref":"#/components/schemas/typeTimeOfDay"},"datetime":{"$ref":"#/components/schemas/typeDateTime"},"duration":{"type":"string","title":"Signed duration representing a span of time"},"text_value":{"$ref":"#/components/schemas/v1TextValue"}},"description":"Represents a hashable value that can be used as a dictionary key.\n\nThis message contains only the hashable types from the Value message,\ncorresponding to Python's hashable types. These types can be safely\nused as keys in maps and dictionaries.\n\nHashable types include: bool, Number, string, Date, TimeOfDay, DateTime\nand Duration."},"v1TextValue":{"type":"object","properties":{"remote":{"type":"string","title":"Reference to remote text content via URL or file path"},"inline":{"type":"string","title":"Text content embedded directly in the message"}},"description":"Represents a text value that can be either stored inline or referenced remotely.\n\nThis message provides flexibility for handling text strings in the Jarvis interpreter:\n- Small strings can be embedded directly using the inline option\n- Large strings can be referenced by URL using the remote option\n- The choice depends on string size, network constraints, and access patterns"},"v1FileValue":{"type":"object","properties":{"remote":{"type":"string","title":"Reference to a remote file via URL or file path"},"inline":{"$ref":"#/components/schemas/v1File"}},"description":"Represents a file value that can be either stored inline or referenced remotely.\n\nThis message provides flexibility for handling files in the Jarvis interpreter:\n- Small files can be embedded directly using the inline option\n- Large files can be referenced by URL/path using the remote option\n- The choice depends on file size, network constraints, and access patterns"},"v1File":{"type":"object","properties":{"content":{"type":"string","format":"byte","title":"The raw binary content of the file"},"name":{"type":"string","title":"The name of the file, including extension if applicable"}},"description":"Represents a file with its name and binary content.\n\nThis message contains the complete file data including both metadata\n(filename) and the actual file content as raw bytes. It's used for\nembedding files directly within messages when the file size is\nmanageable and immediate access is required.\n\nExamples:\n - Configuration files\n - Small text or binary files\n - Generated reports or documents\n - Temporary files created during execution\n"},"v1TableValue":{"type":"object","properties":{"remote":{"type":"string","title":"Reference to a remote table via URL or file path (feather-v2 format)"},"inline":{"$ref":"#/components/schemas/v1Table"}},"description":"Represents a table value that can be either stored inline or referenced remotely."},"v1Table":{"type":"object","properties":{"data":{"type":"string","format":"byte","title":"The table data serialized in feather-v2 format"}},"description":"Represents a table with data in feather-v2 format.\n\nThis message contains the complete table data serialized using the\nfeather-v2 format, which provides efficient columnar storage and\nfast serialization/deserialization for tabular data."},"v1Set":{"type":"object","properties":{"items":{"type":"array","items":{"$ref":"#/components/schemas/v1HashableValue"},"title":"The unique elements stored in this set\nAll elements must be hashable types"}},"description":"Represents an unordered collection of unique values.\n\nThis message stores a collection of unique elements, where duplicate values\nare automatically removed. Only hashable types can be stored in sets.\nSets are useful for membership testing, removing duplicates, and mathematical\nset operations like union, intersection, and difference.\n\nThe set does not maintain insertion order - elements may appear in any order\nduring iteration.\n\nExamples:\n - {1, 2, 3} - set of numbers\n - {\"apple\", \"banana\", \"cherry\"} - set of strings\n - {true, false} - set of booleans\n - {1, \"hello\", true} - set with mixed hashable types"},"commonv1ListValue":{"type":"object","properties":{"remote":{"type":"string","title":"Reference to remote list data via URL or file path"},"inline":{"$ref":"#/components/schemas/v1List"}},"description":"Represents a list value that can be either stored inline or referenced remotely.\n\nThis message provides flexibility for handling large lists:\n- Small lists can be embedded directly using the inline option\n- Large lists can be referenced by URL using the remote option"},"v1SetValue":{"type":"object","properties":{"remote":{"type":"string","title":"Reference to remote set data via URL or file path"},"inline":{"$ref":"#/components/schemas/v1Set"}},"description":"Represents a set value that can be either stored inline or referenced remotely.\n\nThis message provides flexibility for handling large sets:\n- Small sets can be embedded directly using the inline option\n- Large sets can be referenced by URL using the remote option"},"v1DictionaryValue":{"type":"object","properties":{"remote":{"type":"string","title":"Reference to remote dictionary data via URL or file path"},"inline":{"$ref":"#/components/schemas/v1Dictionary"}},"description":"Represents a dictionary value that can be either stored inline or referenced remotely.\n\nThis message provides flexibility for handling large dictionaries:\n- Small dictionaries can be embedded directly using the inline option\n- Large dictionaries can be referenced by URL using the remote option"},"v1FormSpec":{"type":"object","properties":{"fields":{"type":"array","items":{"$ref":"#/components/schemas/v1FormField"},"description":"At least one question, with unique nonempty keys. Order is the semantic\nreading sequence, not a prescribed screen layout."}},"description":"A set of typed questions for human input or source answers (R6, R13, R14).\nField types derive the returned record type. The platform selects controls\nand layout; there are no widgets, scripts, URLs, or executable expressions.\nShared human input may reference options in each unit's immutable evidence.\nWorkbench resolves those references into the unit's InputContext before use.\nSource answer forms must already be resolved. Filled values are separate messages.\nSources persist their answer form with the pending invocation for recovery.","required":["fields"]},"v1FormField":{"type":"object","properties":{"key":{"type":"string","description":"Stable record key. Unique within its field set; nonempty."},"label":{"type":"string","description":"Business-facing wording, independent of the programmatic key; nonempty."},"help_text":{"type":"string","description":"Optional guidance displayed with the question."},"value_type":{"$ref":"#/components/schemas/v1ValueType"},"initial_value":{"$ref":"#/components/schemas/commonv1Value"},"text":{"$ref":"#/components/schemas/v1TextConstraints"},"number":{"$ref":"#/components/schemas/v1NumberConstraints"},"input_spec":{"$ref":"#/components/schemas/v1InputSpec"}},"description":"One named question, its answer type and its input behavior.","required":["key","label","value_type"]},"v1ValueType":{"type":"object","properties":{"scalar_type":{"$ref":"#/components/schemas/v1ValueScalarType"},"optional_type":{"$ref":"#/components/schemas/v1ValueOptionalType"},"list_type":{"$ref":"#/components/schemas/v1ValueListType"},"dictionary_type":{"$ref":"#/components/schemas/v1ValueDictionaryType"},"table_type":{"$ref":"#/components/schemas/v1ValueTableType"},"opaque_type":{"$ref":"#/components/schemas/v1ValueOpaqueType"},"any_type":{"$ref":"#/components/schemas/v1ValueAnyType"},"union_type":{"$ref":"#/components/schemas/v1ValueUnionType"},"sensitive_type":{"$ref":"#/components/schemas/v1ValueSensitiveType"},"enum_type":{"$ref":"#/components/schemas/v1ValueEnumType"},"generic_dictionary_type":{"$ref":"#/components/schemas/v1ValueGenericDictionaryType"},"none_type":{"$ref":"#/components/schemas/v1ValueNoneType"}},"title":"Represents a complete value type definition using a discriminated union"},"v1ValueScalarType":{"type":"string","enum":["VALUE_SCALAR_TYPE_UNSPECIFIED","VALUE_SCALAR_TYPE_TEXT","VALUE_SCALAR_TYPE_NUMBER","VALUE_SCALAR_TYPE_BOOLEAN","VALUE_SCALAR_TYPE_DATETIME","VALUE_SCALAR_TYPE_DATE","VALUE_SCALAR_TYPE_TIME","VALUE_SCALAR_TYPE_FILE","VALUE_SCALAR_TYPE_TIMEDELTA"],"default":"VALUE_SCALAR_TYPE_UNSPECIFIED","description":"- VALUE_SCALAR_TYPE_UNSPECIFIED: Unspecified value type\n - VALUE_SCALAR_TYPE_TEXT: A text value type\n - VALUE_SCALAR_TYPE_NUMBER: A number value type\n - VALUE_SCALAR_TYPE_BOOLEAN: A boolean value type\n - VALUE_SCALAR_TYPE_DATETIME: A datetime value type\n - VALUE_SCALAR_TYPE_DATE: A date value type\n - VALUE_SCALAR_TYPE_TIME: A time value type\n - VALUE_SCALAR_TYPE_FILE: A file value type\n - VALUE_SCALAR_TYPE_TIMEDELTA: A timedelta value type","title":"Supported Value Scalar Types"},"v1ValueOptionalType":{"type":"object","properties":{"inner":{"$ref":"#/components/schemas/v1ValueType"}},"title":"Represents a value type that can be optional (nullable)"},"v1ValueListType":{"type":"object","properties":{"inner":{"$ref":"#/components/schemas/v1ValueType"}},"title":"Represents a list/array value type containing elements of a specific type"},"v1ValueDictionaryType":{"type":"object","properties":{"is_a":{"type":"string","title":"Semantic classification of what this dictionary represents"},"fields":{"type":"array","items":{"$ref":"#/components/schemas/v1ValueDictionaryTypeField"},"title":"The named fields contained in this dictionary"},"description":{"type":"string","title":"Optional human-readable description of this dictionary type"}},"title":"Represents a dictionary/object value type with named fields"},"v1ValueDictionaryTypeField":{"type":"object","properties":{"key":{"type":"string","title":"The name/key of this field"},"value":{"$ref":"#/components/schemas/v1ValueType"},"description":{"type":"string","title":"Optional human-readable description of this field"}},"title":"Represents a single field within a dictionary value type"},"v1ValueTableType":{"type":"object","properties":{"is_a":{"type":"string","title":"Semantic classification of what this table represents"},"columns":{"type":"array","items":{"$ref":"#/components/schemas/v1ValueTableTypeColumn"},"title":"The columns that make up this table"},"description":{"type":"string","title":"Optional human-readable description of this table type"}},"title":"Represents a table value type with structured columns"},"v1ValueTableTypeColumn":{"type":"object","properties":{"key":{"type":"string","title":"The name/key of this column"},"value":{"$ref":"#/components/schemas/v1ValueType"},"description":{"type":"string","title":"Optional human-readable description of this column"}},"title":"Represents a single column within a table value type"},"v1ValueOpaqueType":{"type":"object","properties":{"is_a":{"type":"string","title":"Semantic classification of what this opaque type represents"},"description":{"type":"string","title":"Optional human-readable description of this opaque type"}},"title":"Represents an opaque value type with semantic meaning but unknown internal structure"},"v1ValueAnyType":{"type":"object","title":"Represents a value type that can hold any kind of value"},"v1ValueUnionType":{"type":"object","properties":{"inners":{"type":"array","items":{"$ref":"#/components/schemas/v1ValueType"},"title":"The possible value types in this union"}},"title":"Represents a union value type that can be one of several possible types"},"v1ValueSensitiveType":{"type":"object","properties":{"inner":{"$ref":"#/components/schemas/v1ValueType"}},"title":"Represents a value type that contains sensitive information"},"v1ValueEnumType":{"type":"object","properties":{"is_a":{"type":"string","title":"Semantic classification of what this enum represents"},"members":{"type":"array","items":{"$ref":"#/components/schemas/v1ValueEnumTypeMember"},"title":"The available options/members of this enum"},"description":{"type":"string","title":"Optional human-readable description of this enum type"}},"title":"Represents an enumeration value type with predefined options"},"v1ValueEnumTypeMember":{"type":"object","properties":{"name":{"type":"string","title":"The programmatic name of this enum member"},"description":{"type":"string","title":"Optional human-readable description of this enum member"}},"title":"Represents a single member/option within an enum value type"},"v1ValueGenericDictionaryType":{"type":"object","properties":{"key_type":{"$ref":"#/components/schemas/v1ValueType"},"value_type":{"$ref":"#/components/schemas/v1ValueType"}},"title":"Represent a generic dictionary that can hold any entry of a particular key and value type"},"v1ValueNoneType":{"type":"object","title":"Represents a none value type that can hold no value"},"v1TextConstraints":{"type":"object","properties":{"min_length":{"type":"integer","format":"int64","description":"Unicode scalar-value counts, not bytes or UTF-16 code units. No implicit\ntrimming, normalization, pattern evaluation or text transformation."},"max_length":{"type":"integer","format":"int64","description":"Inclusive maximum length, measured in Unicode scalar values."}},"description":"Length restrictions on a text answer."},"v1NumberConstraints":{"type":"object","properties":{"minimum":{"$ref":"#/components/schemas/v1Number"},"maximum":{"$ref":"#/components/schemas/v1Number"},"integer_only":{"type":"boolean","description":"Require a value with no fractional component."}},"description":"Exact decimal restrictions on a numeric answer."},"v1InputSpec":{"type":"object","properties":{"selection":{"$ref":"#/components/schemas/v1SelectionInput"}},"description":"How a person supplies a typed answer. Concrete controls and layout belong\nto the renderer. No option carries follow-up fields or executable behavior."},"v1SelectionInput":{"type":"object","properties":{"options":{"type":"array","items":{"$ref":"#/components/schemas/v1SelectionOption"},"description":"Distinct typed values with nonempty labels. May be empty. Each value must\nsatisfy the scalar/element type and applicable field constraints. Numeric\nequality is decimal equality, so 1 and 1.0 are the same option."},"min_selections":{"type":"integer","format":"int64","description":"Only for list fields. Omitted minimum means zero; omitted maximum means the\noption count. Bounds must be ordered and, for nonempty option sets, no greater\nthan that count. Empty selections retain bounds for answer validation.\nUnknown or repeated selections fail. Persist selections in option order,\nusing the declared option values, not user click order or numeric encoding."},"max_selections":{"type":"integer","format":"int64","description":"Inclusive maximum number of selected options."},"options_ref":{"type":"string","description":"Exact nonempty top-level WorkUnit.evidence key, not a path or expression.\nAllowed only in shared human input, mutually exclusive with inline options.\nValid evidence is an inline list of distinct scalar values matching\nthe field's scalar/element type and constraints. Inline text wrappers are\nnormalized to text. No remote reads, record projections or coercion occur.\nEach value is both the displayed choice and the submitted value: text is\nunchanged, numbers use exact decimal text, booleans use true/false, and dates\nuse YYYY-MM-DD. Empty text has no display label and is invalid as an option.\nMissing, empty or invalid choices produce an empty selection, not an input\nerror or free entry. Other fields remain usable. Initial values incompatible\nwith the resolved selection are omitted for that unit."}},"description":"A finite set of offered values. A scalar field selects one value; a list\nfield selects distinct values of its element type. Optional None is absence,\nnever an option. Use inline options or options_ref, not both. Empty selections\noffer no choices and never enable free entry. Resolved unit input and source\nanswer forms use inline options only."},"v1SelectionOption":{"type":"object","properties":{"label":{"type":"string","description":"Nonempty display wording, independent of the submitted value."},"value":{"$ref":"#/components/schemas/commonv1Value"}},"description":"Display wording and the typed value returned when this option is selected.","required":["label","value"]},"v1WorkUnitStatusCount":{"type":"object","properties":{"status":{"$ref":"#/components/schemas/v1WorkUnitStatus"},"count":{"type":"integer","format":"int32","description":"Number of attached units in this status. Always nonnegative."}},"description":"WorkUnitStatusCount counts the attached units in one lifecycle status."},"v1WorkUnitStatus":{"type":"string","enum":["WORK_UNIT_STATUS_UNSPECIFIED","WORK_UNIT_STATUS_WAITING_FOR_INPUT","WORK_UNIT_STATUS_ANSWERED","WORK_UNIT_STATUS_DISMISSED","WORK_UNIT_STATUS_WITHDRAWN","WORK_UNIT_STATUS_PROCESSING"],"default":"WORK_UNIT_STATUS_UNSPECIFIED","description":"WorkUnitStatus records attention and final resolution independently of delivery.\n\n - WORK_UNIT_STATUS_UNSPECIFIED: Default value; not returned for an existing resource.\n - WORK_UNIT_STATUS_WAITING_FOR_INPUT: Waiting for intermediate input or a direct final answer: an item input_form\nexists and input is unaccepted, or no input_form exists and the kind does\nnot require preparation. Saving either draft leaves status unchanged.\n - WORK_UNIT_STATUS_ANSWERED: Final submission and its delivery obligation are durable.\n - WORK_UNIT_STATUS_DISMISSED: Locally dismissed by item archival, arrival or rekey into an archived item.\nUnarchive restores it unless the source or operator has withdrawn it.\n - WORK_UNIT_STATUS_WITHDRAWN: Source or operator ended the occurrence without an answer.\n - WORK_UNIT_STATUS_PROCESSING: Analysis or decision preparation is pending; no current human request.\nIncludes work without an input_form whose kind requires preparation, and\nfinal-answer preparation after intermediate input acceptance."},"rpcStatus":{"type":"object","properties":{"code":{"type":"integer","format":"int32"},"message":{"type":"string"},"details":{"type":"array","items":{"$ref":"#/components/schemas/protobufAny"}}}},"protobufAny":{"type":"object","properties":{"@type":{"type":"string"}},"additionalProperties":{}}}},"paths":{"/api/v1/organizations/{organization_id}/workspaces/{workspace_id}/workItems/{work_item_id}":{"get":{"summary":"Get Work Item","description":"GetWorkItem retrieves one item: its question, the shared human-input form,\nthe labels that define it and how much it covers. Final submissions belong\nto units; delivery outcomes are independent of unit settlement.","operationId":"GetWorkItem","responses":{"200":{"description":"A successful response.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/v1WorkItem"}}}},"default":{"description":"An unexpected error response.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/rpcStatus"}}}}},"parameters":[{"name":"organization_id","in":"path","required":true,"schema":{"type":"string"}},{"name":"workspace_id","in":"path","required":true,"schema":{"type":"string"}},{"name":"work_item_id","in":"path","required":true,"schema":{"type":"string"}}],"tags":["Work Items"]}}}}
```

## Archive Work Item

> ArchiveWorkItem archives a persistent item and locally dismisses its\
> unresolved units. New arrivals and units rekeyed into it are also dismissed.\
> Requires a dismissible kind; items without unresolved units may be archived. Answered and\
> withdrawn units retain their outcomes. Assignment is unchanged.\
> No source decision or delivery is created; archival controls attention only.

```json
{"openapi":"3.0.0","info":{"title":"Kognitos API","version":"1.0.0"},"tags":[{"name":"Work Items","description":"Track work items and work units that need human input."}],"servers":[{"url":"https://app.us-1.kognitos.com"}],"security":[{"BearerAuth":[]}],"components":{"securitySchemes":{"BearerAuth":{"type":"http","scheme":"bearer","description":"Personal Access Token."}},"schemas":{"v1WorkItem":{"type":"object","properties":{"name":{"type":"string","title":"The resource name of the work item.\nFormat: organizations/{organization_id}/workspaces/{workspace_id}/workItems/{work_item_id}"},"kind":{"type":"string","description":"The registered kind of work, as an opaque dotted id\n(for example \"astral.automation_exception\").\n\nThis is a string rather than an enum so that registering a kind is not a\nproto change. It is validated against the registered kind descriptors, so\nthe set is closed at runtime. No behaviour in this contract branches on it.","readOnly":true},"agg_labels":{"$ref":"#/components/schemas/commonv1Value"},"question":{"type":"string","description":"The question in business language: the summary of the unit that\nmaterialised this item, verbatim.\n\nThe pointer and source summary are fixed for the item's life. Per-unit\nquestions remain available on the units; this is a queue summary.\n\nIt is one unit's words about a set. Clients use unit_counts to show the\nnumber of occurrences relevant to their view.","readOnly":true},"assignee":{"type":"string","title":"The person this item is assigned to. The empty value means unassigned,\nwhich is an ordinary state of a queue and not a missing value.\nFormat: users/{user_id}"},"declined_by":{"type":"string","title":"The person who last handed this item back. Current state rather than\nhistory; the history is in the audit log.\nFormat: users/{user_id}","readOnly":true},"decline_reason":{"type":"string","description":"Why the item was last handed back. Current state rather than history.","readOnly":true},"create_time":{"type":"string","format":"date-time","description":"The time the item was materialised. This is the item's age.","readOnly":true},"update_time":{"type":"string","format":"date-time","description":"The time the item last changed.","readOnly":true},"input_form":{"$ref":"#/components/schemas/v1FormSpec"},"input_form_etag":{"type":"string","description":"Concurrency token for input_form, present even before the first form is set.\nChanges only when the form changes. Returned by Get and List.","readOnly":true},"archive_time":{"type":"string","format":"date-time","description":"When the item was explicitly archived. Absence means not archived.\nUnarchive clears this field. Archival locally dismisses unresolved units\nand future arrivals; answered and withdrawn units retain their outcomes.","readOnly":true},"unit_counts":{"type":"array","items":{"$ref":"#/components/schemas/v1WorkUnitStatusCount"},"description":"Counts of all attached units, independent of any ListWorkItems filter.\nReturned by Get and List. Exactly one entry for every defined WorkUnitStatus\nexcept UNSPECIFIED, including zero counts; no duplicate statuses.\nSum all entries for the total, or selected statuses for a view's count.","readOnly":true},"preparation_required":{"type":"boolean","description":"Whether the UI should offer preparation before opening chat.\nSet for preparation-enabled kinds when unresolved membership changes from\nzero to nonzero, including initial arrival, unarchive and rekey. Further\narrivals while unresolved units remain do not set it again. Suppress the\ngate when no unresolved units remain, regardless of this stored flag.\nMarkWorkItemPreparationStarted clears it after Rain accepts a prompt.\nAutomatic invocation also clears it on message acceptance while its unit\nstill belongs to the item and the item is not archived.\nClearing this flag does not change unit status or indicate preparation has\nfinished. This is not execution state or an authorization boundary. Returned by Get and List.","readOnly":true},"revision":{"type":"string","format":"int64","description":"Monotonically increasing version of this resource's mutable state.\nCompare only revisions of the same resource. Includes changes to unit_counts.\nIndependent of form and draft etags; never a mutation precondition.","readOnly":true}},"description":"WorkItem groups related occurrences that can be resolved independently.\n\nAn item is not a container a source puts things in. It is materialised by\nthis service from the work units that share the labels the workspace groups\non, so its identity is those label values.\n\nEach unit records its lifecycle independently of delivery.\nA submission settles one unit; delivery records whether the source applied it.\nOne item persists for each workspace, kind and grouping identity. New units\nattach to the same item; archived items locally dismiss new arrivals. Existing\nsubmissions and assignment survive new arrivals. Rekey never changes this identity."},"commonv1Value":{"type":"object","properties":{"null_value":{"type":"string","title":"Represents the absence of a value (None/null/undefined)"},"bool_value":{"type":"boolean","title":"Boolean true/false value"},"number":{"$ref":"#/components/schemas/v1Number"},"text":{"type":"string","title":"UTF-8 encoded text string"},"date":{"$ref":"#/components/schemas/typeDate"},"timeofday":{"$ref":"#/components/schemas/typeTimeOfDay"},"datetime":{"$ref":"#/components/schemas/typeDateTime"},"time_zone":{"$ref":"#/components/schemas/typeTimeZone"},"duration":{"type":"string","title":"Signed duration representing a span of time"},"list":{"$ref":"#/components/schemas/v1List"},"dictionary":{"$ref":"#/components/schemas/v1Dictionary"},"file":{"$ref":"#/components/schemas/v1FileValue"},"table":{"$ref":"#/components/schemas/v1TableValue"},"set":{"$ref":"#/components/schemas/v1Set"},"text_value":{"$ref":"#/components/schemas/v1TextValue"},"list_value":{"$ref":"#/components/schemas/commonv1ListValue"},"set_value":{"$ref":"#/components/schemas/v1SetValue"},"dictionary_value":{"$ref":"#/components/schemas/v1DictionaryValue"}},"description":"Represents a runtime value that can be produced by the Jarvis interpreter.\n\nThis message provides a type-safe way to serialize and transmit values between\nthe Jarvis interpreter and other services via gRPC. It supports all the basic\ndata types that can be represented in the Jarvis language runtime.\n\nThe oneof structure ensures that exactly one value type is set at a time,\nproviding both type safety and efficient serialization."},"v1Number":{"type":"object","properties":{"lo":{"type":"integer","format":"int64","description":"Low 32 bits of the 96-bit mantissa."},"mid":{"type":"integer","format":"int64","description":"Middle 32 bits of the 96-bit mantissa."},"hi":{"type":"integer","format":"int64","description":"High 32 bits of the 96-bit mantissa."},"flags":{"type":"integer","format":"int64","description":"Flags word:\n - Bits 16–23: scale (0–28)\n - Bit 31: sign (0 = positive, 1 = negative)\n - Other bits must be zero."}},"description":"A fixed-precision decimal number with up to 28 fractional digits.\n\nThis message represents decimal numbers with exact precision, avoiding\nfloating-point rounding errors. It's particularly useful for financial\ncalculations, measurements, and any scenario where exact decimal\nrepresentation is required.\n\nThe value is calculated as: m / 10^e, where:\n - m is an unsigned 96-bit integer composed of (lo, mid, hi)\n - e is the scale (0–28) stored in flags bits 16–23\n - sign is encoded in flags bit 31 (0 = positive, 1 = negative)\n\nExamples:\n - 123.45 would have m=12345, e=2\n - -0.001 would have m=1, e=3, with sign bit set\n"},"typeDate":{"type":"object","properties":{"year":{"type":"integer","format":"int32","description":"Year of the date. Must be from 1 to 9999, or 0 to specify a date without\na year."},"month":{"type":"integer","format":"int32","description":"Month of a year. Must be from 1 to 12, or 0 to specify a year without a\nmonth and day."},"day":{"type":"integer","format":"int32","description":"Day of a month. Must be from 1 to 31 and valid for the year and month, or 0\nto specify a year by itself or a year and month where the day isn't\nsignificant."}},"description":"* A full date, with non-zero year, month, and day values\n* A month and day value, with a zero year, such as an anniversary\n* A year on its own, with zero month and day values\n* A year and month value, with a zero day, such as a credit card expiration\ndate\n\nRelated types are [google.type.TimeOfDay][google.type.TimeOfDay] and\n`google.protobuf.Timestamp`.","title":"Represents a whole or partial calendar date, such as a birthday. The time of\nday and time zone are either specified elsewhere or are insignificant. The\ndate is relative to the Gregorian Calendar. This can represent one of the\nfollowing:"},"typeTimeOfDay":{"type":"object","properties":{"hours":{"type":"integer","format":"int32","description":"Hours of day in 24 hour format. Should be from 0 to 23. An API may choose\nto allow the value \"24:00:00\" for scenarios like business closing time."},"minutes":{"type":"integer","format":"int32","description":"Minutes of hour of day. Must be from 0 to 59."},"seconds":{"type":"integer","format":"int32","description":"Seconds of minutes of the time. Must normally be from 0 to 59. An API may\nallow the value 60 if it allows leap-seconds."},"nanos":{"type":"integer","format":"int32","description":"Fractions of seconds in nanoseconds. Must be from 0 to 999,999,999."}},"description":"Represents a time of day. The date and time zone are either not significant\nor are specified elsewhere. An API may choose to allow leap seconds. Related\ntypes are [google.type.Date][google.type.Date] and\n`google.protobuf.Timestamp`."},"typeDateTime":{"type":"object","properties":{"year":{"type":"integer","format":"int32","description":"Optional. Year of date. Must be from 1 to 9999, or 0 if specifying a\ndatetime without a year."},"month":{"type":"integer","format":"int32","description":"Required. Month of year. Must be from 1 to 12."},"day":{"type":"integer","format":"int32","description":"Required. Day of month. Must be from 1 to 31 and valid for the year and\nmonth."},"hours":{"type":"integer","format":"int32","description":"Required. Hours of day in 24 hour format. Should be from 0 to 23. An API\nmay choose to allow the value \"24:00:00\" for scenarios like business\nclosing time."},"minutes":{"type":"integer","format":"int32","description":"Required. Minutes of hour of day. Must be from 0 to 59."},"seconds":{"type":"integer","format":"int32","description":"Required. Seconds of minutes of the time. Must normally be from 0 to 59. An\nAPI may allow the value 60 if it allows leap-seconds."},"nanos":{"type":"integer","format":"int32","description":"Required. Fractions of seconds in nanoseconds. Must be from 0 to\n999,999,999."},"utc_offset":{"type":"string","description":"UTC offset. Must be whole seconds, between -18 hours and +18 hours.\nFor example, a UTC offset of -4:00 would be represented as\n{ seconds: -14400 }."},"time_zone":{"$ref":"#/components/schemas/typeTimeZone"}},"description":"Represents civil time (or occasionally physical time).\n\nThis type can represent a civil time in one of a few possible ways:\n\n * When utc_offset is set and time_zone is unset: a civil time on a calendar\n   day with a particular offset from UTC.\n * When time_zone is set and utc_offset is unset: a civil time on a calendar\n   day in a particular time zone.\n * When neither time_zone nor utc_offset is set: a civil time on a calendar\n   day in local time.\n\nThe date is relative to the Proleptic Gregorian Calendar.\n\nIf year is 0, the DateTime is considered not to have a specific year. month\nand day must have valid, non-zero values.\n\nThis type may also be used to represent a physical time if all the date and\ntime fields are set and either case of the `time_offset` oneof is set.\nConsider using `Timestamp` message for physical time instead. If your use\ncase also would like to store the user's timezone, that can be done in\nanother field.\n\nThis type is more flexible than some applications may want. Make sure to\ndocument and validate your application's limitations."},"typeTimeZone":{"type":"object","properties":{"id":{"type":"string","description":"IANA Time Zone Database time zone, e.g. \"America/New_York\"."},"version":{"type":"string","description":"Optional. IANA Time Zone Database version number, e.g. \"2019a\"."}},"description":"Represents a time zone from the\n[IANA Time Zone Database](https://www.iana.org/time-zones)."},"v1List":{"type":"object","properties":{"items":{"type":"array","items":{"$ref":"#/components/schemas/commonV1Value"},"title":"The ordered sequence of values in this list"}},"description":"Represents an ordered collection of values (similar to arrays or lists).\n\nThis message can contain any number of Value elements in a specific order.\nLists are mutable and can grow or shrink during runtime. Elements can be\naccessed by their zero-based index position.\n\nExamples:\n - [1, 2, 3] - list of numbers\n - [\"hello\", \"world\"] - list of strings\n - [true, 42, \"mixed\"] - list with mixed types\n - [[1, 2], [3, 4]] - nested lists"},"commonV1Value":{"type":"object","properties":{"null_value":{"type":"string","title":"Represents the absence of a value (None/null/undefined)"},"bool_value":{"type":"boolean","title":"Boolean true/false value"},"number":{"$ref":"#/components/schemas/v1Number"},"text":{"type":"string","title":"UTF-8 encoded text string"},"date":{"$ref":"#/components/schemas/typeDate"},"timeofday":{"$ref":"#/components/schemas/typeTimeOfDay"},"datetime":{"$ref":"#/components/schemas/typeDateTime"},"time_zone":{"$ref":"#/components/schemas/typeTimeZone"},"duration":{"type":"string","title":"Signed duration representing a span of time"},"list":{"$ref":"#/components/schemas/v1List"},"dictionary":{"$ref":"#/components/schemas/v1Dictionary"},"file":{"$ref":"#/components/schemas/v1FileValue"},"table":{"$ref":"#/components/schemas/v1TableValue"},"set":{"$ref":"#/components/schemas/v1Set"},"text_value":{"$ref":"#/components/schemas/v1TextValue"},"list_value":{"$ref":"#/components/schemas/commonv1ListValue"},"set_value":{"$ref":"#/components/schemas/v1SetValue"},"dictionary_value":{"$ref":"#/components/schemas/v1DictionaryValue"}},"description":"Represents a runtime value that can be produced by the Jarvis interpreter.\n\nThis message provides a type-safe way to serialize and transmit values between\nthe Jarvis interpreter and other services via gRPC. It supports all the basic\ndata types that can be represented in the Jarvis language runtime.\n\nThe oneof structure ensures that exactly one value type is set at a time,\nproviding both type safety and efficient serialization."},"v1Dictionary":{"type":"object","properties":{"entries":{"type":"array","items":{"$ref":"#/components/schemas/v1DictionaryEntry"},"title":"The key-value pairs stored in this dictionary"}},"description":"Represents a key-value mapping (similar to hash maps or dictionaries).\n\nThis message stores associations between keys and values, where keys must be\nhashable types (null, bool, Number, string, Date, TimeOfDay, DateTime, TimeZone). Keys are\nunique within a dictionary - duplicate keys will overwrite previous values.\n\nThe dictionary maintains insertion order for consistent iteration behavior.\n\nExamples:\n - {\"name\": \"John\", \"age\": 30} - string keys with mixed values\n - {1: \"one\", 2: \"two\"} - number keys with string values\n - {\"nested\": {\"inner\": \"value\"}} - nested dictionaries"},"v1DictionaryEntry":{"type":"object","properties":{"key":{"$ref":"#/components/schemas/v1HashableValue"},"value":{"$ref":"#/components/schemas/commonV1Value"}},"description":"Represents a single key-value pair within a Dictionary.\n\nBoth key and value can be any Value type, though keys should be\nhashable types for proper dictionary behavior. Non-hashable keys\n(like lists or dictionaries) may cause runtime errors."},"v1HashableValue":{"type":"object","properties":{"bool_value":{"type":"boolean","title":"Boolean true/false value"},"number":{"$ref":"#/components/schemas/v1Number"},"text":{"type":"string","title":"UTF-8 encoded text string"},"date":{"$ref":"#/components/schemas/typeDate"},"timeofday":{"$ref":"#/components/schemas/typeTimeOfDay"},"datetime":{"$ref":"#/components/schemas/typeDateTime"},"duration":{"type":"string","title":"Signed duration representing a span of time"},"text_value":{"$ref":"#/components/schemas/v1TextValue"}},"description":"Represents a hashable value that can be used as a dictionary key.\n\nThis message contains only the hashable types from the Value message,\ncorresponding to Python's hashable types. These types can be safely\nused as keys in maps and dictionaries.\n\nHashable types include: bool, Number, string, Date, TimeOfDay, DateTime\nand Duration."},"v1TextValue":{"type":"object","properties":{"remote":{"type":"string","title":"Reference to remote text content via URL or file path"},"inline":{"type":"string","title":"Text content embedded directly in the message"}},"description":"Represents a text value that can be either stored inline or referenced remotely.\n\nThis message provides flexibility for handling text strings in the Jarvis interpreter:\n- Small strings can be embedded directly using the inline option\n- Large strings can be referenced by URL using the remote option\n- The choice depends on string size, network constraints, and access patterns"},"v1FileValue":{"type":"object","properties":{"remote":{"type":"string","title":"Reference to a remote file via URL or file path"},"inline":{"$ref":"#/components/schemas/v1File"}},"description":"Represents a file value that can be either stored inline or referenced remotely.\n\nThis message provides flexibility for handling files in the Jarvis interpreter:\n- Small files can be embedded directly using the inline option\n- Large files can be referenced by URL/path using the remote option\n- The choice depends on file size, network constraints, and access patterns"},"v1File":{"type":"object","properties":{"content":{"type":"string","format":"byte","title":"The raw binary content of the file"},"name":{"type":"string","title":"The name of the file, including extension if applicable"}},"description":"Represents a file with its name and binary content.\n\nThis message contains the complete file data including both metadata\n(filename) and the actual file content as raw bytes. It's used for\nembedding files directly within messages when the file size is\nmanageable and immediate access is required.\n\nExamples:\n - Configuration files\n - Small text or binary files\n - Generated reports or documents\n - Temporary files created during execution\n"},"v1TableValue":{"type":"object","properties":{"remote":{"type":"string","title":"Reference to a remote table via URL or file path (feather-v2 format)"},"inline":{"$ref":"#/components/schemas/v1Table"}},"description":"Represents a table value that can be either stored inline or referenced remotely."},"v1Table":{"type":"object","properties":{"data":{"type":"string","format":"byte","title":"The table data serialized in feather-v2 format"}},"description":"Represents a table with data in feather-v2 format.\n\nThis message contains the complete table data serialized using the\nfeather-v2 format, which provides efficient columnar storage and\nfast serialization/deserialization for tabular data."},"v1Set":{"type":"object","properties":{"items":{"type":"array","items":{"$ref":"#/components/schemas/v1HashableValue"},"title":"The unique elements stored in this set\nAll elements must be hashable types"}},"description":"Represents an unordered collection of unique values.\n\nThis message stores a collection of unique elements, where duplicate values\nare automatically removed. Only hashable types can be stored in sets.\nSets are useful for membership testing, removing duplicates, and mathematical\nset operations like union, intersection, and difference.\n\nThe set does not maintain insertion order - elements may appear in any order\nduring iteration.\n\nExamples:\n - {1, 2, 3} - set of numbers\n - {\"apple\", \"banana\", \"cherry\"} - set of strings\n - {true, false} - set of booleans\n - {1, \"hello\", true} - set with mixed hashable types"},"commonv1ListValue":{"type":"object","properties":{"remote":{"type":"string","title":"Reference to remote list data via URL or file path"},"inline":{"$ref":"#/components/schemas/v1List"}},"description":"Represents a list value that can be either stored inline or referenced remotely.\n\nThis message provides flexibility for handling large lists:\n- Small lists can be embedded directly using the inline option\n- Large lists can be referenced by URL using the remote option"},"v1SetValue":{"type":"object","properties":{"remote":{"type":"string","title":"Reference to remote set data via URL or file path"},"inline":{"$ref":"#/components/schemas/v1Set"}},"description":"Represents a set value that can be either stored inline or referenced remotely.\n\nThis message provides flexibility for handling large sets:\n- Small sets can be embedded directly using the inline option\n- Large sets can be referenced by URL using the remote option"},"v1DictionaryValue":{"type":"object","properties":{"remote":{"type":"string","title":"Reference to remote dictionary data via URL or file path"},"inline":{"$ref":"#/components/schemas/v1Dictionary"}},"description":"Represents a dictionary value that can be either stored inline or referenced remotely.\n\nThis message provides flexibility for handling large dictionaries:\n- Small dictionaries can be embedded directly using the inline option\n- Large dictionaries can be referenced by URL using the remote option"},"v1FormSpec":{"type":"object","properties":{"fields":{"type":"array","items":{"$ref":"#/components/schemas/v1FormField"},"description":"At least one question, with unique nonempty keys. Order is the semantic\nreading sequence, not a prescribed screen layout."}},"description":"A set of typed questions for human input or source answers (R6, R13, R14).\nField types derive the returned record type. The platform selects controls\nand layout; there are no widgets, scripts, URLs, or executable expressions.\nShared human input may reference options in each unit's immutable evidence.\nWorkbench resolves those references into the unit's InputContext before use.\nSource answer forms must already be resolved. Filled values are separate messages.\nSources persist their answer form with the pending invocation for recovery.","required":["fields"]},"v1FormField":{"type":"object","properties":{"key":{"type":"string","description":"Stable record key. Unique within its field set; nonempty."},"label":{"type":"string","description":"Business-facing wording, independent of the programmatic key; nonempty."},"help_text":{"type":"string","description":"Optional guidance displayed with the question."},"value_type":{"$ref":"#/components/schemas/v1ValueType"},"initial_value":{"$ref":"#/components/schemas/commonv1Value"},"text":{"$ref":"#/components/schemas/v1TextConstraints"},"number":{"$ref":"#/components/schemas/v1NumberConstraints"},"input_spec":{"$ref":"#/components/schemas/v1InputSpec"}},"description":"One named question, its answer type and its input behavior.","required":["key","label","value_type"]},"v1ValueType":{"type":"object","properties":{"scalar_type":{"$ref":"#/components/schemas/v1ValueScalarType"},"optional_type":{"$ref":"#/components/schemas/v1ValueOptionalType"},"list_type":{"$ref":"#/components/schemas/v1ValueListType"},"dictionary_type":{"$ref":"#/components/schemas/v1ValueDictionaryType"},"table_type":{"$ref":"#/components/schemas/v1ValueTableType"},"opaque_type":{"$ref":"#/components/schemas/v1ValueOpaqueType"},"any_type":{"$ref":"#/components/schemas/v1ValueAnyType"},"union_type":{"$ref":"#/components/schemas/v1ValueUnionType"},"sensitive_type":{"$ref":"#/components/schemas/v1ValueSensitiveType"},"enum_type":{"$ref":"#/components/schemas/v1ValueEnumType"},"generic_dictionary_type":{"$ref":"#/components/schemas/v1ValueGenericDictionaryType"},"none_type":{"$ref":"#/components/schemas/v1ValueNoneType"}},"title":"Represents a complete value type definition using a discriminated union"},"v1ValueScalarType":{"type":"string","enum":["VALUE_SCALAR_TYPE_UNSPECIFIED","VALUE_SCALAR_TYPE_TEXT","VALUE_SCALAR_TYPE_NUMBER","VALUE_SCALAR_TYPE_BOOLEAN","VALUE_SCALAR_TYPE_DATETIME","VALUE_SCALAR_TYPE_DATE","VALUE_SCALAR_TYPE_TIME","VALUE_SCALAR_TYPE_FILE","VALUE_SCALAR_TYPE_TIMEDELTA"],"default":"VALUE_SCALAR_TYPE_UNSPECIFIED","description":"- VALUE_SCALAR_TYPE_UNSPECIFIED: Unspecified value type\n - VALUE_SCALAR_TYPE_TEXT: A text value type\n - VALUE_SCALAR_TYPE_NUMBER: A number value type\n - VALUE_SCALAR_TYPE_BOOLEAN: A boolean value type\n - VALUE_SCALAR_TYPE_DATETIME: A datetime value type\n - VALUE_SCALAR_TYPE_DATE: A date value type\n - VALUE_SCALAR_TYPE_TIME: A time value type\n - VALUE_SCALAR_TYPE_FILE: A file value type\n - VALUE_SCALAR_TYPE_TIMEDELTA: A timedelta value type","title":"Supported Value Scalar Types"},"v1ValueOptionalType":{"type":"object","properties":{"inner":{"$ref":"#/components/schemas/v1ValueType"}},"title":"Represents a value type that can be optional (nullable)"},"v1ValueListType":{"type":"object","properties":{"inner":{"$ref":"#/components/schemas/v1ValueType"}},"title":"Represents a list/array value type containing elements of a specific type"},"v1ValueDictionaryType":{"type":"object","properties":{"is_a":{"type":"string","title":"Semantic classification of what this dictionary represents"},"fields":{"type":"array","items":{"$ref":"#/components/schemas/v1ValueDictionaryTypeField"},"title":"The named fields contained in this dictionary"},"description":{"type":"string","title":"Optional human-readable description of this dictionary type"}},"title":"Represents a dictionary/object value type with named fields"},"v1ValueDictionaryTypeField":{"type":"object","properties":{"key":{"type":"string","title":"The name/key of this field"},"value":{"$ref":"#/components/schemas/v1ValueType"},"description":{"type":"string","title":"Optional human-readable description of this field"}},"title":"Represents a single field within a dictionary value type"},"v1ValueTableType":{"type":"object","properties":{"is_a":{"type":"string","title":"Semantic classification of what this table represents"},"columns":{"type":"array","items":{"$ref":"#/components/schemas/v1ValueTableTypeColumn"},"title":"The columns that make up this table"},"description":{"type":"string","title":"Optional human-readable description of this table type"}},"title":"Represents a table value type with structured columns"},"v1ValueTableTypeColumn":{"type":"object","properties":{"key":{"type":"string","title":"The name/key of this column"},"value":{"$ref":"#/components/schemas/v1ValueType"},"description":{"type":"string","title":"Optional human-readable description of this column"}},"title":"Represents a single column within a table value type"},"v1ValueOpaqueType":{"type":"object","properties":{"is_a":{"type":"string","title":"Semantic classification of what this opaque type represents"},"description":{"type":"string","title":"Optional human-readable description of this opaque type"}},"title":"Represents an opaque value type with semantic meaning but unknown internal structure"},"v1ValueAnyType":{"type":"object","title":"Represents a value type that can hold any kind of value"},"v1ValueUnionType":{"type":"object","properties":{"inners":{"type":"array","items":{"$ref":"#/components/schemas/v1ValueType"},"title":"The possible value types in this union"}},"title":"Represents a union value type that can be one of several possible types"},"v1ValueSensitiveType":{"type":"object","properties":{"inner":{"$ref":"#/components/schemas/v1ValueType"}},"title":"Represents a value type that contains sensitive information"},"v1ValueEnumType":{"type":"object","properties":{"is_a":{"type":"string","title":"Semantic classification of what this enum represents"},"members":{"type":"array","items":{"$ref":"#/components/schemas/v1ValueEnumTypeMember"},"title":"The available options/members of this enum"},"description":{"type":"string","title":"Optional human-readable description of this enum type"}},"title":"Represents an enumeration value type with predefined options"},"v1ValueEnumTypeMember":{"type":"object","properties":{"name":{"type":"string","title":"The programmatic name of this enum member"},"description":{"type":"string","title":"Optional human-readable description of this enum member"}},"title":"Represents a single member/option within an enum value type"},"v1ValueGenericDictionaryType":{"type":"object","properties":{"key_type":{"$ref":"#/components/schemas/v1ValueType"},"value_type":{"$ref":"#/components/schemas/v1ValueType"}},"title":"Represent a generic dictionary that can hold any entry of a particular key and value type"},"v1ValueNoneType":{"type":"object","title":"Represents a none value type that can hold no value"},"v1TextConstraints":{"type":"object","properties":{"min_length":{"type":"integer","format":"int64","description":"Unicode scalar-value counts, not bytes or UTF-16 code units. No implicit\ntrimming, normalization, pattern evaluation or text transformation."},"max_length":{"type":"integer","format":"int64","description":"Inclusive maximum length, measured in Unicode scalar values."}},"description":"Length restrictions on a text answer."},"v1NumberConstraints":{"type":"object","properties":{"minimum":{"$ref":"#/components/schemas/v1Number"},"maximum":{"$ref":"#/components/schemas/v1Number"},"integer_only":{"type":"boolean","description":"Require a value with no fractional component."}},"description":"Exact decimal restrictions on a numeric answer."},"v1InputSpec":{"type":"object","properties":{"selection":{"$ref":"#/components/schemas/v1SelectionInput"}},"description":"How a person supplies a typed answer. Concrete controls and layout belong\nto the renderer. No option carries follow-up fields or executable behavior."},"v1SelectionInput":{"type":"object","properties":{"options":{"type":"array","items":{"$ref":"#/components/schemas/v1SelectionOption"},"description":"Distinct typed values with nonempty labels. May be empty. Each value must\nsatisfy the scalar/element type and applicable field constraints. Numeric\nequality is decimal equality, so 1 and 1.0 are the same option."},"min_selections":{"type":"integer","format":"int64","description":"Only for list fields. Omitted minimum means zero; omitted maximum means the\noption count. Bounds must be ordered and, for nonempty option sets, no greater\nthan that count. Empty selections retain bounds for answer validation.\nUnknown or repeated selections fail. Persist selections in option order,\nusing the declared option values, not user click order or numeric encoding."},"max_selections":{"type":"integer","format":"int64","description":"Inclusive maximum number of selected options."},"options_ref":{"type":"string","description":"Exact nonempty top-level WorkUnit.evidence key, not a path or expression.\nAllowed only in shared human input, mutually exclusive with inline options.\nValid evidence is an inline list of distinct scalar values matching\nthe field's scalar/element type and constraints. Inline text wrappers are\nnormalized to text. No remote reads, record projections or coercion occur.\nEach value is both the displayed choice and the submitted value: text is\nunchanged, numbers use exact decimal text, booleans use true/false, and dates\nuse YYYY-MM-DD. Empty text has no display label and is invalid as an option.\nMissing, empty or invalid choices produce an empty selection, not an input\nerror or free entry. Other fields remain usable. Initial values incompatible\nwith the resolved selection are omitted for that unit."}},"description":"A finite set of offered values. A scalar field selects one value; a list\nfield selects distinct values of its element type. Optional None is absence,\nnever an option. Use inline options or options_ref, not both. Empty selections\noffer no choices and never enable free entry. Resolved unit input and source\nanswer forms use inline options only."},"v1SelectionOption":{"type":"object","properties":{"label":{"type":"string","description":"Nonempty display wording, independent of the submitted value."},"value":{"$ref":"#/components/schemas/commonv1Value"}},"description":"Display wording and the typed value returned when this option is selected.","required":["label","value"]},"v1WorkUnitStatusCount":{"type":"object","properties":{"status":{"$ref":"#/components/schemas/v1WorkUnitStatus"},"count":{"type":"integer","format":"int32","description":"Number of attached units in this status. Always nonnegative."}},"description":"WorkUnitStatusCount counts the attached units in one lifecycle status."},"v1WorkUnitStatus":{"type":"string","enum":["WORK_UNIT_STATUS_UNSPECIFIED","WORK_UNIT_STATUS_WAITING_FOR_INPUT","WORK_UNIT_STATUS_ANSWERED","WORK_UNIT_STATUS_DISMISSED","WORK_UNIT_STATUS_WITHDRAWN","WORK_UNIT_STATUS_PROCESSING"],"default":"WORK_UNIT_STATUS_UNSPECIFIED","description":"WorkUnitStatus records attention and final resolution independently of delivery.\n\n - WORK_UNIT_STATUS_UNSPECIFIED: Default value; not returned for an existing resource.\n - WORK_UNIT_STATUS_WAITING_FOR_INPUT: Waiting for intermediate input or a direct final answer: an item input_form\nexists and input is unaccepted, or no input_form exists and the kind does\nnot require preparation. Saving either draft leaves status unchanged.\n - WORK_UNIT_STATUS_ANSWERED: Final submission and its delivery obligation are durable.\n - WORK_UNIT_STATUS_DISMISSED: Locally dismissed by item archival, arrival or rekey into an archived item.\nUnarchive restores it unless the source or operator has withdrawn it.\n - WORK_UNIT_STATUS_WITHDRAWN: Source or operator ended the occurrence without an answer.\n - WORK_UNIT_STATUS_PROCESSING: Analysis or decision preparation is pending; no current human request.\nIncludes work without an input_form whose kind requires preparation, and\nfinal-answer preparation after intermediate input acceptance."},"rpcStatus":{"type":"object","properties":{"code":{"type":"integer","format":"int32"},"message":{"type":"string"},"details":{"type":"array","items":{"$ref":"#/components/schemas/protobufAny"}}}},"protobufAny":{"type":"object","properties":{"@type":{"type":"string"}},"additionalProperties":{}},"WorkItemServiceArchiveWorkItemBody":{"type":"object","properties":{"reason":{"type":"string","description":"Business-safe reason for archival, recorded in the audit event."}},"description":"ArchiveWorkItemRequest names the item and reason for local dismissal.\nRejected with FAILED_PRECONDITION when the kind is not dismissible.","required":["reason"]}}},"paths":{"/api/v1/organizations/{organization_id}/workspaces/{workspace_id}/workItems/{work_item_id}:archive":{"post":{"summary":"Archive Work Item","description":"ArchiveWorkItem archives a persistent item and locally dismisses its\nunresolved units. New arrivals and units rekeyed into it are also dismissed.\nRequires a dismissible kind; items without unresolved units may be archived. Answered and\nwithdrawn units retain their outcomes. Assignment is unchanged.\nNo source decision or delivery is created; archival controls attention only.","operationId":"ArchiveWorkItem","responses":{"200":{"description":"A successful response.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/v1WorkItem"}}}},"default":{"description":"An unexpected error response.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/rpcStatus"}}}}},"parameters":[{"name":"organization_id","in":"path","required":true,"schema":{"type":"string"}},{"name":"workspace_id","in":"path","required":true,"schema":{"type":"string"}},{"name":"work_item_id","in":"path","required":true,"schema":{"type":"string"}}],"requestBody":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/WorkItemServiceArchiveWorkItemBody"}}},"required":true},"tags":["Work Items"]}}}}
```

## Assign Work Item

> AssignWorkItem assigns an item to a person, or returns it to unassigned\
> when the assignee is empty.\
> \
> Requires a non-archived item with at least one unresolved unit; otherwise\
> returns FAILED\_PRECONDITION. Assignment does not restrict who may answer.

```json
{"openapi":"3.0.0","info":{"title":"Kognitos API","version":"1.0.0"},"tags":[{"name":"Work Items","description":"Track work items and work units that need human input."}],"servers":[{"url":"https://app.us-1.kognitos.com"}],"security":[{"BearerAuth":[]}],"components":{"securitySchemes":{"BearerAuth":{"type":"http","scheme":"bearer","description":"Personal Access Token."}},"schemas":{"v1WorkItem":{"type":"object","properties":{"name":{"type":"string","title":"The resource name of the work item.\nFormat: organizations/{organization_id}/workspaces/{workspace_id}/workItems/{work_item_id}"},"kind":{"type":"string","description":"The registered kind of work, as an opaque dotted id\n(for example \"astral.automation_exception\").\n\nThis is a string rather than an enum so that registering a kind is not a\nproto change. It is validated against the registered kind descriptors, so\nthe set is closed at runtime. No behaviour in this contract branches on it.","readOnly":true},"agg_labels":{"$ref":"#/components/schemas/commonv1Value"},"question":{"type":"string","description":"The question in business language: the summary of the unit that\nmaterialised this item, verbatim.\n\nThe pointer and source summary are fixed for the item's life. Per-unit\nquestions remain available on the units; this is a queue summary.\n\nIt is one unit's words about a set. Clients use unit_counts to show the\nnumber of occurrences relevant to their view.","readOnly":true},"assignee":{"type":"string","title":"The person this item is assigned to. The empty value means unassigned,\nwhich is an ordinary state of a queue and not a missing value.\nFormat: users/{user_id}"},"declined_by":{"type":"string","title":"The person who last handed this item back. Current state rather than\nhistory; the history is in the audit log.\nFormat: users/{user_id}","readOnly":true},"decline_reason":{"type":"string","description":"Why the item was last handed back. Current state rather than history.","readOnly":true},"create_time":{"type":"string","format":"date-time","description":"The time the item was materialised. This is the item's age.","readOnly":true},"update_time":{"type":"string","format":"date-time","description":"The time the item last changed.","readOnly":true},"input_form":{"$ref":"#/components/schemas/v1FormSpec"},"input_form_etag":{"type":"string","description":"Concurrency token for input_form, present even before the first form is set.\nChanges only when the form changes. Returned by Get and List.","readOnly":true},"archive_time":{"type":"string","format":"date-time","description":"When the item was explicitly archived. Absence means not archived.\nUnarchive clears this field. Archival locally dismisses unresolved units\nand future arrivals; answered and withdrawn units retain their outcomes.","readOnly":true},"unit_counts":{"type":"array","items":{"$ref":"#/components/schemas/v1WorkUnitStatusCount"},"description":"Counts of all attached units, independent of any ListWorkItems filter.\nReturned by Get and List. Exactly one entry for every defined WorkUnitStatus\nexcept UNSPECIFIED, including zero counts; no duplicate statuses.\nSum all entries for the total, or selected statuses for a view's count.","readOnly":true},"preparation_required":{"type":"boolean","description":"Whether the UI should offer preparation before opening chat.\nSet for preparation-enabled kinds when unresolved membership changes from\nzero to nonzero, including initial arrival, unarchive and rekey. Further\narrivals while unresolved units remain do not set it again. Suppress the\ngate when no unresolved units remain, regardless of this stored flag.\nMarkWorkItemPreparationStarted clears it after Rain accepts a prompt.\nAutomatic invocation also clears it on message acceptance while its unit\nstill belongs to the item and the item is not archived.\nClearing this flag does not change unit status or indicate preparation has\nfinished. This is not execution state or an authorization boundary. Returned by Get and List.","readOnly":true},"revision":{"type":"string","format":"int64","description":"Monotonically increasing version of this resource's mutable state.\nCompare only revisions of the same resource. Includes changes to unit_counts.\nIndependent of form and draft etags; never a mutation precondition.","readOnly":true}},"description":"WorkItem groups related occurrences that can be resolved independently.\n\nAn item is not a container a source puts things in. It is materialised by\nthis service from the work units that share the labels the workspace groups\non, so its identity is those label values.\n\nEach unit records its lifecycle independently of delivery.\nA submission settles one unit; delivery records whether the source applied it.\nOne item persists for each workspace, kind and grouping identity. New units\nattach to the same item; archived items locally dismiss new arrivals. Existing\nsubmissions and assignment survive new arrivals. Rekey never changes this identity."},"commonv1Value":{"type":"object","properties":{"null_value":{"type":"string","title":"Represents the absence of a value (None/null/undefined)"},"bool_value":{"type":"boolean","title":"Boolean true/false value"},"number":{"$ref":"#/components/schemas/v1Number"},"text":{"type":"string","title":"UTF-8 encoded text string"},"date":{"$ref":"#/components/schemas/typeDate"},"timeofday":{"$ref":"#/components/schemas/typeTimeOfDay"},"datetime":{"$ref":"#/components/schemas/typeDateTime"},"time_zone":{"$ref":"#/components/schemas/typeTimeZone"},"duration":{"type":"string","title":"Signed duration representing a span of time"},"list":{"$ref":"#/components/schemas/v1List"},"dictionary":{"$ref":"#/components/schemas/v1Dictionary"},"file":{"$ref":"#/components/schemas/v1FileValue"},"table":{"$ref":"#/components/schemas/v1TableValue"},"set":{"$ref":"#/components/schemas/v1Set"},"text_value":{"$ref":"#/components/schemas/v1TextValue"},"list_value":{"$ref":"#/components/schemas/commonv1ListValue"},"set_value":{"$ref":"#/components/schemas/v1SetValue"},"dictionary_value":{"$ref":"#/components/schemas/v1DictionaryValue"}},"description":"Represents a runtime value that can be produced by the Jarvis interpreter.\n\nThis message provides a type-safe way to serialize and transmit values between\nthe Jarvis interpreter and other services via gRPC. It supports all the basic\ndata types that can be represented in the Jarvis language runtime.\n\nThe oneof structure ensures that exactly one value type is set at a time,\nproviding both type safety and efficient serialization."},"v1Number":{"type":"object","properties":{"lo":{"type":"integer","format":"int64","description":"Low 32 bits of the 96-bit mantissa."},"mid":{"type":"integer","format":"int64","description":"Middle 32 bits of the 96-bit mantissa."},"hi":{"type":"integer","format":"int64","description":"High 32 bits of the 96-bit mantissa."},"flags":{"type":"integer","format":"int64","description":"Flags word:\n - Bits 16–23: scale (0–28)\n - Bit 31: sign (0 = positive, 1 = negative)\n - Other bits must be zero."}},"description":"A fixed-precision decimal number with up to 28 fractional digits.\n\nThis message represents decimal numbers with exact precision, avoiding\nfloating-point rounding errors. It's particularly useful for financial\ncalculations, measurements, and any scenario where exact decimal\nrepresentation is required.\n\nThe value is calculated as: m / 10^e, where:\n - m is an unsigned 96-bit integer composed of (lo, mid, hi)\n - e is the scale (0–28) stored in flags bits 16–23\n - sign is encoded in flags bit 31 (0 = positive, 1 = negative)\n\nExamples:\n - 123.45 would have m=12345, e=2\n - -0.001 would have m=1, e=3, with sign bit set\n"},"typeDate":{"type":"object","properties":{"year":{"type":"integer","format":"int32","description":"Year of the date. Must be from 1 to 9999, or 0 to specify a date without\na year."},"month":{"type":"integer","format":"int32","description":"Month of a year. Must be from 1 to 12, or 0 to specify a year without a\nmonth and day."},"day":{"type":"integer","format":"int32","description":"Day of a month. Must be from 1 to 31 and valid for the year and month, or 0\nto specify a year by itself or a year and month where the day isn't\nsignificant."}},"description":"* A full date, with non-zero year, month, and day values\n* A month and day value, with a zero year, such as an anniversary\n* A year on its own, with zero month and day values\n* A year and month value, with a zero day, such as a credit card expiration\ndate\n\nRelated types are [google.type.TimeOfDay][google.type.TimeOfDay] and\n`google.protobuf.Timestamp`.","title":"Represents a whole or partial calendar date, such as a birthday. The time of\nday and time zone are either specified elsewhere or are insignificant. The\ndate is relative to the Gregorian Calendar. This can represent one of the\nfollowing:"},"typeTimeOfDay":{"type":"object","properties":{"hours":{"type":"integer","format":"int32","description":"Hours of day in 24 hour format. Should be from 0 to 23. An API may choose\nto allow the value \"24:00:00\" for scenarios like business closing time."},"minutes":{"type":"integer","format":"int32","description":"Minutes of hour of day. Must be from 0 to 59."},"seconds":{"type":"integer","format":"int32","description":"Seconds of minutes of the time. Must normally be from 0 to 59. An API may\nallow the value 60 if it allows leap-seconds."},"nanos":{"type":"integer","format":"int32","description":"Fractions of seconds in nanoseconds. Must be from 0 to 999,999,999."}},"description":"Represents a time of day. The date and time zone are either not significant\nor are specified elsewhere. An API may choose to allow leap seconds. Related\ntypes are [google.type.Date][google.type.Date] and\n`google.protobuf.Timestamp`."},"typeDateTime":{"type":"object","properties":{"year":{"type":"integer","format":"int32","description":"Optional. Year of date. Must be from 1 to 9999, or 0 if specifying a\ndatetime without a year."},"month":{"type":"integer","format":"int32","description":"Required. Month of year. Must be from 1 to 12."},"day":{"type":"integer","format":"int32","description":"Required. Day of month. Must be from 1 to 31 and valid for the year and\nmonth."},"hours":{"type":"integer","format":"int32","description":"Required. Hours of day in 24 hour format. Should be from 0 to 23. An API\nmay choose to allow the value \"24:00:00\" for scenarios like business\nclosing time."},"minutes":{"type":"integer","format":"int32","description":"Required. Minutes of hour of day. Must be from 0 to 59."},"seconds":{"type":"integer","format":"int32","description":"Required. Seconds of minutes of the time. Must normally be from 0 to 59. An\nAPI may allow the value 60 if it allows leap-seconds."},"nanos":{"type":"integer","format":"int32","description":"Required. Fractions of seconds in nanoseconds. Must be from 0 to\n999,999,999."},"utc_offset":{"type":"string","description":"UTC offset. Must be whole seconds, between -18 hours and +18 hours.\nFor example, a UTC offset of -4:00 would be represented as\n{ seconds: -14400 }."},"time_zone":{"$ref":"#/components/schemas/typeTimeZone"}},"description":"Represents civil time (or occasionally physical time).\n\nThis type can represent a civil time in one of a few possible ways:\n\n * When utc_offset is set and time_zone is unset: a civil time on a calendar\n   day with a particular offset from UTC.\n * When time_zone is set and utc_offset is unset: a civil time on a calendar\n   day in a particular time zone.\n * When neither time_zone nor utc_offset is set: a civil time on a calendar\n   day in local time.\n\nThe date is relative to the Proleptic Gregorian Calendar.\n\nIf year is 0, the DateTime is considered not to have a specific year. month\nand day must have valid, non-zero values.\n\nThis type may also be used to represent a physical time if all the date and\ntime fields are set and either case of the `time_offset` oneof is set.\nConsider using `Timestamp` message for physical time instead. If your use\ncase also would like to store the user's timezone, that can be done in\nanother field.\n\nThis type is more flexible than some applications may want. Make sure to\ndocument and validate your application's limitations."},"typeTimeZone":{"type":"object","properties":{"id":{"type":"string","description":"IANA Time Zone Database time zone, e.g. \"America/New_York\"."},"version":{"type":"string","description":"Optional. IANA Time Zone Database version number, e.g. \"2019a\"."}},"description":"Represents a time zone from the\n[IANA Time Zone Database](https://www.iana.org/time-zones)."},"v1List":{"type":"object","properties":{"items":{"type":"array","items":{"$ref":"#/components/schemas/commonV1Value"},"title":"The ordered sequence of values in this list"}},"description":"Represents an ordered collection of values (similar to arrays or lists).\n\nThis message can contain any number of Value elements in a specific order.\nLists are mutable and can grow or shrink during runtime. Elements can be\naccessed by their zero-based index position.\n\nExamples:\n - [1, 2, 3] - list of numbers\n - [\"hello\", \"world\"] - list of strings\n - [true, 42, \"mixed\"] - list with mixed types\n - [[1, 2], [3, 4]] - nested lists"},"commonV1Value":{"type":"object","properties":{"null_value":{"type":"string","title":"Represents the absence of a value (None/null/undefined)"},"bool_value":{"type":"boolean","title":"Boolean true/false value"},"number":{"$ref":"#/components/schemas/v1Number"},"text":{"type":"string","title":"UTF-8 encoded text string"},"date":{"$ref":"#/components/schemas/typeDate"},"timeofday":{"$ref":"#/components/schemas/typeTimeOfDay"},"datetime":{"$ref":"#/components/schemas/typeDateTime"},"time_zone":{"$ref":"#/components/schemas/typeTimeZone"},"duration":{"type":"string","title":"Signed duration representing a span of time"},"list":{"$ref":"#/components/schemas/v1List"},"dictionary":{"$ref":"#/components/schemas/v1Dictionary"},"file":{"$ref":"#/components/schemas/v1FileValue"},"table":{"$ref":"#/components/schemas/v1TableValue"},"set":{"$ref":"#/components/schemas/v1Set"},"text_value":{"$ref":"#/components/schemas/v1TextValue"},"list_value":{"$ref":"#/components/schemas/commonv1ListValue"},"set_value":{"$ref":"#/components/schemas/v1SetValue"},"dictionary_value":{"$ref":"#/components/schemas/v1DictionaryValue"}},"description":"Represents a runtime value that can be produced by the Jarvis interpreter.\n\nThis message provides a type-safe way to serialize and transmit values between\nthe Jarvis interpreter and other services via gRPC. It supports all the basic\ndata types that can be represented in the Jarvis language runtime.\n\nThe oneof structure ensures that exactly one value type is set at a time,\nproviding both type safety and efficient serialization."},"v1Dictionary":{"type":"object","properties":{"entries":{"type":"array","items":{"$ref":"#/components/schemas/v1DictionaryEntry"},"title":"The key-value pairs stored in this dictionary"}},"description":"Represents a key-value mapping (similar to hash maps or dictionaries).\n\nThis message stores associations between keys and values, where keys must be\nhashable types (null, bool, Number, string, Date, TimeOfDay, DateTime, TimeZone). Keys are\nunique within a dictionary - duplicate keys will overwrite previous values.\n\nThe dictionary maintains insertion order for consistent iteration behavior.\n\nExamples:\n - {\"name\": \"John\", \"age\": 30} - string keys with mixed values\n - {1: \"one\", 2: \"two\"} - number keys with string values\n - {\"nested\": {\"inner\": \"value\"}} - nested dictionaries"},"v1DictionaryEntry":{"type":"object","properties":{"key":{"$ref":"#/components/schemas/v1HashableValue"},"value":{"$ref":"#/components/schemas/commonV1Value"}},"description":"Represents a single key-value pair within a Dictionary.\n\nBoth key and value can be any Value type, though keys should be\nhashable types for proper dictionary behavior. Non-hashable keys\n(like lists or dictionaries) may cause runtime errors."},"v1HashableValue":{"type":"object","properties":{"bool_value":{"type":"boolean","title":"Boolean true/false value"},"number":{"$ref":"#/components/schemas/v1Number"},"text":{"type":"string","title":"UTF-8 encoded text string"},"date":{"$ref":"#/components/schemas/typeDate"},"timeofday":{"$ref":"#/components/schemas/typeTimeOfDay"},"datetime":{"$ref":"#/components/schemas/typeDateTime"},"duration":{"type":"string","title":"Signed duration representing a span of time"},"text_value":{"$ref":"#/components/schemas/v1TextValue"}},"description":"Represents a hashable value that can be used as a dictionary key.\n\nThis message contains only the hashable types from the Value message,\ncorresponding to Python's hashable types. These types can be safely\nused as keys in maps and dictionaries.\n\nHashable types include: bool, Number, string, Date, TimeOfDay, DateTime\nand Duration."},"v1TextValue":{"type":"object","properties":{"remote":{"type":"string","title":"Reference to remote text content via URL or file path"},"inline":{"type":"string","title":"Text content embedded directly in the message"}},"description":"Represents a text value that can be either stored inline or referenced remotely.\n\nThis message provides flexibility for handling text strings in the Jarvis interpreter:\n- Small strings can be embedded directly using the inline option\n- Large strings can be referenced by URL using the remote option\n- The choice depends on string size, network constraints, and access patterns"},"v1FileValue":{"type":"object","properties":{"remote":{"type":"string","title":"Reference to a remote file via URL or file path"},"inline":{"$ref":"#/components/schemas/v1File"}},"description":"Represents a file value that can be either stored inline or referenced remotely.\n\nThis message provides flexibility for handling files in the Jarvis interpreter:\n- Small files can be embedded directly using the inline option\n- Large files can be referenced by URL/path using the remote option\n- The choice depends on file size, network constraints, and access patterns"},"v1File":{"type":"object","properties":{"content":{"type":"string","format":"byte","title":"The raw binary content of the file"},"name":{"type":"string","title":"The name of the file, including extension if applicable"}},"description":"Represents a file with its name and binary content.\n\nThis message contains the complete file data including both metadata\n(filename) and the actual file content as raw bytes. It's used for\nembedding files directly within messages when the file size is\nmanageable and immediate access is required.\n\nExamples:\n - Configuration files\n - Small text or binary files\n - Generated reports or documents\n - Temporary files created during execution\n"},"v1TableValue":{"type":"object","properties":{"remote":{"type":"string","title":"Reference to a remote table via URL or file path (feather-v2 format)"},"inline":{"$ref":"#/components/schemas/v1Table"}},"description":"Represents a table value that can be either stored inline or referenced remotely."},"v1Table":{"type":"object","properties":{"data":{"type":"string","format":"byte","title":"The table data serialized in feather-v2 format"}},"description":"Represents a table with data in feather-v2 format.\n\nThis message contains the complete table data serialized using the\nfeather-v2 format, which provides efficient columnar storage and\nfast serialization/deserialization for tabular data."},"v1Set":{"type":"object","properties":{"items":{"type":"array","items":{"$ref":"#/components/schemas/v1HashableValue"},"title":"The unique elements stored in this set\nAll elements must be hashable types"}},"description":"Represents an unordered collection of unique values.\n\nThis message stores a collection of unique elements, where duplicate values\nare automatically removed. Only hashable types can be stored in sets.\nSets are useful for membership testing, removing duplicates, and mathematical\nset operations like union, intersection, and difference.\n\nThe set does not maintain insertion order - elements may appear in any order\nduring iteration.\n\nExamples:\n - {1, 2, 3} - set of numbers\n - {\"apple\", \"banana\", \"cherry\"} - set of strings\n - {true, false} - set of booleans\n - {1, \"hello\", true} - set with mixed hashable types"},"commonv1ListValue":{"type":"object","properties":{"remote":{"type":"string","title":"Reference to remote list data via URL or file path"},"inline":{"$ref":"#/components/schemas/v1List"}},"description":"Represents a list value that can be either stored inline or referenced remotely.\n\nThis message provides flexibility for handling large lists:\n- Small lists can be embedded directly using the inline option\n- Large lists can be referenced by URL using the remote option"},"v1SetValue":{"type":"object","properties":{"remote":{"type":"string","title":"Reference to remote set data via URL or file path"},"inline":{"$ref":"#/components/schemas/v1Set"}},"description":"Represents a set value that can be either stored inline or referenced remotely.\n\nThis message provides flexibility for handling large sets:\n- Small sets can be embedded directly using the inline option\n- Large sets can be referenced by URL using the remote option"},"v1DictionaryValue":{"type":"object","properties":{"remote":{"type":"string","title":"Reference to remote dictionary data via URL or file path"},"inline":{"$ref":"#/components/schemas/v1Dictionary"}},"description":"Represents a dictionary value that can be either stored inline or referenced remotely.\n\nThis message provides flexibility for handling large dictionaries:\n- Small dictionaries can be embedded directly using the inline option\n- Large dictionaries can be referenced by URL using the remote option"},"v1FormSpec":{"type":"object","properties":{"fields":{"type":"array","items":{"$ref":"#/components/schemas/v1FormField"},"description":"At least one question, with unique nonempty keys. Order is the semantic\nreading sequence, not a prescribed screen layout."}},"description":"A set of typed questions for human input or source answers (R6, R13, R14).\nField types derive the returned record type. The platform selects controls\nand layout; there are no widgets, scripts, URLs, or executable expressions.\nShared human input may reference options in each unit's immutable evidence.\nWorkbench resolves those references into the unit's InputContext before use.\nSource answer forms must already be resolved. Filled values are separate messages.\nSources persist their answer form with the pending invocation for recovery.","required":["fields"]},"v1FormField":{"type":"object","properties":{"key":{"type":"string","description":"Stable record key. Unique within its field set; nonempty."},"label":{"type":"string","description":"Business-facing wording, independent of the programmatic key; nonempty."},"help_text":{"type":"string","description":"Optional guidance displayed with the question."},"value_type":{"$ref":"#/components/schemas/v1ValueType"},"initial_value":{"$ref":"#/components/schemas/commonv1Value"},"text":{"$ref":"#/components/schemas/v1TextConstraints"},"number":{"$ref":"#/components/schemas/v1NumberConstraints"},"input_spec":{"$ref":"#/components/schemas/v1InputSpec"}},"description":"One named question, its answer type and its input behavior.","required":["key","label","value_type"]},"v1ValueType":{"type":"object","properties":{"scalar_type":{"$ref":"#/components/schemas/v1ValueScalarType"},"optional_type":{"$ref":"#/components/schemas/v1ValueOptionalType"},"list_type":{"$ref":"#/components/schemas/v1ValueListType"},"dictionary_type":{"$ref":"#/components/schemas/v1ValueDictionaryType"},"table_type":{"$ref":"#/components/schemas/v1ValueTableType"},"opaque_type":{"$ref":"#/components/schemas/v1ValueOpaqueType"},"any_type":{"$ref":"#/components/schemas/v1ValueAnyType"},"union_type":{"$ref":"#/components/schemas/v1ValueUnionType"},"sensitive_type":{"$ref":"#/components/schemas/v1ValueSensitiveType"},"enum_type":{"$ref":"#/components/schemas/v1ValueEnumType"},"generic_dictionary_type":{"$ref":"#/components/schemas/v1ValueGenericDictionaryType"},"none_type":{"$ref":"#/components/schemas/v1ValueNoneType"}},"title":"Represents a complete value type definition using a discriminated union"},"v1ValueScalarType":{"type":"string","enum":["VALUE_SCALAR_TYPE_UNSPECIFIED","VALUE_SCALAR_TYPE_TEXT","VALUE_SCALAR_TYPE_NUMBER","VALUE_SCALAR_TYPE_BOOLEAN","VALUE_SCALAR_TYPE_DATETIME","VALUE_SCALAR_TYPE_DATE","VALUE_SCALAR_TYPE_TIME","VALUE_SCALAR_TYPE_FILE","VALUE_SCALAR_TYPE_TIMEDELTA"],"default":"VALUE_SCALAR_TYPE_UNSPECIFIED","description":"- VALUE_SCALAR_TYPE_UNSPECIFIED: Unspecified value type\n - VALUE_SCALAR_TYPE_TEXT: A text value type\n - VALUE_SCALAR_TYPE_NUMBER: A number value type\n - VALUE_SCALAR_TYPE_BOOLEAN: A boolean value type\n - VALUE_SCALAR_TYPE_DATETIME: A datetime value type\n - VALUE_SCALAR_TYPE_DATE: A date value type\n - VALUE_SCALAR_TYPE_TIME: A time value type\n - VALUE_SCALAR_TYPE_FILE: A file value type\n - VALUE_SCALAR_TYPE_TIMEDELTA: A timedelta value type","title":"Supported Value Scalar Types"},"v1ValueOptionalType":{"type":"object","properties":{"inner":{"$ref":"#/components/schemas/v1ValueType"}},"title":"Represents a value type that can be optional (nullable)"},"v1ValueListType":{"type":"object","properties":{"inner":{"$ref":"#/components/schemas/v1ValueType"}},"title":"Represents a list/array value type containing elements of a specific type"},"v1ValueDictionaryType":{"type":"object","properties":{"is_a":{"type":"string","title":"Semantic classification of what this dictionary represents"},"fields":{"type":"array","items":{"$ref":"#/components/schemas/v1ValueDictionaryTypeField"},"title":"The named fields contained in this dictionary"},"description":{"type":"string","title":"Optional human-readable description of this dictionary type"}},"title":"Represents a dictionary/object value type with named fields"},"v1ValueDictionaryTypeField":{"type":"object","properties":{"key":{"type":"string","title":"The name/key of this field"},"value":{"$ref":"#/components/schemas/v1ValueType"},"description":{"type":"string","title":"Optional human-readable description of this field"}},"title":"Represents a single field within a dictionary value type"},"v1ValueTableType":{"type":"object","properties":{"is_a":{"type":"string","title":"Semantic classification of what this table represents"},"columns":{"type":"array","items":{"$ref":"#/components/schemas/v1ValueTableTypeColumn"},"title":"The columns that make up this table"},"description":{"type":"string","title":"Optional human-readable description of this table type"}},"title":"Represents a table value type with structured columns"},"v1ValueTableTypeColumn":{"type":"object","properties":{"key":{"type":"string","title":"The name/key of this column"},"value":{"$ref":"#/components/schemas/v1ValueType"},"description":{"type":"string","title":"Optional human-readable description of this column"}},"title":"Represents a single column within a table value type"},"v1ValueOpaqueType":{"type":"object","properties":{"is_a":{"type":"string","title":"Semantic classification of what this opaque type represents"},"description":{"type":"string","title":"Optional human-readable description of this opaque type"}},"title":"Represents an opaque value type with semantic meaning but unknown internal structure"},"v1ValueAnyType":{"type":"object","title":"Represents a value type that can hold any kind of value"},"v1ValueUnionType":{"type":"object","properties":{"inners":{"type":"array","items":{"$ref":"#/components/schemas/v1ValueType"},"title":"The possible value types in this union"}},"title":"Represents a union value type that can be one of several possible types"},"v1ValueSensitiveType":{"type":"object","properties":{"inner":{"$ref":"#/components/schemas/v1ValueType"}},"title":"Represents a value type that contains sensitive information"},"v1ValueEnumType":{"type":"object","properties":{"is_a":{"type":"string","title":"Semantic classification of what this enum represents"},"members":{"type":"array","items":{"$ref":"#/components/schemas/v1ValueEnumTypeMember"},"title":"The available options/members of this enum"},"description":{"type":"string","title":"Optional human-readable description of this enum type"}},"title":"Represents an enumeration value type with predefined options"},"v1ValueEnumTypeMember":{"type":"object","properties":{"name":{"type":"string","title":"The programmatic name of this enum member"},"description":{"type":"string","title":"Optional human-readable description of this enum member"}},"title":"Represents a single member/option within an enum value type"},"v1ValueGenericDictionaryType":{"type":"object","properties":{"key_type":{"$ref":"#/components/schemas/v1ValueType"},"value_type":{"$ref":"#/components/schemas/v1ValueType"}},"title":"Represent a generic dictionary that can hold any entry of a particular key and value type"},"v1ValueNoneType":{"type":"object","title":"Represents a none value type that can hold no value"},"v1TextConstraints":{"type":"object","properties":{"min_length":{"type":"integer","format":"int64","description":"Unicode scalar-value counts, not bytes or UTF-16 code units. No implicit\ntrimming, normalization, pattern evaluation or text transformation."},"max_length":{"type":"integer","format":"int64","description":"Inclusive maximum length, measured in Unicode scalar values."}},"description":"Length restrictions on a text answer."},"v1NumberConstraints":{"type":"object","properties":{"minimum":{"$ref":"#/components/schemas/v1Number"},"maximum":{"$ref":"#/components/schemas/v1Number"},"integer_only":{"type":"boolean","description":"Require a value with no fractional component."}},"description":"Exact decimal restrictions on a numeric answer."},"v1InputSpec":{"type":"object","properties":{"selection":{"$ref":"#/components/schemas/v1SelectionInput"}},"description":"How a person supplies a typed answer. Concrete controls and layout belong\nto the renderer. No option carries follow-up fields or executable behavior."},"v1SelectionInput":{"type":"object","properties":{"options":{"type":"array","items":{"$ref":"#/components/schemas/v1SelectionOption"},"description":"Distinct typed values with nonempty labels. May be empty. Each value must\nsatisfy the scalar/element type and applicable field constraints. Numeric\nequality is decimal equality, so 1 and 1.0 are the same option."},"min_selections":{"type":"integer","format":"int64","description":"Only for list fields. Omitted minimum means zero; omitted maximum means the\noption count. Bounds must be ordered and, for nonempty option sets, no greater\nthan that count. Empty selections retain bounds for answer validation.\nUnknown or repeated selections fail. Persist selections in option order,\nusing the declared option values, not user click order or numeric encoding."},"max_selections":{"type":"integer","format":"int64","description":"Inclusive maximum number of selected options."},"options_ref":{"type":"string","description":"Exact nonempty top-level WorkUnit.evidence key, not a path or expression.\nAllowed only in shared human input, mutually exclusive with inline options.\nValid evidence is an inline list of distinct scalar values matching\nthe field's scalar/element type and constraints. Inline text wrappers are\nnormalized to text. No remote reads, record projections or coercion occur.\nEach value is both the displayed choice and the submitted value: text is\nunchanged, numbers use exact decimal text, booleans use true/false, and dates\nuse YYYY-MM-DD. Empty text has no display label and is invalid as an option.\nMissing, empty or invalid choices produce an empty selection, not an input\nerror or free entry. Other fields remain usable. Initial values incompatible\nwith the resolved selection are omitted for that unit."}},"description":"A finite set of offered values. A scalar field selects one value; a list\nfield selects distinct values of its element type. Optional None is absence,\nnever an option. Use inline options or options_ref, not both. Empty selections\noffer no choices and never enable free entry. Resolved unit input and source\nanswer forms use inline options only."},"v1SelectionOption":{"type":"object","properties":{"label":{"type":"string","description":"Nonempty display wording, independent of the submitted value."},"value":{"$ref":"#/components/schemas/commonv1Value"}},"description":"Display wording and the typed value returned when this option is selected.","required":["label","value"]},"v1WorkUnitStatusCount":{"type":"object","properties":{"status":{"$ref":"#/components/schemas/v1WorkUnitStatus"},"count":{"type":"integer","format":"int32","description":"Number of attached units in this status. Always nonnegative."}},"description":"WorkUnitStatusCount counts the attached units in one lifecycle status."},"v1WorkUnitStatus":{"type":"string","enum":["WORK_UNIT_STATUS_UNSPECIFIED","WORK_UNIT_STATUS_WAITING_FOR_INPUT","WORK_UNIT_STATUS_ANSWERED","WORK_UNIT_STATUS_DISMISSED","WORK_UNIT_STATUS_WITHDRAWN","WORK_UNIT_STATUS_PROCESSING"],"default":"WORK_UNIT_STATUS_UNSPECIFIED","description":"WorkUnitStatus records attention and final resolution independently of delivery.\n\n - WORK_UNIT_STATUS_UNSPECIFIED: Default value; not returned for an existing resource.\n - WORK_UNIT_STATUS_WAITING_FOR_INPUT: Waiting for intermediate input or a direct final answer: an item input_form\nexists and input is unaccepted, or no input_form exists and the kind does\nnot require preparation. Saving either draft leaves status unchanged.\n - WORK_UNIT_STATUS_ANSWERED: Final submission and its delivery obligation are durable.\n - WORK_UNIT_STATUS_DISMISSED: Locally dismissed by item archival, arrival or rekey into an archived item.\nUnarchive restores it unless the source or operator has withdrawn it.\n - WORK_UNIT_STATUS_WITHDRAWN: Source or operator ended the occurrence without an answer.\n - WORK_UNIT_STATUS_PROCESSING: Analysis or decision preparation is pending; no current human request.\nIncludes work without an input_form whose kind requires preparation, and\nfinal-answer preparation after intermediate input acceptance."},"rpcStatus":{"type":"object","properties":{"code":{"type":"integer","format":"int32"},"message":{"type":"string"},"details":{"type":"array","items":{"$ref":"#/components/schemas/protobufAny"}}}},"protobufAny":{"type":"object","properties":{"@type":{"type":"string"}},"additionalProperties":{}},"WorkItemServiceAssignWorkItemBody":{"type":"object","properties":{"assignee":{"type":"string","title":"The person to assign the item to. The empty value returns it to\nunassigned.\nFormat: users/{user_id}"}},"description":"AssignWorkItemRequest contains the item to assign and who to assign it to.","required":["assignee"]}}},"paths":{"/api/v1/organizations/{organization_id}/workspaces/{workspace_id}/workItems/{work_item_id}:assign":{"post":{"summary":"Assign Work Item","description":"AssignWorkItem assigns an item to a person, or returns it to unassigned\nwhen the assignee is empty.\n\nRequires a non-archived item with at least one unresolved unit; otherwise\nreturns FAILED_PRECONDITION. Assignment does not restrict who may answer.","operationId":"AssignWorkItem","responses":{"200":{"description":"A successful response.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/v1WorkItem"}}}},"default":{"description":"An unexpected error response.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/rpcStatus"}}}}},"parameters":[{"name":"organization_id","in":"path","required":true,"schema":{"type":"string"}},{"name":"workspace_id","in":"path","required":true,"schema":{"type":"string"}},{"name":"work_item_id","in":"path","required":true,"schema":{"type":"string"}}],"requestBody":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/WorkItemServiceAssignWorkItemBody"}}},"required":true},"tags":["Work Items"]}}}}
```

## Decline Assignment

> DeclineAssignment hands an item back with a reason, returning it to\
> unassigned.\
> \
> Requires a non-archived item with at least one unresolved unit; otherwise\
> returns FAILED\_PRECONDITION. Unit states are unchanged.

```json
{"openapi":"3.0.0","info":{"title":"Kognitos API","version":"1.0.0"},"tags":[{"name":"Work Items","description":"Track work items and work units that need human input."}],"servers":[{"url":"https://app.us-1.kognitos.com"}],"security":[{"BearerAuth":[]}],"components":{"securitySchemes":{"BearerAuth":{"type":"http","scheme":"bearer","description":"Personal Access Token."}},"schemas":{"v1WorkItem":{"type":"object","properties":{"name":{"type":"string","title":"The resource name of the work item.\nFormat: organizations/{organization_id}/workspaces/{workspace_id}/workItems/{work_item_id}"},"kind":{"type":"string","description":"The registered kind of work, as an opaque dotted id\n(for example \"astral.automation_exception\").\n\nThis is a string rather than an enum so that registering a kind is not a\nproto change. It is validated against the registered kind descriptors, so\nthe set is closed at runtime. No behaviour in this contract branches on it.","readOnly":true},"agg_labels":{"$ref":"#/components/schemas/commonv1Value"},"question":{"type":"string","description":"The question in business language: the summary of the unit that\nmaterialised this item, verbatim.\n\nThe pointer and source summary are fixed for the item's life. Per-unit\nquestions remain available on the units; this is a queue summary.\n\nIt is one unit's words about a set. Clients use unit_counts to show the\nnumber of occurrences relevant to their view.","readOnly":true},"assignee":{"type":"string","title":"The person this item is assigned to. The empty value means unassigned,\nwhich is an ordinary state of a queue and not a missing value.\nFormat: users/{user_id}"},"declined_by":{"type":"string","title":"The person who last handed this item back. Current state rather than\nhistory; the history is in the audit log.\nFormat: users/{user_id}","readOnly":true},"decline_reason":{"type":"string","description":"Why the item was last handed back. Current state rather than history.","readOnly":true},"create_time":{"type":"string","format":"date-time","description":"The time the item was materialised. This is the item's age.","readOnly":true},"update_time":{"type":"string","format":"date-time","description":"The time the item last changed.","readOnly":true},"input_form":{"$ref":"#/components/schemas/v1FormSpec"},"input_form_etag":{"type":"string","description":"Concurrency token for input_form, present even before the first form is set.\nChanges only when the form changes. Returned by Get and List.","readOnly":true},"archive_time":{"type":"string","format":"date-time","description":"When the item was explicitly archived. Absence means not archived.\nUnarchive clears this field. Archival locally dismisses unresolved units\nand future arrivals; answered and withdrawn units retain their outcomes.","readOnly":true},"unit_counts":{"type":"array","items":{"$ref":"#/components/schemas/v1WorkUnitStatusCount"},"description":"Counts of all attached units, independent of any ListWorkItems filter.\nReturned by Get and List. Exactly one entry for every defined WorkUnitStatus\nexcept UNSPECIFIED, including zero counts; no duplicate statuses.\nSum all entries for the total, or selected statuses for a view's count.","readOnly":true},"preparation_required":{"type":"boolean","description":"Whether the UI should offer preparation before opening chat.\nSet for preparation-enabled kinds when unresolved membership changes from\nzero to nonzero, including initial arrival, unarchive and rekey. Further\narrivals while unresolved units remain do not set it again. Suppress the\ngate when no unresolved units remain, regardless of this stored flag.\nMarkWorkItemPreparationStarted clears it after Rain accepts a prompt.\nAutomatic invocation also clears it on message acceptance while its unit\nstill belongs to the item and the item is not archived.\nClearing this flag does not change unit status or indicate preparation has\nfinished. This is not execution state or an authorization boundary. Returned by Get and List.","readOnly":true},"revision":{"type":"string","format":"int64","description":"Monotonically increasing version of this resource's mutable state.\nCompare only revisions of the same resource. Includes changes to unit_counts.\nIndependent of form and draft etags; never a mutation precondition.","readOnly":true}},"description":"WorkItem groups related occurrences that can be resolved independently.\n\nAn item is not a container a source puts things in. It is materialised by\nthis service from the work units that share the labels the workspace groups\non, so its identity is those label values.\n\nEach unit records its lifecycle independently of delivery.\nA submission settles one unit; delivery records whether the source applied it.\nOne item persists for each workspace, kind and grouping identity. New units\nattach to the same item; archived items locally dismiss new arrivals. Existing\nsubmissions and assignment survive new arrivals. Rekey never changes this identity."},"commonv1Value":{"type":"object","properties":{"null_value":{"type":"string","title":"Represents the absence of a value (None/null/undefined)"},"bool_value":{"type":"boolean","title":"Boolean true/false value"},"number":{"$ref":"#/components/schemas/v1Number"},"text":{"type":"string","title":"UTF-8 encoded text string"},"date":{"$ref":"#/components/schemas/typeDate"},"timeofday":{"$ref":"#/components/schemas/typeTimeOfDay"},"datetime":{"$ref":"#/components/schemas/typeDateTime"},"time_zone":{"$ref":"#/components/schemas/typeTimeZone"},"duration":{"type":"string","title":"Signed duration representing a span of time"},"list":{"$ref":"#/components/schemas/v1List"},"dictionary":{"$ref":"#/components/schemas/v1Dictionary"},"file":{"$ref":"#/components/schemas/v1FileValue"},"table":{"$ref":"#/components/schemas/v1TableValue"},"set":{"$ref":"#/components/schemas/v1Set"},"text_value":{"$ref":"#/components/schemas/v1TextValue"},"list_value":{"$ref":"#/components/schemas/commonv1ListValue"},"set_value":{"$ref":"#/components/schemas/v1SetValue"},"dictionary_value":{"$ref":"#/components/schemas/v1DictionaryValue"}},"description":"Represents a runtime value that can be produced by the Jarvis interpreter.\n\nThis message provides a type-safe way to serialize and transmit values between\nthe Jarvis interpreter and other services via gRPC. It supports all the basic\ndata types that can be represented in the Jarvis language runtime.\n\nThe oneof structure ensures that exactly one value type is set at a time,\nproviding both type safety and efficient serialization."},"v1Number":{"type":"object","properties":{"lo":{"type":"integer","format":"int64","description":"Low 32 bits of the 96-bit mantissa."},"mid":{"type":"integer","format":"int64","description":"Middle 32 bits of the 96-bit mantissa."},"hi":{"type":"integer","format":"int64","description":"High 32 bits of the 96-bit mantissa."},"flags":{"type":"integer","format":"int64","description":"Flags word:\n - Bits 16–23: scale (0–28)\n - Bit 31: sign (0 = positive, 1 = negative)\n - Other bits must be zero."}},"description":"A fixed-precision decimal number with up to 28 fractional digits.\n\nThis message represents decimal numbers with exact precision, avoiding\nfloating-point rounding errors. It's particularly useful for financial\ncalculations, measurements, and any scenario where exact decimal\nrepresentation is required.\n\nThe value is calculated as: m / 10^e, where:\n - m is an unsigned 96-bit integer composed of (lo, mid, hi)\n - e is the scale (0–28) stored in flags bits 16–23\n - sign is encoded in flags bit 31 (0 = positive, 1 = negative)\n\nExamples:\n - 123.45 would have m=12345, e=2\n - -0.001 would have m=1, e=3, with sign bit set\n"},"typeDate":{"type":"object","properties":{"year":{"type":"integer","format":"int32","description":"Year of the date. Must be from 1 to 9999, or 0 to specify a date without\na year."},"month":{"type":"integer","format":"int32","description":"Month of a year. Must be from 1 to 12, or 0 to specify a year without a\nmonth and day."},"day":{"type":"integer","format":"int32","description":"Day of a month. Must be from 1 to 31 and valid for the year and month, or 0\nto specify a year by itself or a year and month where the day isn't\nsignificant."}},"description":"* A full date, with non-zero year, month, and day values\n* A month and day value, with a zero year, such as an anniversary\n* A year on its own, with zero month and day values\n* A year and month value, with a zero day, such as a credit card expiration\ndate\n\nRelated types are [google.type.TimeOfDay][google.type.TimeOfDay] and\n`google.protobuf.Timestamp`.","title":"Represents a whole or partial calendar date, such as a birthday. The time of\nday and time zone are either specified elsewhere or are insignificant. The\ndate is relative to the Gregorian Calendar. This can represent one of the\nfollowing:"},"typeTimeOfDay":{"type":"object","properties":{"hours":{"type":"integer","format":"int32","description":"Hours of day in 24 hour format. Should be from 0 to 23. An API may choose\nto allow the value \"24:00:00\" for scenarios like business closing time."},"minutes":{"type":"integer","format":"int32","description":"Minutes of hour of day. Must be from 0 to 59."},"seconds":{"type":"integer","format":"int32","description":"Seconds of minutes of the time. Must normally be from 0 to 59. An API may\nallow the value 60 if it allows leap-seconds."},"nanos":{"type":"integer","format":"int32","description":"Fractions of seconds in nanoseconds. Must be from 0 to 999,999,999."}},"description":"Represents a time of day. The date and time zone are either not significant\nor are specified elsewhere. An API may choose to allow leap seconds. Related\ntypes are [google.type.Date][google.type.Date] and\n`google.protobuf.Timestamp`."},"typeDateTime":{"type":"object","properties":{"year":{"type":"integer","format":"int32","description":"Optional. Year of date. Must be from 1 to 9999, or 0 if specifying a\ndatetime without a year."},"month":{"type":"integer","format":"int32","description":"Required. Month of year. Must be from 1 to 12."},"day":{"type":"integer","format":"int32","description":"Required. Day of month. Must be from 1 to 31 and valid for the year and\nmonth."},"hours":{"type":"integer","format":"int32","description":"Required. Hours of day in 24 hour format. Should be from 0 to 23. An API\nmay choose to allow the value \"24:00:00\" for scenarios like business\nclosing time."},"minutes":{"type":"integer","format":"int32","description":"Required. Minutes of hour of day. Must be from 0 to 59."},"seconds":{"type":"integer","format":"int32","description":"Required. Seconds of minutes of the time. Must normally be from 0 to 59. An\nAPI may allow the value 60 if it allows leap-seconds."},"nanos":{"type":"integer","format":"int32","description":"Required. Fractions of seconds in nanoseconds. Must be from 0 to\n999,999,999."},"utc_offset":{"type":"string","description":"UTC offset. Must be whole seconds, between -18 hours and +18 hours.\nFor example, a UTC offset of -4:00 would be represented as\n{ seconds: -14400 }."},"time_zone":{"$ref":"#/components/schemas/typeTimeZone"}},"description":"Represents civil time (or occasionally physical time).\n\nThis type can represent a civil time in one of a few possible ways:\n\n * When utc_offset is set and time_zone is unset: a civil time on a calendar\n   day with a particular offset from UTC.\n * When time_zone is set and utc_offset is unset: a civil time on a calendar\n   day in a particular time zone.\n * When neither time_zone nor utc_offset is set: a civil time on a calendar\n   day in local time.\n\nThe date is relative to the Proleptic Gregorian Calendar.\n\nIf year is 0, the DateTime is considered not to have a specific year. month\nand day must have valid, non-zero values.\n\nThis type may also be used to represent a physical time if all the date and\ntime fields are set and either case of the `time_offset` oneof is set.\nConsider using `Timestamp` message for physical time instead. If your use\ncase also would like to store the user's timezone, that can be done in\nanother field.\n\nThis type is more flexible than some applications may want. Make sure to\ndocument and validate your application's limitations."},"typeTimeZone":{"type":"object","properties":{"id":{"type":"string","description":"IANA Time Zone Database time zone, e.g. \"America/New_York\"."},"version":{"type":"string","description":"Optional. IANA Time Zone Database version number, e.g. \"2019a\"."}},"description":"Represents a time zone from the\n[IANA Time Zone Database](https://www.iana.org/time-zones)."},"v1List":{"type":"object","properties":{"items":{"type":"array","items":{"$ref":"#/components/schemas/commonV1Value"},"title":"The ordered sequence of values in this list"}},"description":"Represents an ordered collection of values (similar to arrays or lists).\n\nThis message can contain any number of Value elements in a specific order.\nLists are mutable and can grow or shrink during runtime. Elements can be\naccessed by their zero-based index position.\n\nExamples:\n - [1, 2, 3] - list of numbers\n - [\"hello\", \"world\"] - list of strings\n - [true, 42, \"mixed\"] - list with mixed types\n - [[1, 2], [3, 4]] - nested lists"},"commonV1Value":{"type":"object","properties":{"null_value":{"type":"string","title":"Represents the absence of a value (None/null/undefined)"},"bool_value":{"type":"boolean","title":"Boolean true/false value"},"number":{"$ref":"#/components/schemas/v1Number"},"text":{"type":"string","title":"UTF-8 encoded text string"},"date":{"$ref":"#/components/schemas/typeDate"},"timeofday":{"$ref":"#/components/schemas/typeTimeOfDay"},"datetime":{"$ref":"#/components/schemas/typeDateTime"},"time_zone":{"$ref":"#/components/schemas/typeTimeZone"},"duration":{"type":"string","title":"Signed duration representing a span of time"},"list":{"$ref":"#/components/schemas/v1List"},"dictionary":{"$ref":"#/components/schemas/v1Dictionary"},"file":{"$ref":"#/components/schemas/v1FileValue"},"table":{"$ref":"#/components/schemas/v1TableValue"},"set":{"$ref":"#/components/schemas/v1Set"},"text_value":{"$ref":"#/components/schemas/v1TextValue"},"list_value":{"$ref":"#/components/schemas/commonv1ListValue"},"set_value":{"$ref":"#/components/schemas/v1SetValue"},"dictionary_value":{"$ref":"#/components/schemas/v1DictionaryValue"}},"description":"Represents a runtime value that can be produced by the Jarvis interpreter.\n\nThis message provides a type-safe way to serialize and transmit values between\nthe Jarvis interpreter and other services via gRPC. It supports all the basic\ndata types that can be represented in the Jarvis language runtime.\n\nThe oneof structure ensures that exactly one value type is set at a time,\nproviding both type safety and efficient serialization."},"v1Dictionary":{"type":"object","properties":{"entries":{"type":"array","items":{"$ref":"#/components/schemas/v1DictionaryEntry"},"title":"The key-value pairs stored in this dictionary"}},"description":"Represents a key-value mapping (similar to hash maps or dictionaries).\n\nThis message stores associations between keys and values, where keys must be\nhashable types (null, bool, Number, string, Date, TimeOfDay, DateTime, TimeZone). Keys are\nunique within a dictionary - duplicate keys will overwrite previous values.\n\nThe dictionary maintains insertion order for consistent iteration behavior.\n\nExamples:\n - {\"name\": \"John\", \"age\": 30} - string keys with mixed values\n - {1: \"one\", 2: \"two\"} - number keys with string values\n - {\"nested\": {\"inner\": \"value\"}} - nested dictionaries"},"v1DictionaryEntry":{"type":"object","properties":{"key":{"$ref":"#/components/schemas/v1HashableValue"},"value":{"$ref":"#/components/schemas/commonV1Value"}},"description":"Represents a single key-value pair within a Dictionary.\n\nBoth key and value can be any Value type, though keys should be\nhashable types for proper dictionary behavior. Non-hashable keys\n(like lists or dictionaries) may cause runtime errors."},"v1HashableValue":{"type":"object","properties":{"bool_value":{"type":"boolean","title":"Boolean true/false value"},"number":{"$ref":"#/components/schemas/v1Number"},"text":{"type":"string","title":"UTF-8 encoded text string"},"date":{"$ref":"#/components/schemas/typeDate"},"timeofday":{"$ref":"#/components/schemas/typeTimeOfDay"},"datetime":{"$ref":"#/components/schemas/typeDateTime"},"duration":{"type":"string","title":"Signed duration representing a span of time"},"text_value":{"$ref":"#/components/schemas/v1TextValue"}},"description":"Represents a hashable value that can be used as a dictionary key.\n\nThis message contains only the hashable types from the Value message,\ncorresponding to Python's hashable types. These types can be safely\nused as keys in maps and dictionaries.\n\nHashable types include: bool, Number, string, Date, TimeOfDay, DateTime\nand Duration."},"v1TextValue":{"type":"object","properties":{"remote":{"type":"string","title":"Reference to remote text content via URL or file path"},"inline":{"type":"string","title":"Text content embedded directly in the message"}},"description":"Represents a text value that can be either stored inline or referenced remotely.\n\nThis message provides flexibility for handling text strings in the Jarvis interpreter:\n- Small strings can be embedded directly using the inline option\n- Large strings can be referenced by URL using the remote option\n- The choice depends on string size, network constraints, and access patterns"},"v1FileValue":{"type":"object","properties":{"remote":{"type":"string","title":"Reference to a remote file via URL or file path"},"inline":{"$ref":"#/components/schemas/v1File"}},"description":"Represents a file value that can be either stored inline or referenced remotely.\n\nThis message provides flexibility for handling files in the Jarvis interpreter:\n- Small files can be embedded directly using the inline option\n- Large files can be referenced by URL/path using the remote option\n- The choice depends on file size, network constraints, and access patterns"},"v1File":{"type":"object","properties":{"content":{"type":"string","format":"byte","title":"The raw binary content of the file"},"name":{"type":"string","title":"The name of the file, including extension if applicable"}},"description":"Represents a file with its name and binary content.\n\nThis message contains the complete file data including both metadata\n(filename) and the actual file content as raw bytes. It's used for\nembedding files directly within messages when the file size is\nmanageable and immediate access is required.\n\nExamples:\n - Configuration files\n - Small text or binary files\n - Generated reports or documents\n - Temporary files created during execution\n"},"v1TableValue":{"type":"object","properties":{"remote":{"type":"string","title":"Reference to a remote table via URL or file path (feather-v2 format)"},"inline":{"$ref":"#/components/schemas/v1Table"}},"description":"Represents a table value that can be either stored inline or referenced remotely."},"v1Table":{"type":"object","properties":{"data":{"type":"string","format":"byte","title":"The table data serialized in feather-v2 format"}},"description":"Represents a table with data in feather-v2 format.\n\nThis message contains the complete table data serialized using the\nfeather-v2 format, which provides efficient columnar storage and\nfast serialization/deserialization for tabular data."},"v1Set":{"type":"object","properties":{"items":{"type":"array","items":{"$ref":"#/components/schemas/v1HashableValue"},"title":"The unique elements stored in this set\nAll elements must be hashable types"}},"description":"Represents an unordered collection of unique values.\n\nThis message stores a collection of unique elements, where duplicate values\nare automatically removed. Only hashable types can be stored in sets.\nSets are useful for membership testing, removing duplicates, and mathematical\nset operations like union, intersection, and difference.\n\nThe set does not maintain insertion order - elements may appear in any order\nduring iteration.\n\nExamples:\n - {1, 2, 3} - set of numbers\n - {\"apple\", \"banana\", \"cherry\"} - set of strings\n - {true, false} - set of booleans\n - {1, \"hello\", true} - set with mixed hashable types"},"commonv1ListValue":{"type":"object","properties":{"remote":{"type":"string","title":"Reference to remote list data via URL or file path"},"inline":{"$ref":"#/components/schemas/v1List"}},"description":"Represents a list value that can be either stored inline or referenced remotely.\n\nThis message provides flexibility for handling large lists:\n- Small lists can be embedded directly using the inline option\n- Large lists can be referenced by URL using the remote option"},"v1SetValue":{"type":"object","properties":{"remote":{"type":"string","title":"Reference to remote set data via URL or file path"},"inline":{"$ref":"#/components/schemas/v1Set"}},"description":"Represents a set value that can be either stored inline or referenced remotely.\n\nThis message provides flexibility for handling large sets:\n- Small sets can be embedded directly using the inline option\n- Large sets can be referenced by URL using the remote option"},"v1DictionaryValue":{"type":"object","properties":{"remote":{"type":"string","title":"Reference to remote dictionary data via URL or file path"},"inline":{"$ref":"#/components/schemas/v1Dictionary"}},"description":"Represents a dictionary value that can be either stored inline or referenced remotely.\n\nThis message provides flexibility for handling large dictionaries:\n- Small dictionaries can be embedded directly using the inline option\n- Large dictionaries can be referenced by URL using the remote option"},"v1FormSpec":{"type":"object","properties":{"fields":{"type":"array","items":{"$ref":"#/components/schemas/v1FormField"},"description":"At least one question, with unique nonempty keys. Order is the semantic\nreading sequence, not a prescribed screen layout."}},"description":"A set of typed questions for human input or source answers (R6, R13, R14).\nField types derive the returned record type. The platform selects controls\nand layout; there are no widgets, scripts, URLs, or executable expressions.\nShared human input may reference options in each unit's immutable evidence.\nWorkbench resolves those references into the unit's InputContext before use.\nSource answer forms must already be resolved. Filled values are separate messages.\nSources persist their answer form with the pending invocation for recovery.","required":["fields"]},"v1FormField":{"type":"object","properties":{"key":{"type":"string","description":"Stable record key. Unique within its field set; nonempty."},"label":{"type":"string","description":"Business-facing wording, independent of the programmatic key; nonempty."},"help_text":{"type":"string","description":"Optional guidance displayed with the question."},"value_type":{"$ref":"#/components/schemas/v1ValueType"},"initial_value":{"$ref":"#/components/schemas/commonv1Value"},"text":{"$ref":"#/components/schemas/v1TextConstraints"},"number":{"$ref":"#/components/schemas/v1NumberConstraints"},"input_spec":{"$ref":"#/components/schemas/v1InputSpec"}},"description":"One named question, its answer type and its input behavior.","required":["key","label","value_type"]},"v1ValueType":{"type":"object","properties":{"scalar_type":{"$ref":"#/components/schemas/v1ValueScalarType"},"optional_type":{"$ref":"#/components/schemas/v1ValueOptionalType"},"list_type":{"$ref":"#/components/schemas/v1ValueListType"},"dictionary_type":{"$ref":"#/components/schemas/v1ValueDictionaryType"},"table_type":{"$ref":"#/components/schemas/v1ValueTableType"},"opaque_type":{"$ref":"#/components/schemas/v1ValueOpaqueType"},"any_type":{"$ref":"#/components/schemas/v1ValueAnyType"},"union_type":{"$ref":"#/components/schemas/v1ValueUnionType"},"sensitive_type":{"$ref":"#/components/schemas/v1ValueSensitiveType"},"enum_type":{"$ref":"#/components/schemas/v1ValueEnumType"},"generic_dictionary_type":{"$ref":"#/components/schemas/v1ValueGenericDictionaryType"},"none_type":{"$ref":"#/components/schemas/v1ValueNoneType"}},"title":"Represents a complete value type definition using a discriminated union"},"v1ValueScalarType":{"type":"string","enum":["VALUE_SCALAR_TYPE_UNSPECIFIED","VALUE_SCALAR_TYPE_TEXT","VALUE_SCALAR_TYPE_NUMBER","VALUE_SCALAR_TYPE_BOOLEAN","VALUE_SCALAR_TYPE_DATETIME","VALUE_SCALAR_TYPE_DATE","VALUE_SCALAR_TYPE_TIME","VALUE_SCALAR_TYPE_FILE","VALUE_SCALAR_TYPE_TIMEDELTA"],"default":"VALUE_SCALAR_TYPE_UNSPECIFIED","description":"- VALUE_SCALAR_TYPE_UNSPECIFIED: Unspecified value type\n - VALUE_SCALAR_TYPE_TEXT: A text value type\n - VALUE_SCALAR_TYPE_NUMBER: A number value type\n - VALUE_SCALAR_TYPE_BOOLEAN: A boolean value type\n - VALUE_SCALAR_TYPE_DATETIME: A datetime value type\n - VALUE_SCALAR_TYPE_DATE: A date value type\n - VALUE_SCALAR_TYPE_TIME: A time value type\n - VALUE_SCALAR_TYPE_FILE: A file value type\n - VALUE_SCALAR_TYPE_TIMEDELTA: A timedelta value type","title":"Supported Value Scalar Types"},"v1ValueOptionalType":{"type":"object","properties":{"inner":{"$ref":"#/components/schemas/v1ValueType"}},"title":"Represents a value type that can be optional (nullable)"},"v1ValueListType":{"type":"object","properties":{"inner":{"$ref":"#/components/schemas/v1ValueType"}},"title":"Represents a list/array value type containing elements of a specific type"},"v1ValueDictionaryType":{"type":"object","properties":{"is_a":{"type":"string","title":"Semantic classification of what this dictionary represents"},"fields":{"type":"array","items":{"$ref":"#/components/schemas/v1ValueDictionaryTypeField"},"title":"The named fields contained in this dictionary"},"description":{"type":"string","title":"Optional human-readable description of this dictionary type"}},"title":"Represents a dictionary/object value type with named fields"},"v1ValueDictionaryTypeField":{"type":"object","properties":{"key":{"type":"string","title":"The name/key of this field"},"value":{"$ref":"#/components/schemas/v1ValueType"},"description":{"type":"string","title":"Optional human-readable description of this field"}},"title":"Represents a single field within a dictionary value type"},"v1ValueTableType":{"type":"object","properties":{"is_a":{"type":"string","title":"Semantic classification of what this table represents"},"columns":{"type":"array","items":{"$ref":"#/components/schemas/v1ValueTableTypeColumn"},"title":"The columns that make up this table"},"description":{"type":"string","title":"Optional human-readable description of this table type"}},"title":"Represents a table value type with structured columns"},"v1ValueTableTypeColumn":{"type":"object","properties":{"key":{"type":"string","title":"The name/key of this column"},"value":{"$ref":"#/components/schemas/v1ValueType"},"description":{"type":"string","title":"Optional human-readable description of this column"}},"title":"Represents a single column within a table value type"},"v1ValueOpaqueType":{"type":"object","properties":{"is_a":{"type":"string","title":"Semantic classification of what this opaque type represents"},"description":{"type":"string","title":"Optional human-readable description of this opaque type"}},"title":"Represents an opaque value type with semantic meaning but unknown internal structure"},"v1ValueAnyType":{"type":"object","title":"Represents a value type that can hold any kind of value"},"v1ValueUnionType":{"type":"object","properties":{"inners":{"type":"array","items":{"$ref":"#/components/schemas/v1ValueType"},"title":"The possible value types in this union"}},"title":"Represents a union value type that can be one of several possible types"},"v1ValueSensitiveType":{"type":"object","properties":{"inner":{"$ref":"#/components/schemas/v1ValueType"}},"title":"Represents a value type that contains sensitive information"},"v1ValueEnumType":{"type":"object","properties":{"is_a":{"type":"string","title":"Semantic classification of what this enum represents"},"members":{"type":"array","items":{"$ref":"#/components/schemas/v1ValueEnumTypeMember"},"title":"The available options/members of this enum"},"description":{"type":"string","title":"Optional human-readable description of this enum type"}},"title":"Represents an enumeration value type with predefined options"},"v1ValueEnumTypeMember":{"type":"object","properties":{"name":{"type":"string","title":"The programmatic name of this enum member"},"description":{"type":"string","title":"Optional human-readable description of this enum member"}},"title":"Represents a single member/option within an enum value type"},"v1ValueGenericDictionaryType":{"type":"object","properties":{"key_type":{"$ref":"#/components/schemas/v1ValueType"},"value_type":{"$ref":"#/components/schemas/v1ValueType"}},"title":"Represent a generic dictionary that can hold any entry of a particular key and value type"},"v1ValueNoneType":{"type":"object","title":"Represents a none value type that can hold no value"},"v1TextConstraints":{"type":"object","properties":{"min_length":{"type":"integer","format":"int64","description":"Unicode scalar-value counts, not bytes or UTF-16 code units. No implicit\ntrimming, normalization, pattern evaluation or text transformation."},"max_length":{"type":"integer","format":"int64","description":"Inclusive maximum length, measured in Unicode scalar values."}},"description":"Length restrictions on a text answer."},"v1NumberConstraints":{"type":"object","properties":{"minimum":{"$ref":"#/components/schemas/v1Number"},"maximum":{"$ref":"#/components/schemas/v1Number"},"integer_only":{"type":"boolean","description":"Require a value with no fractional component."}},"description":"Exact decimal restrictions on a numeric answer."},"v1InputSpec":{"type":"object","properties":{"selection":{"$ref":"#/components/schemas/v1SelectionInput"}},"description":"How a person supplies a typed answer. Concrete controls and layout belong\nto the renderer. No option carries follow-up fields or executable behavior."},"v1SelectionInput":{"type":"object","properties":{"options":{"type":"array","items":{"$ref":"#/components/schemas/v1SelectionOption"},"description":"Distinct typed values with nonempty labels. May be empty. Each value must\nsatisfy the scalar/element type and applicable field constraints. Numeric\nequality is decimal equality, so 1 and 1.0 are the same option."},"min_selections":{"type":"integer","format":"int64","description":"Only for list fields. Omitted minimum means zero; omitted maximum means the\noption count. Bounds must be ordered and, for nonempty option sets, no greater\nthan that count. Empty selections retain bounds for answer validation.\nUnknown or repeated selections fail. Persist selections in option order,\nusing the declared option values, not user click order or numeric encoding."},"max_selections":{"type":"integer","format":"int64","description":"Inclusive maximum number of selected options."},"options_ref":{"type":"string","description":"Exact nonempty top-level WorkUnit.evidence key, not a path or expression.\nAllowed only in shared human input, mutually exclusive with inline options.\nValid evidence is an inline list of distinct scalar values matching\nthe field's scalar/element type and constraints. Inline text wrappers are\nnormalized to text. No remote reads, record projections or coercion occur.\nEach value is both the displayed choice and the submitted value: text is\nunchanged, numbers use exact decimal text, booleans use true/false, and dates\nuse YYYY-MM-DD. Empty text has no display label and is invalid as an option.\nMissing, empty or invalid choices produce an empty selection, not an input\nerror or free entry. Other fields remain usable. Initial values incompatible\nwith the resolved selection are omitted for that unit."}},"description":"A finite set of offered values. A scalar field selects one value; a list\nfield selects distinct values of its element type. Optional None is absence,\nnever an option. Use inline options or options_ref, not both. Empty selections\noffer no choices and never enable free entry. Resolved unit input and source\nanswer forms use inline options only."},"v1SelectionOption":{"type":"object","properties":{"label":{"type":"string","description":"Nonempty display wording, independent of the submitted value."},"value":{"$ref":"#/components/schemas/commonv1Value"}},"description":"Display wording and the typed value returned when this option is selected.","required":["label","value"]},"v1WorkUnitStatusCount":{"type":"object","properties":{"status":{"$ref":"#/components/schemas/v1WorkUnitStatus"},"count":{"type":"integer","format":"int32","description":"Number of attached units in this status. Always nonnegative."}},"description":"WorkUnitStatusCount counts the attached units in one lifecycle status."},"v1WorkUnitStatus":{"type":"string","enum":["WORK_UNIT_STATUS_UNSPECIFIED","WORK_UNIT_STATUS_WAITING_FOR_INPUT","WORK_UNIT_STATUS_ANSWERED","WORK_UNIT_STATUS_DISMISSED","WORK_UNIT_STATUS_WITHDRAWN","WORK_UNIT_STATUS_PROCESSING"],"default":"WORK_UNIT_STATUS_UNSPECIFIED","description":"WorkUnitStatus records attention and final resolution independently of delivery.\n\n - WORK_UNIT_STATUS_UNSPECIFIED: Default value; not returned for an existing resource.\n - WORK_UNIT_STATUS_WAITING_FOR_INPUT: Waiting for intermediate input or a direct final answer: an item input_form\nexists and input is unaccepted, or no input_form exists and the kind does\nnot require preparation. Saving either draft leaves status unchanged.\n - WORK_UNIT_STATUS_ANSWERED: Final submission and its delivery obligation are durable.\n - WORK_UNIT_STATUS_DISMISSED: Locally dismissed by item archival, arrival or rekey into an archived item.\nUnarchive restores it unless the source or operator has withdrawn it.\n - WORK_UNIT_STATUS_WITHDRAWN: Source or operator ended the occurrence without an answer.\n - WORK_UNIT_STATUS_PROCESSING: Analysis or decision preparation is pending; no current human request.\nIncludes work without an input_form whose kind requires preparation, and\nfinal-answer preparation after intermediate input acceptance."},"rpcStatus":{"type":"object","properties":{"code":{"type":"integer","format":"int32"},"message":{"type":"string"},"details":{"type":"array","items":{"$ref":"#/components/schemas/protobufAny"}}}},"protobufAny":{"type":"object","properties":{"@type":{"type":"string"}},"additionalProperties":{}},"WorkItemServiceDeclineAssignmentBody":{"type":"object","properties":{"reason":{"type":"string","description":"Why the item is being handed back. Required, because the reason is what\nwhoever picks it up next needs."}},"description":"DeclineAssignmentRequest contains the item to hand back and why.","required":["reason"]}}},"paths":{"/api/v1/organizations/{organization_id}/workspaces/{workspace_id}/workItems/{work_item_id}:decline":{"post":{"summary":"Decline Assignment","description":"DeclineAssignment hands an item back with a reason, returning it to\nunassigned.\n\nRequires a non-archived item with at least one unresolved unit; otherwise\nreturns FAILED_PRECONDITION. Unit states are unchanged.","operationId":"DeclineAssignment","responses":{"200":{"description":"A successful response.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/v1WorkItem"}}}},"default":{"description":"An unexpected error response.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/rpcStatus"}}}}},"parameters":[{"name":"organization_id","in":"path","required":true,"schema":{"type":"string"}},{"name":"workspace_id","in":"path","required":true,"schema":{"type":"string"}},{"name":"work_item_id","in":"path","required":true,"schema":{"type":"string"}}],"requestBody":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/WorkItemServiceDeclineAssignmentBody"}}},"required":true},"tags":["Work Items"]}}}}
```

## Mark Work Item Preparation Started

> MarkWorkItemPreparationStarted clears the item's preparation\_required flag.\
> Clients call this after Rain accepts the preparation prompt. This operation\
> neither starts an agent nor asserts preparation succeeded. Already-clear\
> items succeed. There is no concurrency token: a delayed clear can clear a\
> flag set by a newer arrival. Final submissions and approval are unaffected.

```json
{"openapi":"3.0.0","info":{"title":"Kognitos API","version":"1.0.0"},"tags":[{"name":"Work Items","description":"Track work items and work units that need human input."}],"servers":[{"url":"https://app.us-1.kognitos.com"}],"security":[{"BearerAuth":[]}],"components":{"securitySchemes":{"BearerAuth":{"type":"http","scheme":"bearer","description":"Personal Access Token."}},"schemas":{"v1WorkItem":{"type":"object","properties":{"name":{"type":"string","title":"The resource name of the work item.\nFormat: organizations/{organization_id}/workspaces/{workspace_id}/workItems/{work_item_id}"},"kind":{"type":"string","description":"The registered kind of work, as an opaque dotted id\n(for example \"astral.automation_exception\").\n\nThis is a string rather than an enum so that registering a kind is not a\nproto change. It is validated against the registered kind descriptors, so\nthe set is closed at runtime. No behaviour in this contract branches on it.","readOnly":true},"agg_labels":{"$ref":"#/components/schemas/commonv1Value"},"question":{"type":"string","description":"The question in business language: the summary of the unit that\nmaterialised this item, verbatim.\n\nThe pointer and source summary are fixed for the item's life. Per-unit\nquestions remain available on the units; this is a queue summary.\n\nIt is one unit's words about a set. Clients use unit_counts to show the\nnumber of occurrences relevant to their view.","readOnly":true},"assignee":{"type":"string","title":"The person this item is assigned to. The empty value means unassigned,\nwhich is an ordinary state of a queue and not a missing value.\nFormat: users/{user_id}"},"declined_by":{"type":"string","title":"The person who last handed this item back. Current state rather than\nhistory; the history is in the audit log.\nFormat: users/{user_id}","readOnly":true},"decline_reason":{"type":"string","description":"Why the item was last handed back. Current state rather than history.","readOnly":true},"create_time":{"type":"string","format":"date-time","description":"The time the item was materialised. This is the item's age.","readOnly":true},"update_time":{"type":"string","format":"date-time","description":"The time the item last changed.","readOnly":true},"input_form":{"$ref":"#/components/schemas/v1FormSpec"},"input_form_etag":{"type":"string","description":"Concurrency token for input_form, present even before the first form is set.\nChanges only when the form changes. Returned by Get and List.","readOnly":true},"archive_time":{"type":"string","format":"date-time","description":"When the item was explicitly archived. Absence means not archived.\nUnarchive clears this field. Archival locally dismisses unresolved units\nand future arrivals; answered and withdrawn units retain their outcomes.","readOnly":true},"unit_counts":{"type":"array","items":{"$ref":"#/components/schemas/v1WorkUnitStatusCount"},"description":"Counts of all attached units, independent of any ListWorkItems filter.\nReturned by Get and List. Exactly one entry for every defined WorkUnitStatus\nexcept UNSPECIFIED, including zero counts; no duplicate statuses.\nSum all entries for the total, or selected statuses for a view's count.","readOnly":true},"preparation_required":{"type":"boolean","description":"Whether the UI should offer preparation before opening chat.\nSet for preparation-enabled kinds when unresolved membership changes from\nzero to nonzero, including initial arrival, unarchive and rekey. Further\narrivals while unresolved units remain do not set it again. Suppress the\ngate when no unresolved units remain, regardless of this stored flag.\nMarkWorkItemPreparationStarted clears it after Rain accepts a prompt.\nAutomatic invocation also clears it on message acceptance while its unit\nstill belongs to the item and the item is not archived.\nClearing this flag does not change unit status or indicate preparation has\nfinished. This is not execution state or an authorization boundary. Returned by Get and List.","readOnly":true},"revision":{"type":"string","format":"int64","description":"Monotonically increasing version of this resource's mutable state.\nCompare only revisions of the same resource. Includes changes to unit_counts.\nIndependent of form and draft etags; never a mutation precondition.","readOnly":true}},"description":"WorkItem groups related occurrences that can be resolved independently.\n\nAn item is not a container a source puts things in. It is materialised by\nthis service from the work units that share the labels the workspace groups\non, so its identity is those label values.\n\nEach unit records its lifecycle independently of delivery.\nA submission settles one unit; delivery records whether the source applied it.\nOne item persists for each workspace, kind and grouping identity. New units\nattach to the same item; archived items locally dismiss new arrivals. Existing\nsubmissions and assignment survive new arrivals. Rekey never changes this identity."},"commonv1Value":{"type":"object","properties":{"null_value":{"type":"string","title":"Represents the absence of a value (None/null/undefined)"},"bool_value":{"type":"boolean","title":"Boolean true/false value"},"number":{"$ref":"#/components/schemas/v1Number"},"text":{"type":"string","title":"UTF-8 encoded text string"},"date":{"$ref":"#/components/schemas/typeDate"},"timeofday":{"$ref":"#/components/schemas/typeTimeOfDay"},"datetime":{"$ref":"#/components/schemas/typeDateTime"},"time_zone":{"$ref":"#/components/schemas/typeTimeZone"},"duration":{"type":"string","title":"Signed duration representing a span of time"},"list":{"$ref":"#/components/schemas/v1List"},"dictionary":{"$ref":"#/components/schemas/v1Dictionary"},"file":{"$ref":"#/components/schemas/v1FileValue"},"table":{"$ref":"#/components/schemas/v1TableValue"},"set":{"$ref":"#/components/schemas/v1Set"},"text_value":{"$ref":"#/components/schemas/v1TextValue"},"list_value":{"$ref":"#/components/schemas/commonv1ListValue"},"set_value":{"$ref":"#/components/schemas/v1SetValue"},"dictionary_value":{"$ref":"#/components/schemas/v1DictionaryValue"}},"description":"Represents a runtime value that can be produced by the Jarvis interpreter.\n\nThis message provides a type-safe way to serialize and transmit values between\nthe Jarvis interpreter and other services via gRPC. It supports all the basic\ndata types that can be represented in the Jarvis language runtime.\n\nThe oneof structure ensures that exactly one value type is set at a time,\nproviding both type safety and efficient serialization."},"v1Number":{"type":"object","properties":{"lo":{"type":"integer","format":"int64","description":"Low 32 bits of the 96-bit mantissa."},"mid":{"type":"integer","format":"int64","description":"Middle 32 bits of the 96-bit mantissa."},"hi":{"type":"integer","format":"int64","description":"High 32 bits of the 96-bit mantissa."},"flags":{"type":"integer","format":"int64","description":"Flags word:\n - Bits 16–23: scale (0–28)\n - Bit 31: sign (0 = positive, 1 = negative)\n - Other bits must be zero."}},"description":"A fixed-precision decimal number with up to 28 fractional digits.\n\nThis message represents decimal numbers with exact precision, avoiding\nfloating-point rounding errors. It's particularly useful for financial\ncalculations, measurements, and any scenario where exact decimal\nrepresentation is required.\n\nThe value is calculated as: m / 10^e, where:\n - m is an unsigned 96-bit integer composed of (lo, mid, hi)\n - e is the scale (0–28) stored in flags bits 16–23\n - sign is encoded in flags bit 31 (0 = positive, 1 = negative)\n\nExamples:\n - 123.45 would have m=12345, e=2\n - -0.001 would have m=1, e=3, with sign bit set\n"},"typeDate":{"type":"object","properties":{"year":{"type":"integer","format":"int32","description":"Year of the date. Must be from 1 to 9999, or 0 to specify a date without\na year."},"month":{"type":"integer","format":"int32","description":"Month of a year. Must be from 1 to 12, or 0 to specify a year without a\nmonth and day."},"day":{"type":"integer","format":"int32","description":"Day of a month. Must be from 1 to 31 and valid for the year and month, or 0\nto specify a year by itself or a year and month where the day isn't\nsignificant."}},"description":"* A full date, with non-zero year, month, and day values\n* A month and day value, with a zero year, such as an anniversary\n* A year on its own, with zero month and day values\n* A year and month value, with a zero day, such as a credit card expiration\ndate\n\nRelated types are [google.type.TimeOfDay][google.type.TimeOfDay] and\n`google.protobuf.Timestamp`.","title":"Represents a whole or partial calendar date, such as a birthday. The time of\nday and time zone are either specified elsewhere or are insignificant. The\ndate is relative to the Gregorian Calendar. This can represent one of the\nfollowing:"},"typeTimeOfDay":{"type":"object","properties":{"hours":{"type":"integer","format":"int32","description":"Hours of day in 24 hour format. Should be from 0 to 23. An API may choose\nto allow the value \"24:00:00\" for scenarios like business closing time."},"minutes":{"type":"integer","format":"int32","description":"Minutes of hour of day. Must be from 0 to 59."},"seconds":{"type":"integer","format":"int32","description":"Seconds of minutes of the time. Must normally be from 0 to 59. An API may\nallow the value 60 if it allows leap-seconds."},"nanos":{"type":"integer","format":"int32","description":"Fractions of seconds in nanoseconds. Must be from 0 to 999,999,999."}},"description":"Represents a time of day. The date and time zone are either not significant\nor are specified elsewhere. An API may choose to allow leap seconds. Related\ntypes are [google.type.Date][google.type.Date] and\n`google.protobuf.Timestamp`."},"typeDateTime":{"type":"object","properties":{"year":{"type":"integer","format":"int32","description":"Optional. Year of date. Must be from 1 to 9999, or 0 if specifying a\ndatetime without a year."},"month":{"type":"integer","format":"int32","description":"Required. Month of year. Must be from 1 to 12."},"day":{"type":"integer","format":"int32","description":"Required. Day of month. Must be from 1 to 31 and valid for the year and\nmonth."},"hours":{"type":"integer","format":"int32","description":"Required. Hours of day in 24 hour format. Should be from 0 to 23. An API\nmay choose to allow the value \"24:00:00\" for scenarios like business\nclosing time."},"minutes":{"type":"integer","format":"int32","description":"Required. Minutes of hour of day. Must be from 0 to 59."},"seconds":{"type":"integer","format":"int32","description":"Required. Seconds of minutes of the time. Must normally be from 0 to 59. An\nAPI may allow the value 60 if it allows leap-seconds."},"nanos":{"type":"integer","format":"int32","description":"Required. Fractions of seconds in nanoseconds. Must be from 0 to\n999,999,999."},"utc_offset":{"type":"string","description":"UTC offset. Must be whole seconds, between -18 hours and +18 hours.\nFor example, a UTC offset of -4:00 would be represented as\n{ seconds: -14400 }."},"time_zone":{"$ref":"#/components/schemas/typeTimeZone"}},"description":"Represents civil time (or occasionally physical time).\n\nThis type can represent a civil time in one of a few possible ways:\n\n * When utc_offset is set and time_zone is unset: a civil time on a calendar\n   day with a particular offset from UTC.\n * When time_zone is set and utc_offset is unset: a civil time on a calendar\n   day in a particular time zone.\n * When neither time_zone nor utc_offset is set: a civil time on a calendar\n   day in local time.\n\nThe date is relative to the Proleptic Gregorian Calendar.\n\nIf year is 0, the DateTime is considered not to have a specific year. month\nand day must have valid, non-zero values.\n\nThis type may also be used to represent a physical time if all the date and\ntime fields are set and either case of the `time_offset` oneof is set.\nConsider using `Timestamp` message for physical time instead. If your use\ncase also would like to store the user's timezone, that can be done in\nanother field.\n\nThis type is more flexible than some applications may want. Make sure to\ndocument and validate your application's limitations."},"typeTimeZone":{"type":"object","properties":{"id":{"type":"string","description":"IANA Time Zone Database time zone, e.g. \"America/New_York\"."},"version":{"type":"string","description":"Optional. IANA Time Zone Database version number, e.g. \"2019a\"."}},"description":"Represents a time zone from the\n[IANA Time Zone Database](https://www.iana.org/time-zones)."},"v1List":{"type":"object","properties":{"items":{"type":"array","items":{"$ref":"#/components/schemas/commonV1Value"},"title":"The ordered sequence of values in this list"}},"description":"Represents an ordered collection of values (similar to arrays or lists).\n\nThis message can contain any number of Value elements in a specific order.\nLists are mutable and can grow or shrink during runtime. Elements can be\naccessed by their zero-based index position.\n\nExamples:\n - [1, 2, 3] - list of numbers\n - [\"hello\", \"world\"] - list of strings\n - [true, 42, \"mixed\"] - list with mixed types\n - [[1, 2], [3, 4]] - nested lists"},"commonV1Value":{"type":"object","properties":{"null_value":{"type":"string","title":"Represents the absence of a value (None/null/undefined)"},"bool_value":{"type":"boolean","title":"Boolean true/false value"},"number":{"$ref":"#/components/schemas/v1Number"},"text":{"type":"string","title":"UTF-8 encoded text string"},"date":{"$ref":"#/components/schemas/typeDate"},"timeofday":{"$ref":"#/components/schemas/typeTimeOfDay"},"datetime":{"$ref":"#/components/schemas/typeDateTime"},"time_zone":{"$ref":"#/components/schemas/typeTimeZone"},"duration":{"type":"string","title":"Signed duration representing a span of time"},"list":{"$ref":"#/components/schemas/v1List"},"dictionary":{"$ref":"#/components/schemas/v1Dictionary"},"file":{"$ref":"#/components/schemas/v1FileValue"},"table":{"$ref":"#/components/schemas/v1TableValue"},"set":{"$ref":"#/components/schemas/v1Set"},"text_value":{"$ref":"#/components/schemas/v1TextValue"},"list_value":{"$ref":"#/components/schemas/commonv1ListValue"},"set_value":{"$ref":"#/components/schemas/v1SetValue"},"dictionary_value":{"$ref":"#/components/schemas/v1DictionaryValue"}},"description":"Represents a runtime value that can be produced by the Jarvis interpreter.\n\nThis message provides a type-safe way to serialize and transmit values between\nthe Jarvis interpreter and other services via gRPC. It supports all the basic\ndata types that can be represented in the Jarvis language runtime.\n\nThe oneof structure ensures that exactly one value type is set at a time,\nproviding both type safety and efficient serialization."},"v1Dictionary":{"type":"object","properties":{"entries":{"type":"array","items":{"$ref":"#/components/schemas/v1DictionaryEntry"},"title":"The key-value pairs stored in this dictionary"}},"description":"Represents a key-value mapping (similar to hash maps or dictionaries).\n\nThis message stores associations between keys and values, where keys must be\nhashable types (null, bool, Number, string, Date, TimeOfDay, DateTime, TimeZone). Keys are\nunique within a dictionary - duplicate keys will overwrite previous values.\n\nThe dictionary maintains insertion order for consistent iteration behavior.\n\nExamples:\n - {\"name\": \"John\", \"age\": 30} - string keys with mixed values\n - {1: \"one\", 2: \"two\"} - number keys with string values\n - {\"nested\": {\"inner\": \"value\"}} - nested dictionaries"},"v1DictionaryEntry":{"type":"object","properties":{"key":{"$ref":"#/components/schemas/v1HashableValue"},"value":{"$ref":"#/components/schemas/commonV1Value"}},"description":"Represents a single key-value pair within a Dictionary.\n\nBoth key and value can be any Value type, though keys should be\nhashable types for proper dictionary behavior. Non-hashable keys\n(like lists or dictionaries) may cause runtime errors."},"v1HashableValue":{"type":"object","properties":{"bool_value":{"type":"boolean","title":"Boolean true/false value"},"number":{"$ref":"#/components/schemas/v1Number"},"text":{"type":"string","title":"UTF-8 encoded text string"},"date":{"$ref":"#/components/schemas/typeDate"},"timeofday":{"$ref":"#/components/schemas/typeTimeOfDay"},"datetime":{"$ref":"#/components/schemas/typeDateTime"},"duration":{"type":"string","title":"Signed duration representing a span of time"},"text_value":{"$ref":"#/components/schemas/v1TextValue"}},"description":"Represents a hashable value that can be used as a dictionary key.\n\nThis message contains only the hashable types from the Value message,\ncorresponding to Python's hashable types. These types can be safely\nused as keys in maps and dictionaries.\n\nHashable types include: bool, Number, string, Date, TimeOfDay, DateTime\nand Duration."},"v1TextValue":{"type":"object","properties":{"remote":{"type":"string","title":"Reference to remote text content via URL or file path"},"inline":{"type":"string","title":"Text content embedded directly in the message"}},"description":"Represents a text value that can be either stored inline or referenced remotely.\n\nThis message provides flexibility for handling text strings in the Jarvis interpreter:\n- Small strings can be embedded directly using the inline option\n- Large strings can be referenced by URL using the remote option\n- The choice depends on string size, network constraints, and access patterns"},"v1FileValue":{"type":"object","properties":{"remote":{"type":"string","title":"Reference to a remote file via URL or file path"},"inline":{"$ref":"#/components/schemas/v1File"}},"description":"Represents a file value that can be either stored inline or referenced remotely.\n\nThis message provides flexibility for handling files in the Jarvis interpreter:\n- Small files can be embedded directly using the inline option\n- Large files can be referenced by URL/path using the remote option\n- The choice depends on file size, network constraints, and access patterns"},"v1File":{"type":"object","properties":{"content":{"type":"string","format":"byte","title":"The raw binary content of the file"},"name":{"type":"string","title":"The name of the file, including extension if applicable"}},"description":"Represents a file with its name and binary content.\n\nThis message contains the complete file data including both metadata\n(filename) and the actual file content as raw bytes. It's used for\nembedding files directly within messages when the file size is\nmanageable and immediate access is required.\n\nExamples:\n - Configuration files\n - Small text or binary files\n - Generated reports or documents\n - Temporary files created during execution\n"},"v1TableValue":{"type":"object","properties":{"remote":{"type":"string","title":"Reference to a remote table via URL or file path (feather-v2 format)"},"inline":{"$ref":"#/components/schemas/v1Table"}},"description":"Represents a table value that can be either stored inline or referenced remotely."},"v1Table":{"type":"object","properties":{"data":{"type":"string","format":"byte","title":"The table data serialized in feather-v2 format"}},"description":"Represents a table with data in feather-v2 format.\n\nThis message contains the complete table data serialized using the\nfeather-v2 format, which provides efficient columnar storage and\nfast serialization/deserialization for tabular data."},"v1Set":{"type":"object","properties":{"items":{"type":"array","items":{"$ref":"#/components/schemas/v1HashableValue"},"title":"The unique elements stored in this set\nAll elements must be hashable types"}},"description":"Represents an unordered collection of unique values.\n\nThis message stores a collection of unique elements, where duplicate values\nare automatically removed. Only hashable types can be stored in sets.\nSets are useful for membership testing, removing duplicates, and mathematical\nset operations like union, intersection, and difference.\n\nThe set does not maintain insertion order - elements may appear in any order\nduring iteration.\n\nExamples:\n - {1, 2, 3} - set of numbers\n - {\"apple\", \"banana\", \"cherry\"} - set of strings\n - {true, false} - set of booleans\n - {1, \"hello\", true} - set with mixed hashable types"},"commonv1ListValue":{"type":"object","properties":{"remote":{"type":"string","title":"Reference to remote list data via URL or file path"},"inline":{"$ref":"#/components/schemas/v1List"}},"description":"Represents a list value that can be either stored inline or referenced remotely.\n\nThis message provides flexibility for handling large lists:\n- Small lists can be embedded directly using the inline option\n- Large lists can be referenced by URL using the remote option"},"v1SetValue":{"type":"object","properties":{"remote":{"type":"string","title":"Reference to remote set data via URL or file path"},"inline":{"$ref":"#/components/schemas/v1Set"}},"description":"Represents a set value that can be either stored inline or referenced remotely.\n\nThis message provides flexibility for handling large sets:\n- Small sets can be embedded directly using the inline option\n- Large sets can be referenced by URL using the remote option"},"v1DictionaryValue":{"type":"object","properties":{"remote":{"type":"string","title":"Reference to remote dictionary data via URL or file path"},"inline":{"$ref":"#/components/schemas/v1Dictionary"}},"description":"Represents a dictionary value that can be either stored inline or referenced remotely.\n\nThis message provides flexibility for handling large dictionaries:\n- Small dictionaries can be embedded directly using the inline option\n- Large dictionaries can be referenced by URL using the remote option"},"v1FormSpec":{"type":"object","properties":{"fields":{"type":"array","items":{"$ref":"#/components/schemas/v1FormField"},"description":"At least one question, with unique nonempty keys. Order is the semantic\nreading sequence, not a prescribed screen layout."}},"description":"A set of typed questions for human input or source answers (R6, R13, R14).\nField types derive the returned record type. The platform selects controls\nand layout; there are no widgets, scripts, URLs, or executable expressions.\nShared human input may reference options in each unit's immutable evidence.\nWorkbench resolves those references into the unit's InputContext before use.\nSource answer forms must already be resolved. Filled values are separate messages.\nSources persist their answer form with the pending invocation for recovery.","required":["fields"]},"v1FormField":{"type":"object","properties":{"key":{"type":"string","description":"Stable record key. Unique within its field set; nonempty."},"label":{"type":"string","description":"Business-facing wording, independent of the programmatic key; nonempty."},"help_text":{"type":"string","description":"Optional guidance displayed with the question."},"value_type":{"$ref":"#/components/schemas/v1ValueType"},"initial_value":{"$ref":"#/components/schemas/commonv1Value"},"text":{"$ref":"#/components/schemas/v1TextConstraints"},"number":{"$ref":"#/components/schemas/v1NumberConstraints"},"input_spec":{"$ref":"#/components/schemas/v1InputSpec"}},"description":"One named question, its answer type and its input behavior.","required":["key","label","value_type"]},"v1ValueType":{"type":"object","properties":{"scalar_type":{"$ref":"#/components/schemas/v1ValueScalarType"},"optional_type":{"$ref":"#/components/schemas/v1ValueOptionalType"},"list_type":{"$ref":"#/components/schemas/v1ValueListType"},"dictionary_type":{"$ref":"#/components/schemas/v1ValueDictionaryType"},"table_type":{"$ref":"#/components/schemas/v1ValueTableType"},"opaque_type":{"$ref":"#/components/schemas/v1ValueOpaqueType"},"any_type":{"$ref":"#/components/schemas/v1ValueAnyType"},"union_type":{"$ref":"#/components/schemas/v1ValueUnionType"},"sensitive_type":{"$ref":"#/components/schemas/v1ValueSensitiveType"},"enum_type":{"$ref":"#/components/schemas/v1ValueEnumType"},"generic_dictionary_type":{"$ref":"#/components/schemas/v1ValueGenericDictionaryType"},"none_type":{"$ref":"#/components/schemas/v1ValueNoneType"}},"title":"Represents a complete value type definition using a discriminated union"},"v1ValueScalarType":{"type":"string","enum":["VALUE_SCALAR_TYPE_UNSPECIFIED","VALUE_SCALAR_TYPE_TEXT","VALUE_SCALAR_TYPE_NUMBER","VALUE_SCALAR_TYPE_BOOLEAN","VALUE_SCALAR_TYPE_DATETIME","VALUE_SCALAR_TYPE_DATE","VALUE_SCALAR_TYPE_TIME","VALUE_SCALAR_TYPE_FILE","VALUE_SCALAR_TYPE_TIMEDELTA"],"default":"VALUE_SCALAR_TYPE_UNSPECIFIED","description":"- VALUE_SCALAR_TYPE_UNSPECIFIED: Unspecified value type\n - VALUE_SCALAR_TYPE_TEXT: A text value type\n - VALUE_SCALAR_TYPE_NUMBER: A number value type\n - VALUE_SCALAR_TYPE_BOOLEAN: A boolean value type\n - VALUE_SCALAR_TYPE_DATETIME: A datetime value type\n - VALUE_SCALAR_TYPE_DATE: A date value type\n - VALUE_SCALAR_TYPE_TIME: A time value type\n - VALUE_SCALAR_TYPE_FILE: A file value type\n - VALUE_SCALAR_TYPE_TIMEDELTA: A timedelta value type","title":"Supported Value Scalar Types"},"v1ValueOptionalType":{"type":"object","properties":{"inner":{"$ref":"#/components/schemas/v1ValueType"}},"title":"Represents a value type that can be optional (nullable)"},"v1ValueListType":{"type":"object","properties":{"inner":{"$ref":"#/components/schemas/v1ValueType"}},"title":"Represents a list/array value type containing elements of a specific type"},"v1ValueDictionaryType":{"type":"object","properties":{"is_a":{"type":"string","title":"Semantic classification of what this dictionary represents"},"fields":{"type":"array","items":{"$ref":"#/components/schemas/v1ValueDictionaryTypeField"},"title":"The named fields contained in this dictionary"},"description":{"type":"string","title":"Optional human-readable description of this dictionary type"}},"title":"Represents a dictionary/object value type with named fields"},"v1ValueDictionaryTypeField":{"type":"object","properties":{"key":{"type":"string","title":"The name/key of this field"},"value":{"$ref":"#/components/schemas/v1ValueType"},"description":{"type":"string","title":"Optional human-readable description of this field"}},"title":"Represents a single field within a dictionary value type"},"v1ValueTableType":{"type":"object","properties":{"is_a":{"type":"string","title":"Semantic classification of what this table represents"},"columns":{"type":"array","items":{"$ref":"#/components/schemas/v1ValueTableTypeColumn"},"title":"The columns that make up this table"},"description":{"type":"string","title":"Optional human-readable description of this table type"}},"title":"Represents a table value type with structured columns"},"v1ValueTableTypeColumn":{"type":"object","properties":{"key":{"type":"string","title":"The name/key of this column"},"value":{"$ref":"#/components/schemas/v1ValueType"},"description":{"type":"string","title":"Optional human-readable description of this column"}},"title":"Represents a single column within a table value type"},"v1ValueOpaqueType":{"type":"object","properties":{"is_a":{"type":"string","title":"Semantic classification of what this opaque type represents"},"description":{"type":"string","title":"Optional human-readable description of this opaque type"}},"title":"Represents an opaque value type with semantic meaning but unknown internal structure"},"v1ValueAnyType":{"type":"object","title":"Represents a value type that can hold any kind of value"},"v1ValueUnionType":{"type":"object","properties":{"inners":{"type":"array","items":{"$ref":"#/components/schemas/v1ValueType"},"title":"The possible value types in this union"}},"title":"Represents a union value type that can be one of several possible types"},"v1ValueSensitiveType":{"type":"object","properties":{"inner":{"$ref":"#/components/schemas/v1ValueType"}},"title":"Represents a value type that contains sensitive information"},"v1ValueEnumType":{"type":"object","properties":{"is_a":{"type":"string","title":"Semantic classification of what this enum represents"},"members":{"type":"array","items":{"$ref":"#/components/schemas/v1ValueEnumTypeMember"},"title":"The available options/members of this enum"},"description":{"type":"string","title":"Optional human-readable description of this enum type"}},"title":"Represents an enumeration value type with predefined options"},"v1ValueEnumTypeMember":{"type":"object","properties":{"name":{"type":"string","title":"The programmatic name of this enum member"},"description":{"type":"string","title":"Optional human-readable description of this enum member"}},"title":"Represents a single member/option within an enum value type"},"v1ValueGenericDictionaryType":{"type":"object","properties":{"key_type":{"$ref":"#/components/schemas/v1ValueType"},"value_type":{"$ref":"#/components/schemas/v1ValueType"}},"title":"Represent a generic dictionary that can hold any entry of a particular key and value type"},"v1ValueNoneType":{"type":"object","title":"Represents a none value type that can hold no value"},"v1TextConstraints":{"type":"object","properties":{"min_length":{"type":"integer","format":"int64","description":"Unicode scalar-value counts, not bytes or UTF-16 code units. No implicit\ntrimming, normalization, pattern evaluation or text transformation."},"max_length":{"type":"integer","format":"int64","description":"Inclusive maximum length, measured in Unicode scalar values."}},"description":"Length restrictions on a text answer."},"v1NumberConstraints":{"type":"object","properties":{"minimum":{"$ref":"#/components/schemas/v1Number"},"maximum":{"$ref":"#/components/schemas/v1Number"},"integer_only":{"type":"boolean","description":"Require a value with no fractional component."}},"description":"Exact decimal restrictions on a numeric answer."},"v1InputSpec":{"type":"object","properties":{"selection":{"$ref":"#/components/schemas/v1SelectionInput"}},"description":"How a person supplies a typed answer. Concrete controls and layout belong\nto the renderer. No option carries follow-up fields or executable behavior."},"v1SelectionInput":{"type":"object","properties":{"options":{"type":"array","items":{"$ref":"#/components/schemas/v1SelectionOption"},"description":"Distinct typed values with nonempty labels. May be empty. Each value must\nsatisfy the scalar/element type and applicable field constraints. Numeric\nequality is decimal equality, so 1 and 1.0 are the same option."},"min_selections":{"type":"integer","format":"int64","description":"Only for list fields. Omitted minimum means zero; omitted maximum means the\noption count. Bounds must be ordered and, for nonempty option sets, no greater\nthan that count. Empty selections retain bounds for answer validation.\nUnknown or repeated selections fail. Persist selections in option order,\nusing the declared option values, not user click order or numeric encoding."},"max_selections":{"type":"integer","format":"int64","description":"Inclusive maximum number of selected options."},"options_ref":{"type":"string","description":"Exact nonempty top-level WorkUnit.evidence key, not a path or expression.\nAllowed only in shared human input, mutually exclusive with inline options.\nValid evidence is an inline list of distinct scalar values matching\nthe field's scalar/element type and constraints. Inline text wrappers are\nnormalized to text. No remote reads, record projections or coercion occur.\nEach value is both the displayed choice and the submitted value: text is\nunchanged, numbers use exact decimal text, booleans use true/false, and dates\nuse YYYY-MM-DD. Empty text has no display label and is invalid as an option.\nMissing, empty or invalid choices produce an empty selection, not an input\nerror or free entry. Other fields remain usable. Initial values incompatible\nwith the resolved selection are omitted for that unit."}},"description":"A finite set of offered values. A scalar field selects one value; a list\nfield selects distinct values of its element type. Optional None is absence,\nnever an option. Use inline options or options_ref, not both. Empty selections\noffer no choices and never enable free entry. Resolved unit input and source\nanswer forms use inline options only."},"v1SelectionOption":{"type":"object","properties":{"label":{"type":"string","description":"Nonempty display wording, independent of the submitted value."},"value":{"$ref":"#/components/schemas/commonv1Value"}},"description":"Display wording and the typed value returned when this option is selected.","required":["label","value"]},"v1WorkUnitStatusCount":{"type":"object","properties":{"status":{"$ref":"#/components/schemas/v1WorkUnitStatus"},"count":{"type":"integer","format":"int32","description":"Number of attached units in this status. Always nonnegative."}},"description":"WorkUnitStatusCount counts the attached units in one lifecycle status."},"v1WorkUnitStatus":{"type":"string","enum":["WORK_UNIT_STATUS_UNSPECIFIED","WORK_UNIT_STATUS_WAITING_FOR_INPUT","WORK_UNIT_STATUS_ANSWERED","WORK_UNIT_STATUS_DISMISSED","WORK_UNIT_STATUS_WITHDRAWN","WORK_UNIT_STATUS_PROCESSING"],"default":"WORK_UNIT_STATUS_UNSPECIFIED","description":"WorkUnitStatus records attention and final resolution independently of delivery.\n\n - WORK_UNIT_STATUS_UNSPECIFIED: Default value; not returned for an existing resource.\n - WORK_UNIT_STATUS_WAITING_FOR_INPUT: Waiting for intermediate input or a direct final answer: an item input_form\nexists and input is unaccepted, or no input_form exists and the kind does\nnot require preparation. Saving either draft leaves status unchanged.\n - WORK_UNIT_STATUS_ANSWERED: Final submission and its delivery obligation are durable.\n - WORK_UNIT_STATUS_DISMISSED: Locally dismissed by item archival, arrival or rekey into an archived item.\nUnarchive restores it unless the source or operator has withdrawn it.\n - WORK_UNIT_STATUS_WITHDRAWN: Source or operator ended the occurrence without an answer.\n - WORK_UNIT_STATUS_PROCESSING: Analysis or decision preparation is pending; no current human request.\nIncludes work without an input_form whose kind requires preparation, and\nfinal-answer preparation after intermediate input acceptance."},"rpcStatus":{"type":"object","properties":{"code":{"type":"integer","format":"int32"},"message":{"type":"string"},"details":{"type":"array","items":{"$ref":"#/components/schemas/protobufAny"}}}},"protobufAny":{"type":"object","properties":{"@type":{"type":"string"}},"additionalProperties":{}},"WorkItemServiceMarkWorkItemPreparationStartedBody":{"type":"object","description":"MarkWorkItemPreparationStartedRequest identifies the item whose flag is cleared."}}},"paths":{"/api/v1/organizations/{organization_id}/workspaces/{workspace_id}/workItems/{work_item_id}:markPreparationStarted":{"post":{"summary":"Mark Work Item Preparation Started","description":"MarkWorkItemPreparationStarted clears the item's preparation_required flag.\nClients call this after Rain accepts the preparation prompt. This operation\nneither starts an agent nor asserts preparation succeeded. Already-clear\nitems succeed. There is no concurrency token: a delayed clear can clear a\nflag set by a newer arrival. Final submissions and approval are unaffected.","operationId":"MarkWorkItemPreparationStarted","responses":{"200":{"description":"A successful response.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/v1WorkItem"}}}},"default":{"description":"An unexpected error response.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/rpcStatus"}}}}},"parameters":[{"name":"organization_id","in":"path","required":true,"schema":{"type":"string"}},{"name":"workspace_id","in":"path","required":true,"schema":{"type":"string"}},{"name":"work_item_id","in":"path","required":true,"schema":{"type":"string"}}],"requestBody":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/WorkItemServiceMarkWorkItemPreparationStartedBody"}}},"required":true},"tags":["Work Items"]}}}}
```

## Set Work Item Input Form

> SetWorkItemInputForm creates or replaces the shared human-input form.\
> Requires the current input\_form\_etag; mismatch returns ABORTED. An identical\
> form is a no-op after checking the etag. Unsupported forms return\
> INVALID\_ARGUMENT. The form is required; this operation does not remove it.\
> Resolve option references separately against each unit's immutable evidence.\
> Missing or invalid choices become empty selections without rejecting the\
> shared form or blocking other fields or units.\
> \
> Carry values into each unresolved unit's new draft only for matching field\
> keys whose values validate against the new field; do not coerce values.\
> Drop other values. Previous forms and responses are not retained.\
> Clear acceptance, rotate response etags and set WAITING\_FOR\_INPUT atomically.\
> Settled units retain their input and status, including on archived items.\
> New unresolved units use the latest form. No per-unit opt-out exists.\
> Serialize with admission, rekey, acceptance and final submission: a committed\
> submission stays final; a form change committed first invalidates old etags.

```json
{"openapi":"3.0.0","info":{"title":"Kognitos API","version":"1.0.0"},"tags":[{"name":"Work Items","description":"Track work items and work units that need human input."}],"servers":[{"url":"https://app.us-1.kognitos.com"}],"security":[{"BearerAuth":[]}],"components":{"securitySchemes":{"BearerAuth":{"type":"http","scheme":"bearer","description":"Personal Access Token."}},"schemas":{"v1WorkItem":{"type":"object","properties":{"name":{"type":"string","title":"The resource name of the work item.\nFormat: organizations/{organization_id}/workspaces/{workspace_id}/workItems/{work_item_id}"},"kind":{"type":"string","description":"The registered kind of work, as an opaque dotted id\n(for example \"astral.automation_exception\").\n\nThis is a string rather than an enum so that registering a kind is not a\nproto change. It is validated against the registered kind descriptors, so\nthe set is closed at runtime. No behaviour in this contract branches on it.","readOnly":true},"agg_labels":{"$ref":"#/components/schemas/commonv1Value"},"question":{"type":"string","description":"The question in business language: the summary of the unit that\nmaterialised this item, verbatim.\n\nThe pointer and source summary are fixed for the item's life. Per-unit\nquestions remain available on the units; this is a queue summary.\n\nIt is one unit's words about a set. Clients use unit_counts to show the\nnumber of occurrences relevant to their view.","readOnly":true},"assignee":{"type":"string","title":"The person this item is assigned to. The empty value means unassigned,\nwhich is an ordinary state of a queue and not a missing value.\nFormat: users/{user_id}"},"declined_by":{"type":"string","title":"The person who last handed this item back. Current state rather than\nhistory; the history is in the audit log.\nFormat: users/{user_id}","readOnly":true},"decline_reason":{"type":"string","description":"Why the item was last handed back. Current state rather than history.","readOnly":true},"create_time":{"type":"string","format":"date-time","description":"The time the item was materialised. This is the item's age.","readOnly":true},"update_time":{"type":"string","format":"date-time","description":"The time the item last changed.","readOnly":true},"input_form":{"$ref":"#/components/schemas/v1FormSpec"},"input_form_etag":{"type":"string","description":"Concurrency token for input_form, present even before the first form is set.\nChanges only when the form changes. Returned by Get and List.","readOnly":true},"archive_time":{"type":"string","format":"date-time","description":"When the item was explicitly archived. Absence means not archived.\nUnarchive clears this field. Archival locally dismisses unresolved units\nand future arrivals; answered and withdrawn units retain their outcomes.","readOnly":true},"unit_counts":{"type":"array","items":{"$ref":"#/components/schemas/v1WorkUnitStatusCount"},"description":"Counts of all attached units, independent of any ListWorkItems filter.\nReturned by Get and List. Exactly one entry for every defined WorkUnitStatus\nexcept UNSPECIFIED, including zero counts; no duplicate statuses.\nSum all entries for the total, or selected statuses for a view's count.","readOnly":true},"preparation_required":{"type":"boolean","description":"Whether the UI should offer preparation before opening chat.\nSet for preparation-enabled kinds when unresolved membership changes from\nzero to nonzero, including initial arrival, unarchive and rekey. Further\narrivals while unresolved units remain do not set it again. Suppress the\ngate when no unresolved units remain, regardless of this stored flag.\nMarkWorkItemPreparationStarted clears it after Rain accepts a prompt.\nAutomatic invocation also clears it on message acceptance while its unit\nstill belongs to the item and the item is not archived.\nClearing this flag does not change unit status or indicate preparation has\nfinished. This is not execution state or an authorization boundary. Returned by Get and List.","readOnly":true},"revision":{"type":"string","format":"int64","description":"Monotonically increasing version of this resource's mutable state.\nCompare only revisions of the same resource. Includes changes to unit_counts.\nIndependent of form and draft etags; never a mutation precondition.","readOnly":true}},"description":"WorkItem groups related occurrences that can be resolved independently.\n\nAn item is not a container a source puts things in. It is materialised by\nthis service from the work units that share the labels the workspace groups\non, so its identity is those label values.\n\nEach unit records its lifecycle independently of delivery.\nA submission settles one unit; delivery records whether the source applied it.\nOne item persists for each workspace, kind and grouping identity. New units\nattach to the same item; archived items locally dismiss new arrivals. Existing\nsubmissions and assignment survive new arrivals. Rekey never changes this identity."},"commonv1Value":{"type":"object","properties":{"null_value":{"type":"string","title":"Represents the absence of a value (None/null/undefined)"},"bool_value":{"type":"boolean","title":"Boolean true/false value"},"number":{"$ref":"#/components/schemas/v1Number"},"text":{"type":"string","title":"UTF-8 encoded text string"},"date":{"$ref":"#/components/schemas/typeDate"},"timeofday":{"$ref":"#/components/schemas/typeTimeOfDay"},"datetime":{"$ref":"#/components/schemas/typeDateTime"},"time_zone":{"$ref":"#/components/schemas/typeTimeZone"},"duration":{"type":"string","title":"Signed duration representing a span of time"},"list":{"$ref":"#/components/schemas/v1List"},"dictionary":{"$ref":"#/components/schemas/v1Dictionary"},"file":{"$ref":"#/components/schemas/v1FileValue"},"table":{"$ref":"#/components/schemas/v1TableValue"},"set":{"$ref":"#/components/schemas/v1Set"},"text_value":{"$ref":"#/components/schemas/v1TextValue"},"list_value":{"$ref":"#/components/schemas/commonv1ListValue"},"set_value":{"$ref":"#/components/schemas/v1SetValue"},"dictionary_value":{"$ref":"#/components/schemas/v1DictionaryValue"}},"description":"Represents a runtime value that can be produced by the Jarvis interpreter.\n\nThis message provides a type-safe way to serialize and transmit values between\nthe Jarvis interpreter and other services via gRPC. It supports all the basic\ndata types that can be represented in the Jarvis language runtime.\n\nThe oneof structure ensures that exactly one value type is set at a time,\nproviding both type safety and efficient serialization."},"v1Number":{"type":"object","properties":{"lo":{"type":"integer","format":"int64","description":"Low 32 bits of the 96-bit mantissa."},"mid":{"type":"integer","format":"int64","description":"Middle 32 bits of the 96-bit mantissa."},"hi":{"type":"integer","format":"int64","description":"High 32 bits of the 96-bit mantissa."},"flags":{"type":"integer","format":"int64","description":"Flags word:\n - Bits 16–23: scale (0–28)\n - Bit 31: sign (0 = positive, 1 = negative)\n - Other bits must be zero."}},"description":"A fixed-precision decimal number with up to 28 fractional digits.\n\nThis message represents decimal numbers with exact precision, avoiding\nfloating-point rounding errors. It's particularly useful for financial\ncalculations, measurements, and any scenario where exact decimal\nrepresentation is required.\n\nThe value is calculated as: m / 10^e, where:\n - m is an unsigned 96-bit integer composed of (lo, mid, hi)\n - e is the scale (0–28) stored in flags bits 16–23\n - sign is encoded in flags bit 31 (0 = positive, 1 = negative)\n\nExamples:\n - 123.45 would have m=12345, e=2\n - -0.001 would have m=1, e=3, with sign bit set\n"},"typeDate":{"type":"object","properties":{"year":{"type":"integer","format":"int32","description":"Year of the date. Must be from 1 to 9999, or 0 to specify a date without\na year."},"month":{"type":"integer","format":"int32","description":"Month of a year. Must be from 1 to 12, or 0 to specify a year without a\nmonth and day."},"day":{"type":"integer","format":"int32","description":"Day of a month. Must be from 1 to 31 and valid for the year and month, or 0\nto specify a year by itself or a year and month where the day isn't\nsignificant."}},"description":"* A full date, with non-zero year, month, and day values\n* A month and day value, with a zero year, such as an anniversary\n* A year on its own, with zero month and day values\n* A year and month value, with a zero day, such as a credit card expiration\ndate\n\nRelated types are [google.type.TimeOfDay][google.type.TimeOfDay] and\n`google.protobuf.Timestamp`.","title":"Represents a whole or partial calendar date, such as a birthday. The time of\nday and time zone are either specified elsewhere or are insignificant. The\ndate is relative to the Gregorian Calendar. This can represent one of the\nfollowing:"},"typeTimeOfDay":{"type":"object","properties":{"hours":{"type":"integer","format":"int32","description":"Hours of day in 24 hour format. Should be from 0 to 23. An API may choose\nto allow the value \"24:00:00\" for scenarios like business closing time."},"minutes":{"type":"integer","format":"int32","description":"Minutes of hour of day. Must be from 0 to 59."},"seconds":{"type":"integer","format":"int32","description":"Seconds of minutes of the time. Must normally be from 0 to 59. An API may\nallow the value 60 if it allows leap-seconds."},"nanos":{"type":"integer","format":"int32","description":"Fractions of seconds in nanoseconds. Must be from 0 to 999,999,999."}},"description":"Represents a time of day. The date and time zone are either not significant\nor are specified elsewhere. An API may choose to allow leap seconds. Related\ntypes are [google.type.Date][google.type.Date] and\n`google.protobuf.Timestamp`."},"typeDateTime":{"type":"object","properties":{"year":{"type":"integer","format":"int32","description":"Optional. Year of date. Must be from 1 to 9999, or 0 if specifying a\ndatetime without a year."},"month":{"type":"integer","format":"int32","description":"Required. Month of year. Must be from 1 to 12."},"day":{"type":"integer","format":"int32","description":"Required. Day of month. Must be from 1 to 31 and valid for the year and\nmonth."},"hours":{"type":"integer","format":"int32","description":"Required. Hours of day in 24 hour format. Should be from 0 to 23. An API\nmay choose to allow the value \"24:00:00\" for scenarios like business\nclosing time."},"minutes":{"type":"integer","format":"int32","description":"Required. Minutes of hour of day. Must be from 0 to 59."},"seconds":{"type":"integer","format":"int32","description":"Required. Seconds of minutes of the time. Must normally be from 0 to 59. An\nAPI may allow the value 60 if it allows leap-seconds."},"nanos":{"type":"integer","format":"int32","description":"Required. Fractions of seconds in nanoseconds. Must be from 0 to\n999,999,999."},"utc_offset":{"type":"string","description":"UTC offset. Must be whole seconds, between -18 hours and +18 hours.\nFor example, a UTC offset of -4:00 would be represented as\n{ seconds: -14400 }."},"time_zone":{"$ref":"#/components/schemas/typeTimeZone"}},"description":"Represents civil time (or occasionally physical time).\n\nThis type can represent a civil time in one of a few possible ways:\n\n * When utc_offset is set and time_zone is unset: a civil time on a calendar\n   day with a particular offset from UTC.\n * When time_zone is set and utc_offset is unset: a civil time on a calendar\n   day in a particular time zone.\n * When neither time_zone nor utc_offset is set: a civil time on a calendar\n   day in local time.\n\nThe date is relative to the Proleptic Gregorian Calendar.\n\nIf year is 0, the DateTime is considered not to have a specific year. month\nand day must have valid, non-zero values.\n\nThis type may also be used to represent a physical time if all the date and\ntime fields are set and either case of the `time_offset` oneof is set.\nConsider using `Timestamp` message for physical time instead. If your use\ncase also would like to store the user's timezone, that can be done in\nanother field.\n\nThis type is more flexible than some applications may want. Make sure to\ndocument and validate your application's limitations."},"typeTimeZone":{"type":"object","properties":{"id":{"type":"string","description":"IANA Time Zone Database time zone, e.g. \"America/New_York\"."},"version":{"type":"string","description":"Optional. IANA Time Zone Database version number, e.g. \"2019a\"."}},"description":"Represents a time zone from the\n[IANA Time Zone Database](https://www.iana.org/time-zones)."},"v1List":{"type":"object","properties":{"items":{"type":"array","items":{"$ref":"#/components/schemas/commonV1Value"},"title":"The ordered sequence of values in this list"}},"description":"Represents an ordered collection of values (similar to arrays or lists).\n\nThis message can contain any number of Value elements in a specific order.\nLists are mutable and can grow or shrink during runtime. Elements can be\naccessed by their zero-based index position.\n\nExamples:\n - [1, 2, 3] - list of numbers\n - [\"hello\", \"world\"] - list of strings\n - [true, 42, \"mixed\"] - list with mixed types\n - [[1, 2], [3, 4]] - nested lists"},"commonV1Value":{"type":"object","properties":{"null_value":{"type":"string","title":"Represents the absence of a value (None/null/undefined)"},"bool_value":{"type":"boolean","title":"Boolean true/false value"},"number":{"$ref":"#/components/schemas/v1Number"},"text":{"type":"string","title":"UTF-8 encoded text string"},"date":{"$ref":"#/components/schemas/typeDate"},"timeofday":{"$ref":"#/components/schemas/typeTimeOfDay"},"datetime":{"$ref":"#/components/schemas/typeDateTime"},"time_zone":{"$ref":"#/components/schemas/typeTimeZone"},"duration":{"type":"string","title":"Signed duration representing a span of time"},"list":{"$ref":"#/components/schemas/v1List"},"dictionary":{"$ref":"#/components/schemas/v1Dictionary"},"file":{"$ref":"#/components/schemas/v1FileValue"},"table":{"$ref":"#/components/schemas/v1TableValue"},"set":{"$ref":"#/components/schemas/v1Set"},"text_value":{"$ref":"#/components/schemas/v1TextValue"},"list_value":{"$ref":"#/components/schemas/commonv1ListValue"},"set_value":{"$ref":"#/components/schemas/v1SetValue"},"dictionary_value":{"$ref":"#/components/schemas/v1DictionaryValue"}},"description":"Represents a runtime value that can be produced by the Jarvis interpreter.\n\nThis message provides a type-safe way to serialize and transmit values between\nthe Jarvis interpreter and other services via gRPC. It supports all the basic\ndata types that can be represented in the Jarvis language runtime.\n\nThe oneof structure ensures that exactly one value type is set at a time,\nproviding both type safety and efficient serialization."},"v1Dictionary":{"type":"object","properties":{"entries":{"type":"array","items":{"$ref":"#/components/schemas/v1DictionaryEntry"},"title":"The key-value pairs stored in this dictionary"}},"description":"Represents a key-value mapping (similar to hash maps or dictionaries).\n\nThis message stores associations between keys and values, where keys must be\nhashable types (null, bool, Number, string, Date, TimeOfDay, DateTime, TimeZone). Keys are\nunique within a dictionary - duplicate keys will overwrite previous values.\n\nThe dictionary maintains insertion order for consistent iteration behavior.\n\nExamples:\n - {\"name\": \"John\", \"age\": 30} - string keys with mixed values\n - {1: \"one\", 2: \"two\"} - number keys with string values\n - {\"nested\": {\"inner\": \"value\"}} - nested dictionaries"},"v1DictionaryEntry":{"type":"object","properties":{"key":{"$ref":"#/components/schemas/v1HashableValue"},"value":{"$ref":"#/components/schemas/commonV1Value"}},"description":"Represents a single key-value pair within a Dictionary.\n\nBoth key and value can be any Value type, though keys should be\nhashable types for proper dictionary behavior. Non-hashable keys\n(like lists or dictionaries) may cause runtime errors."},"v1HashableValue":{"type":"object","properties":{"bool_value":{"type":"boolean","title":"Boolean true/false value"},"number":{"$ref":"#/components/schemas/v1Number"},"text":{"type":"string","title":"UTF-8 encoded text string"},"date":{"$ref":"#/components/schemas/typeDate"},"timeofday":{"$ref":"#/components/schemas/typeTimeOfDay"},"datetime":{"$ref":"#/components/schemas/typeDateTime"},"duration":{"type":"string","title":"Signed duration representing a span of time"},"text_value":{"$ref":"#/components/schemas/v1TextValue"}},"description":"Represents a hashable value that can be used as a dictionary key.\n\nThis message contains only the hashable types from the Value message,\ncorresponding to Python's hashable types. These types can be safely\nused as keys in maps and dictionaries.\n\nHashable types include: bool, Number, string, Date, TimeOfDay, DateTime\nand Duration."},"v1TextValue":{"type":"object","properties":{"remote":{"type":"string","title":"Reference to remote text content via URL or file path"},"inline":{"type":"string","title":"Text content embedded directly in the message"}},"description":"Represents a text value that can be either stored inline or referenced remotely.\n\nThis message provides flexibility for handling text strings in the Jarvis interpreter:\n- Small strings can be embedded directly using the inline option\n- Large strings can be referenced by URL using the remote option\n- The choice depends on string size, network constraints, and access patterns"},"v1FileValue":{"type":"object","properties":{"remote":{"type":"string","title":"Reference to a remote file via URL or file path"},"inline":{"$ref":"#/components/schemas/v1File"}},"description":"Represents a file value that can be either stored inline or referenced remotely.\n\nThis message provides flexibility for handling files in the Jarvis interpreter:\n- Small files can be embedded directly using the inline option\n- Large files can be referenced by URL/path using the remote option\n- The choice depends on file size, network constraints, and access patterns"},"v1File":{"type":"object","properties":{"content":{"type":"string","format":"byte","title":"The raw binary content of the file"},"name":{"type":"string","title":"The name of the file, including extension if applicable"}},"description":"Represents a file with its name and binary content.\n\nThis message contains the complete file data including both metadata\n(filename) and the actual file content as raw bytes. It's used for\nembedding files directly within messages when the file size is\nmanageable and immediate access is required.\n\nExamples:\n - Configuration files\n - Small text or binary files\n - Generated reports or documents\n - Temporary files created during execution\n"},"v1TableValue":{"type":"object","properties":{"remote":{"type":"string","title":"Reference to a remote table via URL or file path (feather-v2 format)"},"inline":{"$ref":"#/components/schemas/v1Table"}},"description":"Represents a table value that can be either stored inline or referenced remotely."},"v1Table":{"type":"object","properties":{"data":{"type":"string","format":"byte","title":"The table data serialized in feather-v2 format"}},"description":"Represents a table with data in feather-v2 format.\n\nThis message contains the complete table data serialized using the\nfeather-v2 format, which provides efficient columnar storage and\nfast serialization/deserialization for tabular data."},"v1Set":{"type":"object","properties":{"items":{"type":"array","items":{"$ref":"#/components/schemas/v1HashableValue"},"title":"The unique elements stored in this set\nAll elements must be hashable types"}},"description":"Represents an unordered collection of unique values.\n\nThis message stores a collection of unique elements, where duplicate values\nare automatically removed. Only hashable types can be stored in sets.\nSets are useful for membership testing, removing duplicates, and mathematical\nset operations like union, intersection, and difference.\n\nThe set does not maintain insertion order - elements may appear in any order\nduring iteration.\n\nExamples:\n - {1, 2, 3} - set of numbers\n - {\"apple\", \"banana\", \"cherry\"} - set of strings\n - {true, false} - set of booleans\n - {1, \"hello\", true} - set with mixed hashable types"},"commonv1ListValue":{"type":"object","properties":{"remote":{"type":"string","title":"Reference to remote list data via URL or file path"},"inline":{"$ref":"#/components/schemas/v1List"}},"description":"Represents a list value that can be either stored inline or referenced remotely.\n\nThis message provides flexibility for handling large lists:\n- Small lists can be embedded directly using the inline option\n- Large lists can be referenced by URL using the remote option"},"v1SetValue":{"type":"object","properties":{"remote":{"type":"string","title":"Reference to remote set data via URL or file path"},"inline":{"$ref":"#/components/schemas/v1Set"}},"description":"Represents a set value that can be either stored inline or referenced remotely.\n\nThis message provides flexibility for handling large sets:\n- Small sets can be embedded directly using the inline option\n- Large sets can be referenced by URL using the remote option"},"v1DictionaryValue":{"type":"object","properties":{"remote":{"type":"string","title":"Reference to remote dictionary data via URL or file path"},"inline":{"$ref":"#/components/schemas/v1Dictionary"}},"description":"Represents a dictionary value that can be either stored inline or referenced remotely.\n\nThis message provides flexibility for handling large dictionaries:\n- Small dictionaries can be embedded directly using the inline option\n- Large dictionaries can be referenced by URL using the remote option"},"v1FormSpec":{"type":"object","properties":{"fields":{"type":"array","items":{"$ref":"#/components/schemas/v1FormField"},"description":"At least one question, with unique nonempty keys. Order is the semantic\nreading sequence, not a prescribed screen layout."}},"description":"A set of typed questions for human input or source answers (R6, R13, R14).\nField types derive the returned record type. The platform selects controls\nand layout; there are no widgets, scripts, URLs, or executable expressions.\nShared human input may reference options in each unit's immutable evidence.\nWorkbench resolves those references into the unit's InputContext before use.\nSource answer forms must already be resolved. Filled values are separate messages.\nSources persist their answer form with the pending invocation for recovery.","required":["fields"]},"v1FormField":{"type":"object","properties":{"key":{"type":"string","description":"Stable record key. Unique within its field set; nonempty."},"label":{"type":"string","description":"Business-facing wording, independent of the programmatic key; nonempty."},"help_text":{"type":"string","description":"Optional guidance displayed with the question."},"value_type":{"$ref":"#/components/schemas/v1ValueType"},"initial_value":{"$ref":"#/components/schemas/commonv1Value"},"text":{"$ref":"#/components/schemas/v1TextConstraints"},"number":{"$ref":"#/components/schemas/v1NumberConstraints"},"input_spec":{"$ref":"#/components/schemas/v1InputSpec"}},"description":"One named question, its answer type and its input behavior.","required":["key","label","value_type"]},"v1ValueType":{"type":"object","properties":{"scalar_type":{"$ref":"#/components/schemas/v1ValueScalarType"},"optional_type":{"$ref":"#/components/schemas/v1ValueOptionalType"},"list_type":{"$ref":"#/components/schemas/v1ValueListType"},"dictionary_type":{"$ref":"#/components/schemas/v1ValueDictionaryType"},"table_type":{"$ref":"#/components/schemas/v1ValueTableType"},"opaque_type":{"$ref":"#/components/schemas/v1ValueOpaqueType"},"any_type":{"$ref":"#/components/schemas/v1ValueAnyType"},"union_type":{"$ref":"#/components/schemas/v1ValueUnionType"},"sensitive_type":{"$ref":"#/components/schemas/v1ValueSensitiveType"},"enum_type":{"$ref":"#/components/schemas/v1ValueEnumType"},"generic_dictionary_type":{"$ref":"#/components/schemas/v1ValueGenericDictionaryType"},"none_type":{"$ref":"#/components/schemas/v1ValueNoneType"}},"title":"Represents a complete value type definition using a discriminated union"},"v1ValueScalarType":{"type":"string","enum":["VALUE_SCALAR_TYPE_UNSPECIFIED","VALUE_SCALAR_TYPE_TEXT","VALUE_SCALAR_TYPE_NUMBER","VALUE_SCALAR_TYPE_BOOLEAN","VALUE_SCALAR_TYPE_DATETIME","VALUE_SCALAR_TYPE_DATE","VALUE_SCALAR_TYPE_TIME","VALUE_SCALAR_TYPE_FILE","VALUE_SCALAR_TYPE_TIMEDELTA"],"default":"VALUE_SCALAR_TYPE_UNSPECIFIED","description":"- VALUE_SCALAR_TYPE_UNSPECIFIED: Unspecified value type\n - VALUE_SCALAR_TYPE_TEXT: A text value type\n - VALUE_SCALAR_TYPE_NUMBER: A number value type\n - VALUE_SCALAR_TYPE_BOOLEAN: A boolean value type\n - VALUE_SCALAR_TYPE_DATETIME: A datetime value type\n - VALUE_SCALAR_TYPE_DATE: A date value type\n - VALUE_SCALAR_TYPE_TIME: A time value type\n - VALUE_SCALAR_TYPE_FILE: A file value type\n - VALUE_SCALAR_TYPE_TIMEDELTA: A timedelta value type","title":"Supported Value Scalar Types"},"v1ValueOptionalType":{"type":"object","properties":{"inner":{"$ref":"#/components/schemas/v1ValueType"}},"title":"Represents a value type that can be optional (nullable)"},"v1ValueListType":{"type":"object","properties":{"inner":{"$ref":"#/components/schemas/v1ValueType"}},"title":"Represents a list/array value type containing elements of a specific type"},"v1ValueDictionaryType":{"type":"object","properties":{"is_a":{"type":"string","title":"Semantic classification of what this dictionary represents"},"fields":{"type":"array","items":{"$ref":"#/components/schemas/v1ValueDictionaryTypeField"},"title":"The named fields contained in this dictionary"},"description":{"type":"string","title":"Optional human-readable description of this dictionary type"}},"title":"Represents a dictionary/object value type with named fields"},"v1ValueDictionaryTypeField":{"type":"object","properties":{"key":{"type":"string","title":"The name/key of this field"},"value":{"$ref":"#/components/schemas/v1ValueType"},"description":{"type":"string","title":"Optional human-readable description of this field"}},"title":"Represents a single field within a dictionary value type"},"v1ValueTableType":{"type":"object","properties":{"is_a":{"type":"string","title":"Semantic classification of what this table represents"},"columns":{"type":"array","items":{"$ref":"#/components/schemas/v1ValueTableTypeColumn"},"title":"The columns that make up this table"},"description":{"type":"string","title":"Optional human-readable description of this table type"}},"title":"Represents a table value type with structured columns"},"v1ValueTableTypeColumn":{"type":"object","properties":{"key":{"type":"string","title":"The name/key of this column"},"value":{"$ref":"#/components/schemas/v1ValueType"},"description":{"type":"string","title":"Optional human-readable description of this column"}},"title":"Represents a single column within a table value type"},"v1ValueOpaqueType":{"type":"object","properties":{"is_a":{"type":"string","title":"Semantic classification of what this opaque type represents"},"description":{"type":"string","title":"Optional human-readable description of this opaque type"}},"title":"Represents an opaque value type with semantic meaning but unknown internal structure"},"v1ValueAnyType":{"type":"object","title":"Represents a value type that can hold any kind of value"},"v1ValueUnionType":{"type":"object","properties":{"inners":{"type":"array","items":{"$ref":"#/components/schemas/v1ValueType"},"title":"The possible value types in this union"}},"title":"Represents a union value type that can be one of several possible types"},"v1ValueSensitiveType":{"type":"object","properties":{"inner":{"$ref":"#/components/schemas/v1ValueType"}},"title":"Represents a value type that contains sensitive information"},"v1ValueEnumType":{"type":"object","properties":{"is_a":{"type":"string","title":"Semantic classification of what this enum represents"},"members":{"type":"array","items":{"$ref":"#/components/schemas/v1ValueEnumTypeMember"},"title":"The available options/members of this enum"},"description":{"type":"string","title":"Optional human-readable description of this enum type"}},"title":"Represents an enumeration value type with predefined options"},"v1ValueEnumTypeMember":{"type":"object","properties":{"name":{"type":"string","title":"The programmatic name of this enum member"},"description":{"type":"string","title":"Optional human-readable description of this enum member"}},"title":"Represents a single member/option within an enum value type"},"v1ValueGenericDictionaryType":{"type":"object","properties":{"key_type":{"$ref":"#/components/schemas/v1ValueType"},"value_type":{"$ref":"#/components/schemas/v1ValueType"}},"title":"Represent a generic dictionary that can hold any entry of a particular key and value type"},"v1ValueNoneType":{"type":"object","title":"Represents a none value type that can hold no value"},"v1TextConstraints":{"type":"object","properties":{"min_length":{"type":"integer","format":"int64","description":"Unicode scalar-value counts, not bytes or UTF-16 code units. No implicit\ntrimming, normalization, pattern evaluation or text transformation."},"max_length":{"type":"integer","format":"int64","description":"Inclusive maximum length, measured in Unicode scalar values."}},"description":"Length restrictions on a text answer."},"v1NumberConstraints":{"type":"object","properties":{"minimum":{"$ref":"#/components/schemas/v1Number"},"maximum":{"$ref":"#/components/schemas/v1Number"},"integer_only":{"type":"boolean","description":"Require a value with no fractional component."}},"description":"Exact decimal restrictions on a numeric answer."},"v1InputSpec":{"type":"object","properties":{"selection":{"$ref":"#/components/schemas/v1SelectionInput"}},"description":"How a person supplies a typed answer. Concrete controls and layout belong\nto the renderer. No option carries follow-up fields or executable behavior."},"v1SelectionInput":{"type":"object","properties":{"options":{"type":"array","items":{"$ref":"#/components/schemas/v1SelectionOption"},"description":"Distinct typed values with nonempty labels. May be empty. Each value must\nsatisfy the scalar/element type and applicable field constraints. Numeric\nequality is decimal equality, so 1 and 1.0 are the same option."},"min_selections":{"type":"integer","format":"int64","description":"Only for list fields. Omitted minimum means zero; omitted maximum means the\noption count. Bounds must be ordered and, for nonempty option sets, no greater\nthan that count. Empty selections retain bounds for answer validation.\nUnknown or repeated selections fail. Persist selections in option order,\nusing the declared option values, not user click order or numeric encoding."},"max_selections":{"type":"integer","format":"int64","description":"Inclusive maximum number of selected options."},"options_ref":{"type":"string","description":"Exact nonempty top-level WorkUnit.evidence key, not a path or expression.\nAllowed only in shared human input, mutually exclusive with inline options.\nValid evidence is an inline list of distinct scalar values matching\nthe field's scalar/element type and constraints. Inline text wrappers are\nnormalized to text. No remote reads, record projections or coercion occur.\nEach value is both the displayed choice and the submitted value: text is\nunchanged, numbers use exact decimal text, booleans use true/false, and dates\nuse YYYY-MM-DD. Empty text has no display label and is invalid as an option.\nMissing, empty or invalid choices produce an empty selection, not an input\nerror or free entry. Other fields remain usable. Initial values incompatible\nwith the resolved selection are omitted for that unit."}},"description":"A finite set of offered values. A scalar field selects one value; a list\nfield selects distinct values of its element type. Optional None is absence,\nnever an option. Use inline options or options_ref, not both. Empty selections\noffer no choices and never enable free entry. Resolved unit input and source\nanswer forms use inline options only."},"v1SelectionOption":{"type":"object","properties":{"label":{"type":"string","description":"Nonempty display wording, independent of the submitted value."},"value":{"$ref":"#/components/schemas/commonv1Value"}},"description":"Display wording and the typed value returned when this option is selected.","required":["label","value"]},"v1WorkUnitStatusCount":{"type":"object","properties":{"status":{"$ref":"#/components/schemas/v1WorkUnitStatus"},"count":{"type":"integer","format":"int32","description":"Number of attached units in this status. Always nonnegative."}},"description":"WorkUnitStatusCount counts the attached units in one lifecycle status."},"v1WorkUnitStatus":{"type":"string","enum":["WORK_UNIT_STATUS_UNSPECIFIED","WORK_UNIT_STATUS_WAITING_FOR_INPUT","WORK_UNIT_STATUS_ANSWERED","WORK_UNIT_STATUS_DISMISSED","WORK_UNIT_STATUS_WITHDRAWN","WORK_UNIT_STATUS_PROCESSING"],"default":"WORK_UNIT_STATUS_UNSPECIFIED","description":"WorkUnitStatus records attention and final resolution independently of delivery.\n\n - WORK_UNIT_STATUS_UNSPECIFIED: Default value; not returned for an existing resource.\n - WORK_UNIT_STATUS_WAITING_FOR_INPUT: Waiting for intermediate input or a direct final answer: an item input_form\nexists and input is unaccepted, or no input_form exists and the kind does\nnot require preparation. Saving either draft leaves status unchanged.\n - WORK_UNIT_STATUS_ANSWERED: Final submission and its delivery obligation are durable.\n - WORK_UNIT_STATUS_DISMISSED: Locally dismissed by item archival, arrival or rekey into an archived item.\nUnarchive restores it unless the source or operator has withdrawn it.\n - WORK_UNIT_STATUS_WITHDRAWN: Source or operator ended the occurrence without an answer.\n - WORK_UNIT_STATUS_PROCESSING: Analysis or decision preparation is pending; no current human request.\nIncludes work without an input_form whose kind requires preparation, and\nfinal-answer preparation after intermediate input acceptance."},"rpcStatus":{"type":"object","properties":{"code":{"type":"integer","format":"int32"},"message":{"type":"string"},"details":{"type":"array","items":{"$ref":"#/components/schemas/protobufAny"}}}},"protobufAny":{"type":"object","properties":{"@type":{"type":"string"}},"additionalProperties":{}},"WorkItemServiceSetWorkItemInputFormBody":{"type":"object","properties":{"input_form":{"$ref":"#/components/schemas/v1FormSpec"},"etag":{"type":"string","description":"Current WorkItem.input_form_etag, including for the first form."}},"description":"SetWorkItemInputFormRequest supplies the complete human-input form.","required":["input_form","etag"]}}},"paths":{"/api/v1/organizations/{organization_id}/workspaces/{workspace_id}/workItems/{work_item_id}:setInputForm":{"post":{"summary":"Set Work Item Input Form","description":"SetWorkItemInputForm creates or replaces the shared human-input form.\nRequires the current input_form_etag; mismatch returns ABORTED. An identical\nform is a no-op after checking the etag. Unsupported forms return\nINVALID_ARGUMENT. The form is required; this operation does not remove it.\nResolve option references separately against each unit's immutable evidence.\nMissing or invalid choices become empty selections without rejecting the\nshared form or blocking other fields or units.\n\nCarry values into each unresolved unit's new draft only for matching field\nkeys whose values validate against the new field; do not coerce values.\nDrop other values. Previous forms and responses are not retained.\nClear acceptance, rotate response etags and set WAITING_FOR_INPUT atomically.\nSettled units retain their input and status, including on archived items.\nNew unresolved units use the latest form. No per-unit opt-out exists.\nSerialize with admission, rekey, acceptance and final submission: a committed\nsubmission stays final; a form change committed first invalidates old etags.","operationId":"SetWorkItemInputForm","responses":{"200":{"description":"A successful response.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/v1WorkItem"}}}},"default":{"description":"An unexpected error response.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/rpcStatus"}}}}},"parameters":[{"name":"organization_id","in":"path","required":true,"schema":{"type":"string"}},{"name":"workspace_id","in":"path","required":true,"schema":{"type":"string"}},{"name":"work_item_id","in":"path","required":true,"schema":{"type":"string"}}],"requestBody":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/WorkItemServiceSetWorkItemInputFormBody"}}},"required":true},"tags":["Work Items"]}}}}
```

## Unarchive Work Item

> UnarchiveWorkItem ends persistent archival and restores locally dismissed\
> units, excluding answered and source/operator-withdrawn occurrences.\
> Restore against the latest input form, retaining only matching field keys\
> with valid values, without coercion or historical copies. Clear input when\
> no form exists. Clear acceptance and rotate response etags.\
> Restored units wait for input when a form exists, otherwise enter PROCESSING.\
> Clear archive\_time, retain assignment and allow future arrivals.\
> No source decision or delivery is created or reversed.

```json
{"openapi":"3.0.0","info":{"title":"Kognitos API","version":"1.0.0"},"tags":[{"name":"Work Items","description":"Track work items and work units that need human input."}],"servers":[{"url":"https://app.us-1.kognitos.com"}],"security":[{"BearerAuth":[]}],"components":{"securitySchemes":{"BearerAuth":{"type":"http","scheme":"bearer","description":"Personal Access Token."}},"schemas":{"v1WorkItem":{"type":"object","properties":{"name":{"type":"string","title":"The resource name of the work item.\nFormat: organizations/{organization_id}/workspaces/{workspace_id}/workItems/{work_item_id}"},"kind":{"type":"string","description":"The registered kind of work, as an opaque dotted id\n(for example \"astral.automation_exception\").\n\nThis is a string rather than an enum so that registering a kind is not a\nproto change. It is validated against the registered kind descriptors, so\nthe set is closed at runtime. No behaviour in this contract branches on it.","readOnly":true},"agg_labels":{"$ref":"#/components/schemas/commonv1Value"},"question":{"type":"string","description":"The question in business language: the summary of the unit that\nmaterialised this item, verbatim.\n\nThe pointer and source summary are fixed for the item's life. Per-unit\nquestions remain available on the units; this is a queue summary.\n\nIt is one unit's words about a set. Clients use unit_counts to show the\nnumber of occurrences relevant to their view.","readOnly":true},"assignee":{"type":"string","title":"The person this item is assigned to. The empty value means unassigned,\nwhich is an ordinary state of a queue and not a missing value.\nFormat: users/{user_id}"},"declined_by":{"type":"string","title":"The person who last handed this item back. Current state rather than\nhistory; the history is in the audit log.\nFormat: users/{user_id}","readOnly":true},"decline_reason":{"type":"string","description":"Why the item was last handed back. Current state rather than history.","readOnly":true},"create_time":{"type":"string","format":"date-time","description":"The time the item was materialised. This is the item's age.","readOnly":true},"update_time":{"type":"string","format":"date-time","description":"The time the item last changed.","readOnly":true},"input_form":{"$ref":"#/components/schemas/v1FormSpec"},"input_form_etag":{"type":"string","description":"Concurrency token for input_form, present even before the first form is set.\nChanges only when the form changes. Returned by Get and List.","readOnly":true},"archive_time":{"type":"string","format":"date-time","description":"When the item was explicitly archived. Absence means not archived.\nUnarchive clears this field. Archival locally dismisses unresolved units\nand future arrivals; answered and withdrawn units retain their outcomes.","readOnly":true},"unit_counts":{"type":"array","items":{"$ref":"#/components/schemas/v1WorkUnitStatusCount"},"description":"Counts of all attached units, independent of any ListWorkItems filter.\nReturned by Get and List. Exactly one entry for every defined WorkUnitStatus\nexcept UNSPECIFIED, including zero counts; no duplicate statuses.\nSum all entries for the total, or selected statuses for a view's count.","readOnly":true},"preparation_required":{"type":"boolean","description":"Whether the UI should offer preparation before opening chat.\nSet for preparation-enabled kinds when unresolved membership changes from\nzero to nonzero, including initial arrival, unarchive and rekey. Further\narrivals while unresolved units remain do not set it again. Suppress the\ngate when no unresolved units remain, regardless of this stored flag.\nMarkWorkItemPreparationStarted clears it after Rain accepts a prompt.\nAutomatic invocation also clears it on message acceptance while its unit\nstill belongs to the item and the item is not archived.\nClearing this flag does not change unit status or indicate preparation has\nfinished. This is not execution state or an authorization boundary. Returned by Get and List.","readOnly":true},"revision":{"type":"string","format":"int64","description":"Monotonically increasing version of this resource's mutable state.\nCompare only revisions of the same resource. Includes changes to unit_counts.\nIndependent of form and draft etags; never a mutation precondition.","readOnly":true}},"description":"WorkItem groups related occurrences that can be resolved independently.\n\nAn item is not a container a source puts things in. It is materialised by\nthis service from the work units that share the labels the workspace groups\non, so its identity is those label values.\n\nEach unit records its lifecycle independently of delivery.\nA submission settles one unit; delivery records whether the source applied it.\nOne item persists for each workspace, kind and grouping identity. New units\nattach to the same item; archived items locally dismiss new arrivals. Existing\nsubmissions and assignment survive new arrivals. Rekey never changes this identity."},"commonv1Value":{"type":"object","properties":{"null_value":{"type":"string","title":"Represents the absence of a value (None/null/undefined)"},"bool_value":{"type":"boolean","title":"Boolean true/false value"},"number":{"$ref":"#/components/schemas/v1Number"},"text":{"type":"string","title":"UTF-8 encoded text string"},"date":{"$ref":"#/components/schemas/typeDate"},"timeofday":{"$ref":"#/components/schemas/typeTimeOfDay"},"datetime":{"$ref":"#/components/schemas/typeDateTime"},"time_zone":{"$ref":"#/components/schemas/typeTimeZone"},"duration":{"type":"string","title":"Signed duration representing a span of time"},"list":{"$ref":"#/components/schemas/v1List"},"dictionary":{"$ref":"#/components/schemas/v1Dictionary"},"file":{"$ref":"#/components/schemas/v1FileValue"},"table":{"$ref":"#/components/schemas/v1TableValue"},"set":{"$ref":"#/components/schemas/v1Set"},"text_value":{"$ref":"#/components/schemas/v1TextValue"},"list_value":{"$ref":"#/components/schemas/commonv1ListValue"},"set_value":{"$ref":"#/components/schemas/v1SetValue"},"dictionary_value":{"$ref":"#/components/schemas/v1DictionaryValue"}},"description":"Represents a runtime value that can be produced by the Jarvis interpreter.\n\nThis message provides a type-safe way to serialize and transmit values between\nthe Jarvis interpreter and other services via gRPC. It supports all the basic\ndata types that can be represented in the Jarvis language runtime.\n\nThe oneof structure ensures that exactly one value type is set at a time,\nproviding both type safety and efficient serialization."},"v1Number":{"type":"object","properties":{"lo":{"type":"integer","format":"int64","description":"Low 32 bits of the 96-bit mantissa."},"mid":{"type":"integer","format":"int64","description":"Middle 32 bits of the 96-bit mantissa."},"hi":{"type":"integer","format":"int64","description":"High 32 bits of the 96-bit mantissa."},"flags":{"type":"integer","format":"int64","description":"Flags word:\n - Bits 16–23: scale (0–28)\n - Bit 31: sign (0 = positive, 1 = negative)\n - Other bits must be zero."}},"description":"A fixed-precision decimal number with up to 28 fractional digits.\n\nThis message represents decimal numbers with exact precision, avoiding\nfloating-point rounding errors. It's particularly useful for financial\ncalculations, measurements, and any scenario where exact decimal\nrepresentation is required.\n\nThe value is calculated as: m / 10^e, where:\n - m is an unsigned 96-bit integer composed of (lo, mid, hi)\n - e is the scale (0–28) stored in flags bits 16–23\n - sign is encoded in flags bit 31 (0 = positive, 1 = negative)\n\nExamples:\n - 123.45 would have m=12345, e=2\n - -0.001 would have m=1, e=3, with sign bit set\n"},"typeDate":{"type":"object","properties":{"year":{"type":"integer","format":"int32","description":"Year of the date. Must be from 1 to 9999, or 0 to specify a date without\na year."},"month":{"type":"integer","format":"int32","description":"Month of a year. Must be from 1 to 12, or 0 to specify a year without a\nmonth and day."},"day":{"type":"integer","format":"int32","description":"Day of a month. Must be from 1 to 31 and valid for the year and month, or 0\nto specify a year by itself or a year and month where the day isn't\nsignificant."}},"description":"* A full date, with non-zero year, month, and day values\n* A month and day value, with a zero year, such as an anniversary\n* A year on its own, with zero month and day values\n* A year and month value, with a zero day, such as a credit card expiration\ndate\n\nRelated types are [google.type.TimeOfDay][google.type.TimeOfDay] and\n`google.protobuf.Timestamp`.","title":"Represents a whole or partial calendar date, such as a birthday. The time of\nday and time zone are either specified elsewhere or are insignificant. The\ndate is relative to the Gregorian Calendar. This can represent one of the\nfollowing:"},"typeTimeOfDay":{"type":"object","properties":{"hours":{"type":"integer","format":"int32","description":"Hours of day in 24 hour format. Should be from 0 to 23. An API may choose\nto allow the value \"24:00:00\" for scenarios like business closing time."},"minutes":{"type":"integer","format":"int32","description":"Minutes of hour of day. Must be from 0 to 59."},"seconds":{"type":"integer","format":"int32","description":"Seconds of minutes of the time. Must normally be from 0 to 59. An API may\nallow the value 60 if it allows leap-seconds."},"nanos":{"type":"integer","format":"int32","description":"Fractions of seconds in nanoseconds. Must be from 0 to 999,999,999."}},"description":"Represents a time of day. The date and time zone are either not significant\nor are specified elsewhere. An API may choose to allow leap seconds. Related\ntypes are [google.type.Date][google.type.Date] and\n`google.protobuf.Timestamp`."},"typeDateTime":{"type":"object","properties":{"year":{"type":"integer","format":"int32","description":"Optional. Year of date. Must be from 1 to 9999, or 0 if specifying a\ndatetime without a year."},"month":{"type":"integer","format":"int32","description":"Required. Month of year. Must be from 1 to 12."},"day":{"type":"integer","format":"int32","description":"Required. Day of month. Must be from 1 to 31 and valid for the year and\nmonth."},"hours":{"type":"integer","format":"int32","description":"Required. Hours of day in 24 hour format. Should be from 0 to 23. An API\nmay choose to allow the value \"24:00:00\" for scenarios like business\nclosing time."},"minutes":{"type":"integer","format":"int32","description":"Required. Minutes of hour of day. Must be from 0 to 59."},"seconds":{"type":"integer","format":"int32","description":"Required. Seconds of minutes of the time. Must normally be from 0 to 59. An\nAPI may allow the value 60 if it allows leap-seconds."},"nanos":{"type":"integer","format":"int32","description":"Required. Fractions of seconds in nanoseconds. Must be from 0 to\n999,999,999."},"utc_offset":{"type":"string","description":"UTC offset. Must be whole seconds, between -18 hours and +18 hours.\nFor example, a UTC offset of -4:00 would be represented as\n{ seconds: -14400 }."},"time_zone":{"$ref":"#/components/schemas/typeTimeZone"}},"description":"Represents civil time (or occasionally physical time).\n\nThis type can represent a civil time in one of a few possible ways:\n\n * When utc_offset is set and time_zone is unset: a civil time on a calendar\n   day with a particular offset from UTC.\n * When time_zone is set and utc_offset is unset: a civil time on a calendar\n   day in a particular time zone.\n * When neither time_zone nor utc_offset is set: a civil time on a calendar\n   day in local time.\n\nThe date is relative to the Proleptic Gregorian Calendar.\n\nIf year is 0, the DateTime is considered not to have a specific year. month\nand day must have valid, non-zero values.\n\nThis type may also be used to represent a physical time if all the date and\ntime fields are set and either case of the `time_offset` oneof is set.\nConsider using `Timestamp` message for physical time instead. If your use\ncase also would like to store the user's timezone, that can be done in\nanother field.\n\nThis type is more flexible than some applications may want. Make sure to\ndocument and validate your application's limitations."},"typeTimeZone":{"type":"object","properties":{"id":{"type":"string","description":"IANA Time Zone Database time zone, e.g. \"America/New_York\"."},"version":{"type":"string","description":"Optional. IANA Time Zone Database version number, e.g. \"2019a\"."}},"description":"Represents a time zone from the\n[IANA Time Zone Database](https://www.iana.org/time-zones)."},"v1List":{"type":"object","properties":{"items":{"type":"array","items":{"$ref":"#/components/schemas/commonV1Value"},"title":"The ordered sequence of values in this list"}},"description":"Represents an ordered collection of values (similar to arrays or lists).\n\nThis message can contain any number of Value elements in a specific order.\nLists are mutable and can grow or shrink during runtime. Elements can be\naccessed by their zero-based index position.\n\nExamples:\n - [1, 2, 3] - list of numbers\n - [\"hello\", \"world\"] - list of strings\n - [true, 42, \"mixed\"] - list with mixed types\n - [[1, 2], [3, 4]] - nested lists"},"commonV1Value":{"type":"object","properties":{"null_value":{"type":"string","title":"Represents the absence of a value (None/null/undefined)"},"bool_value":{"type":"boolean","title":"Boolean true/false value"},"number":{"$ref":"#/components/schemas/v1Number"},"text":{"type":"string","title":"UTF-8 encoded text string"},"date":{"$ref":"#/components/schemas/typeDate"},"timeofday":{"$ref":"#/components/schemas/typeTimeOfDay"},"datetime":{"$ref":"#/components/schemas/typeDateTime"},"time_zone":{"$ref":"#/components/schemas/typeTimeZone"},"duration":{"type":"string","title":"Signed duration representing a span of time"},"list":{"$ref":"#/components/schemas/v1List"},"dictionary":{"$ref":"#/components/schemas/v1Dictionary"},"file":{"$ref":"#/components/schemas/v1FileValue"},"table":{"$ref":"#/components/schemas/v1TableValue"},"set":{"$ref":"#/components/schemas/v1Set"},"text_value":{"$ref":"#/components/schemas/v1TextValue"},"list_value":{"$ref":"#/components/schemas/commonv1ListValue"},"set_value":{"$ref":"#/components/schemas/v1SetValue"},"dictionary_value":{"$ref":"#/components/schemas/v1DictionaryValue"}},"description":"Represents a runtime value that can be produced by the Jarvis interpreter.\n\nThis message provides a type-safe way to serialize and transmit values between\nthe Jarvis interpreter and other services via gRPC. It supports all the basic\ndata types that can be represented in the Jarvis language runtime.\n\nThe oneof structure ensures that exactly one value type is set at a time,\nproviding both type safety and efficient serialization."},"v1Dictionary":{"type":"object","properties":{"entries":{"type":"array","items":{"$ref":"#/components/schemas/v1DictionaryEntry"},"title":"The key-value pairs stored in this dictionary"}},"description":"Represents a key-value mapping (similar to hash maps or dictionaries).\n\nThis message stores associations between keys and values, where keys must be\nhashable types (null, bool, Number, string, Date, TimeOfDay, DateTime, TimeZone). Keys are\nunique within a dictionary - duplicate keys will overwrite previous values.\n\nThe dictionary maintains insertion order for consistent iteration behavior.\n\nExamples:\n - {\"name\": \"John\", \"age\": 30} - string keys with mixed values\n - {1: \"one\", 2: \"two\"} - number keys with string values\n - {\"nested\": {\"inner\": \"value\"}} - nested dictionaries"},"v1DictionaryEntry":{"type":"object","properties":{"key":{"$ref":"#/components/schemas/v1HashableValue"},"value":{"$ref":"#/components/schemas/commonV1Value"}},"description":"Represents a single key-value pair within a Dictionary.\n\nBoth key and value can be any Value type, though keys should be\nhashable types for proper dictionary behavior. Non-hashable keys\n(like lists or dictionaries) may cause runtime errors."},"v1HashableValue":{"type":"object","properties":{"bool_value":{"type":"boolean","title":"Boolean true/false value"},"number":{"$ref":"#/components/schemas/v1Number"},"text":{"type":"string","title":"UTF-8 encoded text string"},"date":{"$ref":"#/components/schemas/typeDate"},"timeofday":{"$ref":"#/components/schemas/typeTimeOfDay"},"datetime":{"$ref":"#/components/schemas/typeDateTime"},"duration":{"type":"string","title":"Signed duration representing a span of time"},"text_value":{"$ref":"#/components/schemas/v1TextValue"}},"description":"Represents a hashable value that can be used as a dictionary key.\n\nThis message contains only the hashable types from the Value message,\ncorresponding to Python's hashable types. These types can be safely\nused as keys in maps and dictionaries.\n\nHashable types include: bool, Number, string, Date, TimeOfDay, DateTime\nand Duration."},"v1TextValue":{"type":"object","properties":{"remote":{"type":"string","title":"Reference to remote text content via URL or file path"},"inline":{"type":"string","title":"Text content embedded directly in the message"}},"description":"Represents a text value that can be either stored inline or referenced remotely.\n\nThis message provides flexibility for handling text strings in the Jarvis interpreter:\n- Small strings can be embedded directly using the inline option\n- Large strings can be referenced by URL using the remote option\n- The choice depends on string size, network constraints, and access patterns"},"v1FileValue":{"type":"object","properties":{"remote":{"type":"string","title":"Reference to a remote file via URL or file path"},"inline":{"$ref":"#/components/schemas/v1File"}},"description":"Represents a file value that can be either stored inline or referenced remotely.\n\nThis message provides flexibility for handling files in the Jarvis interpreter:\n- Small files can be embedded directly using the inline option\n- Large files can be referenced by URL/path using the remote option\n- The choice depends on file size, network constraints, and access patterns"},"v1File":{"type":"object","properties":{"content":{"type":"string","format":"byte","title":"The raw binary content of the file"},"name":{"type":"string","title":"The name of the file, including extension if applicable"}},"description":"Represents a file with its name and binary content.\n\nThis message contains the complete file data including both metadata\n(filename) and the actual file content as raw bytes. It's used for\nembedding files directly within messages when the file size is\nmanageable and immediate access is required.\n\nExamples:\n - Configuration files\n - Small text or binary files\n - Generated reports or documents\n - Temporary files created during execution\n"},"v1TableValue":{"type":"object","properties":{"remote":{"type":"string","title":"Reference to a remote table via URL or file path (feather-v2 format)"},"inline":{"$ref":"#/components/schemas/v1Table"}},"description":"Represents a table value that can be either stored inline or referenced remotely."},"v1Table":{"type":"object","properties":{"data":{"type":"string","format":"byte","title":"The table data serialized in feather-v2 format"}},"description":"Represents a table with data in feather-v2 format.\n\nThis message contains the complete table data serialized using the\nfeather-v2 format, which provides efficient columnar storage and\nfast serialization/deserialization for tabular data."},"v1Set":{"type":"object","properties":{"items":{"type":"array","items":{"$ref":"#/components/schemas/v1HashableValue"},"title":"The unique elements stored in this set\nAll elements must be hashable types"}},"description":"Represents an unordered collection of unique values.\n\nThis message stores a collection of unique elements, where duplicate values\nare automatically removed. Only hashable types can be stored in sets.\nSets are useful for membership testing, removing duplicates, and mathematical\nset operations like union, intersection, and difference.\n\nThe set does not maintain insertion order - elements may appear in any order\nduring iteration.\n\nExamples:\n - {1, 2, 3} - set of numbers\n - {\"apple\", \"banana\", \"cherry\"} - set of strings\n - {true, false} - set of booleans\n - {1, \"hello\", true} - set with mixed hashable types"},"commonv1ListValue":{"type":"object","properties":{"remote":{"type":"string","title":"Reference to remote list data via URL or file path"},"inline":{"$ref":"#/components/schemas/v1List"}},"description":"Represents a list value that can be either stored inline or referenced remotely.\n\nThis message provides flexibility for handling large lists:\n- Small lists can be embedded directly using the inline option\n- Large lists can be referenced by URL using the remote option"},"v1SetValue":{"type":"object","properties":{"remote":{"type":"string","title":"Reference to remote set data via URL or file path"},"inline":{"$ref":"#/components/schemas/v1Set"}},"description":"Represents a set value that can be either stored inline or referenced remotely.\n\nThis message provides flexibility for handling large sets:\n- Small sets can be embedded directly using the inline option\n- Large sets can be referenced by URL using the remote option"},"v1DictionaryValue":{"type":"object","properties":{"remote":{"type":"string","title":"Reference to remote dictionary data via URL or file path"},"inline":{"$ref":"#/components/schemas/v1Dictionary"}},"description":"Represents a dictionary value that can be either stored inline or referenced remotely.\n\nThis message provides flexibility for handling large dictionaries:\n- Small dictionaries can be embedded directly using the inline option\n- Large dictionaries can be referenced by URL using the remote option"},"v1FormSpec":{"type":"object","properties":{"fields":{"type":"array","items":{"$ref":"#/components/schemas/v1FormField"},"description":"At least one question, with unique nonempty keys. Order is the semantic\nreading sequence, not a prescribed screen layout."}},"description":"A set of typed questions for human input or source answers (R6, R13, R14).\nField types derive the returned record type. The platform selects controls\nand layout; there are no widgets, scripts, URLs, or executable expressions.\nShared human input may reference options in each unit's immutable evidence.\nWorkbench resolves those references into the unit's InputContext before use.\nSource answer forms must already be resolved. Filled values are separate messages.\nSources persist their answer form with the pending invocation for recovery.","required":["fields"]},"v1FormField":{"type":"object","properties":{"key":{"type":"string","description":"Stable record key. Unique within its field set; nonempty."},"label":{"type":"string","description":"Business-facing wording, independent of the programmatic key; nonempty."},"help_text":{"type":"string","description":"Optional guidance displayed with the question."},"value_type":{"$ref":"#/components/schemas/v1ValueType"},"initial_value":{"$ref":"#/components/schemas/commonv1Value"},"text":{"$ref":"#/components/schemas/v1TextConstraints"},"number":{"$ref":"#/components/schemas/v1NumberConstraints"},"input_spec":{"$ref":"#/components/schemas/v1InputSpec"}},"description":"One named question, its answer type and its input behavior.","required":["key","label","value_type"]},"v1ValueType":{"type":"object","properties":{"scalar_type":{"$ref":"#/components/schemas/v1ValueScalarType"},"optional_type":{"$ref":"#/components/schemas/v1ValueOptionalType"},"list_type":{"$ref":"#/components/schemas/v1ValueListType"},"dictionary_type":{"$ref":"#/components/schemas/v1ValueDictionaryType"},"table_type":{"$ref":"#/components/schemas/v1ValueTableType"},"opaque_type":{"$ref":"#/components/schemas/v1ValueOpaqueType"},"any_type":{"$ref":"#/components/schemas/v1ValueAnyType"},"union_type":{"$ref":"#/components/schemas/v1ValueUnionType"},"sensitive_type":{"$ref":"#/components/schemas/v1ValueSensitiveType"},"enum_type":{"$ref":"#/components/schemas/v1ValueEnumType"},"generic_dictionary_type":{"$ref":"#/components/schemas/v1ValueGenericDictionaryType"},"none_type":{"$ref":"#/components/schemas/v1ValueNoneType"}},"title":"Represents a complete value type definition using a discriminated union"},"v1ValueScalarType":{"type":"string","enum":["VALUE_SCALAR_TYPE_UNSPECIFIED","VALUE_SCALAR_TYPE_TEXT","VALUE_SCALAR_TYPE_NUMBER","VALUE_SCALAR_TYPE_BOOLEAN","VALUE_SCALAR_TYPE_DATETIME","VALUE_SCALAR_TYPE_DATE","VALUE_SCALAR_TYPE_TIME","VALUE_SCALAR_TYPE_FILE","VALUE_SCALAR_TYPE_TIMEDELTA"],"default":"VALUE_SCALAR_TYPE_UNSPECIFIED","description":"- VALUE_SCALAR_TYPE_UNSPECIFIED: Unspecified value type\n - VALUE_SCALAR_TYPE_TEXT: A text value type\n - VALUE_SCALAR_TYPE_NUMBER: A number value type\n - VALUE_SCALAR_TYPE_BOOLEAN: A boolean value type\n - VALUE_SCALAR_TYPE_DATETIME: A datetime value type\n - VALUE_SCALAR_TYPE_DATE: A date value type\n - VALUE_SCALAR_TYPE_TIME: A time value type\n - VALUE_SCALAR_TYPE_FILE: A file value type\n - VALUE_SCALAR_TYPE_TIMEDELTA: A timedelta value type","title":"Supported Value Scalar Types"},"v1ValueOptionalType":{"type":"object","properties":{"inner":{"$ref":"#/components/schemas/v1ValueType"}},"title":"Represents a value type that can be optional (nullable)"},"v1ValueListType":{"type":"object","properties":{"inner":{"$ref":"#/components/schemas/v1ValueType"}},"title":"Represents a list/array value type containing elements of a specific type"},"v1ValueDictionaryType":{"type":"object","properties":{"is_a":{"type":"string","title":"Semantic classification of what this dictionary represents"},"fields":{"type":"array","items":{"$ref":"#/components/schemas/v1ValueDictionaryTypeField"},"title":"The named fields contained in this dictionary"},"description":{"type":"string","title":"Optional human-readable description of this dictionary type"}},"title":"Represents a dictionary/object value type with named fields"},"v1ValueDictionaryTypeField":{"type":"object","properties":{"key":{"type":"string","title":"The name/key of this field"},"value":{"$ref":"#/components/schemas/v1ValueType"},"description":{"type":"string","title":"Optional human-readable description of this field"}},"title":"Represents a single field within a dictionary value type"},"v1ValueTableType":{"type":"object","properties":{"is_a":{"type":"string","title":"Semantic classification of what this table represents"},"columns":{"type":"array","items":{"$ref":"#/components/schemas/v1ValueTableTypeColumn"},"title":"The columns that make up this table"},"description":{"type":"string","title":"Optional human-readable description of this table type"}},"title":"Represents a table value type with structured columns"},"v1ValueTableTypeColumn":{"type":"object","properties":{"key":{"type":"string","title":"The name/key of this column"},"value":{"$ref":"#/components/schemas/v1ValueType"},"description":{"type":"string","title":"Optional human-readable description of this column"}},"title":"Represents a single column within a table value type"},"v1ValueOpaqueType":{"type":"object","properties":{"is_a":{"type":"string","title":"Semantic classification of what this opaque type represents"},"description":{"type":"string","title":"Optional human-readable description of this opaque type"}},"title":"Represents an opaque value type with semantic meaning but unknown internal structure"},"v1ValueAnyType":{"type":"object","title":"Represents a value type that can hold any kind of value"},"v1ValueUnionType":{"type":"object","properties":{"inners":{"type":"array","items":{"$ref":"#/components/schemas/v1ValueType"},"title":"The possible value types in this union"}},"title":"Represents a union value type that can be one of several possible types"},"v1ValueSensitiveType":{"type":"object","properties":{"inner":{"$ref":"#/components/schemas/v1ValueType"}},"title":"Represents a value type that contains sensitive information"},"v1ValueEnumType":{"type":"object","properties":{"is_a":{"type":"string","title":"Semantic classification of what this enum represents"},"members":{"type":"array","items":{"$ref":"#/components/schemas/v1ValueEnumTypeMember"},"title":"The available options/members of this enum"},"description":{"type":"string","title":"Optional human-readable description of this enum type"}},"title":"Represents an enumeration value type with predefined options"},"v1ValueEnumTypeMember":{"type":"object","properties":{"name":{"type":"string","title":"The programmatic name of this enum member"},"description":{"type":"string","title":"Optional human-readable description of this enum member"}},"title":"Represents a single member/option within an enum value type"},"v1ValueGenericDictionaryType":{"type":"object","properties":{"key_type":{"$ref":"#/components/schemas/v1ValueType"},"value_type":{"$ref":"#/components/schemas/v1ValueType"}},"title":"Represent a generic dictionary that can hold any entry of a particular key and value type"},"v1ValueNoneType":{"type":"object","title":"Represents a none value type that can hold no value"},"v1TextConstraints":{"type":"object","properties":{"min_length":{"type":"integer","format":"int64","description":"Unicode scalar-value counts, not bytes or UTF-16 code units. No implicit\ntrimming, normalization, pattern evaluation or text transformation."},"max_length":{"type":"integer","format":"int64","description":"Inclusive maximum length, measured in Unicode scalar values."}},"description":"Length restrictions on a text answer."},"v1NumberConstraints":{"type":"object","properties":{"minimum":{"$ref":"#/components/schemas/v1Number"},"maximum":{"$ref":"#/components/schemas/v1Number"},"integer_only":{"type":"boolean","description":"Require a value with no fractional component."}},"description":"Exact decimal restrictions on a numeric answer."},"v1InputSpec":{"type":"object","properties":{"selection":{"$ref":"#/components/schemas/v1SelectionInput"}},"description":"How a person supplies a typed answer. Concrete controls and layout belong\nto the renderer. No option carries follow-up fields or executable behavior."},"v1SelectionInput":{"type":"object","properties":{"options":{"type":"array","items":{"$ref":"#/components/schemas/v1SelectionOption"},"description":"Distinct typed values with nonempty labels. May be empty. Each value must\nsatisfy the scalar/element type and applicable field constraints. Numeric\nequality is decimal equality, so 1 and 1.0 are the same option."},"min_selections":{"type":"integer","format":"int64","description":"Only for list fields. Omitted minimum means zero; omitted maximum means the\noption count. Bounds must be ordered and, for nonempty option sets, no greater\nthan that count. Empty selections retain bounds for answer validation.\nUnknown or repeated selections fail. Persist selections in option order,\nusing the declared option values, not user click order or numeric encoding."},"max_selections":{"type":"integer","format":"int64","description":"Inclusive maximum number of selected options."},"options_ref":{"type":"string","description":"Exact nonempty top-level WorkUnit.evidence key, not a path or expression.\nAllowed only in shared human input, mutually exclusive with inline options.\nValid evidence is an inline list of distinct scalar values matching\nthe field's scalar/element type and constraints. Inline text wrappers are\nnormalized to text. No remote reads, record projections or coercion occur.\nEach value is both the displayed choice and the submitted value: text is\nunchanged, numbers use exact decimal text, booleans use true/false, and dates\nuse YYYY-MM-DD. Empty text has no display label and is invalid as an option.\nMissing, empty or invalid choices produce an empty selection, not an input\nerror or free entry. Other fields remain usable. Initial values incompatible\nwith the resolved selection are omitted for that unit."}},"description":"A finite set of offered values. A scalar field selects one value; a list\nfield selects distinct values of its element type. Optional None is absence,\nnever an option. Use inline options or options_ref, not both. Empty selections\noffer no choices and never enable free entry. Resolved unit input and source\nanswer forms use inline options only."},"v1SelectionOption":{"type":"object","properties":{"label":{"type":"string","description":"Nonempty display wording, independent of the submitted value."},"value":{"$ref":"#/components/schemas/commonv1Value"}},"description":"Display wording and the typed value returned when this option is selected.","required":["label","value"]},"v1WorkUnitStatusCount":{"type":"object","properties":{"status":{"$ref":"#/components/schemas/v1WorkUnitStatus"},"count":{"type":"integer","format":"int32","description":"Number of attached units in this status. Always nonnegative."}},"description":"WorkUnitStatusCount counts the attached units in one lifecycle status."},"v1WorkUnitStatus":{"type":"string","enum":["WORK_UNIT_STATUS_UNSPECIFIED","WORK_UNIT_STATUS_WAITING_FOR_INPUT","WORK_UNIT_STATUS_ANSWERED","WORK_UNIT_STATUS_DISMISSED","WORK_UNIT_STATUS_WITHDRAWN","WORK_UNIT_STATUS_PROCESSING"],"default":"WORK_UNIT_STATUS_UNSPECIFIED","description":"WorkUnitStatus records attention and final resolution independently of delivery.\n\n - WORK_UNIT_STATUS_UNSPECIFIED: Default value; not returned for an existing resource.\n - WORK_UNIT_STATUS_WAITING_FOR_INPUT: Waiting for intermediate input or a direct final answer: an item input_form\nexists and input is unaccepted, or no input_form exists and the kind does\nnot require preparation. Saving either draft leaves status unchanged.\n - WORK_UNIT_STATUS_ANSWERED: Final submission and its delivery obligation are durable.\n - WORK_UNIT_STATUS_DISMISSED: Locally dismissed by item archival, arrival or rekey into an archived item.\nUnarchive restores it unless the source or operator has withdrawn it.\n - WORK_UNIT_STATUS_WITHDRAWN: Source or operator ended the occurrence without an answer.\n - WORK_UNIT_STATUS_PROCESSING: Analysis or decision preparation is pending; no current human request.\nIncludes work without an input_form whose kind requires preparation, and\nfinal-answer preparation after intermediate input acceptance."},"rpcStatus":{"type":"object","properties":{"code":{"type":"integer","format":"int32"},"message":{"type":"string"},"details":{"type":"array","items":{"$ref":"#/components/schemas/protobufAny"}}}},"protobufAny":{"type":"object","properties":{"@type":{"type":"string"}},"additionalProperties":{}},"WorkItemServiceUnarchiveWorkItemBody":{"type":"object","description":"UnarchiveWorkItemRequest contains the item to unarchive."}}},"paths":{"/api/v1/organizations/{organization_id}/workspaces/{workspace_id}/workItems/{work_item_id}:unarchive":{"post":{"summary":"Unarchive Work Item","description":"UnarchiveWorkItem ends persistent archival and restores locally dismissed\nunits, excluding answered and source/operator-withdrawn occurrences.\nRestore against the latest input form, retaining only matching field keys\nwith valid values, without coercion or historical copies. Clear input when\nno form exists. Clear acceptance and rotate response etags.\nRestored units wait for input when a form exists, otherwise enter PROCESSING.\nClear archive_time, retain assignment and allow future arrivals.\nNo source decision or delivery is created or reversed.","operationId":"UnarchiveWorkItem","responses":{"200":{"description":"A successful response.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/v1WorkItem"}}}},"default":{"description":"An unexpected error response.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/rpcStatus"}}}}},"parameters":[{"name":"organization_id","in":"path","required":true,"schema":{"type":"string"}},{"name":"workspace_id","in":"path","required":true,"schema":{"type":"string"}},{"name":"work_item_id","in":"path","required":true,"schema":{"type":"string"}}],"requestBody":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/WorkItemServiceUnarchiveWorkItemBody"}}},"required":true},"tags":["Work Items"]}}}}
```

## Subscribe Work Items

> Subscribe to item changes throughout one workspace, independent of list filters.

```json
{"openapi":"3.0.0","info":{"title":"Kognitos API","version":"1.0.0"},"tags":[{"name":"Work Items","description":"Track work items and work units that need human input."}],"servers":[{"url":"https://app.us-1.kognitos.com"}],"security":[{"BearerAuth":[]}],"components":{"securitySchemes":{"BearerAuth":{"type":"http","scheme":"bearer","description":"Personal Access Token."}},"schemas":{"v1WorkItemUpdate":{"type":"object","properties":{"name":{"type":"string","description":"WorkItem resource name."},"revision":{"type":"string","format":"int64","description":"Same ordering token as WorkItem.revision."},"assignee":{"type":"string","description":"Assigned user resource name; empty when unassigned."},"declined_by":{"type":"string","description":"User who last handed the item back; empty before a decline."},"decline_reason":{"type":"string","description":"Reason the item was last handed back."},"update_time":{"type":"string","format":"date-time","description":"Time the item last changed."},"input_form":{"$ref":"#/components/schemas/v1FormSpec"},"input_form_etag":{"type":"string","description":"Concurrency token for the shared input form."},"archive_time":{"type":"string","format":"date-time","description":"Time of explicit archival; absent when not archived."},"unit_counts":{"type":"array","items":{"$ref":"#/components/schemas/v1WorkUnitStatusCount"},"description":"Current unit counts grouped by status."},"preparation_required":{"type":"boolean","description":"Whether a preparation prompt is pending; does not gate submission."}},"description":"Complete replacement of an item's mutable projection at one revision.\n\nMissing messages, empty strings and false values clear earlier values; this\nis not a field patch. Immutable identity and question remain on Get/List.\nAn unknown item requires a read before it can be displayed."},"v1FormSpec":{"type":"object","properties":{"fields":{"type":"array","items":{"$ref":"#/components/schemas/v1FormField"},"description":"At least one question, with unique nonempty keys. Order is the semantic\nreading sequence, not a prescribed screen layout."}},"description":"A set of typed questions for human input or source answers (R6, R13, R14).\nField types derive the returned record type. The platform selects controls\nand layout; there are no widgets, scripts, URLs, or executable expressions.\nShared human input may reference options in each unit's immutable evidence.\nWorkbench resolves those references into the unit's InputContext before use.\nSource answer forms must already be resolved. Filled values are separate messages.\nSources persist their answer form with the pending invocation for recovery.","required":["fields"]},"v1FormField":{"type":"object","properties":{"key":{"type":"string","description":"Stable record key. Unique within its field set; nonempty."},"label":{"type":"string","description":"Business-facing wording, independent of the programmatic key; nonempty."},"help_text":{"type":"string","description":"Optional guidance displayed with the question."},"value_type":{"$ref":"#/components/schemas/v1ValueType"},"initial_value":{"$ref":"#/components/schemas/commonv1Value"},"text":{"$ref":"#/components/schemas/v1TextConstraints"},"number":{"$ref":"#/components/schemas/v1NumberConstraints"},"input_spec":{"$ref":"#/components/schemas/v1InputSpec"}},"description":"One named question, its answer type and its input behavior.","required":["key","label","value_type"]},"v1ValueType":{"type":"object","properties":{"scalar_type":{"$ref":"#/components/schemas/v1ValueScalarType"},"optional_type":{"$ref":"#/components/schemas/v1ValueOptionalType"},"list_type":{"$ref":"#/components/schemas/v1ValueListType"},"dictionary_type":{"$ref":"#/components/schemas/v1ValueDictionaryType"},"table_type":{"$ref":"#/components/schemas/v1ValueTableType"},"opaque_type":{"$ref":"#/components/schemas/v1ValueOpaqueType"},"any_type":{"$ref":"#/components/schemas/v1ValueAnyType"},"union_type":{"$ref":"#/components/schemas/v1ValueUnionType"},"sensitive_type":{"$ref":"#/components/schemas/v1ValueSensitiveType"},"enum_type":{"$ref":"#/components/schemas/v1ValueEnumType"},"generic_dictionary_type":{"$ref":"#/components/schemas/v1ValueGenericDictionaryType"},"none_type":{"$ref":"#/components/schemas/v1ValueNoneType"}},"title":"Represents a complete value type definition using a discriminated union"},"v1ValueScalarType":{"type":"string","enum":["VALUE_SCALAR_TYPE_UNSPECIFIED","VALUE_SCALAR_TYPE_TEXT","VALUE_SCALAR_TYPE_NUMBER","VALUE_SCALAR_TYPE_BOOLEAN","VALUE_SCALAR_TYPE_DATETIME","VALUE_SCALAR_TYPE_DATE","VALUE_SCALAR_TYPE_TIME","VALUE_SCALAR_TYPE_FILE","VALUE_SCALAR_TYPE_TIMEDELTA"],"default":"VALUE_SCALAR_TYPE_UNSPECIFIED","description":"- VALUE_SCALAR_TYPE_UNSPECIFIED: Unspecified value type\n - VALUE_SCALAR_TYPE_TEXT: A text value type\n - VALUE_SCALAR_TYPE_NUMBER: A number value type\n - VALUE_SCALAR_TYPE_BOOLEAN: A boolean value type\n - VALUE_SCALAR_TYPE_DATETIME: A datetime value type\n - VALUE_SCALAR_TYPE_DATE: A date value type\n - VALUE_SCALAR_TYPE_TIME: A time value type\n - VALUE_SCALAR_TYPE_FILE: A file value type\n - VALUE_SCALAR_TYPE_TIMEDELTA: A timedelta value type","title":"Supported Value Scalar Types"},"v1ValueOptionalType":{"type":"object","properties":{"inner":{"$ref":"#/components/schemas/v1ValueType"}},"title":"Represents a value type that can be optional (nullable)"},"v1ValueListType":{"type":"object","properties":{"inner":{"$ref":"#/components/schemas/v1ValueType"}},"title":"Represents a list/array value type containing elements of a specific type"},"v1ValueDictionaryType":{"type":"object","properties":{"is_a":{"type":"string","title":"Semantic classification of what this dictionary represents"},"fields":{"type":"array","items":{"$ref":"#/components/schemas/v1ValueDictionaryTypeField"},"title":"The named fields contained in this dictionary"},"description":{"type":"string","title":"Optional human-readable description of this dictionary type"}},"title":"Represents a dictionary/object value type with named fields"},"v1ValueDictionaryTypeField":{"type":"object","properties":{"key":{"type":"string","title":"The name/key of this field"},"value":{"$ref":"#/components/schemas/v1ValueType"},"description":{"type":"string","title":"Optional human-readable description of this field"}},"title":"Represents a single field within a dictionary value type"},"v1ValueTableType":{"type":"object","properties":{"is_a":{"type":"string","title":"Semantic classification of what this table represents"},"columns":{"type":"array","items":{"$ref":"#/components/schemas/v1ValueTableTypeColumn"},"title":"The columns that make up this table"},"description":{"type":"string","title":"Optional human-readable description of this table type"}},"title":"Represents a table value type with structured columns"},"v1ValueTableTypeColumn":{"type":"object","properties":{"key":{"type":"string","title":"The name/key of this column"},"value":{"$ref":"#/components/schemas/v1ValueType"},"description":{"type":"string","title":"Optional human-readable description of this column"}},"title":"Represents a single column within a table value type"},"v1ValueOpaqueType":{"type":"object","properties":{"is_a":{"type":"string","title":"Semantic classification of what this opaque type represents"},"description":{"type":"string","title":"Optional human-readable description of this opaque type"}},"title":"Represents an opaque value type with semantic meaning but unknown internal structure"},"v1ValueAnyType":{"type":"object","title":"Represents a value type that can hold any kind of value"},"v1ValueUnionType":{"type":"object","properties":{"inners":{"type":"array","items":{"$ref":"#/components/schemas/v1ValueType"},"title":"The possible value types in this union"}},"title":"Represents a union value type that can be one of several possible types"},"v1ValueSensitiveType":{"type":"object","properties":{"inner":{"$ref":"#/components/schemas/v1ValueType"}},"title":"Represents a value type that contains sensitive information"},"v1ValueEnumType":{"type":"object","properties":{"is_a":{"type":"string","title":"Semantic classification of what this enum represents"},"members":{"type":"array","items":{"$ref":"#/components/schemas/v1ValueEnumTypeMember"},"title":"The available options/members of this enum"},"description":{"type":"string","title":"Optional human-readable description of this enum type"}},"title":"Represents an enumeration value type with predefined options"},"v1ValueEnumTypeMember":{"type":"object","properties":{"name":{"type":"string","title":"The programmatic name of this enum member"},"description":{"type":"string","title":"Optional human-readable description of this enum member"}},"title":"Represents a single member/option within an enum value type"},"v1ValueGenericDictionaryType":{"type":"object","properties":{"key_type":{"$ref":"#/components/schemas/v1ValueType"},"value_type":{"$ref":"#/components/schemas/v1ValueType"}},"title":"Represent a generic dictionary that can hold any entry of a particular key and value type"},"v1ValueNoneType":{"type":"object","title":"Represents a none value type that can hold no value"},"commonv1Value":{"type":"object","properties":{"null_value":{"type":"string","title":"Represents the absence of a value (None/null/undefined)"},"bool_value":{"type":"boolean","title":"Boolean true/false value"},"number":{"$ref":"#/components/schemas/v1Number"},"text":{"type":"string","title":"UTF-8 encoded text string"},"date":{"$ref":"#/components/schemas/typeDate"},"timeofday":{"$ref":"#/components/schemas/typeTimeOfDay"},"datetime":{"$ref":"#/components/schemas/typeDateTime"},"time_zone":{"$ref":"#/components/schemas/typeTimeZone"},"duration":{"type":"string","title":"Signed duration representing a span of time"},"list":{"$ref":"#/components/schemas/v1List"},"dictionary":{"$ref":"#/components/schemas/v1Dictionary"},"file":{"$ref":"#/components/schemas/v1FileValue"},"table":{"$ref":"#/components/schemas/v1TableValue"},"set":{"$ref":"#/components/schemas/v1Set"},"text_value":{"$ref":"#/components/schemas/v1TextValue"},"list_value":{"$ref":"#/components/schemas/commonv1ListValue"},"set_value":{"$ref":"#/components/schemas/v1SetValue"},"dictionary_value":{"$ref":"#/components/schemas/v1DictionaryValue"}},"description":"Represents a runtime value that can be produced by the Jarvis interpreter.\n\nThis message provides a type-safe way to serialize and transmit values between\nthe Jarvis interpreter and other services via gRPC. It supports all the basic\ndata types that can be represented in the Jarvis language runtime.\n\nThe oneof structure ensures that exactly one value type is set at a time,\nproviding both type safety and efficient serialization."},"v1Number":{"type":"object","properties":{"lo":{"type":"integer","format":"int64","description":"Low 32 bits of the 96-bit mantissa."},"mid":{"type":"integer","format":"int64","description":"Middle 32 bits of the 96-bit mantissa."},"hi":{"type":"integer","format":"int64","description":"High 32 bits of the 96-bit mantissa."},"flags":{"type":"integer","format":"int64","description":"Flags word:\n - Bits 16–23: scale (0–28)\n - Bit 31: sign (0 = positive, 1 = negative)\n - Other bits must be zero."}},"description":"A fixed-precision decimal number with up to 28 fractional digits.\n\nThis message represents decimal numbers with exact precision, avoiding\nfloating-point rounding errors. It's particularly useful for financial\ncalculations, measurements, and any scenario where exact decimal\nrepresentation is required.\n\nThe value is calculated as: m / 10^e, where:\n - m is an unsigned 96-bit integer composed of (lo, mid, hi)\n - e is the scale (0–28) stored in flags bits 16–23\n - sign is encoded in flags bit 31 (0 = positive, 1 = negative)\n\nExamples:\n - 123.45 would have m=12345, e=2\n - -0.001 would have m=1, e=3, with sign bit set\n"},"typeDate":{"type":"object","properties":{"year":{"type":"integer","format":"int32","description":"Year of the date. Must be from 1 to 9999, or 0 to specify a date without\na year."},"month":{"type":"integer","format":"int32","description":"Month of a year. Must be from 1 to 12, or 0 to specify a year without a\nmonth and day."},"day":{"type":"integer","format":"int32","description":"Day of a month. Must be from 1 to 31 and valid for the year and month, or 0\nto specify a year by itself or a year and month where the day isn't\nsignificant."}},"description":"* A full date, with non-zero year, month, and day values\n* A month and day value, with a zero year, such as an anniversary\n* A year on its own, with zero month and day values\n* A year and month value, with a zero day, such as a credit card expiration\ndate\n\nRelated types are [google.type.TimeOfDay][google.type.TimeOfDay] and\n`google.protobuf.Timestamp`.","title":"Represents a whole or partial calendar date, such as a birthday. The time of\nday and time zone are either specified elsewhere or are insignificant. The\ndate is relative to the Gregorian Calendar. This can represent one of the\nfollowing:"},"typeTimeOfDay":{"type":"object","properties":{"hours":{"type":"integer","format":"int32","description":"Hours of day in 24 hour format. Should be from 0 to 23. An API may choose\nto allow the value \"24:00:00\" for scenarios like business closing time."},"minutes":{"type":"integer","format":"int32","description":"Minutes of hour of day. Must be from 0 to 59."},"seconds":{"type":"integer","format":"int32","description":"Seconds of minutes of the time. Must normally be from 0 to 59. An API may\nallow the value 60 if it allows leap-seconds."},"nanos":{"type":"integer","format":"int32","description":"Fractions of seconds in nanoseconds. Must be from 0 to 999,999,999."}},"description":"Represents a time of day. The date and time zone are either not significant\nor are specified elsewhere. An API may choose to allow leap seconds. Related\ntypes are [google.type.Date][google.type.Date] and\n`google.protobuf.Timestamp`."},"typeDateTime":{"type":"object","properties":{"year":{"type":"integer","format":"int32","description":"Optional. Year of date. Must be from 1 to 9999, or 0 if specifying a\ndatetime without a year."},"month":{"type":"integer","format":"int32","description":"Required. Month of year. Must be from 1 to 12."},"day":{"type":"integer","format":"int32","description":"Required. Day of month. Must be from 1 to 31 and valid for the year and\nmonth."},"hours":{"type":"integer","format":"int32","description":"Required. Hours of day in 24 hour format. Should be from 0 to 23. An API\nmay choose to allow the value \"24:00:00\" for scenarios like business\nclosing time."},"minutes":{"type":"integer","format":"int32","description":"Required. Minutes of hour of day. Must be from 0 to 59."},"seconds":{"type":"integer","format":"int32","description":"Required. Seconds of minutes of the time. Must normally be from 0 to 59. An\nAPI may allow the value 60 if it allows leap-seconds."},"nanos":{"type":"integer","format":"int32","description":"Required. Fractions of seconds in nanoseconds. Must be from 0 to\n999,999,999."},"utc_offset":{"type":"string","description":"UTC offset. Must be whole seconds, between -18 hours and +18 hours.\nFor example, a UTC offset of -4:00 would be represented as\n{ seconds: -14400 }."},"time_zone":{"$ref":"#/components/schemas/typeTimeZone"}},"description":"Represents civil time (or occasionally physical time).\n\nThis type can represent a civil time in one of a few possible ways:\n\n * When utc_offset is set and time_zone is unset: a civil time on a calendar\n   day with a particular offset from UTC.\n * When time_zone is set and utc_offset is unset: a civil time on a calendar\n   day in a particular time zone.\n * When neither time_zone nor utc_offset is set: a civil time on a calendar\n   day in local time.\n\nThe date is relative to the Proleptic Gregorian Calendar.\n\nIf year is 0, the DateTime is considered not to have a specific year. month\nand day must have valid, non-zero values.\n\nThis type may also be used to represent a physical time if all the date and\ntime fields are set and either case of the `time_offset` oneof is set.\nConsider using `Timestamp` message for physical time instead. If your use\ncase also would like to store the user's timezone, that can be done in\nanother field.\n\nThis type is more flexible than some applications may want. Make sure to\ndocument and validate your application's limitations."},"typeTimeZone":{"type":"object","properties":{"id":{"type":"string","description":"IANA Time Zone Database time zone, e.g. \"America/New_York\"."},"version":{"type":"string","description":"Optional. IANA Time Zone Database version number, e.g. \"2019a\"."}},"description":"Represents a time zone from the\n[IANA Time Zone Database](https://www.iana.org/time-zones)."},"v1List":{"type":"object","properties":{"items":{"type":"array","items":{"$ref":"#/components/schemas/commonV1Value"},"title":"The ordered sequence of values in this list"}},"description":"Represents an ordered collection of values (similar to arrays or lists).\n\nThis message can contain any number of Value elements in a specific order.\nLists are mutable and can grow or shrink during runtime. Elements can be\naccessed by their zero-based index position.\n\nExamples:\n - [1, 2, 3] - list of numbers\n - [\"hello\", \"world\"] - list of strings\n - [true, 42, \"mixed\"] - list with mixed types\n - [[1, 2], [3, 4]] - nested lists"},"commonV1Value":{"type":"object","properties":{"null_value":{"type":"string","title":"Represents the absence of a value (None/null/undefined)"},"bool_value":{"type":"boolean","title":"Boolean true/false value"},"number":{"$ref":"#/components/schemas/v1Number"},"text":{"type":"string","title":"UTF-8 encoded text string"},"date":{"$ref":"#/components/schemas/typeDate"},"timeofday":{"$ref":"#/components/schemas/typeTimeOfDay"},"datetime":{"$ref":"#/components/schemas/typeDateTime"},"time_zone":{"$ref":"#/components/schemas/typeTimeZone"},"duration":{"type":"string","title":"Signed duration representing a span of time"},"list":{"$ref":"#/components/schemas/v1List"},"dictionary":{"$ref":"#/components/schemas/v1Dictionary"},"file":{"$ref":"#/components/schemas/v1FileValue"},"table":{"$ref":"#/components/schemas/v1TableValue"},"set":{"$ref":"#/components/schemas/v1Set"},"text_value":{"$ref":"#/components/schemas/v1TextValue"},"list_value":{"$ref":"#/components/schemas/commonv1ListValue"},"set_value":{"$ref":"#/components/schemas/v1SetValue"},"dictionary_value":{"$ref":"#/components/schemas/v1DictionaryValue"}},"description":"Represents a runtime value that can be produced by the Jarvis interpreter.\n\nThis message provides a type-safe way to serialize and transmit values between\nthe Jarvis interpreter and other services via gRPC. It supports all the basic\ndata types that can be represented in the Jarvis language runtime.\n\nThe oneof structure ensures that exactly one value type is set at a time,\nproviding both type safety and efficient serialization."},"v1Dictionary":{"type":"object","properties":{"entries":{"type":"array","items":{"$ref":"#/components/schemas/v1DictionaryEntry"},"title":"The key-value pairs stored in this dictionary"}},"description":"Represents a key-value mapping (similar to hash maps or dictionaries).\n\nThis message stores associations between keys and values, where keys must be\nhashable types (null, bool, Number, string, Date, TimeOfDay, DateTime, TimeZone). Keys are\nunique within a dictionary - duplicate keys will overwrite previous values.\n\nThe dictionary maintains insertion order for consistent iteration behavior.\n\nExamples:\n - {\"name\": \"John\", \"age\": 30} - string keys with mixed values\n - {1: \"one\", 2: \"two\"} - number keys with string values\n - {\"nested\": {\"inner\": \"value\"}} - nested dictionaries"},"v1DictionaryEntry":{"type":"object","properties":{"key":{"$ref":"#/components/schemas/v1HashableValue"},"value":{"$ref":"#/components/schemas/commonV1Value"}},"description":"Represents a single key-value pair within a Dictionary.\n\nBoth key and value can be any Value type, though keys should be\nhashable types for proper dictionary behavior. Non-hashable keys\n(like lists or dictionaries) may cause runtime errors."},"v1HashableValue":{"type":"object","properties":{"bool_value":{"type":"boolean","title":"Boolean true/false value"},"number":{"$ref":"#/components/schemas/v1Number"},"text":{"type":"string","title":"UTF-8 encoded text string"},"date":{"$ref":"#/components/schemas/typeDate"},"timeofday":{"$ref":"#/components/schemas/typeTimeOfDay"},"datetime":{"$ref":"#/components/schemas/typeDateTime"},"duration":{"type":"string","title":"Signed duration representing a span of time"},"text_value":{"$ref":"#/components/schemas/v1TextValue"}},"description":"Represents a hashable value that can be used as a dictionary key.\n\nThis message contains only the hashable types from the Value message,\ncorresponding to Python's hashable types. These types can be safely\nused as keys in maps and dictionaries.\n\nHashable types include: bool, Number, string, Date, TimeOfDay, DateTime\nand Duration."},"v1TextValue":{"type":"object","properties":{"remote":{"type":"string","title":"Reference to remote text content via URL or file path"},"inline":{"type":"string","title":"Text content embedded directly in the message"}},"description":"Represents a text value that can be either stored inline or referenced remotely.\n\nThis message provides flexibility for handling text strings in the Jarvis interpreter:\n- Small strings can be embedded directly using the inline option\n- Large strings can be referenced by URL using the remote option\n- The choice depends on string size, network constraints, and access patterns"},"v1FileValue":{"type":"object","properties":{"remote":{"type":"string","title":"Reference to a remote file via URL or file path"},"inline":{"$ref":"#/components/schemas/v1File"}},"description":"Represents a file value that can be either stored inline or referenced remotely.\n\nThis message provides flexibility for handling files in the Jarvis interpreter:\n- Small files can be embedded directly using the inline option\n- Large files can be referenced by URL/path using the remote option\n- The choice depends on file size, network constraints, and access patterns"},"v1File":{"type":"object","properties":{"content":{"type":"string","format":"byte","title":"The raw binary content of the file"},"name":{"type":"string","title":"The name of the file, including extension if applicable"}},"description":"Represents a file with its name and binary content.\n\nThis message contains the complete file data including both metadata\n(filename) and the actual file content as raw bytes. It's used for\nembedding files directly within messages when the file size is\nmanageable and immediate access is required.\n\nExamples:\n - Configuration files\n - Small text or binary files\n - Generated reports or documents\n - Temporary files created during execution\n"},"v1TableValue":{"type":"object","properties":{"remote":{"type":"string","title":"Reference to a remote table via URL or file path (feather-v2 format)"},"inline":{"$ref":"#/components/schemas/v1Table"}},"description":"Represents a table value that can be either stored inline or referenced remotely."},"v1Table":{"type":"object","properties":{"data":{"type":"string","format":"byte","title":"The table data serialized in feather-v2 format"}},"description":"Represents a table with data in feather-v2 format.\n\nThis message contains the complete table data serialized using the\nfeather-v2 format, which provides efficient columnar storage and\nfast serialization/deserialization for tabular data."},"v1Set":{"type":"object","properties":{"items":{"type":"array","items":{"$ref":"#/components/schemas/v1HashableValue"},"title":"The unique elements stored in this set\nAll elements must be hashable types"}},"description":"Represents an unordered collection of unique values.\n\nThis message stores a collection of unique elements, where duplicate values\nare automatically removed. Only hashable types can be stored in sets.\nSets are useful for membership testing, removing duplicates, and mathematical\nset operations like union, intersection, and difference.\n\nThe set does not maintain insertion order - elements may appear in any order\nduring iteration.\n\nExamples:\n - {1, 2, 3} - set of numbers\n - {\"apple\", \"banana\", \"cherry\"} - set of strings\n - {true, false} - set of booleans\n - {1, \"hello\", true} - set with mixed hashable types"},"commonv1ListValue":{"type":"object","properties":{"remote":{"type":"string","title":"Reference to remote list data via URL or file path"},"inline":{"$ref":"#/components/schemas/v1List"}},"description":"Represents a list value that can be either stored inline or referenced remotely.\n\nThis message provides flexibility for handling large lists:\n- Small lists can be embedded directly using the inline option\n- Large lists can be referenced by URL using the remote option"},"v1SetValue":{"type":"object","properties":{"remote":{"type":"string","title":"Reference to remote set data via URL or file path"},"inline":{"$ref":"#/components/schemas/v1Set"}},"description":"Represents a set value that can be either stored inline or referenced remotely.\n\nThis message provides flexibility for handling large sets:\n- Small sets can be embedded directly using the inline option\n- Large sets can be referenced by URL using the remote option"},"v1DictionaryValue":{"type":"object","properties":{"remote":{"type":"string","title":"Reference to remote dictionary data via URL or file path"},"inline":{"$ref":"#/components/schemas/v1Dictionary"}},"description":"Represents a dictionary value that can be either stored inline or referenced remotely.\n\nThis message provides flexibility for handling large dictionaries:\n- Small dictionaries can be embedded directly using the inline option\n- Large dictionaries can be referenced by URL using the remote option"},"v1TextConstraints":{"type":"object","properties":{"min_length":{"type":"integer","format":"int64","description":"Unicode scalar-value counts, not bytes or UTF-16 code units. No implicit\ntrimming, normalization, pattern evaluation or text transformation."},"max_length":{"type":"integer","format":"int64","description":"Inclusive maximum length, measured in Unicode scalar values."}},"description":"Length restrictions on a text answer."},"v1NumberConstraints":{"type":"object","properties":{"minimum":{"$ref":"#/components/schemas/v1Number"},"maximum":{"$ref":"#/components/schemas/v1Number"},"integer_only":{"type":"boolean","description":"Require a value with no fractional component."}},"description":"Exact decimal restrictions on a numeric answer."},"v1InputSpec":{"type":"object","properties":{"selection":{"$ref":"#/components/schemas/v1SelectionInput"}},"description":"How a person supplies a typed answer. Concrete controls and layout belong\nto the renderer. No option carries follow-up fields or executable behavior."},"v1SelectionInput":{"type":"object","properties":{"options":{"type":"array","items":{"$ref":"#/components/schemas/v1SelectionOption"},"description":"Distinct typed values with nonempty labels. May be empty. Each value must\nsatisfy the scalar/element type and applicable field constraints. Numeric\nequality is decimal equality, so 1 and 1.0 are the same option."},"min_selections":{"type":"integer","format":"int64","description":"Only for list fields. Omitted minimum means zero; omitted maximum means the\noption count. Bounds must be ordered and, for nonempty option sets, no greater\nthan that count. Empty selections retain bounds for answer validation.\nUnknown or repeated selections fail. Persist selections in option order,\nusing the declared option values, not user click order or numeric encoding."},"max_selections":{"type":"integer","format":"int64","description":"Inclusive maximum number of selected options."},"options_ref":{"type":"string","description":"Exact nonempty top-level WorkUnit.evidence key, not a path or expression.\nAllowed only in shared human input, mutually exclusive with inline options.\nValid evidence is an inline list of distinct scalar values matching\nthe field's scalar/element type and constraints. Inline text wrappers are\nnormalized to text. No remote reads, record projections or coercion occur.\nEach value is both the displayed choice and the submitted value: text is\nunchanged, numbers use exact decimal text, booleans use true/false, and dates\nuse YYYY-MM-DD. Empty text has no display label and is invalid as an option.\nMissing, empty or invalid choices produce an empty selection, not an input\nerror or free entry. Other fields remain usable. Initial values incompatible\nwith the resolved selection are omitted for that unit."}},"description":"A finite set of offered values. A scalar field selects one value; a list\nfield selects distinct values of its element type. Optional None is absence,\nnever an option. Use inline options or options_ref, not both. Empty selections\noffer no choices and never enable free entry. Resolved unit input and source\nanswer forms use inline options only."},"v1SelectionOption":{"type":"object","properties":{"label":{"type":"string","description":"Nonempty display wording, independent of the submitted value."},"value":{"$ref":"#/components/schemas/commonv1Value"}},"description":"Display wording and the typed value returned when this option is selected.","required":["label","value"]},"v1WorkUnitStatusCount":{"type":"object","properties":{"status":{"$ref":"#/components/schemas/v1WorkUnitStatus"},"count":{"type":"integer","format":"int32","description":"Number of attached units in this status. Always nonnegative."}},"description":"WorkUnitStatusCount counts the attached units in one lifecycle status."},"v1WorkUnitStatus":{"type":"string","enum":["WORK_UNIT_STATUS_UNSPECIFIED","WORK_UNIT_STATUS_WAITING_FOR_INPUT","WORK_UNIT_STATUS_ANSWERED","WORK_UNIT_STATUS_DISMISSED","WORK_UNIT_STATUS_WITHDRAWN","WORK_UNIT_STATUS_PROCESSING"],"default":"WORK_UNIT_STATUS_UNSPECIFIED","description":"WorkUnitStatus records attention and final resolution independently of delivery.\n\n - WORK_UNIT_STATUS_UNSPECIFIED: Default value; not returned for an existing resource.\n - WORK_UNIT_STATUS_WAITING_FOR_INPUT: Waiting for intermediate input or a direct final answer: an item input_form\nexists and input is unaccepted, or no input_form exists and the kind does\nnot require preparation. Saving either draft leaves status unchanged.\n - WORK_UNIT_STATUS_ANSWERED: Final submission and its delivery obligation are durable.\n - WORK_UNIT_STATUS_DISMISSED: Locally dismissed by item archival, arrival or rekey into an archived item.\nUnarchive restores it unless the source or operator has withdrawn it.\n - WORK_UNIT_STATUS_WITHDRAWN: Source or operator ended the occurrence without an answer.\n - WORK_UNIT_STATUS_PROCESSING: Analysis or decision preparation is pending; no current human request.\nIncludes work without an input_form whose kind requires preparation, and\nfinal-answer preparation after intermediate input acceptance."},"rpcStatus":{"type":"object","properties":{"code":{"type":"integer","format":"int32"},"message":{"type":"string"},"details":{"type":"array","items":{"$ref":"#/components/schemas/protobufAny"}}}},"protobufAny":{"type":"object","properties":{"@type":{"type":"string"}},"additionalProperties":{}}}},"paths":{"/api/v1/organizations/{organization_id}/workspaces/{workspace_id}/workItems:stream":{"get":{"summary":"Subscribe Work Items","description":"Subscribe to item changes throughout one workspace, independent of list filters.","operationId":"SubscribeWorkItems","responses":{"200":{"description":"A successful response.(streaming responses)","content":{"application/json":{"schema":{"type":"object","properties":{"result":{"$ref":"#/components/schemas/v1WorkItemUpdate"},"error":{"$ref":"#/components/schemas/rpcStatus"}},"title":"Stream result of v1WorkItemUpdate"}}}},"default":{"description":"An unexpected error response.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/rpcStatus"}}}}},"parameters":[{"name":"organization_id","in":"path","required":true,"schema":{"type":"string"}},{"name":"workspace_id","in":"path","required":true,"schema":{"type":"string"}}],"tags":["Work Items"]}}}}
```

## List Work Units

> ListWorkUnits lists workspace units and, per unit, whether the answer\
> took effect.\
> \
> Each unit carries the same fields as GetWorkUnit, including evidence and\
> answer\_form, input and answer\_draft. Choose page\_size to keep the complete response within transport limits.

```json
{"openapi":"3.0.0","info":{"title":"Kognitos API","version":"1.0.0"},"tags":[{"name":"Work Items","description":"Track work items and work units that need human input."}],"servers":[{"url":"https://app.us-1.kognitos.com"}],"security":[{"BearerAuth":[]}],"components":{"securitySchemes":{"BearerAuth":{"type":"http","scheme":"bearer","description":"Personal Access Token."}},"schemas":{"v1ListWorkUnitsResponse":{"type":"object","properties":{"work_units":{"type":"array","items":{"$ref":"#/components/schemas/v1WorkUnit"},"description":"The complete matching units."},"next_page_token":{"type":"string","description":"A token to retrieve the next page, or empty if there are no more."},"total_size":{"type":"integer","format":"int32","description":"The total number of units matching the filter."}},"description":"ListWorkUnitsResponse contains a page of workspace units."},"v1WorkUnit":{"type":"object","properties":{"name":{"type":"string","title":"The stable workspace-scoped resource name of the work unit.\nFormat: organizations/{organization_id}/workspaces/{workspace_id}/workUnits/{work_unit_id}"},"work_item":{"type":"string","description":"Current grouping membership in the same workspace. Rekey may change this reference without changing\nthe unit's name. Empty when the occurrence has no work item.","readOnly":true},"source_ref":{"type":"string","description":"The source's own id for this unit, combined with occurrence_id to identify one request\nfor attention within an organization, workspace and kind across history.\n\nThe source's shape rather than ours. Decisions also carry occurrence_id so a later request\nabout the same thing cannot consume an earlier answer. Not a label: no\nkind declares it and no grouping configuration names it."},"correlation_id":{"type":"string","description":"Source-owned correlation shared by related requests within this organization,\nworkspace and kind. Empty when none was supplied on first admission.\nImmutable; returned by Get and List and filterable through ListWorkUnits.\nIndependent of work-item grouping, occurrence identity and decision routing.","readOnly":true},"kind":{"type":"string","description":"The registered kind of work, as an opaque dotted id. See\nWorkItem.kind.","readOnly":true},"labels":{"type":"object","additionalProperties":{"type":"string"},"description":"The facts the source stated about this unit. The subset the workspace\ngroups on became its item's agg_labels, where a key the workspace groups\non that this unit does not carry became a null.","readOnly":true},"summary":{"type":"string","description":"One line about this unit in business language, as its source put it. The\nquestion, when this is the unit that materialised the item.\n\nImmutable for this occurrence, including before acceptance.","readOnly":true},"detail":{"type":"string","description":"Additional source-authored text describing this occurrence. Empty when omitted.\nImmutable for the occurrence; returned by GetWorkUnit and ListWorkUnits.","readOnly":true},"identifying_details":{"type":"array","items":{"$ref":"#/components/schemas/v1IdentifyingDetail"},"description":"Ordered identifying facts, immutable for this occurrence. Entries with a\nblank label or value are omitted. Clients fall back to summary, then the\nkind display name when empty; detail is supplementary context, not a heading.","readOnly":true},"evidence":{"type":"object","additionalProperties":{"$ref":"#/components/schemas/commonv1Value"},"description":"What a person reads to decide: the records and facts behind this unit,\nnamed and typed, so the platform renders it and the source ships no\nrendering (R6).\n\nImmutable for this occurrence. Changed decision context requires withdrawal\nand a new occurrence. Re-reports never overwrite this evidence.\n\nReturned by both GetWorkUnit and ListWorkUnits.","readOnly":true},"status":{"$ref":"#/components/schemas/v1WorkUnitStatus"},"delivery":{"$ref":"#/components/schemas/v1EffectDelivery"},"settle_time":{"type":"string","format":"date-time","description":"When attention ended for this occurrence: answer, dismissal or withdrawal.","readOnly":true},"create_time":{"type":"string","format":"date-time","description":"The time this unit was first seen.","readOnly":true},"update_time":{"type":"string","format":"date-time","description":"The time this unit last changed, including by a source's re-report.","readOnly":true},"occurrence_id":{"type":"string","description":"The source's immutable identifier for this particular request for attention.\nRe-reports reuse it; a new request uses a new one even for the same source_ref.","readOnly":true},"previous_delivery":{"type":"string","description":"Earlier delivery whose rejection or later execution raised this question.\nEmpty for ordinary arrivals. Exposes follow-up provenance to the surface.","readOnly":true},"submission":{"type":"string","description":"The sole accepted final submission, or empty while no answer is recorded.","readOnly":true},"answer_form":{"$ref":"#/components/schemas/v1FormSpec"},"input":{"$ref":"#/components/schemas/v1InputContext"},"answer_draft":{"$ref":"#/components/schemas/v1AnswerDraft"},"revision":{"type":"string","format":"int64","description":"Monotonically increasing version of this resource's mutable state,\nincluding resolved input and embedded delivery. Compare only versions of\nthe same resource. Independent of mutation etags.","readOnly":true}},"description":"WorkUnit is one real-world thing needing attention, as its source reported\nit: a run that failed, a record that was flagged, an automation waiting on a\nvalue.\n\nThe workspace is the resource parent. The name remains stable across rekey;\nwork_item records grouping membership rather than resource parentage.\nA source reports occurrences without naming an item or asserting grouping."},"v1IdentifyingDetail":{"type":"object","properties":{"label":{"type":"string","description":"Business-facing label, for example \"Invoice\"."},"value":{"type":"string","description":"Nonempty display fallback, for example \"INV-1042\" or \"invoice.pdf\"."},"evidence_ref":{"type":"string","description":"Optional exact top-level key in the same work unit's evidence map.\nThis is neither a resource URI nor an expression. Readers use value when\nabsent, unresolved or unavailable; an invalid reference never rejects work."}},"description":"A source-authored identifying fact for a unit's compact heading.\nDisplayed in source order, with optional access to frozen evidence."},"commonv1Value":{"type":"object","properties":{"null_value":{"type":"string","title":"Represents the absence of a value (None/null/undefined)"},"bool_value":{"type":"boolean","title":"Boolean true/false value"},"number":{"$ref":"#/components/schemas/v1Number"},"text":{"type":"string","title":"UTF-8 encoded text string"},"date":{"$ref":"#/components/schemas/typeDate"},"timeofday":{"$ref":"#/components/schemas/typeTimeOfDay"},"datetime":{"$ref":"#/components/schemas/typeDateTime"},"time_zone":{"$ref":"#/components/schemas/typeTimeZone"},"duration":{"type":"string","title":"Signed duration representing a span of time"},"list":{"$ref":"#/components/schemas/v1List"},"dictionary":{"$ref":"#/components/schemas/v1Dictionary"},"file":{"$ref":"#/components/schemas/v1FileValue"},"table":{"$ref":"#/components/schemas/v1TableValue"},"set":{"$ref":"#/components/schemas/v1Set"},"text_value":{"$ref":"#/components/schemas/v1TextValue"},"list_value":{"$ref":"#/components/schemas/commonv1ListValue"},"set_value":{"$ref":"#/components/schemas/v1SetValue"},"dictionary_value":{"$ref":"#/components/schemas/v1DictionaryValue"}},"description":"Represents a runtime value that can be produced by the Jarvis interpreter.\n\nThis message provides a type-safe way to serialize and transmit values between\nthe Jarvis interpreter and other services via gRPC. It supports all the basic\ndata types that can be represented in the Jarvis language runtime.\n\nThe oneof structure ensures that exactly one value type is set at a time,\nproviding both type safety and efficient serialization."},"v1Number":{"type":"object","properties":{"lo":{"type":"integer","format":"int64","description":"Low 32 bits of the 96-bit mantissa."},"mid":{"type":"integer","format":"int64","description":"Middle 32 bits of the 96-bit mantissa."},"hi":{"type":"integer","format":"int64","description":"High 32 bits of the 96-bit mantissa."},"flags":{"type":"integer","format":"int64","description":"Flags word:\n - Bits 16–23: scale (0–28)\n - Bit 31: sign (0 = positive, 1 = negative)\n - Other bits must be zero."}},"description":"A fixed-precision decimal number with up to 28 fractional digits.\n\nThis message represents decimal numbers with exact precision, avoiding\nfloating-point rounding errors. It's particularly useful for financial\ncalculations, measurements, and any scenario where exact decimal\nrepresentation is required.\n\nThe value is calculated as: m / 10^e, where:\n - m is an unsigned 96-bit integer composed of (lo, mid, hi)\n - e is the scale (0–28) stored in flags bits 16–23\n - sign is encoded in flags bit 31 (0 = positive, 1 = negative)\n\nExamples:\n - 123.45 would have m=12345, e=2\n - -0.001 would have m=1, e=3, with sign bit set\n"},"typeDate":{"type":"object","properties":{"year":{"type":"integer","format":"int32","description":"Year of the date. Must be from 1 to 9999, or 0 to specify a date without\na year."},"month":{"type":"integer","format":"int32","description":"Month of a year. Must be from 1 to 12, or 0 to specify a year without a\nmonth and day."},"day":{"type":"integer","format":"int32","description":"Day of a month. Must be from 1 to 31 and valid for the year and month, or 0\nto specify a year by itself or a year and month where the day isn't\nsignificant."}},"description":"* A full date, with non-zero year, month, and day values\n* A month and day value, with a zero year, such as an anniversary\n* A year on its own, with zero month and day values\n* A year and month value, with a zero day, such as a credit card expiration\ndate\n\nRelated types are [google.type.TimeOfDay][google.type.TimeOfDay] and\n`google.protobuf.Timestamp`.","title":"Represents a whole or partial calendar date, such as a birthday. The time of\nday and time zone are either specified elsewhere or are insignificant. The\ndate is relative to the Gregorian Calendar. This can represent one of the\nfollowing:"},"typeTimeOfDay":{"type":"object","properties":{"hours":{"type":"integer","format":"int32","description":"Hours of day in 24 hour format. Should be from 0 to 23. An API may choose\nto allow the value \"24:00:00\" for scenarios like business closing time."},"minutes":{"type":"integer","format":"int32","description":"Minutes of hour of day. Must be from 0 to 59."},"seconds":{"type":"integer","format":"int32","description":"Seconds of minutes of the time. Must normally be from 0 to 59. An API may\nallow the value 60 if it allows leap-seconds."},"nanos":{"type":"integer","format":"int32","description":"Fractions of seconds in nanoseconds. Must be from 0 to 999,999,999."}},"description":"Represents a time of day. The date and time zone are either not significant\nor are specified elsewhere. An API may choose to allow leap seconds. Related\ntypes are [google.type.Date][google.type.Date] and\n`google.protobuf.Timestamp`."},"typeDateTime":{"type":"object","properties":{"year":{"type":"integer","format":"int32","description":"Optional. Year of date. Must be from 1 to 9999, or 0 if specifying a\ndatetime without a year."},"month":{"type":"integer","format":"int32","description":"Required. Month of year. Must be from 1 to 12."},"day":{"type":"integer","format":"int32","description":"Required. Day of month. Must be from 1 to 31 and valid for the year and\nmonth."},"hours":{"type":"integer","format":"int32","description":"Required. Hours of day in 24 hour format. Should be from 0 to 23. An API\nmay choose to allow the value \"24:00:00\" for scenarios like business\nclosing time."},"minutes":{"type":"integer","format":"int32","description":"Required. Minutes of hour of day. Must be from 0 to 59."},"seconds":{"type":"integer","format":"int32","description":"Required. Seconds of minutes of the time. Must normally be from 0 to 59. An\nAPI may allow the value 60 if it allows leap-seconds."},"nanos":{"type":"integer","format":"int32","description":"Required. Fractions of seconds in nanoseconds. Must be from 0 to\n999,999,999."},"utc_offset":{"type":"string","description":"UTC offset. Must be whole seconds, between -18 hours and +18 hours.\nFor example, a UTC offset of -4:00 would be represented as\n{ seconds: -14400 }."},"time_zone":{"$ref":"#/components/schemas/typeTimeZone"}},"description":"Represents civil time (or occasionally physical time).\n\nThis type can represent a civil time in one of a few possible ways:\n\n * When utc_offset is set and time_zone is unset: a civil time on a calendar\n   day with a particular offset from UTC.\n * When time_zone is set and utc_offset is unset: a civil time on a calendar\n   day in a particular time zone.\n * When neither time_zone nor utc_offset is set: a civil time on a calendar\n   day in local time.\n\nThe date is relative to the Proleptic Gregorian Calendar.\n\nIf year is 0, the DateTime is considered not to have a specific year. month\nand day must have valid, non-zero values.\n\nThis type may also be used to represent a physical time if all the date and\ntime fields are set and either case of the `time_offset` oneof is set.\nConsider using `Timestamp` message for physical time instead. If your use\ncase also would like to store the user's timezone, that can be done in\nanother field.\n\nThis type is more flexible than some applications may want. Make sure to\ndocument and validate your application's limitations."},"typeTimeZone":{"type":"object","properties":{"id":{"type":"string","description":"IANA Time Zone Database time zone, e.g. \"America/New_York\"."},"version":{"type":"string","description":"Optional. IANA Time Zone Database version number, e.g. \"2019a\"."}},"description":"Represents a time zone from the\n[IANA Time Zone Database](https://www.iana.org/time-zones)."},"v1List":{"type":"object","properties":{"items":{"type":"array","items":{"$ref":"#/components/schemas/commonV1Value"},"title":"The ordered sequence of values in this list"}},"description":"Represents an ordered collection of values (similar to arrays or lists).\n\nThis message can contain any number of Value elements in a specific order.\nLists are mutable and can grow or shrink during runtime. Elements can be\naccessed by their zero-based index position.\n\nExamples:\n - [1, 2, 3] - list of numbers\n - [\"hello\", \"world\"] - list of strings\n - [true, 42, \"mixed\"] - list with mixed types\n - [[1, 2], [3, 4]] - nested lists"},"commonV1Value":{"type":"object","properties":{"null_value":{"type":"string","title":"Represents the absence of a value (None/null/undefined)"},"bool_value":{"type":"boolean","title":"Boolean true/false value"},"number":{"$ref":"#/components/schemas/v1Number"},"text":{"type":"string","title":"UTF-8 encoded text string"},"date":{"$ref":"#/components/schemas/typeDate"},"timeofday":{"$ref":"#/components/schemas/typeTimeOfDay"},"datetime":{"$ref":"#/components/schemas/typeDateTime"},"time_zone":{"$ref":"#/components/schemas/typeTimeZone"},"duration":{"type":"string","title":"Signed duration representing a span of time"},"list":{"$ref":"#/components/schemas/v1List"},"dictionary":{"$ref":"#/components/schemas/v1Dictionary"},"file":{"$ref":"#/components/schemas/v1FileValue"},"table":{"$ref":"#/components/schemas/v1TableValue"},"set":{"$ref":"#/components/schemas/v1Set"},"text_value":{"$ref":"#/components/schemas/v1TextValue"},"list_value":{"$ref":"#/components/schemas/commonv1ListValue"},"set_value":{"$ref":"#/components/schemas/v1SetValue"},"dictionary_value":{"$ref":"#/components/schemas/v1DictionaryValue"}},"description":"Represents a runtime value that can be produced by the Jarvis interpreter.\n\nThis message provides a type-safe way to serialize and transmit values between\nthe Jarvis interpreter and other services via gRPC. It supports all the basic\ndata types that can be represented in the Jarvis language runtime.\n\nThe oneof structure ensures that exactly one value type is set at a time,\nproviding both type safety and efficient serialization."},"v1Dictionary":{"type":"object","properties":{"entries":{"type":"array","items":{"$ref":"#/components/schemas/v1DictionaryEntry"},"title":"The key-value pairs stored in this dictionary"}},"description":"Represents a key-value mapping (similar to hash maps or dictionaries).\n\nThis message stores associations between keys and values, where keys must be\nhashable types (null, bool, Number, string, Date, TimeOfDay, DateTime, TimeZone). Keys are\nunique within a dictionary - duplicate keys will overwrite previous values.\n\nThe dictionary maintains insertion order for consistent iteration behavior.\n\nExamples:\n - {\"name\": \"John\", \"age\": 30} - string keys with mixed values\n - {1: \"one\", 2: \"two\"} - number keys with string values\n - {\"nested\": {\"inner\": \"value\"}} - nested dictionaries"},"v1DictionaryEntry":{"type":"object","properties":{"key":{"$ref":"#/components/schemas/v1HashableValue"},"value":{"$ref":"#/components/schemas/commonV1Value"}},"description":"Represents a single key-value pair within a Dictionary.\n\nBoth key and value can be any Value type, though keys should be\nhashable types for proper dictionary behavior. Non-hashable keys\n(like lists or dictionaries) may cause runtime errors."},"v1HashableValue":{"type":"object","properties":{"bool_value":{"type":"boolean","title":"Boolean true/false value"},"number":{"$ref":"#/components/schemas/v1Number"},"text":{"type":"string","title":"UTF-8 encoded text string"},"date":{"$ref":"#/components/schemas/typeDate"},"timeofday":{"$ref":"#/components/schemas/typeTimeOfDay"},"datetime":{"$ref":"#/components/schemas/typeDateTime"},"duration":{"type":"string","title":"Signed duration representing a span of time"},"text_value":{"$ref":"#/components/schemas/v1TextValue"}},"description":"Represents a hashable value that can be used as a dictionary key.\n\nThis message contains only the hashable types from the Value message,\ncorresponding to Python's hashable types. These types can be safely\nused as keys in maps and dictionaries.\n\nHashable types include: bool, Number, string, Date, TimeOfDay, DateTime\nand Duration."},"v1TextValue":{"type":"object","properties":{"remote":{"type":"string","title":"Reference to remote text content via URL or file path"},"inline":{"type":"string","title":"Text content embedded directly in the message"}},"description":"Represents a text value that can be either stored inline or referenced remotely.\n\nThis message provides flexibility for handling text strings in the Jarvis interpreter:\n- Small strings can be embedded directly using the inline option\n- Large strings can be referenced by URL using the remote option\n- The choice depends on string size, network constraints, and access patterns"},"v1FileValue":{"type":"object","properties":{"remote":{"type":"string","title":"Reference to a remote file via URL or file path"},"inline":{"$ref":"#/components/schemas/v1File"}},"description":"Represents a file value that can be either stored inline or referenced remotely.\n\nThis message provides flexibility for handling files in the Jarvis interpreter:\n- Small files can be embedded directly using the inline option\n- Large files can be referenced by URL/path using the remote option\n- The choice depends on file size, network constraints, and access patterns"},"v1File":{"type":"object","properties":{"content":{"type":"string","format":"byte","title":"The raw binary content of the file"},"name":{"type":"string","title":"The name of the file, including extension if applicable"}},"description":"Represents a file with its name and binary content.\n\nThis message contains the complete file data including both metadata\n(filename) and the actual file content as raw bytes. It's used for\nembedding files directly within messages when the file size is\nmanageable and immediate access is required.\n\nExamples:\n - Configuration files\n - Small text or binary files\n - Generated reports or documents\n - Temporary files created during execution\n"},"v1TableValue":{"type":"object","properties":{"remote":{"type":"string","title":"Reference to a remote table via URL or file path (feather-v2 format)"},"inline":{"$ref":"#/components/schemas/v1Table"}},"description":"Represents a table value that can be either stored inline or referenced remotely."},"v1Table":{"type":"object","properties":{"data":{"type":"string","format":"byte","title":"The table data serialized in feather-v2 format"}},"description":"Represents a table with data in feather-v2 format.\n\nThis message contains the complete table data serialized using the\nfeather-v2 format, which provides efficient columnar storage and\nfast serialization/deserialization for tabular data."},"v1Set":{"type":"object","properties":{"items":{"type":"array","items":{"$ref":"#/components/schemas/v1HashableValue"},"title":"The unique elements stored in this set\nAll elements must be hashable types"}},"description":"Represents an unordered collection of unique values.\n\nThis message stores a collection of unique elements, where duplicate values\nare automatically removed. Only hashable types can be stored in sets.\nSets are useful for membership testing, removing duplicates, and mathematical\nset operations like union, intersection, and difference.\n\nThe set does not maintain insertion order - elements may appear in any order\nduring iteration.\n\nExamples:\n - {1, 2, 3} - set of numbers\n - {\"apple\", \"banana\", \"cherry\"} - set of strings\n - {true, false} - set of booleans\n - {1, \"hello\", true} - set with mixed hashable types"},"commonv1ListValue":{"type":"object","properties":{"remote":{"type":"string","title":"Reference to remote list data via URL or file path"},"inline":{"$ref":"#/components/schemas/v1List"}},"description":"Represents a list value that can be either stored inline or referenced remotely.\n\nThis message provides flexibility for handling large lists:\n- Small lists can be embedded directly using the inline option\n- Large lists can be referenced by URL using the remote option"},"v1SetValue":{"type":"object","properties":{"remote":{"type":"string","title":"Reference to remote set data via URL or file path"},"inline":{"$ref":"#/components/schemas/v1Set"}},"description":"Represents a set value that can be either stored inline or referenced remotely.\n\nThis message provides flexibility for handling large sets:\n- Small sets can be embedded directly using the inline option\n- Large sets can be referenced by URL using the remote option"},"v1DictionaryValue":{"type":"object","properties":{"remote":{"type":"string","title":"Reference to remote dictionary data via URL or file path"},"inline":{"$ref":"#/components/schemas/v1Dictionary"}},"description":"Represents a dictionary value that can be either stored inline or referenced remotely.\n\nThis message provides flexibility for handling large dictionaries:\n- Small dictionaries can be embedded directly using the inline option\n- Large dictionaries can be referenced by URL using the remote option"},"v1WorkUnitStatus":{"type":"string","enum":["WORK_UNIT_STATUS_UNSPECIFIED","WORK_UNIT_STATUS_WAITING_FOR_INPUT","WORK_UNIT_STATUS_ANSWERED","WORK_UNIT_STATUS_DISMISSED","WORK_UNIT_STATUS_WITHDRAWN","WORK_UNIT_STATUS_PROCESSING"],"default":"WORK_UNIT_STATUS_UNSPECIFIED","description":"WorkUnitStatus records attention and final resolution independently of delivery.\n\n - WORK_UNIT_STATUS_UNSPECIFIED: Default value; not returned for an existing resource.\n - WORK_UNIT_STATUS_WAITING_FOR_INPUT: Waiting for intermediate input or a direct final answer: an item input_form\nexists and input is unaccepted, or no input_form exists and the kind does\nnot require preparation. Saving either draft leaves status unchanged.\n - WORK_UNIT_STATUS_ANSWERED: Final submission and its delivery obligation are durable.\n - WORK_UNIT_STATUS_DISMISSED: Locally dismissed by item archival, arrival or rekey into an archived item.\nUnarchive restores it unless the source or operator has withdrawn it.\n - WORK_UNIT_STATUS_WITHDRAWN: Source or operator ended the occurrence without an answer.\n - WORK_UNIT_STATUS_PROCESSING: Analysis or decision preparation is pending; no current human request.\nIncludes work without an input_form whose kind requires preparation, and\nfinal-answer preparation after intermediate input acceptance."},"v1EffectDelivery":{"type":"object","properties":{"name":{"type":"string","description":"Resource name; the final segment is the dispatch_id given to the source."},"work_unit":{"type":"string","description":"The unit whose decision this delivers.","readOnly":true},"submission":{"type":"string","description":"The final submission this delivers; always present.","readOnly":true},"attempt_count":{"type":"integer","format":"int32","description":"Count of publish attempts across automatic and operator retry cycles.","readOnly":true},"publish_time":{"type":"string","format":"date-time","description":"First successful broker acknowledgement. Absent before publication.","readOnly":true},"result_time":{"type":"string","format":"date-time","description":"Time Workbench durably received a terminal source result.","readOnly":true},"outcome":{"$ref":"#/components/schemas/v1DecisionOutcome"},"rejection_reason":{"type":"string","description":"Source rejection reason, present only for REJECTED.","readOnly":true},"confirmation_deadline":{"type":"string","format":"date-time","description":"Fixed at first successful publication. Passing this time without a result\nmeans confirmation overdue, never that delivery or application failed.","readOnly":true},"attention_required_time":{"type":"string","format":"date-time","description":"When automatic retries stopped pending operator attention. A late result\nremains admissible. This is not a terminal source result.","readOnly":true},"last_error":{"type":"string","description":"Business-safe operational diagnostic, distinct from a source rejection.\nNo traceback, internal identifier or resource name; richer detail is logged.","readOnly":true}},"description":"EffectDelivery is the durable obligation to deliver one decision to one unit.\nA source result is independent of publication and of unit settlement."},"v1DecisionOutcome":{"type":"string","enum":["DECISION_OUTCOME_UNSPECIFIED","DECISION_OUTCOME_APPLIED","DECISION_OUTCOME_REJECTED"],"default":"DECISION_OUTCOME_UNSPECIFIED","description":"DecisionOutcome is a source's terminal result for a specific dispatch.\n\n - DECISION_OUTCOME_UNSPECIFIED: Not a terminal result; callers must select an outcome.\n - DECISION_OUTCOME_APPLIED: The requested action was committed or durably scheduled by the source.\nThis does not assert that the downstream workflow succeeded.\n - DECISION_OUTCOME_REJECTED: The source definitively refused the decision. A reason is required."},"v1FormSpec":{"type":"object","properties":{"fields":{"type":"array","items":{"$ref":"#/components/schemas/v1FormField"},"description":"At least one question, with unique nonempty keys. Order is the semantic\nreading sequence, not a prescribed screen layout."}},"description":"A set of typed questions for human input or source answers (R6, R13, R14).\nField types derive the returned record type. The platform selects controls\nand layout; there are no widgets, scripts, URLs, or executable expressions.\nShared human input may reference options in each unit's immutable evidence.\nWorkbench resolves those references into the unit's InputContext before use.\nSource answer forms must already be resolved. Filled values are separate messages.\nSources persist their answer form with the pending invocation for recovery.","required":["fields"]},"v1FormField":{"type":"object","properties":{"key":{"type":"string","description":"Stable record key. Unique within its field set; nonempty."},"label":{"type":"string","description":"Business-facing wording, independent of the programmatic key; nonempty."},"help_text":{"type":"string","description":"Optional guidance displayed with the question."},"value_type":{"$ref":"#/components/schemas/v1ValueType"},"initial_value":{"$ref":"#/components/schemas/commonv1Value"},"text":{"$ref":"#/components/schemas/v1TextConstraints"},"number":{"$ref":"#/components/schemas/v1NumberConstraints"},"input_spec":{"$ref":"#/components/schemas/v1InputSpec"}},"description":"One named question, its answer type and its input behavior.","required":["key","label","value_type"]},"v1ValueType":{"type":"object","properties":{"scalar_type":{"$ref":"#/components/schemas/v1ValueScalarType"},"optional_type":{"$ref":"#/components/schemas/v1ValueOptionalType"},"list_type":{"$ref":"#/components/schemas/v1ValueListType"},"dictionary_type":{"$ref":"#/components/schemas/v1ValueDictionaryType"},"table_type":{"$ref":"#/components/schemas/v1ValueTableType"},"opaque_type":{"$ref":"#/components/schemas/v1ValueOpaqueType"},"any_type":{"$ref":"#/components/schemas/v1ValueAnyType"},"union_type":{"$ref":"#/components/schemas/v1ValueUnionType"},"sensitive_type":{"$ref":"#/components/schemas/v1ValueSensitiveType"},"enum_type":{"$ref":"#/components/schemas/v1ValueEnumType"},"generic_dictionary_type":{"$ref":"#/components/schemas/v1ValueGenericDictionaryType"},"none_type":{"$ref":"#/components/schemas/v1ValueNoneType"}},"title":"Represents a complete value type definition using a discriminated union"},"v1ValueScalarType":{"type":"string","enum":["VALUE_SCALAR_TYPE_UNSPECIFIED","VALUE_SCALAR_TYPE_TEXT","VALUE_SCALAR_TYPE_NUMBER","VALUE_SCALAR_TYPE_BOOLEAN","VALUE_SCALAR_TYPE_DATETIME","VALUE_SCALAR_TYPE_DATE","VALUE_SCALAR_TYPE_TIME","VALUE_SCALAR_TYPE_FILE","VALUE_SCALAR_TYPE_TIMEDELTA"],"default":"VALUE_SCALAR_TYPE_UNSPECIFIED","description":"- VALUE_SCALAR_TYPE_UNSPECIFIED: Unspecified value type\n - VALUE_SCALAR_TYPE_TEXT: A text value type\n - VALUE_SCALAR_TYPE_NUMBER: A number value type\n - VALUE_SCALAR_TYPE_BOOLEAN: A boolean value type\n - VALUE_SCALAR_TYPE_DATETIME: A datetime value type\n - VALUE_SCALAR_TYPE_DATE: A date value type\n - VALUE_SCALAR_TYPE_TIME: A time value type\n - VALUE_SCALAR_TYPE_FILE: A file value type\n - VALUE_SCALAR_TYPE_TIMEDELTA: A timedelta value type","title":"Supported Value Scalar Types"},"v1ValueOptionalType":{"type":"object","properties":{"inner":{"$ref":"#/components/schemas/v1ValueType"}},"title":"Represents a value type that can be optional (nullable)"},"v1ValueListType":{"type":"object","properties":{"inner":{"$ref":"#/components/schemas/v1ValueType"}},"title":"Represents a list/array value type containing elements of a specific type"},"v1ValueDictionaryType":{"type":"object","properties":{"is_a":{"type":"string","title":"Semantic classification of what this dictionary represents"},"fields":{"type":"array","items":{"$ref":"#/components/schemas/v1ValueDictionaryTypeField"},"title":"The named fields contained in this dictionary"},"description":{"type":"string","title":"Optional human-readable description of this dictionary type"}},"title":"Represents a dictionary/object value type with named fields"},"v1ValueDictionaryTypeField":{"type":"object","properties":{"key":{"type":"string","title":"The name/key of this field"},"value":{"$ref":"#/components/schemas/v1ValueType"},"description":{"type":"string","title":"Optional human-readable description of this field"}},"title":"Represents a single field within a dictionary value type"},"v1ValueTableType":{"type":"object","properties":{"is_a":{"type":"string","title":"Semantic classification of what this table represents"},"columns":{"type":"array","items":{"$ref":"#/components/schemas/v1ValueTableTypeColumn"},"title":"The columns that make up this table"},"description":{"type":"string","title":"Optional human-readable description of this table type"}},"title":"Represents a table value type with structured columns"},"v1ValueTableTypeColumn":{"type":"object","properties":{"key":{"type":"string","title":"The name/key of this column"},"value":{"$ref":"#/components/schemas/v1ValueType"},"description":{"type":"string","title":"Optional human-readable description of this column"}},"title":"Represents a single column within a table value type"},"v1ValueOpaqueType":{"type":"object","properties":{"is_a":{"type":"string","title":"Semantic classification of what this opaque type represents"},"description":{"type":"string","title":"Optional human-readable description of this opaque type"}},"title":"Represents an opaque value type with semantic meaning but unknown internal structure"},"v1ValueAnyType":{"type":"object","title":"Represents a value type that can hold any kind of value"},"v1ValueUnionType":{"type":"object","properties":{"inners":{"type":"array","items":{"$ref":"#/components/schemas/v1ValueType"},"title":"The possible value types in this union"}},"title":"Represents a union value type that can be one of several possible types"},"v1ValueSensitiveType":{"type":"object","properties":{"inner":{"$ref":"#/components/schemas/v1ValueType"}},"title":"Represents a value type that contains sensitive information"},"v1ValueEnumType":{"type":"object","properties":{"is_a":{"type":"string","title":"Semantic classification of what this enum represents"},"members":{"type":"array","items":{"$ref":"#/components/schemas/v1ValueEnumTypeMember"},"title":"The available options/members of this enum"},"description":{"type":"string","title":"Optional human-readable description of this enum type"}},"title":"Represents an enumeration value type with predefined options"},"v1ValueEnumTypeMember":{"type":"object","properties":{"name":{"type":"string","title":"The programmatic name of this enum member"},"description":{"type":"string","title":"Optional human-readable description of this enum member"}},"title":"Represents a single member/option within an enum value type"},"v1ValueGenericDictionaryType":{"type":"object","properties":{"key_type":{"$ref":"#/components/schemas/v1ValueType"},"value_type":{"$ref":"#/components/schemas/v1ValueType"}},"title":"Represent a generic dictionary that can hold any entry of a particular key and value type"},"v1ValueNoneType":{"type":"object","title":"Represents a none value type that can hold no value"},"v1TextConstraints":{"type":"object","properties":{"min_length":{"type":"integer","format":"int64","description":"Unicode scalar-value counts, not bytes or UTF-16 code units. No implicit\ntrimming, normalization, pattern evaluation or text transformation."},"max_length":{"type":"integer","format":"int64","description":"Inclusive maximum length, measured in Unicode scalar values."}},"description":"Length restrictions on a text answer."},"v1NumberConstraints":{"type":"object","properties":{"minimum":{"$ref":"#/components/schemas/v1Number"},"maximum":{"$ref":"#/components/schemas/v1Number"},"integer_only":{"type":"boolean","description":"Require a value with no fractional component."}},"description":"Exact decimal restrictions on a numeric answer."},"v1InputSpec":{"type":"object","properties":{"selection":{"$ref":"#/components/schemas/v1SelectionInput"}},"description":"How a person supplies a typed answer. Concrete controls and layout belong\nto the renderer. No option carries follow-up fields or executable behavior."},"v1SelectionInput":{"type":"object","properties":{"options":{"type":"array","items":{"$ref":"#/components/schemas/v1SelectionOption"},"description":"Distinct typed values with nonempty labels. May be empty. Each value must\nsatisfy the scalar/element type and applicable field constraints. Numeric\nequality is decimal equality, so 1 and 1.0 are the same option."},"min_selections":{"type":"integer","format":"int64","description":"Only for list fields. Omitted minimum means zero; omitted maximum means the\noption count. Bounds must be ordered and, for nonempty option sets, no greater\nthan that count. Empty selections retain bounds for answer validation.\nUnknown or repeated selections fail. Persist selections in option order,\nusing the declared option values, not user click order or numeric encoding."},"max_selections":{"type":"integer","format":"int64","description":"Inclusive maximum number of selected options."},"options_ref":{"type":"string","description":"Exact nonempty top-level WorkUnit.evidence key, not a path or expression.\nAllowed only in shared human input, mutually exclusive with inline options.\nValid evidence is an inline list of distinct scalar values matching\nthe field's scalar/element type and constraints. Inline text wrappers are\nnormalized to text. No remote reads, record projections or coercion occur.\nEach value is both the displayed choice and the submitted value: text is\nunchanged, numbers use exact decimal text, booleans use true/false, and dates\nuse YYYY-MM-DD. Empty text has no display label and is invalid as an option.\nMissing, empty or invalid choices produce an empty selection, not an input\nerror or free entry. Other fields remain usable. Initial values incompatible\nwith the resolved selection are omitted for that unit."}},"description":"A finite set of offered values. A scalar field selects one value; a list\nfield selects distinct values of its element type. Optional None is absence,\nnever an option. Use inline options or options_ref, not both. Empty selections\noffer no choices and never enable free entry. Resolved unit input and source\nanswer forms use inline options only."},"v1SelectionOption":{"type":"object","properties":{"label":{"type":"string","description":"Nonempty display wording, independent of the submitted value."},"value":{"$ref":"#/components/schemas/commonv1Value"}},"description":"Display wording and the typed value returned when this option is selected.","required":["label","value"]},"v1InputContext":{"type":"object","properties":{"form":{"$ref":"#/components/schemas/v1FormSpec"},"response":{"$ref":"#/components/schemas/v1InputResponse"}},"description":"A human-input form paired with its response.\n\nThe form preserves the meaning of values after form edits or membership changes."},"v1InputResponse":{"type":"object","properties":{"values":{"type":"object","additionalProperties":{"$ref":"#/components/schemas/commonv1Value"},"description":"Current values. Drafts may omit required fields, but supplied values must\nsatisfy the published form. Empty values clear the draft. Unknown keys fail.","readOnly":true},"etag":{"type":"string","description":"Opaque concurrency token. Changes on edits, acceptance, revocation and\nunarchive or form changes. Never reused after clearing a response or rekey.\nClients must return the token they actually read.","readOnly":true},"updated_by":{"type":"string","description":"Actor who last edited values. Empty for a newly created, untouched draft.","readOnly":true},"update_time":{"type":"string","format":"date-time","description":"Time of the latest draft or acceptance change.","readOnly":true},"accepted_by":{"type":"string","description":"Authenticated actor who explicitly accepted these values; empty if not\naccepted. User attribution does not distinguish a human from their agent.","readOnly":true},"accept_time":{"type":"string","format":"date-time","description":"Present only while acceptance is valid. Revoke acceptance before editing.\nForm edits, rekey and unarchive invalidate acceptance; final submission\nprevents editing.","readOnly":true}},"description":"Editable per-unit human input, with explicit acceptance separate from filling.\nAcceptance permits final-answer preparation; it is not a final submission."},"v1AnswerDraft":{"type":"object","properties":{"values":{"type":"object","additionalProperties":{"$ref":"#/components/schemas/commonv1Value"},"description":"Supplied fields must validate; required top-level fields may be omitted.\nSupplied structured values must be complete. Unknown keys fail.","readOnly":true},"etag":{"type":"string","description":"Concurrency token, present before the first save. Changes on saves.\nClearing values never reuses a token.","readOnly":true},"updated_by":{"type":"string","description":"Authenticated actor who last saved values; empty before the first save.","readOnly":true},"update_time":{"type":"string","format":"date-time","description":"Time of the latest save.","readOnly":true}},"description":"Partial final-answer values for one immutable source answer contract.\n\nSaving is optional and never accepts input or settles the unit."},"rpcStatus":{"type":"object","properties":{"code":{"type":"integer","format":"int32"},"message":{"type":"string"},"details":{"type":"array","items":{"$ref":"#/components/schemas/protobufAny"}}}},"protobufAny":{"type":"object","properties":{"@type":{"type":"string"}},"additionalProperties":{}}}},"paths":{"/api/v1/organizations/{organization_id}/workspaces/{workspace_id}/workUnits":{"get":{"summary":"List Work Units","description":"ListWorkUnits lists workspace units and, per unit, whether the answer\ntook effect.\n\nEach unit carries the same fields as GetWorkUnit, including evidence and\nanswer_form, input and answer_draft. Choose page_size to keep the complete response within transport limits.","operationId":"ListWorkUnits","responses":{"200":{"description":"A successful response.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/v1ListWorkUnitsResponse"}}}},"default":{"description":"An unexpected error response.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/rpcStatus"}}}}},"parameters":[{"name":"organization_id","in":"path","required":true,"schema":{"type":"string"}},{"name":"workspace_id","in":"path","required":true,"schema":{"type":"string"}},{"name":"page_size","description":"The maximum number of units to return. The service may return fewer.\nIf unspecified, at most 50 units are returned. The maximum is 1000; values\nabove 1000 are coerced to 1000.","in":"query","required":false,"schema":{"type":"integer","format":"int32"}},{"name":"page_token","description":"The page token received from a previous ListWorkUnits call.","in":"query","required":false,"schema":{"type":"string"}},{"name":"filter","description":"An AIP-160 filter expression over workspace units. An empty filter lists all units,\nincluding occurrences with no work item.\n\nFilterable fields, with the operators each admits:\n\n  work_item                    =  !=  :*\n  kind, source_ref, occurrence_id =  !=\n  correlation_id               =  !=  :*\n  status                       =  !=\n  labels.*                     =  !=  :*\n  create_time, update_time     =  !=  <  <=  >  >=\n  settle_time                  =  !=  <  <=  >  >=  :*\n\nAnything else is INVALID_ARGUMENT, including an ordered comparison on a\nlabel and any field not listed. assignee and delivery.outcome are not\nfilterable; every unit returned carries its own delivery.\n\ncorrelation_id is scoped by the workspace; include kind when looking up\nrelated requests from one source kind. Uncorrelated units match neither\nequality nor inequality; use NOT correlation_id:* for absence.\n\nwork_item compares a full WorkItem resource name, including its workspace;\na bare identifier is INVALID_ARGUMENT. Units without an item match neither\nequality nor inequality; use NOT work_item:* for absence.\n\nA label filter matches the unit's labels as they stand now. A unit that\ndoes not carry the label matches neither `labels.k = \"v\"` nor\n`labels.k != \"v\"`; use `NOT labels.k:*` for absence. Unresolved units\nhave status WAITING_FOR_INPUT or PROCESSING and no settle_time.","in":"query","required":false,"schema":{"type":"string"}},{"name":"order_by","description":"How to order the results. Orderable fields: create_time, update_time,\nsettle_time, each ascending or descending. Defaults to create_time\nascending. Ties break by name, so a page boundary neither repeats nor\nskips a unit sharing a timestamp with another.","in":"query","required":false,"schema":{"type":"string"}}],"tags":["Work Items"]}}}}
```

## Batch Create Submissions

> BatchCreateSubmissions applies a shared answer or each selected unit's saved draft.\
> All selected submissions and delivery obligations commit together or none do.\
> Validate and normalize independently for each unit; response order matches\
> work\_units. New arrivals outside the selection receive no decision.\
> Reject duplicate names, empty selection, malformed names or a unit whose\
> workspace differs from parent with INVALID\_ARGUMENT before writes.\
> work\_item must name an item in parent. Verify every selected unit's stored\
> membership in work\_item atomically with submission; a mismatch returns\
> FAILED\_PRECONDITION. A resource name alone does not establish membership.\
> If any unit is already answered, return ABORTED with the conflict count and\
> first conflicting submission. Read selected units for the remaining\
> submission references; error metadata is bounded. Dismissed/withdrawn units return\
> FAILED\_PRECONDITION. Any failure writes nothing for the entire selection.

```json
{"openapi":"3.0.0","info":{"title":"Kognitos API","version":"1.0.0"},"tags":[{"name":"Work Items","description":"Track work items and work units that need human input."}],"servers":[{"url":"https://app.us-1.kognitos.com"}],"security":[{"BearerAuth":[]}],"components":{"securitySchemes":{"BearerAuth":{"type":"http","scheme":"bearer","description":"Personal Access Token."}},"schemas":{"v1BatchCreateSubmissionsResponse":{"type":"object","properties":{"submissions":{"type":"array","items":{"$ref":"#/components/schemas/v1Submission"},"description":"Same order as request.work_units; every entry is durably accepted."}},"description":"BatchCreateSubmissionsResponse contains one immutable submission per selected unit."},"v1Submission":{"type":"object","properties":{"name":{"type":"string","description":"Full unit-scoped resource name. The identifier is server-generated."},"answer":{"$ref":"#/components/schemas/v1Answer"},"submitter":{"type":"string","title":"Server-derived authenticated actor. An agent acting on a user's behalf is\nattributed to that user; this field does not establish human approval.\nFormat: users/{user_id}","readOnly":true},"descriptor_version":{"type":"string","format":"int64","description":"Version of the kind descriptor used to create the delivery obligation.","readOnly":true},"create_time":{"type":"string","format":"date-time","description":"Time the answer and delivery obligation became durable.","readOnly":true}},"description":"Submission is one immutable final answer to one work-unit occurrence.\n\nA unit accepts at most one submission. Its decision delivery is recorded in\nthe same transaction. Source rejection or delivery failure never replaces it;\na different final answer requires a new source occurrence.","required":["answer"]},"v1Answer":{"type":"object","properties":{"kind":{"type":"string","description":"The registered kind this answer is for, checked against the item on submit."},"values":{"type":"object","additionalProperties":{"$ref":"#/components/schemas/commonv1Value"},"description":"Exact declared field set: unknown keys fail and required omissions fail.\nOptional omission normalizes to None; initial suggestions are never inserted.\nSelection membership and normalization follow the field's InputSpec."}},"description":"Answer is the typed values supplied for the questions in a resolved form.\nEach submission validates against its own unit's source contract.","required":["kind","values"]},"commonv1Value":{"type":"object","properties":{"null_value":{"type":"string","title":"Represents the absence of a value (None/null/undefined)"},"bool_value":{"type":"boolean","title":"Boolean true/false value"},"number":{"$ref":"#/components/schemas/v1Number"},"text":{"type":"string","title":"UTF-8 encoded text string"},"date":{"$ref":"#/components/schemas/typeDate"},"timeofday":{"$ref":"#/components/schemas/typeTimeOfDay"},"datetime":{"$ref":"#/components/schemas/typeDateTime"},"time_zone":{"$ref":"#/components/schemas/typeTimeZone"},"duration":{"type":"string","title":"Signed duration representing a span of time"},"list":{"$ref":"#/components/schemas/v1List"},"dictionary":{"$ref":"#/components/schemas/v1Dictionary"},"file":{"$ref":"#/components/schemas/v1FileValue"},"table":{"$ref":"#/components/schemas/v1TableValue"},"set":{"$ref":"#/components/schemas/v1Set"},"text_value":{"$ref":"#/components/schemas/v1TextValue"},"list_value":{"$ref":"#/components/schemas/commonv1ListValue"},"set_value":{"$ref":"#/components/schemas/v1SetValue"},"dictionary_value":{"$ref":"#/components/schemas/v1DictionaryValue"}},"description":"Represents a runtime value that can be produced by the Jarvis interpreter.\n\nThis message provides a type-safe way to serialize and transmit values between\nthe Jarvis interpreter and other services via gRPC. It supports all the basic\ndata types that can be represented in the Jarvis language runtime.\n\nThe oneof structure ensures that exactly one value type is set at a time,\nproviding both type safety and efficient serialization."},"v1Number":{"type":"object","properties":{"lo":{"type":"integer","format":"int64","description":"Low 32 bits of the 96-bit mantissa."},"mid":{"type":"integer","format":"int64","description":"Middle 32 bits of the 96-bit mantissa."},"hi":{"type":"integer","format":"int64","description":"High 32 bits of the 96-bit mantissa."},"flags":{"type":"integer","format":"int64","description":"Flags word:\n - Bits 16–23: scale (0–28)\n - Bit 31: sign (0 = positive, 1 = negative)\n - Other bits must be zero."}},"description":"A fixed-precision decimal number with up to 28 fractional digits.\n\nThis message represents decimal numbers with exact precision, avoiding\nfloating-point rounding errors. It's particularly useful for financial\ncalculations, measurements, and any scenario where exact decimal\nrepresentation is required.\n\nThe value is calculated as: m / 10^e, where:\n - m is an unsigned 96-bit integer composed of (lo, mid, hi)\n - e is the scale (0–28) stored in flags bits 16–23\n - sign is encoded in flags bit 31 (0 = positive, 1 = negative)\n\nExamples:\n - 123.45 would have m=12345, e=2\n - -0.001 would have m=1, e=3, with sign bit set\n"},"typeDate":{"type":"object","properties":{"year":{"type":"integer","format":"int32","description":"Year of the date. Must be from 1 to 9999, or 0 to specify a date without\na year."},"month":{"type":"integer","format":"int32","description":"Month of a year. Must be from 1 to 12, or 0 to specify a year without a\nmonth and day."},"day":{"type":"integer","format":"int32","description":"Day of a month. Must be from 1 to 31 and valid for the year and month, or 0\nto specify a year by itself or a year and month where the day isn't\nsignificant."}},"description":"* A full date, with non-zero year, month, and day values\n* A month and day value, with a zero year, such as an anniversary\n* A year on its own, with zero month and day values\n* A year and month value, with a zero day, such as a credit card expiration\ndate\n\nRelated types are [google.type.TimeOfDay][google.type.TimeOfDay] and\n`google.protobuf.Timestamp`.","title":"Represents a whole or partial calendar date, such as a birthday. The time of\nday and time zone are either specified elsewhere or are insignificant. The\ndate is relative to the Gregorian Calendar. This can represent one of the\nfollowing:"},"typeTimeOfDay":{"type":"object","properties":{"hours":{"type":"integer","format":"int32","description":"Hours of day in 24 hour format. Should be from 0 to 23. An API may choose\nto allow the value \"24:00:00\" for scenarios like business closing time."},"minutes":{"type":"integer","format":"int32","description":"Minutes of hour of day. Must be from 0 to 59."},"seconds":{"type":"integer","format":"int32","description":"Seconds of minutes of the time. Must normally be from 0 to 59. An API may\nallow the value 60 if it allows leap-seconds."},"nanos":{"type":"integer","format":"int32","description":"Fractions of seconds in nanoseconds. Must be from 0 to 999,999,999."}},"description":"Represents a time of day. The date and time zone are either not significant\nor are specified elsewhere. An API may choose to allow leap seconds. Related\ntypes are [google.type.Date][google.type.Date] and\n`google.protobuf.Timestamp`."},"typeDateTime":{"type":"object","properties":{"year":{"type":"integer","format":"int32","description":"Optional. Year of date. Must be from 1 to 9999, or 0 if specifying a\ndatetime without a year."},"month":{"type":"integer","format":"int32","description":"Required. Month of year. Must be from 1 to 12."},"day":{"type":"integer","format":"int32","description":"Required. Day of month. Must be from 1 to 31 and valid for the year and\nmonth."},"hours":{"type":"integer","format":"int32","description":"Required. Hours of day in 24 hour format. Should be from 0 to 23. An API\nmay choose to allow the value \"24:00:00\" for scenarios like business\nclosing time."},"minutes":{"type":"integer","format":"int32","description":"Required. Minutes of hour of day. Must be from 0 to 59."},"seconds":{"type":"integer","format":"int32","description":"Required. Seconds of minutes of the time. Must normally be from 0 to 59. An\nAPI may allow the value 60 if it allows leap-seconds."},"nanos":{"type":"integer","format":"int32","description":"Required. Fractions of seconds in nanoseconds. Must be from 0 to\n999,999,999."},"utc_offset":{"type":"string","description":"UTC offset. Must be whole seconds, between -18 hours and +18 hours.\nFor example, a UTC offset of -4:00 would be represented as\n{ seconds: -14400 }."},"time_zone":{"$ref":"#/components/schemas/typeTimeZone"}},"description":"Represents civil time (or occasionally physical time).\n\nThis type can represent a civil time in one of a few possible ways:\n\n * When utc_offset is set and time_zone is unset: a civil time on a calendar\n   day with a particular offset from UTC.\n * When time_zone is set and utc_offset is unset: a civil time on a calendar\n   day in a particular time zone.\n * When neither time_zone nor utc_offset is set: a civil time on a calendar\n   day in local time.\n\nThe date is relative to the Proleptic Gregorian Calendar.\n\nIf year is 0, the DateTime is considered not to have a specific year. month\nand day must have valid, non-zero values.\n\nThis type may also be used to represent a physical time if all the date and\ntime fields are set and either case of the `time_offset` oneof is set.\nConsider using `Timestamp` message for physical time instead. If your use\ncase also would like to store the user's timezone, that can be done in\nanother field.\n\nThis type is more flexible than some applications may want. Make sure to\ndocument and validate your application's limitations."},"typeTimeZone":{"type":"object","properties":{"id":{"type":"string","description":"IANA Time Zone Database time zone, e.g. \"America/New_York\"."},"version":{"type":"string","description":"Optional. IANA Time Zone Database version number, e.g. \"2019a\"."}},"description":"Represents a time zone from the\n[IANA Time Zone Database](https://www.iana.org/time-zones)."},"v1List":{"type":"object","properties":{"items":{"type":"array","items":{"$ref":"#/components/schemas/commonV1Value"},"title":"The ordered sequence of values in this list"}},"description":"Represents an ordered collection of values (similar to arrays or lists).\n\nThis message can contain any number of Value elements in a specific order.\nLists are mutable and can grow or shrink during runtime. Elements can be\naccessed by their zero-based index position.\n\nExamples:\n - [1, 2, 3] - list of numbers\n - [\"hello\", \"world\"] - list of strings\n - [true, 42, \"mixed\"] - list with mixed types\n - [[1, 2], [3, 4]] - nested lists"},"commonV1Value":{"type":"object","properties":{"null_value":{"type":"string","title":"Represents the absence of a value (None/null/undefined)"},"bool_value":{"type":"boolean","title":"Boolean true/false value"},"number":{"$ref":"#/components/schemas/v1Number"},"text":{"type":"string","title":"UTF-8 encoded text string"},"date":{"$ref":"#/components/schemas/typeDate"},"timeofday":{"$ref":"#/components/schemas/typeTimeOfDay"},"datetime":{"$ref":"#/components/schemas/typeDateTime"},"time_zone":{"$ref":"#/components/schemas/typeTimeZone"},"duration":{"type":"string","title":"Signed duration representing a span of time"},"list":{"$ref":"#/components/schemas/v1List"},"dictionary":{"$ref":"#/components/schemas/v1Dictionary"},"file":{"$ref":"#/components/schemas/v1FileValue"},"table":{"$ref":"#/components/schemas/v1TableValue"},"set":{"$ref":"#/components/schemas/v1Set"},"text_value":{"$ref":"#/components/schemas/v1TextValue"},"list_value":{"$ref":"#/components/schemas/commonv1ListValue"},"set_value":{"$ref":"#/components/schemas/v1SetValue"},"dictionary_value":{"$ref":"#/components/schemas/v1DictionaryValue"}},"description":"Represents a runtime value that can be produced by the Jarvis interpreter.\n\nThis message provides a type-safe way to serialize and transmit values between\nthe Jarvis interpreter and other services via gRPC. It supports all the basic\ndata types that can be represented in the Jarvis language runtime.\n\nThe oneof structure ensures that exactly one value type is set at a time,\nproviding both type safety and efficient serialization."},"v1Dictionary":{"type":"object","properties":{"entries":{"type":"array","items":{"$ref":"#/components/schemas/v1DictionaryEntry"},"title":"The key-value pairs stored in this dictionary"}},"description":"Represents a key-value mapping (similar to hash maps or dictionaries).\n\nThis message stores associations between keys and values, where keys must be\nhashable types (null, bool, Number, string, Date, TimeOfDay, DateTime, TimeZone). Keys are\nunique within a dictionary - duplicate keys will overwrite previous values.\n\nThe dictionary maintains insertion order for consistent iteration behavior.\n\nExamples:\n - {\"name\": \"John\", \"age\": 30} - string keys with mixed values\n - {1: \"one\", 2: \"two\"} - number keys with string values\n - {\"nested\": {\"inner\": \"value\"}} - nested dictionaries"},"v1DictionaryEntry":{"type":"object","properties":{"key":{"$ref":"#/components/schemas/v1HashableValue"},"value":{"$ref":"#/components/schemas/commonV1Value"}},"description":"Represents a single key-value pair within a Dictionary.\n\nBoth key and value can be any Value type, though keys should be\nhashable types for proper dictionary behavior. Non-hashable keys\n(like lists or dictionaries) may cause runtime errors."},"v1HashableValue":{"type":"object","properties":{"bool_value":{"type":"boolean","title":"Boolean true/false value"},"number":{"$ref":"#/components/schemas/v1Number"},"text":{"type":"string","title":"UTF-8 encoded text string"},"date":{"$ref":"#/components/schemas/typeDate"},"timeofday":{"$ref":"#/components/schemas/typeTimeOfDay"},"datetime":{"$ref":"#/components/schemas/typeDateTime"},"duration":{"type":"string","title":"Signed duration representing a span of time"},"text_value":{"$ref":"#/components/schemas/v1TextValue"}},"description":"Represents a hashable value that can be used as a dictionary key.\n\nThis message contains only the hashable types from the Value message,\ncorresponding to Python's hashable types. These types can be safely\nused as keys in maps and dictionaries.\n\nHashable types include: bool, Number, string, Date, TimeOfDay, DateTime\nand Duration."},"v1TextValue":{"type":"object","properties":{"remote":{"type":"string","title":"Reference to remote text content via URL or file path"},"inline":{"type":"string","title":"Text content embedded directly in the message"}},"description":"Represents a text value that can be either stored inline or referenced remotely.\n\nThis message provides flexibility for handling text strings in the Jarvis interpreter:\n- Small strings can be embedded directly using the inline option\n- Large strings can be referenced by URL using the remote option\n- The choice depends on string size, network constraints, and access patterns"},"v1FileValue":{"type":"object","properties":{"remote":{"type":"string","title":"Reference to a remote file via URL or file path"},"inline":{"$ref":"#/components/schemas/v1File"}},"description":"Represents a file value that can be either stored inline or referenced remotely.\n\nThis message provides flexibility for handling files in the Jarvis interpreter:\n- Small files can be embedded directly using the inline option\n- Large files can be referenced by URL/path using the remote option\n- The choice depends on file size, network constraints, and access patterns"},"v1File":{"type":"object","properties":{"content":{"type":"string","format":"byte","title":"The raw binary content of the file"},"name":{"type":"string","title":"The name of the file, including extension if applicable"}},"description":"Represents a file with its name and binary content.\n\nThis message contains the complete file data including both metadata\n(filename) and the actual file content as raw bytes. It's used for\nembedding files directly within messages when the file size is\nmanageable and immediate access is required.\n\nExamples:\n - Configuration files\n - Small text or binary files\n - Generated reports or documents\n - Temporary files created during execution\n"},"v1TableValue":{"type":"object","properties":{"remote":{"type":"string","title":"Reference to a remote table via URL or file path (feather-v2 format)"},"inline":{"$ref":"#/components/schemas/v1Table"}},"description":"Represents a table value that can be either stored inline or referenced remotely."},"v1Table":{"type":"object","properties":{"data":{"type":"string","format":"byte","title":"The table data serialized in feather-v2 format"}},"description":"Represents a table with data in feather-v2 format.\n\nThis message contains the complete table data serialized using the\nfeather-v2 format, which provides efficient columnar storage and\nfast serialization/deserialization for tabular data."},"v1Set":{"type":"object","properties":{"items":{"type":"array","items":{"$ref":"#/components/schemas/v1HashableValue"},"title":"The unique elements stored in this set\nAll elements must be hashable types"}},"description":"Represents an unordered collection of unique values.\n\nThis message stores a collection of unique elements, where duplicate values\nare automatically removed. Only hashable types can be stored in sets.\nSets are useful for membership testing, removing duplicates, and mathematical\nset operations like union, intersection, and difference.\n\nThe set does not maintain insertion order - elements may appear in any order\nduring iteration.\n\nExamples:\n - {1, 2, 3} - set of numbers\n - {\"apple\", \"banana\", \"cherry\"} - set of strings\n - {true, false} - set of booleans\n - {1, \"hello\", true} - set with mixed hashable types"},"commonv1ListValue":{"type":"object","properties":{"remote":{"type":"string","title":"Reference to remote list data via URL or file path"},"inline":{"$ref":"#/components/schemas/v1List"}},"description":"Represents a list value that can be either stored inline or referenced remotely.\n\nThis message provides flexibility for handling large lists:\n- Small lists can be embedded directly using the inline option\n- Large lists can be referenced by URL using the remote option"},"v1SetValue":{"type":"object","properties":{"remote":{"type":"string","title":"Reference to remote set data via URL or file path"},"inline":{"$ref":"#/components/schemas/v1Set"}},"description":"Represents a set value that can be either stored inline or referenced remotely.\n\nThis message provides flexibility for handling large sets:\n- Small sets can be embedded directly using the inline option\n- Large sets can be referenced by URL using the remote option"},"v1DictionaryValue":{"type":"object","properties":{"remote":{"type":"string","title":"Reference to remote dictionary data via URL or file path"},"inline":{"$ref":"#/components/schemas/v1Dictionary"}},"description":"Represents a dictionary value that can be either stored inline or referenced remotely.\n\nThis message provides flexibility for handling large dictionaries:\n- Small dictionaries can be embedded directly using the inline option\n- Large dictionaries can be referenced by URL using the remote option"},"rpcStatus":{"type":"object","properties":{"code":{"type":"integer","format":"int32"},"message":{"type":"string"},"details":{"type":"array","items":{"$ref":"#/components/schemas/protobufAny"}}}},"protobufAny":{"type":"object","properties":{"@type":{"type":"string"}},"additionalProperties":{}},"SubmissionServiceBatchCreateSubmissionsBody":{"type":"object","properties":{"work_units":{"type":"array","items":{"type":"string"},"description":"Nonempty distinct full resource names, not IDs. Every name must belong to parent."},"answer":{"$ref":"#/components/schemas/v1Answer"},"work_item":{"type":"string","description":"Expected current item of every selected unit, checked atomically on submit.\nMust belong to parent. Units outside this item, including itemless units,\nreject the entire batch."},"answer_draft_etags":{"type":"object","additionalProperties":{"type":"string"},"description":"Supply answer or this map, exactly one. Each selected unit must have exactly\none nonempty token, keyed by its full resource name. Each unit submits its\nown saved values. One stale, incomplete\nor invalid draft rejects the entire batch.\nSuccessful submission clears all selected drafts atomically."}},"description":"BatchCreateSubmissionsRequest submits a shared answer or per-unit saved drafts.","required":["work_units","work_item"]}}},"paths":{"/api/v1/organizations/{organization_id}/workspaces/{workspace_id}/workUnits/submissions:batchCreate":{"post":{"summary":"Batch Create Submissions","description":"BatchCreateSubmissions applies a shared answer or each selected unit's saved draft.\nAll selected submissions and delivery obligations commit together or none do.\nValidate and normalize independently for each unit; response order matches\nwork_units. New arrivals outside the selection receive no decision.\nReject duplicate names, empty selection, malformed names or a unit whose\nworkspace differs from parent with INVALID_ARGUMENT before writes.\nwork_item must name an item in parent. Verify every selected unit's stored\nmembership in work_item atomically with submission; a mismatch returns\nFAILED_PRECONDITION. A resource name alone does not establish membership.\nIf any unit is already answered, return ABORTED with the conflict count and\nfirst conflicting submission. Read selected units for the remaining\nsubmission references; error metadata is bounded. Dismissed/withdrawn units return\nFAILED_PRECONDITION. Any failure writes nothing for the entire selection.","operationId":"BatchCreateSubmissions","responses":{"200":{"description":"A successful response.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/v1BatchCreateSubmissionsResponse"}}}},"default":{"description":"An unexpected error response.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/rpcStatus"}}}}},"parameters":[{"name":"organization_id","in":"path","required":true,"schema":{"type":"string"}},{"name":"workspace_id","in":"path","required":true,"schema":{"type":"string"}}],"requestBody":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/SubmissionServiceBatchCreateSubmissionsBody"}}},"required":true},"tags":["Work Items"]}}}}
```

## Get Work Unit

> GetWorkUnit retrieves one unit in full, including the evidence behind it\
> and whether its decision took effect.

```json
{"openapi":"3.0.0","info":{"title":"Kognitos API","version":"1.0.0"},"tags":[{"name":"Work Items","description":"Track work items and work units that need human input."}],"servers":[{"url":"https://app.us-1.kognitos.com"}],"security":[{"BearerAuth":[]}],"components":{"securitySchemes":{"BearerAuth":{"type":"http","scheme":"bearer","description":"Personal Access Token."}},"schemas":{"v1WorkUnit":{"type":"object","properties":{"name":{"type":"string","title":"The stable workspace-scoped resource name of the work unit.\nFormat: organizations/{organization_id}/workspaces/{workspace_id}/workUnits/{work_unit_id}"},"work_item":{"type":"string","description":"Current grouping membership in the same workspace. Rekey may change this reference without changing\nthe unit's name. Empty when the occurrence has no work item.","readOnly":true},"source_ref":{"type":"string","description":"The source's own id for this unit, combined with occurrence_id to identify one request\nfor attention within an organization, workspace and kind across history.\n\nThe source's shape rather than ours. Decisions also carry occurrence_id so a later request\nabout the same thing cannot consume an earlier answer. Not a label: no\nkind declares it and no grouping configuration names it."},"correlation_id":{"type":"string","description":"Source-owned correlation shared by related requests within this organization,\nworkspace and kind. Empty when none was supplied on first admission.\nImmutable; returned by Get and List and filterable through ListWorkUnits.\nIndependent of work-item grouping, occurrence identity and decision routing.","readOnly":true},"kind":{"type":"string","description":"The registered kind of work, as an opaque dotted id. See\nWorkItem.kind.","readOnly":true},"labels":{"type":"object","additionalProperties":{"type":"string"},"description":"The facts the source stated about this unit. The subset the workspace\ngroups on became its item's agg_labels, where a key the workspace groups\non that this unit does not carry became a null.","readOnly":true},"summary":{"type":"string","description":"One line about this unit in business language, as its source put it. The\nquestion, when this is the unit that materialised the item.\n\nImmutable for this occurrence, including before acceptance.","readOnly":true},"detail":{"type":"string","description":"Additional source-authored text describing this occurrence. Empty when omitted.\nImmutable for the occurrence; returned by GetWorkUnit and ListWorkUnits.","readOnly":true},"identifying_details":{"type":"array","items":{"$ref":"#/components/schemas/v1IdentifyingDetail"},"description":"Ordered identifying facts, immutable for this occurrence. Entries with a\nblank label or value are omitted. Clients fall back to summary, then the\nkind display name when empty; detail is supplementary context, not a heading.","readOnly":true},"evidence":{"type":"object","additionalProperties":{"$ref":"#/components/schemas/commonv1Value"},"description":"What a person reads to decide: the records and facts behind this unit,\nnamed and typed, so the platform renders it and the source ships no\nrendering (R6).\n\nImmutable for this occurrence. Changed decision context requires withdrawal\nand a new occurrence. Re-reports never overwrite this evidence.\n\nReturned by both GetWorkUnit and ListWorkUnits.","readOnly":true},"status":{"$ref":"#/components/schemas/v1WorkUnitStatus"},"delivery":{"$ref":"#/components/schemas/v1EffectDelivery"},"settle_time":{"type":"string","format":"date-time","description":"When attention ended for this occurrence: answer, dismissal or withdrawal.","readOnly":true},"create_time":{"type":"string","format":"date-time","description":"The time this unit was first seen.","readOnly":true},"update_time":{"type":"string","format":"date-time","description":"The time this unit last changed, including by a source's re-report.","readOnly":true},"occurrence_id":{"type":"string","description":"The source's immutable identifier for this particular request for attention.\nRe-reports reuse it; a new request uses a new one even for the same source_ref.","readOnly":true},"previous_delivery":{"type":"string","description":"Earlier delivery whose rejection or later execution raised this question.\nEmpty for ordinary arrivals. Exposes follow-up provenance to the surface.","readOnly":true},"submission":{"type":"string","description":"The sole accepted final submission, or empty while no answer is recorded.","readOnly":true},"answer_form":{"$ref":"#/components/schemas/v1FormSpec"},"input":{"$ref":"#/components/schemas/v1InputContext"},"answer_draft":{"$ref":"#/components/schemas/v1AnswerDraft"},"revision":{"type":"string","format":"int64","description":"Monotonically increasing version of this resource's mutable state,\nincluding resolved input and embedded delivery. Compare only versions of\nthe same resource. Independent of mutation etags.","readOnly":true}},"description":"WorkUnit is one real-world thing needing attention, as its source reported\nit: a run that failed, a record that was flagged, an automation waiting on a\nvalue.\n\nThe workspace is the resource parent. The name remains stable across rekey;\nwork_item records grouping membership rather than resource parentage.\nA source reports occurrences without naming an item or asserting grouping."},"v1IdentifyingDetail":{"type":"object","properties":{"label":{"type":"string","description":"Business-facing label, for example \"Invoice\"."},"value":{"type":"string","description":"Nonempty display fallback, for example \"INV-1042\" or \"invoice.pdf\"."},"evidence_ref":{"type":"string","description":"Optional exact top-level key in the same work unit's evidence map.\nThis is neither a resource URI nor an expression. Readers use value when\nabsent, unresolved or unavailable; an invalid reference never rejects work."}},"description":"A source-authored identifying fact for a unit's compact heading.\nDisplayed in source order, with optional access to frozen evidence."},"commonv1Value":{"type":"object","properties":{"null_value":{"type":"string","title":"Represents the absence of a value (None/null/undefined)"},"bool_value":{"type":"boolean","title":"Boolean true/false value"},"number":{"$ref":"#/components/schemas/v1Number"},"text":{"type":"string","title":"UTF-8 encoded text string"},"date":{"$ref":"#/components/schemas/typeDate"},"timeofday":{"$ref":"#/components/schemas/typeTimeOfDay"},"datetime":{"$ref":"#/components/schemas/typeDateTime"},"time_zone":{"$ref":"#/components/schemas/typeTimeZone"},"duration":{"type":"string","title":"Signed duration representing a span of time"},"list":{"$ref":"#/components/schemas/v1List"},"dictionary":{"$ref":"#/components/schemas/v1Dictionary"},"file":{"$ref":"#/components/schemas/v1FileValue"},"table":{"$ref":"#/components/schemas/v1TableValue"},"set":{"$ref":"#/components/schemas/v1Set"},"text_value":{"$ref":"#/components/schemas/v1TextValue"},"list_value":{"$ref":"#/components/schemas/commonv1ListValue"},"set_value":{"$ref":"#/components/schemas/v1SetValue"},"dictionary_value":{"$ref":"#/components/schemas/v1DictionaryValue"}},"description":"Represents a runtime value that can be produced by the Jarvis interpreter.\n\nThis message provides a type-safe way to serialize and transmit values between\nthe Jarvis interpreter and other services via gRPC. It supports all the basic\ndata types that can be represented in the Jarvis language runtime.\n\nThe oneof structure ensures that exactly one value type is set at a time,\nproviding both type safety and efficient serialization."},"v1Number":{"type":"object","properties":{"lo":{"type":"integer","format":"int64","description":"Low 32 bits of the 96-bit mantissa."},"mid":{"type":"integer","format":"int64","description":"Middle 32 bits of the 96-bit mantissa."},"hi":{"type":"integer","format":"int64","description":"High 32 bits of the 96-bit mantissa."},"flags":{"type":"integer","format":"int64","description":"Flags word:\n - Bits 16–23: scale (0–28)\n - Bit 31: sign (0 = positive, 1 = negative)\n - Other bits must be zero."}},"description":"A fixed-precision decimal number with up to 28 fractional digits.\n\nThis message represents decimal numbers with exact precision, avoiding\nfloating-point rounding errors. It's particularly useful for financial\ncalculations, measurements, and any scenario where exact decimal\nrepresentation is required.\n\nThe value is calculated as: m / 10^e, where:\n - m is an unsigned 96-bit integer composed of (lo, mid, hi)\n - e is the scale (0–28) stored in flags bits 16–23\n - sign is encoded in flags bit 31 (0 = positive, 1 = negative)\n\nExamples:\n - 123.45 would have m=12345, e=2\n - -0.001 would have m=1, e=3, with sign bit set\n"},"typeDate":{"type":"object","properties":{"year":{"type":"integer","format":"int32","description":"Year of the date. Must be from 1 to 9999, or 0 to specify a date without\na year."},"month":{"type":"integer","format":"int32","description":"Month of a year. Must be from 1 to 12, or 0 to specify a year without a\nmonth and day."},"day":{"type":"integer","format":"int32","description":"Day of a month. Must be from 1 to 31 and valid for the year and month, or 0\nto specify a year by itself or a year and month where the day isn't\nsignificant."}},"description":"* A full date, with non-zero year, month, and day values\n* A month and day value, with a zero year, such as an anniversary\n* A year on its own, with zero month and day values\n* A year and month value, with a zero day, such as a credit card expiration\ndate\n\nRelated types are [google.type.TimeOfDay][google.type.TimeOfDay] and\n`google.protobuf.Timestamp`.","title":"Represents a whole or partial calendar date, such as a birthday. The time of\nday and time zone are either specified elsewhere or are insignificant. The\ndate is relative to the Gregorian Calendar. This can represent one of the\nfollowing:"},"typeTimeOfDay":{"type":"object","properties":{"hours":{"type":"integer","format":"int32","description":"Hours of day in 24 hour format. Should be from 0 to 23. An API may choose\nto allow the value \"24:00:00\" for scenarios like business closing time."},"minutes":{"type":"integer","format":"int32","description":"Minutes of hour of day. Must be from 0 to 59."},"seconds":{"type":"integer","format":"int32","description":"Seconds of minutes of the time. Must normally be from 0 to 59. An API may\nallow the value 60 if it allows leap-seconds."},"nanos":{"type":"integer","format":"int32","description":"Fractions of seconds in nanoseconds. Must be from 0 to 999,999,999."}},"description":"Represents a time of day. The date and time zone are either not significant\nor are specified elsewhere. An API may choose to allow leap seconds. Related\ntypes are [google.type.Date][google.type.Date] and\n`google.protobuf.Timestamp`."},"typeDateTime":{"type":"object","properties":{"year":{"type":"integer","format":"int32","description":"Optional. Year of date. Must be from 1 to 9999, or 0 if specifying a\ndatetime without a year."},"month":{"type":"integer","format":"int32","description":"Required. Month of year. Must be from 1 to 12."},"day":{"type":"integer","format":"int32","description":"Required. Day of month. Must be from 1 to 31 and valid for the year and\nmonth."},"hours":{"type":"integer","format":"int32","description":"Required. Hours of day in 24 hour format. Should be from 0 to 23. An API\nmay choose to allow the value \"24:00:00\" for scenarios like business\nclosing time."},"minutes":{"type":"integer","format":"int32","description":"Required. Minutes of hour of day. Must be from 0 to 59."},"seconds":{"type":"integer","format":"int32","description":"Required. Seconds of minutes of the time. Must normally be from 0 to 59. An\nAPI may allow the value 60 if it allows leap-seconds."},"nanos":{"type":"integer","format":"int32","description":"Required. Fractions of seconds in nanoseconds. Must be from 0 to\n999,999,999."},"utc_offset":{"type":"string","description":"UTC offset. Must be whole seconds, between -18 hours and +18 hours.\nFor example, a UTC offset of -4:00 would be represented as\n{ seconds: -14400 }."},"time_zone":{"$ref":"#/components/schemas/typeTimeZone"}},"description":"Represents civil time (or occasionally physical time).\n\nThis type can represent a civil time in one of a few possible ways:\n\n * When utc_offset is set and time_zone is unset: a civil time on a calendar\n   day with a particular offset from UTC.\n * When time_zone is set and utc_offset is unset: a civil time on a calendar\n   day in a particular time zone.\n * When neither time_zone nor utc_offset is set: a civil time on a calendar\n   day in local time.\n\nThe date is relative to the Proleptic Gregorian Calendar.\n\nIf year is 0, the DateTime is considered not to have a specific year. month\nand day must have valid, non-zero values.\n\nThis type may also be used to represent a physical time if all the date and\ntime fields are set and either case of the `time_offset` oneof is set.\nConsider using `Timestamp` message for physical time instead. If your use\ncase also would like to store the user's timezone, that can be done in\nanother field.\n\nThis type is more flexible than some applications may want. Make sure to\ndocument and validate your application's limitations."},"typeTimeZone":{"type":"object","properties":{"id":{"type":"string","description":"IANA Time Zone Database time zone, e.g. \"America/New_York\"."},"version":{"type":"string","description":"Optional. IANA Time Zone Database version number, e.g. \"2019a\"."}},"description":"Represents a time zone from the\n[IANA Time Zone Database](https://www.iana.org/time-zones)."},"v1List":{"type":"object","properties":{"items":{"type":"array","items":{"$ref":"#/components/schemas/commonV1Value"},"title":"The ordered sequence of values in this list"}},"description":"Represents an ordered collection of values (similar to arrays or lists).\n\nThis message can contain any number of Value elements in a specific order.\nLists are mutable and can grow or shrink during runtime. Elements can be\naccessed by their zero-based index position.\n\nExamples:\n - [1, 2, 3] - list of numbers\n - [\"hello\", \"world\"] - list of strings\n - [true, 42, \"mixed\"] - list with mixed types\n - [[1, 2], [3, 4]] - nested lists"},"commonV1Value":{"type":"object","properties":{"null_value":{"type":"string","title":"Represents the absence of a value (None/null/undefined)"},"bool_value":{"type":"boolean","title":"Boolean true/false value"},"number":{"$ref":"#/components/schemas/v1Number"},"text":{"type":"string","title":"UTF-8 encoded text string"},"date":{"$ref":"#/components/schemas/typeDate"},"timeofday":{"$ref":"#/components/schemas/typeTimeOfDay"},"datetime":{"$ref":"#/components/schemas/typeDateTime"},"time_zone":{"$ref":"#/components/schemas/typeTimeZone"},"duration":{"type":"string","title":"Signed duration representing a span of time"},"list":{"$ref":"#/components/schemas/v1List"},"dictionary":{"$ref":"#/components/schemas/v1Dictionary"},"file":{"$ref":"#/components/schemas/v1FileValue"},"table":{"$ref":"#/components/schemas/v1TableValue"},"set":{"$ref":"#/components/schemas/v1Set"},"text_value":{"$ref":"#/components/schemas/v1TextValue"},"list_value":{"$ref":"#/components/schemas/commonv1ListValue"},"set_value":{"$ref":"#/components/schemas/v1SetValue"},"dictionary_value":{"$ref":"#/components/schemas/v1DictionaryValue"}},"description":"Represents a runtime value that can be produced by the Jarvis interpreter.\n\nThis message provides a type-safe way to serialize and transmit values between\nthe Jarvis interpreter and other services via gRPC. It supports all the basic\ndata types that can be represented in the Jarvis language runtime.\n\nThe oneof structure ensures that exactly one value type is set at a time,\nproviding both type safety and efficient serialization."},"v1Dictionary":{"type":"object","properties":{"entries":{"type":"array","items":{"$ref":"#/components/schemas/v1DictionaryEntry"},"title":"The key-value pairs stored in this dictionary"}},"description":"Represents a key-value mapping (similar to hash maps or dictionaries).\n\nThis message stores associations between keys and values, where keys must be\nhashable types (null, bool, Number, string, Date, TimeOfDay, DateTime, TimeZone). Keys are\nunique within a dictionary - duplicate keys will overwrite previous values.\n\nThe dictionary maintains insertion order for consistent iteration behavior.\n\nExamples:\n - {\"name\": \"John\", \"age\": 30} - string keys with mixed values\n - {1: \"one\", 2: \"two\"} - number keys with string values\n - {\"nested\": {\"inner\": \"value\"}} - nested dictionaries"},"v1DictionaryEntry":{"type":"object","properties":{"key":{"$ref":"#/components/schemas/v1HashableValue"},"value":{"$ref":"#/components/schemas/commonV1Value"}},"description":"Represents a single key-value pair within a Dictionary.\n\nBoth key and value can be any Value type, though keys should be\nhashable types for proper dictionary behavior. Non-hashable keys\n(like lists or dictionaries) may cause runtime errors."},"v1HashableValue":{"type":"object","properties":{"bool_value":{"type":"boolean","title":"Boolean true/false value"},"number":{"$ref":"#/components/schemas/v1Number"},"text":{"type":"string","title":"UTF-8 encoded text string"},"date":{"$ref":"#/components/schemas/typeDate"},"timeofday":{"$ref":"#/components/schemas/typeTimeOfDay"},"datetime":{"$ref":"#/components/schemas/typeDateTime"},"duration":{"type":"string","title":"Signed duration representing a span of time"},"text_value":{"$ref":"#/components/schemas/v1TextValue"}},"description":"Represents a hashable value that can be used as a dictionary key.\n\nThis message contains only the hashable types from the Value message,\ncorresponding to Python's hashable types. These types can be safely\nused as keys in maps and dictionaries.\n\nHashable types include: bool, Number, string, Date, TimeOfDay, DateTime\nand Duration."},"v1TextValue":{"type":"object","properties":{"remote":{"type":"string","title":"Reference to remote text content via URL or file path"},"inline":{"type":"string","title":"Text content embedded directly in the message"}},"description":"Represents a text value that can be either stored inline or referenced remotely.\n\nThis message provides flexibility for handling text strings in the Jarvis interpreter:\n- Small strings can be embedded directly using the inline option\n- Large strings can be referenced by URL using the remote option\n- The choice depends on string size, network constraints, and access patterns"},"v1FileValue":{"type":"object","properties":{"remote":{"type":"string","title":"Reference to a remote file via URL or file path"},"inline":{"$ref":"#/components/schemas/v1File"}},"description":"Represents a file value that can be either stored inline or referenced remotely.\n\nThis message provides flexibility for handling files in the Jarvis interpreter:\n- Small files can be embedded directly using the inline option\n- Large files can be referenced by URL/path using the remote option\n- The choice depends on file size, network constraints, and access patterns"},"v1File":{"type":"object","properties":{"content":{"type":"string","format":"byte","title":"The raw binary content of the file"},"name":{"type":"string","title":"The name of the file, including extension if applicable"}},"description":"Represents a file with its name and binary content.\n\nThis message contains the complete file data including both metadata\n(filename) and the actual file content as raw bytes. It's used for\nembedding files directly within messages when the file size is\nmanageable and immediate access is required.\n\nExamples:\n - Configuration files\n - Small text or binary files\n - Generated reports or documents\n - Temporary files created during execution\n"},"v1TableValue":{"type":"object","properties":{"remote":{"type":"string","title":"Reference to a remote table via URL or file path (feather-v2 format)"},"inline":{"$ref":"#/components/schemas/v1Table"}},"description":"Represents a table value that can be either stored inline or referenced remotely."},"v1Table":{"type":"object","properties":{"data":{"type":"string","format":"byte","title":"The table data serialized in feather-v2 format"}},"description":"Represents a table with data in feather-v2 format.\n\nThis message contains the complete table data serialized using the\nfeather-v2 format, which provides efficient columnar storage and\nfast serialization/deserialization for tabular data."},"v1Set":{"type":"object","properties":{"items":{"type":"array","items":{"$ref":"#/components/schemas/v1HashableValue"},"title":"The unique elements stored in this set\nAll elements must be hashable types"}},"description":"Represents an unordered collection of unique values.\n\nThis message stores a collection of unique elements, where duplicate values\nare automatically removed. Only hashable types can be stored in sets.\nSets are useful for membership testing, removing duplicates, and mathematical\nset operations like union, intersection, and difference.\n\nThe set does not maintain insertion order - elements may appear in any order\nduring iteration.\n\nExamples:\n - {1, 2, 3} - set of numbers\n - {\"apple\", \"banana\", \"cherry\"} - set of strings\n - {true, false} - set of booleans\n - {1, \"hello\", true} - set with mixed hashable types"},"commonv1ListValue":{"type":"object","properties":{"remote":{"type":"string","title":"Reference to remote list data via URL or file path"},"inline":{"$ref":"#/components/schemas/v1List"}},"description":"Represents a list value that can be either stored inline or referenced remotely.\n\nThis message provides flexibility for handling large lists:\n- Small lists can be embedded directly using the inline option\n- Large lists can be referenced by URL using the remote option"},"v1SetValue":{"type":"object","properties":{"remote":{"type":"string","title":"Reference to remote set data via URL or file path"},"inline":{"$ref":"#/components/schemas/v1Set"}},"description":"Represents a set value that can be either stored inline or referenced remotely.\n\nThis message provides flexibility for handling large sets:\n- Small sets can be embedded directly using the inline option\n- Large sets can be referenced by URL using the remote option"},"v1DictionaryValue":{"type":"object","properties":{"remote":{"type":"string","title":"Reference to remote dictionary data via URL or file path"},"inline":{"$ref":"#/components/schemas/v1Dictionary"}},"description":"Represents a dictionary value that can be either stored inline or referenced remotely.\n\nThis message provides flexibility for handling large dictionaries:\n- Small dictionaries can be embedded directly using the inline option\n- Large dictionaries can be referenced by URL using the remote option"},"v1WorkUnitStatus":{"type":"string","enum":["WORK_UNIT_STATUS_UNSPECIFIED","WORK_UNIT_STATUS_WAITING_FOR_INPUT","WORK_UNIT_STATUS_ANSWERED","WORK_UNIT_STATUS_DISMISSED","WORK_UNIT_STATUS_WITHDRAWN","WORK_UNIT_STATUS_PROCESSING"],"default":"WORK_UNIT_STATUS_UNSPECIFIED","description":"WorkUnitStatus records attention and final resolution independently of delivery.\n\n - WORK_UNIT_STATUS_UNSPECIFIED: Default value; not returned for an existing resource.\n - WORK_UNIT_STATUS_WAITING_FOR_INPUT: Waiting for intermediate input or a direct final answer: an item input_form\nexists and input is unaccepted, or no input_form exists and the kind does\nnot require preparation. Saving either draft leaves status unchanged.\n - WORK_UNIT_STATUS_ANSWERED: Final submission and its delivery obligation are durable.\n - WORK_UNIT_STATUS_DISMISSED: Locally dismissed by item archival, arrival or rekey into an archived item.\nUnarchive restores it unless the source or operator has withdrawn it.\n - WORK_UNIT_STATUS_WITHDRAWN: Source or operator ended the occurrence without an answer.\n - WORK_UNIT_STATUS_PROCESSING: Analysis or decision preparation is pending; no current human request.\nIncludes work without an input_form whose kind requires preparation, and\nfinal-answer preparation after intermediate input acceptance."},"v1EffectDelivery":{"type":"object","properties":{"name":{"type":"string","description":"Resource name; the final segment is the dispatch_id given to the source."},"work_unit":{"type":"string","description":"The unit whose decision this delivers.","readOnly":true},"submission":{"type":"string","description":"The final submission this delivers; always present.","readOnly":true},"attempt_count":{"type":"integer","format":"int32","description":"Count of publish attempts across automatic and operator retry cycles.","readOnly":true},"publish_time":{"type":"string","format":"date-time","description":"First successful broker acknowledgement. Absent before publication.","readOnly":true},"result_time":{"type":"string","format":"date-time","description":"Time Workbench durably received a terminal source result.","readOnly":true},"outcome":{"$ref":"#/components/schemas/v1DecisionOutcome"},"rejection_reason":{"type":"string","description":"Source rejection reason, present only for REJECTED.","readOnly":true},"confirmation_deadline":{"type":"string","format":"date-time","description":"Fixed at first successful publication. Passing this time without a result\nmeans confirmation overdue, never that delivery or application failed.","readOnly":true},"attention_required_time":{"type":"string","format":"date-time","description":"When automatic retries stopped pending operator attention. A late result\nremains admissible. This is not a terminal source result.","readOnly":true},"last_error":{"type":"string","description":"Business-safe operational diagnostic, distinct from a source rejection.\nNo traceback, internal identifier or resource name; richer detail is logged.","readOnly":true}},"description":"EffectDelivery is the durable obligation to deliver one decision to one unit.\nA source result is independent of publication and of unit settlement."},"v1DecisionOutcome":{"type":"string","enum":["DECISION_OUTCOME_UNSPECIFIED","DECISION_OUTCOME_APPLIED","DECISION_OUTCOME_REJECTED"],"default":"DECISION_OUTCOME_UNSPECIFIED","description":"DecisionOutcome is a source's terminal result for a specific dispatch.\n\n - DECISION_OUTCOME_UNSPECIFIED: Not a terminal result; callers must select an outcome.\n - DECISION_OUTCOME_APPLIED: The requested action was committed or durably scheduled by the source.\nThis does not assert that the downstream workflow succeeded.\n - DECISION_OUTCOME_REJECTED: The source definitively refused the decision. A reason is required."},"v1FormSpec":{"type":"object","properties":{"fields":{"type":"array","items":{"$ref":"#/components/schemas/v1FormField"},"description":"At least one question, with unique nonempty keys. Order is the semantic\nreading sequence, not a prescribed screen layout."}},"description":"A set of typed questions for human input or source answers (R6, R13, R14).\nField types derive the returned record type. The platform selects controls\nand layout; there are no widgets, scripts, URLs, or executable expressions.\nShared human input may reference options in each unit's immutable evidence.\nWorkbench resolves those references into the unit's InputContext before use.\nSource answer forms must already be resolved. Filled values are separate messages.\nSources persist their answer form with the pending invocation for recovery.","required":["fields"]},"v1FormField":{"type":"object","properties":{"key":{"type":"string","description":"Stable record key. Unique within its field set; nonempty."},"label":{"type":"string","description":"Business-facing wording, independent of the programmatic key; nonempty."},"help_text":{"type":"string","description":"Optional guidance displayed with the question."},"value_type":{"$ref":"#/components/schemas/v1ValueType"},"initial_value":{"$ref":"#/components/schemas/commonv1Value"},"text":{"$ref":"#/components/schemas/v1TextConstraints"},"number":{"$ref":"#/components/schemas/v1NumberConstraints"},"input_spec":{"$ref":"#/components/schemas/v1InputSpec"}},"description":"One named question, its answer type and its input behavior.","required":["key","label","value_type"]},"v1ValueType":{"type":"object","properties":{"scalar_type":{"$ref":"#/components/schemas/v1ValueScalarType"},"optional_type":{"$ref":"#/components/schemas/v1ValueOptionalType"},"list_type":{"$ref":"#/components/schemas/v1ValueListType"},"dictionary_type":{"$ref":"#/components/schemas/v1ValueDictionaryType"},"table_type":{"$ref":"#/components/schemas/v1ValueTableType"},"opaque_type":{"$ref":"#/components/schemas/v1ValueOpaqueType"},"any_type":{"$ref":"#/components/schemas/v1ValueAnyType"},"union_type":{"$ref":"#/components/schemas/v1ValueUnionType"},"sensitive_type":{"$ref":"#/components/schemas/v1ValueSensitiveType"},"enum_type":{"$ref":"#/components/schemas/v1ValueEnumType"},"generic_dictionary_type":{"$ref":"#/components/schemas/v1ValueGenericDictionaryType"},"none_type":{"$ref":"#/components/schemas/v1ValueNoneType"}},"title":"Represents a complete value type definition using a discriminated union"},"v1ValueScalarType":{"type":"string","enum":["VALUE_SCALAR_TYPE_UNSPECIFIED","VALUE_SCALAR_TYPE_TEXT","VALUE_SCALAR_TYPE_NUMBER","VALUE_SCALAR_TYPE_BOOLEAN","VALUE_SCALAR_TYPE_DATETIME","VALUE_SCALAR_TYPE_DATE","VALUE_SCALAR_TYPE_TIME","VALUE_SCALAR_TYPE_FILE","VALUE_SCALAR_TYPE_TIMEDELTA"],"default":"VALUE_SCALAR_TYPE_UNSPECIFIED","description":"- VALUE_SCALAR_TYPE_UNSPECIFIED: Unspecified value type\n - VALUE_SCALAR_TYPE_TEXT: A text value type\n - VALUE_SCALAR_TYPE_NUMBER: A number value type\n - VALUE_SCALAR_TYPE_BOOLEAN: A boolean value type\n - VALUE_SCALAR_TYPE_DATETIME: A datetime value type\n - VALUE_SCALAR_TYPE_DATE: A date value type\n - VALUE_SCALAR_TYPE_TIME: A time value type\n - VALUE_SCALAR_TYPE_FILE: A file value type\n - VALUE_SCALAR_TYPE_TIMEDELTA: A timedelta value type","title":"Supported Value Scalar Types"},"v1ValueOptionalType":{"type":"object","properties":{"inner":{"$ref":"#/components/schemas/v1ValueType"}},"title":"Represents a value type that can be optional (nullable)"},"v1ValueListType":{"type":"object","properties":{"inner":{"$ref":"#/components/schemas/v1ValueType"}},"title":"Represents a list/array value type containing elements of a specific type"},"v1ValueDictionaryType":{"type":"object","properties":{"is_a":{"type":"string","title":"Semantic classification of what this dictionary represents"},"fields":{"type":"array","items":{"$ref":"#/components/schemas/v1ValueDictionaryTypeField"},"title":"The named fields contained in this dictionary"},"description":{"type":"string","title":"Optional human-readable description of this dictionary type"}},"title":"Represents a dictionary/object value type with named fields"},"v1ValueDictionaryTypeField":{"type":"object","properties":{"key":{"type":"string","title":"The name/key of this field"},"value":{"$ref":"#/components/schemas/v1ValueType"},"description":{"type":"string","title":"Optional human-readable description of this field"}},"title":"Represents a single field within a dictionary value type"},"v1ValueTableType":{"type":"object","properties":{"is_a":{"type":"string","title":"Semantic classification of what this table represents"},"columns":{"type":"array","items":{"$ref":"#/components/schemas/v1ValueTableTypeColumn"},"title":"The columns that make up this table"},"description":{"type":"string","title":"Optional human-readable description of this table type"}},"title":"Represents a table value type with structured columns"},"v1ValueTableTypeColumn":{"type":"object","properties":{"key":{"type":"string","title":"The name/key of this column"},"value":{"$ref":"#/components/schemas/v1ValueType"},"description":{"type":"string","title":"Optional human-readable description of this column"}},"title":"Represents a single column within a table value type"},"v1ValueOpaqueType":{"type":"object","properties":{"is_a":{"type":"string","title":"Semantic classification of what this opaque type represents"},"description":{"type":"string","title":"Optional human-readable description of this opaque type"}},"title":"Represents an opaque value type with semantic meaning but unknown internal structure"},"v1ValueAnyType":{"type":"object","title":"Represents a value type that can hold any kind of value"},"v1ValueUnionType":{"type":"object","properties":{"inners":{"type":"array","items":{"$ref":"#/components/schemas/v1ValueType"},"title":"The possible value types in this union"}},"title":"Represents a union value type that can be one of several possible types"},"v1ValueSensitiveType":{"type":"object","properties":{"inner":{"$ref":"#/components/schemas/v1ValueType"}},"title":"Represents a value type that contains sensitive information"},"v1ValueEnumType":{"type":"object","properties":{"is_a":{"type":"string","title":"Semantic classification of what this enum represents"},"members":{"type":"array","items":{"$ref":"#/components/schemas/v1ValueEnumTypeMember"},"title":"The available options/members of this enum"},"description":{"type":"string","title":"Optional human-readable description of this enum type"}},"title":"Represents an enumeration value type with predefined options"},"v1ValueEnumTypeMember":{"type":"object","properties":{"name":{"type":"string","title":"The programmatic name of this enum member"},"description":{"type":"string","title":"Optional human-readable description of this enum member"}},"title":"Represents a single member/option within an enum value type"},"v1ValueGenericDictionaryType":{"type":"object","properties":{"key_type":{"$ref":"#/components/schemas/v1ValueType"},"value_type":{"$ref":"#/components/schemas/v1ValueType"}},"title":"Represent a generic dictionary that can hold any entry of a particular key and value type"},"v1ValueNoneType":{"type":"object","title":"Represents a none value type that can hold no value"},"v1TextConstraints":{"type":"object","properties":{"min_length":{"type":"integer","format":"int64","description":"Unicode scalar-value counts, not bytes or UTF-16 code units. No implicit\ntrimming, normalization, pattern evaluation or text transformation."},"max_length":{"type":"integer","format":"int64","description":"Inclusive maximum length, measured in Unicode scalar values."}},"description":"Length restrictions on a text answer."},"v1NumberConstraints":{"type":"object","properties":{"minimum":{"$ref":"#/components/schemas/v1Number"},"maximum":{"$ref":"#/components/schemas/v1Number"},"integer_only":{"type":"boolean","description":"Require a value with no fractional component."}},"description":"Exact decimal restrictions on a numeric answer."},"v1InputSpec":{"type":"object","properties":{"selection":{"$ref":"#/components/schemas/v1SelectionInput"}},"description":"How a person supplies a typed answer. Concrete controls and layout belong\nto the renderer. No option carries follow-up fields or executable behavior."},"v1SelectionInput":{"type":"object","properties":{"options":{"type":"array","items":{"$ref":"#/components/schemas/v1SelectionOption"},"description":"Distinct typed values with nonempty labels. May be empty. Each value must\nsatisfy the scalar/element type and applicable field constraints. Numeric\nequality is decimal equality, so 1 and 1.0 are the same option."},"min_selections":{"type":"integer","format":"int64","description":"Only for list fields. Omitted minimum means zero; omitted maximum means the\noption count. Bounds must be ordered and, for nonempty option sets, no greater\nthan that count. Empty selections retain bounds for answer validation.\nUnknown or repeated selections fail. Persist selections in option order,\nusing the declared option values, not user click order or numeric encoding."},"max_selections":{"type":"integer","format":"int64","description":"Inclusive maximum number of selected options."},"options_ref":{"type":"string","description":"Exact nonempty top-level WorkUnit.evidence key, not a path or expression.\nAllowed only in shared human input, mutually exclusive with inline options.\nValid evidence is an inline list of distinct scalar values matching\nthe field's scalar/element type and constraints. Inline text wrappers are\nnormalized to text. No remote reads, record projections or coercion occur.\nEach value is both the displayed choice and the submitted value: text is\nunchanged, numbers use exact decimal text, booleans use true/false, and dates\nuse YYYY-MM-DD. Empty text has no display label and is invalid as an option.\nMissing, empty or invalid choices produce an empty selection, not an input\nerror or free entry. Other fields remain usable. Initial values incompatible\nwith the resolved selection are omitted for that unit."}},"description":"A finite set of offered values. A scalar field selects one value; a list\nfield selects distinct values of its element type. Optional None is absence,\nnever an option. Use inline options or options_ref, not both. Empty selections\noffer no choices and never enable free entry. Resolved unit input and source\nanswer forms use inline options only."},"v1SelectionOption":{"type":"object","properties":{"label":{"type":"string","description":"Nonempty display wording, independent of the submitted value."},"value":{"$ref":"#/components/schemas/commonv1Value"}},"description":"Display wording and the typed value returned when this option is selected.","required":["label","value"]},"v1InputContext":{"type":"object","properties":{"form":{"$ref":"#/components/schemas/v1FormSpec"},"response":{"$ref":"#/components/schemas/v1InputResponse"}},"description":"A human-input form paired with its response.\n\nThe form preserves the meaning of values after form edits or membership changes."},"v1InputResponse":{"type":"object","properties":{"values":{"type":"object","additionalProperties":{"$ref":"#/components/schemas/commonv1Value"},"description":"Current values. Drafts may omit required fields, but supplied values must\nsatisfy the published form. Empty values clear the draft. Unknown keys fail.","readOnly":true},"etag":{"type":"string","description":"Opaque concurrency token. Changes on edits, acceptance, revocation and\nunarchive or form changes. Never reused after clearing a response or rekey.\nClients must return the token they actually read.","readOnly":true},"updated_by":{"type":"string","description":"Actor who last edited values. Empty for a newly created, untouched draft.","readOnly":true},"update_time":{"type":"string","format":"date-time","description":"Time of the latest draft or acceptance change.","readOnly":true},"accepted_by":{"type":"string","description":"Authenticated actor who explicitly accepted these values; empty if not\naccepted. User attribution does not distinguish a human from their agent.","readOnly":true},"accept_time":{"type":"string","format":"date-time","description":"Present only while acceptance is valid. Revoke acceptance before editing.\nForm edits, rekey and unarchive invalidate acceptance; final submission\nprevents editing.","readOnly":true}},"description":"Editable per-unit human input, with explicit acceptance separate from filling.\nAcceptance permits final-answer preparation; it is not a final submission."},"v1AnswerDraft":{"type":"object","properties":{"values":{"type":"object","additionalProperties":{"$ref":"#/components/schemas/commonv1Value"},"description":"Supplied fields must validate; required top-level fields may be omitted.\nSupplied structured values must be complete. Unknown keys fail.","readOnly":true},"etag":{"type":"string","description":"Concurrency token, present before the first save. Changes on saves.\nClearing values never reuses a token.","readOnly":true},"updated_by":{"type":"string","description":"Authenticated actor who last saved values; empty before the first save.","readOnly":true},"update_time":{"type":"string","format":"date-time","description":"Time of the latest save.","readOnly":true}},"description":"Partial final-answer values for one immutable source answer contract.\n\nSaving is optional and never accepts input or settles the unit."},"rpcStatus":{"type":"object","properties":{"code":{"type":"integer","format":"int32"},"message":{"type":"string"},"details":{"type":"array","items":{"$ref":"#/components/schemas/protobufAny"}}}},"protobufAny":{"type":"object","properties":{"@type":{"type":"string"}},"additionalProperties":{}}}},"paths":{"/api/v1/organizations/{organization_id}/workspaces/{workspace_id}/workUnits/{work_unit_id}":{"get":{"summary":"Get Work Unit","description":"GetWorkUnit retrieves one unit in full, including the evidence behind it\nand whether its decision took effect.","operationId":"GetWorkUnit","responses":{"200":{"description":"A successful response.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/v1WorkUnit"}}}},"default":{"description":"An unexpected error response.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/rpcStatus"}}}}},"parameters":[{"name":"organization_id","in":"path","required":true,"schema":{"type":"string"}},{"name":"workspace_id","in":"path","required":true,"schema":{"type":"string"}},{"name":"work_unit_id","in":"path","required":true,"schema":{"type":"string"}}],"tags":["Work Items"]}}}}
```

## Create Submission

> CreateSubmission answers one unit. Acceptance, submission and delivery\
> obligation commit atomically; publication and source application are later.\
> Validate the unit's immutable answer\_form and normalize before writes.\
> Human input is optional, even when the item has an input\_form. Validate\
> independently of intermediate input. Alternatively consume the exact\
> answer\_draft\_etag; do not supply direct values in this mode. Successful\
> submission clears the draft in either mode. A direct answer does not check\
> the draft token. Serialize with rekey and settlement.\
> Require an authenticated user; derive submitter from trusted context.\
> ABORTED identifies the existing submission if already answered, even when\
> the repeated request has identical values. Dismissed or withdrawn units\
> return FAILED\_PRECONDITION. Invalid values return INVALID\_ARGUMENT.

```json
{"openapi":"3.0.0","info":{"title":"Kognitos API","version":"1.0.0"},"tags":[{"name":"Work Items","description":"Track work items and work units that need human input."}],"servers":[{"url":"https://app.us-1.kognitos.com"}],"security":[{"BearerAuth":[]}],"components":{"securitySchemes":{"BearerAuth":{"type":"http","scheme":"bearer","description":"Personal Access Token."}},"schemas":{"v1Submission":{"type":"object","properties":{"name":{"type":"string","description":"Full unit-scoped resource name. The identifier is server-generated."},"answer":{"$ref":"#/components/schemas/v1Answer"},"submitter":{"type":"string","title":"Server-derived authenticated actor. An agent acting on a user's behalf is\nattributed to that user; this field does not establish human approval.\nFormat: users/{user_id}","readOnly":true},"descriptor_version":{"type":"string","format":"int64","description":"Version of the kind descriptor used to create the delivery obligation.","readOnly":true},"create_time":{"type":"string","format":"date-time","description":"Time the answer and delivery obligation became durable.","readOnly":true}},"description":"Submission is one immutable final answer to one work-unit occurrence.\n\nA unit accepts at most one submission. Its decision delivery is recorded in\nthe same transaction. Source rejection or delivery failure never replaces it;\na different final answer requires a new source occurrence.","required":["answer"]},"v1Answer":{"type":"object","properties":{"kind":{"type":"string","description":"The registered kind this answer is for, checked against the item on submit."},"values":{"type":"object","additionalProperties":{"$ref":"#/components/schemas/commonv1Value"},"description":"Exact declared field set: unknown keys fail and required omissions fail.\nOptional omission normalizes to None; initial suggestions are never inserted.\nSelection membership and normalization follow the field's InputSpec."}},"description":"Answer is the typed values supplied for the questions in a resolved form.\nEach submission validates against its own unit's source contract.","required":["kind","values"]},"commonv1Value":{"type":"object","properties":{"null_value":{"type":"string","title":"Represents the absence of a value (None/null/undefined)"},"bool_value":{"type":"boolean","title":"Boolean true/false value"},"number":{"$ref":"#/components/schemas/v1Number"},"text":{"type":"string","title":"UTF-8 encoded text string"},"date":{"$ref":"#/components/schemas/typeDate"},"timeofday":{"$ref":"#/components/schemas/typeTimeOfDay"},"datetime":{"$ref":"#/components/schemas/typeDateTime"},"time_zone":{"$ref":"#/components/schemas/typeTimeZone"},"duration":{"type":"string","title":"Signed duration representing a span of time"},"list":{"$ref":"#/components/schemas/v1List"},"dictionary":{"$ref":"#/components/schemas/v1Dictionary"},"file":{"$ref":"#/components/schemas/v1FileValue"},"table":{"$ref":"#/components/schemas/v1TableValue"},"set":{"$ref":"#/components/schemas/v1Set"},"text_value":{"$ref":"#/components/schemas/v1TextValue"},"list_value":{"$ref":"#/components/schemas/commonv1ListValue"},"set_value":{"$ref":"#/components/schemas/v1SetValue"},"dictionary_value":{"$ref":"#/components/schemas/v1DictionaryValue"}},"description":"Represents a runtime value that can be produced by the Jarvis interpreter.\n\nThis message provides a type-safe way to serialize and transmit values between\nthe Jarvis interpreter and other services via gRPC. It supports all the basic\ndata types that can be represented in the Jarvis language runtime.\n\nThe oneof structure ensures that exactly one value type is set at a time,\nproviding both type safety and efficient serialization."},"v1Number":{"type":"object","properties":{"lo":{"type":"integer","format":"int64","description":"Low 32 bits of the 96-bit mantissa."},"mid":{"type":"integer","format":"int64","description":"Middle 32 bits of the 96-bit mantissa."},"hi":{"type":"integer","format":"int64","description":"High 32 bits of the 96-bit mantissa."},"flags":{"type":"integer","format":"int64","description":"Flags word:\n - Bits 16–23: scale (0–28)\n - Bit 31: sign (0 = positive, 1 = negative)\n - Other bits must be zero."}},"description":"A fixed-precision decimal number with up to 28 fractional digits.\n\nThis message represents decimal numbers with exact precision, avoiding\nfloating-point rounding errors. It's particularly useful for financial\ncalculations, measurements, and any scenario where exact decimal\nrepresentation is required.\n\nThe value is calculated as: m / 10^e, where:\n - m is an unsigned 96-bit integer composed of (lo, mid, hi)\n - e is the scale (0–28) stored in flags bits 16–23\n - sign is encoded in flags bit 31 (0 = positive, 1 = negative)\n\nExamples:\n - 123.45 would have m=12345, e=2\n - -0.001 would have m=1, e=3, with sign bit set\n"},"typeDate":{"type":"object","properties":{"year":{"type":"integer","format":"int32","description":"Year of the date. Must be from 1 to 9999, or 0 to specify a date without\na year."},"month":{"type":"integer","format":"int32","description":"Month of a year. Must be from 1 to 12, or 0 to specify a year without a\nmonth and day."},"day":{"type":"integer","format":"int32","description":"Day of a month. Must be from 1 to 31 and valid for the year and month, or 0\nto specify a year by itself or a year and month where the day isn't\nsignificant."}},"description":"* A full date, with non-zero year, month, and day values\n* A month and day value, with a zero year, such as an anniversary\n* A year on its own, with zero month and day values\n* A year and month value, with a zero day, such as a credit card expiration\ndate\n\nRelated types are [google.type.TimeOfDay][google.type.TimeOfDay] and\n`google.protobuf.Timestamp`.","title":"Represents a whole or partial calendar date, such as a birthday. The time of\nday and time zone are either specified elsewhere or are insignificant. The\ndate is relative to the Gregorian Calendar. This can represent one of the\nfollowing:"},"typeTimeOfDay":{"type":"object","properties":{"hours":{"type":"integer","format":"int32","description":"Hours of day in 24 hour format. Should be from 0 to 23. An API may choose\nto allow the value \"24:00:00\" for scenarios like business closing time."},"minutes":{"type":"integer","format":"int32","description":"Minutes of hour of day. Must be from 0 to 59."},"seconds":{"type":"integer","format":"int32","description":"Seconds of minutes of the time. Must normally be from 0 to 59. An API may\nallow the value 60 if it allows leap-seconds."},"nanos":{"type":"integer","format":"int32","description":"Fractions of seconds in nanoseconds. Must be from 0 to 999,999,999."}},"description":"Represents a time of day. The date and time zone are either not significant\nor are specified elsewhere. An API may choose to allow leap seconds. Related\ntypes are [google.type.Date][google.type.Date] and\n`google.protobuf.Timestamp`."},"typeDateTime":{"type":"object","properties":{"year":{"type":"integer","format":"int32","description":"Optional. Year of date. Must be from 1 to 9999, or 0 if specifying a\ndatetime without a year."},"month":{"type":"integer","format":"int32","description":"Required. Month of year. Must be from 1 to 12."},"day":{"type":"integer","format":"int32","description":"Required. Day of month. Must be from 1 to 31 and valid for the year and\nmonth."},"hours":{"type":"integer","format":"int32","description":"Required. Hours of day in 24 hour format. Should be from 0 to 23. An API\nmay choose to allow the value \"24:00:00\" for scenarios like business\nclosing time."},"minutes":{"type":"integer","format":"int32","description":"Required. Minutes of hour of day. Must be from 0 to 59."},"seconds":{"type":"integer","format":"int32","description":"Required. Seconds of minutes of the time. Must normally be from 0 to 59. An\nAPI may allow the value 60 if it allows leap-seconds."},"nanos":{"type":"integer","format":"int32","description":"Required. Fractions of seconds in nanoseconds. Must be from 0 to\n999,999,999."},"utc_offset":{"type":"string","description":"UTC offset. Must be whole seconds, between -18 hours and +18 hours.\nFor example, a UTC offset of -4:00 would be represented as\n{ seconds: -14400 }."},"time_zone":{"$ref":"#/components/schemas/typeTimeZone"}},"description":"Represents civil time (or occasionally physical time).\n\nThis type can represent a civil time in one of a few possible ways:\n\n * When utc_offset is set and time_zone is unset: a civil time on a calendar\n   day with a particular offset from UTC.\n * When time_zone is set and utc_offset is unset: a civil time on a calendar\n   day in a particular time zone.\n * When neither time_zone nor utc_offset is set: a civil time on a calendar\n   day in local time.\n\nThe date is relative to the Proleptic Gregorian Calendar.\n\nIf year is 0, the DateTime is considered not to have a specific year. month\nand day must have valid, non-zero values.\n\nThis type may also be used to represent a physical time if all the date and\ntime fields are set and either case of the `time_offset` oneof is set.\nConsider using `Timestamp` message for physical time instead. If your use\ncase also would like to store the user's timezone, that can be done in\nanother field.\n\nThis type is more flexible than some applications may want. Make sure to\ndocument and validate your application's limitations."},"typeTimeZone":{"type":"object","properties":{"id":{"type":"string","description":"IANA Time Zone Database time zone, e.g. \"America/New_York\"."},"version":{"type":"string","description":"Optional. IANA Time Zone Database version number, e.g. \"2019a\"."}},"description":"Represents a time zone from the\n[IANA Time Zone Database](https://www.iana.org/time-zones)."},"v1List":{"type":"object","properties":{"items":{"type":"array","items":{"$ref":"#/components/schemas/commonV1Value"},"title":"The ordered sequence of values in this list"}},"description":"Represents an ordered collection of values (similar to arrays or lists).\n\nThis message can contain any number of Value elements in a specific order.\nLists are mutable and can grow or shrink during runtime. Elements can be\naccessed by their zero-based index position.\n\nExamples:\n - [1, 2, 3] - list of numbers\n - [\"hello\", \"world\"] - list of strings\n - [true, 42, \"mixed\"] - list with mixed types\n - [[1, 2], [3, 4]] - nested lists"},"commonV1Value":{"type":"object","properties":{"null_value":{"type":"string","title":"Represents the absence of a value (None/null/undefined)"},"bool_value":{"type":"boolean","title":"Boolean true/false value"},"number":{"$ref":"#/components/schemas/v1Number"},"text":{"type":"string","title":"UTF-8 encoded text string"},"date":{"$ref":"#/components/schemas/typeDate"},"timeofday":{"$ref":"#/components/schemas/typeTimeOfDay"},"datetime":{"$ref":"#/components/schemas/typeDateTime"},"time_zone":{"$ref":"#/components/schemas/typeTimeZone"},"duration":{"type":"string","title":"Signed duration representing a span of time"},"list":{"$ref":"#/components/schemas/v1List"},"dictionary":{"$ref":"#/components/schemas/v1Dictionary"},"file":{"$ref":"#/components/schemas/v1FileValue"},"table":{"$ref":"#/components/schemas/v1TableValue"},"set":{"$ref":"#/components/schemas/v1Set"},"text_value":{"$ref":"#/components/schemas/v1TextValue"},"list_value":{"$ref":"#/components/schemas/commonv1ListValue"},"set_value":{"$ref":"#/components/schemas/v1SetValue"},"dictionary_value":{"$ref":"#/components/schemas/v1DictionaryValue"}},"description":"Represents a runtime value that can be produced by the Jarvis interpreter.\n\nThis message provides a type-safe way to serialize and transmit values between\nthe Jarvis interpreter and other services via gRPC. It supports all the basic\ndata types that can be represented in the Jarvis language runtime.\n\nThe oneof structure ensures that exactly one value type is set at a time,\nproviding both type safety and efficient serialization."},"v1Dictionary":{"type":"object","properties":{"entries":{"type":"array","items":{"$ref":"#/components/schemas/v1DictionaryEntry"},"title":"The key-value pairs stored in this dictionary"}},"description":"Represents a key-value mapping (similar to hash maps or dictionaries).\n\nThis message stores associations between keys and values, where keys must be\nhashable types (null, bool, Number, string, Date, TimeOfDay, DateTime, TimeZone). Keys are\nunique within a dictionary - duplicate keys will overwrite previous values.\n\nThe dictionary maintains insertion order for consistent iteration behavior.\n\nExamples:\n - {\"name\": \"John\", \"age\": 30} - string keys with mixed values\n - {1: \"one\", 2: \"two\"} - number keys with string values\n - {\"nested\": {\"inner\": \"value\"}} - nested dictionaries"},"v1DictionaryEntry":{"type":"object","properties":{"key":{"$ref":"#/components/schemas/v1HashableValue"},"value":{"$ref":"#/components/schemas/commonV1Value"}},"description":"Represents a single key-value pair within a Dictionary.\n\nBoth key and value can be any Value type, though keys should be\nhashable types for proper dictionary behavior. Non-hashable keys\n(like lists or dictionaries) may cause runtime errors."},"v1HashableValue":{"type":"object","properties":{"bool_value":{"type":"boolean","title":"Boolean true/false value"},"number":{"$ref":"#/components/schemas/v1Number"},"text":{"type":"string","title":"UTF-8 encoded text string"},"date":{"$ref":"#/components/schemas/typeDate"},"timeofday":{"$ref":"#/components/schemas/typeTimeOfDay"},"datetime":{"$ref":"#/components/schemas/typeDateTime"},"duration":{"type":"string","title":"Signed duration representing a span of time"},"text_value":{"$ref":"#/components/schemas/v1TextValue"}},"description":"Represents a hashable value that can be used as a dictionary key.\n\nThis message contains only the hashable types from the Value message,\ncorresponding to Python's hashable types. These types can be safely\nused as keys in maps and dictionaries.\n\nHashable types include: bool, Number, string, Date, TimeOfDay, DateTime\nand Duration."},"v1TextValue":{"type":"object","properties":{"remote":{"type":"string","title":"Reference to remote text content via URL or file path"},"inline":{"type":"string","title":"Text content embedded directly in the message"}},"description":"Represents a text value that can be either stored inline or referenced remotely.\n\nThis message provides flexibility for handling text strings in the Jarvis interpreter:\n- Small strings can be embedded directly using the inline option\n- Large strings can be referenced by URL using the remote option\n- The choice depends on string size, network constraints, and access patterns"},"v1FileValue":{"type":"object","properties":{"remote":{"type":"string","title":"Reference to a remote file via URL or file path"},"inline":{"$ref":"#/components/schemas/v1File"}},"description":"Represents a file value that can be either stored inline or referenced remotely.\n\nThis message provides flexibility for handling files in the Jarvis interpreter:\n- Small files can be embedded directly using the inline option\n- Large files can be referenced by URL/path using the remote option\n- The choice depends on file size, network constraints, and access patterns"},"v1File":{"type":"object","properties":{"content":{"type":"string","format":"byte","title":"The raw binary content of the file"},"name":{"type":"string","title":"The name of the file, including extension if applicable"}},"description":"Represents a file with its name and binary content.\n\nThis message contains the complete file data including both metadata\n(filename) and the actual file content as raw bytes. It's used for\nembedding files directly within messages when the file size is\nmanageable and immediate access is required.\n\nExamples:\n - Configuration files\n - Small text or binary files\n - Generated reports or documents\n - Temporary files created during execution\n"},"v1TableValue":{"type":"object","properties":{"remote":{"type":"string","title":"Reference to a remote table via URL or file path (feather-v2 format)"},"inline":{"$ref":"#/components/schemas/v1Table"}},"description":"Represents a table value that can be either stored inline or referenced remotely."},"v1Table":{"type":"object","properties":{"data":{"type":"string","format":"byte","title":"The table data serialized in feather-v2 format"}},"description":"Represents a table with data in feather-v2 format.\n\nThis message contains the complete table data serialized using the\nfeather-v2 format, which provides efficient columnar storage and\nfast serialization/deserialization for tabular data."},"v1Set":{"type":"object","properties":{"items":{"type":"array","items":{"$ref":"#/components/schemas/v1HashableValue"},"title":"The unique elements stored in this set\nAll elements must be hashable types"}},"description":"Represents an unordered collection of unique values.\n\nThis message stores a collection of unique elements, where duplicate values\nare automatically removed. Only hashable types can be stored in sets.\nSets are useful for membership testing, removing duplicates, and mathematical\nset operations like union, intersection, and difference.\n\nThe set does not maintain insertion order - elements may appear in any order\nduring iteration.\n\nExamples:\n - {1, 2, 3} - set of numbers\n - {\"apple\", \"banana\", \"cherry\"} - set of strings\n - {true, false} - set of booleans\n - {1, \"hello\", true} - set with mixed hashable types"},"commonv1ListValue":{"type":"object","properties":{"remote":{"type":"string","title":"Reference to remote list data via URL or file path"},"inline":{"$ref":"#/components/schemas/v1List"}},"description":"Represents a list value that can be either stored inline or referenced remotely.\n\nThis message provides flexibility for handling large lists:\n- Small lists can be embedded directly using the inline option\n- Large lists can be referenced by URL using the remote option"},"v1SetValue":{"type":"object","properties":{"remote":{"type":"string","title":"Reference to remote set data via URL or file path"},"inline":{"$ref":"#/components/schemas/v1Set"}},"description":"Represents a set value that can be either stored inline or referenced remotely.\n\nThis message provides flexibility for handling large sets:\n- Small sets can be embedded directly using the inline option\n- Large sets can be referenced by URL using the remote option"},"v1DictionaryValue":{"type":"object","properties":{"remote":{"type":"string","title":"Reference to remote dictionary data via URL or file path"},"inline":{"$ref":"#/components/schemas/v1Dictionary"}},"description":"Represents a dictionary value that can be either stored inline or referenced remotely.\n\nThis message provides flexibility for handling large dictionaries:\n- Small dictionaries can be embedded directly using the inline option\n- Large dictionaries can be referenced by URL using the remote option"},"rpcStatus":{"type":"object","properties":{"code":{"type":"integer","format":"int32"},"message":{"type":"string"},"details":{"type":"array","items":{"$ref":"#/components/schemas/protobufAny"}}}},"protobufAny":{"type":"object","properties":{"@type":{"type":"string"}},"additionalProperties":{}}}},"paths":{"/api/v1/organizations/{organization_id}/workspaces/{workspace_id}/workUnits/{work_unit_id}/submissions":{"post":{"summary":"Create Submission","description":"CreateSubmission answers one unit. Acceptance, submission and delivery\nobligation commit atomically; publication and source application are later.\nValidate the unit's immutable answer_form and normalize before writes.\nHuman input is optional, even when the item has an input_form. Validate\nindependently of intermediate input. Alternatively consume the exact\nanswer_draft_etag; do not supply direct values in this mode. Successful\nsubmission clears the draft in either mode. A direct answer does not check\nthe draft token. Serialize with rekey and settlement.\nRequire an authenticated user; derive submitter from trusted context.\nABORTED identifies the existing submission if already answered, even when\nthe repeated request has identical values. Dismissed or withdrawn units\nreturn FAILED_PRECONDITION. Invalid values return INVALID_ARGUMENT.","operationId":"CreateSubmission","responses":{"200":{"description":"A successful response.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/v1Submission"}}}},"default":{"description":"An unexpected error response.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/rpcStatus"}}}}},"parameters":[{"name":"organization_id","in":"path","required":true,"schema":{"type":"string"}},{"name":"workspace_id","in":"path","required":true,"schema":{"type":"string"}},{"name":"work_unit_id","in":"path","required":true,"schema":{"type":"string"}},{"name":"answer_draft_etag","description":"Submit exactly this saved draft. Stale drafts return ABORTED.\nBoth modes clear the draft atomically on success; failed submissions retain it.","in":"query","required":false,"schema":{"type":"string"}}],"requestBody":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/v1Submission"}}},"description":"For a direct answer, only submission.answer is supplied; metadata and name\nare server-derived.\nSupply submission.answer or answer_draft_etag, exactly one. Direct answers\nbypass draft storage and do not require the current draft's etag.","required":true},"tags":["Work Items"]}}}}
```

## Get Submission

> GetSubmission returns the exact unit-scoped final answer, never response\
> history or a bulk aggregate. Submissions cannot be updated or deleted.

```json
{"openapi":"3.0.0","info":{"title":"Kognitos API","version":"1.0.0"},"tags":[{"name":"Work Items","description":"Track work items and work units that need human input."}],"servers":[{"url":"https://app.us-1.kognitos.com"}],"security":[{"BearerAuth":[]}],"components":{"securitySchemes":{"BearerAuth":{"type":"http","scheme":"bearer","description":"Personal Access Token."}},"schemas":{"v1Submission":{"type":"object","properties":{"name":{"type":"string","description":"Full unit-scoped resource name. The identifier is server-generated."},"answer":{"$ref":"#/components/schemas/v1Answer"},"submitter":{"type":"string","title":"Server-derived authenticated actor. An agent acting on a user's behalf is\nattributed to that user; this field does not establish human approval.\nFormat: users/{user_id}","readOnly":true},"descriptor_version":{"type":"string","format":"int64","description":"Version of the kind descriptor used to create the delivery obligation.","readOnly":true},"create_time":{"type":"string","format":"date-time","description":"Time the answer and delivery obligation became durable.","readOnly":true}},"description":"Submission is one immutable final answer to one work-unit occurrence.\n\nA unit accepts at most one submission. Its decision delivery is recorded in\nthe same transaction. Source rejection or delivery failure never replaces it;\na different final answer requires a new source occurrence.","required":["answer"]},"v1Answer":{"type":"object","properties":{"kind":{"type":"string","description":"The registered kind this answer is for, checked against the item on submit."},"values":{"type":"object","additionalProperties":{"$ref":"#/components/schemas/commonv1Value"},"description":"Exact declared field set: unknown keys fail and required omissions fail.\nOptional omission normalizes to None; initial suggestions are never inserted.\nSelection membership and normalization follow the field's InputSpec."}},"description":"Answer is the typed values supplied for the questions in a resolved form.\nEach submission validates against its own unit's source contract.","required":["kind","values"]},"commonv1Value":{"type":"object","properties":{"null_value":{"type":"string","title":"Represents the absence of a value (None/null/undefined)"},"bool_value":{"type":"boolean","title":"Boolean true/false value"},"number":{"$ref":"#/components/schemas/v1Number"},"text":{"type":"string","title":"UTF-8 encoded text string"},"date":{"$ref":"#/components/schemas/typeDate"},"timeofday":{"$ref":"#/components/schemas/typeTimeOfDay"},"datetime":{"$ref":"#/components/schemas/typeDateTime"},"time_zone":{"$ref":"#/components/schemas/typeTimeZone"},"duration":{"type":"string","title":"Signed duration representing a span of time"},"list":{"$ref":"#/components/schemas/v1List"},"dictionary":{"$ref":"#/components/schemas/v1Dictionary"},"file":{"$ref":"#/components/schemas/v1FileValue"},"table":{"$ref":"#/components/schemas/v1TableValue"},"set":{"$ref":"#/components/schemas/v1Set"},"text_value":{"$ref":"#/components/schemas/v1TextValue"},"list_value":{"$ref":"#/components/schemas/commonv1ListValue"},"set_value":{"$ref":"#/components/schemas/v1SetValue"},"dictionary_value":{"$ref":"#/components/schemas/v1DictionaryValue"}},"description":"Represents a runtime value that can be produced by the Jarvis interpreter.\n\nThis message provides a type-safe way to serialize and transmit values between\nthe Jarvis interpreter and other services via gRPC. It supports all the basic\ndata types that can be represented in the Jarvis language runtime.\n\nThe oneof structure ensures that exactly one value type is set at a time,\nproviding both type safety and efficient serialization."},"v1Number":{"type":"object","properties":{"lo":{"type":"integer","format":"int64","description":"Low 32 bits of the 96-bit mantissa."},"mid":{"type":"integer","format":"int64","description":"Middle 32 bits of the 96-bit mantissa."},"hi":{"type":"integer","format":"int64","description":"High 32 bits of the 96-bit mantissa."},"flags":{"type":"integer","format":"int64","description":"Flags word:\n - Bits 16–23: scale (0–28)\n - Bit 31: sign (0 = positive, 1 = negative)\n - Other bits must be zero."}},"description":"A fixed-precision decimal number with up to 28 fractional digits.\n\nThis message represents decimal numbers with exact precision, avoiding\nfloating-point rounding errors. It's particularly useful for financial\ncalculations, measurements, and any scenario where exact decimal\nrepresentation is required.\n\nThe value is calculated as: m / 10^e, where:\n - m is an unsigned 96-bit integer composed of (lo, mid, hi)\n - e is the scale (0–28) stored in flags bits 16–23\n - sign is encoded in flags bit 31 (0 = positive, 1 = negative)\n\nExamples:\n - 123.45 would have m=12345, e=2\n - -0.001 would have m=1, e=3, with sign bit set\n"},"typeDate":{"type":"object","properties":{"year":{"type":"integer","format":"int32","description":"Year of the date. Must be from 1 to 9999, or 0 to specify a date without\na year."},"month":{"type":"integer","format":"int32","description":"Month of a year. Must be from 1 to 12, or 0 to specify a year without a\nmonth and day."},"day":{"type":"integer","format":"int32","description":"Day of a month. Must be from 1 to 31 and valid for the year and month, or 0\nto specify a year by itself or a year and month where the day isn't\nsignificant."}},"description":"* A full date, with non-zero year, month, and day values\n* A month and day value, with a zero year, such as an anniversary\n* A year on its own, with zero month and day values\n* A year and month value, with a zero day, such as a credit card expiration\ndate\n\nRelated types are [google.type.TimeOfDay][google.type.TimeOfDay] and\n`google.protobuf.Timestamp`.","title":"Represents a whole or partial calendar date, such as a birthday. The time of\nday and time zone are either specified elsewhere or are insignificant. The\ndate is relative to the Gregorian Calendar. This can represent one of the\nfollowing:"},"typeTimeOfDay":{"type":"object","properties":{"hours":{"type":"integer","format":"int32","description":"Hours of day in 24 hour format. Should be from 0 to 23. An API may choose\nto allow the value \"24:00:00\" for scenarios like business closing time."},"minutes":{"type":"integer","format":"int32","description":"Minutes of hour of day. Must be from 0 to 59."},"seconds":{"type":"integer","format":"int32","description":"Seconds of minutes of the time. Must normally be from 0 to 59. An API may\nallow the value 60 if it allows leap-seconds."},"nanos":{"type":"integer","format":"int32","description":"Fractions of seconds in nanoseconds. Must be from 0 to 999,999,999."}},"description":"Represents a time of day. The date and time zone are either not significant\nor are specified elsewhere. An API may choose to allow leap seconds. Related\ntypes are [google.type.Date][google.type.Date] and\n`google.protobuf.Timestamp`."},"typeDateTime":{"type":"object","properties":{"year":{"type":"integer","format":"int32","description":"Optional. Year of date. Must be from 1 to 9999, or 0 if specifying a\ndatetime without a year."},"month":{"type":"integer","format":"int32","description":"Required. Month of year. Must be from 1 to 12."},"day":{"type":"integer","format":"int32","description":"Required. Day of month. Must be from 1 to 31 and valid for the year and\nmonth."},"hours":{"type":"integer","format":"int32","description":"Required. Hours of day in 24 hour format. Should be from 0 to 23. An API\nmay choose to allow the value \"24:00:00\" for scenarios like business\nclosing time."},"minutes":{"type":"integer","format":"int32","description":"Required. Minutes of hour of day. Must be from 0 to 59."},"seconds":{"type":"integer","format":"int32","description":"Required. Seconds of minutes of the time. Must normally be from 0 to 59. An\nAPI may allow the value 60 if it allows leap-seconds."},"nanos":{"type":"integer","format":"int32","description":"Required. Fractions of seconds in nanoseconds. Must be from 0 to\n999,999,999."},"utc_offset":{"type":"string","description":"UTC offset. Must be whole seconds, between -18 hours and +18 hours.\nFor example, a UTC offset of -4:00 would be represented as\n{ seconds: -14400 }."},"time_zone":{"$ref":"#/components/schemas/typeTimeZone"}},"description":"Represents civil time (or occasionally physical time).\n\nThis type can represent a civil time in one of a few possible ways:\n\n * When utc_offset is set and time_zone is unset: a civil time on a calendar\n   day with a particular offset from UTC.\n * When time_zone is set and utc_offset is unset: a civil time on a calendar\n   day in a particular time zone.\n * When neither time_zone nor utc_offset is set: a civil time on a calendar\n   day in local time.\n\nThe date is relative to the Proleptic Gregorian Calendar.\n\nIf year is 0, the DateTime is considered not to have a specific year. month\nand day must have valid, non-zero values.\n\nThis type may also be used to represent a physical time if all the date and\ntime fields are set and either case of the `time_offset` oneof is set.\nConsider using `Timestamp` message for physical time instead. If your use\ncase also would like to store the user's timezone, that can be done in\nanother field.\n\nThis type is more flexible than some applications may want. Make sure to\ndocument and validate your application's limitations."},"typeTimeZone":{"type":"object","properties":{"id":{"type":"string","description":"IANA Time Zone Database time zone, e.g. \"America/New_York\"."},"version":{"type":"string","description":"Optional. IANA Time Zone Database version number, e.g. \"2019a\"."}},"description":"Represents a time zone from the\n[IANA Time Zone Database](https://www.iana.org/time-zones)."},"v1List":{"type":"object","properties":{"items":{"type":"array","items":{"$ref":"#/components/schemas/commonV1Value"},"title":"The ordered sequence of values in this list"}},"description":"Represents an ordered collection of values (similar to arrays or lists).\n\nThis message can contain any number of Value elements in a specific order.\nLists are mutable and can grow or shrink during runtime. Elements can be\naccessed by their zero-based index position.\n\nExamples:\n - [1, 2, 3] - list of numbers\n - [\"hello\", \"world\"] - list of strings\n - [true, 42, \"mixed\"] - list with mixed types\n - [[1, 2], [3, 4]] - nested lists"},"commonV1Value":{"type":"object","properties":{"null_value":{"type":"string","title":"Represents the absence of a value (None/null/undefined)"},"bool_value":{"type":"boolean","title":"Boolean true/false value"},"number":{"$ref":"#/components/schemas/v1Number"},"text":{"type":"string","title":"UTF-8 encoded text string"},"date":{"$ref":"#/components/schemas/typeDate"},"timeofday":{"$ref":"#/components/schemas/typeTimeOfDay"},"datetime":{"$ref":"#/components/schemas/typeDateTime"},"time_zone":{"$ref":"#/components/schemas/typeTimeZone"},"duration":{"type":"string","title":"Signed duration representing a span of time"},"list":{"$ref":"#/components/schemas/v1List"},"dictionary":{"$ref":"#/components/schemas/v1Dictionary"},"file":{"$ref":"#/components/schemas/v1FileValue"},"table":{"$ref":"#/components/schemas/v1TableValue"},"set":{"$ref":"#/components/schemas/v1Set"},"text_value":{"$ref":"#/components/schemas/v1TextValue"},"list_value":{"$ref":"#/components/schemas/commonv1ListValue"},"set_value":{"$ref":"#/components/schemas/v1SetValue"},"dictionary_value":{"$ref":"#/components/schemas/v1DictionaryValue"}},"description":"Represents a runtime value that can be produced by the Jarvis interpreter.\n\nThis message provides a type-safe way to serialize and transmit values between\nthe Jarvis interpreter and other services via gRPC. It supports all the basic\ndata types that can be represented in the Jarvis language runtime.\n\nThe oneof structure ensures that exactly one value type is set at a time,\nproviding both type safety and efficient serialization."},"v1Dictionary":{"type":"object","properties":{"entries":{"type":"array","items":{"$ref":"#/components/schemas/v1DictionaryEntry"},"title":"The key-value pairs stored in this dictionary"}},"description":"Represents a key-value mapping (similar to hash maps or dictionaries).\n\nThis message stores associations between keys and values, where keys must be\nhashable types (null, bool, Number, string, Date, TimeOfDay, DateTime, TimeZone). Keys are\nunique within a dictionary - duplicate keys will overwrite previous values.\n\nThe dictionary maintains insertion order for consistent iteration behavior.\n\nExamples:\n - {\"name\": \"John\", \"age\": 30} - string keys with mixed values\n - {1: \"one\", 2: \"two\"} - number keys with string values\n - {\"nested\": {\"inner\": \"value\"}} - nested dictionaries"},"v1DictionaryEntry":{"type":"object","properties":{"key":{"$ref":"#/components/schemas/v1HashableValue"},"value":{"$ref":"#/components/schemas/commonV1Value"}},"description":"Represents a single key-value pair within a Dictionary.\n\nBoth key and value can be any Value type, though keys should be\nhashable types for proper dictionary behavior. Non-hashable keys\n(like lists or dictionaries) may cause runtime errors."},"v1HashableValue":{"type":"object","properties":{"bool_value":{"type":"boolean","title":"Boolean true/false value"},"number":{"$ref":"#/components/schemas/v1Number"},"text":{"type":"string","title":"UTF-8 encoded text string"},"date":{"$ref":"#/components/schemas/typeDate"},"timeofday":{"$ref":"#/components/schemas/typeTimeOfDay"},"datetime":{"$ref":"#/components/schemas/typeDateTime"},"duration":{"type":"string","title":"Signed duration representing a span of time"},"text_value":{"$ref":"#/components/schemas/v1TextValue"}},"description":"Represents a hashable value that can be used as a dictionary key.\n\nThis message contains only the hashable types from the Value message,\ncorresponding to Python's hashable types. These types can be safely\nused as keys in maps and dictionaries.\n\nHashable types include: bool, Number, string, Date, TimeOfDay, DateTime\nand Duration."},"v1TextValue":{"type":"object","properties":{"remote":{"type":"string","title":"Reference to remote text content via URL or file path"},"inline":{"type":"string","title":"Text content embedded directly in the message"}},"description":"Represents a text value that can be either stored inline or referenced remotely.\n\nThis message provides flexibility for handling text strings in the Jarvis interpreter:\n- Small strings can be embedded directly using the inline option\n- Large strings can be referenced by URL using the remote option\n- The choice depends on string size, network constraints, and access patterns"},"v1FileValue":{"type":"object","properties":{"remote":{"type":"string","title":"Reference to a remote file via URL or file path"},"inline":{"$ref":"#/components/schemas/v1File"}},"description":"Represents a file value that can be either stored inline or referenced remotely.\n\nThis message provides flexibility for handling files in the Jarvis interpreter:\n- Small files can be embedded directly using the inline option\n- Large files can be referenced by URL/path using the remote option\n- The choice depends on file size, network constraints, and access patterns"},"v1File":{"type":"object","properties":{"content":{"type":"string","format":"byte","title":"The raw binary content of the file"},"name":{"type":"string","title":"The name of the file, including extension if applicable"}},"description":"Represents a file with its name and binary content.\n\nThis message contains the complete file data including both metadata\n(filename) and the actual file content as raw bytes. It's used for\nembedding files directly within messages when the file size is\nmanageable and immediate access is required.\n\nExamples:\n - Configuration files\n - Small text or binary files\n - Generated reports or documents\n - Temporary files created during execution\n"},"v1TableValue":{"type":"object","properties":{"remote":{"type":"string","title":"Reference to a remote table via URL or file path (feather-v2 format)"},"inline":{"$ref":"#/components/schemas/v1Table"}},"description":"Represents a table value that can be either stored inline or referenced remotely."},"v1Table":{"type":"object","properties":{"data":{"type":"string","format":"byte","title":"The table data serialized in feather-v2 format"}},"description":"Represents a table with data in feather-v2 format.\n\nThis message contains the complete table data serialized using the\nfeather-v2 format, which provides efficient columnar storage and\nfast serialization/deserialization for tabular data."},"v1Set":{"type":"object","properties":{"items":{"type":"array","items":{"$ref":"#/components/schemas/v1HashableValue"},"title":"The unique elements stored in this set\nAll elements must be hashable types"}},"description":"Represents an unordered collection of unique values.\n\nThis message stores a collection of unique elements, where duplicate values\nare automatically removed. Only hashable types can be stored in sets.\nSets are useful for membership testing, removing duplicates, and mathematical\nset operations like union, intersection, and difference.\n\nThe set does not maintain insertion order - elements may appear in any order\nduring iteration.\n\nExamples:\n - {1, 2, 3} - set of numbers\n - {\"apple\", \"banana\", \"cherry\"} - set of strings\n - {true, false} - set of booleans\n - {1, \"hello\", true} - set with mixed hashable types"},"commonv1ListValue":{"type":"object","properties":{"remote":{"type":"string","title":"Reference to remote list data via URL or file path"},"inline":{"$ref":"#/components/schemas/v1List"}},"description":"Represents a list value that can be either stored inline or referenced remotely.\n\nThis message provides flexibility for handling large lists:\n- Small lists can be embedded directly using the inline option\n- Large lists can be referenced by URL using the remote option"},"v1SetValue":{"type":"object","properties":{"remote":{"type":"string","title":"Reference to remote set data via URL or file path"},"inline":{"$ref":"#/components/schemas/v1Set"}},"description":"Represents a set value that can be either stored inline or referenced remotely.\n\nThis message provides flexibility for handling large sets:\n- Small sets can be embedded directly using the inline option\n- Large sets can be referenced by URL using the remote option"},"v1DictionaryValue":{"type":"object","properties":{"remote":{"type":"string","title":"Reference to remote dictionary data via URL or file path"},"inline":{"$ref":"#/components/schemas/v1Dictionary"}},"description":"Represents a dictionary value that can be either stored inline or referenced remotely.\n\nThis message provides flexibility for handling large dictionaries:\n- Small dictionaries can be embedded directly using the inline option\n- Large dictionaries can be referenced by URL using the remote option"},"rpcStatus":{"type":"object","properties":{"code":{"type":"integer","format":"int32"},"message":{"type":"string"},"details":{"type":"array","items":{"$ref":"#/components/schemas/protobufAny"}}}},"protobufAny":{"type":"object","properties":{"@type":{"type":"string"}},"additionalProperties":{}}}},"paths":{"/api/v1/organizations/{organization_id}/workspaces/{workspace_id}/workUnits/{work_unit_id}/submissions/{submission_id}":{"get":{"summary":"Get Submission","description":"GetSubmission returns the exact unit-scoped final answer, never response\nhistory or a bulk aggregate. Submissions cannot be updated or deleted.","operationId":"GetSubmission","responses":{"200":{"description":"A successful response.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/v1Submission"}}}},"default":{"description":"An unexpected error response.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/rpcStatus"}}}}},"parameters":[{"name":"organization_id","in":"path","required":true,"schema":{"type":"string"}},{"name":"workspace_id","in":"path","required":true,"schema":{"type":"string"}},{"name":"work_unit_id","in":"path","required":true,"schema":{"type":"string"}},{"name":"submission_id","in":"path","required":true,"schema":{"type":"string"}}],"tags":["Work Items"]}}}}
```

## Accept Work Unit Input

> AcceptWorkUnitInput explicitly accepts the current complete human response.\
> Validate and normalize against the unit's resolved input.form; missing\
> required fields fail. Record the authenticated actor and time, change etag\
> and set PROCESSING. Revoke acceptance before editing again. This creates no\
> final submission.\
> Requires a matching etag; stale etags return ABORTED. Settled units or an absent\
> item input\_form return FAILED\_PRECONDITION. Invalid values return INVALID\_ARGUMENT.\
> Attribution alone does not establish that the caller is a human.

```json
{"openapi":"3.0.0","info":{"title":"Kognitos API","version":"1.0.0"},"tags":[{"name":"Work Items","description":"Track work items and work units that need human input."}],"servers":[{"url":"https://app.us-1.kognitos.com"}],"security":[{"BearerAuth":[]}],"components":{"securitySchemes":{"BearerAuth":{"type":"http","scheme":"bearer","description":"Personal Access Token."}},"schemas":{"v1WorkUnit":{"type":"object","properties":{"name":{"type":"string","title":"The stable workspace-scoped resource name of the work unit.\nFormat: organizations/{organization_id}/workspaces/{workspace_id}/workUnits/{work_unit_id}"},"work_item":{"type":"string","description":"Current grouping membership in the same workspace. Rekey may change this reference without changing\nthe unit's name. Empty when the occurrence has no work item.","readOnly":true},"source_ref":{"type":"string","description":"The source's own id for this unit, combined with occurrence_id to identify one request\nfor attention within an organization, workspace and kind across history.\n\nThe source's shape rather than ours. Decisions also carry occurrence_id so a later request\nabout the same thing cannot consume an earlier answer. Not a label: no\nkind declares it and no grouping configuration names it."},"correlation_id":{"type":"string","description":"Source-owned correlation shared by related requests within this organization,\nworkspace and kind. Empty when none was supplied on first admission.\nImmutable; returned by Get and List and filterable through ListWorkUnits.\nIndependent of work-item grouping, occurrence identity and decision routing.","readOnly":true},"kind":{"type":"string","description":"The registered kind of work, as an opaque dotted id. See\nWorkItem.kind.","readOnly":true},"labels":{"type":"object","additionalProperties":{"type":"string"},"description":"The facts the source stated about this unit. The subset the workspace\ngroups on became its item's agg_labels, where a key the workspace groups\non that this unit does not carry became a null.","readOnly":true},"summary":{"type":"string","description":"One line about this unit in business language, as its source put it. The\nquestion, when this is the unit that materialised the item.\n\nImmutable for this occurrence, including before acceptance.","readOnly":true},"detail":{"type":"string","description":"Additional source-authored text describing this occurrence. Empty when omitted.\nImmutable for the occurrence; returned by GetWorkUnit and ListWorkUnits.","readOnly":true},"identifying_details":{"type":"array","items":{"$ref":"#/components/schemas/v1IdentifyingDetail"},"description":"Ordered identifying facts, immutable for this occurrence. Entries with a\nblank label or value are omitted. Clients fall back to summary, then the\nkind display name when empty; detail is supplementary context, not a heading.","readOnly":true},"evidence":{"type":"object","additionalProperties":{"$ref":"#/components/schemas/commonv1Value"},"description":"What a person reads to decide: the records and facts behind this unit,\nnamed and typed, so the platform renders it and the source ships no\nrendering (R6).\n\nImmutable for this occurrence. Changed decision context requires withdrawal\nand a new occurrence. Re-reports never overwrite this evidence.\n\nReturned by both GetWorkUnit and ListWorkUnits.","readOnly":true},"status":{"$ref":"#/components/schemas/v1WorkUnitStatus"},"delivery":{"$ref":"#/components/schemas/v1EffectDelivery"},"settle_time":{"type":"string","format":"date-time","description":"When attention ended for this occurrence: answer, dismissal or withdrawal.","readOnly":true},"create_time":{"type":"string","format":"date-time","description":"The time this unit was first seen.","readOnly":true},"update_time":{"type":"string","format":"date-time","description":"The time this unit last changed, including by a source's re-report.","readOnly":true},"occurrence_id":{"type":"string","description":"The source's immutable identifier for this particular request for attention.\nRe-reports reuse it; a new request uses a new one even for the same source_ref.","readOnly":true},"previous_delivery":{"type":"string","description":"Earlier delivery whose rejection or later execution raised this question.\nEmpty for ordinary arrivals. Exposes follow-up provenance to the surface.","readOnly":true},"submission":{"type":"string","description":"The sole accepted final submission, or empty while no answer is recorded.","readOnly":true},"answer_form":{"$ref":"#/components/schemas/v1FormSpec"},"input":{"$ref":"#/components/schemas/v1InputContext"},"answer_draft":{"$ref":"#/components/schemas/v1AnswerDraft"},"revision":{"type":"string","format":"int64","description":"Monotonically increasing version of this resource's mutable state,\nincluding resolved input and embedded delivery. Compare only versions of\nthe same resource. Independent of mutation etags.","readOnly":true}},"description":"WorkUnit is one real-world thing needing attention, as its source reported\nit: a run that failed, a record that was flagged, an automation waiting on a\nvalue.\n\nThe workspace is the resource parent. The name remains stable across rekey;\nwork_item records grouping membership rather than resource parentage.\nA source reports occurrences without naming an item or asserting grouping."},"v1IdentifyingDetail":{"type":"object","properties":{"label":{"type":"string","description":"Business-facing label, for example \"Invoice\"."},"value":{"type":"string","description":"Nonempty display fallback, for example \"INV-1042\" or \"invoice.pdf\"."},"evidence_ref":{"type":"string","description":"Optional exact top-level key in the same work unit's evidence map.\nThis is neither a resource URI nor an expression. Readers use value when\nabsent, unresolved or unavailable; an invalid reference never rejects work."}},"description":"A source-authored identifying fact for a unit's compact heading.\nDisplayed in source order, with optional access to frozen evidence."},"commonv1Value":{"type":"object","properties":{"null_value":{"type":"string","title":"Represents the absence of a value (None/null/undefined)"},"bool_value":{"type":"boolean","title":"Boolean true/false value"},"number":{"$ref":"#/components/schemas/v1Number"},"text":{"type":"string","title":"UTF-8 encoded text string"},"date":{"$ref":"#/components/schemas/typeDate"},"timeofday":{"$ref":"#/components/schemas/typeTimeOfDay"},"datetime":{"$ref":"#/components/schemas/typeDateTime"},"time_zone":{"$ref":"#/components/schemas/typeTimeZone"},"duration":{"type":"string","title":"Signed duration representing a span of time"},"list":{"$ref":"#/components/schemas/v1List"},"dictionary":{"$ref":"#/components/schemas/v1Dictionary"},"file":{"$ref":"#/components/schemas/v1FileValue"},"table":{"$ref":"#/components/schemas/v1TableValue"},"set":{"$ref":"#/components/schemas/v1Set"},"text_value":{"$ref":"#/components/schemas/v1TextValue"},"list_value":{"$ref":"#/components/schemas/commonv1ListValue"},"set_value":{"$ref":"#/components/schemas/v1SetValue"},"dictionary_value":{"$ref":"#/components/schemas/v1DictionaryValue"}},"description":"Represents a runtime value that can be produced by the Jarvis interpreter.\n\nThis message provides a type-safe way to serialize and transmit values between\nthe Jarvis interpreter and other services via gRPC. It supports all the basic\ndata types that can be represented in the Jarvis language runtime.\n\nThe oneof structure ensures that exactly one value type is set at a time,\nproviding both type safety and efficient serialization."},"v1Number":{"type":"object","properties":{"lo":{"type":"integer","format":"int64","description":"Low 32 bits of the 96-bit mantissa."},"mid":{"type":"integer","format":"int64","description":"Middle 32 bits of the 96-bit mantissa."},"hi":{"type":"integer","format":"int64","description":"High 32 bits of the 96-bit mantissa."},"flags":{"type":"integer","format":"int64","description":"Flags word:\n - Bits 16–23: scale (0–28)\n - Bit 31: sign (0 = positive, 1 = negative)\n - Other bits must be zero."}},"description":"A fixed-precision decimal number with up to 28 fractional digits.\n\nThis message represents decimal numbers with exact precision, avoiding\nfloating-point rounding errors. It's particularly useful for financial\ncalculations, measurements, and any scenario where exact decimal\nrepresentation is required.\n\nThe value is calculated as: m / 10^e, where:\n - m is an unsigned 96-bit integer composed of (lo, mid, hi)\n - e is the scale (0–28) stored in flags bits 16–23\n - sign is encoded in flags bit 31 (0 = positive, 1 = negative)\n\nExamples:\n - 123.45 would have m=12345, e=2\n - -0.001 would have m=1, e=3, with sign bit set\n"},"typeDate":{"type":"object","properties":{"year":{"type":"integer","format":"int32","description":"Year of the date. Must be from 1 to 9999, or 0 to specify a date without\na year."},"month":{"type":"integer","format":"int32","description":"Month of a year. Must be from 1 to 12, or 0 to specify a year without a\nmonth and day."},"day":{"type":"integer","format":"int32","description":"Day of a month. Must be from 1 to 31 and valid for the year and month, or 0\nto specify a year by itself or a year and month where the day isn't\nsignificant."}},"description":"* A full date, with non-zero year, month, and day values\n* A month and day value, with a zero year, such as an anniversary\n* A year on its own, with zero month and day values\n* A year and month value, with a zero day, such as a credit card expiration\ndate\n\nRelated types are [google.type.TimeOfDay][google.type.TimeOfDay] and\n`google.protobuf.Timestamp`.","title":"Represents a whole or partial calendar date, such as a birthday. The time of\nday and time zone are either specified elsewhere or are insignificant. The\ndate is relative to the Gregorian Calendar. This can represent one of the\nfollowing:"},"typeTimeOfDay":{"type":"object","properties":{"hours":{"type":"integer","format":"int32","description":"Hours of day in 24 hour format. Should be from 0 to 23. An API may choose\nto allow the value \"24:00:00\" for scenarios like business closing time."},"minutes":{"type":"integer","format":"int32","description":"Minutes of hour of day. Must be from 0 to 59."},"seconds":{"type":"integer","format":"int32","description":"Seconds of minutes of the time. Must normally be from 0 to 59. An API may\nallow the value 60 if it allows leap-seconds."},"nanos":{"type":"integer","format":"int32","description":"Fractions of seconds in nanoseconds. Must be from 0 to 999,999,999."}},"description":"Represents a time of day. The date and time zone are either not significant\nor are specified elsewhere. An API may choose to allow leap seconds. Related\ntypes are [google.type.Date][google.type.Date] and\n`google.protobuf.Timestamp`."},"typeDateTime":{"type":"object","properties":{"year":{"type":"integer","format":"int32","description":"Optional. Year of date. Must be from 1 to 9999, or 0 if specifying a\ndatetime without a year."},"month":{"type":"integer","format":"int32","description":"Required. Month of year. Must be from 1 to 12."},"day":{"type":"integer","format":"int32","description":"Required. Day of month. Must be from 1 to 31 and valid for the year and\nmonth."},"hours":{"type":"integer","format":"int32","description":"Required. Hours of day in 24 hour format. Should be from 0 to 23. An API\nmay choose to allow the value \"24:00:00\" for scenarios like business\nclosing time."},"minutes":{"type":"integer","format":"int32","description":"Required. Minutes of hour of day. Must be from 0 to 59."},"seconds":{"type":"integer","format":"int32","description":"Required. Seconds of minutes of the time. Must normally be from 0 to 59. An\nAPI may allow the value 60 if it allows leap-seconds."},"nanos":{"type":"integer","format":"int32","description":"Required. Fractions of seconds in nanoseconds. Must be from 0 to\n999,999,999."},"utc_offset":{"type":"string","description":"UTC offset. Must be whole seconds, between -18 hours and +18 hours.\nFor example, a UTC offset of -4:00 would be represented as\n{ seconds: -14400 }."},"time_zone":{"$ref":"#/components/schemas/typeTimeZone"}},"description":"Represents civil time (or occasionally physical time).\n\nThis type can represent a civil time in one of a few possible ways:\n\n * When utc_offset is set and time_zone is unset: a civil time on a calendar\n   day with a particular offset from UTC.\n * When time_zone is set and utc_offset is unset: a civil time on a calendar\n   day in a particular time zone.\n * When neither time_zone nor utc_offset is set: a civil time on a calendar\n   day in local time.\n\nThe date is relative to the Proleptic Gregorian Calendar.\n\nIf year is 0, the DateTime is considered not to have a specific year. month\nand day must have valid, non-zero values.\n\nThis type may also be used to represent a physical time if all the date and\ntime fields are set and either case of the `time_offset` oneof is set.\nConsider using `Timestamp` message for physical time instead. If your use\ncase also would like to store the user's timezone, that can be done in\nanother field.\n\nThis type is more flexible than some applications may want. Make sure to\ndocument and validate your application's limitations."},"typeTimeZone":{"type":"object","properties":{"id":{"type":"string","description":"IANA Time Zone Database time zone, e.g. \"America/New_York\"."},"version":{"type":"string","description":"Optional. IANA Time Zone Database version number, e.g. \"2019a\"."}},"description":"Represents a time zone from the\n[IANA Time Zone Database](https://www.iana.org/time-zones)."},"v1List":{"type":"object","properties":{"items":{"type":"array","items":{"$ref":"#/components/schemas/commonV1Value"},"title":"The ordered sequence of values in this list"}},"description":"Represents an ordered collection of values (similar to arrays or lists).\n\nThis message can contain any number of Value elements in a specific order.\nLists are mutable and can grow or shrink during runtime. Elements can be\naccessed by their zero-based index position.\n\nExamples:\n - [1, 2, 3] - list of numbers\n - [\"hello\", \"world\"] - list of strings\n - [true, 42, \"mixed\"] - list with mixed types\n - [[1, 2], [3, 4]] - nested lists"},"commonV1Value":{"type":"object","properties":{"null_value":{"type":"string","title":"Represents the absence of a value (None/null/undefined)"},"bool_value":{"type":"boolean","title":"Boolean true/false value"},"number":{"$ref":"#/components/schemas/v1Number"},"text":{"type":"string","title":"UTF-8 encoded text string"},"date":{"$ref":"#/components/schemas/typeDate"},"timeofday":{"$ref":"#/components/schemas/typeTimeOfDay"},"datetime":{"$ref":"#/components/schemas/typeDateTime"},"time_zone":{"$ref":"#/components/schemas/typeTimeZone"},"duration":{"type":"string","title":"Signed duration representing a span of time"},"list":{"$ref":"#/components/schemas/v1List"},"dictionary":{"$ref":"#/components/schemas/v1Dictionary"},"file":{"$ref":"#/components/schemas/v1FileValue"},"table":{"$ref":"#/components/schemas/v1TableValue"},"set":{"$ref":"#/components/schemas/v1Set"},"text_value":{"$ref":"#/components/schemas/v1TextValue"},"list_value":{"$ref":"#/components/schemas/commonv1ListValue"},"set_value":{"$ref":"#/components/schemas/v1SetValue"},"dictionary_value":{"$ref":"#/components/schemas/v1DictionaryValue"}},"description":"Represents a runtime value that can be produced by the Jarvis interpreter.\n\nThis message provides a type-safe way to serialize and transmit values between\nthe Jarvis interpreter and other services via gRPC. It supports all the basic\ndata types that can be represented in the Jarvis language runtime.\n\nThe oneof structure ensures that exactly one value type is set at a time,\nproviding both type safety and efficient serialization."},"v1Dictionary":{"type":"object","properties":{"entries":{"type":"array","items":{"$ref":"#/components/schemas/v1DictionaryEntry"},"title":"The key-value pairs stored in this dictionary"}},"description":"Represents a key-value mapping (similar to hash maps or dictionaries).\n\nThis message stores associations between keys and values, where keys must be\nhashable types (null, bool, Number, string, Date, TimeOfDay, DateTime, TimeZone). Keys are\nunique within a dictionary - duplicate keys will overwrite previous values.\n\nThe dictionary maintains insertion order for consistent iteration behavior.\n\nExamples:\n - {\"name\": \"John\", \"age\": 30} - string keys with mixed values\n - {1: \"one\", 2: \"two\"} - number keys with string values\n - {\"nested\": {\"inner\": \"value\"}} - nested dictionaries"},"v1DictionaryEntry":{"type":"object","properties":{"key":{"$ref":"#/components/schemas/v1HashableValue"},"value":{"$ref":"#/components/schemas/commonV1Value"}},"description":"Represents a single key-value pair within a Dictionary.\n\nBoth key and value can be any Value type, though keys should be\nhashable types for proper dictionary behavior. Non-hashable keys\n(like lists or dictionaries) may cause runtime errors."},"v1HashableValue":{"type":"object","properties":{"bool_value":{"type":"boolean","title":"Boolean true/false value"},"number":{"$ref":"#/components/schemas/v1Number"},"text":{"type":"string","title":"UTF-8 encoded text string"},"date":{"$ref":"#/components/schemas/typeDate"},"timeofday":{"$ref":"#/components/schemas/typeTimeOfDay"},"datetime":{"$ref":"#/components/schemas/typeDateTime"},"duration":{"type":"string","title":"Signed duration representing a span of time"},"text_value":{"$ref":"#/components/schemas/v1TextValue"}},"description":"Represents a hashable value that can be used as a dictionary key.\n\nThis message contains only the hashable types from the Value message,\ncorresponding to Python's hashable types. These types can be safely\nused as keys in maps and dictionaries.\n\nHashable types include: bool, Number, string, Date, TimeOfDay, DateTime\nand Duration."},"v1TextValue":{"type":"object","properties":{"remote":{"type":"string","title":"Reference to remote text content via URL or file path"},"inline":{"type":"string","title":"Text content embedded directly in the message"}},"description":"Represents a text value that can be either stored inline or referenced remotely.\n\nThis message provides flexibility for handling text strings in the Jarvis interpreter:\n- Small strings can be embedded directly using the inline option\n- Large strings can be referenced by URL using the remote option\n- The choice depends on string size, network constraints, and access patterns"},"v1FileValue":{"type":"object","properties":{"remote":{"type":"string","title":"Reference to a remote file via URL or file path"},"inline":{"$ref":"#/components/schemas/v1File"}},"description":"Represents a file value that can be either stored inline or referenced remotely.\n\nThis message provides flexibility for handling files in the Jarvis interpreter:\n- Small files can be embedded directly using the inline option\n- Large files can be referenced by URL/path using the remote option\n- The choice depends on file size, network constraints, and access patterns"},"v1File":{"type":"object","properties":{"content":{"type":"string","format":"byte","title":"The raw binary content of the file"},"name":{"type":"string","title":"The name of the file, including extension if applicable"}},"description":"Represents a file with its name and binary content.\n\nThis message contains the complete file data including both metadata\n(filename) and the actual file content as raw bytes. It's used for\nembedding files directly within messages when the file size is\nmanageable and immediate access is required.\n\nExamples:\n - Configuration files\n - Small text or binary files\n - Generated reports or documents\n - Temporary files created during execution\n"},"v1TableValue":{"type":"object","properties":{"remote":{"type":"string","title":"Reference to a remote table via URL or file path (feather-v2 format)"},"inline":{"$ref":"#/components/schemas/v1Table"}},"description":"Represents a table value that can be either stored inline or referenced remotely."},"v1Table":{"type":"object","properties":{"data":{"type":"string","format":"byte","title":"The table data serialized in feather-v2 format"}},"description":"Represents a table with data in feather-v2 format.\n\nThis message contains the complete table data serialized using the\nfeather-v2 format, which provides efficient columnar storage and\nfast serialization/deserialization for tabular data."},"v1Set":{"type":"object","properties":{"items":{"type":"array","items":{"$ref":"#/components/schemas/v1HashableValue"},"title":"The unique elements stored in this set\nAll elements must be hashable types"}},"description":"Represents an unordered collection of unique values.\n\nThis message stores a collection of unique elements, where duplicate values\nare automatically removed. Only hashable types can be stored in sets.\nSets are useful for membership testing, removing duplicates, and mathematical\nset operations like union, intersection, and difference.\n\nThe set does not maintain insertion order - elements may appear in any order\nduring iteration.\n\nExamples:\n - {1, 2, 3} - set of numbers\n - {\"apple\", \"banana\", \"cherry\"} - set of strings\n - {true, false} - set of booleans\n - {1, \"hello\", true} - set with mixed hashable types"},"commonv1ListValue":{"type":"object","properties":{"remote":{"type":"string","title":"Reference to remote list data via URL or file path"},"inline":{"$ref":"#/components/schemas/v1List"}},"description":"Represents a list value that can be either stored inline or referenced remotely.\n\nThis message provides flexibility for handling large lists:\n- Small lists can be embedded directly using the inline option\n- Large lists can be referenced by URL using the remote option"},"v1SetValue":{"type":"object","properties":{"remote":{"type":"string","title":"Reference to remote set data via URL or file path"},"inline":{"$ref":"#/components/schemas/v1Set"}},"description":"Represents a set value that can be either stored inline or referenced remotely.\n\nThis message provides flexibility for handling large sets:\n- Small sets can be embedded directly using the inline option\n- Large sets can be referenced by URL using the remote option"},"v1DictionaryValue":{"type":"object","properties":{"remote":{"type":"string","title":"Reference to remote dictionary data via URL or file path"},"inline":{"$ref":"#/components/schemas/v1Dictionary"}},"description":"Represents a dictionary value that can be either stored inline or referenced remotely.\n\nThis message provides flexibility for handling large dictionaries:\n- Small dictionaries can be embedded directly using the inline option\n- Large dictionaries can be referenced by URL using the remote option"},"v1WorkUnitStatus":{"type":"string","enum":["WORK_UNIT_STATUS_UNSPECIFIED","WORK_UNIT_STATUS_WAITING_FOR_INPUT","WORK_UNIT_STATUS_ANSWERED","WORK_UNIT_STATUS_DISMISSED","WORK_UNIT_STATUS_WITHDRAWN","WORK_UNIT_STATUS_PROCESSING"],"default":"WORK_UNIT_STATUS_UNSPECIFIED","description":"WorkUnitStatus records attention and final resolution independently of delivery.\n\n - WORK_UNIT_STATUS_UNSPECIFIED: Default value; not returned for an existing resource.\n - WORK_UNIT_STATUS_WAITING_FOR_INPUT: Waiting for intermediate input or a direct final answer: an item input_form\nexists and input is unaccepted, or no input_form exists and the kind does\nnot require preparation. Saving either draft leaves status unchanged.\n - WORK_UNIT_STATUS_ANSWERED: Final submission and its delivery obligation are durable.\n - WORK_UNIT_STATUS_DISMISSED: Locally dismissed by item archival, arrival or rekey into an archived item.\nUnarchive restores it unless the source or operator has withdrawn it.\n - WORK_UNIT_STATUS_WITHDRAWN: Source or operator ended the occurrence without an answer.\n - WORK_UNIT_STATUS_PROCESSING: Analysis or decision preparation is pending; no current human request.\nIncludes work without an input_form whose kind requires preparation, and\nfinal-answer preparation after intermediate input acceptance."},"v1EffectDelivery":{"type":"object","properties":{"name":{"type":"string","description":"Resource name; the final segment is the dispatch_id given to the source."},"work_unit":{"type":"string","description":"The unit whose decision this delivers.","readOnly":true},"submission":{"type":"string","description":"The final submission this delivers; always present.","readOnly":true},"attempt_count":{"type":"integer","format":"int32","description":"Count of publish attempts across automatic and operator retry cycles.","readOnly":true},"publish_time":{"type":"string","format":"date-time","description":"First successful broker acknowledgement. Absent before publication.","readOnly":true},"result_time":{"type":"string","format":"date-time","description":"Time Workbench durably received a terminal source result.","readOnly":true},"outcome":{"$ref":"#/components/schemas/v1DecisionOutcome"},"rejection_reason":{"type":"string","description":"Source rejection reason, present only for REJECTED.","readOnly":true},"confirmation_deadline":{"type":"string","format":"date-time","description":"Fixed at first successful publication. Passing this time without a result\nmeans confirmation overdue, never that delivery or application failed.","readOnly":true},"attention_required_time":{"type":"string","format":"date-time","description":"When automatic retries stopped pending operator attention. A late result\nremains admissible. This is not a terminal source result.","readOnly":true},"last_error":{"type":"string","description":"Business-safe operational diagnostic, distinct from a source rejection.\nNo traceback, internal identifier or resource name; richer detail is logged.","readOnly":true}},"description":"EffectDelivery is the durable obligation to deliver one decision to one unit.\nA source result is independent of publication and of unit settlement."},"v1DecisionOutcome":{"type":"string","enum":["DECISION_OUTCOME_UNSPECIFIED","DECISION_OUTCOME_APPLIED","DECISION_OUTCOME_REJECTED"],"default":"DECISION_OUTCOME_UNSPECIFIED","description":"DecisionOutcome is a source's terminal result for a specific dispatch.\n\n - DECISION_OUTCOME_UNSPECIFIED: Not a terminal result; callers must select an outcome.\n - DECISION_OUTCOME_APPLIED: The requested action was committed or durably scheduled by the source.\nThis does not assert that the downstream workflow succeeded.\n - DECISION_OUTCOME_REJECTED: The source definitively refused the decision. A reason is required."},"v1FormSpec":{"type":"object","properties":{"fields":{"type":"array","items":{"$ref":"#/components/schemas/v1FormField"},"description":"At least one question, with unique nonempty keys. Order is the semantic\nreading sequence, not a prescribed screen layout."}},"description":"A set of typed questions for human input or source answers (R6, R13, R14).\nField types derive the returned record type. The platform selects controls\nand layout; there are no widgets, scripts, URLs, or executable expressions.\nShared human input may reference options in each unit's immutable evidence.\nWorkbench resolves those references into the unit's InputContext before use.\nSource answer forms must already be resolved. Filled values are separate messages.\nSources persist their answer form with the pending invocation for recovery.","required":["fields"]},"v1FormField":{"type":"object","properties":{"key":{"type":"string","description":"Stable record key. Unique within its field set; nonempty."},"label":{"type":"string","description":"Business-facing wording, independent of the programmatic key; nonempty."},"help_text":{"type":"string","description":"Optional guidance displayed with the question."},"value_type":{"$ref":"#/components/schemas/v1ValueType"},"initial_value":{"$ref":"#/components/schemas/commonv1Value"},"text":{"$ref":"#/components/schemas/v1TextConstraints"},"number":{"$ref":"#/components/schemas/v1NumberConstraints"},"input_spec":{"$ref":"#/components/schemas/v1InputSpec"}},"description":"One named question, its answer type and its input behavior.","required":["key","label","value_type"]},"v1ValueType":{"type":"object","properties":{"scalar_type":{"$ref":"#/components/schemas/v1ValueScalarType"},"optional_type":{"$ref":"#/components/schemas/v1ValueOptionalType"},"list_type":{"$ref":"#/components/schemas/v1ValueListType"},"dictionary_type":{"$ref":"#/components/schemas/v1ValueDictionaryType"},"table_type":{"$ref":"#/components/schemas/v1ValueTableType"},"opaque_type":{"$ref":"#/components/schemas/v1ValueOpaqueType"},"any_type":{"$ref":"#/components/schemas/v1ValueAnyType"},"union_type":{"$ref":"#/components/schemas/v1ValueUnionType"},"sensitive_type":{"$ref":"#/components/schemas/v1ValueSensitiveType"},"enum_type":{"$ref":"#/components/schemas/v1ValueEnumType"},"generic_dictionary_type":{"$ref":"#/components/schemas/v1ValueGenericDictionaryType"},"none_type":{"$ref":"#/components/schemas/v1ValueNoneType"}},"title":"Represents a complete value type definition using a discriminated union"},"v1ValueScalarType":{"type":"string","enum":["VALUE_SCALAR_TYPE_UNSPECIFIED","VALUE_SCALAR_TYPE_TEXT","VALUE_SCALAR_TYPE_NUMBER","VALUE_SCALAR_TYPE_BOOLEAN","VALUE_SCALAR_TYPE_DATETIME","VALUE_SCALAR_TYPE_DATE","VALUE_SCALAR_TYPE_TIME","VALUE_SCALAR_TYPE_FILE","VALUE_SCALAR_TYPE_TIMEDELTA"],"default":"VALUE_SCALAR_TYPE_UNSPECIFIED","description":"- VALUE_SCALAR_TYPE_UNSPECIFIED: Unspecified value type\n - VALUE_SCALAR_TYPE_TEXT: A text value type\n - VALUE_SCALAR_TYPE_NUMBER: A number value type\n - VALUE_SCALAR_TYPE_BOOLEAN: A boolean value type\n - VALUE_SCALAR_TYPE_DATETIME: A datetime value type\n - VALUE_SCALAR_TYPE_DATE: A date value type\n - VALUE_SCALAR_TYPE_TIME: A time value type\n - VALUE_SCALAR_TYPE_FILE: A file value type\n - VALUE_SCALAR_TYPE_TIMEDELTA: A timedelta value type","title":"Supported Value Scalar Types"},"v1ValueOptionalType":{"type":"object","properties":{"inner":{"$ref":"#/components/schemas/v1ValueType"}},"title":"Represents a value type that can be optional (nullable)"},"v1ValueListType":{"type":"object","properties":{"inner":{"$ref":"#/components/schemas/v1ValueType"}},"title":"Represents a list/array value type containing elements of a specific type"},"v1ValueDictionaryType":{"type":"object","properties":{"is_a":{"type":"string","title":"Semantic classification of what this dictionary represents"},"fields":{"type":"array","items":{"$ref":"#/components/schemas/v1ValueDictionaryTypeField"},"title":"The named fields contained in this dictionary"},"description":{"type":"string","title":"Optional human-readable description of this dictionary type"}},"title":"Represents a dictionary/object value type with named fields"},"v1ValueDictionaryTypeField":{"type":"object","properties":{"key":{"type":"string","title":"The name/key of this field"},"value":{"$ref":"#/components/schemas/v1ValueType"},"description":{"type":"string","title":"Optional human-readable description of this field"}},"title":"Represents a single field within a dictionary value type"},"v1ValueTableType":{"type":"object","properties":{"is_a":{"type":"string","title":"Semantic classification of what this table represents"},"columns":{"type":"array","items":{"$ref":"#/components/schemas/v1ValueTableTypeColumn"},"title":"The columns that make up this table"},"description":{"type":"string","title":"Optional human-readable description of this table type"}},"title":"Represents a table value type with structured columns"},"v1ValueTableTypeColumn":{"type":"object","properties":{"key":{"type":"string","title":"The name/key of this column"},"value":{"$ref":"#/components/schemas/v1ValueType"},"description":{"type":"string","title":"Optional human-readable description of this column"}},"title":"Represents a single column within a table value type"},"v1ValueOpaqueType":{"type":"object","properties":{"is_a":{"type":"string","title":"Semantic classification of what this opaque type represents"},"description":{"type":"string","title":"Optional human-readable description of this opaque type"}},"title":"Represents an opaque value type with semantic meaning but unknown internal structure"},"v1ValueAnyType":{"type":"object","title":"Represents a value type that can hold any kind of value"},"v1ValueUnionType":{"type":"object","properties":{"inners":{"type":"array","items":{"$ref":"#/components/schemas/v1ValueType"},"title":"The possible value types in this union"}},"title":"Represents a union value type that can be one of several possible types"},"v1ValueSensitiveType":{"type":"object","properties":{"inner":{"$ref":"#/components/schemas/v1ValueType"}},"title":"Represents a value type that contains sensitive information"},"v1ValueEnumType":{"type":"object","properties":{"is_a":{"type":"string","title":"Semantic classification of what this enum represents"},"members":{"type":"array","items":{"$ref":"#/components/schemas/v1ValueEnumTypeMember"},"title":"The available options/members of this enum"},"description":{"type":"string","title":"Optional human-readable description of this enum type"}},"title":"Represents an enumeration value type with predefined options"},"v1ValueEnumTypeMember":{"type":"object","properties":{"name":{"type":"string","title":"The programmatic name of this enum member"},"description":{"type":"string","title":"Optional human-readable description of this enum member"}},"title":"Represents a single member/option within an enum value type"},"v1ValueGenericDictionaryType":{"type":"object","properties":{"key_type":{"$ref":"#/components/schemas/v1ValueType"},"value_type":{"$ref":"#/components/schemas/v1ValueType"}},"title":"Represent a generic dictionary that can hold any entry of a particular key and value type"},"v1ValueNoneType":{"type":"object","title":"Represents a none value type that can hold no value"},"v1TextConstraints":{"type":"object","properties":{"min_length":{"type":"integer","format":"int64","description":"Unicode scalar-value counts, not bytes or UTF-16 code units. No implicit\ntrimming, normalization, pattern evaluation or text transformation."},"max_length":{"type":"integer","format":"int64","description":"Inclusive maximum length, measured in Unicode scalar values."}},"description":"Length restrictions on a text answer."},"v1NumberConstraints":{"type":"object","properties":{"minimum":{"$ref":"#/components/schemas/v1Number"},"maximum":{"$ref":"#/components/schemas/v1Number"},"integer_only":{"type":"boolean","description":"Require a value with no fractional component."}},"description":"Exact decimal restrictions on a numeric answer."},"v1InputSpec":{"type":"object","properties":{"selection":{"$ref":"#/components/schemas/v1SelectionInput"}},"description":"How a person supplies a typed answer. Concrete controls and layout belong\nto the renderer. No option carries follow-up fields or executable behavior."},"v1SelectionInput":{"type":"object","properties":{"options":{"type":"array","items":{"$ref":"#/components/schemas/v1SelectionOption"},"description":"Distinct typed values with nonempty labels. May be empty. Each value must\nsatisfy the scalar/element type and applicable field constraints. Numeric\nequality is decimal equality, so 1 and 1.0 are the same option."},"min_selections":{"type":"integer","format":"int64","description":"Only for list fields. Omitted minimum means zero; omitted maximum means the\noption count. Bounds must be ordered and, for nonempty option sets, no greater\nthan that count. Empty selections retain bounds for answer validation.\nUnknown or repeated selections fail. Persist selections in option order,\nusing the declared option values, not user click order or numeric encoding."},"max_selections":{"type":"integer","format":"int64","description":"Inclusive maximum number of selected options."},"options_ref":{"type":"string","description":"Exact nonempty top-level WorkUnit.evidence key, not a path or expression.\nAllowed only in shared human input, mutually exclusive with inline options.\nValid evidence is an inline list of distinct scalar values matching\nthe field's scalar/element type and constraints. Inline text wrappers are\nnormalized to text. No remote reads, record projections or coercion occur.\nEach value is both the displayed choice and the submitted value: text is\nunchanged, numbers use exact decimal text, booleans use true/false, and dates\nuse YYYY-MM-DD. Empty text has no display label and is invalid as an option.\nMissing, empty or invalid choices produce an empty selection, not an input\nerror or free entry. Other fields remain usable. Initial values incompatible\nwith the resolved selection are omitted for that unit."}},"description":"A finite set of offered values. A scalar field selects one value; a list\nfield selects distinct values of its element type. Optional None is absence,\nnever an option. Use inline options or options_ref, not both. Empty selections\noffer no choices and never enable free entry. Resolved unit input and source\nanswer forms use inline options only."},"v1SelectionOption":{"type":"object","properties":{"label":{"type":"string","description":"Nonempty display wording, independent of the submitted value."},"value":{"$ref":"#/components/schemas/commonv1Value"}},"description":"Display wording and the typed value returned when this option is selected.","required":["label","value"]},"v1InputContext":{"type":"object","properties":{"form":{"$ref":"#/components/schemas/v1FormSpec"},"response":{"$ref":"#/components/schemas/v1InputResponse"}},"description":"A human-input form paired with its response.\n\nThe form preserves the meaning of values after form edits or membership changes."},"v1InputResponse":{"type":"object","properties":{"values":{"type":"object","additionalProperties":{"$ref":"#/components/schemas/commonv1Value"},"description":"Current values. Drafts may omit required fields, but supplied values must\nsatisfy the published form. Empty values clear the draft. Unknown keys fail.","readOnly":true},"etag":{"type":"string","description":"Opaque concurrency token. Changes on edits, acceptance, revocation and\nunarchive or form changes. Never reused after clearing a response or rekey.\nClients must return the token they actually read.","readOnly":true},"updated_by":{"type":"string","description":"Actor who last edited values. Empty for a newly created, untouched draft.","readOnly":true},"update_time":{"type":"string","format":"date-time","description":"Time of the latest draft or acceptance change.","readOnly":true},"accepted_by":{"type":"string","description":"Authenticated actor who explicitly accepted these values; empty if not\naccepted. User attribution does not distinguish a human from their agent.","readOnly":true},"accept_time":{"type":"string","format":"date-time","description":"Present only while acceptance is valid. Revoke acceptance before editing.\nForm edits, rekey and unarchive invalidate acceptance; final submission\nprevents editing.","readOnly":true}},"description":"Editable per-unit human input, with explicit acceptance separate from filling.\nAcceptance permits final-answer preparation; it is not a final submission."},"v1AnswerDraft":{"type":"object","properties":{"values":{"type":"object","additionalProperties":{"$ref":"#/components/schemas/commonv1Value"},"description":"Supplied fields must validate; required top-level fields may be omitted.\nSupplied structured values must be complete. Unknown keys fail.","readOnly":true},"etag":{"type":"string","description":"Concurrency token, present before the first save. Changes on saves.\nClearing values never reuses a token.","readOnly":true},"updated_by":{"type":"string","description":"Authenticated actor who last saved values; empty before the first save.","readOnly":true},"update_time":{"type":"string","format":"date-time","description":"Time of the latest save.","readOnly":true}},"description":"Partial final-answer values for one immutable source answer contract.\n\nSaving is optional and never accepts input or settles the unit."},"rpcStatus":{"type":"object","properties":{"code":{"type":"integer","format":"int32"},"message":{"type":"string"},"details":{"type":"array","items":{"$ref":"#/components/schemas/protobufAny"}}}},"protobufAny":{"type":"object","properties":{"@type":{"type":"string"}},"additionalProperties":{}},"WorkItemServiceAcceptWorkUnitInputBody":{"type":"object","properties":{"etag":{"type":"string","description":"Required current input.response.etag; accepted values are read server-side."}},"description":"AcceptWorkUnitInputRequest accepts exactly the response the caller reviewed.","required":["etag"]}}},"paths":{"/api/v1/organizations/{organization_id}/workspaces/{workspace_id}/workUnits/{work_unit_id}:acceptInput":{"post":{"summary":"Accept Work Unit Input","description":"AcceptWorkUnitInput explicitly accepts the current complete human response.\nValidate and normalize against the unit's resolved input.form; missing\nrequired fields fail. Record the authenticated actor and time, change etag\nand set PROCESSING. Revoke acceptance before editing again. This creates no\nfinal submission.\nRequires a matching etag; stale etags return ABORTED. Settled units or an absent\nitem input_form return FAILED_PRECONDITION. Invalid values return INVALID_ARGUMENT.\nAttribution alone does not establish that the caller is a human.","operationId":"AcceptWorkUnitInput","responses":{"200":{"description":"A successful response.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/v1WorkUnit"}}}},"default":{"description":"An unexpected error response.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/rpcStatus"}}}}},"parameters":[{"name":"organization_id","in":"path","required":true,"schema":{"type":"string"}},{"name":"workspace_id","in":"path","required":true,"schema":{"type":"string"}},{"name":"work_unit_id","in":"path","required":true,"schema":{"type":"string"}}],"requestBody":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/WorkItemServiceAcceptWorkUnitInputBody"}}},"required":true},"tags":["Work Items"]}}}}
```

## Revoke Work Unit Input Acceptance

> RevokeWorkUnitInputAcceptance clears acceptance without changing values,\
> changes etag and sets WAITING\_FOR\_INPUT. No final decision is created.\
> Requires a published item input\_form and matching response etag. Stale etags return\
> ABORTED; settled units or an absent item input\_form return FAILED\_PRECONDITION.

```json
{"openapi":"3.0.0","info":{"title":"Kognitos API","version":"1.0.0"},"tags":[{"name":"Work Items","description":"Track work items and work units that need human input."}],"servers":[{"url":"https://app.us-1.kognitos.com"}],"security":[{"BearerAuth":[]}],"components":{"securitySchemes":{"BearerAuth":{"type":"http","scheme":"bearer","description":"Personal Access Token."}},"schemas":{"v1WorkUnit":{"type":"object","properties":{"name":{"type":"string","title":"The stable workspace-scoped resource name of the work unit.\nFormat: organizations/{organization_id}/workspaces/{workspace_id}/workUnits/{work_unit_id}"},"work_item":{"type":"string","description":"Current grouping membership in the same workspace. Rekey may change this reference without changing\nthe unit's name. Empty when the occurrence has no work item.","readOnly":true},"source_ref":{"type":"string","description":"The source's own id for this unit, combined with occurrence_id to identify one request\nfor attention within an organization, workspace and kind across history.\n\nThe source's shape rather than ours. Decisions also carry occurrence_id so a later request\nabout the same thing cannot consume an earlier answer. Not a label: no\nkind declares it and no grouping configuration names it."},"correlation_id":{"type":"string","description":"Source-owned correlation shared by related requests within this organization,\nworkspace and kind. Empty when none was supplied on first admission.\nImmutable; returned by Get and List and filterable through ListWorkUnits.\nIndependent of work-item grouping, occurrence identity and decision routing.","readOnly":true},"kind":{"type":"string","description":"The registered kind of work, as an opaque dotted id. See\nWorkItem.kind.","readOnly":true},"labels":{"type":"object","additionalProperties":{"type":"string"},"description":"The facts the source stated about this unit. The subset the workspace\ngroups on became its item's agg_labels, where a key the workspace groups\non that this unit does not carry became a null.","readOnly":true},"summary":{"type":"string","description":"One line about this unit in business language, as its source put it. The\nquestion, when this is the unit that materialised the item.\n\nImmutable for this occurrence, including before acceptance.","readOnly":true},"detail":{"type":"string","description":"Additional source-authored text describing this occurrence. Empty when omitted.\nImmutable for the occurrence; returned by GetWorkUnit and ListWorkUnits.","readOnly":true},"identifying_details":{"type":"array","items":{"$ref":"#/components/schemas/v1IdentifyingDetail"},"description":"Ordered identifying facts, immutable for this occurrence. Entries with a\nblank label or value are omitted. Clients fall back to summary, then the\nkind display name when empty; detail is supplementary context, not a heading.","readOnly":true},"evidence":{"type":"object","additionalProperties":{"$ref":"#/components/schemas/commonv1Value"},"description":"What a person reads to decide: the records and facts behind this unit,\nnamed and typed, so the platform renders it and the source ships no\nrendering (R6).\n\nImmutable for this occurrence. Changed decision context requires withdrawal\nand a new occurrence. Re-reports never overwrite this evidence.\n\nReturned by both GetWorkUnit and ListWorkUnits.","readOnly":true},"status":{"$ref":"#/components/schemas/v1WorkUnitStatus"},"delivery":{"$ref":"#/components/schemas/v1EffectDelivery"},"settle_time":{"type":"string","format":"date-time","description":"When attention ended for this occurrence: answer, dismissal or withdrawal.","readOnly":true},"create_time":{"type":"string","format":"date-time","description":"The time this unit was first seen.","readOnly":true},"update_time":{"type":"string","format":"date-time","description":"The time this unit last changed, including by a source's re-report.","readOnly":true},"occurrence_id":{"type":"string","description":"The source's immutable identifier for this particular request for attention.\nRe-reports reuse it; a new request uses a new one even for the same source_ref.","readOnly":true},"previous_delivery":{"type":"string","description":"Earlier delivery whose rejection or later execution raised this question.\nEmpty for ordinary arrivals. Exposes follow-up provenance to the surface.","readOnly":true},"submission":{"type":"string","description":"The sole accepted final submission, or empty while no answer is recorded.","readOnly":true},"answer_form":{"$ref":"#/components/schemas/v1FormSpec"},"input":{"$ref":"#/components/schemas/v1InputContext"},"answer_draft":{"$ref":"#/components/schemas/v1AnswerDraft"},"revision":{"type":"string","format":"int64","description":"Monotonically increasing version of this resource's mutable state,\nincluding resolved input and embedded delivery. Compare only versions of\nthe same resource. Independent of mutation etags.","readOnly":true}},"description":"WorkUnit is one real-world thing needing attention, as its source reported\nit: a run that failed, a record that was flagged, an automation waiting on a\nvalue.\n\nThe workspace is the resource parent. The name remains stable across rekey;\nwork_item records grouping membership rather than resource parentage.\nA source reports occurrences without naming an item or asserting grouping."},"v1IdentifyingDetail":{"type":"object","properties":{"label":{"type":"string","description":"Business-facing label, for example \"Invoice\"."},"value":{"type":"string","description":"Nonempty display fallback, for example \"INV-1042\" or \"invoice.pdf\"."},"evidence_ref":{"type":"string","description":"Optional exact top-level key in the same work unit's evidence map.\nThis is neither a resource URI nor an expression. Readers use value when\nabsent, unresolved or unavailable; an invalid reference never rejects work."}},"description":"A source-authored identifying fact for a unit's compact heading.\nDisplayed in source order, with optional access to frozen evidence."},"commonv1Value":{"type":"object","properties":{"null_value":{"type":"string","title":"Represents the absence of a value (None/null/undefined)"},"bool_value":{"type":"boolean","title":"Boolean true/false value"},"number":{"$ref":"#/components/schemas/v1Number"},"text":{"type":"string","title":"UTF-8 encoded text string"},"date":{"$ref":"#/components/schemas/typeDate"},"timeofday":{"$ref":"#/components/schemas/typeTimeOfDay"},"datetime":{"$ref":"#/components/schemas/typeDateTime"},"time_zone":{"$ref":"#/components/schemas/typeTimeZone"},"duration":{"type":"string","title":"Signed duration representing a span of time"},"list":{"$ref":"#/components/schemas/v1List"},"dictionary":{"$ref":"#/components/schemas/v1Dictionary"},"file":{"$ref":"#/components/schemas/v1FileValue"},"table":{"$ref":"#/components/schemas/v1TableValue"},"set":{"$ref":"#/components/schemas/v1Set"},"text_value":{"$ref":"#/components/schemas/v1TextValue"},"list_value":{"$ref":"#/components/schemas/commonv1ListValue"},"set_value":{"$ref":"#/components/schemas/v1SetValue"},"dictionary_value":{"$ref":"#/components/schemas/v1DictionaryValue"}},"description":"Represents a runtime value that can be produced by the Jarvis interpreter.\n\nThis message provides a type-safe way to serialize and transmit values between\nthe Jarvis interpreter and other services via gRPC. It supports all the basic\ndata types that can be represented in the Jarvis language runtime.\n\nThe oneof structure ensures that exactly one value type is set at a time,\nproviding both type safety and efficient serialization."},"v1Number":{"type":"object","properties":{"lo":{"type":"integer","format":"int64","description":"Low 32 bits of the 96-bit mantissa."},"mid":{"type":"integer","format":"int64","description":"Middle 32 bits of the 96-bit mantissa."},"hi":{"type":"integer","format":"int64","description":"High 32 bits of the 96-bit mantissa."},"flags":{"type":"integer","format":"int64","description":"Flags word:\n - Bits 16–23: scale (0–28)\n - Bit 31: sign (0 = positive, 1 = negative)\n - Other bits must be zero."}},"description":"A fixed-precision decimal number with up to 28 fractional digits.\n\nThis message represents decimal numbers with exact precision, avoiding\nfloating-point rounding errors. It's particularly useful for financial\ncalculations, measurements, and any scenario where exact decimal\nrepresentation is required.\n\nThe value is calculated as: m / 10^e, where:\n - m is an unsigned 96-bit integer composed of (lo, mid, hi)\n - e is the scale (0–28) stored in flags bits 16–23\n - sign is encoded in flags bit 31 (0 = positive, 1 = negative)\n\nExamples:\n - 123.45 would have m=12345, e=2\n - -0.001 would have m=1, e=3, with sign bit set\n"},"typeDate":{"type":"object","properties":{"year":{"type":"integer","format":"int32","description":"Year of the date. Must be from 1 to 9999, or 0 to specify a date without\na year."},"month":{"type":"integer","format":"int32","description":"Month of a year. Must be from 1 to 12, or 0 to specify a year without a\nmonth and day."},"day":{"type":"integer","format":"int32","description":"Day of a month. Must be from 1 to 31 and valid for the year and month, or 0\nto specify a year by itself or a year and month where the day isn't\nsignificant."}},"description":"* A full date, with non-zero year, month, and day values\n* A month and day value, with a zero year, such as an anniversary\n* A year on its own, with zero month and day values\n* A year and month value, with a zero day, such as a credit card expiration\ndate\n\nRelated types are [google.type.TimeOfDay][google.type.TimeOfDay] and\n`google.protobuf.Timestamp`.","title":"Represents a whole or partial calendar date, such as a birthday. The time of\nday and time zone are either specified elsewhere or are insignificant. The\ndate is relative to the Gregorian Calendar. This can represent one of the\nfollowing:"},"typeTimeOfDay":{"type":"object","properties":{"hours":{"type":"integer","format":"int32","description":"Hours of day in 24 hour format. Should be from 0 to 23. An API may choose\nto allow the value \"24:00:00\" for scenarios like business closing time."},"minutes":{"type":"integer","format":"int32","description":"Minutes of hour of day. Must be from 0 to 59."},"seconds":{"type":"integer","format":"int32","description":"Seconds of minutes of the time. Must normally be from 0 to 59. An API may\nallow the value 60 if it allows leap-seconds."},"nanos":{"type":"integer","format":"int32","description":"Fractions of seconds in nanoseconds. Must be from 0 to 999,999,999."}},"description":"Represents a time of day. The date and time zone are either not significant\nor are specified elsewhere. An API may choose to allow leap seconds. Related\ntypes are [google.type.Date][google.type.Date] and\n`google.protobuf.Timestamp`."},"typeDateTime":{"type":"object","properties":{"year":{"type":"integer","format":"int32","description":"Optional. Year of date. Must be from 1 to 9999, or 0 if specifying a\ndatetime without a year."},"month":{"type":"integer","format":"int32","description":"Required. Month of year. Must be from 1 to 12."},"day":{"type":"integer","format":"int32","description":"Required. Day of month. Must be from 1 to 31 and valid for the year and\nmonth."},"hours":{"type":"integer","format":"int32","description":"Required. Hours of day in 24 hour format. Should be from 0 to 23. An API\nmay choose to allow the value \"24:00:00\" for scenarios like business\nclosing time."},"minutes":{"type":"integer","format":"int32","description":"Required. Minutes of hour of day. Must be from 0 to 59."},"seconds":{"type":"integer","format":"int32","description":"Required. Seconds of minutes of the time. Must normally be from 0 to 59. An\nAPI may allow the value 60 if it allows leap-seconds."},"nanos":{"type":"integer","format":"int32","description":"Required. Fractions of seconds in nanoseconds. Must be from 0 to\n999,999,999."},"utc_offset":{"type":"string","description":"UTC offset. Must be whole seconds, between -18 hours and +18 hours.\nFor example, a UTC offset of -4:00 would be represented as\n{ seconds: -14400 }."},"time_zone":{"$ref":"#/components/schemas/typeTimeZone"}},"description":"Represents civil time (or occasionally physical time).\n\nThis type can represent a civil time in one of a few possible ways:\n\n * When utc_offset is set and time_zone is unset: a civil time on a calendar\n   day with a particular offset from UTC.\n * When time_zone is set and utc_offset is unset: a civil time on a calendar\n   day in a particular time zone.\n * When neither time_zone nor utc_offset is set: a civil time on a calendar\n   day in local time.\n\nThe date is relative to the Proleptic Gregorian Calendar.\n\nIf year is 0, the DateTime is considered not to have a specific year. month\nand day must have valid, non-zero values.\n\nThis type may also be used to represent a physical time if all the date and\ntime fields are set and either case of the `time_offset` oneof is set.\nConsider using `Timestamp` message for physical time instead. If your use\ncase also would like to store the user's timezone, that can be done in\nanother field.\n\nThis type is more flexible than some applications may want. Make sure to\ndocument and validate your application's limitations."},"typeTimeZone":{"type":"object","properties":{"id":{"type":"string","description":"IANA Time Zone Database time zone, e.g. \"America/New_York\"."},"version":{"type":"string","description":"Optional. IANA Time Zone Database version number, e.g. \"2019a\"."}},"description":"Represents a time zone from the\n[IANA Time Zone Database](https://www.iana.org/time-zones)."},"v1List":{"type":"object","properties":{"items":{"type":"array","items":{"$ref":"#/components/schemas/commonV1Value"},"title":"The ordered sequence of values in this list"}},"description":"Represents an ordered collection of values (similar to arrays or lists).\n\nThis message can contain any number of Value elements in a specific order.\nLists are mutable and can grow or shrink during runtime. Elements can be\naccessed by their zero-based index position.\n\nExamples:\n - [1, 2, 3] - list of numbers\n - [\"hello\", \"world\"] - list of strings\n - [true, 42, \"mixed\"] - list with mixed types\n - [[1, 2], [3, 4]] - nested lists"},"commonV1Value":{"type":"object","properties":{"null_value":{"type":"string","title":"Represents the absence of a value (None/null/undefined)"},"bool_value":{"type":"boolean","title":"Boolean true/false value"},"number":{"$ref":"#/components/schemas/v1Number"},"text":{"type":"string","title":"UTF-8 encoded text string"},"date":{"$ref":"#/components/schemas/typeDate"},"timeofday":{"$ref":"#/components/schemas/typeTimeOfDay"},"datetime":{"$ref":"#/components/schemas/typeDateTime"},"time_zone":{"$ref":"#/components/schemas/typeTimeZone"},"duration":{"type":"string","title":"Signed duration representing a span of time"},"list":{"$ref":"#/components/schemas/v1List"},"dictionary":{"$ref":"#/components/schemas/v1Dictionary"},"file":{"$ref":"#/components/schemas/v1FileValue"},"table":{"$ref":"#/components/schemas/v1TableValue"},"set":{"$ref":"#/components/schemas/v1Set"},"text_value":{"$ref":"#/components/schemas/v1TextValue"},"list_value":{"$ref":"#/components/schemas/commonv1ListValue"},"set_value":{"$ref":"#/components/schemas/v1SetValue"},"dictionary_value":{"$ref":"#/components/schemas/v1DictionaryValue"}},"description":"Represents a runtime value that can be produced by the Jarvis interpreter.\n\nThis message provides a type-safe way to serialize and transmit values between\nthe Jarvis interpreter and other services via gRPC. It supports all the basic\ndata types that can be represented in the Jarvis language runtime.\n\nThe oneof structure ensures that exactly one value type is set at a time,\nproviding both type safety and efficient serialization."},"v1Dictionary":{"type":"object","properties":{"entries":{"type":"array","items":{"$ref":"#/components/schemas/v1DictionaryEntry"},"title":"The key-value pairs stored in this dictionary"}},"description":"Represents a key-value mapping (similar to hash maps or dictionaries).\n\nThis message stores associations between keys and values, where keys must be\nhashable types (null, bool, Number, string, Date, TimeOfDay, DateTime, TimeZone). Keys are\nunique within a dictionary - duplicate keys will overwrite previous values.\n\nThe dictionary maintains insertion order for consistent iteration behavior.\n\nExamples:\n - {\"name\": \"John\", \"age\": 30} - string keys with mixed values\n - {1: \"one\", 2: \"two\"} - number keys with string values\n - {\"nested\": {\"inner\": \"value\"}} - nested dictionaries"},"v1DictionaryEntry":{"type":"object","properties":{"key":{"$ref":"#/components/schemas/v1HashableValue"},"value":{"$ref":"#/components/schemas/commonV1Value"}},"description":"Represents a single key-value pair within a Dictionary.\n\nBoth key and value can be any Value type, though keys should be\nhashable types for proper dictionary behavior. Non-hashable keys\n(like lists or dictionaries) may cause runtime errors."},"v1HashableValue":{"type":"object","properties":{"bool_value":{"type":"boolean","title":"Boolean true/false value"},"number":{"$ref":"#/components/schemas/v1Number"},"text":{"type":"string","title":"UTF-8 encoded text string"},"date":{"$ref":"#/components/schemas/typeDate"},"timeofday":{"$ref":"#/components/schemas/typeTimeOfDay"},"datetime":{"$ref":"#/components/schemas/typeDateTime"},"duration":{"type":"string","title":"Signed duration representing a span of time"},"text_value":{"$ref":"#/components/schemas/v1TextValue"}},"description":"Represents a hashable value that can be used as a dictionary key.\n\nThis message contains only the hashable types from the Value message,\ncorresponding to Python's hashable types. These types can be safely\nused as keys in maps and dictionaries.\n\nHashable types include: bool, Number, string, Date, TimeOfDay, DateTime\nand Duration."},"v1TextValue":{"type":"object","properties":{"remote":{"type":"string","title":"Reference to remote text content via URL or file path"},"inline":{"type":"string","title":"Text content embedded directly in the message"}},"description":"Represents a text value that can be either stored inline or referenced remotely.\n\nThis message provides flexibility for handling text strings in the Jarvis interpreter:\n- Small strings can be embedded directly using the inline option\n- Large strings can be referenced by URL using the remote option\n- The choice depends on string size, network constraints, and access patterns"},"v1FileValue":{"type":"object","properties":{"remote":{"type":"string","title":"Reference to a remote file via URL or file path"},"inline":{"$ref":"#/components/schemas/v1File"}},"description":"Represents a file value that can be either stored inline or referenced remotely.\n\nThis message provides flexibility for handling files in the Jarvis interpreter:\n- Small files can be embedded directly using the inline option\n- Large files can be referenced by URL/path using the remote option\n- The choice depends on file size, network constraints, and access patterns"},"v1File":{"type":"object","properties":{"content":{"type":"string","format":"byte","title":"The raw binary content of the file"},"name":{"type":"string","title":"The name of the file, including extension if applicable"}},"description":"Represents a file with its name and binary content.\n\nThis message contains the complete file data including both metadata\n(filename) and the actual file content as raw bytes. It's used for\nembedding files directly within messages when the file size is\nmanageable and immediate access is required.\n\nExamples:\n - Configuration files\n - Small text or binary files\n - Generated reports or documents\n - Temporary files created during execution\n"},"v1TableValue":{"type":"object","properties":{"remote":{"type":"string","title":"Reference to a remote table via URL or file path (feather-v2 format)"},"inline":{"$ref":"#/components/schemas/v1Table"}},"description":"Represents a table value that can be either stored inline or referenced remotely."},"v1Table":{"type":"object","properties":{"data":{"type":"string","format":"byte","title":"The table data serialized in feather-v2 format"}},"description":"Represents a table with data in feather-v2 format.\n\nThis message contains the complete table data serialized using the\nfeather-v2 format, which provides efficient columnar storage and\nfast serialization/deserialization for tabular data."},"v1Set":{"type":"object","properties":{"items":{"type":"array","items":{"$ref":"#/components/schemas/v1HashableValue"},"title":"The unique elements stored in this set\nAll elements must be hashable types"}},"description":"Represents an unordered collection of unique values.\n\nThis message stores a collection of unique elements, where duplicate values\nare automatically removed. Only hashable types can be stored in sets.\nSets are useful for membership testing, removing duplicates, and mathematical\nset operations like union, intersection, and difference.\n\nThe set does not maintain insertion order - elements may appear in any order\nduring iteration.\n\nExamples:\n - {1, 2, 3} - set of numbers\n - {\"apple\", \"banana\", \"cherry\"} - set of strings\n - {true, false} - set of booleans\n - {1, \"hello\", true} - set with mixed hashable types"},"commonv1ListValue":{"type":"object","properties":{"remote":{"type":"string","title":"Reference to remote list data via URL or file path"},"inline":{"$ref":"#/components/schemas/v1List"}},"description":"Represents a list value that can be either stored inline or referenced remotely.\n\nThis message provides flexibility for handling large lists:\n- Small lists can be embedded directly using the inline option\n- Large lists can be referenced by URL using the remote option"},"v1SetValue":{"type":"object","properties":{"remote":{"type":"string","title":"Reference to remote set data via URL or file path"},"inline":{"$ref":"#/components/schemas/v1Set"}},"description":"Represents a set value that can be either stored inline or referenced remotely.\n\nThis message provides flexibility for handling large sets:\n- Small sets can be embedded directly using the inline option\n- Large sets can be referenced by URL using the remote option"},"v1DictionaryValue":{"type":"object","properties":{"remote":{"type":"string","title":"Reference to remote dictionary data via URL or file path"},"inline":{"$ref":"#/components/schemas/v1Dictionary"}},"description":"Represents a dictionary value that can be either stored inline or referenced remotely.\n\nThis message provides flexibility for handling large dictionaries:\n- Small dictionaries can be embedded directly using the inline option\n- Large dictionaries can be referenced by URL using the remote option"},"v1WorkUnitStatus":{"type":"string","enum":["WORK_UNIT_STATUS_UNSPECIFIED","WORK_UNIT_STATUS_WAITING_FOR_INPUT","WORK_UNIT_STATUS_ANSWERED","WORK_UNIT_STATUS_DISMISSED","WORK_UNIT_STATUS_WITHDRAWN","WORK_UNIT_STATUS_PROCESSING"],"default":"WORK_UNIT_STATUS_UNSPECIFIED","description":"WorkUnitStatus records attention and final resolution independently of delivery.\n\n - WORK_UNIT_STATUS_UNSPECIFIED: Default value; not returned for an existing resource.\n - WORK_UNIT_STATUS_WAITING_FOR_INPUT: Waiting for intermediate input or a direct final answer: an item input_form\nexists and input is unaccepted, or no input_form exists and the kind does\nnot require preparation. Saving either draft leaves status unchanged.\n - WORK_UNIT_STATUS_ANSWERED: Final submission and its delivery obligation are durable.\n - WORK_UNIT_STATUS_DISMISSED: Locally dismissed by item archival, arrival or rekey into an archived item.\nUnarchive restores it unless the source or operator has withdrawn it.\n - WORK_UNIT_STATUS_WITHDRAWN: Source or operator ended the occurrence without an answer.\n - WORK_UNIT_STATUS_PROCESSING: Analysis or decision preparation is pending; no current human request.\nIncludes work without an input_form whose kind requires preparation, and\nfinal-answer preparation after intermediate input acceptance."},"v1EffectDelivery":{"type":"object","properties":{"name":{"type":"string","description":"Resource name; the final segment is the dispatch_id given to the source."},"work_unit":{"type":"string","description":"The unit whose decision this delivers.","readOnly":true},"submission":{"type":"string","description":"The final submission this delivers; always present.","readOnly":true},"attempt_count":{"type":"integer","format":"int32","description":"Count of publish attempts across automatic and operator retry cycles.","readOnly":true},"publish_time":{"type":"string","format":"date-time","description":"First successful broker acknowledgement. Absent before publication.","readOnly":true},"result_time":{"type":"string","format":"date-time","description":"Time Workbench durably received a terminal source result.","readOnly":true},"outcome":{"$ref":"#/components/schemas/v1DecisionOutcome"},"rejection_reason":{"type":"string","description":"Source rejection reason, present only for REJECTED.","readOnly":true},"confirmation_deadline":{"type":"string","format":"date-time","description":"Fixed at first successful publication. Passing this time without a result\nmeans confirmation overdue, never that delivery or application failed.","readOnly":true},"attention_required_time":{"type":"string","format":"date-time","description":"When automatic retries stopped pending operator attention. A late result\nremains admissible. This is not a terminal source result.","readOnly":true},"last_error":{"type":"string","description":"Business-safe operational diagnostic, distinct from a source rejection.\nNo traceback, internal identifier or resource name; richer detail is logged.","readOnly":true}},"description":"EffectDelivery is the durable obligation to deliver one decision to one unit.\nA source result is independent of publication and of unit settlement."},"v1DecisionOutcome":{"type":"string","enum":["DECISION_OUTCOME_UNSPECIFIED","DECISION_OUTCOME_APPLIED","DECISION_OUTCOME_REJECTED"],"default":"DECISION_OUTCOME_UNSPECIFIED","description":"DecisionOutcome is a source's terminal result for a specific dispatch.\n\n - DECISION_OUTCOME_UNSPECIFIED: Not a terminal result; callers must select an outcome.\n - DECISION_OUTCOME_APPLIED: The requested action was committed or durably scheduled by the source.\nThis does not assert that the downstream workflow succeeded.\n - DECISION_OUTCOME_REJECTED: The source definitively refused the decision. A reason is required."},"v1FormSpec":{"type":"object","properties":{"fields":{"type":"array","items":{"$ref":"#/components/schemas/v1FormField"},"description":"At least one question, with unique nonempty keys. Order is the semantic\nreading sequence, not a prescribed screen layout."}},"description":"A set of typed questions for human input or source answers (R6, R13, R14).\nField types derive the returned record type. The platform selects controls\nand layout; there are no widgets, scripts, URLs, or executable expressions.\nShared human input may reference options in each unit's immutable evidence.\nWorkbench resolves those references into the unit's InputContext before use.\nSource answer forms must already be resolved. Filled values are separate messages.\nSources persist their answer form with the pending invocation for recovery.","required":["fields"]},"v1FormField":{"type":"object","properties":{"key":{"type":"string","description":"Stable record key. Unique within its field set; nonempty."},"label":{"type":"string","description":"Business-facing wording, independent of the programmatic key; nonempty."},"help_text":{"type":"string","description":"Optional guidance displayed with the question."},"value_type":{"$ref":"#/components/schemas/v1ValueType"},"initial_value":{"$ref":"#/components/schemas/commonv1Value"},"text":{"$ref":"#/components/schemas/v1TextConstraints"},"number":{"$ref":"#/components/schemas/v1NumberConstraints"},"input_spec":{"$ref":"#/components/schemas/v1InputSpec"}},"description":"One named question, its answer type and its input behavior.","required":["key","label","value_type"]},"v1ValueType":{"type":"object","properties":{"scalar_type":{"$ref":"#/components/schemas/v1ValueScalarType"},"optional_type":{"$ref":"#/components/schemas/v1ValueOptionalType"},"list_type":{"$ref":"#/components/schemas/v1ValueListType"},"dictionary_type":{"$ref":"#/components/schemas/v1ValueDictionaryType"},"table_type":{"$ref":"#/components/schemas/v1ValueTableType"},"opaque_type":{"$ref":"#/components/schemas/v1ValueOpaqueType"},"any_type":{"$ref":"#/components/schemas/v1ValueAnyType"},"union_type":{"$ref":"#/components/schemas/v1ValueUnionType"},"sensitive_type":{"$ref":"#/components/schemas/v1ValueSensitiveType"},"enum_type":{"$ref":"#/components/schemas/v1ValueEnumType"},"generic_dictionary_type":{"$ref":"#/components/schemas/v1ValueGenericDictionaryType"},"none_type":{"$ref":"#/components/schemas/v1ValueNoneType"}},"title":"Represents a complete value type definition using a discriminated union"},"v1ValueScalarType":{"type":"string","enum":["VALUE_SCALAR_TYPE_UNSPECIFIED","VALUE_SCALAR_TYPE_TEXT","VALUE_SCALAR_TYPE_NUMBER","VALUE_SCALAR_TYPE_BOOLEAN","VALUE_SCALAR_TYPE_DATETIME","VALUE_SCALAR_TYPE_DATE","VALUE_SCALAR_TYPE_TIME","VALUE_SCALAR_TYPE_FILE","VALUE_SCALAR_TYPE_TIMEDELTA"],"default":"VALUE_SCALAR_TYPE_UNSPECIFIED","description":"- VALUE_SCALAR_TYPE_UNSPECIFIED: Unspecified value type\n - VALUE_SCALAR_TYPE_TEXT: A text value type\n - VALUE_SCALAR_TYPE_NUMBER: A number value type\n - VALUE_SCALAR_TYPE_BOOLEAN: A boolean value type\n - VALUE_SCALAR_TYPE_DATETIME: A datetime value type\n - VALUE_SCALAR_TYPE_DATE: A date value type\n - VALUE_SCALAR_TYPE_TIME: A time value type\n - VALUE_SCALAR_TYPE_FILE: A file value type\n - VALUE_SCALAR_TYPE_TIMEDELTA: A timedelta value type","title":"Supported Value Scalar Types"},"v1ValueOptionalType":{"type":"object","properties":{"inner":{"$ref":"#/components/schemas/v1ValueType"}},"title":"Represents a value type that can be optional (nullable)"},"v1ValueListType":{"type":"object","properties":{"inner":{"$ref":"#/components/schemas/v1ValueType"}},"title":"Represents a list/array value type containing elements of a specific type"},"v1ValueDictionaryType":{"type":"object","properties":{"is_a":{"type":"string","title":"Semantic classification of what this dictionary represents"},"fields":{"type":"array","items":{"$ref":"#/components/schemas/v1ValueDictionaryTypeField"},"title":"The named fields contained in this dictionary"},"description":{"type":"string","title":"Optional human-readable description of this dictionary type"}},"title":"Represents a dictionary/object value type with named fields"},"v1ValueDictionaryTypeField":{"type":"object","properties":{"key":{"type":"string","title":"The name/key of this field"},"value":{"$ref":"#/components/schemas/v1ValueType"},"description":{"type":"string","title":"Optional human-readable description of this field"}},"title":"Represents a single field within a dictionary value type"},"v1ValueTableType":{"type":"object","properties":{"is_a":{"type":"string","title":"Semantic classification of what this table represents"},"columns":{"type":"array","items":{"$ref":"#/components/schemas/v1ValueTableTypeColumn"},"title":"The columns that make up this table"},"description":{"type":"string","title":"Optional human-readable description of this table type"}},"title":"Represents a table value type with structured columns"},"v1ValueTableTypeColumn":{"type":"object","properties":{"key":{"type":"string","title":"The name/key of this column"},"value":{"$ref":"#/components/schemas/v1ValueType"},"description":{"type":"string","title":"Optional human-readable description of this column"}},"title":"Represents a single column within a table value type"},"v1ValueOpaqueType":{"type":"object","properties":{"is_a":{"type":"string","title":"Semantic classification of what this opaque type represents"},"description":{"type":"string","title":"Optional human-readable description of this opaque type"}},"title":"Represents an opaque value type with semantic meaning but unknown internal structure"},"v1ValueAnyType":{"type":"object","title":"Represents a value type that can hold any kind of value"},"v1ValueUnionType":{"type":"object","properties":{"inners":{"type":"array","items":{"$ref":"#/components/schemas/v1ValueType"},"title":"The possible value types in this union"}},"title":"Represents a union value type that can be one of several possible types"},"v1ValueSensitiveType":{"type":"object","properties":{"inner":{"$ref":"#/components/schemas/v1ValueType"}},"title":"Represents a value type that contains sensitive information"},"v1ValueEnumType":{"type":"object","properties":{"is_a":{"type":"string","title":"Semantic classification of what this enum represents"},"members":{"type":"array","items":{"$ref":"#/components/schemas/v1ValueEnumTypeMember"},"title":"The available options/members of this enum"},"description":{"type":"string","title":"Optional human-readable description of this enum type"}},"title":"Represents an enumeration value type with predefined options"},"v1ValueEnumTypeMember":{"type":"object","properties":{"name":{"type":"string","title":"The programmatic name of this enum member"},"description":{"type":"string","title":"Optional human-readable description of this enum member"}},"title":"Represents a single member/option within an enum value type"},"v1ValueGenericDictionaryType":{"type":"object","properties":{"key_type":{"$ref":"#/components/schemas/v1ValueType"},"value_type":{"$ref":"#/components/schemas/v1ValueType"}},"title":"Represent a generic dictionary that can hold any entry of a particular key and value type"},"v1ValueNoneType":{"type":"object","title":"Represents a none value type that can hold no value"},"v1TextConstraints":{"type":"object","properties":{"min_length":{"type":"integer","format":"int64","description":"Unicode scalar-value counts, not bytes or UTF-16 code units. No implicit\ntrimming, normalization, pattern evaluation or text transformation."},"max_length":{"type":"integer","format":"int64","description":"Inclusive maximum length, measured in Unicode scalar values."}},"description":"Length restrictions on a text answer."},"v1NumberConstraints":{"type":"object","properties":{"minimum":{"$ref":"#/components/schemas/v1Number"},"maximum":{"$ref":"#/components/schemas/v1Number"},"integer_only":{"type":"boolean","description":"Require a value with no fractional component."}},"description":"Exact decimal restrictions on a numeric answer."},"v1InputSpec":{"type":"object","properties":{"selection":{"$ref":"#/components/schemas/v1SelectionInput"}},"description":"How a person supplies a typed answer. Concrete controls and layout belong\nto the renderer. No option carries follow-up fields or executable behavior."},"v1SelectionInput":{"type":"object","properties":{"options":{"type":"array","items":{"$ref":"#/components/schemas/v1SelectionOption"},"description":"Distinct typed values with nonempty labels. May be empty. Each value must\nsatisfy the scalar/element type and applicable field constraints. Numeric\nequality is decimal equality, so 1 and 1.0 are the same option."},"min_selections":{"type":"integer","format":"int64","description":"Only for list fields. Omitted minimum means zero; omitted maximum means the\noption count. Bounds must be ordered and, for nonempty option sets, no greater\nthan that count. Empty selections retain bounds for answer validation.\nUnknown or repeated selections fail. Persist selections in option order,\nusing the declared option values, not user click order or numeric encoding."},"max_selections":{"type":"integer","format":"int64","description":"Inclusive maximum number of selected options."},"options_ref":{"type":"string","description":"Exact nonempty top-level WorkUnit.evidence key, not a path or expression.\nAllowed only in shared human input, mutually exclusive with inline options.\nValid evidence is an inline list of distinct scalar values matching\nthe field's scalar/element type and constraints. Inline text wrappers are\nnormalized to text. No remote reads, record projections or coercion occur.\nEach value is both the displayed choice and the submitted value: text is\nunchanged, numbers use exact decimal text, booleans use true/false, and dates\nuse YYYY-MM-DD. Empty text has no display label and is invalid as an option.\nMissing, empty or invalid choices produce an empty selection, not an input\nerror or free entry. Other fields remain usable. Initial values incompatible\nwith the resolved selection are omitted for that unit."}},"description":"A finite set of offered values. A scalar field selects one value; a list\nfield selects distinct values of its element type. Optional None is absence,\nnever an option. Use inline options or options_ref, not both. Empty selections\noffer no choices and never enable free entry. Resolved unit input and source\nanswer forms use inline options only."},"v1SelectionOption":{"type":"object","properties":{"label":{"type":"string","description":"Nonempty display wording, independent of the submitted value."},"value":{"$ref":"#/components/schemas/commonv1Value"}},"description":"Display wording and the typed value returned when this option is selected.","required":["label","value"]},"v1InputContext":{"type":"object","properties":{"form":{"$ref":"#/components/schemas/v1FormSpec"},"response":{"$ref":"#/components/schemas/v1InputResponse"}},"description":"A human-input form paired with its response.\n\nThe form preserves the meaning of values after form edits or membership changes."},"v1InputResponse":{"type":"object","properties":{"values":{"type":"object","additionalProperties":{"$ref":"#/components/schemas/commonv1Value"},"description":"Current values. Drafts may omit required fields, but supplied values must\nsatisfy the published form. Empty values clear the draft. Unknown keys fail.","readOnly":true},"etag":{"type":"string","description":"Opaque concurrency token. Changes on edits, acceptance, revocation and\nunarchive or form changes. Never reused after clearing a response or rekey.\nClients must return the token they actually read.","readOnly":true},"updated_by":{"type":"string","description":"Actor who last edited values. Empty for a newly created, untouched draft.","readOnly":true},"update_time":{"type":"string","format":"date-time","description":"Time of the latest draft or acceptance change.","readOnly":true},"accepted_by":{"type":"string","description":"Authenticated actor who explicitly accepted these values; empty if not\naccepted. User attribution does not distinguish a human from their agent.","readOnly":true},"accept_time":{"type":"string","format":"date-time","description":"Present only while acceptance is valid. Revoke acceptance before editing.\nForm edits, rekey and unarchive invalidate acceptance; final submission\nprevents editing.","readOnly":true}},"description":"Editable per-unit human input, with explicit acceptance separate from filling.\nAcceptance permits final-answer preparation; it is not a final submission."},"v1AnswerDraft":{"type":"object","properties":{"values":{"type":"object","additionalProperties":{"$ref":"#/components/schemas/commonv1Value"},"description":"Supplied fields must validate; required top-level fields may be omitted.\nSupplied structured values must be complete. Unknown keys fail.","readOnly":true},"etag":{"type":"string","description":"Concurrency token, present before the first save. Changes on saves.\nClearing values never reuses a token.","readOnly":true},"updated_by":{"type":"string","description":"Authenticated actor who last saved values; empty before the first save.","readOnly":true},"update_time":{"type":"string","format":"date-time","description":"Time of the latest save.","readOnly":true}},"description":"Partial final-answer values for one immutable source answer contract.\n\nSaving is optional and never accepts input or settles the unit."},"rpcStatus":{"type":"object","properties":{"code":{"type":"integer","format":"int32"},"message":{"type":"string"},"details":{"type":"array","items":{"$ref":"#/components/schemas/protobufAny"}}}},"protobufAny":{"type":"object","properties":{"@type":{"type":"string"}},"additionalProperties":{}},"WorkItemServiceRevokeWorkUnitInputAcceptanceBody":{"type":"object","properties":{"etag":{"type":"string","description":"Required current input.response.etag."}},"description":"RevokeWorkUnitInputAcceptanceRequest returns the current response to human review.","required":["etag"]}}},"paths":{"/api/v1/organizations/{organization_id}/workspaces/{workspace_id}/workUnits/{work_unit_id}:revokeInputAcceptance":{"post":{"summary":"Revoke Work Unit Input Acceptance","description":"RevokeWorkUnitInputAcceptance clears acceptance without changing values,\nchanges etag and sets WAITING_FOR_INPUT. No final decision is created.\nRequires a published item input_form and matching response etag. Stale etags return\nABORTED; settled units or an absent item input_form return FAILED_PRECONDITION.","operationId":"RevokeWorkUnitInputAcceptance","responses":{"200":{"description":"A successful response.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/v1WorkUnit"}}}},"default":{"description":"An unexpected error response.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/rpcStatus"}}}}},"parameters":[{"name":"organization_id","in":"path","required":true,"schema":{"type":"string"}},{"name":"workspace_id","in":"path","required":true,"schema":{"type":"string"}},{"name":"work_unit_id","in":"path","required":true,"schema":{"type":"string"}}],"requestBody":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/WorkItemServiceRevokeWorkUnitInputAcceptanceBody"}}},"required":true},"tags":["Work Items"]}}}}
```

## Save Work Unit Answer

> SaveWorkUnitAnswer replaces an optional final-answer draft. Required fields\
> may be omitted; supplied values validate against the unit's answer\_form.\
> Empty values clear the draft. Requires the current answer\_draft.etag;\
> stale tokens return ABORTED. Settled units return FAILED\_PRECONDITION.\
> Saving changes neither status nor input acceptance and creates no delivery.

```json
{"openapi":"3.0.0","info":{"title":"Kognitos API","version":"1.0.0"},"tags":[{"name":"Work Items","description":"Track work items and work units that need human input."}],"servers":[{"url":"https://app.us-1.kognitos.com"}],"security":[{"BearerAuth":[]}],"components":{"securitySchemes":{"BearerAuth":{"type":"http","scheme":"bearer","description":"Personal Access Token."}},"schemas":{"v1WorkUnit":{"type":"object","properties":{"name":{"type":"string","title":"The stable workspace-scoped resource name of the work unit.\nFormat: organizations/{organization_id}/workspaces/{workspace_id}/workUnits/{work_unit_id}"},"work_item":{"type":"string","description":"Current grouping membership in the same workspace. Rekey may change this reference without changing\nthe unit's name. Empty when the occurrence has no work item.","readOnly":true},"source_ref":{"type":"string","description":"The source's own id for this unit, combined with occurrence_id to identify one request\nfor attention within an organization, workspace and kind across history.\n\nThe source's shape rather than ours. Decisions also carry occurrence_id so a later request\nabout the same thing cannot consume an earlier answer. Not a label: no\nkind declares it and no grouping configuration names it."},"correlation_id":{"type":"string","description":"Source-owned correlation shared by related requests within this organization,\nworkspace and kind. Empty when none was supplied on first admission.\nImmutable; returned by Get and List and filterable through ListWorkUnits.\nIndependent of work-item grouping, occurrence identity and decision routing.","readOnly":true},"kind":{"type":"string","description":"The registered kind of work, as an opaque dotted id. See\nWorkItem.kind.","readOnly":true},"labels":{"type":"object","additionalProperties":{"type":"string"},"description":"The facts the source stated about this unit. The subset the workspace\ngroups on became its item's agg_labels, where a key the workspace groups\non that this unit does not carry became a null.","readOnly":true},"summary":{"type":"string","description":"One line about this unit in business language, as its source put it. The\nquestion, when this is the unit that materialised the item.\n\nImmutable for this occurrence, including before acceptance.","readOnly":true},"detail":{"type":"string","description":"Additional source-authored text describing this occurrence. Empty when omitted.\nImmutable for the occurrence; returned by GetWorkUnit and ListWorkUnits.","readOnly":true},"identifying_details":{"type":"array","items":{"$ref":"#/components/schemas/v1IdentifyingDetail"},"description":"Ordered identifying facts, immutable for this occurrence. Entries with a\nblank label or value are omitted. Clients fall back to summary, then the\nkind display name when empty; detail is supplementary context, not a heading.","readOnly":true},"evidence":{"type":"object","additionalProperties":{"$ref":"#/components/schemas/commonv1Value"},"description":"What a person reads to decide: the records and facts behind this unit,\nnamed and typed, so the platform renders it and the source ships no\nrendering (R6).\n\nImmutable for this occurrence. Changed decision context requires withdrawal\nand a new occurrence. Re-reports never overwrite this evidence.\n\nReturned by both GetWorkUnit and ListWorkUnits.","readOnly":true},"status":{"$ref":"#/components/schemas/v1WorkUnitStatus"},"delivery":{"$ref":"#/components/schemas/v1EffectDelivery"},"settle_time":{"type":"string","format":"date-time","description":"When attention ended for this occurrence: answer, dismissal or withdrawal.","readOnly":true},"create_time":{"type":"string","format":"date-time","description":"The time this unit was first seen.","readOnly":true},"update_time":{"type":"string","format":"date-time","description":"The time this unit last changed, including by a source's re-report.","readOnly":true},"occurrence_id":{"type":"string","description":"The source's immutable identifier for this particular request for attention.\nRe-reports reuse it; a new request uses a new one even for the same source_ref.","readOnly":true},"previous_delivery":{"type":"string","description":"Earlier delivery whose rejection or later execution raised this question.\nEmpty for ordinary arrivals. Exposes follow-up provenance to the surface.","readOnly":true},"submission":{"type":"string","description":"The sole accepted final submission, or empty while no answer is recorded.","readOnly":true},"answer_form":{"$ref":"#/components/schemas/v1FormSpec"},"input":{"$ref":"#/components/schemas/v1InputContext"},"answer_draft":{"$ref":"#/components/schemas/v1AnswerDraft"},"revision":{"type":"string","format":"int64","description":"Monotonically increasing version of this resource's mutable state,\nincluding resolved input and embedded delivery. Compare only versions of\nthe same resource. Independent of mutation etags.","readOnly":true}},"description":"WorkUnit is one real-world thing needing attention, as its source reported\nit: a run that failed, a record that was flagged, an automation waiting on a\nvalue.\n\nThe workspace is the resource parent. The name remains stable across rekey;\nwork_item records grouping membership rather than resource parentage.\nA source reports occurrences without naming an item or asserting grouping."},"v1IdentifyingDetail":{"type":"object","properties":{"label":{"type":"string","description":"Business-facing label, for example \"Invoice\"."},"value":{"type":"string","description":"Nonempty display fallback, for example \"INV-1042\" or \"invoice.pdf\"."},"evidence_ref":{"type":"string","description":"Optional exact top-level key in the same work unit's evidence map.\nThis is neither a resource URI nor an expression. Readers use value when\nabsent, unresolved or unavailable; an invalid reference never rejects work."}},"description":"A source-authored identifying fact for a unit's compact heading.\nDisplayed in source order, with optional access to frozen evidence."},"commonv1Value":{"type":"object","properties":{"null_value":{"type":"string","title":"Represents the absence of a value (None/null/undefined)"},"bool_value":{"type":"boolean","title":"Boolean true/false value"},"number":{"$ref":"#/components/schemas/v1Number"},"text":{"type":"string","title":"UTF-8 encoded text string"},"date":{"$ref":"#/components/schemas/typeDate"},"timeofday":{"$ref":"#/components/schemas/typeTimeOfDay"},"datetime":{"$ref":"#/components/schemas/typeDateTime"},"time_zone":{"$ref":"#/components/schemas/typeTimeZone"},"duration":{"type":"string","title":"Signed duration representing a span of time"},"list":{"$ref":"#/components/schemas/v1List"},"dictionary":{"$ref":"#/components/schemas/v1Dictionary"},"file":{"$ref":"#/components/schemas/v1FileValue"},"table":{"$ref":"#/components/schemas/v1TableValue"},"set":{"$ref":"#/components/schemas/v1Set"},"text_value":{"$ref":"#/components/schemas/v1TextValue"},"list_value":{"$ref":"#/components/schemas/commonv1ListValue"},"set_value":{"$ref":"#/components/schemas/v1SetValue"},"dictionary_value":{"$ref":"#/components/schemas/v1DictionaryValue"}},"description":"Represents a runtime value that can be produced by the Jarvis interpreter.\n\nThis message provides a type-safe way to serialize and transmit values between\nthe Jarvis interpreter and other services via gRPC. It supports all the basic\ndata types that can be represented in the Jarvis language runtime.\n\nThe oneof structure ensures that exactly one value type is set at a time,\nproviding both type safety and efficient serialization."},"v1Number":{"type":"object","properties":{"lo":{"type":"integer","format":"int64","description":"Low 32 bits of the 96-bit mantissa."},"mid":{"type":"integer","format":"int64","description":"Middle 32 bits of the 96-bit mantissa."},"hi":{"type":"integer","format":"int64","description":"High 32 bits of the 96-bit mantissa."},"flags":{"type":"integer","format":"int64","description":"Flags word:\n - Bits 16–23: scale (0–28)\n - Bit 31: sign (0 = positive, 1 = negative)\n - Other bits must be zero."}},"description":"A fixed-precision decimal number with up to 28 fractional digits.\n\nThis message represents decimal numbers with exact precision, avoiding\nfloating-point rounding errors. It's particularly useful for financial\ncalculations, measurements, and any scenario where exact decimal\nrepresentation is required.\n\nThe value is calculated as: m / 10^e, where:\n - m is an unsigned 96-bit integer composed of (lo, mid, hi)\n - e is the scale (0–28) stored in flags bits 16–23\n - sign is encoded in flags bit 31 (0 = positive, 1 = negative)\n\nExamples:\n - 123.45 would have m=12345, e=2\n - -0.001 would have m=1, e=3, with sign bit set\n"},"typeDate":{"type":"object","properties":{"year":{"type":"integer","format":"int32","description":"Year of the date. Must be from 1 to 9999, or 0 to specify a date without\na year."},"month":{"type":"integer","format":"int32","description":"Month of a year. Must be from 1 to 12, or 0 to specify a year without a\nmonth and day."},"day":{"type":"integer","format":"int32","description":"Day of a month. Must be from 1 to 31 and valid for the year and month, or 0\nto specify a year by itself or a year and month where the day isn't\nsignificant."}},"description":"* A full date, with non-zero year, month, and day values\n* A month and day value, with a zero year, such as an anniversary\n* A year on its own, with zero month and day values\n* A year and month value, with a zero day, such as a credit card expiration\ndate\n\nRelated types are [google.type.TimeOfDay][google.type.TimeOfDay] and\n`google.protobuf.Timestamp`.","title":"Represents a whole or partial calendar date, such as a birthday. The time of\nday and time zone are either specified elsewhere or are insignificant. The\ndate is relative to the Gregorian Calendar. This can represent one of the\nfollowing:"},"typeTimeOfDay":{"type":"object","properties":{"hours":{"type":"integer","format":"int32","description":"Hours of day in 24 hour format. Should be from 0 to 23. An API may choose\nto allow the value \"24:00:00\" for scenarios like business closing time."},"minutes":{"type":"integer","format":"int32","description":"Minutes of hour of day. Must be from 0 to 59."},"seconds":{"type":"integer","format":"int32","description":"Seconds of minutes of the time. Must normally be from 0 to 59. An API may\nallow the value 60 if it allows leap-seconds."},"nanos":{"type":"integer","format":"int32","description":"Fractions of seconds in nanoseconds. Must be from 0 to 999,999,999."}},"description":"Represents a time of day. The date and time zone are either not significant\nor are specified elsewhere. An API may choose to allow leap seconds. Related\ntypes are [google.type.Date][google.type.Date] and\n`google.protobuf.Timestamp`."},"typeDateTime":{"type":"object","properties":{"year":{"type":"integer","format":"int32","description":"Optional. Year of date. Must be from 1 to 9999, or 0 if specifying a\ndatetime without a year."},"month":{"type":"integer","format":"int32","description":"Required. Month of year. Must be from 1 to 12."},"day":{"type":"integer","format":"int32","description":"Required. Day of month. Must be from 1 to 31 and valid for the year and\nmonth."},"hours":{"type":"integer","format":"int32","description":"Required. Hours of day in 24 hour format. Should be from 0 to 23. An API\nmay choose to allow the value \"24:00:00\" for scenarios like business\nclosing time."},"minutes":{"type":"integer","format":"int32","description":"Required. Minutes of hour of day. Must be from 0 to 59."},"seconds":{"type":"integer","format":"int32","description":"Required. Seconds of minutes of the time. Must normally be from 0 to 59. An\nAPI may allow the value 60 if it allows leap-seconds."},"nanos":{"type":"integer","format":"int32","description":"Required. Fractions of seconds in nanoseconds. Must be from 0 to\n999,999,999."},"utc_offset":{"type":"string","description":"UTC offset. Must be whole seconds, between -18 hours and +18 hours.\nFor example, a UTC offset of -4:00 would be represented as\n{ seconds: -14400 }."},"time_zone":{"$ref":"#/components/schemas/typeTimeZone"}},"description":"Represents civil time (or occasionally physical time).\n\nThis type can represent a civil time in one of a few possible ways:\n\n * When utc_offset is set and time_zone is unset: a civil time on a calendar\n   day with a particular offset from UTC.\n * When time_zone is set and utc_offset is unset: a civil time on a calendar\n   day in a particular time zone.\n * When neither time_zone nor utc_offset is set: a civil time on a calendar\n   day in local time.\n\nThe date is relative to the Proleptic Gregorian Calendar.\n\nIf year is 0, the DateTime is considered not to have a specific year. month\nand day must have valid, non-zero values.\n\nThis type may also be used to represent a physical time if all the date and\ntime fields are set and either case of the `time_offset` oneof is set.\nConsider using `Timestamp` message for physical time instead. If your use\ncase also would like to store the user's timezone, that can be done in\nanother field.\n\nThis type is more flexible than some applications may want. Make sure to\ndocument and validate your application's limitations."},"typeTimeZone":{"type":"object","properties":{"id":{"type":"string","description":"IANA Time Zone Database time zone, e.g. \"America/New_York\"."},"version":{"type":"string","description":"Optional. IANA Time Zone Database version number, e.g. \"2019a\"."}},"description":"Represents a time zone from the\n[IANA Time Zone Database](https://www.iana.org/time-zones)."},"v1List":{"type":"object","properties":{"items":{"type":"array","items":{"$ref":"#/components/schemas/commonV1Value"},"title":"The ordered sequence of values in this list"}},"description":"Represents an ordered collection of values (similar to arrays or lists).\n\nThis message can contain any number of Value elements in a specific order.\nLists are mutable and can grow or shrink during runtime. Elements can be\naccessed by their zero-based index position.\n\nExamples:\n - [1, 2, 3] - list of numbers\n - [\"hello\", \"world\"] - list of strings\n - [true, 42, \"mixed\"] - list with mixed types\n - [[1, 2], [3, 4]] - nested lists"},"commonV1Value":{"type":"object","properties":{"null_value":{"type":"string","title":"Represents the absence of a value (None/null/undefined)"},"bool_value":{"type":"boolean","title":"Boolean true/false value"},"number":{"$ref":"#/components/schemas/v1Number"},"text":{"type":"string","title":"UTF-8 encoded text string"},"date":{"$ref":"#/components/schemas/typeDate"},"timeofday":{"$ref":"#/components/schemas/typeTimeOfDay"},"datetime":{"$ref":"#/components/schemas/typeDateTime"},"time_zone":{"$ref":"#/components/schemas/typeTimeZone"},"duration":{"type":"string","title":"Signed duration representing a span of time"},"list":{"$ref":"#/components/schemas/v1List"},"dictionary":{"$ref":"#/components/schemas/v1Dictionary"},"file":{"$ref":"#/components/schemas/v1FileValue"},"table":{"$ref":"#/components/schemas/v1TableValue"},"set":{"$ref":"#/components/schemas/v1Set"},"text_value":{"$ref":"#/components/schemas/v1TextValue"},"list_value":{"$ref":"#/components/schemas/commonv1ListValue"},"set_value":{"$ref":"#/components/schemas/v1SetValue"},"dictionary_value":{"$ref":"#/components/schemas/v1DictionaryValue"}},"description":"Represents a runtime value that can be produced by the Jarvis interpreter.\n\nThis message provides a type-safe way to serialize and transmit values between\nthe Jarvis interpreter and other services via gRPC. It supports all the basic\ndata types that can be represented in the Jarvis language runtime.\n\nThe oneof structure ensures that exactly one value type is set at a time,\nproviding both type safety and efficient serialization."},"v1Dictionary":{"type":"object","properties":{"entries":{"type":"array","items":{"$ref":"#/components/schemas/v1DictionaryEntry"},"title":"The key-value pairs stored in this dictionary"}},"description":"Represents a key-value mapping (similar to hash maps or dictionaries).\n\nThis message stores associations between keys and values, where keys must be\nhashable types (null, bool, Number, string, Date, TimeOfDay, DateTime, TimeZone). Keys are\nunique within a dictionary - duplicate keys will overwrite previous values.\n\nThe dictionary maintains insertion order for consistent iteration behavior.\n\nExamples:\n - {\"name\": \"John\", \"age\": 30} - string keys with mixed values\n - {1: \"one\", 2: \"two\"} - number keys with string values\n - {\"nested\": {\"inner\": \"value\"}} - nested dictionaries"},"v1DictionaryEntry":{"type":"object","properties":{"key":{"$ref":"#/components/schemas/v1HashableValue"},"value":{"$ref":"#/components/schemas/commonV1Value"}},"description":"Represents a single key-value pair within a Dictionary.\n\nBoth key and value can be any Value type, though keys should be\nhashable types for proper dictionary behavior. Non-hashable keys\n(like lists or dictionaries) may cause runtime errors."},"v1HashableValue":{"type":"object","properties":{"bool_value":{"type":"boolean","title":"Boolean true/false value"},"number":{"$ref":"#/components/schemas/v1Number"},"text":{"type":"string","title":"UTF-8 encoded text string"},"date":{"$ref":"#/components/schemas/typeDate"},"timeofday":{"$ref":"#/components/schemas/typeTimeOfDay"},"datetime":{"$ref":"#/components/schemas/typeDateTime"},"duration":{"type":"string","title":"Signed duration representing a span of time"},"text_value":{"$ref":"#/components/schemas/v1TextValue"}},"description":"Represents a hashable value that can be used as a dictionary key.\n\nThis message contains only the hashable types from the Value message,\ncorresponding to Python's hashable types. These types can be safely\nused as keys in maps and dictionaries.\n\nHashable types include: bool, Number, string, Date, TimeOfDay, DateTime\nand Duration."},"v1TextValue":{"type":"object","properties":{"remote":{"type":"string","title":"Reference to remote text content via URL or file path"},"inline":{"type":"string","title":"Text content embedded directly in the message"}},"description":"Represents a text value that can be either stored inline or referenced remotely.\n\nThis message provides flexibility for handling text strings in the Jarvis interpreter:\n- Small strings can be embedded directly using the inline option\n- Large strings can be referenced by URL using the remote option\n- The choice depends on string size, network constraints, and access patterns"},"v1FileValue":{"type":"object","properties":{"remote":{"type":"string","title":"Reference to a remote file via URL or file path"},"inline":{"$ref":"#/components/schemas/v1File"}},"description":"Represents a file value that can be either stored inline or referenced remotely.\n\nThis message provides flexibility for handling files in the Jarvis interpreter:\n- Small files can be embedded directly using the inline option\n- Large files can be referenced by URL/path using the remote option\n- The choice depends on file size, network constraints, and access patterns"},"v1File":{"type":"object","properties":{"content":{"type":"string","format":"byte","title":"The raw binary content of the file"},"name":{"type":"string","title":"The name of the file, including extension if applicable"}},"description":"Represents a file with its name and binary content.\n\nThis message contains the complete file data including both metadata\n(filename) and the actual file content as raw bytes. It's used for\nembedding files directly within messages when the file size is\nmanageable and immediate access is required.\n\nExamples:\n - Configuration files\n - Small text or binary files\n - Generated reports or documents\n - Temporary files created during execution\n"},"v1TableValue":{"type":"object","properties":{"remote":{"type":"string","title":"Reference to a remote table via URL or file path (feather-v2 format)"},"inline":{"$ref":"#/components/schemas/v1Table"}},"description":"Represents a table value that can be either stored inline or referenced remotely."},"v1Table":{"type":"object","properties":{"data":{"type":"string","format":"byte","title":"The table data serialized in feather-v2 format"}},"description":"Represents a table with data in feather-v2 format.\n\nThis message contains the complete table data serialized using the\nfeather-v2 format, which provides efficient columnar storage and\nfast serialization/deserialization for tabular data."},"v1Set":{"type":"object","properties":{"items":{"type":"array","items":{"$ref":"#/components/schemas/v1HashableValue"},"title":"The unique elements stored in this set\nAll elements must be hashable types"}},"description":"Represents an unordered collection of unique values.\n\nThis message stores a collection of unique elements, where duplicate values\nare automatically removed. Only hashable types can be stored in sets.\nSets are useful for membership testing, removing duplicates, and mathematical\nset operations like union, intersection, and difference.\n\nThe set does not maintain insertion order - elements may appear in any order\nduring iteration.\n\nExamples:\n - {1, 2, 3} - set of numbers\n - {\"apple\", \"banana\", \"cherry\"} - set of strings\n - {true, false} - set of booleans\n - {1, \"hello\", true} - set with mixed hashable types"},"commonv1ListValue":{"type":"object","properties":{"remote":{"type":"string","title":"Reference to remote list data via URL or file path"},"inline":{"$ref":"#/components/schemas/v1List"}},"description":"Represents a list value that can be either stored inline or referenced remotely.\n\nThis message provides flexibility for handling large lists:\n- Small lists can be embedded directly using the inline option\n- Large lists can be referenced by URL using the remote option"},"v1SetValue":{"type":"object","properties":{"remote":{"type":"string","title":"Reference to remote set data via URL or file path"},"inline":{"$ref":"#/components/schemas/v1Set"}},"description":"Represents a set value that can be either stored inline or referenced remotely.\n\nThis message provides flexibility for handling large sets:\n- Small sets can be embedded directly using the inline option\n- Large sets can be referenced by URL using the remote option"},"v1DictionaryValue":{"type":"object","properties":{"remote":{"type":"string","title":"Reference to remote dictionary data via URL or file path"},"inline":{"$ref":"#/components/schemas/v1Dictionary"}},"description":"Represents a dictionary value that can be either stored inline or referenced remotely.\n\nThis message provides flexibility for handling large dictionaries:\n- Small dictionaries can be embedded directly using the inline option\n- Large dictionaries can be referenced by URL using the remote option"},"v1WorkUnitStatus":{"type":"string","enum":["WORK_UNIT_STATUS_UNSPECIFIED","WORK_UNIT_STATUS_WAITING_FOR_INPUT","WORK_UNIT_STATUS_ANSWERED","WORK_UNIT_STATUS_DISMISSED","WORK_UNIT_STATUS_WITHDRAWN","WORK_UNIT_STATUS_PROCESSING"],"default":"WORK_UNIT_STATUS_UNSPECIFIED","description":"WorkUnitStatus records attention and final resolution independently of delivery.\n\n - WORK_UNIT_STATUS_UNSPECIFIED: Default value; not returned for an existing resource.\n - WORK_UNIT_STATUS_WAITING_FOR_INPUT: Waiting for intermediate input or a direct final answer: an item input_form\nexists and input is unaccepted, or no input_form exists and the kind does\nnot require preparation. Saving either draft leaves status unchanged.\n - WORK_UNIT_STATUS_ANSWERED: Final submission and its delivery obligation are durable.\n - WORK_UNIT_STATUS_DISMISSED: Locally dismissed by item archival, arrival or rekey into an archived item.\nUnarchive restores it unless the source or operator has withdrawn it.\n - WORK_UNIT_STATUS_WITHDRAWN: Source or operator ended the occurrence without an answer.\n - WORK_UNIT_STATUS_PROCESSING: Analysis or decision preparation is pending; no current human request.\nIncludes work without an input_form whose kind requires preparation, and\nfinal-answer preparation after intermediate input acceptance."},"v1EffectDelivery":{"type":"object","properties":{"name":{"type":"string","description":"Resource name; the final segment is the dispatch_id given to the source."},"work_unit":{"type":"string","description":"The unit whose decision this delivers.","readOnly":true},"submission":{"type":"string","description":"The final submission this delivers; always present.","readOnly":true},"attempt_count":{"type":"integer","format":"int32","description":"Count of publish attempts across automatic and operator retry cycles.","readOnly":true},"publish_time":{"type":"string","format":"date-time","description":"First successful broker acknowledgement. Absent before publication.","readOnly":true},"result_time":{"type":"string","format":"date-time","description":"Time Workbench durably received a terminal source result.","readOnly":true},"outcome":{"$ref":"#/components/schemas/v1DecisionOutcome"},"rejection_reason":{"type":"string","description":"Source rejection reason, present only for REJECTED.","readOnly":true},"confirmation_deadline":{"type":"string","format":"date-time","description":"Fixed at first successful publication. Passing this time without a result\nmeans confirmation overdue, never that delivery or application failed.","readOnly":true},"attention_required_time":{"type":"string","format":"date-time","description":"When automatic retries stopped pending operator attention. A late result\nremains admissible. This is not a terminal source result.","readOnly":true},"last_error":{"type":"string","description":"Business-safe operational diagnostic, distinct from a source rejection.\nNo traceback, internal identifier or resource name; richer detail is logged.","readOnly":true}},"description":"EffectDelivery is the durable obligation to deliver one decision to one unit.\nA source result is independent of publication and of unit settlement."},"v1DecisionOutcome":{"type":"string","enum":["DECISION_OUTCOME_UNSPECIFIED","DECISION_OUTCOME_APPLIED","DECISION_OUTCOME_REJECTED"],"default":"DECISION_OUTCOME_UNSPECIFIED","description":"DecisionOutcome is a source's terminal result for a specific dispatch.\n\n - DECISION_OUTCOME_UNSPECIFIED: Not a terminal result; callers must select an outcome.\n - DECISION_OUTCOME_APPLIED: The requested action was committed or durably scheduled by the source.\nThis does not assert that the downstream workflow succeeded.\n - DECISION_OUTCOME_REJECTED: The source definitively refused the decision. A reason is required."},"v1FormSpec":{"type":"object","properties":{"fields":{"type":"array","items":{"$ref":"#/components/schemas/v1FormField"},"description":"At least one question, with unique nonempty keys. Order is the semantic\nreading sequence, not a prescribed screen layout."}},"description":"A set of typed questions for human input or source answers (R6, R13, R14).\nField types derive the returned record type. The platform selects controls\nand layout; there are no widgets, scripts, URLs, or executable expressions.\nShared human input may reference options in each unit's immutable evidence.\nWorkbench resolves those references into the unit's InputContext before use.\nSource answer forms must already be resolved. Filled values are separate messages.\nSources persist their answer form with the pending invocation for recovery.","required":["fields"]},"v1FormField":{"type":"object","properties":{"key":{"type":"string","description":"Stable record key. Unique within its field set; nonempty."},"label":{"type":"string","description":"Business-facing wording, independent of the programmatic key; nonempty."},"help_text":{"type":"string","description":"Optional guidance displayed with the question."},"value_type":{"$ref":"#/components/schemas/v1ValueType"},"initial_value":{"$ref":"#/components/schemas/commonv1Value"},"text":{"$ref":"#/components/schemas/v1TextConstraints"},"number":{"$ref":"#/components/schemas/v1NumberConstraints"},"input_spec":{"$ref":"#/components/schemas/v1InputSpec"}},"description":"One named question, its answer type and its input behavior.","required":["key","label","value_type"]},"v1ValueType":{"type":"object","properties":{"scalar_type":{"$ref":"#/components/schemas/v1ValueScalarType"},"optional_type":{"$ref":"#/components/schemas/v1ValueOptionalType"},"list_type":{"$ref":"#/components/schemas/v1ValueListType"},"dictionary_type":{"$ref":"#/components/schemas/v1ValueDictionaryType"},"table_type":{"$ref":"#/components/schemas/v1ValueTableType"},"opaque_type":{"$ref":"#/components/schemas/v1ValueOpaqueType"},"any_type":{"$ref":"#/components/schemas/v1ValueAnyType"},"union_type":{"$ref":"#/components/schemas/v1ValueUnionType"},"sensitive_type":{"$ref":"#/components/schemas/v1ValueSensitiveType"},"enum_type":{"$ref":"#/components/schemas/v1ValueEnumType"},"generic_dictionary_type":{"$ref":"#/components/schemas/v1ValueGenericDictionaryType"},"none_type":{"$ref":"#/components/schemas/v1ValueNoneType"}},"title":"Represents a complete value type definition using a discriminated union"},"v1ValueScalarType":{"type":"string","enum":["VALUE_SCALAR_TYPE_UNSPECIFIED","VALUE_SCALAR_TYPE_TEXT","VALUE_SCALAR_TYPE_NUMBER","VALUE_SCALAR_TYPE_BOOLEAN","VALUE_SCALAR_TYPE_DATETIME","VALUE_SCALAR_TYPE_DATE","VALUE_SCALAR_TYPE_TIME","VALUE_SCALAR_TYPE_FILE","VALUE_SCALAR_TYPE_TIMEDELTA"],"default":"VALUE_SCALAR_TYPE_UNSPECIFIED","description":"- VALUE_SCALAR_TYPE_UNSPECIFIED: Unspecified value type\n - VALUE_SCALAR_TYPE_TEXT: A text value type\n - VALUE_SCALAR_TYPE_NUMBER: A number value type\n - VALUE_SCALAR_TYPE_BOOLEAN: A boolean value type\n - VALUE_SCALAR_TYPE_DATETIME: A datetime value type\n - VALUE_SCALAR_TYPE_DATE: A date value type\n - VALUE_SCALAR_TYPE_TIME: A time value type\n - VALUE_SCALAR_TYPE_FILE: A file value type\n - VALUE_SCALAR_TYPE_TIMEDELTA: A timedelta value type","title":"Supported Value Scalar Types"},"v1ValueOptionalType":{"type":"object","properties":{"inner":{"$ref":"#/components/schemas/v1ValueType"}},"title":"Represents a value type that can be optional (nullable)"},"v1ValueListType":{"type":"object","properties":{"inner":{"$ref":"#/components/schemas/v1ValueType"}},"title":"Represents a list/array value type containing elements of a specific type"},"v1ValueDictionaryType":{"type":"object","properties":{"is_a":{"type":"string","title":"Semantic classification of what this dictionary represents"},"fields":{"type":"array","items":{"$ref":"#/components/schemas/v1ValueDictionaryTypeField"},"title":"The named fields contained in this dictionary"},"description":{"type":"string","title":"Optional human-readable description of this dictionary type"}},"title":"Represents a dictionary/object value type with named fields"},"v1ValueDictionaryTypeField":{"type":"object","properties":{"key":{"type":"string","title":"The name/key of this field"},"value":{"$ref":"#/components/schemas/v1ValueType"},"description":{"type":"string","title":"Optional human-readable description of this field"}},"title":"Represents a single field within a dictionary value type"},"v1ValueTableType":{"type":"object","properties":{"is_a":{"type":"string","title":"Semantic classification of what this table represents"},"columns":{"type":"array","items":{"$ref":"#/components/schemas/v1ValueTableTypeColumn"},"title":"The columns that make up this table"},"description":{"type":"string","title":"Optional human-readable description of this table type"}},"title":"Represents a table value type with structured columns"},"v1ValueTableTypeColumn":{"type":"object","properties":{"key":{"type":"string","title":"The name/key of this column"},"value":{"$ref":"#/components/schemas/v1ValueType"},"description":{"type":"string","title":"Optional human-readable description of this column"}},"title":"Represents a single column within a table value type"},"v1ValueOpaqueType":{"type":"object","properties":{"is_a":{"type":"string","title":"Semantic classification of what this opaque type represents"},"description":{"type":"string","title":"Optional human-readable description of this opaque type"}},"title":"Represents an opaque value type with semantic meaning but unknown internal structure"},"v1ValueAnyType":{"type":"object","title":"Represents a value type that can hold any kind of value"},"v1ValueUnionType":{"type":"object","properties":{"inners":{"type":"array","items":{"$ref":"#/components/schemas/v1ValueType"},"title":"The possible value types in this union"}},"title":"Represents a union value type that can be one of several possible types"},"v1ValueSensitiveType":{"type":"object","properties":{"inner":{"$ref":"#/components/schemas/v1ValueType"}},"title":"Represents a value type that contains sensitive information"},"v1ValueEnumType":{"type":"object","properties":{"is_a":{"type":"string","title":"Semantic classification of what this enum represents"},"members":{"type":"array","items":{"$ref":"#/components/schemas/v1ValueEnumTypeMember"},"title":"The available options/members of this enum"},"description":{"type":"string","title":"Optional human-readable description of this enum type"}},"title":"Represents an enumeration value type with predefined options"},"v1ValueEnumTypeMember":{"type":"object","properties":{"name":{"type":"string","title":"The programmatic name of this enum member"},"description":{"type":"string","title":"Optional human-readable description of this enum member"}},"title":"Represents a single member/option within an enum value type"},"v1ValueGenericDictionaryType":{"type":"object","properties":{"key_type":{"$ref":"#/components/schemas/v1ValueType"},"value_type":{"$ref":"#/components/schemas/v1ValueType"}},"title":"Represent a generic dictionary that can hold any entry of a particular key and value type"},"v1ValueNoneType":{"type":"object","title":"Represents a none value type that can hold no value"},"v1TextConstraints":{"type":"object","properties":{"min_length":{"type":"integer","format":"int64","description":"Unicode scalar-value counts, not bytes or UTF-16 code units. No implicit\ntrimming, normalization, pattern evaluation or text transformation."},"max_length":{"type":"integer","format":"int64","description":"Inclusive maximum length, measured in Unicode scalar values."}},"description":"Length restrictions on a text answer."},"v1NumberConstraints":{"type":"object","properties":{"minimum":{"$ref":"#/components/schemas/v1Number"},"maximum":{"$ref":"#/components/schemas/v1Number"},"integer_only":{"type":"boolean","description":"Require a value with no fractional component."}},"description":"Exact decimal restrictions on a numeric answer."},"v1InputSpec":{"type":"object","properties":{"selection":{"$ref":"#/components/schemas/v1SelectionInput"}},"description":"How a person supplies a typed answer. Concrete controls and layout belong\nto the renderer. No option carries follow-up fields or executable behavior."},"v1SelectionInput":{"type":"object","properties":{"options":{"type":"array","items":{"$ref":"#/components/schemas/v1SelectionOption"},"description":"Distinct typed values with nonempty labels. May be empty. Each value must\nsatisfy the scalar/element type and applicable field constraints. Numeric\nequality is decimal equality, so 1 and 1.0 are the same option."},"min_selections":{"type":"integer","format":"int64","description":"Only for list fields. Omitted minimum means zero; omitted maximum means the\noption count. Bounds must be ordered and, for nonempty option sets, no greater\nthan that count. Empty selections retain bounds for answer validation.\nUnknown or repeated selections fail. Persist selections in option order,\nusing the declared option values, not user click order or numeric encoding."},"max_selections":{"type":"integer","format":"int64","description":"Inclusive maximum number of selected options."},"options_ref":{"type":"string","description":"Exact nonempty top-level WorkUnit.evidence key, not a path or expression.\nAllowed only in shared human input, mutually exclusive with inline options.\nValid evidence is an inline list of distinct scalar values matching\nthe field's scalar/element type and constraints. Inline text wrappers are\nnormalized to text. No remote reads, record projections or coercion occur.\nEach value is both the displayed choice and the submitted value: text is\nunchanged, numbers use exact decimal text, booleans use true/false, and dates\nuse YYYY-MM-DD. Empty text has no display label and is invalid as an option.\nMissing, empty or invalid choices produce an empty selection, not an input\nerror or free entry. Other fields remain usable. Initial values incompatible\nwith the resolved selection are omitted for that unit."}},"description":"A finite set of offered values. A scalar field selects one value; a list\nfield selects distinct values of its element type. Optional None is absence,\nnever an option. Use inline options or options_ref, not both. Empty selections\noffer no choices and never enable free entry. Resolved unit input and source\nanswer forms use inline options only."},"v1SelectionOption":{"type":"object","properties":{"label":{"type":"string","description":"Nonempty display wording, independent of the submitted value."},"value":{"$ref":"#/components/schemas/commonv1Value"}},"description":"Display wording and the typed value returned when this option is selected.","required":["label","value"]},"v1InputContext":{"type":"object","properties":{"form":{"$ref":"#/components/schemas/v1FormSpec"},"response":{"$ref":"#/components/schemas/v1InputResponse"}},"description":"A human-input form paired with its response.\n\nThe form preserves the meaning of values after form edits or membership changes."},"v1InputResponse":{"type":"object","properties":{"values":{"type":"object","additionalProperties":{"$ref":"#/components/schemas/commonv1Value"},"description":"Current values. Drafts may omit required fields, but supplied values must\nsatisfy the published form. Empty values clear the draft. Unknown keys fail.","readOnly":true},"etag":{"type":"string","description":"Opaque concurrency token. Changes on edits, acceptance, revocation and\nunarchive or form changes. Never reused after clearing a response or rekey.\nClients must return the token they actually read.","readOnly":true},"updated_by":{"type":"string","description":"Actor who last edited values. Empty for a newly created, untouched draft.","readOnly":true},"update_time":{"type":"string","format":"date-time","description":"Time of the latest draft or acceptance change.","readOnly":true},"accepted_by":{"type":"string","description":"Authenticated actor who explicitly accepted these values; empty if not\naccepted. User attribution does not distinguish a human from their agent.","readOnly":true},"accept_time":{"type":"string","format":"date-time","description":"Present only while acceptance is valid. Revoke acceptance before editing.\nForm edits, rekey and unarchive invalidate acceptance; final submission\nprevents editing.","readOnly":true}},"description":"Editable per-unit human input, with explicit acceptance separate from filling.\nAcceptance permits final-answer preparation; it is not a final submission."},"v1AnswerDraft":{"type":"object","properties":{"values":{"type":"object","additionalProperties":{"$ref":"#/components/schemas/commonv1Value"},"description":"Supplied fields must validate; required top-level fields may be omitted.\nSupplied structured values must be complete. Unknown keys fail.","readOnly":true},"etag":{"type":"string","description":"Concurrency token, present before the first save. Changes on saves.\nClearing values never reuses a token.","readOnly":true},"updated_by":{"type":"string","description":"Authenticated actor who last saved values; empty before the first save.","readOnly":true},"update_time":{"type":"string","format":"date-time","description":"Time of the latest save.","readOnly":true}},"description":"Partial final-answer values for one immutable source answer contract.\n\nSaving is optional and never accepts input or settles the unit."},"rpcStatus":{"type":"object","properties":{"code":{"type":"integer","format":"int32"},"message":{"type":"string"},"details":{"type":"array","items":{"$ref":"#/components/schemas/protobufAny"}}}},"protobufAny":{"type":"object","properties":{"@type":{"type":"string"}},"additionalProperties":{}},"WorkItemServiceSaveWorkUnitAnswerBody":{"type":"object","properties":{"values":{"type":"object","additionalProperties":{"$ref":"#/components/schemas/commonv1Value"},"description":"Complete replacement map; empty clears all values."},"etag":{"type":"string","description":"Current answer_draft.etag, including for the first save."}},"description":"SaveWorkUnitAnswerRequest replaces partial final-answer values.","required":["etag"]}}},"paths":{"/api/v1/organizations/{organization_id}/workspaces/{workspace_id}/workUnits/{work_unit_id}:saveAnswer":{"post":{"summary":"Save Work Unit Answer","description":"SaveWorkUnitAnswer replaces an optional final-answer draft. Required fields\nmay be omitted; supplied values validate against the unit's answer_form.\nEmpty values clear the draft. Requires the current answer_draft.etag;\nstale tokens return ABORTED. Settled units return FAILED_PRECONDITION.\nSaving changes neither status nor input acceptance and creates no delivery.","operationId":"SaveWorkUnitAnswer","responses":{"200":{"description":"A successful response.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/v1WorkUnit"}}}},"default":{"description":"An unexpected error response.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/rpcStatus"}}}}},"parameters":[{"name":"organization_id","in":"path","required":true,"schema":{"type":"string"}},{"name":"workspace_id","in":"path","required":true,"schema":{"type":"string"}},{"name":"work_unit_id","in":"path","required":true,"schema":{"type":"string"}}],"requestBody":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/WorkItemServiceSaveWorkUnitAnswerBody"}}},"required":true},"tags":["Work Items"]}}}}
```

## Save Work Unit Input

> SaveWorkUnitInput replaces the complete draft value map, not a final answer.\
> Requires a published item input\_form and matching response etag. Drafts may\
> omit required fields; supplied values must validate. Empty clears the draft.\
> Accepted input returns FAILED\_PRECONDITION, even when values are equal;\
> revoke acceptance before editing. Successful saves remain WAITING\_FOR\_INPUT.\
> No submission or delivery is created. Stale etags return ABORTED; an absent item\
> input\_form or settled units return FAILED\_PRECONDITION; invalid values return\
> INVALID\_ARGUMENT. Empty selections do not prevent saving other fields.\
> Validate against the unit's resolved input form under its current item lock.

```json
{"openapi":"3.0.0","info":{"title":"Kognitos API","version":"1.0.0"},"tags":[{"name":"Work Items","description":"Track work items and work units that need human input."}],"servers":[{"url":"https://app.us-1.kognitos.com"}],"security":[{"BearerAuth":[]}],"components":{"securitySchemes":{"BearerAuth":{"type":"http","scheme":"bearer","description":"Personal Access Token."}},"schemas":{"v1WorkUnit":{"type":"object","properties":{"name":{"type":"string","title":"The stable workspace-scoped resource name of the work unit.\nFormat: organizations/{organization_id}/workspaces/{workspace_id}/workUnits/{work_unit_id}"},"work_item":{"type":"string","description":"Current grouping membership in the same workspace. Rekey may change this reference without changing\nthe unit's name. Empty when the occurrence has no work item.","readOnly":true},"source_ref":{"type":"string","description":"The source's own id for this unit, combined with occurrence_id to identify one request\nfor attention within an organization, workspace and kind across history.\n\nThe source's shape rather than ours. Decisions also carry occurrence_id so a later request\nabout the same thing cannot consume an earlier answer. Not a label: no\nkind declares it and no grouping configuration names it."},"correlation_id":{"type":"string","description":"Source-owned correlation shared by related requests within this organization,\nworkspace and kind. Empty when none was supplied on first admission.\nImmutable; returned by Get and List and filterable through ListWorkUnits.\nIndependent of work-item grouping, occurrence identity and decision routing.","readOnly":true},"kind":{"type":"string","description":"The registered kind of work, as an opaque dotted id. See\nWorkItem.kind.","readOnly":true},"labels":{"type":"object","additionalProperties":{"type":"string"},"description":"The facts the source stated about this unit. The subset the workspace\ngroups on became its item's agg_labels, where a key the workspace groups\non that this unit does not carry became a null.","readOnly":true},"summary":{"type":"string","description":"One line about this unit in business language, as its source put it. The\nquestion, when this is the unit that materialised the item.\n\nImmutable for this occurrence, including before acceptance.","readOnly":true},"detail":{"type":"string","description":"Additional source-authored text describing this occurrence. Empty when omitted.\nImmutable for the occurrence; returned by GetWorkUnit and ListWorkUnits.","readOnly":true},"identifying_details":{"type":"array","items":{"$ref":"#/components/schemas/v1IdentifyingDetail"},"description":"Ordered identifying facts, immutable for this occurrence. Entries with a\nblank label or value are omitted. Clients fall back to summary, then the\nkind display name when empty; detail is supplementary context, not a heading.","readOnly":true},"evidence":{"type":"object","additionalProperties":{"$ref":"#/components/schemas/commonv1Value"},"description":"What a person reads to decide: the records and facts behind this unit,\nnamed and typed, so the platform renders it and the source ships no\nrendering (R6).\n\nImmutable for this occurrence. Changed decision context requires withdrawal\nand a new occurrence. Re-reports never overwrite this evidence.\n\nReturned by both GetWorkUnit and ListWorkUnits.","readOnly":true},"status":{"$ref":"#/components/schemas/v1WorkUnitStatus"},"delivery":{"$ref":"#/components/schemas/v1EffectDelivery"},"settle_time":{"type":"string","format":"date-time","description":"When attention ended for this occurrence: answer, dismissal or withdrawal.","readOnly":true},"create_time":{"type":"string","format":"date-time","description":"The time this unit was first seen.","readOnly":true},"update_time":{"type":"string","format":"date-time","description":"The time this unit last changed, including by a source's re-report.","readOnly":true},"occurrence_id":{"type":"string","description":"The source's immutable identifier for this particular request for attention.\nRe-reports reuse it; a new request uses a new one even for the same source_ref.","readOnly":true},"previous_delivery":{"type":"string","description":"Earlier delivery whose rejection or later execution raised this question.\nEmpty for ordinary arrivals. Exposes follow-up provenance to the surface.","readOnly":true},"submission":{"type":"string","description":"The sole accepted final submission, or empty while no answer is recorded.","readOnly":true},"answer_form":{"$ref":"#/components/schemas/v1FormSpec"},"input":{"$ref":"#/components/schemas/v1InputContext"},"answer_draft":{"$ref":"#/components/schemas/v1AnswerDraft"},"revision":{"type":"string","format":"int64","description":"Monotonically increasing version of this resource's mutable state,\nincluding resolved input and embedded delivery. Compare only versions of\nthe same resource. Independent of mutation etags.","readOnly":true}},"description":"WorkUnit is one real-world thing needing attention, as its source reported\nit: a run that failed, a record that was flagged, an automation waiting on a\nvalue.\n\nThe workspace is the resource parent. The name remains stable across rekey;\nwork_item records grouping membership rather than resource parentage.\nA source reports occurrences without naming an item or asserting grouping."},"v1IdentifyingDetail":{"type":"object","properties":{"label":{"type":"string","description":"Business-facing label, for example \"Invoice\"."},"value":{"type":"string","description":"Nonempty display fallback, for example \"INV-1042\" or \"invoice.pdf\"."},"evidence_ref":{"type":"string","description":"Optional exact top-level key in the same work unit's evidence map.\nThis is neither a resource URI nor an expression. Readers use value when\nabsent, unresolved or unavailable; an invalid reference never rejects work."}},"description":"A source-authored identifying fact for a unit's compact heading.\nDisplayed in source order, with optional access to frozen evidence."},"commonv1Value":{"type":"object","properties":{"null_value":{"type":"string","title":"Represents the absence of a value (None/null/undefined)"},"bool_value":{"type":"boolean","title":"Boolean true/false value"},"number":{"$ref":"#/components/schemas/v1Number"},"text":{"type":"string","title":"UTF-8 encoded text string"},"date":{"$ref":"#/components/schemas/typeDate"},"timeofday":{"$ref":"#/components/schemas/typeTimeOfDay"},"datetime":{"$ref":"#/components/schemas/typeDateTime"},"time_zone":{"$ref":"#/components/schemas/typeTimeZone"},"duration":{"type":"string","title":"Signed duration representing a span of time"},"list":{"$ref":"#/components/schemas/v1List"},"dictionary":{"$ref":"#/components/schemas/v1Dictionary"},"file":{"$ref":"#/components/schemas/v1FileValue"},"table":{"$ref":"#/components/schemas/v1TableValue"},"set":{"$ref":"#/components/schemas/v1Set"},"text_value":{"$ref":"#/components/schemas/v1TextValue"},"list_value":{"$ref":"#/components/schemas/commonv1ListValue"},"set_value":{"$ref":"#/components/schemas/v1SetValue"},"dictionary_value":{"$ref":"#/components/schemas/v1DictionaryValue"}},"description":"Represents a runtime value that can be produced by the Jarvis interpreter.\n\nThis message provides a type-safe way to serialize and transmit values between\nthe Jarvis interpreter and other services via gRPC. It supports all the basic\ndata types that can be represented in the Jarvis language runtime.\n\nThe oneof structure ensures that exactly one value type is set at a time,\nproviding both type safety and efficient serialization."},"v1Number":{"type":"object","properties":{"lo":{"type":"integer","format":"int64","description":"Low 32 bits of the 96-bit mantissa."},"mid":{"type":"integer","format":"int64","description":"Middle 32 bits of the 96-bit mantissa."},"hi":{"type":"integer","format":"int64","description":"High 32 bits of the 96-bit mantissa."},"flags":{"type":"integer","format":"int64","description":"Flags word:\n - Bits 16–23: scale (0–28)\n - Bit 31: sign (0 = positive, 1 = negative)\n - Other bits must be zero."}},"description":"A fixed-precision decimal number with up to 28 fractional digits.\n\nThis message represents decimal numbers with exact precision, avoiding\nfloating-point rounding errors. It's particularly useful for financial\ncalculations, measurements, and any scenario where exact decimal\nrepresentation is required.\n\nThe value is calculated as: m / 10^e, where:\n - m is an unsigned 96-bit integer composed of (lo, mid, hi)\n - e is the scale (0–28) stored in flags bits 16–23\n - sign is encoded in flags bit 31 (0 = positive, 1 = negative)\n\nExamples:\n - 123.45 would have m=12345, e=2\n - -0.001 would have m=1, e=3, with sign bit set\n"},"typeDate":{"type":"object","properties":{"year":{"type":"integer","format":"int32","description":"Year of the date. Must be from 1 to 9999, or 0 to specify a date without\na year."},"month":{"type":"integer","format":"int32","description":"Month of a year. Must be from 1 to 12, or 0 to specify a year without a\nmonth and day."},"day":{"type":"integer","format":"int32","description":"Day of a month. Must be from 1 to 31 and valid for the year and month, or 0\nto specify a year by itself or a year and month where the day isn't\nsignificant."}},"description":"* A full date, with non-zero year, month, and day values\n* A month and day value, with a zero year, such as an anniversary\n* A year on its own, with zero month and day values\n* A year and month value, with a zero day, such as a credit card expiration\ndate\n\nRelated types are [google.type.TimeOfDay][google.type.TimeOfDay] and\n`google.protobuf.Timestamp`.","title":"Represents a whole or partial calendar date, such as a birthday. The time of\nday and time zone are either specified elsewhere or are insignificant. The\ndate is relative to the Gregorian Calendar. This can represent one of the\nfollowing:"},"typeTimeOfDay":{"type":"object","properties":{"hours":{"type":"integer","format":"int32","description":"Hours of day in 24 hour format. Should be from 0 to 23. An API may choose\nto allow the value \"24:00:00\" for scenarios like business closing time."},"minutes":{"type":"integer","format":"int32","description":"Minutes of hour of day. Must be from 0 to 59."},"seconds":{"type":"integer","format":"int32","description":"Seconds of minutes of the time. Must normally be from 0 to 59. An API may\nallow the value 60 if it allows leap-seconds."},"nanos":{"type":"integer","format":"int32","description":"Fractions of seconds in nanoseconds. Must be from 0 to 999,999,999."}},"description":"Represents a time of day. The date and time zone are either not significant\nor are specified elsewhere. An API may choose to allow leap seconds. Related\ntypes are [google.type.Date][google.type.Date] and\n`google.protobuf.Timestamp`."},"typeDateTime":{"type":"object","properties":{"year":{"type":"integer","format":"int32","description":"Optional. Year of date. Must be from 1 to 9999, or 0 if specifying a\ndatetime without a year."},"month":{"type":"integer","format":"int32","description":"Required. Month of year. Must be from 1 to 12."},"day":{"type":"integer","format":"int32","description":"Required. Day of month. Must be from 1 to 31 and valid for the year and\nmonth."},"hours":{"type":"integer","format":"int32","description":"Required. Hours of day in 24 hour format. Should be from 0 to 23. An API\nmay choose to allow the value \"24:00:00\" for scenarios like business\nclosing time."},"minutes":{"type":"integer","format":"int32","description":"Required. Minutes of hour of day. Must be from 0 to 59."},"seconds":{"type":"integer","format":"int32","description":"Required. Seconds of minutes of the time. Must normally be from 0 to 59. An\nAPI may allow the value 60 if it allows leap-seconds."},"nanos":{"type":"integer","format":"int32","description":"Required. Fractions of seconds in nanoseconds. Must be from 0 to\n999,999,999."},"utc_offset":{"type":"string","description":"UTC offset. Must be whole seconds, between -18 hours and +18 hours.\nFor example, a UTC offset of -4:00 would be represented as\n{ seconds: -14400 }."},"time_zone":{"$ref":"#/components/schemas/typeTimeZone"}},"description":"Represents civil time (or occasionally physical time).\n\nThis type can represent a civil time in one of a few possible ways:\n\n * When utc_offset is set and time_zone is unset: a civil time on a calendar\n   day with a particular offset from UTC.\n * When time_zone is set and utc_offset is unset: a civil time on a calendar\n   day in a particular time zone.\n * When neither time_zone nor utc_offset is set: a civil time on a calendar\n   day in local time.\n\nThe date is relative to the Proleptic Gregorian Calendar.\n\nIf year is 0, the DateTime is considered not to have a specific year. month\nand day must have valid, non-zero values.\n\nThis type may also be used to represent a physical time if all the date and\ntime fields are set and either case of the `time_offset` oneof is set.\nConsider using `Timestamp` message for physical time instead. If your use\ncase also would like to store the user's timezone, that can be done in\nanother field.\n\nThis type is more flexible than some applications may want. Make sure to\ndocument and validate your application's limitations."},"typeTimeZone":{"type":"object","properties":{"id":{"type":"string","description":"IANA Time Zone Database time zone, e.g. \"America/New_York\"."},"version":{"type":"string","description":"Optional. IANA Time Zone Database version number, e.g. \"2019a\"."}},"description":"Represents a time zone from the\n[IANA Time Zone Database](https://www.iana.org/time-zones)."},"v1List":{"type":"object","properties":{"items":{"type":"array","items":{"$ref":"#/components/schemas/commonV1Value"},"title":"The ordered sequence of values in this list"}},"description":"Represents an ordered collection of values (similar to arrays or lists).\n\nThis message can contain any number of Value elements in a specific order.\nLists are mutable and can grow or shrink during runtime. Elements can be\naccessed by their zero-based index position.\n\nExamples:\n - [1, 2, 3] - list of numbers\n - [\"hello\", \"world\"] - list of strings\n - [true, 42, \"mixed\"] - list with mixed types\n - [[1, 2], [3, 4]] - nested lists"},"commonV1Value":{"type":"object","properties":{"null_value":{"type":"string","title":"Represents the absence of a value (None/null/undefined)"},"bool_value":{"type":"boolean","title":"Boolean true/false value"},"number":{"$ref":"#/components/schemas/v1Number"},"text":{"type":"string","title":"UTF-8 encoded text string"},"date":{"$ref":"#/components/schemas/typeDate"},"timeofday":{"$ref":"#/components/schemas/typeTimeOfDay"},"datetime":{"$ref":"#/components/schemas/typeDateTime"},"time_zone":{"$ref":"#/components/schemas/typeTimeZone"},"duration":{"type":"string","title":"Signed duration representing a span of time"},"list":{"$ref":"#/components/schemas/v1List"},"dictionary":{"$ref":"#/components/schemas/v1Dictionary"},"file":{"$ref":"#/components/schemas/v1FileValue"},"table":{"$ref":"#/components/schemas/v1TableValue"},"set":{"$ref":"#/components/schemas/v1Set"},"text_value":{"$ref":"#/components/schemas/v1TextValue"},"list_value":{"$ref":"#/components/schemas/commonv1ListValue"},"set_value":{"$ref":"#/components/schemas/v1SetValue"},"dictionary_value":{"$ref":"#/components/schemas/v1DictionaryValue"}},"description":"Represents a runtime value that can be produced by the Jarvis interpreter.\n\nThis message provides a type-safe way to serialize and transmit values between\nthe Jarvis interpreter and other services via gRPC. It supports all the basic\ndata types that can be represented in the Jarvis language runtime.\n\nThe oneof structure ensures that exactly one value type is set at a time,\nproviding both type safety and efficient serialization."},"v1Dictionary":{"type":"object","properties":{"entries":{"type":"array","items":{"$ref":"#/components/schemas/v1DictionaryEntry"},"title":"The key-value pairs stored in this dictionary"}},"description":"Represents a key-value mapping (similar to hash maps or dictionaries).\n\nThis message stores associations between keys and values, where keys must be\nhashable types (null, bool, Number, string, Date, TimeOfDay, DateTime, TimeZone). Keys are\nunique within a dictionary - duplicate keys will overwrite previous values.\n\nThe dictionary maintains insertion order for consistent iteration behavior.\n\nExamples:\n - {\"name\": \"John\", \"age\": 30} - string keys with mixed values\n - {1: \"one\", 2: \"two\"} - number keys with string values\n - {\"nested\": {\"inner\": \"value\"}} - nested dictionaries"},"v1DictionaryEntry":{"type":"object","properties":{"key":{"$ref":"#/components/schemas/v1HashableValue"},"value":{"$ref":"#/components/schemas/commonV1Value"}},"description":"Represents a single key-value pair within a Dictionary.\n\nBoth key and value can be any Value type, though keys should be\nhashable types for proper dictionary behavior. Non-hashable keys\n(like lists or dictionaries) may cause runtime errors."},"v1HashableValue":{"type":"object","properties":{"bool_value":{"type":"boolean","title":"Boolean true/false value"},"number":{"$ref":"#/components/schemas/v1Number"},"text":{"type":"string","title":"UTF-8 encoded text string"},"date":{"$ref":"#/components/schemas/typeDate"},"timeofday":{"$ref":"#/components/schemas/typeTimeOfDay"},"datetime":{"$ref":"#/components/schemas/typeDateTime"},"duration":{"type":"string","title":"Signed duration representing a span of time"},"text_value":{"$ref":"#/components/schemas/v1TextValue"}},"description":"Represents a hashable value that can be used as a dictionary key.\n\nThis message contains only the hashable types from the Value message,\ncorresponding to Python's hashable types. These types can be safely\nused as keys in maps and dictionaries.\n\nHashable types include: bool, Number, string, Date, TimeOfDay, DateTime\nand Duration."},"v1TextValue":{"type":"object","properties":{"remote":{"type":"string","title":"Reference to remote text content via URL or file path"},"inline":{"type":"string","title":"Text content embedded directly in the message"}},"description":"Represents a text value that can be either stored inline or referenced remotely.\n\nThis message provides flexibility for handling text strings in the Jarvis interpreter:\n- Small strings can be embedded directly using the inline option\n- Large strings can be referenced by URL using the remote option\n- The choice depends on string size, network constraints, and access patterns"},"v1FileValue":{"type":"object","properties":{"remote":{"type":"string","title":"Reference to a remote file via URL or file path"},"inline":{"$ref":"#/components/schemas/v1File"}},"description":"Represents a file value that can be either stored inline or referenced remotely.\n\nThis message provides flexibility for handling files in the Jarvis interpreter:\n- Small files can be embedded directly using the inline option\n- Large files can be referenced by URL/path using the remote option\n- The choice depends on file size, network constraints, and access patterns"},"v1File":{"type":"object","properties":{"content":{"type":"string","format":"byte","title":"The raw binary content of the file"},"name":{"type":"string","title":"The name of the file, including extension if applicable"}},"description":"Represents a file with its name and binary content.\n\nThis message contains the complete file data including both metadata\n(filename) and the actual file content as raw bytes. It's used for\nembedding files directly within messages when the file size is\nmanageable and immediate access is required.\n\nExamples:\n - Configuration files\n - Small text or binary files\n - Generated reports or documents\n - Temporary files created during execution\n"},"v1TableValue":{"type":"object","properties":{"remote":{"type":"string","title":"Reference to a remote table via URL or file path (feather-v2 format)"},"inline":{"$ref":"#/components/schemas/v1Table"}},"description":"Represents a table value that can be either stored inline or referenced remotely."},"v1Table":{"type":"object","properties":{"data":{"type":"string","format":"byte","title":"The table data serialized in feather-v2 format"}},"description":"Represents a table with data in feather-v2 format.\n\nThis message contains the complete table data serialized using the\nfeather-v2 format, which provides efficient columnar storage and\nfast serialization/deserialization for tabular data."},"v1Set":{"type":"object","properties":{"items":{"type":"array","items":{"$ref":"#/components/schemas/v1HashableValue"},"title":"The unique elements stored in this set\nAll elements must be hashable types"}},"description":"Represents an unordered collection of unique values.\n\nThis message stores a collection of unique elements, where duplicate values\nare automatically removed. Only hashable types can be stored in sets.\nSets are useful for membership testing, removing duplicates, and mathematical\nset operations like union, intersection, and difference.\n\nThe set does not maintain insertion order - elements may appear in any order\nduring iteration.\n\nExamples:\n - {1, 2, 3} - set of numbers\n - {\"apple\", \"banana\", \"cherry\"} - set of strings\n - {true, false} - set of booleans\n - {1, \"hello\", true} - set with mixed hashable types"},"commonv1ListValue":{"type":"object","properties":{"remote":{"type":"string","title":"Reference to remote list data via URL or file path"},"inline":{"$ref":"#/components/schemas/v1List"}},"description":"Represents a list value that can be either stored inline or referenced remotely.\n\nThis message provides flexibility for handling large lists:\n- Small lists can be embedded directly using the inline option\n- Large lists can be referenced by URL using the remote option"},"v1SetValue":{"type":"object","properties":{"remote":{"type":"string","title":"Reference to remote set data via URL or file path"},"inline":{"$ref":"#/components/schemas/v1Set"}},"description":"Represents a set value that can be either stored inline or referenced remotely.\n\nThis message provides flexibility for handling large sets:\n- Small sets can be embedded directly using the inline option\n- Large sets can be referenced by URL using the remote option"},"v1DictionaryValue":{"type":"object","properties":{"remote":{"type":"string","title":"Reference to remote dictionary data via URL or file path"},"inline":{"$ref":"#/components/schemas/v1Dictionary"}},"description":"Represents a dictionary value that can be either stored inline or referenced remotely.\n\nThis message provides flexibility for handling large dictionaries:\n- Small dictionaries can be embedded directly using the inline option\n- Large dictionaries can be referenced by URL using the remote option"},"v1WorkUnitStatus":{"type":"string","enum":["WORK_UNIT_STATUS_UNSPECIFIED","WORK_UNIT_STATUS_WAITING_FOR_INPUT","WORK_UNIT_STATUS_ANSWERED","WORK_UNIT_STATUS_DISMISSED","WORK_UNIT_STATUS_WITHDRAWN","WORK_UNIT_STATUS_PROCESSING"],"default":"WORK_UNIT_STATUS_UNSPECIFIED","description":"WorkUnitStatus records attention and final resolution independently of delivery.\n\n - WORK_UNIT_STATUS_UNSPECIFIED: Default value; not returned for an existing resource.\n - WORK_UNIT_STATUS_WAITING_FOR_INPUT: Waiting for intermediate input or a direct final answer: an item input_form\nexists and input is unaccepted, or no input_form exists and the kind does\nnot require preparation. Saving either draft leaves status unchanged.\n - WORK_UNIT_STATUS_ANSWERED: Final submission and its delivery obligation are durable.\n - WORK_UNIT_STATUS_DISMISSED: Locally dismissed by item archival, arrival or rekey into an archived item.\nUnarchive restores it unless the source or operator has withdrawn it.\n - WORK_UNIT_STATUS_WITHDRAWN: Source or operator ended the occurrence without an answer.\n - WORK_UNIT_STATUS_PROCESSING: Analysis or decision preparation is pending; no current human request.\nIncludes work without an input_form whose kind requires preparation, and\nfinal-answer preparation after intermediate input acceptance."},"v1EffectDelivery":{"type":"object","properties":{"name":{"type":"string","description":"Resource name; the final segment is the dispatch_id given to the source."},"work_unit":{"type":"string","description":"The unit whose decision this delivers.","readOnly":true},"submission":{"type":"string","description":"The final submission this delivers; always present.","readOnly":true},"attempt_count":{"type":"integer","format":"int32","description":"Count of publish attempts across automatic and operator retry cycles.","readOnly":true},"publish_time":{"type":"string","format":"date-time","description":"First successful broker acknowledgement. Absent before publication.","readOnly":true},"result_time":{"type":"string","format":"date-time","description":"Time Workbench durably received a terminal source result.","readOnly":true},"outcome":{"$ref":"#/components/schemas/v1DecisionOutcome"},"rejection_reason":{"type":"string","description":"Source rejection reason, present only for REJECTED.","readOnly":true},"confirmation_deadline":{"type":"string","format":"date-time","description":"Fixed at first successful publication. Passing this time without a result\nmeans confirmation overdue, never that delivery or application failed.","readOnly":true},"attention_required_time":{"type":"string","format":"date-time","description":"When automatic retries stopped pending operator attention. A late result\nremains admissible. This is not a terminal source result.","readOnly":true},"last_error":{"type":"string","description":"Business-safe operational diagnostic, distinct from a source rejection.\nNo traceback, internal identifier or resource name; richer detail is logged.","readOnly":true}},"description":"EffectDelivery is the durable obligation to deliver one decision to one unit.\nA source result is independent of publication and of unit settlement."},"v1DecisionOutcome":{"type":"string","enum":["DECISION_OUTCOME_UNSPECIFIED","DECISION_OUTCOME_APPLIED","DECISION_OUTCOME_REJECTED"],"default":"DECISION_OUTCOME_UNSPECIFIED","description":"DecisionOutcome is a source's terminal result for a specific dispatch.\n\n - DECISION_OUTCOME_UNSPECIFIED: Not a terminal result; callers must select an outcome.\n - DECISION_OUTCOME_APPLIED: The requested action was committed or durably scheduled by the source.\nThis does not assert that the downstream workflow succeeded.\n - DECISION_OUTCOME_REJECTED: The source definitively refused the decision. A reason is required."},"v1FormSpec":{"type":"object","properties":{"fields":{"type":"array","items":{"$ref":"#/components/schemas/v1FormField"},"description":"At least one question, with unique nonempty keys. Order is the semantic\nreading sequence, not a prescribed screen layout."}},"description":"A set of typed questions for human input or source answers (R6, R13, R14).\nField types derive the returned record type. The platform selects controls\nand layout; there are no widgets, scripts, URLs, or executable expressions.\nShared human input may reference options in each unit's immutable evidence.\nWorkbench resolves those references into the unit's InputContext before use.\nSource answer forms must already be resolved. Filled values are separate messages.\nSources persist their answer form with the pending invocation for recovery.","required":["fields"]},"v1FormField":{"type":"object","properties":{"key":{"type":"string","description":"Stable record key. Unique within its field set; nonempty."},"label":{"type":"string","description":"Business-facing wording, independent of the programmatic key; nonempty."},"help_text":{"type":"string","description":"Optional guidance displayed with the question."},"value_type":{"$ref":"#/components/schemas/v1ValueType"},"initial_value":{"$ref":"#/components/schemas/commonv1Value"},"text":{"$ref":"#/components/schemas/v1TextConstraints"},"number":{"$ref":"#/components/schemas/v1NumberConstraints"},"input_spec":{"$ref":"#/components/schemas/v1InputSpec"}},"description":"One named question, its answer type and its input behavior.","required":["key","label","value_type"]},"v1ValueType":{"type":"object","properties":{"scalar_type":{"$ref":"#/components/schemas/v1ValueScalarType"},"optional_type":{"$ref":"#/components/schemas/v1ValueOptionalType"},"list_type":{"$ref":"#/components/schemas/v1ValueListType"},"dictionary_type":{"$ref":"#/components/schemas/v1ValueDictionaryType"},"table_type":{"$ref":"#/components/schemas/v1ValueTableType"},"opaque_type":{"$ref":"#/components/schemas/v1ValueOpaqueType"},"any_type":{"$ref":"#/components/schemas/v1ValueAnyType"},"union_type":{"$ref":"#/components/schemas/v1ValueUnionType"},"sensitive_type":{"$ref":"#/components/schemas/v1ValueSensitiveType"},"enum_type":{"$ref":"#/components/schemas/v1ValueEnumType"},"generic_dictionary_type":{"$ref":"#/components/schemas/v1ValueGenericDictionaryType"},"none_type":{"$ref":"#/components/schemas/v1ValueNoneType"}},"title":"Represents a complete value type definition using a discriminated union"},"v1ValueScalarType":{"type":"string","enum":["VALUE_SCALAR_TYPE_UNSPECIFIED","VALUE_SCALAR_TYPE_TEXT","VALUE_SCALAR_TYPE_NUMBER","VALUE_SCALAR_TYPE_BOOLEAN","VALUE_SCALAR_TYPE_DATETIME","VALUE_SCALAR_TYPE_DATE","VALUE_SCALAR_TYPE_TIME","VALUE_SCALAR_TYPE_FILE","VALUE_SCALAR_TYPE_TIMEDELTA"],"default":"VALUE_SCALAR_TYPE_UNSPECIFIED","description":"- VALUE_SCALAR_TYPE_UNSPECIFIED: Unspecified value type\n - VALUE_SCALAR_TYPE_TEXT: A text value type\n - VALUE_SCALAR_TYPE_NUMBER: A number value type\n - VALUE_SCALAR_TYPE_BOOLEAN: A boolean value type\n - VALUE_SCALAR_TYPE_DATETIME: A datetime value type\n - VALUE_SCALAR_TYPE_DATE: A date value type\n - VALUE_SCALAR_TYPE_TIME: A time value type\n - VALUE_SCALAR_TYPE_FILE: A file value type\n - VALUE_SCALAR_TYPE_TIMEDELTA: A timedelta value type","title":"Supported Value Scalar Types"},"v1ValueOptionalType":{"type":"object","properties":{"inner":{"$ref":"#/components/schemas/v1ValueType"}},"title":"Represents a value type that can be optional (nullable)"},"v1ValueListType":{"type":"object","properties":{"inner":{"$ref":"#/components/schemas/v1ValueType"}},"title":"Represents a list/array value type containing elements of a specific type"},"v1ValueDictionaryType":{"type":"object","properties":{"is_a":{"type":"string","title":"Semantic classification of what this dictionary represents"},"fields":{"type":"array","items":{"$ref":"#/components/schemas/v1ValueDictionaryTypeField"},"title":"The named fields contained in this dictionary"},"description":{"type":"string","title":"Optional human-readable description of this dictionary type"}},"title":"Represents a dictionary/object value type with named fields"},"v1ValueDictionaryTypeField":{"type":"object","properties":{"key":{"type":"string","title":"The name/key of this field"},"value":{"$ref":"#/components/schemas/v1ValueType"},"description":{"type":"string","title":"Optional human-readable description of this field"}},"title":"Represents a single field within a dictionary value type"},"v1ValueTableType":{"type":"object","properties":{"is_a":{"type":"string","title":"Semantic classification of what this table represents"},"columns":{"type":"array","items":{"$ref":"#/components/schemas/v1ValueTableTypeColumn"},"title":"The columns that make up this table"},"description":{"type":"string","title":"Optional human-readable description of this table type"}},"title":"Represents a table value type with structured columns"},"v1ValueTableTypeColumn":{"type":"object","properties":{"key":{"type":"string","title":"The name/key of this column"},"value":{"$ref":"#/components/schemas/v1ValueType"},"description":{"type":"string","title":"Optional human-readable description of this column"}},"title":"Represents a single column within a table value type"},"v1ValueOpaqueType":{"type":"object","properties":{"is_a":{"type":"string","title":"Semantic classification of what this opaque type represents"},"description":{"type":"string","title":"Optional human-readable description of this opaque type"}},"title":"Represents an opaque value type with semantic meaning but unknown internal structure"},"v1ValueAnyType":{"type":"object","title":"Represents a value type that can hold any kind of value"},"v1ValueUnionType":{"type":"object","properties":{"inners":{"type":"array","items":{"$ref":"#/components/schemas/v1ValueType"},"title":"The possible value types in this union"}},"title":"Represents a union value type that can be one of several possible types"},"v1ValueSensitiveType":{"type":"object","properties":{"inner":{"$ref":"#/components/schemas/v1ValueType"}},"title":"Represents a value type that contains sensitive information"},"v1ValueEnumType":{"type":"object","properties":{"is_a":{"type":"string","title":"Semantic classification of what this enum represents"},"members":{"type":"array","items":{"$ref":"#/components/schemas/v1ValueEnumTypeMember"},"title":"The available options/members of this enum"},"description":{"type":"string","title":"Optional human-readable description of this enum type"}},"title":"Represents an enumeration value type with predefined options"},"v1ValueEnumTypeMember":{"type":"object","properties":{"name":{"type":"string","title":"The programmatic name of this enum member"},"description":{"type":"string","title":"Optional human-readable description of this enum member"}},"title":"Represents a single member/option within an enum value type"},"v1ValueGenericDictionaryType":{"type":"object","properties":{"key_type":{"$ref":"#/components/schemas/v1ValueType"},"value_type":{"$ref":"#/components/schemas/v1ValueType"}},"title":"Represent a generic dictionary that can hold any entry of a particular key and value type"},"v1ValueNoneType":{"type":"object","title":"Represents a none value type that can hold no value"},"v1TextConstraints":{"type":"object","properties":{"min_length":{"type":"integer","format":"int64","description":"Unicode scalar-value counts, not bytes or UTF-16 code units. No implicit\ntrimming, normalization, pattern evaluation or text transformation."},"max_length":{"type":"integer","format":"int64","description":"Inclusive maximum length, measured in Unicode scalar values."}},"description":"Length restrictions on a text answer."},"v1NumberConstraints":{"type":"object","properties":{"minimum":{"$ref":"#/components/schemas/v1Number"},"maximum":{"$ref":"#/components/schemas/v1Number"},"integer_only":{"type":"boolean","description":"Require a value with no fractional component."}},"description":"Exact decimal restrictions on a numeric answer."},"v1InputSpec":{"type":"object","properties":{"selection":{"$ref":"#/components/schemas/v1SelectionInput"}},"description":"How a person supplies a typed answer. Concrete controls and layout belong\nto the renderer. No option carries follow-up fields or executable behavior."},"v1SelectionInput":{"type":"object","properties":{"options":{"type":"array","items":{"$ref":"#/components/schemas/v1SelectionOption"},"description":"Distinct typed values with nonempty labels. May be empty. Each value must\nsatisfy the scalar/element type and applicable field constraints. Numeric\nequality is decimal equality, so 1 and 1.0 are the same option."},"min_selections":{"type":"integer","format":"int64","description":"Only for list fields. Omitted minimum means zero; omitted maximum means the\noption count. Bounds must be ordered and, for nonempty option sets, no greater\nthan that count. Empty selections retain bounds for answer validation.\nUnknown or repeated selections fail. Persist selections in option order,\nusing the declared option values, not user click order or numeric encoding."},"max_selections":{"type":"integer","format":"int64","description":"Inclusive maximum number of selected options."},"options_ref":{"type":"string","description":"Exact nonempty top-level WorkUnit.evidence key, not a path or expression.\nAllowed only in shared human input, mutually exclusive with inline options.\nValid evidence is an inline list of distinct scalar values matching\nthe field's scalar/element type and constraints. Inline text wrappers are\nnormalized to text. No remote reads, record projections or coercion occur.\nEach value is both the displayed choice and the submitted value: text is\nunchanged, numbers use exact decimal text, booleans use true/false, and dates\nuse YYYY-MM-DD. Empty text has no display label and is invalid as an option.\nMissing, empty or invalid choices produce an empty selection, not an input\nerror or free entry. Other fields remain usable. Initial values incompatible\nwith the resolved selection are omitted for that unit."}},"description":"A finite set of offered values. A scalar field selects one value; a list\nfield selects distinct values of its element type. Optional None is absence,\nnever an option. Use inline options or options_ref, not both. Empty selections\noffer no choices and never enable free entry. Resolved unit input and source\nanswer forms use inline options only."},"v1SelectionOption":{"type":"object","properties":{"label":{"type":"string","description":"Nonempty display wording, independent of the submitted value."},"value":{"$ref":"#/components/schemas/commonv1Value"}},"description":"Display wording and the typed value returned when this option is selected.","required":["label","value"]},"v1InputContext":{"type":"object","properties":{"form":{"$ref":"#/components/schemas/v1FormSpec"},"response":{"$ref":"#/components/schemas/v1InputResponse"}},"description":"A human-input form paired with its response.\n\nThe form preserves the meaning of values after form edits or membership changes."},"v1InputResponse":{"type":"object","properties":{"values":{"type":"object","additionalProperties":{"$ref":"#/components/schemas/commonv1Value"},"description":"Current values. Drafts may omit required fields, but supplied values must\nsatisfy the published form. Empty values clear the draft. Unknown keys fail.","readOnly":true},"etag":{"type":"string","description":"Opaque concurrency token. Changes on edits, acceptance, revocation and\nunarchive or form changes. Never reused after clearing a response or rekey.\nClients must return the token they actually read.","readOnly":true},"updated_by":{"type":"string","description":"Actor who last edited values. Empty for a newly created, untouched draft.","readOnly":true},"update_time":{"type":"string","format":"date-time","description":"Time of the latest draft or acceptance change.","readOnly":true},"accepted_by":{"type":"string","description":"Authenticated actor who explicitly accepted these values; empty if not\naccepted. User attribution does not distinguish a human from their agent.","readOnly":true},"accept_time":{"type":"string","format":"date-time","description":"Present only while acceptance is valid. Revoke acceptance before editing.\nForm edits, rekey and unarchive invalidate acceptance; final submission\nprevents editing.","readOnly":true}},"description":"Editable per-unit human input, with explicit acceptance separate from filling.\nAcceptance permits final-answer preparation; it is not a final submission."},"v1AnswerDraft":{"type":"object","properties":{"values":{"type":"object","additionalProperties":{"$ref":"#/components/schemas/commonv1Value"},"description":"Supplied fields must validate; required top-level fields may be omitted.\nSupplied structured values must be complete. Unknown keys fail.","readOnly":true},"etag":{"type":"string","description":"Concurrency token, present before the first save. Changes on saves.\nClearing values never reuses a token.","readOnly":true},"updated_by":{"type":"string","description":"Authenticated actor who last saved values; empty before the first save.","readOnly":true},"update_time":{"type":"string","format":"date-time","description":"Time of the latest save.","readOnly":true}},"description":"Partial final-answer values for one immutable source answer contract.\n\nSaving is optional and never accepts input or settles the unit."},"rpcStatus":{"type":"object","properties":{"code":{"type":"integer","format":"int32"},"message":{"type":"string"},"details":{"type":"array","items":{"$ref":"#/components/schemas/protobufAny"}}}},"protobufAny":{"type":"object","properties":{"@type":{"type":"string"}},"additionalProperties":{}},"WorkItemServiceSaveWorkUnitInputBody":{"type":"object","properties":{"values":{"type":"object","additionalProperties":{"$ref":"#/components/schemas/commonv1Value"},"description":"Complete replacement map. Omitted keys are removed; empty clears all values."},"etag":{"type":"string","description":"The input.response.etag read by the caller, never an item or form revision."}},"description":"SaveWorkUnitInputRequest replaces a unit's draft values under an etag check.","required":["etag"]}}},"paths":{"/api/v1/organizations/{organization_id}/workspaces/{workspace_id}/workUnits/{work_unit_id}:saveInput":{"post":{"summary":"Save Work Unit Input","description":"SaveWorkUnitInput replaces the complete draft value map, not a final answer.\nRequires a published item input_form and matching response etag. Drafts may\nomit required fields; supplied values must validate. Empty clears the draft.\nAccepted input returns FAILED_PRECONDITION, even when values are equal;\nrevoke acceptance before editing. Successful saves remain WAITING_FOR_INPUT.\nNo submission or delivery is created. Stale etags return ABORTED; an absent item\ninput_form or settled units return FAILED_PRECONDITION; invalid values return\nINVALID_ARGUMENT. Empty selections do not prevent saving other fields.\nValidate against the unit's resolved input form under its current item lock.","operationId":"SaveWorkUnitInput","responses":{"200":{"description":"A successful response.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/v1WorkUnit"}}}},"default":{"description":"An unexpected error response.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/rpcStatus"}}}}},"parameters":[{"name":"organization_id","in":"path","required":true,"schema":{"type":"string"}},{"name":"workspace_id","in":"path","required":true,"schema":{"type":"string"}},{"name":"work_unit_id","in":"path","required":true,"schema":{"type":"string"}}],"requestBody":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/WorkItemServiceSaveWorkUnitInputBody"}}},"required":true},"tags":["Work Items"]}}}}
```

## Subscribe Work Units

> Subscribe to units entering, changing within or leaving one item.\
> Status is never filtered: answered, dismissed and withdrawn updates are included.

```json
{"openapi":"3.0.0","info":{"title":"Kognitos API","version":"1.0.0"},"tags":[{"name":"Work Items","description":"Track work items and work units that need human input."}],"servers":[{"url":"https://app.us-1.kognitos.com"}],"security":[{"BearerAuth":[]}],"components":{"securitySchemes":{"BearerAuth":{"type":"http","scheme":"bearer","description":"Personal Access Token."}},"schemas":{"v1WorkUnitUpdate":{"type":"object","properties":{"name":{"type":"string","description":"Stable WorkUnit resource name, including after rekey."},"revision":{"type":"string","format":"int64","description":"Same ordering token as WorkUnit.revision."},"work_item":{"type":"string","description":"Current parent WorkItem resource name."},"status":{"$ref":"#/components/schemas/v1WorkUnitStatus"},"delivery":{"$ref":"#/components/schemas/v1EffectDelivery"},"settle_time":{"type":"string","format":"date-time","description":"Time the unit settled; absent while unresolved."},"update_time":{"type":"string","format":"date-time","description":"Time the unit last changed."},"submission":{"type":"string","description":"Accepted final Submission resource name; empty before submission."},"input":{"$ref":"#/components/schemas/v1InputContext"},"answer_draft":{"$ref":"#/components/schemas/v1AnswerDraft"},"previous_work_item":{"type":"string","description":"Previous membership when this update moves the unit. Empty otherwise.\nA departure removes membership, never the resource itself."},"labels":{"type":"object","additionalProperties":{"type":"string"},"description":"Current source labels, refreshed by live re-reports. Empty clears earlier labels."}},"description":"Complete replacement of a unit's mutable projection at one revision.\n\nMissing messages and empty strings clear earlier values. Immutable evidence,\nidentifying details and source answer schema remain on Get/List. Unknown\nunits require a read. Changes of item membership reach both subscriptions."},"v1WorkUnitStatus":{"type":"string","enum":["WORK_UNIT_STATUS_UNSPECIFIED","WORK_UNIT_STATUS_WAITING_FOR_INPUT","WORK_UNIT_STATUS_ANSWERED","WORK_UNIT_STATUS_DISMISSED","WORK_UNIT_STATUS_WITHDRAWN","WORK_UNIT_STATUS_PROCESSING"],"default":"WORK_UNIT_STATUS_UNSPECIFIED","description":"WorkUnitStatus records attention and final resolution independently of delivery.\n\n - WORK_UNIT_STATUS_UNSPECIFIED: Default value; not returned for an existing resource.\n - WORK_UNIT_STATUS_WAITING_FOR_INPUT: Waiting for intermediate input or a direct final answer: an item input_form\nexists and input is unaccepted, or no input_form exists and the kind does\nnot require preparation. Saving either draft leaves status unchanged.\n - WORK_UNIT_STATUS_ANSWERED: Final submission and its delivery obligation are durable.\n - WORK_UNIT_STATUS_DISMISSED: Locally dismissed by item archival, arrival or rekey into an archived item.\nUnarchive restores it unless the source or operator has withdrawn it.\n - WORK_UNIT_STATUS_WITHDRAWN: Source or operator ended the occurrence without an answer.\n - WORK_UNIT_STATUS_PROCESSING: Analysis or decision preparation is pending; no current human request.\nIncludes work without an input_form whose kind requires preparation, and\nfinal-answer preparation after intermediate input acceptance."},"v1EffectDelivery":{"type":"object","properties":{"name":{"type":"string","description":"Resource name; the final segment is the dispatch_id given to the source."},"work_unit":{"type":"string","description":"The unit whose decision this delivers.","readOnly":true},"submission":{"type":"string","description":"The final submission this delivers; always present.","readOnly":true},"attempt_count":{"type":"integer","format":"int32","description":"Count of publish attempts across automatic and operator retry cycles.","readOnly":true},"publish_time":{"type":"string","format":"date-time","description":"First successful broker acknowledgement. Absent before publication.","readOnly":true},"result_time":{"type":"string","format":"date-time","description":"Time Workbench durably received a terminal source result.","readOnly":true},"outcome":{"$ref":"#/components/schemas/v1DecisionOutcome"},"rejection_reason":{"type":"string","description":"Source rejection reason, present only for REJECTED.","readOnly":true},"confirmation_deadline":{"type":"string","format":"date-time","description":"Fixed at first successful publication. Passing this time without a result\nmeans confirmation overdue, never that delivery or application failed.","readOnly":true},"attention_required_time":{"type":"string","format":"date-time","description":"When automatic retries stopped pending operator attention. A late result\nremains admissible. This is not a terminal source result.","readOnly":true},"last_error":{"type":"string","description":"Business-safe operational diagnostic, distinct from a source rejection.\nNo traceback, internal identifier or resource name; richer detail is logged.","readOnly":true}},"description":"EffectDelivery is the durable obligation to deliver one decision to one unit.\nA source result is independent of publication and of unit settlement."},"v1DecisionOutcome":{"type":"string","enum":["DECISION_OUTCOME_UNSPECIFIED","DECISION_OUTCOME_APPLIED","DECISION_OUTCOME_REJECTED"],"default":"DECISION_OUTCOME_UNSPECIFIED","description":"DecisionOutcome is a source's terminal result for a specific dispatch.\n\n - DECISION_OUTCOME_UNSPECIFIED: Not a terminal result; callers must select an outcome.\n - DECISION_OUTCOME_APPLIED: The requested action was committed or durably scheduled by the source.\nThis does not assert that the downstream workflow succeeded.\n - DECISION_OUTCOME_REJECTED: The source definitively refused the decision. A reason is required."},"v1InputContext":{"type":"object","properties":{"form":{"$ref":"#/components/schemas/v1FormSpec"},"response":{"$ref":"#/components/schemas/v1InputResponse"}},"description":"A human-input form paired with its response.\n\nThe form preserves the meaning of values after form edits or membership changes."},"v1FormSpec":{"type":"object","properties":{"fields":{"type":"array","items":{"$ref":"#/components/schemas/v1FormField"},"description":"At least one question, with unique nonempty keys. Order is the semantic\nreading sequence, not a prescribed screen layout."}},"description":"A set of typed questions for human input or source answers (R6, R13, R14).\nField types derive the returned record type. The platform selects controls\nand layout; there are no widgets, scripts, URLs, or executable expressions.\nShared human input may reference options in each unit's immutable evidence.\nWorkbench resolves those references into the unit's InputContext before use.\nSource answer forms must already be resolved. Filled values are separate messages.\nSources persist their answer form with the pending invocation for recovery.","required":["fields"]},"v1FormField":{"type":"object","properties":{"key":{"type":"string","description":"Stable record key. Unique within its field set; nonempty."},"label":{"type":"string","description":"Business-facing wording, independent of the programmatic key; nonempty."},"help_text":{"type":"string","description":"Optional guidance displayed with the question."},"value_type":{"$ref":"#/components/schemas/v1ValueType"},"initial_value":{"$ref":"#/components/schemas/commonv1Value"},"text":{"$ref":"#/components/schemas/v1TextConstraints"},"number":{"$ref":"#/components/schemas/v1NumberConstraints"},"input_spec":{"$ref":"#/components/schemas/v1InputSpec"}},"description":"One named question, its answer type and its input behavior.","required":["key","label","value_type"]},"v1ValueType":{"type":"object","properties":{"scalar_type":{"$ref":"#/components/schemas/v1ValueScalarType"},"optional_type":{"$ref":"#/components/schemas/v1ValueOptionalType"},"list_type":{"$ref":"#/components/schemas/v1ValueListType"},"dictionary_type":{"$ref":"#/components/schemas/v1ValueDictionaryType"},"table_type":{"$ref":"#/components/schemas/v1ValueTableType"},"opaque_type":{"$ref":"#/components/schemas/v1ValueOpaqueType"},"any_type":{"$ref":"#/components/schemas/v1ValueAnyType"},"union_type":{"$ref":"#/components/schemas/v1ValueUnionType"},"sensitive_type":{"$ref":"#/components/schemas/v1ValueSensitiveType"},"enum_type":{"$ref":"#/components/schemas/v1ValueEnumType"},"generic_dictionary_type":{"$ref":"#/components/schemas/v1ValueGenericDictionaryType"},"none_type":{"$ref":"#/components/schemas/v1ValueNoneType"}},"title":"Represents a complete value type definition using a discriminated union"},"v1ValueScalarType":{"type":"string","enum":["VALUE_SCALAR_TYPE_UNSPECIFIED","VALUE_SCALAR_TYPE_TEXT","VALUE_SCALAR_TYPE_NUMBER","VALUE_SCALAR_TYPE_BOOLEAN","VALUE_SCALAR_TYPE_DATETIME","VALUE_SCALAR_TYPE_DATE","VALUE_SCALAR_TYPE_TIME","VALUE_SCALAR_TYPE_FILE","VALUE_SCALAR_TYPE_TIMEDELTA"],"default":"VALUE_SCALAR_TYPE_UNSPECIFIED","description":"- VALUE_SCALAR_TYPE_UNSPECIFIED: Unspecified value type\n - VALUE_SCALAR_TYPE_TEXT: A text value type\n - VALUE_SCALAR_TYPE_NUMBER: A number value type\n - VALUE_SCALAR_TYPE_BOOLEAN: A boolean value type\n - VALUE_SCALAR_TYPE_DATETIME: A datetime value type\n - VALUE_SCALAR_TYPE_DATE: A date value type\n - VALUE_SCALAR_TYPE_TIME: A time value type\n - VALUE_SCALAR_TYPE_FILE: A file value type\n - VALUE_SCALAR_TYPE_TIMEDELTA: A timedelta value type","title":"Supported Value Scalar Types"},"v1ValueOptionalType":{"type":"object","properties":{"inner":{"$ref":"#/components/schemas/v1ValueType"}},"title":"Represents a value type that can be optional (nullable)"},"v1ValueListType":{"type":"object","properties":{"inner":{"$ref":"#/components/schemas/v1ValueType"}},"title":"Represents a list/array value type containing elements of a specific type"},"v1ValueDictionaryType":{"type":"object","properties":{"is_a":{"type":"string","title":"Semantic classification of what this dictionary represents"},"fields":{"type":"array","items":{"$ref":"#/components/schemas/v1ValueDictionaryTypeField"},"title":"The named fields contained in this dictionary"},"description":{"type":"string","title":"Optional human-readable description of this dictionary type"}},"title":"Represents a dictionary/object value type with named fields"},"v1ValueDictionaryTypeField":{"type":"object","properties":{"key":{"type":"string","title":"The name/key of this field"},"value":{"$ref":"#/components/schemas/v1ValueType"},"description":{"type":"string","title":"Optional human-readable description of this field"}},"title":"Represents a single field within a dictionary value type"},"v1ValueTableType":{"type":"object","properties":{"is_a":{"type":"string","title":"Semantic classification of what this table represents"},"columns":{"type":"array","items":{"$ref":"#/components/schemas/v1ValueTableTypeColumn"},"title":"The columns that make up this table"},"description":{"type":"string","title":"Optional human-readable description of this table type"}},"title":"Represents a table value type with structured columns"},"v1ValueTableTypeColumn":{"type":"object","properties":{"key":{"type":"string","title":"The name/key of this column"},"value":{"$ref":"#/components/schemas/v1ValueType"},"description":{"type":"string","title":"Optional human-readable description of this column"}},"title":"Represents a single column within a table value type"},"v1ValueOpaqueType":{"type":"object","properties":{"is_a":{"type":"string","title":"Semantic classification of what this opaque type represents"},"description":{"type":"string","title":"Optional human-readable description of this opaque type"}},"title":"Represents an opaque value type with semantic meaning but unknown internal structure"},"v1ValueAnyType":{"type":"object","title":"Represents a value type that can hold any kind of value"},"v1ValueUnionType":{"type":"object","properties":{"inners":{"type":"array","items":{"$ref":"#/components/schemas/v1ValueType"},"title":"The possible value types in this union"}},"title":"Represents a union value type that can be one of several possible types"},"v1ValueSensitiveType":{"type":"object","properties":{"inner":{"$ref":"#/components/schemas/v1ValueType"}},"title":"Represents a value type that contains sensitive information"},"v1ValueEnumType":{"type":"object","properties":{"is_a":{"type":"string","title":"Semantic classification of what this enum represents"},"members":{"type":"array","items":{"$ref":"#/components/schemas/v1ValueEnumTypeMember"},"title":"The available options/members of this enum"},"description":{"type":"string","title":"Optional human-readable description of this enum type"}},"title":"Represents an enumeration value type with predefined options"},"v1ValueEnumTypeMember":{"type":"object","properties":{"name":{"type":"string","title":"The programmatic name of this enum member"},"description":{"type":"string","title":"Optional human-readable description of this enum member"}},"title":"Represents a single member/option within an enum value type"},"v1ValueGenericDictionaryType":{"type":"object","properties":{"key_type":{"$ref":"#/components/schemas/v1ValueType"},"value_type":{"$ref":"#/components/schemas/v1ValueType"}},"title":"Represent a generic dictionary that can hold any entry of a particular key and value type"},"v1ValueNoneType":{"type":"object","title":"Represents a none value type that can hold no value"},"commonv1Value":{"type":"object","properties":{"null_value":{"type":"string","title":"Represents the absence of a value (None/null/undefined)"},"bool_value":{"type":"boolean","title":"Boolean true/false value"},"number":{"$ref":"#/components/schemas/v1Number"},"text":{"type":"string","title":"UTF-8 encoded text string"},"date":{"$ref":"#/components/schemas/typeDate"},"timeofday":{"$ref":"#/components/schemas/typeTimeOfDay"},"datetime":{"$ref":"#/components/schemas/typeDateTime"},"time_zone":{"$ref":"#/components/schemas/typeTimeZone"},"duration":{"type":"string","title":"Signed duration representing a span of time"},"list":{"$ref":"#/components/schemas/v1List"},"dictionary":{"$ref":"#/components/schemas/v1Dictionary"},"file":{"$ref":"#/components/schemas/v1FileValue"},"table":{"$ref":"#/components/schemas/v1TableValue"},"set":{"$ref":"#/components/schemas/v1Set"},"text_value":{"$ref":"#/components/schemas/v1TextValue"},"list_value":{"$ref":"#/components/schemas/commonv1ListValue"},"set_value":{"$ref":"#/components/schemas/v1SetValue"},"dictionary_value":{"$ref":"#/components/schemas/v1DictionaryValue"}},"description":"Represents a runtime value that can be produced by the Jarvis interpreter.\n\nThis message provides a type-safe way to serialize and transmit values between\nthe Jarvis interpreter and other services via gRPC. It supports all the basic\ndata types that can be represented in the Jarvis language runtime.\n\nThe oneof structure ensures that exactly one value type is set at a time,\nproviding both type safety and efficient serialization."},"v1Number":{"type":"object","properties":{"lo":{"type":"integer","format":"int64","description":"Low 32 bits of the 96-bit mantissa."},"mid":{"type":"integer","format":"int64","description":"Middle 32 bits of the 96-bit mantissa."},"hi":{"type":"integer","format":"int64","description":"High 32 bits of the 96-bit mantissa."},"flags":{"type":"integer","format":"int64","description":"Flags word:\n - Bits 16–23: scale (0–28)\n - Bit 31: sign (0 = positive, 1 = negative)\n - Other bits must be zero."}},"description":"A fixed-precision decimal number with up to 28 fractional digits.\n\nThis message represents decimal numbers with exact precision, avoiding\nfloating-point rounding errors. It's particularly useful for financial\ncalculations, measurements, and any scenario where exact decimal\nrepresentation is required.\n\nThe value is calculated as: m / 10^e, where:\n - m is an unsigned 96-bit integer composed of (lo, mid, hi)\n - e is the scale (0–28) stored in flags bits 16–23\n - sign is encoded in flags bit 31 (0 = positive, 1 = negative)\n\nExamples:\n - 123.45 would have m=12345, e=2\n - -0.001 would have m=1, e=3, with sign bit set\n"},"typeDate":{"type":"object","properties":{"year":{"type":"integer","format":"int32","description":"Year of the date. Must be from 1 to 9999, or 0 to specify a date without\na year."},"month":{"type":"integer","format":"int32","description":"Month of a year. Must be from 1 to 12, or 0 to specify a year without a\nmonth and day."},"day":{"type":"integer","format":"int32","description":"Day of a month. Must be from 1 to 31 and valid for the year and month, or 0\nto specify a year by itself or a year and month where the day isn't\nsignificant."}},"description":"* A full date, with non-zero year, month, and day values\n* A month and day value, with a zero year, such as an anniversary\n* A year on its own, with zero month and day values\n* A year and month value, with a zero day, such as a credit card expiration\ndate\n\nRelated types are [google.type.TimeOfDay][google.type.TimeOfDay] and\n`google.protobuf.Timestamp`.","title":"Represents a whole or partial calendar date, such as a birthday. The time of\nday and time zone are either specified elsewhere or are insignificant. The\ndate is relative to the Gregorian Calendar. This can represent one of the\nfollowing:"},"typeTimeOfDay":{"type":"object","properties":{"hours":{"type":"integer","format":"int32","description":"Hours of day in 24 hour format. Should be from 0 to 23. An API may choose\nto allow the value \"24:00:00\" for scenarios like business closing time."},"minutes":{"type":"integer","format":"int32","description":"Minutes of hour of day. Must be from 0 to 59."},"seconds":{"type":"integer","format":"int32","description":"Seconds of minutes of the time. Must normally be from 0 to 59. An API may\nallow the value 60 if it allows leap-seconds."},"nanos":{"type":"integer","format":"int32","description":"Fractions of seconds in nanoseconds. Must be from 0 to 999,999,999."}},"description":"Represents a time of day. The date and time zone are either not significant\nor are specified elsewhere. An API may choose to allow leap seconds. Related\ntypes are [google.type.Date][google.type.Date] and\n`google.protobuf.Timestamp`."},"typeDateTime":{"type":"object","properties":{"year":{"type":"integer","format":"int32","description":"Optional. Year of date. Must be from 1 to 9999, or 0 if specifying a\ndatetime without a year."},"month":{"type":"integer","format":"int32","description":"Required. Month of year. Must be from 1 to 12."},"day":{"type":"integer","format":"int32","description":"Required. Day of month. Must be from 1 to 31 and valid for the year and\nmonth."},"hours":{"type":"integer","format":"int32","description":"Required. Hours of day in 24 hour format. Should be from 0 to 23. An API\nmay choose to allow the value \"24:00:00\" for scenarios like business\nclosing time."},"minutes":{"type":"integer","format":"int32","description":"Required. Minutes of hour of day. Must be from 0 to 59."},"seconds":{"type":"integer","format":"int32","description":"Required. Seconds of minutes of the time. Must normally be from 0 to 59. An\nAPI may allow the value 60 if it allows leap-seconds."},"nanos":{"type":"integer","format":"int32","description":"Required. Fractions of seconds in nanoseconds. Must be from 0 to\n999,999,999."},"utc_offset":{"type":"string","description":"UTC offset. Must be whole seconds, between -18 hours and +18 hours.\nFor example, a UTC offset of -4:00 would be represented as\n{ seconds: -14400 }."},"time_zone":{"$ref":"#/components/schemas/typeTimeZone"}},"description":"Represents civil time (or occasionally physical time).\n\nThis type can represent a civil time in one of a few possible ways:\n\n * When utc_offset is set and time_zone is unset: a civil time on a calendar\n   day with a particular offset from UTC.\n * When time_zone is set and utc_offset is unset: a civil time on a calendar\n   day in a particular time zone.\n * When neither time_zone nor utc_offset is set: a civil time on a calendar\n   day in local time.\n\nThe date is relative to the Proleptic Gregorian Calendar.\n\nIf year is 0, the DateTime is considered not to have a specific year. month\nand day must have valid, non-zero values.\n\nThis type may also be used to represent a physical time if all the date and\ntime fields are set and either case of the `time_offset` oneof is set.\nConsider using `Timestamp` message for physical time instead. If your use\ncase also would like to store the user's timezone, that can be done in\nanother field.\n\nThis type is more flexible than some applications may want. Make sure to\ndocument and validate your application's limitations."},"typeTimeZone":{"type":"object","properties":{"id":{"type":"string","description":"IANA Time Zone Database time zone, e.g. \"America/New_York\"."},"version":{"type":"string","description":"Optional. IANA Time Zone Database version number, e.g. \"2019a\"."}},"description":"Represents a time zone from the\n[IANA Time Zone Database](https://www.iana.org/time-zones)."},"v1List":{"type":"object","properties":{"items":{"type":"array","items":{"$ref":"#/components/schemas/commonV1Value"},"title":"The ordered sequence of values in this list"}},"description":"Represents an ordered collection of values (similar to arrays or lists).\n\nThis message can contain any number of Value elements in a specific order.\nLists are mutable and can grow or shrink during runtime. Elements can be\naccessed by their zero-based index position.\n\nExamples:\n - [1, 2, 3] - list of numbers\n - [\"hello\", \"world\"] - list of strings\n - [true, 42, \"mixed\"] - list with mixed types\n - [[1, 2], [3, 4]] - nested lists"},"commonV1Value":{"type":"object","properties":{"null_value":{"type":"string","title":"Represents the absence of a value (None/null/undefined)"},"bool_value":{"type":"boolean","title":"Boolean true/false value"},"number":{"$ref":"#/components/schemas/v1Number"},"text":{"type":"string","title":"UTF-8 encoded text string"},"date":{"$ref":"#/components/schemas/typeDate"},"timeofday":{"$ref":"#/components/schemas/typeTimeOfDay"},"datetime":{"$ref":"#/components/schemas/typeDateTime"},"time_zone":{"$ref":"#/components/schemas/typeTimeZone"},"duration":{"type":"string","title":"Signed duration representing a span of time"},"list":{"$ref":"#/components/schemas/v1List"},"dictionary":{"$ref":"#/components/schemas/v1Dictionary"},"file":{"$ref":"#/components/schemas/v1FileValue"},"table":{"$ref":"#/components/schemas/v1TableValue"},"set":{"$ref":"#/components/schemas/v1Set"},"text_value":{"$ref":"#/components/schemas/v1TextValue"},"list_value":{"$ref":"#/components/schemas/commonv1ListValue"},"set_value":{"$ref":"#/components/schemas/v1SetValue"},"dictionary_value":{"$ref":"#/components/schemas/v1DictionaryValue"}},"description":"Represents a runtime value that can be produced by the Jarvis interpreter.\n\nThis message provides a type-safe way to serialize and transmit values between\nthe Jarvis interpreter and other services via gRPC. It supports all the basic\ndata types that can be represented in the Jarvis language runtime.\n\nThe oneof structure ensures that exactly one value type is set at a time,\nproviding both type safety and efficient serialization."},"v1Dictionary":{"type":"object","properties":{"entries":{"type":"array","items":{"$ref":"#/components/schemas/v1DictionaryEntry"},"title":"The key-value pairs stored in this dictionary"}},"description":"Represents a key-value mapping (similar to hash maps or dictionaries).\n\nThis message stores associations between keys and values, where keys must be\nhashable types (null, bool, Number, string, Date, TimeOfDay, DateTime, TimeZone). Keys are\nunique within a dictionary - duplicate keys will overwrite previous values.\n\nThe dictionary maintains insertion order for consistent iteration behavior.\n\nExamples:\n - {\"name\": \"John\", \"age\": 30} - string keys with mixed values\n - {1: \"one\", 2: \"two\"} - number keys with string values\n - {\"nested\": {\"inner\": \"value\"}} - nested dictionaries"},"v1DictionaryEntry":{"type":"object","properties":{"key":{"$ref":"#/components/schemas/v1HashableValue"},"value":{"$ref":"#/components/schemas/commonV1Value"}},"description":"Represents a single key-value pair within a Dictionary.\n\nBoth key and value can be any Value type, though keys should be\nhashable types for proper dictionary behavior. Non-hashable keys\n(like lists or dictionaries) may cause runtime errors."},"v1HashableValue":{"type":"object","properties":{"bool_value":{"type":"boolean","title":"Boolean true/false value"},"number":{"$ref":"#/components/schemas/v1Number"},"text":{"type":"string","title":"UTF-8 encoded text string"},"date":{"$ref":"#/components/schemas/typeDate"},"timeofday":{"$ref":"#/components/schemas/typeTimeOfDay"},"datetime":{"$ref":"#/components/schemas/typeDateTime"},"duration":{"type":"string","title":"Signed duration representing a span of time"},"text_value":{"$ref":"#/components/schemas/v1TextValue"}},"description":"Represents a hashable value that can be used as a dictionary key.\n\nThis message contains only the hashable types from the Value message,\ncorresponding to Python's hashable types. These types can be safely\nused as keys in maps and dictionaries.\n\nHashable types include: bool, Number, string, Date, TimeOfDay, DateTime\nand Duration."},"v1TextValue":{"type":"object","properties":{"remote":{"type":"string","title":"Reference to remote text content via URL or file path"},"inline":{"type":"string","title":"Text content embedded directly in the message"}},"description":"Represents a text value that can be either stored inline or referenced remotely.\n\nThis message provides flexibility for handling text strings in the Jarvis interpreter:\n- Small strings can be embedded directly using the inline option\n- Large strings can be referenced by URL using the remote option\n- The choice depends on string size, network constraints, and access patterns"},"v1FileValue":{"type":"object","properties":{"remote":{"type":"string","title":"Reference to a remote file via URL or file path"},"inline":{"$ref":"#/components/schemas/v1File"}},"description":"Represents a file value that can be either stored inline or referenced remotely.\n\nThis message provides flexibility for handling files in the Jarvis interpreter:\n- Small files can be embedded directly using the inline option\n- Large files can be referenced by URL/path using the remote option\n- The choice depends on file size, network constraints, and access patterns"},"v1File":{"type":"object","properties":{"content":{"type":"string","format":"byte","title":"The raw binary content of the file"},"name":{"type":"string","title":"The name of the file, including extension if applicable"}},"description":"Represents a file with its name and binary content.\n\nThis message contains the complete file data including both metadata\n(filename) and the actual file content as raw bytes. It's used for\nembedding files directly within messages when the file size is\nmanageable and immediate access is required.\n\nExamples:\n - Configuration files\n - Small text or binary files\n - Generated reports or documents\n - Temporary files created during execution\n"},"v1TableValue":{"type":"object","properties":{"remote":{"type":"string","title":"Reference to a remote table via URL or file path (feather-v2 format)"},"inline":{"$ref":"#/components/schemas/v1Table"}},"description":"Represents a table value that can be either stored inline or referenced remotely."},"v1Table":{"type":"object","properties":{"data":{"type":"string","format":"byte","title":"The table data serialized in feather-v2 format"}},"description":"Represents a table with data in feather-v2 format.\n\nThis message contains the complete table data serialized using the\nfeather-v2 format, which provides efficient columnar storage and\nfast serialization/deserialization for tabular data."},"v1Set":{"type":"object","properties":{"items":{"type":"array","items":{"$ref":"#/components/schemas/v1HashableValue"},"title":"The unique elements stored in this set\nAll elements must be hashable types"}},"description":"Represents an unordered collection of unique values.\n\nThis message stores a collection of unique elements, where duplicate values\nare automatically removed. Only hashable types can be stored in sets.\nSets are useful for membership testing, removing duplicates, and mathematical\nset operations like union, intersection, and difference.\n\nThe set does not maintain insertion order - elements may appear in any order\nduring iteration.\n\nExamples:\n - {1, 2, 3} - set of numbers\n - {\"apple\", \"banana\", \"cherry\"} - set of strings\n - {true, false} - set of booleans\n - {1, \"hello\", true} - set with mixed hashable types"},"commonv1ListValue":{"type":"object","properties":{"remote":{"type":"string","title":"Reference to remote list data via URL or file path"},"inline":{"$ref":"#/components/schemas/v1List"}},"description":"Represents a list value that can be either stored inline or referenced remotely.\n\nThis message provides flexibility for handling large lists:\n- Small lists can be embedded directly using the inline option\n- Large lists can be referenced by URL using the remote option"},"v1SetValue":{"type":"object","properties":{"remote":{"type":"string","title":"Reference to remote set data via URL or file path"},"inline":{"$ref":"#/components/schemas/v1Set"}},"description":"Represents a set value that can be either stored inline or referenced remotely.\n\nThis message provides flexibility for handling large sets:\n- Small sets can be embedded directly using the inline option\n- Large sets can be referenced by URL using the remote option"},"v1DictionaryValue":{"type":"object","properties":{"remote":{"type":"string","title":"Reference to remote dictionary data via URL or file path"},"inline":{"$ref":"#/components/schemas/v1Dictionary"}},"description":"Represents a dictionary value that can be either stored inline or referenced remotely.\n\nThis message provides flexibility for handling large dictionaries:\n- Small dictionaries can be embedded directly using the inline option\n- Large dictionaries can be referenced by URL using the remote option"},"v1TextConstraints":{"type":"object","properties":{"min_length":{"type":"integer","format":"int64","description":"Unicode scalar-value counts, not bytes or UTF-16 code units. No implicit\ntrimming, normalization, pattern evaluation or text transformation."},"max_length":{"type":"integer","format":"int64","description":"Inclusive maximum length, measured in Unicode scalar values."}},"description":"Length restrictions on a text answer."},"v1NumberConstraints":{"type":"object","properties":{"minimum":{"$ref":"#/components/schemas/v1Number"},"maximum":{"$ref":"#/components/schemas/v1Number"},"integer_only":{"type":"boolean","description":"Require a value with no fractional component."}},"description":"Exact decimal restrictions on a numeric answer."},"v1InputSpec":{"type":"object","properties":{"selection":{"$ref":"#/components/schemas/v1SelectionInput"}},"description":"How a person supplies a typed answer. Concrete controls and layout belong\nto the renderer. No option carries follow-up fields or executable behavior."},"v1SelectionInput":{"type":"object","properties":{"options":{"type":"array","items":{"$ref":"#/components/schemas/v1SelectionOption"},"description":"Distinct typed values with nonempty labels. May be empty. Each value must\nsatisfy the scalar/element type and applicable field constraints. Numeric\nequality is decimal equality, so 1 and 1.0 are the same option."},"min_selections":{"type":"integer","format":"int64","description":"Only for list fields. Omitted minimum means zero; omitted maximum means the\noption count. Bounds must be ordered and, for nonempty option sets, no greater\nthan that count. Empty selections retain bounds for answer validation.\nUnknown or repeated selections fail. Persist selections in option order,\nusing the declared option values, not user click order or numeric encoding."},"max_selections":{"type":"integer","format":"int64","description":"Inclusive maximum number of selected options."},"options_ref":{"type":"string","description":"Exact nonempty top-level WorkUnit.evidence key, not a path or expression.\nAllowed only in shared human input, mutually exclusive with inline options.\nValid evidence is an inline list of distinct scalar values matching\nthe field's scalar/element type and constraints. Inline text wrappers are\nnormalized to text. No remote reads, record projections or coercion occur.\nEach value is both the displayed choice and the submitted value: text is\nunchanged, numbers use exact decimal text, booleans use true/false, and dates\nuse YYYY-MM-DD. Empty text has no display label and is invalid as an option.\nMissing, empty or invalid choices produce an empty selection, not an input\nerror or free entry. Other fields remain usable. Initial values incompatible\nwith the resolved selection are omitted for that unit."}},"description":"A finite set of offered values. A scalar field selects one value; a list\nfield selects distinct values of its element type. Optional None is absence,\nnever an option. Use inline options or options_ref, not both. Empty selections\noffer no choices and never enable free entry. Resolved unit input and source\nanswer forms use inline options only."},"v1SelectionOption":{"type":"object","properties":{"label":{"type":"string","description":"Nonempty display wording, independent of the submitted value."},"value":{"$ref":"#/components/schemas/commonv1Value"}},"description":"Display wording and the typed value returned when this option is selected.","required":["label","value"]},"v1InputResponse":{"type":"object","properties":{"values":{"type":"object","additionalProperties":{"$ref":"#/components/schemas/commonv1Value"},"description":"Current values. Drafts may omit required fields, but supplied values must\nsatisfy the published form. Empty values clear the draft. Unknown keys fail.","readOnly":true},"etag":{"type":"string","description":"Opaque concurrency token. Changes on edits, acceptance, revocation and\nunarchive or form changes. Never reused after clearing a response or rekey.\nClients must return the token they actually read.","readOnly":true},"updated_by":{"type":"string","description":"Actor who last edited values. Empty for a newly created, untouched draft.","readOnly":true},"update_time":{"type":"string","format":"date-time","description":"Time of the latest draft or acceptance change.","readOnly":true},"accepted_by":{"type":"string","description":"Authenticated actor who explicitly accepted these values; empty if not\naccepted. User attribution does not distinguish a human from their agent.","readOnly":true},"accept_time":{"type":"string","format":"date-time","description":"Present only while acceptance is valid. Revoke acceptance before editing.\nForm edits, rekey and unarchive invalidate acceptance; final submission\nprevents editing.","readOnly":true}},"description":"Editable per-unit human input, with explicit acceptance separate from filling.\nAcceptance permits final-answer preparation; it is not a final submission."},"v1AnswerDraft":{"type":"object","properties":{"values":{"type":"object","additionalProperties":{"$ref":"#/components/schemas/commonv1Value"},"description":"Supplied fields must validate; required top-level fields may be omitted.\nSupplied structured values must be complete. Unknown keys fail.","readOnly":true},"etag":{"type":"string","description":"Concurrency token, present before the first save. Changes on saves.\nClearing values never reuses a token.","readOnly":true},"updated_by":{"type":"string","description":"Authenticated actor who last saved values; empty before the first save.","readOnly":true},"update_time":{"type":"string","format":"date-time","description":"Time of the latest save.","readOnly":true}},"description":"Partial final-answer values for one immutable source answer contract.\n\nSaving is optional and never accepts input or settles the unit."},"rpcStatus":{"type":"object","properties":{"code":{"type":"integer","format":"int32"},"message":{"type":"string"},"details":{"type":"array","items":{"$ref":"#/components/schemas/protobufAny"}}}},"protobufAny":{"type":"object","properties":{"@type":{"type":"string"}},"additionalProperties":{}}}},"paths":{"/api/v1/organizations/{organization_id}/workspaces/{workspace_id}/workUnits:stream":{"get":{"summary":"Subscribe Work Units","description":"Subscribe to units entering, changing within or leaving one item.\nStatus is never filtered: answered, dismissed and withdrawn updates are included.","operationId":"SubscribeWorkUnits","responses":{"200":{"description":"A successful response.(streaming responses)","content":{"application/json":{"schema":{"type":"object","properties":{"result":{"$ref":"#/components/schemas/v1WorkUnitUpdate"},"error":{"$ref":"#/components/schemas/rpcStatus"}},"title":"Stream result of v1WorkUnitUpdate"}}}},"default":{"description":"An unexpected error response.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/rpcStatus"}}}}},"parameters":[{"name":"organization_id","in":"path","required":true,"schema":{"type":"string"}},{"name":"workspace_id","in":"path","required":true,"schema":{"type":"string"}},{"name":"work_item","description":"Item membership to observe. Must belong to parent.","in":"query","required":true,"schema":{"type":"string"}}],"tags":["Work Items"]}}}}
```

## List Work Item Kinds

> ListWorkItemKinds lists every kind with the part of its descriptor a client\
> needs: the label to show and the keys that group its units.\
> \
> Retired kinds are listed, and carry \`retire\_time\`. No new work of such a\
> kind will arrive.\
> \
> The registry is small and read whole, so a client fetches this once and\
> caches it rather than resolving a kind per item. That is why there is no\
> GetWorkItemKind. A cached entry may become retired, and a retired one may\
> return to effect.\
> \
> Kinds are registered platform-wide rather than per tenant, so this\
> collection has no parent.

```json
{"openapi":"3.0.0","info":{"title":"Kognitos API","version":"1.0.0"},"tags":[{"name":"Work Items","description":"Track work items and work units that need human input."}],"servers":[{"url":"https://app.us-1.kognitos.com"}],"security":[{"BearerAuth":[]}],"components":{"securitySchemes":{"BearerAuth":{"type":"http","scheme":"bearer","description":"Personal Access Token."}},"schemas":{"v1ListWorkItemKindsResponse":{"type":"object","properties":{"work_item_kinds":{"type":"array","items":{"$ref":"#/components/schemas/v1WorkItemKind"},"description":"The registered kinds, in no guaranteed order."},"next_page_token":{"type":"string","description":"The token to retrieve the next page, or empty if this is the last."}},"description":"ListWorkItemKindsResponse contains the registered kinds."},"v1WorkItemKind":{"type":"object","properties":{"name":{"type":"string","title":"The resource name of the kind. The final segment is exactly the opaque id\ncarried in WorkItem.kind, which is what a client joins on.\nFormat: workItemKinds/{kind_id}"},"display_name":{"type":"string","description":"The label to show a person in place of the opaque id, for example\n\"Automation exception\".","readOnly":true},"description":{"type":"string","description":"One sentence on what this kind of work is, for a surface that has room for\nit. May be empty.","readOnly":true},"aggregation_keys":{"type":"array","items":{"type":"string"},"description":"The label keys this kind groups on.\n\nEach key is optional: a unit that does not carry one groups as a null for\nthat key rather than being rejected. Empty means one item per unit, as does\na unit that carries none of these keys.\n\nIts reader is a surface explaining why two units sit on one item, which R9\nrequires a person to be able to see.","readOnly":true},"dismissible":{"type":"boolean","description":"Whether work of this kind can simply stop being asked.\n\nFalse when something is waiting on the answer: a suspended run needs a\nvalue or an explicit abandon, and dropping its question leaves it waiting\nforever. True when nothing is blocked and the question is merely a\nquestion, as for a detector's finding.\n\nArchiveWorkItem rejects kinds that are not dismissible. Registration rejects\nchanging true to false while any item of this kind remains archived.\nRetry, skip and abandon are answers rather than dismissals, because each\none tells the source to do something.","readOnly":true},"retire_time":{"type":"string","format":"date-time","description":"When this kind stopped being registered. Absent while it is in effect.\n\nA retired kind is still listed, because items already created under it\nstill need a display name. Set means no new work of this kind will arrive:\nits units are quarantined rather than admitted. A surface offering kinds as\na filter value reads this to tell a retired kind from a quiet one.\n\nRetirement is reversible. Registering the kind again clears this.","readOnly":true},"agent_id":{"type":"string","description":"Workspace-scoped Rain agent ID, not a versioned Kubernetes resource name.\nThe agent accepts organizationId, workspaceId and workItemId variables.\nImmutable across retirement and re-registration of the kind.\nEmpty for existing descriptors awaiting their first explicit agent registration.","readOnly":true},"preparation_required":{"type":"boolean","description":"Whether work needs preparation before requesting a response. Without an\nitem input_form, unresolved units are PROCESSING when true and\nWAITING_FOR_INPUT when false, ready for a direct source answer. Changes\nupdate existing unresolved units without an input_form. Published input\nand its acceptance govern status independently of this policy.\nAlso arms the item's preparation prompt on zero-to-nonzero unresolved\nmembership. Disabling clears existing prompt flags; enabling arms only\nfuture membership transitions. Neither value starts an agent or gates submission.","readOnly":true}},"description":"WorkItemKind is a registered kind of work, as much of it as a client needs.\n\nA kind's descriptor is supplied at runtime and most of it is this service's\nbusiness: where to deliver an answer, and how long to wait for the effect.\nWhat a client cannot do without is here — the label to show instead of the\nopaque id and which label keys group. The\nanswer form is not here; it is declared per unit and reaches a client as\nWorkUnit.answer_form.\n\nRegistration is a Kubernetes custom resource, not an API call, so every\nfield is output only and there is no Create, Update or Delete."},"rpcStatus":{"type":"object","properties":{"code":{"type":"integer","format":"int32"},"message":{"type":"string"},"details":{"type":"array","items":{"$ref":"#/components/schemas/protobufAny"}}}},"protobufAny":{"type":"object","properties":{"@type":{"type":"string"}},"additionalProperties":{}}}},"paths":{"/api/v1/workItemKinds":{"get":{"summary":"List Work Item Kinds","description":"ListWorkItemKinds lists every kind with the part of its descriptor a client\nneeds: the label to show and the keys that group its units.\n\nRetired kinds are listed, and carry `retire_time`. No new work of such a\nkind will arrive.\n\nThe registry is small and read whole, so a client fetches this once and\ncaches it rather than resolving a kind per item. That is why there is no\nGetWorkItemKind. A cached entry may become retired, and a retired one may\nreturn to effect.\n\nKinds are registered platform-wide rather than per tenant, so this\ncollection has no parent.","operationId":"ListWorkItemKinds","responses":{"200":{"description":"A successful response.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/v1ListWorkItemKindsResponse"}}}},"default":{"description":"An unexpected error response.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/rpcStatus"}}}}},"parameters":[{"name":"page_size","description":"The maximum number of kinds to return. Defaults to the whole registry,\nwhich is expected to stay small.","in":"query","required":false,"schema":{"type":"integer","format":"int32"}},{"name":"page_token","description":"A page token from a previous response.","in":"query","required":false,"schema":{"type":"string"}}],"tags":["Work Items"]}}}}
```
