{ "openapi": "3.1.0", "info": { "title": "SynckHub Server API", "version": "1.0.0", "description": "Complete registered SynckHub server HTTP route catalog at the pinned source revision. Includes reads, writes, uploads, deletes, administration, maintenance, callbacks, and protocols. Common, Clearinghouse, and standalone remote-service APIs are outside this reference. GET registrations also accept HEAD through Axum. Validation and conditional availability remain governed by the server contract.\n\n## Authentication and routing\nFor ordinary repository operations, use your SynckHub session access token as the bearer credential and your repository API base URL as the server URL below. Administrative, service, callback, WOPI, and CardDAV operations have their own credentials and access requirements. Presence in this catalog does not grant access. The interactive reference keeps credentials only for the current page session.\n\n[API guide](https://synckhub.com/documentation/developers/api) · [Platform guide](https://synckhub.com/documentation/developers/api/synckhub-platform-api) · [Uploads and coauthoring](https://synckhub.com/documentation/developers/api/uploads-shared-links-and-coauthoring) · [Federation](https://synckhub.com/documentation/developers/api/federation-apis) · [Integration guide](https://synckhub.com/documentation/developers/api/repository-integration-api)\n\nCode samples use ordinary HTTP clients; they are not SynckHub SDKs." }, "servers": [ { "url": "{apiBaseUrl}", "description": "The SynckHub repository data-plane base URL for your authenticated session, or your self-hosted SynckHub server URL.", "variables": { "apiBaseUrl": { "default": "https://example.invalid" } } } ], "x-source": { "repository": "synckhub", "ref": "2558506ea6d7a11f34d83f6b68f1ff116bf3b9f5" }, "paths": { "/.well-known/carddav": { "get": { "operationId": "platform_get___well_known_carddav", "summary": "well known", "tags": [ "carddav" ], "parameters": [], "description": "Authorization and validation are enforced by the owning service.", "x-handler": "well_known", "x-source-file": "crates/synckhub-server/src/routes/carddav.rs", "x-source-line": 47, "responses": { "default": { "description": "Service response. Error status and envelope depend on the operation." } }, "security": [] }, "post": { "operationId": "platform_post___well_known_carddav", "summary": "well known", "tags": [ "carddav" ], "parameters": [], "description": "Authorization and validation are enforced by the owning service.", "x-handler": "well_known", "x-source-file": "crates/synckhub-server/src/routes/carddav.rs", "x-source-line": 47, "responses": { "default": { "description": "Service response. Error status and envelope depend on the operation." } }, "security": [] }, "put": { "operationId": "platform_put___well_known_carddav", "summary": "well known", "tags": [ "carddav" ], "parameters": [], "description": "Authorization and validation are enforced by the owning service.", "x-handler": "well_known", "x-source-file": "crates/synckhub-server/src/routes/carddav.rs", "x-source-line": 47, "responses": { "default": { "description": "Service response. Error status and envelope depend on the operation." } }, "security": [] }, "patch": { "operationId": "platform_patch___well_known_carddav", "summary": "well known", "tags": [ "carddav" ], "parameters": [], "description": "Authorization and validation are enforced by the owning service.", "x-handler": "well_known", "x-source-file": "crates/synckhub-server/src/routes/carddav.rs", "x-source-line": 47, "responses": { "default": { "description": "Service response. Error status and envelope depend on the operation." } }, "security": [] }, "delete": { "operationId": "platform_delete___well_known_carddav", "summary": "well known", "tags": [ "carddav" ], "parameters": [], "description": "Authorization and validation are enforced by the owning service.", "x-handler": "well_known", "x-source-file": "crates/synckhub-server/src/routes/carddav.rs", "x-source-line": 47, "responses": { "default": { "description": "Service response. Error status and envelope depend on the operation." } }, "security": [] }, "head": { "operationId": "platform_head___well_known_carddav", "summary": "well known", "tags": [ "carddav" ], "parameters": [], "description": "Authorization and validation are enforced by the owning service.", "x-handler": "well_known", "x-source-file": "crates/synckhub-server/src/routes/carddav.rs", "x-source-line": 47, "responses": { "default": { "description": "Service response. Error status and envelope depend on the operation." } }, "security": [] }, "options": { "operationId": "platform_options___well_known_carddav", "summary": "well known", "tags": [ "carddav" ], "parameters": [], "description": "Authorization and validation are enforced by the owning service.", "x-handler": "well_known", "x-source-file": "crates/synckhub-server/src/routes/carddav.rs", "x-source-line": 47, "responses": { "default": { "description": "Service response. Error status and envelope depend on the operation." } }, "security": [] }, "trace": { "operationId": "platform_trace___well_known_carddav", "summary": "well known", "tags": [ "carddav" ], "parameters": [], "description": "Authorization and validation are enforced by the owning service.", "x-handler": "well_known", "x-source-file": "crates/synckhub-server/src/routes/carddav.rs", "x-source-line": 47, "responses": { "default": { "description": "Service response. Error status and envelope depend on the operation." } }, "security": [] } }, "/.well-known/oauth-protected-resource/mcp": { "get": { "operationId": "platform_get___well_known_oauth_protected_resource_mcp", "summary": "protected resource metadata", "tags": [ "authz" ], "parameters": [], "description": "Authorization and validation are enforced by the owning service.", "x-handler": "mcp::protected_resource_metadata", "x-source-file": "crates/synckhub-server/src/routes/authz.rs", "x-source-line": 6602, "responses": { "default": { "description": "Platform error; branch on HTTP status and stable code, not the human-readable message.", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } } }, "2XX": { "description": "Successful JSON response", "content": { "application/json": { "schema": {} } } } }, "security": [] }, "head": { "operationId": "platform_head___well_known_oauth_protected_resource_mcp", "summary": "protected resource metadata", "tags": [ "authz" ], "parameters": [], "description": "Authorization and validation are enforced by the owning service.\n\nHEAD uses the GET handler and headers without a response body.", "x-handler": "mcp::protected_resource_metadata", "x-source-file": "crates/synckhub-server/src/routes/authz.rs", "x-source-line": 6602, "x-implicit-head": true, "responses": { "default": { "description": "Platform error; branch on HTTP status and stable code, not the human-readable message." } } } }, "/buildz": { "get": { "operationId": "platform_get__buildz", "summary": "buildz", "tags": [ "authz" ], "parameters": [], "description": "Authorization and validation are enforced by the owning service.", "x-handler": "buildz", "x-source-file": "crates/synckhub-server/src/routes/authz.rs", "x-source-line": 6602, "responses": { "default": { "description": "Service response. Error status and envelope depend on the operation." }, "2XX": { "description": "Successful JSON response", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/synckhub_server.routes.authz.BuildInfo" } } } } } }, "head": { "operationId": "platform_head__buildz", "summary": "buildz", "tags": [ "authz" ], "parameters": [], "description": "Authorization and validation are enforced by the owning service.\n\nHEAD uses the GET handler and headers without a response body.", "x-handler": "buildz", "x-source-file": "crates/synckhub-server/src/routes/authz.rs", "x-source-line": 6602, "x-implicit-head": true, "responses": { "default": { "description": "Service response. Error status and envelope depend on the operation." } } } }, "/calendar/agenda": { "get": { "operationId": "platform_get__calendar_agenda", "summary": "agenda", "tags": [ "native_calendars · agenda" ], "parameters": [ { "name": "limit", "in": "query", "required": false, "schema": { "anyOf": [ { "type": "integer", "minimum": 0 }, { "type": "null" } ] } }, { "name": "cursor", "in": "query", "required": false, "schema": { "anyOf": [ { "type": "string" }, { "type": "null" } ] } }, { "name": "start_date", "in": "query", "required": true, "schema": { "type": "string", "format": "date" } }, { "name": "end_date", "in": "query", "required": true, "schema": { "type": "string", "format": "date" } }, { "name": "time_zone", "in": "query", "required": true, "schema": { "type": "string" } } ], "description": "Authorization and validation are enforced by the owning service.", "x-handler": "agenda", "x-source-file": "crates/synckhub-server/src/routes/native_calendars/agenda.rs", "x-source-line": 26, "responses": { "default": { "description": "Platform error; branch on HTTP status and stable code, not the human-readable message.", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } } }, "2XX": { "description": "Successful JSON response", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/synckhub_server.routes.native_calendars.agenda.Page" } } } } } }, "head": { "operationId": "platform_head__calendar_agenda", "summary": "agenda", "tags": [ "native_calendars · agenda" ], "parameters": [ { "name": "limit", "in": "query", "required": false, "schema": { "anyOf": [ { "type": "integer", "minimum": 0 }, { "type": "null" } ] } }, { "name": "cursor", "in": "query", "required": false, "schema": { "anyOf": [ { "type": "string" }, { "type": "null" } ] } }, { "name": "start_date", "in": "query", "required": true, "schema": { "type": "string", "format": "date" } }, { "name": "end_date", "in": "query", "required": true, "schema": { "type": "string", "format": "date" } }, { "name": "time_zone", "in": "query", "required": true, "schema": { "type": "string" } } ], "description": "Authorization and validation are enforced by the owning service.\n\nHEAD uses the GET handler and headers without a response body.", "x-handler": "agenda", "x-source-file": "crates/synckhub-server/src/routes/native_calendars/agenda.rs", "x-source-line": 26, "x-implicit-head": true, "responses": { "default": { "description": "Platform error; branch on HTTP status and stable code, not the human-readable message." } } } }, "/calendar/availability": { "post": { "operationId": "platform_post__calendar_availability", "summary": "availability", "tags": [ "native_calendars · availability" ], "parameters": [], "description": "Authorization and validation are enforced by the owning service.", "x-handler": "availability", "x-source-file": "crates/synckhub-server/src/routes/native_calendars/availability.rs", "x-source-line": 94, "responses": { "default": { "description": "Platform error; branch on HTTP status and stable code, not the human-readable message.", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } } }, "2XX": { "description": "Successful JSON response", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/synckhub_server.routes.native_calendars.availability.Availability" } } } } }, "requestBody": { "required": true, "content": { "application/json": { "schema": { "$ref": "#/components/schemas/synckhub_server.routes.native_calendars.availability.RequestRange" } } } } } }, "/calendar/availability-settings": { "put": { "operationId": "platform_put__calendar_availability_settings", "summary": "put settings", "tags": [ "native_calendars · availability" ], "parameters": [], "description": "Authorization and validation are enforced by the owning service.", "x-handler": "put_settings", "x-source-file": "crates/synckhub-server/src/routes/native_calendars/availability.rs", "x-source-line": 94, "responses": { "default": { "description": "Platform error; branch on HTTP status and stable code, not the human-readable message.", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } } }, "2XX": { "description": "Successful JSON response", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/synckhub_server.routes.native_calendars.availability.Settings" } } } } }, "requestBody": { "required": true, "content": { "application/json": { "schema": { "$ref": "#/components/schemas/synckhub_server.routes.native_calendars.availability.Settings" } } } } }, "get": { "operationId": "platform_get__calendar_availability_settings", "summary": "get settings", "tags": [ "native_calendars · availability" ], "parameters": [], "description": "Authorization and validation are enforced by the owning service.", "x-handler": "get_settings", "x-source-file": "crates/synckhub-server/src/routes/native_calendars/availability.rs", "x-source-line": 94, "responses": { "default": { "description": "Platform error; branch on HTTP status and stable code, not the human-readable message.", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } } }, "2XX": { "description": "Successful JSON response", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/synckhub_server.routes.native_calendars.availability.Settings" } } } } } }, "head": { "operationId": "platform_head__calendar_availability_settings", "summary": "get settings", "tags": [ "native_calendars · availability" ], "parameters": [], "description": "Authorization and validation are enforced by the owning service.\n\nHEAD uses the GET handler and headers without a response body.", "x-handler": "get_settings", "x-source-file": "crates/synckhub-server/src/routes/native_calendars/availability.rs", "x-source-line": 94, "x-implicit-head": true, "responses": { "default": { "description": "Platform error; branch on HTTP status and stable code, not the human-readable message." } } } }, "/calendar/participant-invitations": { "get": { "operationId": "platform_get__calendar_participant_invitations", "summary": "invitations", "tags": [ "native_calendars · invitations" ], "parameters": [ { "name": "limit", "in": "query", "required": false, "schema": { "anyOf": [ { "type": "integer", "minimum": 0 }, { "type": "null" } ] } }, { "name": "cursor", "in": "query", "required": false, "schema": { "anyOf": [ { "type": "string" }, { "type": "null" } ] } } ], "description": "Authorization and validation are enforced by the owning service.", "x-handler": "invitations", "x-source-file": "crates/synckhub-server/src/routes/native_calendars/invitations.rs", "x-source-line": 15, "responses": { "default": { "description": "Platform error; branch on HTTP status and stable code, not the human-readable message.", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } } }, "2XX": { "description": "Successful JSON response", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/synckhub_server.routes.native_calendars.invitations.Page" } } } } } }, "head": { "operationId": "platform_head__calendar_participant_invitations", "summary": "invitations", "tags": [ "native_calendars · invitations" ], "parameters": [ { "name": "limit", "in": "query", "required": false, "schema": { "anyOf": [ { "type": "integer", "minimum": 0 }, { "type": "null" } ] } }, { "name": "cursor", "in": "query", "required": false, "schema": { "anyOf": [ { "type": "string" }, { "type": "null" } ] } } ], "description": "Authorization and validation are enforced by the owning service.\n\nHEAD uses the GET handler and headers without a response body.", "x-handler": "invitations", "x-source-file": "crates/synckhub-server/src/routes/native_calendars/invitations.rs", "x-source-line": 15, "x-implicit-head": true, "responses": { "default": { "description": "Platform error; branch on HTTP status and stable code, not the human-readable message." } } } }, "/calendar/peer/agenda": { "get": { "operationId": "platform_get__calendar_peer_agenda", "summary": "agenda", "tags": [ "native_calendars · peer" ], "parameters": [ { "name": "routing_repo_id", "in": "query", "required": true, "schema": { "type": "string", "format": "uuid" } }, { "name": "limit", "in": "query", "required": false, "schema": { "anyOf": [ { "type": "integer", "minimum": 0 }, { "type": "null" } ] } }, { "name": "cursor", "in": "query", "required": false, "schema": { "anyOf": [ { "type": "string" }, { "type": "null" } ] } }, { "name": "start_date", "in": "query", "required": true, "schema": { "type": "string", "format": "date" } }, { "name": "end_date", "in": "query", "required": true, "schema": { "type": "string", "format": "date" } }, { "name": "time_zone", "in": "query", "required": true, "schema": { "type": "string" } } ], "description": "Authorization and validation are enforced by the owning service.", "x-handler": "agenda", "x-source-file": "crates/synckhub-server/src/routes/native_calendars/peer.rs", "x-source-line": 15, "responses": { "default": { "description": "Platform error; branch on HTTP status and stable code, not the human-readable message.", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } } }, "2XX": { "description": "Successful JSON response", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/synckhub_server.routes.native_calendars.peer.PeerAgendaPage" } } } } } }, "head": { "operationId": "platform_head__calendar_peer_agenda", "summary": "agenda", "tags": [ "native_calendars · peer" ], "parameters": [ { "name": "routing_repo_id", "in": "query", "required": true, "schema": { "type": "string", "format": "uuid" } }, { "name": "limit", "in": "query", "required": false, "schema": { "anyOf": [ { "type": "integer", "minimum": 0 }, { "type": "null" } ] } }, { "name": "cursor", "in": "query", "required": false, "schema": { "anyOf": [ { "type": "string" }, { "type": "null" } ] } }, { "name": "start_date", "in": "query", "required": true, "schema": { "type": "string", "format": "date" } }, { "name": "end_date", "in": "query", "required": true, "schema": { "type": "string", "format": "date" } }, { "name": "time_zone", "in": "query", "required": true, "schema": { "type": "string" } } ], "description": "Authorization and validation are enforced by the owning service.\n\nHEAD uses the GET handler and headers without a response body.", "x-handler": "agenda", "x-source-file": "crates/synckhub-server/src/routes/native_calendars/peer.rs", "x-source-line": 15, "x-implicit-head": true, "responses": { "default": { "description": "Platform error; branch on HTTP status and stable code, not the human-readable message." } } } }, "/calendar/peer/events/{source_repo_id}/{event_id}": { "get": { "operationId": "platform_get__calendar_peer_events__source_repo_id___event_id_", "summary": "detail", "tags": [ "native_calendars · peer" ], "parameters": [ { "name": "source_repo_id", "in": "path", "required": true, "schema": { "type": "string", "format": "uuid" } }, { "name": "event_id", "in": "path", "required": true, "schema": { "type": "string", "format": "uuid" } }, { "name": "occurrence_start", "in": "query", "required": false, "schema": { "anyOf": [ { "type": "string", "format": "date-time" }, { "type": "null" } ] } } ], "description": "Authorization and validation are enforced by the owning service.", "x-handler": "detail", "x-source-file": "crates/synckhub-server/src/routes/native_calendars/peer.rs", "x-source-line": 15, "responses": { "default": { "description": "Platform error; branch on HTTP status and stable code, not the human-readable message.", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } } }, "2XX": { "description": "Successful JSON response", "content": { "application/json": { "schema": {} } } } } }, "head": { "operationId": "platform_head__calendar_peer_events__source_repo_id___event_id_", "summary": "detail", "tags": [ "native_calendars · peer" ], "parameters": [ { "name": "source_repo_id", "in": "path", "required": true, "schema": { "type": "string", "format": "uuid" } }, { "name": "event_id", "in": "path", "required": true, "schema": { "type": "string", "format": "uuid" } }, { "name": "occurrence_start", "in": "query", "required": false, "schema": { "anyOf": [ { "type": "string", "format": "date-time" }, { "type": "null" } ] } } ], "description": "Authorization and validation are enforced by the owning service.\n\nHEAD uses the GET handler and headers without a response body.", "x-handler": "detail", "x-source-file": "crates/synckhub-server/src/routes/native_calendars/peer.rs", "x-source-line": 15, "x-implicit-head": true, "responses": { "default": { "description": "Platform error; branch on HTTP status and stable code, not the human-readable message." } } } }, "/calendar/peer/invitations": { "get": { "operationId": "platform_get__calendar_peer_invitations", "summary": "invitations", "tags": [ "native_calendars · peer" ], "parameters": [ { "name": "routing_repo_id", "in": "query", "required": false, "schema": { "anyOf": [ { "type": "string", "format": "uuid" }, { "type": "null" } ] } }, { "name": "limit", "in": "query", "required": false, "schema": { "anyOf": [ { "type": "integer", "minimum": 0 }, { "type": "null" } ] } }, { "name": "cursor", "in": "query", "required": false, "schema": { "anyOf": [ { "type": "string" }, { "type": "null" } ] } } ], "description": "Authorization and validation are enforced by the owning service.", "x-handler": "invitations", "x-source-file": "crates/synckhub-server/src/routes/native_calendars/peer.rs", "x-source-line": 15, "responses": { "default": { "description": "Platform error; branch on HTTP status and stable code, not the human-readable message.", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } } }, "2XX": { "description": "Successful JSON response", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/synckhub_server.routes.native_calendars.peer.PeerInvitationPage" } } } } } }, "head": { "operationId": "platform_head__calendar_peer_invitations", "summary": "invitations", "tags": [ "native_calendars · peer" ], "parameters": [ { "name": "routing_repo_id", "in": "query", "required": false, "schema": { "anyOf": [ { "type": "string", "format": "uuid" }, { "type": "null" } ] } }, { "name": "limit", "in": "query", "required": false, "schema": { "anyOf": [ { "type": "integer", "minimum": 0 }, { "type": "null" } ] } }, { "name": "cursor", "in": "query", "required": false, "schema": { "anyOf": [ { "type": "string" }, { "type": "null" } ] } } ], "description": "Authorization and validation are enforced by the owning service.\n\nHEAD uses the GET handler and headers without a response body.", "x-handler": "invitations", "x-source-file": "crates/synckhub-server/src/routes/native_calendars/peer.rs", "x-source-line": 15, "x-implicit-head": true, "responses": { "default": { "description": "Platform error; branch on HTTP status and stable code, not the human-readable message." } } } }, "/calendar/peer/participation": { "post": { "operationId": "platform_post__calendar_peer_participation", "summary": "receive", "tags": [ "native_calendars · peer" ], "parameters": [], "description": "Authorization and validation are enforced by the owning service.", "x-handler": "receive", "x-source-file": "crates/synckhub-server/src/routes/native_calendars/peer.rs", "x-source-line": 15, "responses": { "default": { "description": "Platform error; branch on HTTP status and stable code, not the human-readable message.", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } } }, "2XX": { "description": "Successful JSON response", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/synckhub_server.native_calendar_peer.Receipt" } } } } }, "security": [ { "calendarPeerProof": [] } ], "requestBody": { "required": true, "content": { "application/json": { "schema": { "$ref": "#/components/schemas/synckhub_server.native_calendar_peer.Delivery" } } } } } }, "/carddav": { "get": { "operationId": "platform_get__carddav", "summary": "carddav root redirect", "tags": [ "carddav" ], "parameters": [], "description": "Authorization and validation are enforced by the owning service.", "x-handler": "carddav_root_redirect", "x-source-file": "crates/synckhub-server/src/routes/carddav.rs", "x-source-line": 47, "responses": { "default": { "description": "Service response. Error status and envelope depend on the operation." } }, "security": [] }, "post": { "operationId": "platform_post__carddav", "summary": "carddav root redirect", "tags": [ "carddav" ], "parameters": [], "description": "Authorization and validation are enforced by the owning service.", "x-handler": "carddav_root_redirect", "x-source-file": "crates/synckhub-server/src/routes/carddav.rs", "x-source-line": 47, "responses": { "default": { "description": "Service response. Error status and envelope depend on the operation." } }, "security": [] }, "put": { "operationId": "platform_put__carddav", "summary": "carddav root redirect", "tags": [ "carddav" ], "parameters": [], "description": "Authorization and validation are enforced by the owning service.", "x-handler": "carddav_root_redirect", "x-source-file": "crates/synckhub-server/src/routes/carddav.rs", "x-source-line": 47, "responses": { "default": { "description": "Service response. Error status and envelope depend on the operation." } }, "security": [] }, "patch": { "operationId": "platform_patch__carddav", "summary": "carddav root redirect", "tags": [ "carddav" ], "parameters": [], "description": "Authorization and validation are enforced by the owning service.", "x-handler": "carddav_root_redirect", "x-source-file": "crates/synckhub-server/src/routes/carddav.rs", "x-source-line": 47, "responses": { "default": { "description": "Service response. Error status and envelope depend on the operation." } }, "security": [] }, "delete": { "operationId": "platform_delete__carddav", "summary": "carddav root redirect", "tags": [ "carddav" ], "parameters": [], "description": "Authorization and validation are enforced by the owning service.", "x-handler": "carddav_root_redirect", "x-source-file": "crates/synckhub-server/src/routes/carddav.rs", "x-source-line": 47, "responses": { "default": { "description": "Service response. Error status and envelope depend on the operation." } }, "security": [] }, "head": { "operationId": "platform_head__carddav", "summary": "carddav root redirect", "tags": [ "carddav" ], "parameters": [], "description": "Authorization and validation are enforced by the owning service.", "x-handler": "carddav_root_redirect", "x-source-file": "crates/synckhub-server/src/routes/carddav.rs", "x-source-line": 47, "responses": { "default": { "description": "Service response. Error status and envelope depend on the operation." } }, "security": [] }, "options": { "operationId": "platform_options__carddav", "summary": "carddav root redirect", "tags": [ "carddav" ], "parameters": [], "description": "Authorization and validation are enforced by the owning service.", "x-handler": "carddav_root_redirect", "x-source-file": "crates/synckhub-server/src/routes/carddav.rs", "x-source-line": 47, "responses": { "default": { "description": "Service response. Error status and envelope depend on the operation." } }, "security": [] }, "trace": { "operationId": "platform_trace__carddav", "summary": "carddav root redirect", "tags": [ "carddav" ], "parameters": [], "description": "Authorization and validation are enforced by the owning service.", "x-handler": "carddav_root_redirect", "x-source-file": "crates/synckhub-server/src/routes/carddav.rs", "x-source-line": 47, "responses": { "default": { "description": "Service response. Error status and envelope depend on the operation." } }, "security": [] } }, "/carddav/": { "get": { "operationId": "platform_get__carddav_", "summary": "carddav protocol", "tags": [ "carddav" ], "parameters": [], "description": "Authorization and validation are enforced by the owning service.\n\nCardDAV also supports **PROPFIND** and **REPORT** (XML requests and responses). Authenticate with a scoped CardDAV app password using HTTP Basic. These DAV methods are recorded in x-additional-http-methods because OpenAPI has no operation keys for them.", "x-handler": "carddav_protocol", "x-source-file": "crates/synckhub-server/src/routes/carddav.rs", "x-source-line": 47, "responses": { "default": { "description": "Service response. Error status and envelope depend on the operation." } }, "security": [ { "carddavPassword": [] } ] }, "head": { "operationId": "platform_head__carddav_", "summary": "carddav protocol", "tags": [ "carddav" ], "parameters": [], "description": "Authorization and validation are enforced by the owning service.\n\nCardDAV also supports **PROPFIND** and **REPORT** (XML requests and responses). Authenticate with a scoped CardDAV app password using HTTP Basic. These DAV methods are recorded in x-additional-http-methods because OpenAPI has no operation keys for them.", "x-handler": "carddav_protocol", "x-source-file": "crates/synckhub-server/src/routes/carddav.rs", "x-source-line": 47, "responses": { "default": { "description": "Service response. Error status and envelope depend on the operation." } }, "security": [ { "carddavPassword": [] } ] }, "put": { "operationId": "platform_put__carddav_", "summary": "carddav protocol", "tags": [ "carddav" ], "parameters": [], "description": "Authorization and validation are enforced by the owning service.\n\nCardDAV also supports **PROPFIND** and **REPORT** (XML requests and responses). Authenticate with a scoped CardDAV app password using HTTP Basic. These DAV methods are recorded in x-additional-http-methods because OpenAPI has no operation keys for them.", "x-handler": "carddav_protocol", "x-source-file": "crates/synckhub-server/src/routes/carddav.rs", "x-source-line": 47, "responses": { "default": { "description": "Service response. Error status and envelope depend on the operation." } }, "security": [ { "carddavPassword": [] } ], "requestBody": { "required": true, "content": { "text/vcard": { "schema": { "type": "string" } } } } }, "delete": { "operationId": "platform_delete__carddav_", "summary": "carddav protocol", "tags": [ "carddav" ], "parameters": [], "description": "Authorization and validation are enforced by the owning service.\n\nCardDAV also supports **PROPFIND** and **REPORT** (XML requests and responses). Authenticate with a scoped CardDAV app password using HTTP Basic. These DAV methods are recorded in x-additional-http-methods because OpenAPI has no operation keys for them.", "x-handler": "carddav_protocol", "x-source-file": "crates/synckhub-server/src/routes/carddav.rs", "x-source-line": 47, "responses": { "default": { "description": "Service response. Error status and envelope depend on the operation." } }, "security": [ { "carddavPassword": [] } ] }, "options": { "operationId": "platform_options__carddav_", "summary": "carddav protocol", "tags": [ "carddav" ], "parameters": [], "description": "Authorization and validation are enforced by the owning service.\n\nCardDAV also supports **PROPFIND** and **REPORT** (XML requests and responses). Authenticate with a scoped CardDAV app password using HTTP Basic. These DAV methods are recorded in x-additional-http-methods because OpenAPI has no operation keys for them.", "x-handler": "carddav_protocol", "x-source-file": "crates/synckhub-server/src/routes/carddav.rs", "x-source-line": 47, "responses": { "default": { "description": "Service response. Error status and envelope depend on the operation." } }, "security": [] }, "x-additional-http-methods": [ "PROPFIND", "REPORT" ] }, "/carddav/{path}": { "get": { "operationId": "platform_get__carddav__path_", "summary": "carddav protocol", "tags": [ "carddav" ], "parameters": [ { "name": "path", "in": "path", "required": true, "schema": { "type": "string" }, "description": "Catch-all path; may contain slash-separated segments." } ], "description": "Authorization and validation are enforced by the owning service.\n\nCardDAV also supports **PROPFIND** and **REPORT** (XML requests and responses). Authenticate with a scoped CardDAV app password using HTTP Basic. These DAV methods are recorded in x-additional-http-methods because OpenAPI has no operation keys for them.", "x-handler": "carddav_protocol", "x-source-file": "crates/synckhub-server/src/routes/carddav.rs", "x-source-line": 47, "responses": { "default": { "description": "Service response. Error status and envelope depend on the operation." } }, "security": [ { "carddavPassword": [] } ] }, "head": { "operationId": "platform_head__carddav__path_", "summary": "carddav protocol", "tags": [ "carddav" ], "parameters": [ { "name": "path", "in": "path", "required": true, "schema": { "type": "string" }, "description": "Catch-all path; may contain slash-separated segments." } ], "description": "Authorization and validation are enforced by the owning service.\n\nCardDAV also supports **PROPFIND** and **REPORT** (XML requests and responses). Authenticate with a scoped CardDAV app password using HTTP Basic. These DAV methods are recorded in x-additional-http-methods because OpenAPI has no operation keys for them.", "x-handler": "carddav_protocol", "x-source-file": "crates/synckhub-server/src/routes/carddav.rs", "x-source-line": 47, "responses": { "default": { "description": "Service response. Error status and envelope depend on the operation." } }, "security": [ { "carddavPassword": [] } ] }, "put": { "operationId": "platform_put__carddav__path_", "summary": "carddav protocol", "tags": [ "carddav" ], "parameters": [ { "name": "path", "in": "path", "required": true, "schema": { "type": "string" }, "description": "Catch-all path; may contain slash-separated segments." } ], "description": "Authorization and validation are enforced by the owning service.\n\nCardDAV also supports **PROPFIND** and **REPORT** (XML requests and responses). Authenticate with a scoped CardDAV app password using HTTP Basic. These DAV methods are recorded in x-additional-http-methods because OpenAPI has no operation keys for them.", "x-handler": "carddav_protocol", "x-source-file": "crates/synckhub-server/src/routes/carddav.rs", "x-source-line": 47, "responses": { "default": { "description": "Service response. Error status and envelope depend on the operation." } }, "security": [ { "carddavPassword": [] } ], "requestBody": { "required": true, "content": { "text/vcard": { "schema": { "type": "string" } } } } }, "delete": { "operationId": "platform_delete__carddav__path_", "summary": "carddav protocol", "tags": [ "carddav" ], "parameters": [ { "name": "path", "in": "path", "required": true, "schema": { "type": "string" }, "description": "Catch-all path; may contain slash-separated segments." } ], "description": "Authorization and validation are enforced by the owning service.\n\nCardDAV also supports **PROPFIND** and **REPORT** (XML requests and responses). Authenticate with a scoped CardDAV app password using HTTP Basic. These DAV methods are recorded in x-additional-http-methods because OpenAPI has no operation keys for them.", "x-handler": "carddav_protocol", "x-source-file": "crates/synckhub-server/src/routes/carddav.rs", "x-source-line": 47, "responses": { "default": { "description": "Service response. Error status and envelope depend on the operation." } }, "security": [ { "carddavPassword": [] } ] }, "options": { "operationId": "platform_options__carddav__path_", "summary": "carddav protocol", "tags": [ "carddav" ], "parameters": [ { "name": "path", "in": "path", "required": true, "schema": { "type": "string" }, "description": "Catch-all path; may contain slash-separated segments." } ], "description": "Authorization and validation are enforced by the owning service.\n\nCardDAV also supports **PROPFIND** and **REPORT** (XML requests and responses). Authenticate with a scoped CardDAV app password using HTTP Basic. These DAV methods are recorded in x-additional-http-methods because OpenAPI has no operation keys for them.", "x-handler": "carddav_protocol", "x-source-file": "crates/synckhub-server/src/routes/carddav.rs", "x-source-line": 47, "responses": { "default": { "description": "Service response. Error status and envelope depend on the operation." } }, "security": [] }, "x-additional-http-methods": [ "PROPFIND", "REPORT" ] }, "/health": { "get": { "operationId": "platform_get__health", "summary": "health", "tags": [ "authz" ], "parameters": [], "description": "Authorization and validation are enforced by the owning service.", "x-handler": "health", "x-source-file": "crates/synckhub-server/src/routes/authz.rs", "x-source-line": 6602, "responses": { "default": { "description": "Service response. Error status and envelope depend on the operation." } }, "security": [] }, "head": { "operationId": "platform_head__health", "summary": "health", "tags": [ "authz" ], "parameters": [], "description": "Authorization and validation are enforced by the owning service.\n\nHEAD uses the GET handler and headers without a response body.", "x-handler": "health", "x-source-file": "crates/synckhub-server/src/routes/authz.rs", "x-source-line": 6602, "x-implicit-head": true, "responses": { "default": { "description": "Service response. Error status and envelope depend on the operation." } } } }, "/healthz": { "get": { "operationId": "platform_get__healthz", "summary": "healthz", "tags": [ "authz" ], "parameters": [], "description": "Authorization and validation are enforced by the owning service.", "x-handler": "healthz", "x-source-file": "crates/synckhub-server/src/routes/authz.rs", "x-source-line": 6602, "responses": { "default": { "description": "Service response. Error status and envelope depend on the operation." } }, "security": [] }, "head": { "operationId": "platform_head__healthz", "summary": "healthz", "tags": [ "authz" ], "parameters": [], "description": "Authorization and validation are enforced by the owning service.\n\nHEAD uses the GET handler and headers without a response body.", "x-handler": "healthz", "x-source-file": "crates/synckhub-server/src/routes/authz.rs", "x-source-line": 6602, "x-implicit-head": true, "responses": { "default": { "description": "Service response. Error status and envelope depend on the operation." } } } }, "/internal/ai/runs/{run_id}/events": { "post": { "operationId": "platform_post__internal_ai_runs__run_id__events", "summary": "Runtime callback for run events", "tags": [ "ai · runtime" ], "parameters": [ { "name": "run_id", "in": "path", "required": true, "schema": { "type": "string", "format": "uuid" } } ], "description": "Authorization and validation are enforced by the owning service.", "x-handler": "ai_runtime_events_callback", "x-source-file": "crates/synckhub-server/src/routes/ai/runtime.rs", "x-source-line": 263, "responses": { "200": { "description": "Callback accepted", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/AiRuntimeCallbackResponse" } } } } }, "requestBody": { "required": true, "content": { "application/json": { "schema": { "$ref": "#/components/schemas/AiRuntimeCallbackRequest" } } } }, "x-internal": true } }, "/internal/ai/runs/{run_id}/input-attachments": { "post": { "operationId": "platform_post__internal_ai_runs__run_id__input_attachments", "summary": "Resolve bounded attachment content under the running agent initiator permissions", "tags": [ "ai · runtime" ], "parameters": [ { "name": "run_id", "in": "path", "required": true, "schema": { "type": "string", "format": "uuid" } }, { "name": "x-synck-ai-runtime-secret", "in": "header", "required": true, "schema": { "type": "string" } } ], "description": "Authorization and validation are enforced by the owning service.", "x-handler": "super::attachments::ai_runtime_input_attachments", "x-source-file": "crates/synckhub-server/src/routes/ai/runtime.rs", "x-source-line": 263, "responses": { "200": { "description": "At most 10 authorized attachments from the 64-message context; inline bytes, no public URLs", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/AiRuntimeAttachmentInputs" } } } }, "403": { "description": "Current initiator cannot read the chat or linked file" }, "404": { "description": "Invalid runtime secret, missing run, or hidden chat/file" }, "409": { "description": "Run/lease invalid or attachment unsupported, missing, unavailable, or over budget" } }, "x-internal": true } }, "/internal/ai/runs/{run_id}/provider-credential": { "post": { "operationId": "platform_post__internal_ai_runs__run_id__provider_credential", "summary": "Runtime resolver for the run-bound provider credential", "tags": [ "ai · runtime" ], "parameters": [ { "name": "run_id", "in": "path", "required": true, "schema": { "type": "string", "format": "uuid" } } ], "description": "Authorization and validation are enforced by the owning service.", "x-handler": "ai_runtime_provider_credential", "x-source-file": "crates/synckhub-server/src/routes/ai/runtime.rs", "x-source-line": 263, "responses": { "200": { "description": "Decrypted provider credential for this run only", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/AiRuntimeProviderCredentialResponse" } } } } }, "x-internal": true } }, "/internal/ai/runs/{run_id}/title": { "post": { "operationId": "platform_post__internal_ai_runs__run_id__title", "summary": "ai runtime title callback", "tags": [ "ai · runtime" ], "parameters": [ { "name": "run_id", "in": "path", "required": true, "schema": { "type": "string" } } ], "description": "Authorization and validation are enforced by the owning service.", "x-handler": "ai_runtime_title_callback", "x-source-file": "crates/synckhub-server/src/routes/ai/runtime.rs", "x-source-line": 263, "responses": { "default": { "description": "Platform error; branch on HTTP status and stable code, not the human-readable message.", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } } }, "2XX": { "description": "Successful JSON response", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/synckhub_server.routes.ai.runtime.AiRuntimeTitleCallbackResponse" } } } } }, "requestBody": { "required": true, "content": { "application/json": { "schema": { "$ref": "#/components/schemas/synckhub_server.routes.ai.runtime.AiRuntimeTitleCallbackRequest" } } } } } }, "/internal/ai/runs/{run_id}/tools/approvals/{tool_call_id}/status": { "post": { "operationId": "platform_post__internal_ai_runs__run_id__tools_approvals__tool_call_id__status", "summary": "Runtime poll for tool approval status", "tags": [ "ai · runtime" ], "parameters": [ { "name": "run_id", "in": "path", "required": true, "schema": { "type": "string", "format": "uuid" } }, { "name": "tool_call_id", "in": "path", "required": true, "schema": { "type": "string" } } ], "description": "Authorization and validation are enforced by the owning service.", "x-handler": "ai_runtime_tool_approval_status", "x-source-file": "crates/synckhub-server/src/routes/ai/runtime.rs", "x-source-line": 263, "responses": { "200": { "description": "Approval status", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/AiRuntimeToolApprovalStatusResponse" } } } } }, "requestBody": { "required": true, "content": { "application/json": { "schema": { "$ref": "#/components/schemas/AiRuntimeToolApprovalStatusRequest" } } } }, "x-internal": true } }, "/internal/ai/runs/{run_id}/tools/execute": { "post": { "operationId": "platform_post__internal_ai_runs__run_id__tools_execute", "summary": "Runtime tool execution bridge", "tags": [ "ai · runtime" ], "parameters": [ { "name": "run_id", "in": "path", "required": true, "schema": { "type": "string", "format": "uuid" } } ], "description": "Authorization and validation are enforced by the owning service.", "x-handler": "ai_runtime_execute_tool", "x-source-file": "crates/synckhub-server/src/routes/ai/runtime.rs", "x-source-line": 263, "responses": { "200": { "description": "Tool result", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/AiRuntimeToolExecuteResponse" } } } } }, "requestBody": { "required": true, "content": { "application/json": { "schema": { "$ref": "#/components/schemas/AiRuntimeToolExecuteRequest" } } } }, "x-internal": true } }, "/internal/federation/connected-direct-chats/admit": { "post": { "operationId": "platform_post__internal_federation_connected_direct_chats_admit", "summary": "admit connected direct chat", "tags": [ "chat · connections" ], "parameters": [], "description": "Authorization and validation are enforced by the owning service.", "x-handler": "admit_connected_direct_chat", "x-source-file": "crates/synckhub-server/src/routes/chat/connections.rs", "x-source-line": 44, "responses": { "default": { "description": "Platform error; branch on HTTP status and stable code, not the human-readable message.", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } } }, "2XX": { "description": "Successful JSON response", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/synckhub_federation.clearinghouse.AcceptInviteResult" } } } } }, "requestBody": { "required": true, "content": { "application/json": { "schema": { "$ref": "#/components/schemas/synckhub_server.routes.chat.connections.ConnectedChatAdmissionBody" } } } } } }, "/maintenance/background-jobs/status": { "get": { "operationId": "platform_get__maintenance_background_jobs_status", "summary": "get background jobs status", "tags": [ "maintenance" ], "parameters": [ { "name": "kind", "in": "query", "required": false, "schema": { "anyOf": [ { "type": "string" }, { "type": "null" } ] } }, { "name": "state", "in": "query", "required": false, "schema": { "anyOf": [ { "type": "string" }, { "type": "null" } ] } }, { "name": "limit", "in": "query", "required": false, "schema": { "anyOf": [ { "type": "integer" }, { "type": "null" } ] } }, { "name": "offset", "in": "query", "required": false, "schema": { "anyOf": [ { "type": "integer" }, { "type": "null" } ] } } ], "description": "Authorization and validation are enforced by the owning service.", "x-handler": "get_background_jobs_status", "x-source-file": "crates/synckhub-server/src/routes/maintenance.rs", "x-source-line": 17, "responses": { "default": { "description": "Platform error; branch on HTTP status and stable code, not the human-readable message.", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } } }, "2XX": { "description": "Successful JSON response", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/synckhub_server.routes.maintenance.BackgroundJobsStatusResponse" } } } } } }, "head": { "operationId": "platform_head__maintenance_background_jobs_status", "summary": "get background jobs status", "tags": [ "maintenance" ], "parameters": [ { "name": "kind", "in": "query", "required": false, "schema": { "anyOf": [ { "type": "string" }, { "type": "null" } ] } }, { "name": "state", "in": "query", "required": false, "schema": { "anyOf": [ { "type": "string" }, { "type": "null" } ] } }, { "name": "limit", "in": "query", "required": false, "schema": { "anyOf": [ { "type": "integer" }, { "type": "null" } ] } }, { "name": "offset", "in": "query", "required": false, "schema": { "anyOf": [ { "type": "integer" }, { "type": "null" } ] } } ], "description": "Authorization and validation are enforced by the owning service.\n\nHEAD uses the GET handler and headers without a response body.", "x-handler": "get_background_jobs_status", "x-source-file": "crates/synckhub-server/src/routes/maintenance.rs", "x-source-line": 17, "x-implicit-head": true, "responses": { "default": { "description": "Platform error; branch on HTTP status and stable code, not the human-readable message." } } } }, "/maintenance/common/authz_snapshot/materializer-progress": { "get": { "operationId": "platform_get__maintenance_common_authz_snapshot_materializer_progress", "summary": "common authz snapshot materializer progress", "tags": [ "authz" ], "parameters": [], "description": "Authorization and validation are enforced by the owning service.\n\nThis route does not require the normal user bearer session. Link/download tokens, OAuth state, or webhook verification are validated by its handler where applicable.", "x-handler": "common_authz_snapshot_materializer_progress", "x-source-file": "crates/synckhub-server/src/routes/authz.rs", "x-source-line": 6602, "responses": { "default": { "description": "Platform error; branch on HTTP status and stable code, not the human-readable message.", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } } }, "2XX": { "description": "Successful JSON response", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/synckhub_server.routes.authz.CommonAuthzSnapshotMaterializerProgressResponse" } } } } }, "security": [] }, "head": { "operationId": "platform_head__maintenance_common_authz_snapshot_materializer_progress", "summary": "common authz snapshot materializer progress", "tags": [ "authz" ], "parameters": [], "description": "Authorization and validation are enforced by the owning service.\n\nHEAD uses the GET handler and headers without a response body.", "x-handler": "common_authz_snapshot_materializer_progress", "x-source-file": "crates/synckhub-server/src/routes/authz.rs", "x-source-line": 6602, "x-implicit-head": true, "responses": { "default": { "description": "Platform error; branch on HTTP status and stable code, not the human-readable message." } } } }, "/maintenance/common/authz_snapshot/notify": { "post": { "operationId": "platform_post__maintenance_common_authz_snapshot_notify", "summary": "common authz snapshot notify", "tags": [ "authz" ], "parameters": [], "description": "Authorization and validation are enforced by the owning service.", "x-handler": "common_authz_snapshot_notify", "x-source-file": "crates/synckhub-server/src/routes/authz.rs", "x-source-line": 6602, "responses": { "default": { "description": "Service response. Error status and envelope depend on the operation." } }, "requestBody": { "required": true, "content": { "application/json": { "schema": { "$ref": "#/components/schemas/synckhub_server.routes.authz.CommonAuthzSnapshotNotifyRequest" } } } } } }, "/maintenance/common/authz_snapshot/repair-local-materializers": { "post": { "operationId": "platform_post__maintenance_common_authz_snapshot_repair_local_materializers", "summary": "common authz snapshot repair local materializers", "tags": [ "authz" ], "parameters": [], "description": "Authorization and validation are enforced by the owning service.", "x-handler": "common_authz_snapshot_repair_local_materializers", "x-source-file": "crates/synckhub-server/src/routes/authz.rs", "x-source-line": 6602, "responses": { "default": { "description": "Service response. Error status and envelope depend on the operation." } }, "requestBody": { "required": true, "content": { "application/json": { "schema": { "$ref": "#/components/schemas/synckhub_server.routes.authz.CommonAuthzSnapshotRepairLocalMaterializersRequest" } } } } } }, "/maintenance/common/authz_snapshot/trigger": { "post": { "operationId": "platform_post__maintenance_common_authz_snapshot_trigger", "summary": "common authz snapshot trigger", "tags": [ "authz" ], "parameters": [], "description": "Authorization and validation are enforced by the owning service.", "x-handler": "common_authz_snapshot_trigger", "x-source-file": "crates/synckhub-server/src/routes/authz.rs", "x-source-line": 6602, "responses": { "default": { "description": "Service response. Error status and envelope depend on the operation." } }, "requestBody": { "required": true, "content": { "application/json": { "schema": { "$ref": "#/components/schemas/synckhub_server.routes.authz.CommonAuthzSnapshotNotifyRequest" } } } } } }, "/maintenance/common/repo_provisioning/notify": { "post": { "operationId": "platform_post__maintenance_common_repo_provisioning_notify", "summary": "common repo provisioning notify", "tags": [ "authz" ], "parameters": [], "description": "Authorization and validation are enforced by the owning service.", "x-handler": "common_repo_provisioning_notify", "x-source-file": "crates/synckhub-server/src/routes/authz.rs", "x-source-line": 6602, "responses": { "default": { "description": "Service response. Error status and envelope depend on the operation." } }, "requestBody": { "required": true, "content": { "application/json": { "schema": { "$ref": "#/components/schemas/synckhub_server.routes.authz.CommonRepoProvisioningNotifyRequest" } } } } } }, "/maintenance/common/sync/status": { "get": { "operationId": "platform_get__maintenance_common_sync_status", "summary": "common sync status", "tags": [ "authz" ], "parameters": [], "description": "Authorization and validation are enforced by the owning service.", "x-handler": "common_sync_status", "x-source-file": "crates/synckhub-server/src/routes/authz.rs", "x-source-line": 6602, "responses": { "default": { "description": "Platform error; branch on HTTP status and stable code, not the human-readable message.", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } } }, "2XX": { "description": "Successful JSON response", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/synckhub_server.routes.authz.CommonSyncStatusResponse" } } } } } }, "head": { "operationId": "platform_head__maintenance_common_sync_status", "summary": "common sync status", "tags": [ "authz" ], "parameters": [], "description": "Authorization and validation are enforced by the owning service.\n\nHEAD uses the GET handler and headers without a response body.", "x-handler": "common_sync_status", "x-source-file": "crates/synckhub-server/src/routes/authz.rs", "x-source-line": 6602, "x-implicit-head": true, "responses": { "default": { "description": "Platform error; branch on HTTP status and stable code, not the human-readable message." } } } }, "/maintenance/drain": { "post": { "operationId": "platform_post__maintenance_drain", "summary": "drain process", "tags": [ "authz" ], "parameters": [], "description": "Authorization and validation are enforced by the owning service.", "x-handler": "drain_process", "x-source-file": "crates/synckhub-server/src/routes/authz.rs", "x-source-line": 6602, "responses": { "default": { "description": "Service response. Error status and envelope depend on the operation." }, "2XX": { "description": "Successful JSON response", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/synckhub_server.routes.authz.DrainResponse" } } } } } } }, "/maintenance/federation/wakeup": { "post": { "operationId": "platform_post__maintenance_federation_wakeup", "summary": "federation wakeup notify", "tags": [ "authz" ], "parameters": [], "description": "Authorization and validation are enforced by the owning service.", "x-handler": "federation_wakeup_notify", "x-source-file": "crates/synckhub-server/src/routes/authz.rs", "x-source-line": 6602, "responses": { "default": { "description": "Service response. Error status and envelope depend on the operation." } }, "requestBody": { "required": true, "content": { "application/json": { "schema": { "$ref": "#/components/schemas/synckhub_federation_protocol.types.FederationWakeupWebhookV1" } } } } } }, "/maintenance/indexing/document-content/rederive": { "post": { "operationId": "platform_post__maintenance_indexing_document_content_rederive", "summary": "rederive document content markdown", "tags": [ "maintenance" ], "parameters": [], "description": "Authorization and validation are enforced by the owning service.", "x-handler": "rederive_document_content_markdown", "x-source-file": "crates/synckhub-server/src/routes/maintenance.rs", "x-source-line": 17, "responses": { "default": { "description": "Platform error; branch on HTTP status and stable code, not the human-readable message.", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } } }, "2XX": { "description": "Successful JSON response", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/synckhub_server.document_content_rederive_job.DocumentContentRederiveRun" } } } } }, "requestBody": { "required": true, "content": { "application/json": { "schema": { "$ref": "#/components/schemas/synckhub_server.routes.maintenance.RederiveDocumentContentMarkdownRequest" } } } } } }, "/maintenance/indexing/document-content/status": { "get": { "operationId": "platform_get__maintenance_indexing_document_content_status", "summary": "get document content status", "tags": [ "maintenance" ], "parameters": [], "description": "Authorization and validation are enforced by the owning service.", "x-handler": "get_document_content_status", "x-source-file": "crates/synckhub-server/src/routes/maintenance.rs", "x-source-line": 17, "responses": { "default": { "description": "Platform error; branch on HTTP status and stable code, not the human-readable message.", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } } }, "2XX": { "description": "Successful JSON response", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/synckhub_server.routes.maintenance.IndexingDocumentContentStatus" } } } } } }, "head": { "operationId": "platform_head__maintenance_indexing_document_content_status", "summary": "get document content status", "tags": [ "maintenance" ], "parameters": [], "description": "Authorization and validation are enforced by the owning service.\n\nHEAD uses the GET handler and headers without a response body.", "x-handler": "get_document_content_status", "x-source-file": "crates/synckhub-server/src/routes/maintenance.rs", "x-source-line": 17, "x-implicit-head": true, "responses": { "default": { "description": "Platform error; branch on HTTP status and stable code, not the human-readable message." } } } }, "/maintenance/indexing/pause": { "post": { "operationId": "platform_post__maintenance_indexing_pause", "summary": "pause global indexing", "tags": [ "maintenance" ], "parameters": [], "description": "Authorization and validation are enforced by the owning service.", "x-handler": "pause_global_indexing", "x-source-file": "crates/synckhub-server/src/routes/maintenance.rs", "x-source-line": 17, "responses": { "default": { "description": "Platform error; branch on HTTP status and stable code, not the human-readable message.", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } } }, "2XX": { "description": "Successful JSON response", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/synckhub_server.routes.maintenance.IndexingPauseStatus" } } } } }, "requestBody": { "required": true, "content": { "application/json": { "schema": { "$ref": "#/components/schemas/synckhub_server.routes.maintenance.PauseIndexingRequest" } } } } } }, "/maintenance/indexing/resume": { "post": { "operationId": "platform_post__maintenance_indexing_resume", "summary": "resume global indexing", "tags": [ "maintenance" ], "parameters": [], "description": "Authorization and validation are enforced by the owning service.", "x-handler": "resume_global_indexing", "x-source-file": "crates/synckhub-server/src/routes/maintenance.rs", "x-source-line": 17, "responses": { "default": { "description": "Platform error; branch on HTTP status and stable code, not the human-readable message.", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } } }, "2XX": { "description": "Successful JSON response", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/synckhub_server.routes.maintenance.IndexingPauseStatus" } } } } } } }, "/maintenance/indexing/runtime-controls": { "put": { "operationId": "platform_put__maintenance_indexing_runtime_controls", "summary": "update indexing runtime controls", "tags": [ "maintenance" ], "parameters": [], "description": "Authorization and validation are enforced by the owning service.", "x-handler": "update_indexing_runtime_controls", "x-source-file": "crates/synckhub-server/src/routes/maintenance.rs", "x-source-line": 17, "responses": { "default": { "description": "Platform error; branch on HTTP status and stable code, not the human-readable message.", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } } }, "2XX": { "description": "Successful JSON response", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/synckhub_server.routes.maintenance.IndexingRuntimeControlsStatus" } } } } }, "requestBody": { "required": true, "content": { "application/json": { "schema": { "$ref": "#/components/schemas/synckhub_server.routes.maintenance.UpdateIndexingRuntimeControlsRequest" } } } } } }, "/maintenance/indexing/runtime-controls/status": { "get": { "operationId": "platform_get__maintenance_indexing_runtime_controls_status", "summary": "get indexing runtime controls status", "tags": [ "maintenance" ], "parameters": [], "description": "Authorization and validation are enforced by the owning service.", "x-handler": "get_indexing_runtime_controls_status", "x-source-file": "crates/synckhub-server/src/routes/maintenance.rs", "x-source-line": 17, "responses": { "default": { "description": "Platform error; branch on HTTP status and stable code, not the human-readable message.", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } } }, "2XX": { "description": "Successful JSON response", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/synckhub_server.routes.maintenance.IndexingRuntimeControlsStatus" } } } } } }, "head": { "operationId": "platform_head__maintenance_indexing_runtime_controls_status", "summary": "get indexing runtime controls status", "tags": [ "maintenance" ], "parameters": [], "description": "Authorization and validation are enforced by the owning service.\n\nHEAD uses the GET handler and headers without a response body.", "x-handler": "get_indexing_runtime_controls_status", "x-source-file": "crates/synckhub-server/src/routes/maintenance.rs", "x-source-line": 17, "x-implicit-head": true, "responses": { "default": { "description": "Platform error; branch on HTTP status and stable code, not the human-readable message." } } } }, "/maintenance/indexing/status": { "get": { "operationId": "platform_get__maintenance_indexing_status", "summary": "get global indexing status", "tags": [ "maintenance" ], "parameters": [], "description": "Authorization and validation are enforced by the owning service.", "x-handler": "get_global_indexing_status", "x-source-file": "crates/synckhub-server/src/routes/maintenance.rs", "x-source-line": 17, "responses": { "default": { "description": "Platform error; branch on HTTP status and stable code, not the human-readable message.", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } } }, "2XX": { "description": "Successful JSON response", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/synckhub_server.routes.maintenance.IndexingPauseStatus" } } } } } }, "head": { "operationId": "platform_head__maintenance_indexing_status", "summary": "get global indexing status", "tags": [ "maintenance" ], "parameters": [], "description": "Authorization and validation are enforced by the owning service.\n\nHEAD uses the GET handler and headers without a response body.", "x-handler": "get_global_indexing_status", "x-source-file": "crates/synckhub-server/src/routes/maintenance.rs", "x-source-line": 17, "x-implicit-head": true, "responses": { "default": { "description": "Platform error; branch on HTTP status and stable code, not the human-readable message." } } } }, "/maintenance/init": { "post": { "operationId": "platform_post__maintenance_init", "summary": "init platform", "tags": [ "authz" ], "parameters": [], "description": "Maintenance init endpoint.\n\nThe platform and core schemas are initialized when the HTTP service\nconstructs its `Platform` instance at startup. This endpoint exists as\nan explicit \"init\" hook for orchestrators; a successful response implies\nthat the service is up and the database schema has already been created.\n\nAuthorization and validation are enforced by the owning service.", "x-handler": "init_platform", "x-source-file": "crates/synckhub-server/src/routes/authz.rs", "x-source-line": 6602, "responses": { "default": { "description": "Service response. Error status and envelope depend on the operation." } } } }, "/maintenance/push/presence/status": { "get": { "operationId": "platform_get__maintenance_push_presence_status", "summary": "maintenance push presence status", "tags": [ "maintenance" ], "parameters": [ { "name": "user_id", "in": "query", "required": true, "schema": { "type": "string" } }, { "name": "include_sessions", "in": "query", "required": false, "schema": { "type": "boolean" } } ], "description": "Authorization and validation are enforced by the owning service.", "x-handler": "maintenance_push_presence_status", "x-source-file": "crates/synckhub-server/src/routes/maintenance.rs", "x-source-line": 17, "responses": { "default": { "description": "Platform error; branch on HTTP status and stable code, not the human-readable message.", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } } }, "2XX": { "description": "Successful JSON response", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/synckhub_server.routes.user_runtime.PresenceStatusResponse" } } } } } }, "head": { "operationId": "platform_head__maintenance_push_presence_status", "summary": "maintenance push presence status", "tags": [ "maintenance" ], "parameters": [ { "name": "user_id", "in": "query", "required": true, "schema": { "type": "string" } }, { "name": "include_sessions", "in": "query", "required": false, "schema": { "type": "boolean" } } ], "description": "Authorization and validation are enforced by the owning service.\n\nHEAD uses the GET handler and headers without a response body.", "x-handler": "maintenance_push_presence_status", "x-source-file": "crates/synckhub-server/src/routes/maintenance.rs", "x-source-line": 17, "x-implicit-head": true, "responses": { "default": { "description": "Platform error; branch on HTTP status and stable code, not the human-readable message." } } } }, "/maintenance/repos/{repo_id}/items/gc-tombstoned-by-age": { "post": { "operationId": "platform_post__maintenance_repos__repo_id__items_gc_tombstoned_by_age", "summary": "gc tombstoned by age", "tags": [ "maintenance" ], "parameters": [ { "name": "repo_id", "in": "path", "required": true, "schema": { "type": "string" } } ], "description": "GC projections for tombstoned items whose last `Item_Tombstone` event is\nolder than the given cutoff.\n\nAuthorization and validation are enforced by the owning service.", "x-handler": "gc_tombstoned_by_age", "x-source-file": "crates/synckhub-server/src/routes/maintenance.rs", "x-source-line": 17, "responses": { "default": { "description": "Platform error; branch on HTTP status and stable code, not the human-readable message.", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } } }, "2XX": { "description": "Successful JSON response", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/synckhub_core.types.GcSummary" } } } } }, "requestBody": { "required": true, "content": { "application/json": { "schema": { "$ref": "#/components/schemas/synckhub_server.routes.maintenance.GcTombstonedByAgeRequest" } } } } } }, "/maintenance/repos/{repo_id}/items/tombstone-trashed-by-age": { "post": { "operationId": "platform_post__maintenance_repos__repo_id__items_tombstone_trashed_by_age", "summary": "tombstone trashed by age", "tags": [ "maintenance" ], "parameters": [ { "name": "repo_id", "in": "path", "required": true, "schema": { "type": "string" } } ], "description": "Tombstone all trashed items whose last `Item_Trash` event is older than\nthe given cutoff.\n\nAuthorization and validation are enforced by the owning service.", "x-handler": "tombstone_trashed_by_age", "x-source-file": "crates/synckhub-server/src/routes/maintenance.rs", "x-source-line": 17, "responses": { "default": { "description": "Platform error; branch on HTTP status and stable code, not the human-readable message.", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } } }, "2XX": { "description": "Successful JSON response", "content": { "application/json": { "schema": { "type": "array", "items": { "$ref": "#/components/schemas/synckhub_core.types.ItemSummary" } } } } } }, "requestBody": { "required": true, "content": { "application/json": { "schema": { "$ref": "#/components/schemas/synckhub_server.routes.maintenance.TombstoneTrashedByAgeRequest" } } } } } }, "/maintenance/repos/{repo_id}/memberships/bootstrap-admin": { "post": { "operationId": "platform_post__maintenance_repos__repo_id__memberships_bootstrap_admin", "summary": "bootstrap admin membership", "tags": [ "authz" ], "parameters": [ { "name": "repo_id", "in": "path", "required": true, "schema": { "type": "string" } } ], "description": "Authorization and validation are enforced by the owning service.", "x-handler": "bootstrap_admin_membership", "x-source-file": "crates/synckhub-server/src/routes/authz.rs", "x-source-line": 6602, "responses": { "default": { "description": "Platform error; branch on HTTP status and stable code, not the human-readable message.", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } } } } } }, "/maintenance/repos/{repo_id}/users/{user_id}/offboarding-cleanup": { "post": { "operationId": "platform_post__maintenance_repos__repo_id__users__user_id__offboarding_cleanup", "summary": "repo user offboarding cleanup", "tags": [ "authz" ], "parameters": [ { "name": "repo_id", "in": "path", "required": true, "schema": { "type": "string" } }, { "name": "user_id", "in": "path", "required": true, "schema": { "type": "string" } } ], "description": "Authorization and validation are enforced by the owning service.", "x-handler": "repo_user_offboarding_cleanup", "x-source-file": "crates/synckhub-server/src/routes/authz.rs", "x-source-line": 6602, "responses": { "default": { "description": "Platform error; branch on HTTP status and stable code, not the human-readable message.", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } } }, "2XX": { "description": "Successful JSON response", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/synckhub_server.routes.authz.RepoUserOffboardingCleanupResponse" } } } } }, "requestBody": { "required": false, "content": { "application/json": { "schema": { "$ref": "#/components/schemas/synckhub_server.routes.authz.RepoUserOffboardingCleanupRequest" } } } } } }, "/maintenance/repos/create": { "post": { "operationId": "platform_post__maintenance_repos_create", "summary": "create repo", "tags": [ "authz" ], "parameters": [], "description": "Authorization and validation are enforced by the owning service.", "x-handler": "create_repo", "x-source-file": "crates/synckhub-server/src/routes/authz.rs", "x-source-line": 6602, "responses": { "default": { "description": "Platform error; branch on HTTP status and stable code, not the human-readable message.", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } } }, "2XX": { "description": "Successful JSON response", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/synckhub_server.routes.CreateRepoResponse" } } } } }, "requestBody": { "required": true, "content": { "application/json": { "schema": { "$ref": "#/components/schemas/synckhub_server.routes.CreateRepoRequest" } } } } } }, "/maintenance/uploads/gc": { "post": { "operationId": "platform_post__maintenance_uploads_gc", "summary": "gc uploads", "tags": [ "uploads" ], "parameters": [], "description": "Authorization and validation are enforced by the owning service.", "x-handler": "gc_uploads", "x-source-file": "crates/synckhub-server/src/routes/uploads.rs", "x-source-line": 980, "responses": { "default": { "description": "Platform error; branch on HTTP status and stable code, not the human-readable message.", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } } }, "2XX": { "description": "Successful JSON response", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/synckhub_server.routes.uploads.UploadsGcResponse" } } } } }, "requestBody": { "required": true, "content": { "application/json": { "schema": { "$ref": "#/components/schemas/synckhub_server.routes.uploads.UploadsGcRequest" } } } } } }, "/mcp": { "get": { "operationId": "platform_get__mcp", "summary": "MCP retired session method", "tags": [ "mcp" ], "parameters": [], "description": "Authorization and validation are enforced by the owning service.\n\nThe server uses stateless, JSON-only MCP transport. POST accepts JSON-RPC requests and notifications. GET and DELETE return 405 because legacy sessions are disabled.", "x-handler": "mcp::add_route", "x-source-file": "crates/synckhub-server/src/routes/mcp.rs", "x-source-line": 379, "responses": { "405": { "description": "Legacy session transport is disabled." }, "default": { "description": "Service response. Error status and envelope depend on the operation." } } }, "post": { "operationId": "platform_post__mcp", "summary": "MCP JSON-RPC request", "tags": [ "mcp" ], "parameters": [ { "name": "Accept", "in": "header", "required": true, "schema": { "type": "string", "example": "application/json, text/event-stream" } }, { "name": "MCP-Protocol-Version", "in": "header", "schema": { "type": "string" } } ], "description": "Authorization and validation are enforced by the owning service.\n\nThe server uses stateless, JSON-only MCP transport. POST accepts JSON-RPC requests and notifications. GET and DELETE return 405 because legacy sessions are disabled.", "x-handler": "mcp::add_route", "x-source-file": "crates/synckhub-server/src/routes/mcp.rs", "x-source-line": 379, "responses": { "default": { "description": "Service response. Error status and envelope depend on the operation." } }, "requestBody": { "required": true, "content": { "application/json": { "schema": { "type": "object", "description": "MCP JSON-RPC 2.0 request or notification." } } } } }, "delete": { "operationId": "platform_delete__mcp", "summary": "MCP retired session method", "tags": [ "mcp" ], "parameters": [], "description": "Authorization and validation are enforced by the owning service.\n\nThe server uses stateless, JSON-only MCP transport. POST accepts JSON-RPC requests and notifications. GET and DELETE return 405 because legacy sessions are disabled.", "x-handler": "mcp::add_route", "x-source-file": "crates/synckhub-server/src/routes/mcp.rs", "x-source-line": 379, "responses": { "405": { "description": "Legacy session transport is disabled." }, "default": { "description": "Service response. Error status and envelope depend on the operation." } } } }, "/metrics": { "get": { "operationId": "platform_get__metrics", "summary": "metrics", "tags": [ "authz" ], "parameters": [], "description": "Authorization and validation are enforced by the owning service.", "x-handler": "metrics", "x-source-file": "crates/synckhub-server/src/routes/authz.rs", "x-source-line": 6602, "responses": { "default": { "description": "Platform error; branch on HTTP status and stable code, not the human-readable message.", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } } } } }, "head": { "operationId": "platform_head__metrics", "summary": "metrics", "tags": [ "authz" ], "parameters": [], "description": "Authorization and validation are enforced by the owning service.\n\nHEAD uses the GET handler and headers without a response body.", "x-handler": "metrics", "x-source-file": "crates/synckhub-server/src/routes/authz.rs", "x-source-line": 6602, "x-implicit-head": true, "responses": { "default": { "description": "Platform error; branch on HTTP status and stable code, not the human-readable message." } } } }, "/openapi/integration-v1.json": { "get": { "operationId": "platform_get__openapi_integration_v1_json", "summary": "Get this OpenAPI document", "tags": [ "integration_openapi" ], "parameters": [], "description": "Authorization and validation are enforced by the owning service.", "x-handler": "get_integration_openapi", "x-source-file": "crates/synckhub-server/src/routes/integration_openapi.rs", "x-source-line": 12, "responses": { "200": { "description": "OpenAPI 3.1 document", "content": { "application/vnd.oai.openapi+json;version=3.1": { "schema": { "type": "object" } } } } }, "security": [] }, "head": { "operationId": "platform_head__openapi_integration_v1_json", "summary": "get integration openapi", "tags": [ "integration_openapi" ], "parameters": [], "description": "Authorization and validation are enforced by the owning service.\n\nHEAD uses the GET handler and headers without a response body.", "x-handler": "get_integration_openapi", "x-source-file": "crates/synckhub-server/src/routes/integration_openapi.rs", "x-source-line": 12, "x-implicit-head": true, "responses": { "default": { "description": "Service response. Error status and envelope depend on the operation." } }, "security": [] } }, "/public-space/repos/{repo_id}/docs/pages/{item_id}/markdown": { "get": { "operationId": "platform_get__public_space_repos__repo_id__docs_pages__item_id__markdown", "summary": "get public space docs page markdown", "tags": [ "docs" ], "parameters": [ { "name": "repo_id", "in": "path", "required": true, "schema": { "type": "string" } }, { "name": "item_id", "in": "path", "required": true, "schema": { "type": "string" } } ], "description": "Authorization and validation are enforced by the owning service.", "x-handler": "get_public_space_docs_page_markdown", "x-source-file": "crates/synckhub-server/src/routes/docs.rs", "x-source-line": 33, "responses": { "default": { "description": "Platform error; branch on HTTP status and stable code, not the human-readable message.", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } } } }, "security": [] }, "head": { "operationId": "platform_head__public_space_repos__repo_id__docs_pages__item_id__markdown", "summary": "get public space docs page markdown", "tags": [ "docs" ], "parameters": [ { "name": "repo_id", "in": "path", "required": true, "schema": { "type": "string" } }, { "name": "item_id", "in": "path", "required": true, "schema": { "type": "string" } } ], "description": "Authorization and validation are enforced by the owning service.\n\nHEAD uses the GET handler and headers without a response body.", "x-handler": "get_public_space_docs_page_markdown", "x-source-file": "crates/synckhub-server/src/routes/docs.rs", "x-source-line": 33, "x-implicit-head": true, "responses": { "default": { "description": "Platform error; branch on HTTP status and stable code, not the human-readable message." } }, "security": [] } }, "/public-space/repos/{repo_id}/docs/tree": { "get": { "operationId": "platform_get__public_space_repos__repo_id__docs_tree", "summary": "get public space docs tree", "tags": [ "docs" ], "parameters": [ { "name": "repo_id", "in": "path", "required": true, "schema": { "type": "string" } } ], "description": "Authorization and validation are enforced by the owning service.", "x-handler": "get_public_space_docs_tree", "x-source-file": "crates/synckhub-server/src/routes/docs.rs", "x-source-line": 33, "responses": { "default": { "description": "Platform error; branch on HTTP status and stable code, not the human-readable message.", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } } } }, "security": [] }, "head": { "operationId": "platform_head__public_space_repos__repo_id__docs_tree", "summary": "get public space docs tree", "tags": [ "docs" ], "parameters": [ { "name": "repo_id", "in": "path", "required": true, "schema": { "type": "string" } } ], "description": "Authorization and validation are enforced by the owning service.\n\nHEAD uses the GET handler and headers without a response body.", "x-handler": "get_public_space_docs_tree", "x-source-file": "crates/synckhub-server/src/routes/docs.rs", "x-source-line": 33, "x-implicit-head": true, "responses": { "default": { "description": "Platform error; branch on HTTP status and stable code, not the human-readable message." } }, "security": [] } }, "/public-space/repos/{repo_id}/items": { "get": { "operationId": "platform_get__public_space_repos__repo_id__items", "summary": "list public space items", "tags": [ "public_space" ], "parameters": [ { "name": "repo_id", "in": "path", "required": true, "schema": { "type": "string" } }, { "name": "item_type", "in": "query", "required": false, "schema": { "type": "array", "items": { "type": "string" } }, "style": "form", "explode": true }, { "name": "item_type_exclude", "in": "query", "required": false, "schema": { "type": "array", "items": { "type": "string" } }, "style": "form", "explode": true }, { "name": "item_subtype", "in": "query", "required": false, "schema": { "type": "array", "items": { "type": "string" } }, "style": "form", "explode": true }, { "name": "case_status", "in": "query", "required": false, "schema": { "type": "array", "items": { "type": "string" } }, "style": "form", "explode": true }, { "name": "file_extension", "in": "query", "required": false, "schema": { "type": "array", "items": { "type": "string" }, "description": "Optional FILE-branch filter (repeatable; ANY match), e.g. `file_extension=pdf`.\n\nValues are normalized to lowercase ASCII and stored without a leading dot." }, "style": "form", "explode": true }, { "name": "file_extension_exclude", "in": "query", "required": false, "schema": { "type": "array", "items": { "type": "string" }, "description": "Optional FILE-branch exclusion (repeatable; ANY match), e.g. `file_extension_exclude=eml`." }, "style": "form", "explode": true }, { "name": "quick_access", "in": "query", "required": false, "schema": { "anyOf": [ { "type": "boolean" }, { "type": "null" } ] } }, { "name": "parent_folder_id", "in": "query", "required": false, "schema": { "anyOf": [ { "type": "string" }, { "type": "null" } ], "description": "Optional parent folder filter:\n- `None` means no parent filter (all items in the repo).\n- `Some(id)` means direct children of the given folder id.\n- `Some(\"\")` means root items only (no parent folder)." } }, { "name": "in_trash", "in": "query", "required": false, "schema": { "anyOf": [ { "type": "boolean" }, { "type": "null" } ] } }, { "name": "tombstoned", "in": "query", "required": false, "schema": { "anyOf": [ { "type": "boolean" }, { "type": "null" } ] } }, { "name": "limit", "in": "query", "required": false, "schema": { "anyOf": [ { "type": "integer", "minimum": 0 }, { "type": "null" } ] } }, { "name": "offset", "in": "query", "required": false, "schema": { "anyOf": [ { "type": "integer", "minimum": 0 }, { "type": "null" } ] } }, { "name": "sort", "in": "query", "required": false, "schema": { "anyOf": [ { "$ref": "#/components/schemas/synckhub_core.types.ListItemsSort" }, { "type": "null" } ] } }, { "name": "order", "in": "query", "required": false, "schema": { "anyOf": [ { "$ref": "#/components/schemas/synckhub_core.types.ListItemsOrder" }, { "type": "null" } ] } }, { "name": "folders_first", "in": "query", "required": false, "schema": { "anyOf": [ { "type": "boolean" }, { "type": "null" } ] } }, { "name": "after_name", "in": "query", "required": false, "schema": { "anyOf": [ { "type": "string" }, { "type": "null" } ] } }, { "name": "after_item_id", "in": "query", "required": false, "schema": { "anyOf": [ { "type": "string" }, { "type": "null" } ] } }, { "name": "include", "in": "query", "required": false, "schema": { "anyOf": [ { "type": "string" }, { "type": "null" } ], "description": "Optional expansions (comma-separated), e.g. `include=breadcrumbs`." } } ], "description": "Authorization and validation are enforced by the owning service.", "x-handler": "list_public_space_items", "x-source-file": "crates/synckhub-server/src/routes/public_space.rs", "x-source-line": 16, "responses": { "default": { "description": "Platform error; branch on HTTP status and stable code, not the human-readable message.", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } } }, "2XX": { "description": "Successful JSON response", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/synckhub_server.routes.ListItemsResponse" } } } } }, "security": [] }, "head": { "operationId": "platform_head__public_space_repos__repo_id__items", "summary": "list public space items", "tags": [ "public_space" ], "parameters": [ { "name": "repo_id", "in": "path", "required": true, "schema": { "type": "string" } }, { "name": "item_type", "in": "query", "required": false, "schema": { "type": "array", "items": { "type": "string" } }, "style": "form", "explode": true }, { "name": "item_type_exclude", "in": "query", "required": false, "schema": { "type": "array", "items": { "type": "string" } }, "style": "form", "explode": true }, { "name": "item_subtype", "in": "query", "required": false, "schema": { "type": "array", "items": { "type": "string" } }, "style": "form", "explode": true }, { "name": "case_status", "in": "query", "required": false, "schema": { "type": "array", "items": { "type": "string" } }, "style": "form", "explode": true }, { "name": "file_extension", "in": "query", "required": false, "schema": { "type": "array", "items": { "type": "string" }, "description": "Optional FILE-branch filter (repeatable; ANY match), e.g. `file_extension=pdf`.\n\nValues are normalized to lowercase ASCII and stored without a leading dot." }, "style": "form", "explode": true }, { "name": "file_extension_exclude", "in": "query", "required": false, "schema": { "type": "array", "items": { "type": "string" }, "description": "Optional FILE-branch exclusion (repeatable; ANY match), e.g. `file_extension_exclude=eml`." }, "style": "form", "explode": true }, { "name": "quick_access", "in": "query", "required": false, "schema": { "anyOf": [ { "type": "boolean" }, { "type": "null" } ] } }, { "name": "parent_folder_id", "in": "query", "required": false, "schema": { "anyOf": [ { "type": "string" }, { "type": "null" } ], "description": "Optional parent folder filter:\n- `None` means no parent filter (all items in the repo).\n- `Some(id)` means direct children of the given folder id.\n- `Some(\"\")` means root items only (no parent folder)." } }, { "name": "in_trash", "in": "query", "required": false, "schema": { "anyOf": [ { "type": "boolean" }, { "type": "null" } ] } }, { "name": "tombstoned", "in": "query", "required": false, "schema": { "anyOf": [ { "type": "boolean" }, { "type": "null" } ] } }, { "name": "limit", "in": "query", "required": false, "schema": { "anyOf": [ { "type": "integer", "minimum": 0 }, { "type": "null" } ] } }, { "name": "offset", "in": "query", "required": false, "schema": { "anyOf": [ { "type": "integer", "minimum": 0 }, { "type": "null" } ] } }, { "name": "sort", "in": "query", "required": false, "schema": { "anyOf": [ { "$ref": "#/components/schemas/synckhub_core.types.ListItemsSort" }, { "type": "null" } ] } }, { "name": "order", "in": "query", "required": false, "schema": { "anyOf": [ { "$ref": "#/components/schemas/synckhub_core.types.ListItemsOrder" }, { "type": "null" } ] } }, { "name": "folders_first", "in": "query", "required": false, "schema": { "anyOf": [ { "type": "boolean" }, { "type": "null" } ] } }, { "name": "after_name", "in": "query", "required": false, "schema": { "anyOf": [ { "type": "string" }, { "type": "null" } ] } }, { "name": "after_item_id", "in": "query", "required": false, "schema": { "anyOf": [ { "type": "string" }, { "type": "null" } ] } }, { "name": "include", "in": "query", "required": false, "schema": { "anyOf": [ { "type": "string" }, { "type": "null" } ], "description": "Optional expansions (comma-separated), e.g. `include=breadcrumbs`." } } ], "description": "Authorization and validation are enforced by the owning service.\n\nHEAD uses the GET handler and headers without a response body.", "x-handler": "list_public_space_items", "x-source-file": "crates/synckhub-server/src/routes/public_space.rs", "x-source-line": 16, "x-implicit-head": true, "responses": { "default": { "description": "Platform error; branch on HTTP status and stable code, not the human-readable message." } }, "security": [] } }, "/public-space/repos/{repo_id}/items/{item_id}/content-url": { "get": { "operationId": "platform_get__public_space_repos__repo_id__items__item_id__content_url", "summary": "get public space item content url", "tags": [ "public_space" ], "parameters": [ { "name": "repo_id", "in": "path", "required": true, "schema": { "type": "string" } }, { "name": "item_id", "in": "path", "required": true, "schema": { "type": "string" } } ], "description": "Authorization and validation are enforced by the owning service.", "x-handler": "get_public_space_item_content_url", "x-source-file": "crates/synckhub-server/src/routes/public_space.rs", "x-source-line": 16, "responses": { "default": { "description": "Platform error; branch on HTTP status and stable code, not the human-readable message.", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } } }, "2XX": { "description": "Successful JSON response", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/synckhub_server.routes.files.content.CreateDownloadUrlResponse" } } } } }, "security": [] }, "head": { "operationId": "platform_head__public_space_repos__repo_id__items__item_id__content_url", "summary": "get public space item content url", "tags": [ "public_space" ], "parameters": [ { "name": "repo_id", "in": "path", "required": true, "schema": { "type": "string" } }, { "name": "item_id", "in": "path", "required": true, "schema": { "type": "string" } } ], "description": "Authorization and validation are enforced by the owning service.\n\nHEAD uses the GET handler and headers without a response body.", "x-handler": "get_public_space_item_content_url", "x-source-file": "crates/synckhub-server/src/routes/public_space.rs", "x-source-line": 16, "x-implicit-head": true, "responses": { "default": { "description": "Platform error; branch on HTTP status and stable code, not the human-readable message." } }, "security": [] } }, "/public-space/repos/{repo_id}/posts": { "get": { "operationId": "platform_get__public_space_repos__repo_id__posts", "summary": "list public space posts", "tags": [ "public_space" ], "parameters": [ { "name": "repo_id", "in": "path", "required": true, "schema": { "type": "string" } }, { "name": "limit", "in": "query", "required": false, "schema": { "anyOf": [ { "type": "integer" }, { "type": "null" } ] } } ], "description": "Authorization and validation are enforced by the owning service.", "x-handler": "list_public_space_posts", "x-source-file": "crates/synckhub-server/src/routes/public_space.rs", "x-source-line": 16, "responses": { "default": { "description": "Platform error; branch on HTTP status and stable code, not the human-readable message.", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } } }, "2XX": { "description": "Successful JSON response", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/synckhub_server.routes.public_space.PublicSpacePostsResponse" } } } } }, "security": [] }, "head": { "operationId": "platform_head__public_space_repos__repo_id__posts", "summary": "list public space posts", "tags": [ "public_space" ], "parameters": [ { "name": "repo_id", "in": "path", "required": true, "schema": { "type": "string" } }, { "name": "limit", "in": "query", "required": false, "schema": { "anyOf": [ { "type": "integer" }, { "type": "null" } ] } } ], "description": "Authorization and validation are enforced by the owning service.\n\nHEAD uses the GET handler and headers without a response body.", "x-handler": "list_public_space_posts", "x-source-file": "crates/synckhub-server/src/routes/public_space.rs", "x-source-line": 16, "x-implicit-head": true, "responses": { "default": { "description": "Platform error; branch on HTTP status and stable code, not the human-readable message." } }, "security": [] } }, "/public/folder-update-subscriptions/unsubscribe/{token}": { "post": { "operationId": "platform_post__public_folder_update_subscriptions_unsubscribe__token_", "summary": "unsubscribe folder update subscription", "tags": [ "authz" ], "parameters": [ { "name": "token", "in": "path", "required": true, "schema": { "type": "string" } } ], "description": "Authorization and validation are enforced by the owning service.", "x-handler": "unsubscribe_folder_update_subscription", "x-source-file": "crates/synckhub-server/src/routes/authz.rs", "x-source-line": 6602, "responses": { "default": { "description": "Platform error; branch on HTTP status and stable code, not the human-readable message.", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } } }, "2XX": { "description": "Successful JSON response", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/synckhub_server.routes.authz.FolderUpdateUnsubscribeResponse" } } } } } } }, "/readyz": { "get": { "operationId": "platform_get__readyz", "summary": "readyz", "tags": [ "authz" ], "parameters": [], "description": "Authorization and validation are enforced by the owning service.", "x-handler": "readyz", "x-source-file": "crates/synckhub-server/src/routes/authz.rs", "x-source-line": 6602, "responses": { "default": { "description": "Service response. Error status and envelope depend on the operation." } }, "security": [] }, "head": { "operationId": "platform_head__readyz", "summary": "readyz", "tags": [ "authz" ], "parameters": [], "description": "Authorization and validation are enforced by the owning service.\n\nHEAD uses the GET handler and headers without a response body.", "x-handler": "readyz", "x-source-file": "crates/synckhub-server/src/routes/authz.rs", "x-source-line": 6602, "x-implicit-head": true, "responses": { "default": { "description": "Service response. Error status and envelope depend on the operation." } } } }, "/repos/{repo_id}/activity": { "get": { "operationId": "platform_get__repos__repo_id__activity", "summary": "list unified activity", "tags": [ "activity" ], "parameters": [ { "name": "repo_id", "in": "path", "required": true, "schema": { "type": "string" } }, { "name": "folder_id", "in": "query", "required": false, "schema": { "anyOf": [ { "type": "string" }, { "type": "null" } ] } }, { "name": "client_ip", "in": "query", "required": false, "schema": { "anyOf": [ { "type": "string" }, { "type": "null" } ] } }, { "name": "outcome", "in": "query", "required": false, "schema": { "anyOf": [ { "type": "string" }, { "type": "null" } ] } }, { "name": "include_root", "in": "query", "required": false, "schema": { "anyOf": [ { "type": "boolean" }, { "type": "null" } ] } }, { "name": "limit", "in": "query", "required": false, "schema": { "anyOf": [ { "type": "integer", "minimum": 0 }, { "type": "null" } ] } }, { "name": "activity_source", "in": "query", "required": false, "schema": { "anyOf": [ { "type": "string" }, { "type": "null" } ] } }, { "name": "source", "in": "query", "required": false, "schema": { "anyOf": [ { "type": "string" }, { "type": "null" } ] } }, { "name": "event_category", "in": "query", "required": false, "schema": { "anyOf": [ { "type": "string" }, { "type": "null" } ] } }, { "name": "actor_id", "in": "query", "required": false, "schema": { "anyOf": [ { "type": "string" }, { "type": "null" } ] } }, { "name": "q", "in": "query", "required": false, "schema": { "anyOf": [ { "type": "string" }, { "type": "null" } ] } }, { "name": "occurred_at_from", "in": "query", "required": false, "schema": { "anyOf": [ { "type": "string" }, { "type": "null" } ] } }, { "name": "occurred_at_to", "in": "query", "required": false, "schema": { "anyOf": [ { "type": "string" }, { "type": "null" } ] } }, { "name": "after_occurred_at", "in": "query", "required": false, "schema": { "anyOf": [ { "type": "string" }, { "type": "null" } ] } }, { "name": "after_activity_source", "in": "query", "required": false, "schema": { "anyOf": [ { "type": "string" }, { "type": "null" } ] } }, { "name": "after_activity_id", "in": "query", "required": false, "schema": { "anyOf": [ { "type": "string" }, { "type": "null" } ] } } ], "description": "Authorization and validation are enforced by the owning service.", "x-handler": "list_unified_activity", "x-source-file": "crates/synckhub-server/src/routes/activity.rs", "x-source-line": 11, "responses": { "default": { "description": "Platform error; branch on HTTP status and stable code, not the human-readable message.", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } } }, "2XX": { "description": "Successful JSON response", "content": { "application/json": { "schema": { "type": "array", "items": { "$ref": "#/components/schemas/synckhub_server.routes.activity.ActivityWithContext" } } } } } } }, "head": { "operationId": "platform_head__repos__repo_id__activity", "summary": "list unified activity", "tags": [ "activity" ], "parameters": [ { "name": "repo_id", "in": "path", "required": true, "schema": { "type": "string" } }, { "name": "folder_id", "in": "query", "required": false, "schema": { "anyOf": [ { "type": "string" }, { "type": "null" } ] } }, { "name": "client_ip", "in": "query", "required": false, "schema": { "anyOf": [ { "type": "string" }, { "type": "null" } ] } }, { "name": "outcome", "in": "query", "required": false, "schema": { "anyOf": [ { "type": "string" }, { "type": "null" } ] } }, { "name": "include_root", "in": "query", "required": false, "schema": { "anyOf": [ { "type": "boolean" }, { "type": "null" } ] } }, { "name": "limit", "in": "query", "required": false, "schema": { "anyOf": [ { "type": "integer", "minimum": 0 }, { "type": "null" } ] } }, { "name": "activity_source", "in": "query", "required": false, "schema": { "anyOf": [ { "type": "string" }, { "type": "null" } ] } }, { "name": "source", "in": "query", "required": false, "schema": { "anyOf": [ { "type": "string" }, { "type": "null" } ] } }, { "name": "event_category", "in": "query", "required": false, "schema": { "anyOf": [ { "type": "string" }, { "type": "null" } ] } }, { "name": "actor_id", "in": "query", "required": false, "schema": { "anyOf": [ { "type": "string" }, { "type": "null" } ] } }, { "name": "q", "in": "query", "required": false, "schema": { "anyOf": [ { "type": "string" }, { "type": "null" } ] } }, { "name": "occurred_at_from", "in": "query", "required": false, "schema": { "anyOf": [ { "type": "string" }, { "type": "null" } ] } }, { "name": "occurred_at_to", "in": "query", "required": false, "schema": { "anyOf": [ { "type": "string" }, { "type": "null" } ] } }, { "name": "after_occurred_at", "in": "query", "required": false, "schema": { "anyOf": [ { "type": "string" }, { "type": "null" } ] } }, { "name": "after_activity_source", "in": "query", "required": false, "schema": { "anyOf": [ { "type": "string" }, { "type": "null" } ] } }, { "name": "after_activity_id", "in": "query", "required": false, "schema": { "anyOf": [ { "type": "string" }, { "type": "null" } ] } } ], "description": "Authorization and validation are enforced by the owning service.\n\nHEAD uses the GET handler and headers without a response body.", "x-handler": "list_unified_activity", "x-source-file": "crates/synckhub-server/src/routes/activity.rs", "x-source-line": 11, "x-implicit-head": true, "responses": { "default": { "description": "Platform error; branch on HTTP status and stable code, not the human-readable message." } } } }, "/repos/{repo_id}/ai/assistants": { "post": { "operationId": "platform_post__repos__repo_id__ai_assistants", "summary": "Create a repository AI assistant", "tags": [ "ai · assistants" ], "parameters": [ { "name": "repo_id", "in": "path", "required": true, "schema": { "type": "string", "format": "uuid" } } ], "description": "Authorization and validation are enforced by the owning service.", "x-handler": "ai_create_assistant", "x-source-file": "crates/synckhub-server/src/routes/ai/assistants.rs", "x-source-line": 12, "responses": { "200": { "description": "Created assistant", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/AiAssistantSummary" } } } } }, "requestBody": { "required": true, "content": { "application/json": { "schema": { "$ref": "#/components/schemas/AiAssistantUpsertRequest" } } } } }, "get": { "operationId": "platform_get__repos__repo_id__ai_assistants", "summary": "List AI assistants", "tags": [ "ai · assistants" ], "parameters": [ { "name": "repo_id", "in": "path", "required": true, "schema": { "type": "string", "format": "uuid" } } ], "description": "Requires active repository membership or platform administrator access; repo-wide READ_CONTENT is not required.", "x-handler": "ai_list_assistants", "x-source-file": "crates/synckhub-server/src/routes/ai/assistants.rs", "x-source-line": 12, "responses": { "200": { "description": "Assistants list", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/AiAssistantsListResponse" } } } } } }, "head": { "operationId": "platform_head__repos__repo_id__ai_assistants", "summary": "ai list assistants", "tags": [ "ai · assistants" ], "parameters": [ { "name": "repo_id", "in": "path", "required": true, "schema": { "type": "string" } } ], "description": "Authorization and validation are enforced by the owning service.\n\nHEAD uses the GET handler and headers without a response body.", "x-handler": "ai_list_assistants", "x-source-file": "crates/synckhub-server/src/routes/ai/assistants.rs", "x-source-line": 12, "x-implicit-head": true, "responses": { "default": { "description": "Platform error; branch on HTTP status and stable code, not the human-readable message." } } } }, "/repos/{repo_id}/ai/assistants/{assistant_id}": { "delete": { "operationId": "platform_delete__repos__repo_id__ai_assistants__assistant_id_", "summary": "Delete a repository AI assistant", "tags": [ "ai · assistants" ], "parameters": [ { "name": "repo_id", "in": "path", "required": true, "schema": { "type": "string", "format": "uuid" } }, { "name": "assistant_id", "in": "path", "required": true, "schema": { "type": "string" } } ], "description": "Authorization and validation are enforced by the owning service.", "x-handler": "ai_delete_assistant", "x-source-file": "crates/synckhub-server/src/routes/ai/assistants.rs", "x-source-line": 12, "responses": { "204": { "description": "Assistant deleted" } } }, "put": { "operationId": "platform_put__repos__repo_id__ai_assistants__assistant_id_", "summary": "Update a repository AI assistant", "tags": [ "ai · assistants" ], "parameters": [ { "name": "repo_id", "in": "path", "required": true, "schema": { "type": "string", "format": "uuid" } }, { "name": "assistant_id", "in": "path", "required": true, "schema": { "type": "string" } } ], "description": "Authorization and validation are enforced by the owning service.", "x-handler": "ai_update_assistant", "x-source-file": "crates/synckhub-server/src/routes/ai/assistants.rs", "x-source-line": 12, "responses": { "200": { "description": "Updated assistant", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/AiAssistantSummary" } } } } }, "requestBody": { "required": true, "content": { "application/json": { "schema": { "$ref": "#/components/schemas/AiAssistantUpsertRequest" } } } } } }, "/repos/{repo_id}/ai/email-sessions": { "post": { "operationId": "platform_post__repos__repo_id__ai_email_sessions", "summary": "Resolve the active temporary AI session for an email draft", "tags": [ "ai · email_sessions" ], "parameters": [ { "name": "repo_id", "in": "path", "required": true, "schema": { "type": "string", "format": "uuid" } } ], "description": "Authorization and validation are enforced by the owning service.", "x-handler": "resolve_email_session", "x-source-file": "crates/synckhub-server/src/routes/ai/email_sessions.rs", "x-source-line": 19, "responses": { "200": { "description": "Temporary email AI session", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/AiEmailSessionResponse" } } } } }, "requestBody": { "required": true, "content": { "application/json": { "schema": { "$ref": "#/components/schemas/AiEmailSessionResolveRequest" } } } } } }, "/repos/{repo_id}/ai/email-sessions/{session_id}": { "get": { "operationId": "platform_get__repos__repo_id__ai_email_sessions__session_id_", "summary": "Get a temporary email AI session and pane history", "tags": [ "ai · email_sessions" ], "parameters": [ { "name": "repo_id", "in": "path", "required": true, "schema": { "type": "string", "format": "uuid" } }, { "name": "session_id", "in": "path", "required": true, "schema": { "type": "string", "format": "uuid" } } ], "description": "Authorization and validation are enforced by the owning service.", "x-handler": "get_email_session", "x-source-file": "crates/synckhub-server/src/routes/ai/email_sessions.rs", "x-source-line": 19, "responses": { "200": { "description": "Temporary email AI session", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/AiEmailSessionResponse" } } } } } }, "head": { "operationId": "platform_head__repos__repo_id__ai_email_sessions__session_id_", "summary": "get email session", "tags": [ "ai · email_sessions" ], "parameters": [ { "name": "repo_id", "in": "path", "required": true, "schema": { "type": "string" } }, { "name": "session_id", "in": "path", "required": true, "schema": { "type": "string" } } ], "description": "Authorization and validation are enforced by the owning service.\n\nHEAD uses the GET handler and headers without a response body.", "x-handler": "get_email_session", "x-source-file": "crates/synckhub-server/src/routes/ai/email_sessions.rs", "x-source-line": 19, "x-implicit-head": true, "responses": { "default": { "description": "Platform error; branch on HTTP status and stable code, not the human-readable message." } } } }, "/repos/{repo_id}/ai/email-sessions/{session_id}/close": { "post": { "operationId": "platform_post__repos__repo_id__ai_email_sessions__session_id__close", "summary": "Close a temporary email AI session after confirmed send or discard", "tags": [ "ai · email_sessions" ], "parameters": [ { "name": "repo_id", "in": "path", "required": true, "schema": { "type": "string", "format": "uuid" } }, { "name": "session_id", "in": "path", "required": true, "schema": { "type": "string", "format": "uuid" } } ], "description": "Authorization and validation are enforced by the owning service.", "x-handler": "close_email_session", "x-source-file": "crates/synckhub-server/src/routes/ai/email_sessions.rs", "x-source-line": 19, "responses": { "200": { "description": "Closed email AI session", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/AiEmailSessionResponse" } } } } } } }, "/repos/{repo_id}/ai/email-sessions/{session_id}/runs": { "post": { "operationId": "platform_post__repos__repo_id__ai_email_sessions__session_id__runs", "summary": "Create a tool-free AI run for an email draft", "tags": [ "ai · email_sessions" ], "parameters": [ { "name": "repo_id", "in": "path", "required": true, "schema": { "type": "string", "format": "uuid" } }, { "name": "session_id", "in": "path", "required": true, "schema": { "type": "string", "format": "uuid" } } ], "description": "Authorization and validation are enforced by the owning service.", "x-handler": "create_email_run", "x-source-file": "crates/synckhub-server/src/routes/ai/email_sessions.rs", "x-source-line": 19, "responses": { "200": { "description": "Run summary", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/AiRunSummaryResponse" } } } } }, "requestBody": { "required": true, "content": { "application/json": { "schema": { "$ref": "#/components/schemas/AiEmailRunStartRequest" } } } } } }, "/repos/{repo_id}/ai/email-sessions/{session_id}/runs/{run_id}": { "get": { "operationId": "platform_get__repos__repo_id__ai_email_sessions__session_id__runs__run_id_", "summary": "Get an email AI run", "tags": [ "ai · email_sessions" ], "parameters": [ { "name": "repo_id", "in": "path", "required": true, "schema": { "type": "string", "format": "uuid" } }, { "name": "session_id", "in": "path", "required": true, "schema": { "type": "string", "format": "uuid" } }, { "name": "run_id", "in": "path", "required": true, "schema": { "type": "string", "format": "uuid" } } ], "description": "Authorization and validation are enforced by the owning service.", "x-handler": "get_email_run", "x-source-file": "crates/synckhub-server/src/routes/ai/email_sessions.rs", "x-source-line": 19, "responses": { "200": { "description": "Email AI run state", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/AiEmailRunStateResponse" } } } } } }, "head": { "operationId": "platform_head__repos__repo_id__ai_email_sessions__session_id__runs__run_id_", "summary": "get email run", "tags": [ "ai · email_sessions" ], "parameters": [ { "name": "repo_id", "in": "path", "required": true, "schema": { "type": "string" } }, { "name": "session_id", "in": "path", "required": true, "schema": { "type": "string" } }, { "name": "run_id", "in": "path", "required": true, "schema": { "type": "string" } } ], "description": "Authorization and validation are enforced by the owning service.\n\nHEAD uses the GET handler and headers without a response body.", "x-handler": "get_email_run", "x-source-file": "crates/synckhub-server/src/routes/ai/email_sessions.rs", "x-source-line": 19, "x-implicit-head": true, "responses": { "default": { "description": "Platform error; branch on HTTP status and stable code, not the human-readable message." } } } }, "/repos/{repo_id}/ai/email-sessions/{session_id}/runs/{run_id}/cancel": { "post": { "operationId": "platform_post__repos__repo_id__ai_email_sessions__session_id__runs__run_id__cancel", "summary": "Cancel an email AI run", "tags": [ "ai · email_sessions" ], "parameters": [ { "name": "repo_id", "in": "path", "required": true, "schema": { "type": "string", "format": "uuid" } }, { "name": "session_id", "in": "path", "required": true, "schema": { "type": "string", "format": "uuid" } }, { "name": "run_id", "in": "path", "required": true, "schema": { "type": "string", "format": "uuid" } } ], "description": "Authorization and validation are enforced by the owning service.", "x-handler": "cancel_email_run", "x-source-file": "crates/synckhub-server/src/routes/ai/email_sessions.rs", "x-source-line": 19, "responses": { "200": { "description": "Run summary", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/AiRunSummaryResponse" } } } } } } }, "/repos/{repo_id}/ai/email-sessions/{session_id}/runs/{run_id}/events": { "get": { "operationId": "platform_get__repos__repo_id__ai_email_sessions__session_id__runs__run_id__events", "summary": "Replay email AI run events", "tags": [ "ai · email_sessions" ], "parameters": [ { "name": "repo_id", "in": "path", "required": true, "schema": { "type": "string", "format": "uuid" } }, { "name": "session_id", "in": "path", "required": true, "schema": { "type": "string", "format": "uuid" } }, { "name": "run_id", "in": "path", "required": true, "schema": { "type": "string", "format": "uuid" } }, { "name": "after_seq", "in": "query", "schema": { "type": "integer", "minimum": 0 } }, { "name": "limit", "in": "query", "schema": { "type": "integer", "minimum": 1, "maximum": 1000 } } ], "description": "Authorization and validation are enforced by the owning service.", "x-handler": "get_email_run_events", "x-source-file": "crates/synckhub-server/src/routes/ai/email_sessions.rs", "x-source-line": 19, "responses": { "200": { "description": "Run events", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/AiRunEventsListResponse" } } } } } }, "head": { "operationId": "platform_head__repos__repo_id__ai_email_sessions__session_id__runs__run_id__events", "summary": "get email run events", "tags": [ "ai · email_sessions" ], "parameters": [ { "name": "repo_id", "in": "path", "required": true, "schema": { "type": "string" } }, { "name": "session_id", "in": "path", "required": true, "schema": { "type": "string" } }, { "name": "run_id", "in": "path", "required": true, "schema": { "type": "string" } }, { "name": "after_seq", "in": "query", "required": false, "schema": { "anyOf": [ { "type": "integer" }, { "type": "null" } ] } }, { "name": "limit", "in": "query", "required": false, "schema": { "anyOf": [ { "type": "integer", "minimum": 0 }, { "type": "null" } ] } } ], "description": "Authorization and validation are enforced by the owning service.\n\nHEAD uses the GET handler and headers without a response body.", "x-handler": "get_email_run_events", "x-source-file": "crates/synckhub-server/src/routes/ai/email_sessions.rs", "x-source-line": 19, "x-implicit-head": true, "responses": { "default": { "description": "Platform error; branch on HTTP status and stable code, not the human-readable message." } } } }, "/repos/{repo_id}/ai/tools": { "get": { "operationId": "platform_get__repos__repo_id__ai_tools", "summary": "List tools available under assistant/profile policy", "tags": [ "ai · tools" ], "parameters": [ { "name": "repo_id", "in": "path", "required": true, "schema": { "type": "string", "format": "uuid" } }, { "name": "assistant_id", "in": "query", "required": false, "schema": { "type": "string" } }, { "name": "tool_profile", "in": "query", "description": "Defaults to the assistant profile. Overrides may narrow its tool allowlist; widening returns BAD_REQUEST.", "required": false, "schema": { "type": "string", "enum": [ "default", "retrieval", "command_runner" ] } } ], "description": "Authorization and validation are enforced by the owning service.", "x-handler": "ai_list_tools", "x-source-file": "crates/synckhub-server/src/routes/ai/tools.rs", "x-source-line": 10, "responses": { "200": { "description": "Tools list", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/AiToolsListResponse" } } } } } }, "head": { "operationId": "platform_head__repos__repo_id__ai_tools", "summary": "ai list tools", "tags": [ "ai · tools" ], "parameters": [ { "name": "repo_id", "in": "path", "required": true, "schema": { "type": "string" } }, { "name": "assistant_id", "in": "query", "required": false, "schema": { "anyOf": [ { "type": "string" }, { "type": "null" } ] } }, { "name": "tool_profile", "in": "query", "required": false, "schema": { "anyOf": [ { "type": "string" }, { "type": "null" } ] } } ], "description": "Authorization and validation are enforced by the owning service.\n\nHEAD uses the GET handler and headers without a response body.", "x-handler": "ai_list_tools", "x-source-file": "crates/synckhub-server/src/routes/ai/tools.rs", "x-source-line": 10, "x-implicit-head": true, "responses": { "default": { "description": "Platform error; branch on HTTP status and stable code, not the human-readable message." } } } }, "/repos/{repo_id}/ai/transcriptions": { "post": { "operationId": "platform_post__repos__repo_id__ai_transcriptions", "summary": "Transcribe a bounded pre-chat agent dictation recording", "tags": [ "ai · transcriptions" ], "parameters": [ { "name": "repo_id", "in": "path", "required": true, "schema": { "type": "string", "format": "uuid" } }, { "name": "X-SynckHub-Audio-Duration-Ms", "in": "header", "required": true, "schema": { "type": "integer", "minimum": 1, "maximum": 300000 } } ], "description": "For the empty AI Chats starter before a chat exists. Requires repository write access. Existing chats must use the chat-scoped transcription operation. Uses the repository tenant's active OpenAI BYOK credential without requiring a Common Copilot billing snapshot. Audio and transcript content are not persisted and this operation does not create an AI run or usage-ledger entry.", "x-handler": "ai_create_transcription", "x-source-file": "crates/synckhub-server/src/routes/ai/transcriptions.rs", "x-source-line": 21, "responses": { "200": { "description": "Trimmed plain-text transcript", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/AiTranscriptionResponse" } } } }, "400": { "description": "Missing/invalid duration or empty audio" }, "403": { "description": "Repository write access is required" }, "409": { "description": "OpenAI credential is missing or disabled" }, "413": { "description": "Audio exceeds 10 MiB" }, "415": { "description": "Unsupported recorder media type" }, "422": { "description": "Provider produced no speech transcript" }, "429": { "description": "A transcription is already active for this user" }, "502": { "description": "Provider authentication or response failure" }, "503": { "description": "Provider is rate-limited or unavailable" }, "504": { "description": "Provider transcription timeout" } }, "requestBody": { "required": true, "content": { "audio/webm": { "schema": { "type": "string", "format": "binary", "maxLength": 10485760 } }, "audio/mp4": { "schema": { "type": "string", "format": "binary", "maxLength": 10485760 } }, "video/mp4": { "schema": { "type": "string", "format": "binary", "maxLength": 10485760 } }, "audio/x-m4a": { "schema": { "type": "string", "format": "binary", "maxLength": 10485760 } } } } } }, "/repos/{repo_id}/audit/alerts": { "get": { "operationId": "platform_get__repos__repo_id__audit_alerts", "summary": "list security alerts", "tags": [ "security" ], "parameters": [ { "name": "repo_id", "in": "path", "required": true, "schema": { "type": "string" } }, { "name": "status", "in": "query", "required": false, "schema": { "anyOf": [ { "type": "string" }, { "type": "null" } ] } }, { "name": "severity", "in": "query", "required": false, "schema": { "anyOf": [ { "type": "string" }, { "type": "null" } ] } }, { "name": "rule_key", "in": "query", "required": false, "schema": { "anyOf": [ { "type": "string" }, { "type": "null" } ] } }, { "name": "actor_id", "in": "query", "required": false, "schema": { "anyOf": [ { "type": "string" }, { "type": "null" } ] } }, { "name": "limit", "in": "query", "required": false, "schema": { "anyOf": [ { "type": "integer" }, { "type": "null" } ] } }, { "name": "before_created_at", "in": "query", "required": false, "schema": { "anyOf": [ { "type": "string", "format": "date-time" }, { "type": "null" } ] } }, { "name": "before_alert_id", "in": "query", "required": false, "schema": { "anyOf": [ { "type": "string", "format": "uuid" }, { "type": "null" } ] } } ], "description": "Authorization and validation are enforced by the owning service.", "x-handler": "crate::security_alerts::list_security_alerts", "x-source-file": "crates/synckhub-server/src/routes/security.rs", "x-source-line": 7, "responses": { "default": { "description": "Platform error; branch on HTTP status and stable code, not the human-readable message.", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } } }, "2XX": { "description": "Successful JSON response", "content": { "application/json": { "schema": { "type": "array", "items": { "$ref": "#/components/schemas/synckhub_server.security_alerts.SecurityAlertResponse" } } } } } } }, "head": { "operationId": "platform_head__repos__repo_id__audit_alerts", "summary": "list security alerts", "tags": [ "security" ], "parameters": [ { "name": "repo_id", "in": "path", "required": true, "schema": { "type": "string" } }, { "name": "status", "in": "query", "required": false, "schema": { "anyOf": [ { "type": "string" }, { "type": "null" } ] } }, { "name": "severity", "in": "query", "required": false, "schema": { "anyOf": [ { "type": "string" }, { "type": "null" } ] } }, { "name": "rule_key", "in": "query", "required": false, "schema": { "anyOf": [ { "type": "string" }, { "type": "null" } ] } }, { "name": "actor_id", "in": "query", "required": false, "schema": { "anyOf": [ { "type": "string" }, { "type": "null" } ] } }, { "name": "limit", "in": "query", "required": false, "schema": { "anyOf": [ { "type": "integer" }, { "type": "null" } ] } }, { "name": "before_created_at", "in": "query", "required": false, "schema": { "anyOf": [ { "type": "string", "format": "date-time" }, { "type": "null" } ] } }, { "name": "before_alert_id", "in": "query", "required": false, "schema": { "anyOf": [ { "type": "string", "format": "uuid" }, { "type": "null" } ] } } ], "description": "Authorization and validation are enforced by the owning service.\n\nHEAD uses the GET handler and headers without a response body.", "x-handler": "crate::security_alerts::list_security_alerts", "x-source-file": "crates/synckhub-server/src/routes/security.rs", "x-source-line": 7, "x-implicit-head": true, "responses": { "default": { "description": "Platform error; branch on HTTP status and stable code, not the human-readable message." } } } }, "/repos/{repo_id}/audit/alerts/{alert_id}": { "patch": { "operationId": "platform_patch__repos__repo_id__audit_alerts__alert_id_", "summary": "patch security alert status", "tags": [ "security" ], "parameters": [ { "name": "repo_id", "in": "path", "required": true, "schema": { "type": "string" } }, { "name": "alert_id", "in": "path", "required": true, "schema": { "type": "string" } } ], "description": "Authorization and validation are enforced by the owning service.", "x-handler": "crate::security_alerts::patch_security_alert_status", "x-source-file": "crates/synckhub-server/src/routes/security.rs", "x-source-line": 7, "responses": { "default": { "description": "Platform error; branch on HTTP status and stable code, not the human-readable message.", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } } } }, "requestBody": { "required": true, "content": { "application/json": { "schema": { "$ref": "#/components/schemas/synckhub_server.security_alerts.PatchSecurityAlertStatusBody" } } } } }, "get": { "operationId": "platform_get__repos__repo_id__audit_alerts__alert_id_", "summary": "get security alert", "tags": [ "security" ], "parameters": [ { "name": "repo_id", "in": "path", "required": true, "schema": { "type": "string" } }, { "name": "alert_id", "in": "path", "required": true, "schema": { "type": "string" } } ], "description": "Authorization and validation are enforced by the owning service.", "x-handler": "crate::security_alerts::get_security_alert", "x-source-file": "crates/synckhub-server/src/routes/security.rs", "x-source-line": 7, "responses": { "default": { "description": "Platform error; branch on HTTP status and stable code, not the human-readable message.", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } } }, "2XX": { "description": "Successful JSON response", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/synckhub_server.security_alerts.SecurityAlertResponse" } } } } } }, "head": { "operationId": "platform_head__repos__repo_id__audit_alerts__alert_id_", "summary": "get security alert", "tags": [ "security" ], "parameters": [ { "name": "repo_id", "in": "path", "required": true, "schema": { "type": "string" } }, { "name": "alert_id", "in": "path", "required": true, "schema": { "type": "string" } } ], "description": "Authorization and validation are enforced by the owning service.\n\nHEAD uses the GET handler and headers without a response body.", "x-handler": "crate::security_alerts::get_security_alert", "x-source-file": "crates/synckhub-server/src/routes/security.rs", "x-source-line": 7, "x-implicit-head": true, "responses": { "default": { "description": "Platform error; branch on HTTP status and stable code, not the human-readable message." } } } }, "/repos/{repo_id}/audit/events": { "get": { "operationId": "platform_get__repos__repo_id__audit_events", "summary": "list audit events", "tags": [ "activity" ], "parameters": [ { "name": "repo_id", "in": "path", "required": true, "schema": { "type": "string" } }, { "name": "mount_id", "in": "query", "required": false, "schema": { "anyOf": [ { "type": "string" }, { "type": "null" } ] } }, { "name": "actor_id", "in": "query", "required": false, "schema": { "anyOf": [ { "type": "string" }, { "type": "null" } ] } }, { "name": "action_kind", "in": "query", "required": false, "schema": { "anyOf": [ { "type": "string" }, { "type": "null" } ] } }, { "name": "limit", "in": "query", "required": false, "schema": { "anyOf": [ { "type": "integer", "minimum": 0 }, { "type": "null" } ] } }, { "name": "offset", "in": "query", "required": false, "schema": { "anyOf": [ { "type": "integer", "minimum": 0 }, { "type": "null" } ] } } ], "description": "Authorization and validation are enforced by the owning service.", "x-handler": "list_audit_events", "x-source-file": "crates/synckhub-server/src/routes/activity.rs", "x-source-line": 11, "responses": { "default": { "description": "Platform error; branch on HTTP status and stable code, not the human-readable message.", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } } }, "2XX": { "description": "Successful JSON response", "content": { "application/json": { "schema": { "type": "array", "items": { "$ref": "#/components/schemas/synckhub_server.shared_link_statistics.AuditWithContext" } } } } } } }, "head": { "operationId": "platform_head__repos__repo_id__audit_events", "summary": "list audit events", "tags": [ "activity" ], "parameters": [ { "name": "repo_id", "in": "path", "required": true, "schema": { "type": "string" } }, { "name": "mount_id", "in": "query", "required": false, "schema": { "anyOf": [ { "type": "string" }, { "type": "null" } ] } }, { "name": "actor_id", "in": "query", "required": false, "schema": { "anyOf": [ { "type": "string" }, { "type": "null" } ] } }, { "name": "action_kind", "in": "query", "required": false, "schema": { "anyOf": [ { "type": "string" }, { "type": "null" } ] } }, { "name": "limit", "in": "query", "required": false, "schema": { "anyOf": [ { "type": "integer", "minimum": 0 }, { "type": "null" } ] } }, { "name": "offset", "in": "query", "required": false, "schema": { "anyOf": [ { "type": "integer", "minimum": 0 }, { "type": "null" } ] } } ], "description": "Authorization and validation are enforced by the owning service.\n\nHEAD uses the GET handler and headers without a response body.", "x-handler": "list_audit_events", "x-source-file": "crates/synckhub-server/src/routes/activity.rs", "x-source-line": 11, "x-implicit-head": true, "responses": { "default": { "description": "Platform error; branch on HTTP status and stable code, not the human-readable message." } } } }, "/repos/{repo_id}/audit/events/{event_id}/network-context": { "get": { "operationId": "platform_get__repos__repo_id__audit_events__event_id__network_context", "summary": "shared link audit context", "tags": [ "activity" ], "parameters": [ { "name": "repo_id", "in": "path", "required": true, "schema": { "type": "string" } }, { "name": "event_id", "in": "path", "required": true, "schema": { "type": "string", "format": "uuid" } } ], "description": "Authorization and validation are enforced by the owning service.", "x-handler": "shared_link_audit_context", "x-source-file": "crates/synckhub-server/src/routes/activity.rs", "x-source-line": 11, "responses": { "default": { "description": "Platform error; branch on HTTP status and stable code, not the human-readable message.", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } } }, "2XX": { "description": "Successful JSON response", "content": { "application/json": { "schema": { "anyOf": [ { "$ref": "#/components/schemas/synckhub_server.shared_link_statistics.RequestContext" }, { "type": "null" } ] } } } } } }, "head": { "operationId": "platform_head__repos__repo_id__audit_events__event_id__network_context", "summary": "shared link audit context", "tags": [ "activity" ], "parameters": [ { "name": "repo_id", "in": "path", "required": true, "schema": { "type": "string" } }, { "name": "event_id", "in": "path", "required": true, "schema": { "type": "string", "format": "uuid" } } ], "description": "Authorization and validation are enforced by the owning service.\n\nHEAD uses the GET handler and headers without a response body.", "x-handler": "shared_link_audit_context", "x-source-file": "crates/synckhub-server/src/routes/activity.rs", "x-source-line": 11, "x-implicit-head": true, "responses": { "default": { "description": "Platform error; branch on HTTP status and stable code, not the human-readable message." } } } }, "/repos/{repo_id}/audit/security-alert-policy": { "patch": { "operationId": "platform_patch__repos__repo_id__audit_security_alert_policy", "summary": "patch repo security alert policy", "tags": [ "security" ], "parameters": [ { "name": "repo_id", "in": "path", "required": true, "schema": { "type": "string" } } ], "description": "Authorization and validation are enforced by the owning service.", "x-handler": "crate::security_alerts::patch_repo_security_alert_policy", "x-source-file": "crates/synckhub-server/src/routes/security.rs", "x-source-line": 7, "responses": { "default": { "description": "Platform error; branch on HTTP status and stable code, not the human-readable message.", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } } }, "2XX": { "description": "Successful JSON response", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/synckhub_server.security_alerts.RepoSecurityAlertPolicyResponse" } } } } }, "requestBody": { "required": true, "content": { "application/json": { "schema": { "$ref": "#/components/schemas/synckhub_server.security_alerts.PatchRepoSecurityAlertPolicyBody" } } } } }, "get": { "operationId": "platform_get__repos__repo_id__audit_security_alert_policy", "summary": "get repo security alert policy", "tags": [ "security" ], "parameters": [ { "name": "repo_id", "in": "path", "required": true, "schema": { "type": "string" } } ], "description": "Authorization and validation are enforced by the owning service.", "x-handler": "crate::security_alerts::get_repo_security_alert_policy", "x-source-file": "crates/synckhub-server/src/routes/security.rs", "x-source-line": 7, "responses": { "default": { "description": "Platform error; branch on HTTP status and stable code, not the human-readable message.", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } } }, "2XX": { "description": "Successful JSON response", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/synckhub_server.security_alerts.RepoSecurityAlertPolicyResponse" } } } } } }, "head": { "operationId": "platform_head__repos__repo_id__audit_security_alert_policy", "summary": "get repo security alert policy", "tags": [ "security" ], "parameters": [ { "name": "repo_id", "in": "path", "required": true, "schema": { "type": "string" } } ], "description": "Authorization and validation are enforced by the owning service.\n\nHEAD uses the GET handler and headers without a response body.", "x-handler": "crate::security_alerts::get_repo_security_alert_policy", "x-source-file": "crates/synckhub-server/src/routes/security.rs", "x-source-line": 7, "x-implicit-head": true, "responses": { "default": { "description": "Platform error; branch on HTTP status and stable code, not the human-readable message." } } } }, "/repos/{repo_id}/authz/effective": { "get": { "operationId": "platform_get__repos__repo_id__authz_effective", "summary": "get effective", "tags": [ "authz" ], "parameters": [ { "name": "repo_id", "in": "path", "required": true, "schema": { "type": "string" } }, { "name": "principal_id", "in": "query", "required": true, "schema": { "type": "string" } }, { "name": "calendar_root", "in": "query", "required": false, "schema": { "type": "boolean" } }, { "name": "folder_id", "in": "query", "required": false, "schema": { "anyOf": [ { "type": "string" }, { "type": "null" } ] } }, { "name": "item_id", "in": "query", "required": false, "schema": { "anyOf": [ { "type": "string" }, { "type": "null" } ] } } ], "description": "Authorization and validation are enforced by the owning service.", "x-handler": "get_effective", "x-source-file": "crates/synckhub-server/src/routes/authz.rs", "x-source-line": 6602, "responses": { "default": { "description": "Platform error; branch on HTTP status and stable code, not the human-readable message.", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } } }, "2XX": { "description": "Successful JSON response", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/synckhub_server.routes.authz.EffectiveResponse" } } } } } }, "head": { "operationId": "platform_head__repos__repo_id__authz_effective", "summary": "get effective", "tags": [ "authz" ], "parameters": [ { "name": "repo_id", "in": "path", "required": true, "schema": { "type": "string" } }, { "name": "principal_id", "in": "query", "required": true, "schema": { "type": "string" } }, { "name": "calendar_root", "in": "query", "required": false, "schema": { "type": "boolean" } }, { "name": "folder_id", "in": "query", "required": false, "schema": { "anyOf": [ { "type": "string" }, { "type": "null" } ] } }, { "name": "item_id", "in": "query", "required": false, "schema": { "anyOf": [ { "type": "string" }, { "type": "null" } ] } } ], "description": "Authorization and validation are enforced by the owning service.\n\nHEAD uses the GET handler and headers without a response body.", "x-handler": "get_effective", "x-source-file": "crates/synckhub-server/src/routes/authz.rs", "x-source-line": 6602, "x-implicit-head": true, "responses": { "default": { "description": "Platform error; branch on HTTP status and stable code, not the human-readable message." } } } }, "/repos/{repo_id}/authz/effective/self": { "get": { "operationId": "platform_get__repos__repo_id__authz_effective_self", "summary": "Get the caller's effective permissions", "tags": [ "authz" ], "parameters": [ { "$ref": "#/components/parameters/RepoId" }, { "name": "calendar_root", "in": "query", "required": false, "schema": { "type": "boolean" } }, { "name": "folder_id", "in": "query", "schema": { "type": "string" } }, { "name": "item_id", "in": "query", "schema": { "type": "string" } } ], "description": "Select at most one target. Omit all target parameters for repository permissions, pass folder_id for a folder, or item_id for an item.", "x-handler": "get_effective_self", "x-source-file": "crates/synckhub-server/src/routes/authz.rs", "x-source-line": 6602, "responses": { "200": { "description": "Effective permissions", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/EffectivePermissions" }, "example": { "principal_id": "service:api-token:44444444-4444-4444-8444-444444444444", "resource_kind": "ITEM", "resource_id": "22222222-2222-4222-8222-222222222222", "allowed_actions": [ "SEE_METADATA", "READ_CONTENT" ] } } } }, "400": { "$ref": "#/components/responses/Error" }, "401": { "$ref": "#/components/responses/Error" }, "403": { "$ref": "#/components/responses/Error" }, "404": { "$ref": "#/components/responses/Error" } } }, "head": { "operationId": "platform_head__repos__repo_id__authz_effective_self", "summary": "get effective self", "tags": [ "authz" ], "parameters": [ { "name": "repo_id", "in": "path", "required": true, "schema": { "type": "string" } }, { "name": "calendar_root", "in": "query", "required": false, "schema": { "type": "boolean" } }, { "name": "folder_id", "in": "query", "required": false, "schema": { "anyOf": [ { "type": "string" }, { "type": "null" } ] } }, { "name": "item_id", "in": "query", "required": false, "schema": { "anyOf": [ { "type": "string" }, { "type": "null" } ] } } ], "description": "Authorization and validation are enforced by the owning service.\n\nHEAD uses the GET handler and headers without a response body.", "x-handler": "get_effective_self", "x-source-file": "crates/synckhub-server/src/routes/authz.rs", "x-source-line": 6602, "x-implicit-head": true, "responses": { "default": { "description": "Platform error; branch on HTTP status and stable code, not the human-readable message." } } } }, "/repos/{repo_id}/authz/events": { "get": { "operationId": "platform_get__repos__repo_id__authz_events", "summary": "list authz events", "tags": [ "authz" ], "parameters": [ { "name": "repo_id", "in": "path", "required": true, "schema": { "type": "string" } }, { "name": "after_authz_seq", "in": "query", "required": false, "schema": { "anyOf": [ { "type": "integer" }, { "type": "null" } ] } }, { "name": "limit", "in": "query", "required": false, "schema": { "anyOf": [ { "type": "integer" }, { "type": "null" } ] } }, { "name": "event_kind", "in": "query", "required": false, "schema": { "anyOf": [ { "type": "string" }, { "type": "null" } ] } } ], "description": "Authorization and validation are enforced by the owning service.", "x-handler": "list_authz_events", "x-source-file": "crates/synckhub-server/src/routes/authz.rs", "x-source-line": 6602, "responses": { "default": { "description": "Platform error; branch on HTTP status and stable code, not the human-readable message.", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } } }, "2XX": { "description": "Successful JSON response", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/synckhub_server.routes.authz.AuthzEventsResponse" } } } } } }, "head": { "operationId": "platform_head__repos__repo_id__authz_events", "summary": "list authz events", "tags": [ "authz" ], "parameters": [ { "name": "repo_id", "in": "path", "required": true, "schema": { "type": "string" } }, { "name": "after_authz_seq", "in": "query", "required": false, "schema": { "anyOf": [ { "type": "integer" }, { "type": "null" } ] } }, { "name": "limit", "in": "query", "required": false, "schema": { "anyOf": [ { "type": "integer" }, { "type": "null" } ] } }, { "name": "event_kind", "in": "query", "required": false, "schema": { "anyOf": [ { "type": "string" }, { "type": "null" } ] } } ], "description": "Authorization and validation are enforced by the owning service.\n\nHEAD uses the GET handler and headers without a response body.", "x-handler": "list_authz_events", "x-source-file": "crates/synckhub-server/src/routes/authz.rs", "x-source-line": 6602, "x-implicit-head": true, "responses": { "default": { "description": "Platform error; branch on HTTP status and stable code, not the human-readable message." } } } }, "/repos/{repo_id}/authz/folder-update-subscriptions": { "get": { "operationId": "platform_get__repos__repo_id__authz_folder_update_subscriptions", "summary": "list folder update subscriptions", "tags": [ "authz" ], "parameters": [ { "name": "repo_id", "in": "path", "required": true, "schema": { "type": "string" } }, { "name": "root_folder_id", "in": "query", "required": true, "schema": { "type": "string" } } ], "description": "Authorization and validation are enforced by the owning service.", "x-handler": "list_folder_update_subscriptions", "x-source-file": "crates/synckhub-server/src/routes/authz.rs", "x-source-line": 6602, "responses": { "default": { "description": "Platform error; branch on HTTP status and stable code, not the human-readable message.", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } } }, "2XX": { "description": "Successful JSON response", "content": { "application/json": { "schema": { "type": "array", "items": { "$ref": "#/components/schemas/synckhub_server.routes.authz.FolderUpdateSubscriptionResponse" } } } } } } }, "head": { "operationId": "platform_head__repos__repo_id__authz_folder_update_subscriptions", "summary": "list folder update subscriptions", "tags": [ "authz" ], "parameters": [ { "name": "repo_id", "in": "path", "required": true, "schema": { "type": "string" } }, { "name": "root_folder_id", "in": "query", "required": true, "schema": { "type": "string" } } ], "description": "Authorization and validation are enforced by the owning service.\n\nHEAD uses the GET handler and headers without a response body.", "x-handler": "list_folder_update_subscriptions", "x-source-file": "crates/synckhub-server/src/routes/authz.rs", "x-source-line": 6602, "x-implicit-head": true, "responses": { "default": { "description": "Platform error; branch on HTTP status and stable code, not the human-readable message." } } } }, "/repos/{repo_id}/authz/folder-update-subscriptions/unsubscribe": { "post": { "operationId": "platform_post__repos__repo_id__authz_folder_update_subscriptions_unsubscribe", "summary": "manager unsubscribe folder update subscription", "tags": [ "authz" ], "parameters": [ { "name": "repo_id", "in": "path", "required": true, "schema": { "type": "string" } } ], "description": "Authorization and validation are enforced by the owning service.", "x-handler": "manager_unsubscribe_folder_update_subscription", "x-source-file": "crates/synckhub-server/src/routes/authz.rs", "x-source-line": 6602, "responses": { "default": { "description": "Platform error; branch on HTTP status and stable code, not the human-readable message.", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } } }, "2XX": { "description": "Successful JSON response", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/synckhub_server.routes.authz.FolderUpdateUnsubscribeResponse" } } } } }, "requestBody": { "required": true, "content": { "application/json": { "schema": { "$ref": "#/components/schemas/synckhub_server.routes.authz.FolderUpdateSubscriptionManagerUnsubscribeRequest" } } } } } }, "/repos/{repo_id}/authz/folder-update-subscriptions/upsert": { "post": { "operationId": "platform_post__repos__repo_id__authz_folder_update_subscriptions_upsert", "summary": "upsert folder update subscriptions", "tags": [ "authz" ], "parameters": [ { "name": "repo_id", "in": "path", "required": true, "schema": { "type": "string" } } ], "description": "Authorization and validation are enforced by the owning service.", "x-handler": "upsert_folder_update_subscriptions", "x-source-file": "crates/synckhub-server/src/routes/authz.rs", "x-source-line": 6602, "responses": { "default": { "description": "Platform error; branch on HTTP status and stable code, not the human-readable message.", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } } }, "2XX": { "description": "Successful JSON response", "content": { "application/json": { "schema": { "type": "array", "items": { "$ref": "#/components/schemas/synckhub_server.routes.authz.FolderUpdateSubscriptionResponse" } } } } } }, "requestBody": { "required": true, "content": { "application/json": { "schema": { "$ref": "#/components/schemas/synckhub_server.routes.authz.FolderUpdateSubscriptionUpsertRequest" } } } } } }, "/repos/{repo_id}/authz/groups/{group_id}/members": { "get": { "operationId": "platform_get__repos__repo_id__authz_groups__group_id__members", "summary": "list group members", "tags": [ "authz" ], "parameters": [ { "name": "repo_id", "in": "path", "required": true, "schema": { "type": "string" } }, { "name": "group_id", "in": "path", "required": true, "schema": { "type": "string" } } ], "description": "Authorization and validation are enforced by the owning service.", "x-handler": "list_group_members", "x-source-file": "crates/synckhub-server/src/routes/authz.rs", "x-source-line": 6602, "responses": { "default": { "description": "Platform error; branch on HTTP status and stable code, not the human-readable message.", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } } }, "2XX": { "description": "Successful JSON response", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/synckhub_server.routes.authz.GroupMembersResponse" } } } } } }, "head": { "operationId": "platform_head__repos__repo_id__authz_groups__group_id__members", "summary": "list group members", "tags": [ "authz" ], "parameters": [ { "name": "repo_id", "in": "path", "required": true, "schema": { "type": "string" } }, { "name": "group_id", "in": "path", "required": true, "schema": { "type": "string" } } ], "description": "Authorization and validation are enforced by the owning service.\n\nHEAD uses the GET handler and headers without a response body.", "x-handler": "list_group_members", "x-source-file": "crates/synckhub-server/src/routes/authz.rs", "x-source-line": 6602, "x-implicit-head": true, "responses": { "default": { "description": "Platform error; branch on HTTP status and stable code, not the human-readable message." } } } }, "/repos/{repo_id}/authz/groups/{group_id}/members/add": { "post": { "operationId": "platform_post__repos__repo_id__authz_groups__group_id__members_add", "summary": "add group members", "tags": [ "authz" ], "parameters": [ { "name": "repo_id", "in": "path", "required": true, "schema": { "type": "string" } }, { "name": "group_id", "in": "path", "required": true, "schema": { "type": "string" } } ], "description": "Authorization and validation are enforced by the owning service.", "x-handler": "add_group_members", "x-source-file": "crates/synckhub-server/src/routes/authz.rs", "x-source-line": 6602, "responses": { "default": { "description": "Platform error; branch on HTTP status and stable code, not the human-readable message.", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } } } }, "requestBody": { "required": true, "content": { "application/json": { "schema": { "$ref": "#/components/schemas/synckhub_server.routes.authz.GroupMembersAddRequest" } } } } } }, "/repos/{repo_id}/authz/groups/{group_id}/members/remove": { "post": { "operationId": "platform_post__repos__repo_id__authz_groups__group_id__members_remove", "summary": "remove group members", "tags": [ "authz" ], "parameters": [ { "name": "repo_id", "in": "path", "required": true, "schema": { "type": "string" } }, { "name": "group_id", "in": "path", "required": true, "schema": { "type": "string" } } ], "description": "Authorization and validation are enforced by the owning service.", "x-handler": "remove_group_members", "x-source-file": "crates/synckhub-server/src/routes/authz.rs", "x-source-line": 6602, "responses": { "default": { "description": "Platform error; branch on HTTP status and stable code, not the human-readable message.", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } } } }, "requestBody": { "required": true, "content": { "application/json": { "schema": { "$ref": "#/components/schemas/synckhub_server.routes.authz.GroupMembersRemoveRequest" } } } } } }, "/repos/{repo_id}/authz/guest-permission-intents": { "post": { "operationId": "platform_post__repos__repo_id__authz_guest_permission_intents", "summary": "upsert guest permission intents", "tags": [ "authz" ], "parameters": [ { "name": "repo_id", "in": "path", "required": true, "schema": { "type": "string" } } ], "description": "Authorization and validation are enforced by the owning service.", "x-handler": "upsert_guest_permission_intents", "x-source-file": "crates/synckhub-server/src/routes/authz.rs", "x-source-line": 6602, "responses": { "default": { "description": "Platform error; branch on HTTP status and stable code, not the human-readable message.", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } } }, "2XX": { "description": "Successful JSON response", "content": { "application/json": { "schema": { "type": "array", "items": { "$ref": "#/components/schemas/synckhub_server.routes.authz.GuestPermissionIntentResponse" } } } } } }, "requestBody": { "required": true, "content": { "application/json": { "schema": { "$ref": "#/components/schemas/synckhub_server.routes.authz.GuestPermissionIntentUpsertRequest" } } } } }, "get": { "operationId": "platform_get__repos__repo_id__authz_guest_permission_intents", "summary": "list guest permission intents", "tags": [ "authz" ], "parameters": [ { "name": "repo_id", "in": "path", "required": true, "schema": { "type": "string" } }, { "name": "folder_id", "in": "query", "required": true, "schema": { "type": "string" } } ], "description": "Authorization and validation are enforced by the owning service.", "x-handler": "list_guest_permission_intents", "x-source-file": "crates/synckhub-server/src/routes/authz.rs", "x-source-line": 6602, "responses": { "default": { "description": "Platform error; branch on HTTP status and stable code, not the human-readable message.", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } } }, "2XX": { "description": "Successful JSON response", "content": { "application/json": { "schema": { "type": "array", "items": { "$ref": "#/components/schemas/synckhub_server.routes.authz.GuestPermissionIntentResponse" } } } } } } }, "head": { "operationId": "platform_head__repos__repo_id__authz_guest_permission_intents", "summary": "list guest permission intents", "tags": [ "authz" ], "parameters": [ { "name": "repo_id", "in": "path", "required": true, "schema": { "type": "string" } }, { "name": "folder_id", "in": "query", "required": true, "schema": { "type": "string" } } ], "description": "Authorization and validation are enforced by the owning service.\n\nHEAD uses the GET handler and headers without a response body.", "x-handler": "list_guest_permission_intents", "x-source-file": "crates/synckhub-server/src/routes/authz.rs", "x-source-line": 6602, "x-implicit-head": true, "responses": { "default": { "description": "Platform error; branch on HTTP status and stable code, not the human-readable message." } } } }, "/repos/{repo_id}/authz/items/{item_id}/set-acl-mode": { "post": { "operationId": "platform_post__repos__repo_id__authz_items__item_id__set_acl_mode", "summary": "set item acl mode", "tags": [ "authz" ], "parameters": [ { "name": "repo_id", "in": "path", "required": true, "schema": { "type": "string" } }, { "name": "item_id", "in": "path", "required": true, "schema": { "type": "string" } } ], "description": "Authorization and validation are enforced by the owning service.", "x-handler": "set_item_acl_mode", "x-source-file": "crates/synckhub-server/src/routes/authz.rs", "x-source-line": 6602, "responses": { "default": { "description": "Platform error; branch on HTTP status and stable code, not the human-readable message.", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } } } }, "requestBody": { "required": true, "content": { "application/json": { "schema": { "$ref": "#/components/schemas/synckhub_server.routes.authz.SetItemAclModeRequest" } } } } } }, "/repos/{repo_id}/authz/my-folder-update-subscriptions": { "get": { "operationId": "platform_get__repos__repo_id__authz_my_folder_update_subscriptions", "summary": "list my folder update subscriptions", "tags": [ "authz" ], "parameters": [ { "name": "repo_id", "in": "path", "required": true, "schema": { "type": "string" } }, { "name": "root_folder_id", "in": "query", "required": false, "schema": { "anyOf": [ { "type": "string" }, { "type": "null" } ] } } ], "description": "Authorization and validation are enforced by the owning service.", "x-handler": "list_my_folder_update_subscriptions", "x-source-file": "crates/synckhub-server/src/routes/authz.rs", "x-source-line": 6602, "responses": { "default": { "description": "Platform error; branch on HTTP status and stable code, not the human-readable message.", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } } }, "2XX": { "description": "Successful JSON response", "content": { "application/json": { "schema": { "type": "array", "items": { "$ref": "#/components/schemas/synckhub_server.routes.authz.FolderUpdateSubscriptionResponse" } } } } } } }, "head": { "operationId": "platform_head__repos__repo_id__authz_my_folder_update_subscriptions", "summary": "list my folder update subscriptions", "tags": [ "authz" ], "parameters": [ { "name": "repo_id", "in": "path", "required": true, "schema": { "type": "string" } }, { "name": "root_folder_id", "in": "query", "required": false, "schema": { "anyOf": [ { "type": "string" }, { "type": "null" } ] } } ], "description": "Authorization and validation are enforced by the owning service.\n\nHEAD uses the GET handler and headers without a response body.", "x-handler": "list_my_folder_update_subscriptions", "x-source-file": "crates/synckhub-server/src/routes/authz.rs", "x-source-line": 6602, "x-implicit-head": true, "responses": { "default": { "description": "Platform error; branch on HTTP status and stable code, not the human-readable message." } } } }, "/repos/{repo_id}/authz/my-folder-update-subscriptions/unsubscribe": { "post": { "operationId": "platform_post__repos__repo_id__authz_my_folder_update_subscriptions_unsubscribe", "summary": "unsubscribe my folder update subscription", "tags": [ "authz" ], "parameters": [ { "name": "repo_id", "in": "path", "required": true, "schema": { "type": "string" } } ], "description": "Authorization and validation are enforced by the owning service.", "x-handler": "unsubscribe_my_folder_update_subscription", "x-source-file": "crates/synckhub-server/src/routes/authz.rs", "x-source-line": 6602, "responses": { "default": { "description": "Platform error; branch on HTTP status and stable code, not the human-readable message.", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } } }, "2XX": { "description": "Successful JSON response", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/synckhub_server.routes.authz.FolderUpdateUnsubscribeResponse" } } } } }, "requestBody": { "required": true, "content": { "application/json": { "schema": { "$ref": "#/components/schemas/synckhub_server.routes.authz.FolderUpdateSubscriptionSelfRequest" } } } } } }, "/repos/{repo_id}/authz/my-folder-update-subscriptions/upsert": { "post": { "operationId": "platform_post__repos__repo_id__authz_my_folder_update_subscriptions_upsert", "summary": "upsert my folder update subscription", "tags": [ "authz" ], "parameters": [ { "name": "repo_id", "in": "path", "required": true, "schema": { "type": "string" } } ], "description": "Authorization and validation are enforced by the owning service.", "x-handler": "upsert_my_folder_update_subscription", "x-source-file": "crates/synckhub-server/src/routes/authz.rs", "x-source-line": 6602, "responses": { "default": { "description": "Platform error; branch on HTTP status and stable code, not the human-readable message.", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } } }, "2XX": { "description": "Successful JSON response", "content": { "application/json": { "schema": { "type": "array", "items": { "$ref": "#/components/schemas/synckhub_server.routes.authz.FolderUpdateSubscriptionResponse" } } } } } }, "requestBody": { "required": true, "content": { "application/json": { "schema": { "$ref": "#/components/schemas/synckhub_server.routes.authz.FolderUpdateSubscriptionSelfRequest" } } } } } }, "/repos/{repo_id}/authz/permission-notifications": { "post": { "operationId": "platform_post__repos__repo_id__authz_permission_notifications", "summary": "send permission notifications", "tags": [ "authz" ], "parameters": [ { "name": "repo_id", "in": "path", "required": true, "schema": { "type": "string" } } ], "description": "Authorization and validation are enforced by the owning service.", "x-handler": "send_permission_notifications", "x-source-file": "crates/synckhub-server/src/routes/authz.rs", "x-source-line": 6602, "responses": { "default": { "description": "Platform error; branch on HTTP status and stable code, not the human-readable message.", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } } }, "2XX": { "description": "Successful JSON response", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/synckhub_server.routes.authz.PermissionNotificationResponse" } } } } }, "requestBody": { "required": true, "content": { "application/json": { "schema": { "$ref": "#/components/schemas/synckhub_server.routes.authz.PermissionNotificationRequest" } } } } } }, "/repos/{repo_id}/authz/rules": { "get": { "operationId": "platform_get__repos__repo_id__authz_rules", "summary": "list authz rules", "tags": [ "authz" ], "parameters": [ { "name": "repo_id", "in": "path", "required": true, "schema": { "type": "string" } }, { "name": "resource_kind", "in": "query", "required": false, "schema": { "anyOf": [ { "type": "string" }, { "type": "null" } ] } }, { "name": "resource_id", "in": "query", "required": false, "schema": { "anyOf": [ { "type": "string" }, { "type": "null" } ] } }, { "name": "subject_kind", "in": "query", "required": false, "schema": { "anyOf": [ { "type": "string" }, { "type": "null" } ] } }, { "name": "subject_id", "in": "query", "required": false, "schema": { "anyOf": [ { "type": "string" }, { "type": "null" } ] } } ], "description": "Authorization and validation are enforced by the owning service.", "x-handler": "list_authz_rules", "x-source-file": "crates/synckhub-server/src/routes/authz.rs", "x-source-line": 6602, "responses": { "default": { "description": "Platform error; branch on HTTP status and stable code, not the human-readable message.", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } } }, "2XX": { "description": "Successful JSON response", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/synckhub_server.routes.authz.AuthzRulesResponse" } } } } } }, "head": { "operationId": "platform_head__repos__repo_id__authz_rules", "summary": "list authz rules", "tags": [ "authz" ], "parameters": [ { "name": "repo_id", "in": "path", "required": true, "schema": { "type": "string" } }, { "name": "resource_kind", "in": "query", "required": false, "schema": { "anyOf": [ { "type": "string" }, { "type": "null" } ] } }, { "name": "resource_id", "in": "query", "required": false, "schema": { "anyOf": [ { "type": "string" }, { "type": "null" } ] } }, { "name": "subject_kind", "in": "query", "required": false, "schema": { "anyOf": [ { "type": "string" }, { "type": "null" } ] } }, { "name": "subject_id", "in": "query", "required": false, "schema": { "anyOf": [ { "type": "string" }, { "type": "null" } ] } } ], "description": "Authorization and validation are enforced by the owning service.\n\nHEAD uses the GET handler and headers without a response body.", "x-handler": "list_authz_rules", "x-source-file": "crates/synckhub-server/src/routes/authz.rs", "x-source-line": 6602, "x-implicit-head": true, "responses": { "default": { "description": "Platform error; branch on HTTP status and stable code, not the human-readable message." } } } }, "/repos/{repo_id}/authz/rules/delete": { "post": { "operationId": "platform_post__repos__repo_id__authz_rules_delete", "summary": "delete authz rules", "tags": [ "authz" ], "parameters": [ { "name": "repo_id", "in": "path", "required": true, "schema": { "type": "string" } } ], "description": "Authorization and validation are enforced by the owning service.", "x-handler": "delete_authz_rules", "x-source-file": "crates/synckhub-server/src/routes/authz.rs", "x-source-line": 6602, "responses": { "default": { "description": "Platform error; branch on HTTP status and stable code, not the human-readable message.", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } } } }, "requestBody": { "required": true, "content": { "application/json": { "schema": { "$ref": "#/components/schemas/synckhub_server.routes.authz.AuthzRulesDeleteRequest" } } } } } }, "/repos/{repo_id}/authz/rules/delete/preflight": { "post": { "operationId": "platform_post__repos__repo_id__authz_rules_delete_preflight", "summary": "preflight delete authz rules", "tags": [ "authz" ], "parameters": [ { "name": "repo_id", "in": "path", "required": true, "schema": { "type": "string" } } ], "description": "Authorization and validation are enforced by the owning service.", "x-handler": "preflight_delete_authz_rules", "x-source-file": "crates/synckhub-server/src/routes/authz.rs", "x-source-line": 6602, "responses": { "default": { "description": "Platform error; branch on HTTP status and stable code, not the human-readable message.", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } } }, "2XX": { "description": "Successful JSON response", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/synckhub_server.routes.authz.AuthzRulesPreflightResponse" } } } } }, "requestBody": { "required": true, "content": { "application/json": { "schema": { "$ref": "#/components/schemas/synckhub_server.routes.authz.AuthzRulesDeleteRequest" } } } } } }, "/repos/{repo_id}/authz/rules/upsert": { "post": { "operationId": "platform_post__repos__repo_id__authz_rules_upsert", "summary": "upsert authz rules", "tags": [ "authz" ], "parameters": [ { "name": "repo_id", "in": "path", "required": true, "schema": { "type": "string" } } ], "description": "Authorization and validation are enforced by the owning service.", "x-handler": "upsert_authz_rules", "x-source-file": "crates/synckhub-server/src/routes/authz.rs", "x-source-line": 6602, "responses": { "default": { "description": "Platform error; branch on HTTP status and stable code, not the human-readable message.", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } } } }, "requestBody": { "required": true, "content": { "application/json": { "schema": { "$ref": "#/components/schemas/synckhub_server.routes.authz.AuthzRulesUpsertRequest" } } } } } }, "/repos/{repo_id}/authz/rules/upsert/preflight": { "post": { "operationId": "platform_post__repos__repo_id__authz_rules_upsert_preflight", "summary": "preflight upsert authz rules", "tags": [ "authz" ], "parameters": [ { "name": "repo_id", "in": "path", "required": true, "schema": { "type": "string" } } ], "description": "Authorization and validation are enforced by the owning service.", "x-handler": "preflight_upsert_authz_rules", "x-source-file": "crates/synckhub-server/src/routes/authz.rs", "x-source-line": 6602, "responses": { "default": { "description": "Platform error; branch on HTTP status and stable code, not the human-readable message.", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } } }, "2XX": { "description": "Successful JSON response", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/synckhub_server.routes.authz.AuthzRulesPreflightResponse" } } } } }, "requestBody": { "required": true, "content": { "application/json": { "schema": { "$ref": "#/components/schemas/synckhub_server.routes.authz.AuthzRulesUpsertRequest" } } } } } }, "/repos/{repo_id}/authz/stack": { "get": { "operationId": "platform_get__repos__repo_id__authz_stack", "summary": "get authz stack", "tags": [ "authz" ], "parameters": [ { "name": "repo_id", "in": "path", "required": true, "schema": { "type": "string" } }, { "name": "calendar_root", "in": "query", "required": false, "schema": { "type": "boolean" } }, { "name": "folder_id", "in": "query", "required": false, "schema": { "anyOf": [ { "type": "string" }, { "type": "null" } ], "description": "Exactly one of `calendar_root`, `folder_id` or `item_id` must be set.\n\nFolder id whose rule sources should be returned.\nUse empty string to target the root-folder sentinel." } }, { "name": "item_id", "in": "query", "required": false, "schema": { "anyOf": [ { "type": "string" }, { "type": "null" } ], "description": "Item id whose rule sources should be returned." } } ], "description": "Authorization and validation are enforced by the owning service.", "x-handler": "get_authz_stack", "x-source-file": "crates/synckhub-server/src/routes/authz.rs", "x-source-line": 6602, "responses": { "default": { "description": "Platform error; branch on HTTP status and stable code, not the human-readable message.", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } } }, "2XX": { "description": "Successful JSON response", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/synckhub_server.routes.authz.AuthzStackResponse" } } } } } }, "head": { "operationId": "platform_head__repos__repo_id__authz_stack", "summary": "get authz stack", "tags": [ "authz" ], "parameters": [ { "name": "repo_id", "in": "path", "required": true, "schema": { "type": "string" } }, { "name": "calendar_root", "in": "query", "required": false, "schema": { "type": "boolean" } }, { "name": "folder_id", "in": "query", "required": false, "schema": { "anyOf": [ { "type": "string" }, { "type": "null" } ], "description": "Exactly one of `calendar_root`, `folder_id` or `item_id` must be set.\n\nFolder id whose rule sources should be returned.\nUse empty string to target the root-folder sentinel." } }, { "name": "item_id", "in": "query", "required": false, "schema": { "anyOf": [ { "type": "string" }, { "type": "null" } ], "description": "Item id whose rule sources should be returned." } } ], "description": "Authorization and validation are enforced by the owning service.\n\nHEAD uses the GET handler and headers without a response body.", "x-handler": "get_authz_stack", "x-source-file": "crates/synckhub-server/src/routes/authz.rs", "x-source-line": 6602, "x-implicit-head": true, "responses": { "default": { "description": "Platform error; branch on HTTP status and stable code, not the human-readable message." } } } }, "/repos/{repo_id}/authz/subjects/{subject_kind}/{subject_id}/folder-permission-roots": { "get": { "operationId": "platform_get__repos__repo_id__authz_subjects__subject_kind___subject_id__folder_permission_roots", "summary": "list subject folder permission roots", "tags": [ "authz" ], "parameters": [ { "name": "repo_id", "in": "path", "required": true, "schema": { "type": "string" } }, { "name": "subject_kind", "in": "path", "required": true, "schema": { "type": "string" } }, { "name": "subject_id", "in": "path", "required": true, "schema": { "type": "string" } } ], "description": "Authorization and validation are enforced by the owning service.", "x-handler": "list_subject_folder_permission_roots", "x-source-file": "crates/synckhub-server/src/routes/authz.rs", "x-source-line": 6602, "responses": { "default": { "description": "Platform error; branch on HTTP status and stable code, not the human-readable message.", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } } }, "2XX": { "description": "Successful JSON response", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/synckhub_server.routes.authz.SubjectFolderPermissionRootsResponse" } } } } } }, "head": { "operationId": "platform_head__repos__repo_id__authz_subjects__subject_kind___subject_id__folder_permission_roots", "summary": "list subject folder permission roots", "tags": [ "authz" ], "parameters": [ { "name": "repo_id", "in": "path", "required": true, "schema": { "type": "string" } }, { "name": "subject_kind", "in": "path", "required": true, "schema": { "type": "string" } }, { "name": "subject_id", "in": "path", "required": true, "schema": { "type": "string" } } ], "description": "Authorization and validation are enforced by the owning service.\n\nHEAD uses the GET handler and headers without a response body.", "x-handler": "list_subject_folder_permission_roots", "x-source-file": "crates/synckhub-server/src/routes/authz.rs", "x-source-line": 6602, "x-implicit-head": true, "responses": { "default": { "description": "Platform error; branch on HTTP status and stable code, not the human-readable message." } } } }, "/repos/{repo_id}/blobs/{blob_id}": { "get": { "operationId": "platform_get__repos__repo_id__blobs__blob_id_", "summary": "Download bytes for a resolved content revision", "tags": [ "files · content" ], "parameters": [ { "$ref": "#/components/parameters/RepoId" }, { "name": "blob_id", "in": "path", "required": true, "schema": { "type": "string" } }, { "name": "Range", "in": "header", "description": "A single byte range for resumable downloads.", "schema": { "type": "string" }, "example": "bytes=0-1023" } ], "description": "Use blob IDs returned by version endpoints. Authorization is still evaluated in the repository context. Supports a single Range: bytes=… request when the blob store supports seeking. Federated blob reads may reject ranges with 501 RANGE_NOT_SUPPORTED.", "x-handler": "get_blob", "x-source-file": "crates/synckhub-server/src/routes/files/content.rs", "x-source-line": 20, "responses": { "200": { "description": "Raw blob bytes", "content": { "application/octet-stream": { "schema": { "type": "string", "format": "binary" } } }, "headers": { "ETag": { "description": "Quoted blob identity.", "schema": { "type": "string" } }, "Accept-Ranges": { "description": "bytes when seeking is supported; otherwise none.", "schema": { "type": "string" } } } }, "206": { "description": "Requested byte range", "content": { "application/octet-stream": { "schema": { "type": "string", "format": "binary" } } }, "headers": { "ETag": { "description": "Quoted blob identity.", "schema": { "type": "string" } }, "Accept-Ranges": { "description": "bytes when seeking is supported; otherwise none.", "schema": { "type": "string" } }, "Content-Range": { "schema": { "type": "string" }, "example": "bytes 0-1023/2048" } } }, "401": { "$ref": "#/components/responses/Error" }, "403": { "$ref": "#/components/responses/Error" }, "404": { "$ref": "#/components/responses/Error" }, "416": { "description": "Invalid or unsatisfiable byte range.", "headers": { "Content-Range": { "schema": { "type": "string" }, "example": "bytes */2048" } }, "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" }, "example": { "code": "RANGE_NOT_SATISFIABLE", "message": "range not satisfiable" } } } }, "501": { "description": "Ranges are unsupported for this blob source.", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" }, "example": { "code": "RANGE_NOT_SUPPORTED", "message": "range requests are not supported for federated blob reads" } } } } } }, "head": { "operationId": "platform_head__repos__repo_id__blobs__blob_id_", "summary": "get blob", "tags": [ "files · content" ], "parameters": [ { "name": "repo_id", "in": "path", "required": true, "schema": { "type": "string" } }, { "name": "blob_id", "in": "path", "required": true, "schema": { "type": "string" } } ], "description": "Authorization and validation are enforced by the owning service.\n\nHEAD uses the GET handler and headers without a response body.", "x-handler": "get_blob", "x-source-file": "crates/synckhub-server/src/routes/files/content.rs", "x-source-line": 20, "x-implicit-head": true, "responses": { "default": { "description": "Platform error; branch on HTTP status and stable code, not the human-readable message." } } } }, "/repos/{repo_id}/calendar-delegations": { "get": { "operationId": "platform_get__repos__repo_id__calendar_delegations", "summary": "received", "tags": [ "native_calendars · delegation" ], "parameters": [ { "name": "repo_id", "in": "path", "required": true, "schema": { "type": "string" } } ], "description": "Authorization and validation are enforced by the owning service.", "x-handler": "received", "x-source-file": "crates/synckhub-server/src/routes/native_calendars/delegation.rs", "x-source-line": 61, "responses": { "default": { "description": "Platform error; branch on HTTP status and stable code, not the human-readable message.", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } } }, "2XX": { "description": "Successful JSON response", "content": { "application/json": { "schema": { "type": "array", "items": { "$ref": "#/components/schemas/synckhub_server.routes.native_calendars.delegation.ReceivedGrant" } } } } } } }, "head": { "operationId": "platform_head__repos__repo_id__calendar_delegations", "summary": "received", "tags": [ "native_calendars · delegation" ], "parameters": [ { "name": "repo_id", "in": "path", "required": true, "schema": { "type": "string" } } ], "description": "Authorization and validation are enforced by the owning service.\n\nHEAD uses the GET handler and headers without a response body.", "x-handler": "received", "x-source-file": "crates/synckhub-server/src/routes/native_calendars/delegation.rs", "x-source-line": 61, "x-implicit-head": true, "responses": { "default": { "description": "Platform error; branch on HTTP status and stable code, not the human-readable message." } } } }, "/repos/{repo_id}/calendar-event-types": { "get": { "operationId": "platform_get__repos__repo_id__calendar_event_types", "summary": "list", "tags": [ "native_calendars · event_types" ], "parameters": [ { "name": "repo_id", "in": "path", "required": true, "schema": { "type": "string" } } ], "description": "Authorization and validation are enforced by the owning service.", "x-handler": "list", "x-source-file": "crates/synckhub-server/src/routes/native_calendars/event_types.rs", "x-source-line": 10, "responses": { "default": { "description": "Platform error; branch on HTTP status and stable code, not the human-readable message.", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } } }, "2XX": { "description": "Successful JSON response", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/synckhub_server.routes.native_calendars.event_types.Catalog" } } } } } }, "head": { "operationId": "platform_head__repos__repo_id__calendar_event_types", "summary": "list", "tags": [ "native_calendars · event_types" ], "parameters": [ { "name": "repo_id", "in": "path", "required": true, "schema": { "type": "string" } } ], "description": "Authorization and validation are enforced by the owning service.\n\nHEAD uses the GET handler and headers without a response body.", "x-handler": "list", "x-source-file": "crates/synckhub-server/src/routes/native_calendars/event_types.rs", "x-source-line": 10, "x-implicit-head": true, "responses": { "default": { "description": "Platform error; branch on HTTP status and stable code, not the human-readable message." } } } }, "/repos/{repo_id}/calendar-event-types/{id}": { "put": { "operationId": "platform_put__repos__repo_id__calendar_event_types__id_", "summary": "put", "tags": [ "native_calendars · event_types" ], "parameters": [ { "name": "repo_id", "in": "path", "required": true, "schema": { "type": "string" } }, { "name": "id", "in": "path", "required": true, "schema": { "type": "string", "format": "uuid" } } ], "description": "Authorization and validation are enforced by the owning service.", "x-handler": "put", "x-source-file": "crates/synckhub-server/src/routes/native_calendars/event_types.rs", "x-source-line": 10, "responses": { "default": { "description": "Platform error; branch on HTTP status and stable code, not the human-readable message.", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } } }, "2XX": { "description": "Successful JSON response", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/synckhub_core_postgres.service.native_calendars.event_types.EventType" } } } } }, "requestBody": { "required": true, "content": { "application/json": { "schema": { "$ref": "#/components/schemas/synckhub_server.routes.native_calendars.event_types.Input" } } } } } }, "/repos/{repo_id}/calendar-events": { "get": { "operationId": "platform_get__repos__repo_id__calendar_events", "summary": "events", "tags": [ "native_calendars · lists" ], "parameters": [ { "name": "repo_id", "in": "path", "required": true, "schema": { "type": "string" } }, { "name": "start_date", "in": "query", "required": true, "schema": { "type": "string", "format": "date" } }, { "name": "end_date", "in": "query", "required": true, "schema": { "type": "string", "format": "date" } }, { "name": "time_zone", "in": "query", "required": true, "schema": { "type": "string" } }, { "name": "calendar_item_id", "in": "query", "required": false, "schema": { "anyOf": [ { "type": "string" }, { "type": "null" } ] } }, { "name": "calendar_item_ids", "in": "query", "required": false, "schema": { "anyOf": [ { "type": "string" }, { "type": "null" } ] } }, { "name": "case_item_id", "in": "query", "required": false, "schema": { "anyOf": [ { "type": "string" }, { "type": "null" } ] } }, { "name": "limit", "in": "query", "required": false, "schema": { "anyOf": [ { "type": "integer", "minimum": 0 }, { "type": "null" } ] } }, { "name": "cursor", "in": "query", "required": false, "schema": { "anyOf": [ { "type": "string" }, { "type": "null" } ] } } ], "description": "Authorization and validation are enforced by the owning service.", "x-handler": "events", "x-source-file": "crates/synckhub-server/src/routes/native_calendars/lists.rs", "x-source-line": 24, "responses": { "default": { "description": "Platform error; branch on HTTP status and stable code, not the human-readable message.", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } } }, "2XX": { "description": "Successful JSON response", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/synckhub_server.routes.native_calendars.lists.EventPage" } } } } } }, "head": { "operationId": "platform_head__repos__repo_id__calendar_events", "summary": "events", "tags": [ "native_calendars · lists" ], "parameters": [ { "name": "repo_id", "in": "path", "required": true, "schema": { "type": "string" } }, { "name": "start_date", "in": "query", "required": true, "schema": { "type": "string", "format": "date" } }, { "name": "end_date", "in": "query", "required": true, "schema": { "type": "string", "format": "date" } }, { "name": "time_zone", "in": "query", "required": true, "schema": { "type": "string" } }, { "name": "calendar_item_id", "in": "query", "required": false, "schema": { "anyOf": [ { "type": "string" }, { "type": "null" } ] } }, { "name": "calendar_item_ids", "in": "query", "required": false, "schema": { "anyOf": [ { "type": "string" }, { "type": "null" } ] } }, { "name": "case_item_id", "in": "query", "required": false, "schema": { "anyOf": [ { "type": "string" }, { "type": "null" } ] } }, { "name": "limit", "in": "query", "required": false, "schema": { "anyOf": [ { "type": "integer", "minimum": 0 }, { "type": "null" } ] } }, { "name": "cursor", "in": "query", "required": false, "schema": { "anyOf": [ { "type": "string" }, { "type": "null" } ] } } ], "description": "Authorization and validation are enforced by the owning service.\n\nHEAD uses the GET handler and headers without a response body.", "x-handler": "events", "x-source-file": "crates/synckhub-server/src/routes/native_calendars/lists.rs", "x-source-line": 24, "x-implicit-head": true, "responses": { "default": { "description": "Platform error; branch on HTTP status and stable code, not the human-readable message." } } } }, "/repos/{repo_id}/calendar-events/{item_id}": { "patch": { "operationId": "platform_patch__repos__repo_id__calendar_events__item_id_", "summary": "edit event", "tags": [ "native_calendars" ], "parameters": [ { "name": "repo_id", "in": "path", "required": true, "schema": { "type": "string" } }, { "name": "item_id", "in": "path", "required": true, "schema": { "type": "string" } } ], "description": "Authorization and validation are enforced by the owning service.", "x-handler": "edit_event", "x-source-file": "crates/synckhub-server/src/routes/native_calendars.rs", "x-source-line": 47, "responses": { "default": { "description": "Platform error; branch on HTTP status and stable code, not the human-readable message.", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } } }, "2XX": { "description": "Successful JSON response", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/synckhub_core_postgres.service.native_calendars.commands.CommandReceipt" } } } } }, "requestBody": { "required": true, "content": { "application/json": { "schema": { "$ref": "#/components/schemas/synckhub_core.native_calendars.commands.EditEvent" } } } } }, "get": { "operationId": "platform_get__repos__repo_id__calendar_events__item_id_", "summary": "event detail", "tags": [ "native_calendars · read" ], "parameters": [ { "name": "repo_id", "in": "path", "required": true, "schema": { "type": "string" } }, { "name": "item_id", "in": "path", "required": true, "schema": { "type": "string" } }, { "name": "occurrence_start", "in": "query", "required": false, "schema": { "anyOf": [ { "type": "string", "format": "date-time" }, { "type": "null" } ] } } ], "description": "Authorization and validation are enforced by the owning service.", "x-handler": "event_detail", "x-source-file": "crates/synckhub-server/src/routes/native_calendars/read.rs", "x-source-line": 11, "responses": { "default": { "description": "Platform error; branch on HTTP status and stable code, not the human-readable message.", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } } }, "2XX": { "description": "Successful JSON response", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/synckhub_server.routes.native_calendars.read.EventDetail" } } } } } }, "head": { "operationId": "platform_head__repos__repo_id__calendar_events__item_id_", "summary": "event detail", "tags": [ "native_calendars · read" ], "parameters": [ { "name": "repo_id", "in": "path", "required": true, "schema": { "type": "string" } }, { "name": "item_id", "in": "path", "required": true, "schema": { "type": "string" } }, { "name": "occurrence_start", "in": "query", "required": false, "schema": { "anyOf": [ { "type": "string", "format": "date-time" }, { "type": "null" } ] } } ], "description": "Authorization and validation are enforced by the owning service.\n\nHEAD uses the GET handler and headers without a response body.", "x-handler": "event_detail", "x-source-file": "crates/synckhub-server/src/routes/native_calendars/read.rs", "x-source-line": 11, "x-implicit-head": true, "responses": { "default": { "description": "Platform error; branch on HTTP status and stable code, not the human-readable message." } } } }, "/repos/{repo_id}/calendar-events/{item_id}/cancel": { "post": { "operationId": "platform_post__repos__repo_id__calendar_events__item_id__cancel", "summary": "cancel event", "tags": [ "native_calendars" ], "parameters": [ { "name": "repo_id", "in": "path", "required": true, "schema": { "type": "string" } }, { "name": "item_id", "in": "path", "required": true, "schema": { "type": "string" } } ], "description": "Authorization and validation are enforced by the owning service.", "x-handler": "cancel_event", "x-source-file": "crates/synckhub-server/src/routes/native_calendars.rs", "x-source-line": 47, "responses": { "default": { "description": "Platform error; branch on HTTP status and stable code, not the human-readable message.", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } } }, "2XX": { "description": "Successful JSON response", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/synckhub_core_postgres.service.native_calendars.commands.CommandReceipt" } } } } }, "requestBody": { "required": true, "content": { "application/json": { "schema": { "$ref": "#/components/schemas/synckhub_core.native_calendars.commands.CancelEvent" } } } } } }, "/repos/{repo_id}/calendar-events/{item_id}/export": { "get": { "operationId": "platform_get__repos__repo_id__calendar_events__item_id__export", "summary": "export event", "tags": [ "native_calendars · read" ], "parameters": [ { "name": "repo_id", "in": "path", "required": true, "schema": { "type": "string" } }, { "name": "item_id", "in": "path", "required": true, "schema": { "type": "string" } } ], "description": "Authorization and validation are enforced by the owning service.", "x-handler": "export_event", "x-source-file": "crates/synckhub-server/src/routes/native_calendars/read.rs", "x-source-line": 11, "responses": { "default": { "description": "Platform error; branch on HTTP status and stable code, not the human-readable message.", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } } } } }, "head": { "operationId": "platform_head__repos__repo_id__calendar_events__item_id__export", "summary": "export event", "tags": [ "native_calendars · read" ], "parameters": [ { "name": "repo_id", "in": "path", "required": true, "schema": { "type": "string" } }, { "name": "item_id", "in": "path", "required": true, "schema": { "type": "string" } } ], "description": "Authorization and validation are enforced by the owning service.\n\nHEAD uses the GET handler and headers without a response body.", "x-handler": "export_event", "x-source-file": "crates/synckhub-server/src/routes/native_calendars/read.rs", "x-source-line": 11, "x-implicit-head": true, "responses": { "default": { "description": "Platform error; branch on HTTP status and stable code, not the human-readable message." } } } }, "/repos/{repo_id}/calendar-events/{item_id}/external-invitations": { "post": { "operationId": "platform_post__repos__repo_id__calendar_events__item_id__external_invitations", "summary": "configure external", "tags": [ "native_calendars" ], "parameters": [ { "name": "repo_id", "in": "path", "required": true, "schema": { "type": "string" } }, { "name": "item_id", "in": "path", "required": true, "schema": { "type": "string" } } ], "description": "Authorization and validation are enforced by the owning service.", "x-handler": "configure_external", "x-source-file": "crates/synckhub-server/src/routes/native_calendars.rs", "x-source-line": 47, "responses": { "default": { "description": "Platform error; branch on HTTP status and stable code, not the human-readable message.", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } } }, "2XX": { "description": "Successful JSON response", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/synckhub_core_postgres.service.native_calendars.commands.CommandReceipt" } } } } }, "requestBody": { "required": true, "content": { "application/json": { "schema": { "$ref": "#/components/schemas/synckhub_core.external_scheduling.state.ConfigureExternal" } } } } } }, "/repos/{repo_id}/calendar-events/{item_id}/external-response": { "post": { "operationId": "platform_post__repos__repo_id__calendar_events__item_id__external_response", "summary": "respond external", "tags": [ "native_calendars" ], "parameters": [ { "name": "repo_id", "in": "path", "required": true, "schema": { "type": "string" } }, { "name": "item_id", "in": "path", "required": true, "schema": { "type": "string" } } ], "description": "Authorization and validation are enforced by the owning service.", "x-handler": "respond_external", "x-source-file": "crates/synckhub-server/src/routes/native_calendars.rs", "x-source-line": 47, "responses": { "default": { "description": "Platform error; branch on HTTP status and stable code, not the human-readable message.", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } } }, "2XX": { "description": "Successful JSON response", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/synckhub_core_postgres.service.native_calendars.commands.CommandReceipt" } } } } }, "requestBody": { "required": true, "content": { "application/json": { "schema": { "$ref": "#/components/schemas/synckhub_core.external_scheduling.state.RespondExternal" } } } } } }, "/repos/{repo_id}/calendar-events/{item_id}/on-behalf/{represented}": { "get": { "operationId": "platform_get__repos__repo_id__calendar_events__item_id__on_behalf__represented_", "summary": "detail", "tags": [ "native_calendars · delegation" ], "parameters": [ { "name": "repo_id", "in": "path", "required": true, "schema": { "type": "string" } }, { "name": "item_id", "in": "path", "required": true, "schema": { "type": "string" } }, { "name": "represented", "in": "path", "required": true, "schema": { "type": "string" } } ], "description": "Authorization and validation are enforced by the owning service.", "x-handler": "detail", "x-source-file": "crates/synckhub-server/src/routes/native_calendars/delegation.rs", "x-source-line": 61, "responses": { "default": { "description": "Platform error; branch on HTTP status and stable code, not the human-readable message.", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } } }, "2XX": { "description": "Successful JSON response", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/synckhub_server.routes.native_calendars.delegation.Detail" } } } } } }, "head": { "operationId": "platform_head__repos__repo_id__calendar_events__item_id__on_behalf__represented_", "summary": "detail", "tags": [ "native_calendars · delegation" ], "parameters": [ { "name": "repo_id", "in": "path", "required": true, "schema": { "type": "string" } }, { "name": "item_id", "in": "path", "required": true, "schema": { "type": "string" } }, { "name": "represented", "in": "path", "required": true, "schema": { "type": "string" } } ], "description": "Authorization and validation are enforced by the owning service.\n\nHEAD uses the GET handler and headers without a response body.", "x-handler": "detail", "x-source-file": "crates/synckhub-server/src/routes/native_calendars/delegation.rs", "x-source-line": 61, "x-implicit-head": true, "responses": { "default": { "description": "Platform error; branch on HTTP status and stable code, not the human-readable message." } } } }, "/repos/{repo_id}/calendar-events/{item_id}/personal-preferences": { "put": { "operationId": "platform_put__repos__repo_id__calendar_events__item_id__personal_preferences", "summary": "put preferences", "tags": [ "native_calendars · preferences" ], "parameters": [ { "name": "repo_id", "in": "path", "required": true, "schema": { "type": "string" } }, { "name": "item_id", "in": "path", "required": true, "schema": { "type": "string" } } ], "description": "Authorization and validation are enforced by the owning service.", "x-handler": "put_preferences", "x-source-file": "crates/synckhub-server/src/routes/native_calendars/preferences.rs", "x-source-line": 45, "responses": { "default": { "description": "Platform error; branch on HTTP status and stable code, not the human-readable message.", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } } }, "2XX": { "description": "Successful JSON response", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/synckhub_server.routes.native_calendars.preferences.Preferences" } } } } }, "requestBody": { "required": true, "content": { "application/json": { "schema": { "$ref": "#/components/schemas/synckhub_server.routes.native_calendars.preferences.Input" } } } } }, "get": { "operationId": "platform_get__repos__repo_id__calendar_events__item_id__personal_preferences", "summary": "get preferences", "tags": [ "native_calendars · preferences" ], "parameters": [ { "name": "repo_id", "in": "path", "required": true, "schema": { "type": "string" } }, { "name": "item_id", "in": "path", "required": true, "schema": { "type": "string" } } ], "description": "Authorization and validation are enforced by the owning service.", "x-handler": "get_preferences", "x-source-file": "crates/synckhub-server/src/routes/native_calendars/preferences.rs", "x-source-line": 45, "responses": { "default": { "description": "Platform error; branch on HTTP status and stable code, not the human-readable message.", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } } }, "2XX": { "description": "Successful JSON response", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/synckhub_server.routes.native_calendars.preferences.Preferences" } } } } } }, "head": { "operationId": "platform_head__repos__repo_id__calendar_events__item_id__personal_preferences", "summary": "get preferences", "tags": [ "native_calendars · preferences" ], "parameters": [ { "name": "repo_id", "in": "path", "required": true, "schema": { "type": "string" } }, { "name": "item_id", "in": "path", "required": true, "schema": { "type": "string" } } ], "description": "Authorization and validation are enforced by the owning service.\n\nHEAD uses the GET handler and headers without a response body.", "x-handler": "get_preferences", "x-source-file": "crates/synckhub-server/src/routes/native_calendars/preferences.rs", "x-source-line": 45, "x-implicit-head": true, "responses": { "default": { "description": "Platform error; branch on HTTP status and stable code, not the human-readable message." } } } }, "/repos/{repo_id}/calendar-events/{item_id}/resources": { "put": { "operationId": "platform_put__repos__repo_id__calendar_events__item_id__resources", "summary": "request", "tags": [ "native_calendars · resources" ], "parameters": [ { "name": "repo_id", "in": "path", "required": true, "schema": { "type": "string" } }, { "name": "item_id", "in": "path", "required": true, "schema": { "type": "string" } } ], "description": "Authorization and validation are enforced by the owning service.", "x-handler": "request", "x-source-file": "crates/synckhub-server/src/routes/native_calendars/resources.rs", "x-source-line": 13, "responses": { "default": { "description": "Platform error; branch on HTTP status and stable code, not the human-readable message.", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } } }, "2XX": { "description": "Successful JSON response", "content": { "application/json": { "schema": { "type": "array", "items": { "$ref": "#/components/schemas/synckhub_core_postgres.service.native_calendars.resources.Booking" } } } } } }, "requestBody": { "required": true, "content": { "application/json": { "schema": { "$ref": "#/components/schemas/synckhub_server.routes.native_calendars.resources.RequestResources" } } } } }, "get": { "operationId": "platform_get__repos__repo_id__calendar_events__item_id__resources", "summary": "bookings", "tags": [ "native_calendars · resources" ], "parameters": [ { "name": "repo_id", "in": "path", "required": true, "schema": { "type": "string" } }, { "name": "item_id", "in": "path", "required": true, "schema": { "type": "string" } } ], "description": "Authorization and validation are enforced by the owning service.", "x-handler": "bookings", "x-source-file": "crates/synckhub-server/src/routes/native_calendars/resources.rs", "x-source-line": 13, "responses": { "default": { "description": "Platform error; branch on HTTP status and stable code, not the human-readable message.", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } } }, "2XX": { "description": "Successful JSON response", "content": { "application/json": { "schema": { "type": "array", "items": { "$ref": "#/components/schemas/synckhub_core_postgres.service.native_calendars.resources.Booking" } } } } } } }, "head": { "operationId": "platform_head__repos__repo_id__calendar_events__item_id__resources", "summary": "bookings", "tags": [ "native_calendars · resources" ], "parameters": [ { "name": "repo_id", "in": "path", "required": true, "schema": { "type": "string" } }, { "name": "item_id", "in": "path", "required": true, "schema": { "type": "string" } } ], "description": "Authorization and validation are enforced by the owning service.\n\nHEAD uses the GET handler and headers without a response body.", "x-handler": "bookings", "x-source-file": "crates/synckhub-server/src/routes/native_calendars/resources.rs", "x-source-line": 13, "x-implicit-head": true, "responses": { "default": { "description": "Platform error; branch on HTTP status and stable code, not the human-readable message." } } } }, "/repos/{repo_id}/calendar-events/{item_id}/response": { "post": { "operationId": "platform_post__repos__repo_id__calendar_events__item_id__response", "summary": "respond", "tags": [ "native_calendars" ], "parameters": [ { "name": "repo_id", "in": "path", "required": true, "schema": { "type": "string" } }, { "name": "item_id", "in": "path", "required": true, "schema": { "type": "string" } } ], "description": "Authorization and validation are enforced by the owning service.", "x-handler": "respond", "x-source-file": "crates/synckhub-server/src/routes/native_calendars.rs", "x-source-line": 47, "responses": { "default": { "description": "Platform error; branch on HTTP status and stable code, not the human-readable message.", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } } }, "2XX": { "description": "Successful JSON response", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/synckhub_core_postgres.service.native_calendars.commands.CommandReceipt" } } } } }, "requestBody": { "required": true, "content": { "application/json": { "schema": { "$ref": "#/components/schemas/synckhub_core.native_calendars.commands.Respond" } } } } } }, "/repos/{repo_id}/calendar-events/{item_id}/review-external": { "post": { "operationId": "platform_post__repos__repo_id__calendar_events__item_id__review_external", "summary": "review external", "tags": [ "native_calendars" ], "parameters": [ { "name": "repo_id", "in": "path", "required": true, "schema": { "type": "string" } }, { "name": "item_id", "in": "path", "required": true, "schema": { "type": "string" } } ], "description": "Authorization and validation are enforced by the owning service.", "x-handler": "review_external", "x-source-file": "crates/synckhub-server/src/routes/native_calendars.rs", "x-source-line": 47, "responses": { "default": { "description": "Platform error; branch on HTTP status and stable code, not the human-readable message.", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } } }, "2XX": { "description": "Successful JSON response", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/synckhub_core_postgres.service.native_calendars.commands.CommandReceipt" } } } } }, "requestBody": { "required": true, "content": { "application/json": { "schema": { "$ref": "#/components/schemas/synckhub_core.external_scheduling.state.ReviewExternal" } } } } } }, "/repos/{repo_id}/calendar-events/{item_id}/seen": { "post": { "operationId": "platform_post__repos__repo_id__calendar_events__item_id__seen", "summary": "seen", "tags": [ "native_calendars · attention" ], "parameters": [ { "name": "repo_id", "in": "path", "required": true, "schema": { "type": "string" } }, { "name": "item_id", "in": "path", "required": true, "schema": { "type": "string" } } ], "description": "Authorization and validation are enforced by the owning service.", "x-handler": "seen", "x-source-file": "crates/synckhub-server/src/routes/native_calendars/attention.rs", "x-source-line": 16, "responses": { "default": { "description": "Platform error; branch on HTTP status and stable code, not the human-readable message.", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } } }, "2XX": { "description": "Successful JSON response", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/synckhub_server.routes.native_calendars.attention.SeenResponse" } } } } }, "requestBody": { "required": true, "content": { "application/json": { "schema": { "$ref": "#/components/schemas/synckhub_server.routes.native_calendars.attention.SeenInput" } } } } } }, "/repos/{repo_id}/calendar-events/attention": { "get": { "operationId": "platform_get__repos__repo_id__calendar_events_attention", "summary": "attention", "tags": [ "native_calendars · attention" ], "parameters": [ { "name": "repo_id", "in": "path", "required": true, "schema": { "type": "string" } }, { "name": "limit", "in": "query", "required": false, "schema": { "anyOf": [ { "type": "integer", "minimum": 0 }, { "type": "null" } ] } }, { "name": "cursor", "in": "query", "required": false, "schema": { "anyOf": [ { "type": "string" }, { "type": "null" } ] } } ], "description": "Authorization and validation are enforced by the owning service.", "x-handler": "attention", "x-source-file": "crates/synckhub-server/src/routes/native_calendars/attention.rs", "x-source-line": 16, "responses": { "default": { "description": "Platform error; branch on HTTP status and stable code, not the human-readable message.", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } } }, "2XX": { "description": "Successful JSON response", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/synckhub_server.routes.native_calendars.attention.AttentionPage" } } } } } }, "head": { "operationId": "platform_head__repos__repo_id__calendar_events_attention", "summary": "attention", "tags": [ "native_calendars · attention" ], "parameters": [ { "name": "repo_id", "in": "path", "required": true, "schema": { "type": "string" } }, { "name": "limit", "in": "query", "required": false, "schema": { "anyOf": [ { "type": "integer", "minimum": 0 }, { "type": "null" } ] } }, { "name": "cursor", "in": "query", "required": false, "schema": { "anyOf": [ { "type": "string" }, { "type": "null" } ] } } ], "description": "Authorization and validation are enforced by the owning service.\n\nHEAD uses the GET handler and headers without a response body.", "x-handler": "attention", "x-source-file": "crates/synckhub-server/src/routes/native_calendars/attention.rs", "x-source-line": 16, "x-implicit-head": true, "responses": { "default": { "description": "Platform error; branch on HTTP status and stable code, not the human-readable message." } } } }, "/repos/{repo_id}/calendar-ics-imports/{job_id}": { "get": { "operationId": "platform_get__repos__repo_id__calendar_ics_imports__job_id_", "summary": "get report", "tags": [ "native_calendars · ics_import" ], "parameters": [ { "name": "repo_id", "in": "path", "required": true, "schema": { "type": "string" } }, { "name": "job_id", "in": "path", "required": true, "schema": { "type": "string" } } ], "description": "Authorization and validation are enforced by the owning service.", "x-handler": "get_report", "x-source-file": "crates/synckhub-server/src/routes/native_calendars/ics_import.rs", "x-source-line": 21, "responses": { "default": { "description": "Platform error; branch on HTTP status and stable code, not the human-readable message.", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } } }, "2XX": { "description": "Successful JSON response", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/synckhub_core_postgres.service.native_calendar_ics_import.Report" } } } } } }, "head": { "operationId": "platform_head__repos__repo_id__calendar_ics_imports__job_id_", "summary": "get report", "tags": [ "native_calendars · ics_import" ], "parameters": [ { "name": "repo_id", "in": "path", "required": true, "schema": { "type": "string" } }, { "name": "job_id", "in": "path", "required": true, "schema": { "type": "string" } } ], "description": "Authorization and validation are enforced by the owning service.\n\nHEAD uses the GET handler and headers without a response body.", "x-handler": "get_report", "x-source-file": "crates/synckhub-server/src/routes/native_calendars/ics_import.rs", "x-source-line": 21, "x-implicit-head": true, "responses": { "default": { "description": "Platform error; branch on HTTP status and stable code, not the human-readable message." } } } }, "/repos/{repo_id}/calendar-ics-imports/{job_id}/cutover-next": { "post": { "operationId": "platform_post__repos__repo_id__calendar_ics_imports__job_id__cutover_next", "summary": "cutover next", "tags": [ "native_calendars · ics_import" ], "parameters": [ { "name": "repo_id", "in": "path", "required": true, "schema": { "type": "string" } }, { "name": "job_id", "in": "path", "required": true, "schema": { "type": "string" } } ], "description": "Authorization and validation are enforced by the owning service.", "x-handler": "cutover_next", "x-source-file": "crates/synckhub-server/src/routes/native_calendars/ics_import.rs", "x-source-line": 21, "responses": { "default": { "description": "Platform error; branch on HTTP status and stable code, not the human-readable message.", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } } }, "2XX": { "description": "Successful JSON response", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/synckhub_core_postgres.service.native_calendar_ics_import.Report" } } } } } } }, "/repos/{repo_id}/calendar-ics-imports/{job_id}/verify": { "post": { "operationId": "platform_post__repos__repo_id__calendar_ics_imports__job_id__verify", "summary": "verify", "tags": [ "native_calendars · ics_import" ], "parameters": [ { "name": "repo_id", "in": "path", "required": true, "schema": { "type": "string" } }, { "name": "job_id", "in": "path", "required": true, "schema": { "type": "string" } } ], "description": "Authorization and validation are enforced by the owning service.", "x-handler": "verify", "x-source-file": "crates/synckhub-server/src/routes/native_calendars/ics_import.rs", "x-source-line": 21, "responses": { "default": { "description": "Platform error; branch on HTTP status and stable code, not the human-readable message.", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } } }, "2XX": { "description": "Successful JSON response", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/synckhub_core_postgres.service.native_calendar_ics_import.Report" } } } } } } }, "/repos/{repo_id}/calendar-invitees/resolve": { "post": { "operationId": "platform_post__repos__repo_id__calendar_invitees_resolve", "summary": "resolve", "tags": [ "native_calendars · invitees" ], "parameters": [ { "name": "repo_id", "in": "path", "required": true, "schema": { "type": "string" } } ], "description": "Authorization and validation are enforced by the owning service.", "x-handler": "resolve", "x-source-file": "crates/synckhub-server/src/routes/native_calendars/invitees.rs", "x-source-line": 15, "responses": { "default": { "description": "Platform error; branch on HTTP status and stable code, not the human-readable message.", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } } }, "2XX": { "description": "Successful JSON response", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/synckhub_server.routes.native_calendars.invitees.Output" } } } } }, "requestBody": { "required": true, "content": { "application/json": { "schema": { "$ref": "#/components/schemas/synckhub_server.routes.native_calendars.invitees.Input" } } } } } }, "/repos/{repo_id}/calendar-notices": { "get": { "operationId": "platform_get__repos__repo_id__calendar_notices", "summary": "notices", "tags": [ "native_calendars · lists" ], "parameters": [ { "name": "repo_id", "in": "path", "required": true, "schema": { "type": "string" } }, { "name": "start_date", "in": "query", "required": true, "schema": { "type": "string", "format": "date" } }, { "name": "end_date", "in": "query", "required": true, "schema": { "type": "string", "format": "date" } }, { "name": "time_zone", "in": "query", "required": true, "schema": { "type": "string" } }, { "name": "case_item_id", "in": "query", "required": false, "schema": { "anyOf": [ { "type": "string" }, { "type": "null" } ] } }, { "name": "user_ids", "in": "query", "required": false, "schema": { "anyOf": [ { "type": "string" }, { "type": "null" } ] } }, { "name": "q", "in": "query", "required": false, "schema": { "anyOf": [ { "type": "string" }, { "type": "null" } ] } }, { "name": "event_type_id", "in": "query", "required": false, "schema": { "anyOf": [ { "type": "string", "format": "uuid" }, { "type": "null" } ] } }, { "name": "professional_user_id", "in": "query", "required": false, "schema": { "anyOf": [ { "type": "string" }, { "type": "null" } ] } }, { "name": "kind", "in": "query", "required": false, "schema": { "$ref": "#/components/schemas/synckhub_server.routes.native_calendars.lists.notices.Kind" } }, { "name": "direction", "in": "query", "required": false, "schema": { "$ref": "#/components/schemas/synckhub_server.routes.native_calendars.lists.notices.Direction" } }, { "name": "limit", "in": "query", "required": false, "schema": { "anyOf": [ { "type": "integer", "minimum": 0 }, { "type": "null" } ] } }, { "name": "cursor", "in": "query", "required": false, "schema": { "anyOf": [ { "type": "string" }, { "type": "null" } ] } } ], "description": "Authorization and validation are enforced by the owning service.", "x-handler": "notices::notices", "x-source-file": "crates/synckhub-server/src/routes/native_calendars/lists.rs", "x-source-line": 24, "responses": { "default": { "description": "Platform error; branch on HTTP status and stable code, not the human-readable message.", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } } }, "2XX": { "description": "Successful JSON response", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/synckhub_server.routes.native_calendars.lists.notices.Page" } } } } } }, "head": { "operationId": "platform_head__repos__repo_id__calendar_notices", "summary": "notices", "tags": [ "native_calendars · lists" ], "parameters": [ { "name": "repo_id", "in": "path", "required": true, "schema": { "type": "string" } }, { "name": "start_date", "in": "query", "required": true, "schema": { "type": "string", "format": "date" } }, { "name": "end_date", "in": "query", "required": true, "schema": { "type": "string", "format": "date" } }, { "name": "time_zone", "in": "query", "required": true, "schema": { "type": "string" } }, { "name": "case_item_id", "in": "query", "required": false, "schema": { "anyOf": [ { "type": "string" }, { "type": "null" } ] } }, { "name": "user_ids", "in": "query", "required": false, "schema": { "anyOf": [ { "type": "string" }, { "type": "null" } ] } }, { "name": "q", "in": "query", "required": false, "schema": { "anyOf": [ { "type": "string" }, { "type": "null" } ] } }, { "name": "event_type_id", "in": "query", "required": false, "schema": { "anyOf": [ { "type": "string", "format": "uuid" }, { "type": "null" } ] } }, { "name": "professional_user_id", "in": "query", "required": false, "schema": { "anyOf": [ { "type": "string" }, { "type": "null" } ] } }, { "name": "kind", "in": "query", "required": false, "schema": { "$ref": "#/components/schemas/synckhub_server.routes.native_calendars.lists.notices.Kind" } }, { "name": "direction", "in": "query", "required": false, "schema": { "$ref": "#/components/schemas/synckhub_server.routes.native_calendars.lists.notices.Direction" } }, { "name": "limit", "in": "query", "required": false, "schema": { "anyOf": [ { "type": "integer", "minimum": 0 }, { "type": "null" } ] } }, { "name": "cursor", "in": "query", "required": false, "schema": { "anyOf": [ { "type": "string" }, { "type": "null" } ] } } ], "description": "Authorization and validation are enforced by the owning service.\n\nHEAD uses the GET handler and headers without a response body.", "x-handler": "notices::notices", "x-source-file": "crates/synckhub-server/src/routes/native_calendars/lists.rs", "x-source-line": 24, "x-implicit-head": true, "responses": { "default": { "description": "Platform error; branch on HTTP status and stable code, not the human-readable message." } } } }, "/repos/{repo_id}/calendar-people-events": { "post": { "operationId": "platform_post__repos__repo_id__calendar_people_events", "summary": "people events", "tags": [ "native_calendars · lists" ], "parameters": [ { "name": "repo_id", "in": "path", "required": true, "schema": { "type": "string" } } ], "description": "Authorization and validation are enforced by the owning service.", "x-handler": "people_events", "x-source-file": "crates/synckhub-server/src/routes/native_calendars/lists.rs", "x-source-line": 24, "responses": { "default": { "description": "Platform error; branch on HTTP status and stable code, not the human-readable message.", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } } }, "2XX": { "description": "Successful JSON response", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/synckhub_server.routes.native_calendars.lists.PeopleEventResult" } } } } }, "requestBody": { "required": true, "content": { "application/json": { "schema": { "$ref": "#/components/schemas/synckhub_server.routes.native_calendars.lists.PeopleEventRequest" } } } } } }, "/repos/{repo_id}/calendar-people/resolve": { "post": { "operationId": "platform_post__repos__repo_id__calendar_people_resolve", "summary": "resolve people", "tags": [ "native_calendars · lists" ], "parameters": [ { "name": "repo_id", "in": "path", "required": true, "schema": { "type": "string" } } ], "description": "Authorization and validation are enforced by the owning service.", "x-handler": "resolve_people", "x-source-file": "crates/synckhub-server/src/routes/native_calendars/lists.rs", "x-source-line": 24, "responses": { "default": { "description": "Platform error; branch on HTTP status and stable code, not the human-readable message.", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } } }, "2XX": { "description": "Successful JSON response", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/synckhub_server.routes.native_calendars.lists.CalendarPeopleDirectoryResult" } } } } }, "requestBody": { "required": true, "content": { "application/json": { "schema": { "$ref": "#/components/schemas/synckhub_server.routes.native_calendars.lists.CalendarPeopleResolve" } } } } } }, "/repos/{repo_id}/calendar-people/search": { "post": { "operationId": "platform_post__repos__repo_id__calendar_people_search", "summary": "search people", "tags": [ "native_calendars · lists" ], "parameters": [ { "name": "repo_id", "in": "path", "required": true, "schema": { "type": "string" } } ], "description": "Authorization and validation are enforced by the owning service.", "x-handler": "search_people", "x-source-file": "crates/synckhub-server/src/routes/native_calendars/lists.rs", "x-source-line": 24, "responses": { "default": { "description": "Platform error; branch on HTTP status and stable code, not the human-readable message.", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } } }, "2XX": { "description": "Successful JSON response", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/synckhub_server.routes.native_calendars.lists.CalendarPeopleDirectoryResult" } } } } }, "requestBody": { "required": true, "content": { "application/json": { "schema": { "$ref": "#/components/schemas/synckhub_server.routes.native_calendars.lists.CalendarPeopleSearch" } } } } } }, "/repos/{repo_id}/calendar-resources": { "get": { "operationId": "platform_get__repos__repo_id__calendar_resources", "summary": "list", "tags": [ "native_calendars · resources" ], "parameters": [ { "name": "repo_id", "in": "path", "required": true, "schema": { "type": "string" } } ], "description": "Authorization and validation are enforced by the owning service.", "x-handler": "list", "x-source-file": "crates/synckhub-server/src/routes/native_calendars/resources.rs", "x-source-line": 13, "responses": { "default": { "description": "Platform error; branch on HTTP status and stable code, not the human-readable message.", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } } }, "2XX": { "description": "Successful JSON response", "content": { "application/json": { "schema": { "type": "array", "items": { "$ref": "#/components/schemas/synckhub_server.routes.native_calendars.resources.ResourceEntry" } } } } } } }, "head": { "operationId": "platform_head__repos__repo_id__calendar_resources", "summary": "list", "tags": [ "native_calendars · resources" ], "parameters": [ { "name": "repo_id", "in": "path", "required": true, "schema": { "type": "string" } } ], "description": "Authorization and validation are enforced by the owning service.\n\nHEAD uses the GET handler and headers without a response body.", "x-handler": "list", "x-source-file": "crates/synckhub-server/src/routes/native_calendars/resources.rs", "x-source-line": 13, "x-implicit-head": true, "responses": { "default": { "description": "Platform error; branch on HTTP status and stable code, not the human-readable message." } } } }, "/repos/{repo_id}/calendar-resources/{item_id}": { "put": { "operationId": "platform_put__repos__repo_id__calendar_resources__item_id_", "summary": "configure", "tags": [ "native_calendars · resources" ], "parameters": [ { "name": "repo_id", "in": "path", "required": true, "schema": { "type": "string" } }, { "name": "item_id", "in": "path", "required": true, "schema": { "type": "string" } } ], "description": "Authorization and validation are enforced by the owning service.", "x-handler": "configure", "x-source-file": "crates/synckhub-server/src/routes/native_calendars/resources.rs", "x-source-line": 13, "responses": { "default": { "description": "Platform error; branch on HTTP status and stable code, not the human-readable message.", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } } }, "2XX": { "description": "Successful JSON response", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/synckhub_core_postgres.service.native_calendars.resources.ResourceConfig" } } } } }, "requestBody": { "required": true, "content": { "application/json": { "schema": { "$ref": "#/components/schemas/synckhub_core_postgres.service.native_calendars.resources.ResourceConfig" } } } } } }, "/repos/{repo_id}/calendar-resources/{resource_id}/requests": { "get": { "operationId": "platform_get__repos__repo_id__calendar_resources__resource_id__requests", "summary": "requests", "tags": [ "native_calendars · resources" ], "parameters": [ { "name": "repo_id", "in": "path", "required": true, "schema": { "type": "string" } }, { "name": "resource_id", "in": "path", "required": true, "schema": { "type": "string" } }, { "name": "cursor", "in": "query", "required": false, "schema": { "anyOf": [ { "type": "string", "format": "uuid" }, { "type": "null" } ] } } ], "description": "Authorization and validation are enforced by the owning service.", "x-handler": "requests", "x-source-file": "crates/synckhub-server/src/routes/native_calendars/resources.rs", "x-source-line": 13, "responses": { "default": { "description": "Platform error; branch on HTTP status and stable code, not the human-readable message.", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } } }, "2XX": { "description": "Successful JSON response", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/synckhub_server.routes.native_calendars.resources.PendingPage" } } } } } }, "head": { "operationId": "platform_head__repos__repo_id__calendar_resources__resource_id__requests", "summary": "requests", "tags": [ "native_calendars · resources" ], "parameters": [ { "name": "repo_id", "in": "path", "required": true, "schema": { "type": "string" } }, { "name": "resource_id", "in": "path", "required": true, "schema": { "type": "string" } }, { "name": "cursor", "in": "query", "required": false, "schema": { "anyOf": [ { "type": "string", "format": "uuid" }, { "type": "null" } ] } } ], "description": "Authorization and validation are enforced by the owning service.\n\nHEAD uses the GET handler and headers without a response body.", "x-handler": "requests", "x-source-file": "crates/synckhub-server/src/routes/native_calendars/resources.rs", "x-source-line": 13, "x-implicit-head": true, "responses": { "default": { "description": "Platform error; branch on HTTP status and stable code, not the human-readable message." } } } }, "/repos/{repo_id}/calendar-resources/{resource_id}/requests/{event_id}": { "put": { "operationId": "platform_put__repos__repo_id__calendar_resources__resource_id__requests__event_id_", "summary": "decide", "tags": [ "native_calendars · resources" ], "parameters": [ { "name": "repo_id", "in": "path", "required": true, "schema": { "type": "string" } }, { "name": "resource_id", "in": "path", "required": true, "schema": { "type": "string" } }, { "name": "event_id", "in": "path", "required": true, "schema": { "type": "string" } } ], "description": "Authorization and validation are enforced by the owning service.", "x-handler": "decide", "x-source-file": "crates/synckhub-server/src/routes/native_calendars/resources.rs", "x-source-line": 13, "responses": { "default": { "description": "Platform error; branch on HTTP status and stable code, not the human-readable message.", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } } }, "2XX": { "description": "Successful JSON response", "content": { "application/json": { "schema": { "type": "array", "items": { "$ref": "#/components/schemas/synckhub_core_postgres.service.native_calendars.resources.Booking" } } } } } }, "requestBody": { "required": true, "content": { "application/json": { "schema": { "$ref": "#/components/schemas/synckhub_server.routes.native_calendars.resources.Decision" } } } } } }, "/repos/{repo_id}/calendar-senders": { "get": { "operationId": "platform_get__repos__repo_id__calendar_senders", "summary": "senders", "tags": [ "native_calendars · invitees" ], "parameters": [ { "name": "repo_id", "in": "path", "required": true, "schema": { "type": "string" } } ], "description": "Authorization and validation are enforced by the owning service.", "x-handler": "senders", "x-source-file": "crates/synckhub-server/src/routes/native_calendars/invitees.rs", "x-source-line": 15, "responses": { "default": { "description": "Platform error; branch on HTTP status and stable code, not the human-readable message.", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } } }, "2XX": { "description": "Successful JSON response", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/synckhub_server.routes.native_calendars.invitees.Senders" } } } } } }, "head": { "operationId": "platform_head__repos__repo_id__calendar_senders", "summary": "senders", "tags": [ "native_calendars · invitees" ], "parameters": [ { "name": "repo_id", "in": "path", "required": true, "schema": { "type": "string" } } ], "description": "Authorization and validation are enforced by the owning service.\n\nHEAD uses the GET handler and headers without a response body.", "x-handler": "senders", "x-source-file": "crates/synckhub-server/src/routes/native_calendars/invitees.rs", "x-source-line": 15, "x-implicit-head": true, "responses": { "default": { "description": "Platform error; branch on HTTP status and stable code, not the human-readable message." } } } }, "/repos/{repo_id}/calendars": { "post": { "operationId": "platform_post__repos__repo_id__calendars", "summary": "create calendar", "tags": [ "native_calendars" ], "parameters": [ { "name": "repo_id", "in": "path", "required": true, "schema": { "type": "string" } } ], "description": "Authorization and validation are enforced by the owning service.", "x-handler": "create_calendar", "x-source-file": "crates/synckhub-server/src/routes/native_calendars.rs", "x-source-line": 47, "responses": { "default": { "description": "Platform error; branch on HTTP status and stable code, not the human-readable message.", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } } }, "2XX": { "description": "Successful JSON response", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/synckhub_core_postgres.service.native_calendars.commands.CommandReceipt" } } } } }, "requestBody": { "required": true, "content": { "application/json": { "schema": { "$ref": "#/components/schemas/synckhub_core.native_calendars.commands.CreateCalendar" } } } } }, "get": { "operationId": "platform_get__repos__repo_id__calendars", "summary": "calendars", "tags": [ "native_calendars · lists" ], "parameters": [ { "name": "repo_id", "in": "path", "required": true, "schema": { "type": "string" } }, { "name": "limit", "in": "query", "required": false, "schema": { "anyOf": [ { "type": "integer", "minimum": 0 }, { "type": "null" } ] } }, { "name": "cursor", "in": "query", "required": false, "schema": { "anyOf": [ { "type": "string" }, { "type": "null" } ] } } ], "description": "Authorization and validation are enforced by the owning service.", "x-handler": "calendars", "x-source-file": "crates/synckhub-server/src/routes/native_calendars/lists.rs", "x-source-line": 24, "responses": { "default": { "description": "Platform error; branch on HTTP status and stable code, not the human-readable message.", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } } }, "2XX": { "description": "Successful JSON response", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/synckhub_server.routes.native_calendars.lists.CalendarPage" } } } } } }, "head": { "operationId": "platform_head__repos__repo_id__calendars", "summary": "calendars", "tags": [ "native_calendars · lists" ], "parameters": [ { "name": "repo_id", "in": "path", "required": true, "schema": { "type": "string" } }, { "name": "limit", "in": "query", "required": false, "schema": { "anyOf": [ { "type": "integer", "minimum": 0 }, { "type": "null" } ] } }, { "name": "cursor", "in": "query", "required": false, "schema": { "anyOf": [ { "type": "string" }, { "type": "null" } ] } } ], "description": "Authorization and validation are enforced by the owning service.\n\nHEAD uses the GET handler and headers without a response body.", "x-handler": "calendars", "x-source-file": "crates/synckhub-server/src/routes/native_calendars/lists.rs", "x-source-line": 24, "x-implicit-head": true, "responses": { "default": { "description": "Platform error; branch on HTTP status and stable code, not the human-readable message." } } } }, "/repos/{repo_id}/calendars/{calendar_id}/delegates": { "put": { "operationId": "platform_put__repos__repo_id__calendars__calendar_id__delegates", "summary": "set grant", "tags": [ "native_calendars · delegation" ], "parameters": [ { "name": "repo_id", "in": "path", "required": true, "schema": { "type": "string" } }, { "name": "calendar_id", "in": "path", "required": true, "schema": { "type": "string" } } ], "description": "Authorization and validation are enforced by the owning service.", "x-handler": "set_grant", "x-source-file": "crates/synckhub-server/src/routes/native_calendars/delegation.rs", "x-source-line": 61, "responses": { "default": { "description": "Platform error; branch on HTTP status and stable code, not the human-readable message.", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } } }, "2XX": { "description": "Successful JSON response", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/synckhub_server.routes.native_calendars.delegation.Grant" } } } } }, "requestBody": { "required": true, "content": { "application/json": { "schema": { "$ref": "#/components/schemas/synckhub_server.routes.native_calendars.delegation.Grant" } } } } }, "get": { "operationId": "platform_get__repos__repo_id__calendars__calendar_id__delegates", "summary": "grants", "tags": [ "native_calendars · delegation" ], "parameters": [ { "name": "repo_id", "in": "path", "required": true, "schema": { "type": "string" } }, { "name": "calendar_id", "in": "path", "required": true, "schema": { "type": "string" } } ], "description": "Authorization and validation are enforced by the owning service.", "x-handler": "grants", "x-source-file": "crates/synckhub-server/src/routes/native_calendars/delegation.rs", "x-source-line": 61, "responses": { "default": { "description": "Platform error; branch on HTTP status and stable code, not the human-readable message.", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } } }, "2XX": { "description": "Successful JSON response", "content": { "application/json": { "schema": { "type": "array", "items": { "$ref": "#/components/schemas/synckhub_server.routes.native_calendars.delegation.Grant" } } } } } } }, "head": { "operationId": "platform_head__repos__repo_id__calendars__calendar_id__delegates", "summary": "grants", "tags": [ "native_calendars · delegation" ], "parameters": [ { "name": "repo_id", "in": "path", "required": true, "schema": { "type": "string" } }, { "name": "calendar_id", "in": "path", "required": true, "schema": { "type": "string" } } ], "description": "Authorization and validation are enforced by the owning service.\n\nHEAD uses the GET handler and headers without a response body.", "x-handler": "grants", "x-source-file": "crates/synckhub-server/src/routes/native_calendars/delegation.rs", "x-source-line": 61, "x-implicit-head": true, "responses": { "default": { "description": "Platform error; branch on HTTP status and stable code, not the human-readable message." } } } }, "/repos/{repo_id}/calendars/{calendar_id}/ics-imports/trial": { "post": { "operationId": "platform_post__repos__repo_id__calendars__calendar_id__ics_imports_trial", "summary": "trial", "tags": [ "native_calendars · ics_import" ], "parameters": [ { "name": "repo_id", "in": "path", "required": true, "schema": { "type": "string" } }, { "name": "calendar_id", "in": "path", "required": true, "schema": { "type": "string" } }, { "name": "source_key", "in": "query", "required": true, "schema": { "type": "string" } }, { "name": "time_zone", "in": "query", "required": false, "schema": { "type": "string" } } ], "description": "Authorization and validation are enforced by the owning service.", "x-handler": "trial", "x-source-file": "crates/synckhub-server/src/routes/native_calendars/ics_import.rs", "x-source-line": 21, "responses": { "default": { "description": "Platform error; branch on HTTP status and stable code, not the human-readable message.", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } } }, "2XX": { "description": "Successful JSON response", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/synckhub_core_postgres.service.native_calendar_ics_import.Report" } } } } }, "requestBody": { "required": true, "content": { "text/calendar": { "schema": { "type": "string", "description": "ICS calendar content to import." } } } } } }, "/repos/{repo_id}/calendars/{calendar_id}/on-behalf/{represented}": { "post": { "operationId": "platform_post__repos__repo_id__calendars__calendar_id__on_behalf__represented_", "summary": "command", "tags": [ "native_calendars · delegation" ], "parameters": [ { "name": "repo_id", "in": "path", "required": true, "schema": { "type": "string" } }, { "name": "calendar_id", "in": "path", "required": true, "schema": { "type": "string" } }, { "name": "represented", "in": "path", "required": true, "schema": { "type": "string" } } ], "description": "Authorization and validation are enforced by the owning service.", "x-handler": "command", "x-source-file": "crates/synckhub-server/src/routes/native_calendars/delegation.rs", "x-source-line": 61, "responses": { "default": { "description": "Platform error; branch on HTTP status and stable code, not the human-readable message.", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } } }, "2XX": { "description": "Successful JSON response", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/synckhub_core_postgres.service.native_calendars.commands.CommandReceipt" } } } } }, "requestBody": { "required": true, "content": { "application/json": { "schema": { "$ref": "#/components/schemas/synckhub_server.routes.native_calendars.delegation.Request" } } } } }, "get": { "operationId": "platform_get__repos__repo_id__calendars__calendar_id__on_behalf__represented_", "summary": "events", "tags": [ "native_calendars · delegation" ], "parameters": [ { "name": "repo_id", "in": "path", "required": true, "schema": { "type": "string" } }, { "name": "calendar_id", "in": "path", "required": true, "schema": { "type": "string" } }, { "name": "represented", "in": "path", "required": true, "schema": { "type": "string" } }, { "name": "limit", "in": "query", "required": false, "schema": { "anyOf": [ { "type": "integer", "minimum": 0 }, { "type": "null" } ] } }, { "name": "cursor", "in": "query", "required": false, "schema": { "anyOf": [ { "type": "string" }, { "type": "null" } ] } } ], "description": "Authorization and validation are enforced by the owning service.", "x-handler": "events", "x-source-file": "crates/synckhub-server/src/routes/native_calendars/delegation.rs", "x-source-line": 61, "responses": { "default": { "description": "Platform error; branch on HTTP status and stable code, not the human-readable message.", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } } }, "2XX": { "description": "Successful JSON response", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/synckhub_server.routes.native_calendars.delegation.EventList" } } } } } }, "head": { "operationId": "platform_head__repos__repo_id__calendars__calendar_id__on_behalf__represented_", "summary": "events", "tags": [ "native_calendars · delegation" ], "parameters": [ { "name": "repo_id", "in": "path", "required": true, "schema": { "type": "string" } }, { "name": "calendar_id", "in": "path", "required": true, "schema": { "type": "string" } }, { "name": "represented", "in": "path", "required": true, "schema": { "type": "string" } }, { "name": "limit", "in": "query", "required": false, "schema": { "anyOf": [ { "type": "integer", "minimum": 0 }, { "type": "null" } ] } }, { "name": "cursor", "in": "query", "required": false, "schema": { "anyOf": [ { "type": "string" }, { "type": "null" } ] } } ], "description": "Authorization and validation are enforced by the owning service.\n\nHEAD uses the GET handler and headers without a response body.", "x-handler": "events", "x-source-file": "crates/synckhub-server/src/routes/native_calendars/delegation.rs", "x-source-line": 61, "x-implicit-head": true, "responses": { "default": { "description": "Platform error; branch on HTTP status and stable code, not the human-readable message." } } } }, "/repos/{repo_id}/calendars/{calendar_id}/on-behalf/{represented}/invitees/resolve": { "post": { "operationId": "platform_post__repos__repo_id__calendars__calendar_id__on_behalf__represented__invitees_resolve", "summary": "resolve invitees", "tags": [ "native_calendars · delegation" ], "parameters": [ { "name": "repo_id", "in": "path", "required": true, "schema": { "type": "string" } }, { "name": "calendar_id", "in": "path", "required": true, "schema": { "type": "string" } }, { "name": "represented", "in": "path", "required": true, "schema": { "type": "string" } } ], "description": "Authorization and validation are enforced by the owning service.", "x-handler": "resolve_invitees", "x-source-file": "crates/synckhub-server/src/routes/native_calendars/delegation.rs", "x-source-line": 61, "responses": { "default": { "description": "Platform error; branch on HTTP status and stable code, not the human-readable message.", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } } }, "2XX": { "description": "Successful JSON response", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/synckhub_server.routes.native_calendars.invitees.Output" } } } } }, "requestBody": { "required": true, "content": { "application/json": { "schema": { "$ref": "#/components/schemas/synckhub_server.routes.native_calendars.delegation.ResolveRequest" } } } } } }, "/repos/{repo_id}/calendars/{item_id}": { "patch": { "operationId": "platform_patch__repos__repo_id__calendars__item_id_", "summary": "edit calendar", "tags": [ "native_calendars" ], "parameters": [ { "name": "repo_id", "in": "path", "required": true, "schema": { "type": "string" } }, { "name": "item_id", "in": "path", "required": true, "schema": { "type": "string" } } ], "description": "Authorization and validation are enforced by the owning service.", "x-handler": "edit_calendar", "x-source-file": "crates/synckhub-server/src/routes/native_calendars.rs", "x-source-line": 47, "responses": { "default": { "description": "Platform error; branch on HTTP status and stable code, not the human-readable message.", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } } }, "2XX": { "description": "Successful JSON response", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/synckhub_core_postgres.service.native_calendars.commands.CommandReceipt" } } } } }, "requestBody": { "required": true, "content": { "application/json": { "schema": { "$ref": "#/components/schemas/synckhub_core.native_calendars.commands.EditCalendar" } } } } }, "get": { "operationId": "platform_get__repos__repo_id__calendars__item_id_", "summary": "calendar detail", "tags": [ "native_calendars · read" ], "parameters": [ { "name": "repo_id", "in": "path", "required": true, "schema": { "type": "string" } }, { "name": "item_id", "in": "path", "required": true, "schema": { "type": "string" } } ], "description": "Authorization and validation are enforced by the owning service.", "x-handler": "calendar_detail", "x-source-file": "crates/synckhub-server/src/routes/native_calendars/read.rs", "x-source-line": 11, "responses": { "default": { "description": "Platform error; branch on HTTP status and stable code, not the human-readable message.", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } } }, "2XX": { "description": "Successful JSON response", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/synckhub_server.routes.native_calendars.read.CalendarDetail" } } } } } }, "head": { "operationId": "platform_head__repos__repo_id__calendars__item_id_", "summary": "calendar detail", "tags": [ "native_calendars · read" ], "parameters": [ { "name": "repo_id", "in": "path", "required": true, "schema": { "type": "string" } }, { "name": "item_id", "in": "path", "required": true, "schema": { "type": "string" } } ], "description": "Authorization and validation are enforced by the owning service.\n\nHEAD uses the GET handler and headers without a response body.", "x-handler": "calendar_detail", "x-source-file": "crates/synckhub-server/src/routes/native_calendars/read.rs", "x-source-line": 11, "x-implicit-head": true, "responses": { "default": { "description": "Platform error; branch on HTTP status and stable code, not the human-readable message." } } } }, "/repos/{repo_id}/calendars/{item_id}/archive": { "post": { "operationId": "platform_post__repos__repo_id__calendars__item_id__archive", "summary": "archive calendar", "tags": [ "native_calendars" ], "parameters": [ { "name": "repo_id", "in": "path", "required": true, "schema": { "type": "string" } }, { "name": "item_id", "in": "path", "required": true, "schema": { "type": "string" } } ], "description": "Authorization and validation are enforced by the owning service.", "x-handler": "archive_calendar", "x-source-file": "crates/synckhub-server/src/routes/native_calendars.rs", "x-source-line": 47, "responses": { "default": { "description": "Platform error; branch on HTTP status and stable code, not the human-readable message.", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } } }, "2XX": { "description": "Successful JSON response", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/synckhub_core_postgres.service.native_calendars.commands.CommandReceipt" } } } } }, "requestBody": { "required": true, "content": { "application/json": { "schema": { "$ref": "#/components/schemas/synckhub_core.native_calendars.commands.VersionedCommand" } } } } } }, "/repos/{repo_id}/calendars/{item_id}/events": { "post": { "operationId": "platform_post__repos__repo_id__calendars__item_id__events", "summary": "create event", "tags": [ "native_calendars" ], "parameters": [ { "name": "repo_id", "in": "path", "required": true, "schema": { "type": "string" } }, { "name": "item_id", "in": "path", "required": true, "schema": { "type": "string" } } ], "description": "Authorization and validation are enforced by the owning service.", "x-handler": "create_event", "x-source-file": "crates/synckhub-server/src/routes/native_calendars.rs", "x-source-line": 47, "responses": { "default": { "description": "Platform error; branch on HTTP status and stable code, not the human-readable message.", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } } }, "2XX": { "description": "Successful JSON response", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/synckhub_core_postgres.service.native_calendars.commands.CommandReceipt" } } } } }, "requestBody": { "required": true, "content": { "application/json": { "schema": { "$ref": "#/components/schemas/synckhub_core.native_calendars.commands.CreateEvent" } } } } }, "get": { "operationId": "platform_get__repos__repo_id__calendars__item_id__events", "summary": "calendar events", "tags": [ "native_calendars · lists" ], "parameters": [ { "name": "repo_id", "in": "path", "required": true, "schema": { "type": "string" } }, { "name": "item_id", "in": "path", "required": true, "schema": { "type": "string" } }, { "name": "start_date", "in": "query", "required": true, "schema": { "type": "string", "format": "date" } }, { "name": "end_date", "in": "query", "required": true, "schema": { "type": "string", "format": "date" } }, { "name": "time_zone", "in": "query", "required": true, "schema": { "type": "string" } }, { "name": "calendar_item_id", "in": "query", "required": false, "schema": { "anyOf": [ { "type": "string" }, { "type": "null" } ] } }, { "name": "calendar_item_ids", "in": "query", "required": false, "schema": { "anyOf": [ { "type": "string" }, { "type": "null" } ] } }, { "name": "case_item_id", "in": "query", "required": false, "schema": { "anyOf": [ { "type": "string" }, { "type": "null" } ] } }, { "name": "limit", "in": "query", "required": false, "schema": { "anyOf": [ { "type": "integer", "minimum": 0 }, { "type": "null" } ] } }, { "name": "cursor", "in": "query", "required": false, "schema": { "anyOf": [ { "type": "string" }, { "type": "null" } ] } } ], "description": "Authorization and validation are enforced by the owning service.", "x-handler": "calendar_events", "x-source-file": "crates/synckhub-server/src/routes/native_calendars/lists.rs", "x-source-line": 24, "responses": { "default": { "description": "Platform error; branch on HTTP status and stable code, not the human-readable message.", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } } }, "2XX": { "description": "Successful JSON response", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/synckhub_server.routes.native_calendars.lists.EventPage" } } } } } }, "head": { "operationId": "platform_head__repos__repo_id__calendars__item_id__events", "summary": "calendar events", "tags": [ "native_calendars · lists" ], "parameters": [ { "name": "repo_id", "in": "path", "required": true, "schema": { "type": "string" } }, { "name": "item_id", "in": "path", "required": true, "schema": { "type": "string" } }, { "name": "start_date", "in": "query", "required": true, "schema": { "type": "string", "format": "date" } }, { "name": "end_date", "in": "query", "required": true, "schema": { "type": "string", "format": "date" } }, { "name": "time_zone", "in": "query", "required": true, "schema": { "type": "string" } }, { "name": "calendar_item_id", "in": "query", "required": false, "schema": { "anyOf": [ { "type": "string" }, { "type": "null" } ] } }, { "name": "calendar_item_ids", "in": "query", "required": false, "schema": { "anyOf": [ { "type": "string" }, { "type": "null" } ] } }, { "name": "case_item_id", "in": "query", "required": false, "schema": { "anyOf": [ { "type": "string" }, { "type": "null" } ] } }, { "name": "limit", "in": "query", "required": false, "schema": { "anyOf": [ { "type": "integer", "minimum": 0 }, { "type": "null" } ] } }, { "name": "cursor", "in": "query", "required": false, "schema": { "anyOf": [ { "type": "string" }, { "type": "null" } ] } } ], "description": "Authorization and validation are enforced by the owning service.\n\nHEAD uses the GET handler and headers without a response body.", "x-handler": "calendar_events", "x-source-file": "crates/synckhub-server/src/routes/native_calendars/lists.rs", "x-source-line": 24, "x-implicit-head": true, "responses": { "default": { "description": "Platform error; branch on HTTP status and stable code, not the human-readable message." } } } }, "/repos/{repo_id}/calendars/{item_id}/export": { "get": { "operationId": "platform_get__repos__repo_id__calendars__item_id__export", "summary": "export calendar", "tags": [ "native_calendars · read" ], "parameters": [ { "name": "repo_id", "in": "path", "required": true, "schema": { "type": "string" } }, { "name": "item_id", "in": "path", "required": true, "schema": { "type": "string" } } ], "description": "Authorization and validation are enforced by the owning service.", "x-handler": "export_calendar", "x-source-file": "crates/synckhub-server/src/routes/native_calendars/read.rs", "x-source-line": 11, "responses": { "default": { "description": "Platform error; branch on HTTP status and stable code, not the human-readable message.", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } } } } }, "head": { "operationId": "platform_head__repos__repo_id__calendars__item_id__export", "summary": "export calendar", "tags": [ "native_calendars · read" ], "parameters": [ { "name": "repo_id", "in": "path", "required": true, "schema": { "type": "string" } }, { "name": "item_id", "in": "path", "required": true, "schema": { "type": "string" } } ], "description": "Authorization and validation are enforced by the owning service.\n\nHEAD uses the GET handler and headers without a response body.", "x-handler": "export_calendar", "x-source-file": "crates/synckhub-server/src/routes/native_calendars/read.rs", "x-source-line": 11, "x-implicit-head": true, "responses": { "default": { "description": "Platform error; branch on HTTP status and stable code, not the human-readable message." } } } }, "/repos/{repo_id}/calendars/{item_id}/unarchive": { "post": { "operationId": "platform_post__repos__repo_id__calendars__item_id__unarchive", "summary": "unarchive calendar", "tags": [ "native_calendars" ], "parameters": [ { "name": "repo_id", "in": "path", "required": true, "schema": { "type": "string" } }, { "name": "item_id", "in": "path", "required": true, "schema": { "type": "string" } } ], "description": "Authorization and validation are enforced by the owning service.", "x-handler": "unarchive_calendar", "x-source-file": "crates/synckhub-server/src/routes/native_calendars.rs", "x-source-line": 47, "responses": { "default": { "description": "Platform error; branch on HTTP status and stable code, not the human-readable message.", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } } }, "2XX": { "description": "Successful JSON response", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/synckhub_core_postgres.service.native_calendars.commands.CommandReceipt" } } } } }, "requestBody": { "required": true, "content": { "application/json": { "schema": { "$ref": "#/components/schemas/synckhub_core.native_calendars.commands.VersionedCommand" } } } } } }, "/repos/{repo_id}/case-lifecycle-versions": { "get": { "operationId": "platform_get__repos__repo_id__case_lifecycle_versions", "summary": "get case lifecycle versions", "tags": [ "cases · mod" ], "parameters": [ { "name": "repo_id", "in": "path", "required": true, "schema": { "type": "string" } }, { "name": "limit", "in": "query", "required": false, "schema": { "anyOf": [ { "type": "integer" }, { "type": "null" } ] } } ], "description": "Authorization and validation are enforced by the owning service.", "x-handler": "get_case_lifecycle_versions", "x-source-file": "crates/synckhub-server/src/routes/cases/mod.rs", "x-source-line": 17, "responses": { "default": { "description": "Platform error; branch on HTTP status and stable code, not the human-readable message.", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } } }, "2XX": { "description": "Successful JSON response", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/synckhub_server.routes.cases.workflow.CaseLifecycleVersionsResponse" } } } } } }, "head": { "operationId": "platform_head__repos__repo_id__case_lifecycle_versions", "summary": "get case lifecycle versions", "tags": [ "cases · mod" ], "parameters": [ { "name": "repo_id", "in": "path", "required": true, "schema": { "type": "string" } }, { "name": "limit", "in": "query", "required": false, "schema": { "anyOf": [ { "type": "integer" }, { "type": "null" } ] } } ], "description": "Authorization and validation are enforced by the owning service.\n\nHEAD uses the GET handler and headers without a response body.", "x-handler": "get_case_lifecycle_versions", "x-source-file": "crates/synckhub-server/src/routes/cases/mod.rs", "x-source-line": 17, "x-implicit-head": true, "responses": { "default": { "description": "Platform error; branch on HTTP status and stable code, not the human-readable message." } } } }, "/repos/{repo_id}/case-metadata-definitions": { "get": { "operationId": "platform_get__repos__repo_id__case_metadata_definitions", "summary": "list case metadata definitions", "tags": [ "items · metadata" ], "parameters": [ { "name": "repo_id", "in": "path", "required": true, "schema": { "type": "string" } }, { "name": "item_type", "in": "query", "required": false, "schema": { "anyOf": [ { "type": "string" }, { "type": "null" } ] } } ], "description": "Authorization and validation are enforced by the owning service.", "x-handler": "list_case_metadata_definitions", "x-source-file": "crates/synckhub-server/src/routes/items/metadata.rs", "x-source-line": 7, "responses": { "default": { "description": "Platform error; branch on HTTP status and stable code, not the human-readable message.", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } } }, "2XX": { "description": "Successful JSON response", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/synckhub_server.routes.items.metadata.ListCaseMetadataDefinitionsResponse" } } } } } }, "head": { "operationId": "platform_head__repos__repo_id__case_metadata_definitions", "summary": "list case metadata definitions", "tags": [ "items · metadata" ], "parameters": [ { "name": "repo_id", "in": "path", "required": true, "schema": { "type": "string" } }, { "name": "item_type", "in": "query", "required": false, "schema": { "anyOf": [ { "type": "string" }, { "type": "null" } ] } } ], "description": "Authorization and validation are enforced by the owning service.\n\nHEAD uses the GET handler and headers without a response body.", "x-handler": "list_case_metadata_definitions", "x-source-file": "crates/synckhub-server/src/routes/items/metadata.rs", "x-source-line": 7, "x-implicit-head": true, "responses": { "default": { "description": "Platform error; branch on HTTP status and stable code, not the human-readable message." } } } }, "/repos/{repo_id}/case-metadata-definitions/{subtype_key}": { "delete": { "operationId": "platform_delete__repos__repo_id__case_metadata_definitions__subtype_key_", "summary": "delete case metadata definition", "tags": [ "items · metadata" ], "parameters": [ { "name": "repo_id", "in": "path", "required": true, "schema": { "type": "string" } }, { "name": "subtype_key", "in": "path", "required": true, "schema": { "type": "string" } } ], "description": "Authorization and validation are enforced by the owning service.", "x-handler": "delete_case_metadata_definition", "x-source-file": "crates/synckhub-server/src/routes/items/metadata.rs", "x-source-line": 7, "responses": { "default": { "description": "Platform error; branch on HTTP status and stable code, not the human-readable message.", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } } } } }, "put": { "operationId": "platform_put__repos__repo_id__case_metadata_definitions__subtype_key_", "summary": "put case metadata definition", "tags": [ "items · metadata" ], "parameters": [ { "name": "repo_id", "in": "path", "required": true, "schema": { "type": "string" } }, { "name": "subtype_key", "in": "path", "required": true, "schema": { "type": "string" } } ], "description": "Authorization and validation are enforced by the owning service.", "x-handler": "put_case_metadata_definition", "x-source-file": "crates/synckhub-server/src/routes/items/metadata.rs", "x-source-line": 7, "responses": { "default": { "description": "Platform error; branch on HTTP status and stable code, not the human-readable message.", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } } }, "2XX": { "description": "Successful JSON response", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/synckhub_server.routes.items.metadata.ItemSubtypeDefinitionResponse" } } } } }, "requestBody": { "required": true, "content": { "application/json": { "schema": { "$ref": "#/components/schemas/synckhub_server.routes.items.metadata.PutItemSubtypeDefinitionRequest" } } } } } }, "/repos/{repo_id}/case-party-links": { "post": { "operationId": "platform_post__repos__repo_id__case_party_links", "summary": "create case party link", "tags": [ "directory · party_links" ], "parameters": [ { "name": "repo_id", "in": "path", "required": true, "schema": { "type": "string" } } ], "description": "Authorization and validation are enforced by the owning service.", "x-handler": "create_case_party_link", "x-source-file": "crates/synckhub-server/src/routes/directory/party_links.rs", "x-source-line": 7, "responses": { "default": { "description": "Platform error; branch on HTTP status and stable code, not the human-readable message.", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } } }, "2XX": { "description": "Successful JSON response", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/synckhub_server.routes.directory.party_links.CasePartyLinkSummary" } } } } }, "requestBody": { "required": true, "content": { "application/json": { "schema": { "$ref": "#/components/schemas/synckhub_server.routes.directory.party_links.CreateCasePartyLinkRequest" } } } } }, "get": { "operationId": "platform_get__repos__repo_id__case_party_links", "summary": "list case party links", "tags": [ "directory · party_links" ], "parameters": [ { "name": "repo_id", "in": "path", "required": true, "schema": { "type": "string" } }, { "name": "case_item_id", "in": "query", "required": false, "schema": { "anyOf": [ { "type": "string" }, { "type": "null" } ] } }, { "name": "party_item_id", "in": "query", "required": false, "schema": { "anyOf": [ { "type": "string" }, { "type": "null" } ] } }, { "name": "role_key", "in": "query", "required": false, "schema": { "anyOf": [ { "type": "string" }, { "type": "null" } ] } }, { "name": "status", "in": "query", "required": false, "schema": { "anyOf": [ { "type": "string" }, { "type": "null" } ] } } ], "description": "Authorization and validation are enforced by the owning service.", "x-handler": "list_case_party_links", "x-source-file": "crates/synckhub-server/src/routes/directory/party_links.rs", "x-source-line": 7, "responses": { "default": { "description": "Platform error; branch on HTTP status and stable code, not the human-readable message.", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } } }, "2XX": { "description": "Successful JSON response", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/synckhub_server.routes.directory.party_links.CasePartyLinksResponse" } } } } } }, "head": { "operationId": "platform_head__repos__repo_id__case_party_links", "summary": "list case party links", "tags": [ "directory · party_links" ], "parameters": [ { "name": "repo_id", "in": "path", "required": true, "schema": { "type": "string" } }, { "name": "case_item_id", "in": "query", "required": false, "schema": { "anyOf": [ { "type": "string" }, { "type": "null" } ] } }, { "name": "party_item_id", "in": "query", "required": false, "schema": { "anyOf": [ { "type": "string" }, { "type": "null" } ] } }, { "name": "role_key", "in": "query", "required": false, "schema": { "anyOf": [ { "type": "string" }, { "type": "null" } ] } }, { "name": "status", "in": "query", "required": false, "schema": { "anyOf": [ { "type": "string" }, { "type": "null" } ] } } ], "description": "Authorization and validation are enforced by the owning service.\n\nHEAD uses the GET handler and headers without a response body.", "x-handler": "list_case_party_links", "x-source-file": "crates/synckhub-server/src/routes/directory/party_links.rs", "x-source-line": 7, "x-implicit-head": true, "responses": { "default": { "description": "Platform error; branch on HTTP status and stable code, not the human-readable message." } } } }, "/repos/{repo_id}/case-party-links/{link_id}/archive": { "post": { "operationId": "platform_post__repos__repo_id__case_party_links__link_id__archive", "summary": "archive case party link", "tags": [ "directory · party_links" ], "parameters": [ { "name": "repo_id", "in": "path", "required": true, "schema": { "type": "string" } }, { "name": "link_id", "in": "path", "required": true, "schema": { "type": "string" } } ], "description": "Authorization and validation are enforced by the owning service.", "x-handler": "archive_case_party_link", "x-source-file": "crates/synckhub-server/src/routes/directory/party_links.rs", "x-source-line": 7, "responses": { "default": { "description": "Platform error; branch on HTTP status and stable code, not the human-readable message.", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } } }, "2XX": { "description": "Successful JSON response", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/synckhub_server.routes.directory.party_links.CasePartyLinkSummary" } } } } } } }, "/repos/{repo_id}/case-party-links/bulk": { "post": { "operationId": "platform_post__repos__repo_id__case_party_links_bulk", "summary": "bulk case party links", "tags": [ "directory · party_links" ], "parameters": [ { "name": "repo_id", "in": "path", "required": true, "schema": { "type": "string" } } ], "description": "Authorization and validation are enforced by the owning service.", "x-handler": "bulk_case_party_links", "x-source-file": "crates/synckhub-server/src/routes/directory/party_links.rs", "x-source-line": 7, "responses": { "default": { "description": "Platform error; branch on HTTP status and stable code, not the human-readable message.", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } } }, "2XX": { "description": "Successful JSON response", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/synckhub_server.routes.directory.party_links.BulkCasePartyLinksResponse" } } } } }, "requestBody": { "required": true, "content": { "application/json": { "schema": { "$ref": "#/components/schemas/synckhub_server.routes.directory.party_links.BulkCasePartyLinksRequest" } } } } } }, "/repos/{repo_id}/case-view-defaults/me": { "delete": { "operationId": "platform_delete__repos__repo_id__case_view_defaults_me", "summary": "clear my case view default", "tags": [ "cases · mod" ], "parameters": [ { "name": "repo_id", "in": "path", "required": true, "schema": { "type": "string" } } ], "description": "Authorization and validation are enforced by the owning service.", "x-handler": "clear_my_case_view_default", "x-source-file": "crates/synckhub-server/src/routes/cases/mod.rs", "x-source-line": 17, "responses": { "default": { "description": "Platform error; branch on HTTP status and stable code, not the human-readable message.", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } } } } }, "put": { "operationId": "platform_put__repos__repo_id__case_view_defaults_me", "summary": "set my case view default", "tags": [ "cases · mod" ], "parameters": [ { "name": "repo_id", "in": "path", "required": true, "schema": { "type": "string" } } ], "description": "Authorization and validation are enforced by the owning service.", "x-handler": "set_my_case_view_default", "x-source-file": "crates/synckhub-server/src/routes/cases/mod.rs", "x-source-line": 17, "responses": { "default": { "description": "Platform error; branch on HTTP status and stable code, not the human-readable message.", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } } }, "2XX": { "description": "Successful JSON response", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/synckhub_server.routes.cases.views.CaseViewsResponse" } } } } }, "requestBody": { "required": true, "content": { "application/json": { "schema": { "$ref": "#/components/schemas/synckhub_server.routes.cases.views.SetCaseViewDefaultRequest" } } } } } }, "/repos/{repo_id}/case-view-defaults/repository": { "delete": { "operationId": "platform_delete__repos__repo_id__case_view_defaults_repository", "summary": "clear repository case view default", "tags": [ "cases · mod" ], "parameters": [ { "name": "repo_id", "in": "path", "required": true, "schema": { "type": "string" } } ], "description": "Authorization and validation are enforced by the owning service.", "x-handler": "clear_repository_case_view_default", "x-source-file": "crates/synckhub-server/src/routes/cases/mod.rs", "x-source-line": 17, "responses": { "default": { "description": "Platform error; branch on HTTP status and stable code, not the human-readable message.", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } } } } }, "put": { "operationId": "platform_put__repos__repo_id__case_view_defaults_repository", "summary": "set repository case view default", "tags": [ "cases · mod" ], "parameters": [ { "name": "repo_id", "in": "path", "required": true, "schema": { "type": "string" } } ], "description": "Authorization and validation are enforced by the owning service.", "x-handler": "set_repository_case_view_default", "x-source-file": "crates/synckhub-server/src/routes/cases/mod.rs", "x-source-line": 17, "responses": { "default": { "description": "Platform error; branch on HTTP status and stable code, not the human-readable message.", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } } }, "2XX": { "description": "Successful JSON response", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/synckhub_server.routes.cases.views.CaseViewsResponse" } } } } }, "requestBody": { "required": true, "content": { "application/json": { "schema": { "$ref": "#/components/schemas/synckhub_server.routes.cases.views.SetCaseViewDefaultRequest" } } } } } }, "/repos/{repo_id}/case-views": { "post": { "operationId": "platform_post__repos__repo_id__case_views", "summary": "create case view", "tags": [ "cases · mod" ], "parameters": [ { "name": "repo_id", "in": "path", "required": true, "schema": { "type": "string" } } ], "description": "Authorization and validation are enforced by the owning service.", "x-handler": "create_case_view", "x-source-file": "crates/synckhub-server/src/routes/cases/mod.rs", "x-source-line": 17, "responses": { "default": { "description": "Platform error; branch on HTTP status and stable code, not the human-readable message.", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } } }, "2XX": { "description": "Successful JSON response", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/synckhub_server.routes.cases.views.CaseViewEntry" } } } } }, "requestBody": { "required": true, "content": { "application/json": { "schema": { "$ref": "#/components/schemas/synckhub_server.routes.cases.views.CreateCaseViewRequest" } } } } }, "get": { "operationId": "platform_get__repos__repo_id__case_views", "summary": "list case views", "tags": [ "cases · mod" ], "parameters": [ { "name": "repo_id", "in": "path", "required": true, "schema": { "type": "string" } } ], "description": "Authorization and validation are enforced by the owning service.", "x-handler": "list_case_views", "x-source-file": "crates/synckhub-server/src/routes/cases/mod.rs", "x-source-line": 17, "responses": { "default": { "description": "Platform error; branch on HTTP status and stable code, not the human-readable message.", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } } }, "2XX": { "description": "Successful JSON response", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/synckhub_server.routes.cases.views.CaseViewsResponse" } } } } } }, "head": { "operationId": "platform_head__repos__repo_id__case_views", "summary": "list case views", "tags": [ "cases · mod" ], "parameters": [ { "name": "repo_id", "in": "path", "required": true, "schema": { "type": "string" } } ], "description": "Authorization and validation are enforced by the owning service.\n\nHEAD uses the GET handler and headers without a response body.", "x-handler": "list_case_views", "x-source-file": "crates/synckhub-server/src/routes/cases/mod.rs", "x-source-line": 17, "x-implicit-head": true, "responses": { "default": { "description": "Platform error; branch on HTTP status and stable code, not the human-readable message." } } } }, "/repos/{repo_id}/case-views/{view_id}": { "delete": { "operationId": "platform_delete__repos__repo_id__case_views__view_id_", "summary": "delete case view", "tags": [ "cases · mod" ], "parameters": [ { "name": "repo_id", "in": "path", "required": true, "schema": { "type": "string" } }, { "name": "view_id", "in": "path", "required": true, "schema": { "type": "string" } } ], "description": "Authorization and validation are enforced by the owning service.", "x-handler": "delete_case_view", "x-source-file": "crates/synckhub-server/src/routes/cases/mod.rs", "x-source-line": 17, "responses": { "default": { "description": "Platform error; branch on HTTP status and stable code, not the human-readable message.", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } } } }, "requestBody": { "required": true, "content": { "application/json": { "schema": { "$ref": "#/components/schemas/synckhub_server.routes.cases.views.DeleteCaseViewRequest" } } } } }, "patch": { "operationId": "platform_patch__repos__repo_id__case_views__view_id_", "summary": "update case view", "tags": [ "cases · mod" ], "parameters": [ { "name": "repo_id", "in": "path", "required": true, "schema": { "type": "string" } }, { "name": "view_id", "in": "path", "required": true, "schema": { "type": "string" } } ], "description": "Authorization and validation are enforced by the owning service.", "x-handler": "update_case_view", "x-source-file": "crates/synckhub-server/src/routes/cases/mod.rs", "x-source-line": 17, "responses": { "default": { "description": "Platform error; branch on HTTP status and stable code, not the human-readable message.", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } } }, "2XX": { "description": "Successful JSON response", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/synckhub_server.routes.cases.views.CaseViewEntry" } } } } }, "requestBody": { "required": true, "content": { "application/json": { "schema": { "$ref": "#/components/schemas/synckhub_server.routes.cases.views.UpdateCaseViewRequest" } } } } }, "get": { "operationId": "platform_get__repos__repo_id__case_views__view_id_", "summary": "get case view", "tags": [ "cases · mod" ], "parameters": [ { "name": "repo_id", "in": "path", "required": true, "schema": { "type": "string" } }, { "name": "view_id", "in": "path", "required": true, "schema": { "type": "string" } } ], "description": "Authorization and validation are enforced by the owning service.", "x-handler": "get_case_view", "x-source-file": "crates/synckhub-server/src/routes/cases/mod.rs", "x-source-line": 17, "responses": { "default": { "description": "Platform error; branch on HTTP status and stable code, not the human-readable message.", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } } }, "2XX": { "description": "Successful JSON response", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/synckhub_server.routes.cases.views.CaseViewEntry" } } } } } }, "head": { "operationId": "platform_head__repos__repo_id__case_views__view_id_", "summary": "get case view", "tags": [ "cases · mod" ], "parameters": [ { "name": "repo_id", "in": "path", "required": true, "schema": { "type": "string" } }, { "name": "view_id", "in": "path", "required": true, "schema": { "type": "string" } } ], "description": "Authorization and validation are enforced by the owning service.\n\nHEAD uses the GET handler and headers without a response body.", "x-handler": "get_case_view", "x-source-file": "crates/synckhub-server/src/routes/cases/mod.rs", "x-source-line": 17, "x-implicit-head": true, "responses": { "default": { "description": "Platform error; branch on HTTP status and stable code, not the human-readable message." } } } }, "/repos/{repo_id}/case-views/reorder": { "put": { "operationId": "platform_put__repos__repo_id__case_views_reorder", "summary": "reorder case views", "tags": [ "cases · mod" ], "parameters": [ { "name": "repo_id", "in": "path", "required": true, "schema": { "type": "string" } } ], "description": "Authorization and validation are enforced by the owning service.", "x-handler": "reorder_case_views", "x-source-file": "crates/synckhub-server/src/routes/cases/mod.rs", "x-source-line": 17, "responses": { "default": { "description": "Platform error; branch on HTTP status and stable code, not the human-readable message.", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } } }, "2XX": { "description": "Successful JSON response", "content": { "application/json": { "schema": { "type": "array", "items": { "$ref": "#/components/schemas/synckhub_server.routes.cases.views.CaseViewEntry" } } } } } }, "requestBody": { "required": true, "content": { "application/json": { "schema": { "$ref": "#/components/schemas/synckhub_server.routes.cases.views.ReorderCaseViewsRequest" } } } } } }, "/repos/{repo_id}/cases": { "post": { "operationId": "platform_post__repos__repo_id__cases", "summary": "create case", "tags": [ "cases · mod" ], "parameters": [ { "name": "repo_id", "in": "path", "required": true, "schema": { "type": "string" } } ], "description": "Authorization and validation are enforced by the owning service.", "x-handler": "create_case", "x-source-file": "crates/synckhub-server/src/routes/cases/mod.rs", "x-source-line": 17, "responses": { "default": { "description": "Platform error; branch on HTTP status and stable code, not the human-readable message.", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } } }, "2XX": { "description": "Successful JSON response", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/synckhub_core.types.ItemSummary" } } } } }, "requestBody": { "required": true, "content": { "application/json": { "schema": { "$ref": "#/components/schemas/synckhub_server.routes.cases.lifecycle.CreateCaseRequest" } } } } }, "get": { "operationId": "platform_get__repos__repo_id__cases", "summary": "list cases", "tags": [ "cases · mod" ], "parameters": [ { "name": "repo_id", "in": "path", "required": true, "schema": { "type": "string" } }, { "name": "stage_key", "in": "query", "required": false, "schema": { "anyOf": [ { "type": "string" }, { "type": "null" } ] } }, { "name": "status", "in": "query", "required": false, "schema": { "anyOf": [ { "type": "string" }, { "type": "null" } ] } }, { "name": "q", "in": "query", "required": false, "schema": { "anyOf": [ { "type": "string" }, { "type": "null" } ] } }, { "name": "filters", "in": "query", "required": false, "schema": { "anyOf": [ { "type": "string" }, { "type": "null" } ] } }, { "name": "filter_clauses", "in": "query", "required": false, "schema": { "anyOf": [ { "type": "array", "items": { "$ref": "#/components/schemas/synckhub_server.routes.cases.views.CaseFilterClause" } }, { "type": "null" } ] } }, { "name": "order_by", "in": "query", "required": false, "schema": { "anyOf": [ { "$ref": "#/components/schemas/synckhub_server.list_name_search_sql.CaseListOrderBy" }, { "type": "null" } ] } }, { "name": "order_dir", "in": "query", "required": false, "schema": { "anyOf": [ { "$ref": "#/components/schemas/synckhub_server.list_name_search_sql.CaseListOrderDir" }, { "type": "null" } ] } }, { "name": "limit", "in": "query", "required": false, "schema": { "anyOf": [ { "type": "integer" }, { "type": "null" } ] } }, { "name": "cursor", "in": "query", "required": false, "schema": { "anyOf": [ { "type": "string" }, { "type": "null" } ] } }, { "name": "metadata_fields", "in": "query", "required": false, "schema": { "anyOf": [ { "type": "array", "items": { "type": "string" } }, { "type": "null" } ] } } ], "description": "Authorization and validation are enforced by the owning service.", "x-handler": "list_cases", "x-source-file": "crates/synckhub-server/src/routes/cases/mod.rs", "x-source-line": 17, "responses": { "default": { "description": "Platform error; branch on HTTP status and stable code, not the human-readable message.", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } } }, "2XX": { "description": "Successful JSON response", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/synckhub_server.routes.cases.lifecycle.CaseListResponse" } } } } } }, "head": { "operationId": "platform_head__repos__repo_id__cases", "summary": "list cases", "tags": [ "cases · mod" ], "parameters": [ { "name": "repo_id", "in": "path", "required": true, "schema": { "type": "string" } }, { "name": "stage_key", "in": "query", "required": false, "schema": { "anyOf": [ { "type": "string" }, { "type": "null" } ] } }, { "name": "status", "in": "query", "required": false, "schema": { "anyOf": [ { "type": "string" }, { "type": "null" } ] } }, { "name": "q", "in": "query", "required": false, "schema": { "anyOf": [ { "type": "string" }, { "type": "null" } ] } }, { "name": "filters", "in": "query", "required": false, "schema": { "anyOf": [ { "type": "string" }, { "type": "null" } ] } }, { "name": "filter_clauses", "in": "query", "required": false, "schema": { "anyOf": [ { "type": "array", "items": { "$ref": "#/components/schemas/synckhub_server.routes.cases.views.CaseFilterClause" } }, { "type": "null" } ] } }, { "name": "order_by", "in": "query", "required": false, "schema": { "anyOf": [ { "$ref": "#/components/schemas/synckhub_server.list_name_search_sql.CaseListOrderBy" }, { "type": "null" } ] } }, { "name": "order_dir", "in": "query", "required": false, "schema": { "anyOf": [ { "$ref": "#/components/schemas/synckhub_server.list_name_search_sql.CaseListOrderDir" }, { "type": "null" } ] } }, { "name": "limit", "in": "query", "required": false, "schema": { "anyOf": [ { "type": "integer" }, { "type": "null" } ] } }, { "name": "cursor", "in": "query", "required": false, "schema": { "anyOf": [ { "type": "string" }, { "type": "null" } ] } }, { "name": "metadata_fields", "in": "query", "required": false, "schema": { "anyOf": [ { "type": "array", "items": { "type": "string" } }, { "type": "null" } ] } } ], "description": "Authorization and validation are enforced by the owning service.\n\nHEAD uses the GET handler and headers without a response body.", "x-handler": "list_cases", "x-source-file": "crates/synckhub-server/src/routes/cases/mod.rs", "x-source-line": 17, "x-implicit-head": true, "responses": { "default": { "description": "Platform error; branch on HTTP status and stable code, not the human-readable message." } } } }, "/repos/{repo_id}/cases/{item_id}/convert-to-folder": { "post": { "operationId": "platform_post__repos__repo_id__cases__item_id__convert_to_folder", "summary": "convert case to folder", "tags": [ "cases · mod" ], "parameters": [ { "name": "repo_id", "in": "path", "required": true, "schema": { "type": "string" } }, { "name": "item_id", "in": "path", "required": true, "schema": { "type": "string" } } ], "description": "Authorization and validation are enforced by the owning service.", "x-handler": "convert_case_to_folder", "x-source-file": "crates/synckhub-server/src/routes/cases/mod.rs", "x-source-line": 17, "responses": { "default": { "description": "Platform error; branch on HTTP status and stable code, not the human-readable message.", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } } }, "2XX": { "description": "Successful JSON response", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/synckhub_core.types.ItemSummary" } } } } } } }, "/repos/{repo_id}/cases/bulk/adopt-folder": { "post": { "operationId": "platform_post__repos__repo_id__cases_bulk_adopt_folder", "summary": "bulk adopt case folders", "tags": [ "cases · mod" ], "parameters": [ { "name": "repo_id", "in": "path", "required": true, "schema": { "type": "string" } } ], "description": "Authorization and validation are enforced by the owning service.", "x-handler": "bulk_adopt_case_folders", "x-source-file": "crates/synckhub-server/src/routes/cases/mod.rs", "x-source-line": 17, "responses": { "default": { "description": "Platform error; branch on HTTP status and stable code, not the human-readable message.", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } } }, "2XX": { "description": "Successful JSON response", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/synckhub_server.routes.cases.lifecycle.CaseAdoptBulkResponse" } } } } }, "requestBody": { "required": true, "content": { "application/json": { "schema": { "$ref": "#/components/schemas/synckhub_server.routes.cases.lifecycle.BulkAdoptCaseFoldersRequest" } } } } } }, "/repos/{repo_id}/cases/bulk/create": { "post": { "operationId": "platform_post__repos__repo_id__cases_bulk_create", "summary": "bulk create cases", "tags": [ "cases · mod" ], "parameters": [ { "name": "repo_id", "in": "path", "required": true, "schema": { "type": "string" } } ], "description": "Authorization and validation are enforced by the owning service.", "x-handler": "bulk_create_cases", "x-source-file": "crates/synckhub-server/src/routes/cases/mod.rs", "x-source-line": 17, "responses": { "default": { "description": "Platform error; branch on HTTP status and stable code, not the human-readable message.", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } } }, "2XX": { "description": "Successful JSON response", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/synckhub_server.routes.cases.lifecycle.CaseCreateBulkResponse" } } } } }, "requestBody": { "required": true, "content": { "application/json": { "schema": { "$ref": "#/components/schemas/synckhub_server.routes.cases.lifecycle.BulkCreateCasesRequest" } } } } } }, "/repos/{repo_id}/cases/bulk/inspect-canonical-state": { "post": { "operationId": "platform_post__repos__repo_id__cases_bulk_inspect_canonical_state", "summary": "inspect canonical cases", "tags": [ "cases · mod" ], "parameters": [ { "name": "repo_id", "in": "path", "required": true, "schema": { "type": "string" } } ], "description": "Authorization and validation are enforced by the owning service.", "x-handler": "inspect_canonical_cases", "x-source-file": "crates/synckhub-server/src/routes/cases/mod.rs", "x-source-line": 17, "responses": { "default": { "description": "Platform error; branch on HTTP status and stable code, not the human-readable message.", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } } }, "2XX": { "description": "Successful JSON response", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/synckhub_server.routes.cases.lifecycle.InspectCanonicalCasesResponse" } } } } }, "requestBody": { "required": true, "content": { "application/json": { "schema": { "$ref": "#/components/schemas/synckhub_server.routes.cases.lifecycle.InspectCanonicalCasesRequest" } } } } } }, "/repos/{repo_id}/cases/bulk/set-lifecycle-mode": { "post": { "operationId": "platform_post__repos__repo_id__cases_bulk_set_lifecycle_mode", "summary": "set cases lifecycle mode", "tags": [ "cases · mod" ], "parameters": [ { "name": "repo_id", "in": "path", "required": true, "schema": { "type": "string" } } ], "description": "Authorization and validation are enforced by the owning service.", "x-handler": "set_cases_lifecycle_mode", "x-source-file": "crates/synckhub-server/src/routes/cases/mod.rs", "x-source-line": 17, "responses": { "default": { "description": "Platform error; branch on HTTP status and stable code, not the human-readable message.", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } } }, "2XX": { "description": "Successful JSON response", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/synckhub_server.routes.cases.lifecycle.CaseLifecycleBatchMutationResponse" } } } } }, "requestBody": { "required": true, "content": { "application/json": { "schema": { "$ref": "#/components/schemas/synckhub_server.routes.cases.lifecycle.SetCasesLifecycleModeRequest" } } } } } }, "/repos/{repo_id}/cases/bulk/set-status": { "post": { "operationId": "platform_post__repos__repo_id__cases_bulk_set_status", "summary": "set cases status", "tags": [ "cases · mod" ], "parameters": [ { "name": "repo_id", "in": "path", "required": true, "schema": { "type": "string" } } ], "description": "Authorization and validation are enforced by the owning service.", "x-handler": "set_cases_status", "x-source-file": "crates/synckhub-server/src/routes/cases/mod.rs", "x-source-line": 17, "responses": { "default": { "description": "Platform error; branch on HTTP status and stable code, not the human-readable message.", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } } }, "2XX": { "description": "Successful JSON response", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/synckhub_server.routes.cases.lifecycle.CaseLifecycleBatchMutationResponse" } } } } }, "requestBody": { "required": true, "content": { "application/json": { "schema": { "$ref": "#/components/schemas/synckhub_server.routes.cases.lifecycle.SetCasesStatusRequest" } } } } } }, "/repos/{repo_id}/cases/bulk/transition": { "post": { "operationId": "platform_post__repos__repo_id__cases_bulk_transition", "summary": "bulk transition cases", "tags": [ "cases · mod" ], "parameters": [ { "name": "repo_id", "in": "path", "required": true, "schema": { "type": "string" } } ], "description": "Authorization and validation are enforced by the owning service.", "x-handler": "bulk_transition_cases", "x-source-file": "crates/synckhub-server/src/routes/cases/mod.rs", "x-source-line": 17, "responses": { "default": { "description": "Platform error; branch on HTTP status and stable code, not the human-readable message.", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } } }, "2XX": { "description": "Successful JSON response", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/synckhub_server.routes.cases.lifecycle.CaseBulkResultResponse" } } } } }, "requestBody": { "required": true, "content": { "application/json": { "schema": { "$ref": "#/components/schemas/synckhub_server.routes.cases.lifecycle.BulkTransitionCasesRequest" } } } } } }, "/repos/{repo_id}/cases/list": { "post": { "operationId": "platform_post__repos__repo_id__cases_list", "summary": "list cases structured", "tags": [ "cases · mod" ], "parameters": [ { "name": "repo_id", "in": "path", "required": true, "schema": { "type": "string" } } ], "description": "Authorization and validation are enforced by the owning service.", "x-handler": "list_cases_structured", "x-source-file": "crates/synckhub-server/src/routes/cases/mod.rs", "x-source-line": 17, "responses": { "default": { "description": "Platform error; branch on HTTP status and stable code, not the human-readable message.", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } } }, "2XX": { "description": "Successful JSON response", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/synckhub_server.routes.cases.lifecycle.CaseListResponse" } } } } }, "requestBody": { "required": true, "content": { "application/json": { "schema": { "$ref": "#/components/schemas/synckhub_server.routes.cases.views.ListCasesQuery" } } } } } }, "/repos/{repo_id}/cases/recents": { "get": { "operationId": "platform_get__repos__repo_id__cases_recents", "summary": "list recent cases", "tags": [ "cases · recents" ], "parameters": [ { "name": "repo_id", "in": "path", "required": true, "schema": { "type": "string" } }, { "name": "metadata_fields", "in": "query", "required": false, "schema": { "anyOf": [ { "type": "string" }, { "type": "null" } ] } } ], "description": "Authorization and validation are enforced by the owning service.", "x-handler": "list_recent_cases", "x-source-file": "crates/synckhub-server/src/routes/cases/recents.rs", "x-source-line": 21, "responses": { "default": { "description": "Platform error; branch on HTTP status and stable code, not the human-readable message.", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } } }, "2XX": { "description": "Successful JSON response", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/synckhub_server.routes.cases.recents.RecentCasesResponse" } } } } } }, "head": { "operationId": "platform_head__repos__repo_id__cases_recents", "summary": "list recent cases", "tags": [ "cases · recents" ], "parameters": [ { "name": "repo_id", "in": "path", "required": true, "schema": { "type": "string" } }, { "name": "metadata_fields", "in": "query", "required": false, "schema": { "anyOf": [ { "type": "string" }, { "type": "null" } ] } } ], "description": "Authorization and validation are enforced by the owning service.\n\nHEAD uses the GET handler and headers without a response body.", "x-handler": "list_recent_cases", "x-source-file": "crates/synckhub-server/src/routes/cases/recents.rs", "x-source-line": 21, "x-implicit-head": true, "responses": { "default": { "description": "Platform error; branch on HTTP status and stable code, not the human-readable message." } } } }, "/repos/{repo_id}/chats": { "post": { "operationId": "platform_post__repos__repo_id__chats", "summary": "create chat", "tags": [ "chat · rooms" ], "parameters": [ { "name": "repo_id", "in": "path", "required": true, "schema": { "type": "string" } } ], "description": "Authorization and validation are enforced by the owning service.", "x-handler": "create_chat", "x-source-file": "crates/synckhub-server/src/routes/chat/rooms.rs", "x-source-line": 11, "responses": { "default": { "description": "Platform error; branch on HTTP status and stable code, not the human-readable message.", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } } }, "2XX": { "description": "Successful JSON response", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/synckhub_server.routes.chat.rooms.ChatListEntry" } } } } }, "requestBody": { "required": true, "content": { "application/json": { "schema": { "$ref": "#/components/schemas/synckhub_server.routes.chat.rooms.CreateChatRequest" } } } } }, "get": { "operationId": "platform_get__repos__repo_id__chats", "summary": "list chats", "tags": [ "chat · rooms" ], "parameters": [ { "name": "repo_id", "in": "path", "required": true, "schema": { "type": "string" } } ], "description": "Authorization and validation are enforced by the owning service.", "x-handler": "list_chats", "x-source-file": "crates/synckhub-server/src/routes/chat/rooms.rs", "x-source-line": 11, "responses": { "default": { "description": "Platform error; branch on HTTP status and stable code, not the human-readable message.", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } } }, "2XX": { "description": "Successful JSON response", "content": { "application/json": { "schema": { "type": "array", "items": { "$ref": "#/components/schemas/synckhub_server.routes.chat.rooms.ChatListEntry" } } } } } } }, "head": { "operationId": "platform_head__repos__repo_id__chats", "summary": "list chats", "tags": [ "chat · rooms" ], "parameters": [ { "name": "repo_id", "in": "path", "required": true, "schema": { "type": "string" } } ], "description": "Authorization and validation are enforced by the owning service.\n\nHEAD uses the GET handler and headers without a response body.", "x-handler": "list_chats", "x-source-file": "crates/synckhub-server/src/routes/chat/rooms.rs", "x-source-line": 11, "x-implicit-head": true, "responses": { "default": { "description": "Platform error; branch on HTTP status and stable code, not the human-readable message." } } } }, "/repos/{repo_id}/chats/identity-invites": { "post": { "operationId": "platform_post__repos__repo_id__chats_identity_invites", "summary": "create chat identity invite", "tags": [ "chat · rooms" ], "parameters": [ { "name": "repo_id", "in": "path", "required": true, "schema": { "type": "string" } } ], "description": "Authorization and validation are enforced by the owning service.", "x-handler": "create_chat_identity_invite", "x-source-file": "crates/synckhub-server/src/routes/chat/rooms.rs", "x-source-line": 11, "responses": { "default": { "description": "Platform error; branch on HTTP status and stable code, not the human-readable message.", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } } }, "2XX": { "description": "Successful JSON response", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/synckhub_server.routes.chat.rooms.CreateChatIdentityInviteResponse" } } } } }, "requestBody": { "required": true, "content": { "application/json": { "schema": { "$ref": "#/components/schemas/synckhub_server.routes.chat.rooms.CreateChatIdentityInviteRequest" } } } } } }, "/repos/{repo_id}/chats/unread-summary": { "get": { "operationId": "platform_get__repos__repo_id__chats_unread_summary", "summary": "chat unread summary", "tags": [ "chat · rooms" ], "parameters": [ { "name": "repo_id", "in": "path", "required": true, "schema": { "type": "string" } } ], "description": "Authorization and validation are enforced by the owning service.", "x-handler": "chat_unread_summary", "x-source-file": "crates/synckhub-server/src/routes/chat/rooms.rs", "x-source-line": 11, "responses": { "default": { "description": "Platform error; branch on HTTP status and stable code, not the human-readable message.", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } } }, "2XX": { "description": "Successful JSON response", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/synckhub_server.routes.chat.rooms.ChatUnreadSummary" } } } } } }, "head": { "operationId": "platform_head__repos__repo_id__chats_unread_summary", "summary": "chat unread summary", "tags": [ "chat · rooms" ], "parameters": [ { "name": "repo_id", "in": "path", "required": true, "schema": { "type": "string" } } ], "description": "Authorization and validation are enforced by the owning service.\n\nHEAD uses the GET handler and headers without a response body.", "x-handler": "chat_unread_summary", "x-source-file": "crates/synckhub-server/src/routes/chat/rooms.rs", "x-source-line": 11, "x-implicit-head": true, "responses": { "default": { "description": "Platform error; branch on HTTP status and stable code, not the human-readable message." } } } }, "/repos/{repo_id}/commits": { "get": { "operationId": "platform_get__repos__repo_id__commits", "summary": "list repo commits", "tags": [ "items · read" ], "parameters": [ { "name": "repo_id", "in": "path", "required": true, "schema": { "type": "string" } }, { "name": "folder_id", "in": "query", "required": false, "schema": { "anyOf": [ { "type": "string" }, { "type": "null" } ], "description": "Root folder item id. Use `\"\"` (empty) or omit for the root folder." } }, { "name": "include_root", "in": "query", "required": false, "schema": { "anyOf": [ { "type": "boolean" }, { "type": "null" } ] } }, { "name": "limit", "in": "query", "required": false, "schema": { "anyOf": [ { "type": "integer", "minimum": 0 }, { "type": "null" } ] } }, { "name": "before_repo_seq", "in": "query", "required": false, "schema": { "anyOf": [ { "type": "integer" }, { "type": "null" } ] } }, { "name": "event_preview_limit", "in": "query", "required": false, "schema": { "anyOf": [ { "type": "integer", "minimum": 0 }, { "type": "null" } ], "description": "Optional per-commit embedded event preview limit. Omit to retain the\ncomplete embedded-event response used by existing clients." } }, { "name": "include_event_payload", "in": "query", "required": false, "schema": { "anyOf": [ { "type": "boolean" }, { "type": "null" } ], "description": "Whether embedded preview events include their canonical payload JSON.\nDefaults to true for compatibility; activity feeds should pass false." } } ], "description": "Authorization and validation are enforced by the owning service.", "x-handler": "list_repo_commits", "x-source-file": "crates/synckhub-server/src/routes/items/read.rs", "x-source-line": 27, "responses": { "default": { "description": "Platform error; branch on HTTP status and stable code, not the human-readable message.", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } } }, "2XX": { "description": "Successful JSON response", "content": { "application/json": { "schema": { "type": "array", "items": { "$ref": "#/components/schemas/synckhub_core.types.RepoCommitEntry" } } } } } } }, "head": { "operationId": "platform_head__repos__repo_id__commits", "summary": "list repo commits", "tags": [ "items · read" ], "parameters": [ { "name": "repo_id", "in": "path", "required": true, "schema": { "type": "string" } }, { "name": "folder_id", "in": "query", "required": false, "schema": { "anyOf": [ { "type": "string" }, { "type": "null" } ], "description": "Root folder item id. Use `\"\"` (empty) or omit for the root folder." } }, { "name": "include_root", "in": "query", "required": false, "schema": { "anyOf": [ { "type": "boolean" }, { "type": "null" } ] } }, { "name": "limit", "in": "query", "required": false, "schema": { "anyOf": [ { "type": "integer", "minimum": 0 }, { "type": "null" } ] } }, { "name": "before_repo_seq", "in": "query", "required": false, "schema": { "anyOf": [ { "type": "integer" }, { "type": "null" } ] } }, { "name": "event_preview_limit", "in": "query", "required": false, "schema": { "anyOf": [ { "type": "integer", "minimum": 0 }, { "type": "null" } ], "description": "Optional per-commit embedded event preview limit. Omit to retain the\ncomplete embedded-event response used by existing clients." } }, { "name": "include_event_payload", "in": "query", "required": false, "schema": { "anyOf": [ { "type": "boolean" }, { "type": "null" } ], "description": "Whether embedded preview events include their canonical payload JSON.\nDefaults to true for compatibility; activity feeds should pass false." } } ], "description": "Authorization and validation are enforced by the owning service.\n\nHEAD uses the GET handler and headers without a response body.", "x-handler": "list_repo_commits", "x-source-file": "crates/synckhub-server/src/routes/items/read.rs", "x-source-line": 27, "x-implicit-head": true, "responses": { "default": { "description": "Platform error; branch on HTTP status and stable code, not the human-readable message." } } } }, "/repos/{repo_id}/commits/{commit_id}/changes": { "get": { "operationId": "platform_get__repos__repo_id__commits__commit_id__changes", "summary": "list repo commit changes", "tags": [ "items · read" ], "parameters": [ { "name": "repo_id", "in": "path", "required": true, "schema": { "type": "string" } }, { "name": "commit_id", "in": "path", "required": true, "schema": { "type": "string" } }, { "name": "folder_id", "in": "query", "required": false, "schema": { "anyOf": [ { "type": "string" }, { "type": "null" } ] } }, { "name": "include_root", "in": "query", "required": false, "schema": { "anyOf": [ { "type": "boolean" }, { "type": "null" } ] } }, { "name": "limit", "in": "query", "required": false, "schema": { "anyOf": [ { "type": "integer", "minimum": 0 }, { "type": "null" } ] } }, { "name": "after_change_event_idx", "in": "query", "required": false, "schema": { "anyOf": [ { "type": "integer" }, { "type": "null" } ] } } ], "description": "Authorization and validation are enforced by the owning service.", "x-handler": "list_repo_commit_changes", "x-source-file": "crates/synckhub-server/src/routes/items/read.rs", "x-source-line": 27, "responses": { "default": { "description": "Platform error; branch on HTTP status and stable code, not the human-readable message.", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } } }, "2XX": { "description": "Successful JSON response", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/synckhub_core.types.RepoCommitChangesPage" } } } } } }, "head": { "operationId": "platform_head__repos__repo_id__commits__commit_id__changes", "summary": "list repo commit changes", "tags": [ "items · read" ], "parameters": [ { "name": "repo_id", "in": "path", "required": true, "schema": { "type": "string" } }, { "name": "commit_id", "in": "path", "required": true, "schema": { "type": "string" } }, { "name": "folder_id", "in": "query", "required": false, "schema": { "anyOf": [ { "type": "string" }, { "type": "null" } ] } }, { "name": "include_root", "in": "query", "required": false, "schema": { "anyOf": [ { "type": "boolean" }, { "type": "null" } ] } }, { "name": "limit", "in": "query", "required": false, "schema": { "anyOf": [ { "type": "integer", "minimum": 0 }, { "type": "null" } ] } }, { "name": "after_change_event_idx", "in": "query", "required": false, "schema": { "anyOf": [ { "type": "integer" }, { "type": "null" } ] } } ], "description": "Authorization and validation are enforced by the owning service.\n\nHEAD uses the GET handler and headers without a response body.", "x-handler": "list_repo_commit_changes", "x-source-file": "crates/synckhub-server/src/routes/items/read.rs", "x-source-line": 27, "x-implicit-head": true, "responses": { "default": { "description": "Platform error; branch on HTTP status and stable code, not the human-readable message." } } } }, "/repos/{repo_id}/commits/{commit_id}/events": { "get": { "operationId": "platform_get__repos__repo_id__commits__commit_id__events", "summary": "list repo commit events", "tags": [ "items · read" ], "parameters": [ { "name": "repo_id", "in": "path", "required": true, "schema": { "type": "string" } }, { "name": "commit_id", "in": "path", "required": true, "schema": { "type": "string" } }, { "name": "folder_id", "in": "query", "required": false, "schema": { "anyOf": [ { "type": "string" }, { "type": "null" } ], "description": "Root folder item id. Use `\"\"` (empty) or omit for the root folder." } }, { "name": "include_root", "in": "query", "required": false, "schema": { "anyOf": [ { "type": "boolean" }, { "type": "null" } ] } }, { "name": "limit", "in": "query", "required": false, "schema": { "anyOf": [ { "type": "integer", "minimum": 0 }, { "type": "null" } ] } }, { "name": "after_commit_event_idx", "in": "query", "required": false, "schema": { "anyOf": [ { "type": "integer" }, { "type": "null" } ] } }, { "name": "include_payload", "in": "query", "required": false, "schema": { "anyOf": [ { "type": "boolean" }, { "type": "null" } ], "description": "Whether returned events include canonical payload JSON." } } ], "description": "Authorization and validation are enforced by the owning service.", "x-handler": "list_repo_commit_events", "x-source-file": "crates/synckhub-server/src/routes/items/read.rs", "x-source-line": 27, "responses": { "default": { "description": "Platform error; branch on HTTP status and stable code, not the human-readable message.", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } } }, "2XX": { "description": "Successful JSON response", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/synckhub_core.types.RepoCommitEventsPage" } } } } } }, "head": { "operationId": "platform_head__repos__repo_id__commits__commit_id__events", "summary": "list repo commit events", "tags": [ "items · read" ], "parameters": [ { "name": "repo_id", "in": "path", "required": true, "schema": { "type": "string" } }, { "name": "commit_id", "in": "path", "required": true, "schema": { "type": "string" } }, { "name": "folder_id", "in": "query", "required": false, "schema": { "anyOf": [ { "type": "string" }, { "type": "null" } ], "description": "Root folder item id. Use `\"\"` (empty) or omit for the root folder." } }, { "name": "include_root", "in": "query", "required": false, "schema": { "anyOf": [ { "type": "boolean" }, { "type": "null" } ] } }, { "name": "limit", "in": "query", "required": false, "schema": { "anyOf": [ { "type": "integer", "minimum": 0 }, { "type": "null" } ] } }, { "name": "after_commit_event_idx", "in": "query", "required": false, "schema": { "anyOf": [ { "type": "integer" }, { "type": "null" } ] } }, { "name": "include_payload", "in": "query", "required": false, "schema": { "anyOf": [ { "type": "boolean" }, { "type": "null" } ], "description": "Whether returned events include canonical payload JSON." } } ], "description": "Authorization and validation are enforced by the owning service.\n\nHEAD uses the GET handler and headers without a response body.", "x-handler": "list_repo_commit_events", "x-source-file": "crates/synckhub-server/src/routes/items/read.rs", "x-source-line": 27, "x-implicit-head": true, "responses": { "default": { "description": "Platform error; branch on HTTP status and stable code, not the human-readable message." } } } }, "/repos/{repo_id}/companies": { "post": { "operationId": "platform_post__repos__repo_id__companies", "summary": "create company", "tags": [ "directory · companies" ], "parameters": [ { "name": "repo_id", "in": "path", "required": true, "schema": { "type": "string" } } ], "description": "Authorization and validation are enforced by the owning service.", "x-handler": "create_company", "x-source-file": "crates/synckhub-server/src/routes/directory/companies.rs", "x-source-line": 28, "responses": { "default": { "description": "Platform error; branch on HTTP status and stable code, not the human-readable message.", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } } }, "2XX": { "description": "Successful JSON response", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/synckhub_core.types.DirectoryFolderSummary" } } } } }, "requestBody": { "required": true, "content": { "application/json": { "schema": { "$ref": "#/components/schemas/synckhub_server.routes.directory.companies.CreateCompanyRequest" } } } } }, "get": { "operationId": "platform_get__repos__repo_id__companies", "summary": "list companies", "tags": [ "directory · companies" ], "parameters": [ { "name": "repo_id", "in": "path", "required": true, "schema": { "type": "string" } }, { "name": "q", "in": "query", "required": false, "schema": { "anyOf": [ { "type": "string" }, { "type": "null" } ] } }, { "name": "scope", "in": "query", "required": false, "schema": { "anyOf": [ { "type": "string" }, { "type": "null" } ] } }, { "name": "role", "in": "query", "required": false, "schema": { "anyOf": [ { "type": "string" }, { "type": "null" } ] } }, { "name": "limit", "in": "query", "required": false, "schema": { "anyOf": [ { "type": "integer", "minimum": 0 }, { "type": "null" } ] } }, { "name": "offset", "in": "query", "required": false, "schema": { "anyOf": [ { "type": "integer", "minimum": 0 }, { "type": "null" } ] } }, { "name": "cursor", "in": "query", "required": false, "schema": { "anyOf": [ { "type": "string" }, { "type": "null" } ] } }, { "name": "order_dir", "in": "query", "required": false, "schema": { "anyOf": [ { "$ref": "#/components/schemas/synckhub_server.list_name_search_sql.DirectoryListOrderDir" }, { "type": "null" } ] } } ], "description": "Authorization and validation are enforced by the owning service.", "x-handler": "list_companies", "x-source-file": "crates/synckhub-server/src/routes/directory/companies.rs", "x-source-line": 28, "responses": { "default": { "description": "Platform error; branch on HTTP status and stable code, not the human-readable message.", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } } }, "2XX": { "description": "Successful JSON response", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/synckhub_server.routes.directory.companies.ListCompaniesResponse" } } } } } }, "head": { "operationId": "platform_head__repos__repo_id__companies", "summary": "list companies", "tags": [ "directory · companies" ], "parameters": [ { "name": "repo_id", "in": "path", "required": true, "schema": { "type": "string" } }, { "name": "q", "in": "query", "required": false, "schema": { "anyOf": [ { "type": "string" }, { "type": "null" } ] } }, { "name": "scope", "in": "query", "required": false, "schema": { "anyOf": [ { "type": "string" }, { "type": "null" } ] } }, { "name": "role", "in": "query", "required": false, "schema": { "anyOf": [ { "type": "string" }, { "type": "null" } ] } }, { "name": "limit", "in": "query", "required": false, "schema": { "anyOf": [ { "type": "integer", "minimum": 0 }, { "type": "null" } ] } }, { "name": "offset", "in": "query", "required": false, "schema": { "anyOf": [ { "type": "integer", "minimum": 0 }, { "type": "null" } ] } }, { "name": "cursor", "in": "query", "required": false, "schema": { "anyOf": [ { "type": "string" }, { "type": "null" } ] } }, { "name": "order_dir", "in": "query", "required": false, "schema": { "anyOf": [ { "$ref": "#/components/schemas/synckhub_server.list_name_search_sql.DirectoryListOrderDir" }, { "type": "null" } ] } } ], "description": "Authorization and validation are enforced by the owning service.\n\nHEAD uses the GET handler and headers without a response body.", "x-handler": "list_companies", "x-source-file": "crates/synckhub-server/src/routes/directory/companies.rs", "x-source-line": 28, "x-implicit-head": true, "responses": { "default": { "description": "Platform error; branch on HTTP status and stable code, not the human-readable message." } } } }, "/repos/{repo_id}/companies/{company_folder_id}": { "patch": { "operationId": "platform_patch__repos__repo_id__companies__company_folder_id_", "summary": "update company", "tags": [ "directory · companies" ], "parameters": [ { "name": "repo_id", "in": "path", "required": true, "schema": { "type": "string" } }, { "name": "company_folder_id", "in": "path", "required": true, "schema": { "type": "string" } } ], "description": "Authorization and validation are enforced by the owning service.", "x-handler": "update_company", "x-source-file": "crates/synckhub-server/src/routes/directory/companies.rs", "x-source-line": 28, "responses": { "default": { "description": "Platform error; branch on HTTP status and stable code, not the human-readable message.", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } } }, "2XX": { "description": "Successful JSON response", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/synckhub_core.types.DirectoryFolderSummary" } } } } }, "requestBody": { "required": true, "content": { "application/json": { "schema": { "$ref": "#/components/schemas/synckhub_server.routes.directory.companies.UpdateDirectoryFolderRequest" } } } } }, "get": { "operationId": "platform_get__repos__repo_id__companies__company_folder_id_", "summary": "get company", "tags": [ "directory · companies" ], "parameters": [ { "name": "repo_id", "in": "path", "required": true, "schema": { "type": "string" } }, { "name": "company_folder_id", "in": "path", "required": true, "schema": { "type": "string" } } ], "description": "Authorization and validation are enforced by the owning service.", "x-handler": "get_company", "x-source-file": "crates/synckhub-server/src/routes/directory/companies.rs", "x-source-line": 28, "responses": { "default": { "description": "Platform error; branch on HTTP status and stable code, not the human-readable message.", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } } }, "2XX": { "description": "Successful JSON response", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/synckhub_core.types.DirectoryFolderSummary" } } } } } }, "head": { "operationId": "platform_head__repos__repo_id__companies__company_folder_id_", "summary": "get company", "tags": [ "directory · companies" ], "parameters": [ { "name": "repo_id", "in": "path", "required": true, "schema": { "type": "string" } }, { "name": "company_folder_id", "in": "path", "required": true, "schema": { "type": "string" } } ], "description": "Authorization and validation are enforced by the owning service.\n\nHEAD uses the GET handler and headers without a response body.", "x-handler": "get_company", "x-source-file": "crates/synckhub-server/src/routes/directory/companies.rs", "x-source-line": 28, "x-implicit-head": true, "responses": { "default": { "description": "Platform error; branch on HTTP status and stable code, not the human-readable message." } } } }, "/repos/{repo_id}/companies/adopt-folder": { "post": { "operationId": "platform_post__repos__repo_id__companies_adopt_folder", "summary": "adopt company folder", "tags": [ "directory · companies" ], "parameters": [ { "name": "repo_id", "in": "path", "required": true, "schema": { "type": "string" } } ], "description": "Authorization and validation are enforced by the owning service.", "x-handler": "adopt_company_folder", "x-source-file": "crates/synckhub-server/src/routes/directory/companies.rs", "x-source-line": 28, "responses": { "default": { "description": "Platform error; branch on HTTP status and stable code, not the human-readable message.", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } } }, "2XX": { "description": "Successful JSON response", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/synckhub_core.types.DirectoryFolderSummary" } } } } }, "requestBody": { "required": true, "content": { "application/json": { "schema": { "$ref": "#/components/schemas/synckhub_server.routes.directory.companies.AdoptDirectoryFolderRequest" } } } } } }, "/repos/{repo_id}/companies/bulk/adopt-folder": { "post": { "operationId": "platform_post__repos__repo_id__companies_bulk_adopt_folder", "summary": "bulk adopt company folders", "tags": [ "directory · companies" ], "parameters": [ { "name": "repo_id", "in": "path", "required": true, "schema": { "type": "string" } } ], "description": "Authorization and validation are enforced by the owning service.", "x-handler": "bulk_adopt_company_folders", "x-source-file": "crates/synckhub-server/src/routes/directory/companies.rs", "x-source-line": 28, "responses": { "default": { "description": "Platform error; branch on HTTP status and stable code, not the human-readable message.", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } } }, "2XX": { "description": "Successful JSON response", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/synckhub_server.routes.directory.companies.DirectoryFolderAdoptBulkResponse" } } } } }, "requestBody": { "required": true, "content": { "application/json": { "schema": { "$ref": "#/components/schemas/synckhub_server.routes.directory.companies.BulkAdoptDirectoryFoldersRequest" } } } } } }, "/repos/{repo_id}/companies/bulk/create": { "post": { "operationId": "platform_post__repos__repo_id__companies_bulk_create", "summary": "bulk create companies", "tags": [ "directory · companies" ], "parameters": [ { "name": "repo_id", "in": "path", "required": true, "schema": { "type": "string" } } ], "description": "Authorization and validation are enforced by the owning service.", "x-handler": "bulk_create_companies", "x-source-file": "crates/synckhub-server/src/routes/directory/companies.rs", "x-source-line": 28, "responses": { "default": { "description": "Platform error; branch on HTTP status and stable code, not the human-readable message.", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } } }, "2XX": { "description": "Successful JSON response", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/synckhub_server.routes.directory.companies.CompanyCreateBulkResponse" } } } } }, "requestBody": { "required": true, "content": { "application/json": { "schema": { "$ref": "#/components/schemas/synckhub_server.routes.directory.companies.BulkCreateCompaniesRequest" } } } } } }, "/repos/{repo_id}/companies/bulk/release-folder": { "post": { "operationId": "platform_post__repos__repo_id__companies_bulk_release_folder", "summary": "bulk release company folders", "tags": [ "directory · companies" ], "parameters": [ { "name": "repo_id", "in": "path", "required": true, "schema": { "type": "string" } } ], "description": "Authorization and validation are enforced by the owning service.", "x-handler": "bulk_release_company_folders", "x-source-file": "crates/synckhub-server/src/routes/directory/companies.rs", "x-source-line": 28, "responses": { "default": { "description": "Platform error; branch on HTTP status and stable code, not the human-readable message.", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } } }, "2XX": { "description": "Successful JSON response", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/synckhub_server.routes.directory.companies.DirectoryFolderReleaseBulkResponse" } } } } }, "requestBody": { "required": true, "content": { "application/json": { "schema": { "$ref": "#/components/schemas/synckhub_server.routes.directory.companies.BulkReleaseDirectoryFoldersRequest" } } } } } }, "/repos/{repo_id}/companies/list": { "post": { "operationId": "platform_post__repos__repo_id__companies_list", "summary": "list companies post", "tags": [ "directory · companies" ], "parameters": [ { "name": "repo_id", "in": "path", "required": true, "schema": { "type": "string" } } ], "description": "Authorization and validation are enforced by the owning service.", "x-handler": "list_companies_post", "x-source-file": "crates/synckhub-server/src/routes/directory/companies.rs", "x-source-line": 28, "responses": { "default": { "description": "Platform error; branch on HTTP status and stable code, not the human-readable message.", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } } }, "2XX": { "description": "Successful JSON response", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/synckhub_server.routes.directory.companies.ListCompaniesResponse" } } } } }, "requestBody": { "required": true, "content": { "application/json": { "schema": { "$ref": "#/components/schemas/synckhub_server.routes.directory.companies.ListDirectoryFoldersQuery" } } } } } }, "/repos/{repo_id}/companies/recents": { "get": { "operationId": "platform_get__repos__repo_id__companies_recents", "summary": "list recent companies", "tags": [ "directory · companies" ], "parameters": [ { "name": "repo_id", "in": "path", "required": true, "schema": { "type": "string" } }, { "name": "role", "in": "query", "required": false, "schema": { "anyOf": [ { "type": "string" }, { "type": "null" } ] } } ], "description": "Authorization and validation are enforced by the owning service.", "x-handler": "list_recent_companies", "x-source-file": "crates/synckhub-server/src/routes/directory/companies.rs", "x-source-line": 28, "responses": { "default": { "description": "Platform error; branch on HTTP status and stable code, not the human-readable message.", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } } }, "2XX": { "description": "Successful JSON response", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/synckhub_server.routes.directory.companies.ListCompaniesResponse" } } } } } }, "head": { "operationId": "platform_head__repos__repo_id__companies_recents", "summary": "list recent companies", "tags": [ "directory · companies" ], "parameters": [ { "name": "repo_id", "in": "path", "required": true, "schema": { "type": "string" } }, { "name": "role", "in": "query", "required": false, "schema": { "anyOf": [ { "type": "string" }, { "type": "null" } ] } } ], "description": "Authorization and validation are enforced by the owning service.\n\nHEAD uses the GET handler and headers without a response body.", "x-handler": "list_recent_companies", "x-source-file": "crates/synckhub-server/src/routes/directory/companies.rs", "x-source-line": 28, "x-implicit-head": true, "responses": { "default": { "description": "Platform error; branch on HTTP status and stable code, not the human-readable message." } } } }, "/repos/{repo_id}/companies/release-folder": { "post": { "operationId": "platform_post__repos__repo_id__companies_release_folder", "summary": "release company folder", "tags": [ "directory · companies" ], "parameters": [ { "name": "repo_id", "in": "path", "required": true, "schema": { "type": "string" } } ], "description": "Authorization and validation are enforced by the owning service.", "x-handler": "release_company_folder", "x-source-file": "crates/synckhub-server/src/routes/directory/companies.rs", "x-source-line": 28, "responses": { "default": { "description": "Platform error; branch on HTTP status and stable code, not the human-readable message.", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } } }, "2XX": { "description": "Successful JSON response", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/synckhub_core.types.ItemSummary" } } } } }, "requestBody": { "required": true, "content": { "application/json": { "schema": { "$ref": "#/components/schemas/synckhub_server.routes.directory.companies.ReleaseDirectoryFolderRequest" } } } } } }, "/repos/{repo_id}/company-metadata-definition": { "put": { "operationId": "platform_put__repos__repo_id__company_metadata_definition", "summary": "put company metadata definition", "tags": [ "directory · companies" ], "parameters": [ { "name": "repo_id", "in": "path", "required": true, "schema": { "type": "string" } } ], "description": "Authorization and validation are enforced by the owning service.", "x-handler": "put_company_metadata_definition", "x-source-file": "crates/synckhub-server/src/routes/directory/companies.rs", "x-source-line": 28, "responses": { "default": { "description": "Platform error; branch on HTTP status and stable code, not the human-readable message.", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } } }, "2XX": { "description": "Successful JSON response", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/synckhub_server.routes.directory.companies.CompanyMetadataDefinitionResponse" } } } } }, "requestBody": { "required": true, "content": { "application/json": { "schema": { "$ref": "#/components/schemas/synckhub_server.routes.directory.companies.PutCompanyMetadataDefinitionRequest" } } } } }, "get": { "operationId": "platform_get__repos__repo_id__company_metadata_definition", "summary": "get company metadata definition", "tags": [ "directory · companies" ], "parameters": [ { "name": "repo_id", "in": "path", "required": true, "schema": { "type": "string" } } ], "description": "Authorization and validation are enforced by the owning service.", "x-handler": "get_company_metadata_definition", "x-source-file": "crates/synckhub-server/src/routes/directory/companies.rs", "x-source-line": 28, "responses": { "default": { "description": "Platform error; branch on HTTP status and stable code, not the human-readable message.", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } } }, "2XX": { "description": "Successful JSON response", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/synckhub_server.routes.directory.companies.CompanyMetadataDefinitionResponse" } } } } } }, "head": { "operationId": "platform_head__repos__repo_id__company_metadata_definition", "summary": "get company metadata definition", "tags": [ "directory · companies" ], "parameters": [ { "name": "repo_id", "in": "path", "required": true, "schema": { "type": "string" } } ], "description": "Authorization and validation are enforced by the owning service.\n\nHEAD uses the GET handler and headers without a response body.", "x-handler": "get_company_metadata_definition", "x-source-file": "crates/synckhub-server/src/routes/directory/companies.rs", "x-source-line": 28, "x-implicit-head": true, "responses": { "default": { "description": "Platform error; branch on HTTP status and stable code, not the human-readable message." } } } }, "/repos/{repo_id}/contact-metadata-definition": { "put": { "operationId": "platform_put__repos__repo_id__contact_metadata_definition", "summary": "put contact metadata definition", "tags": [ "directory · contacts" ], "parameters": [ { "name": "repo_id", "in": "path", "required": true, "schema": { "type": "string" } } ], "description": "Authorization and validation are enforced by the owning service.", "x-handler": "put_contact_metadata_definition", "x-source-file": "crates/synckhub-server/src/routes/directory/contacts.rs", "x-source-line": 23, "responses": { "default": { "description": "Platform error; branch on HTTP status and stable code, not the human-readable message.", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } } }, "2XX": { "description": "Successful JSON response", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/synckhub_server.routes.directory.contacts.ContactMetadataDefinitionResponse" } } } } }, "requestBody": { "required": true, "content": { "application/json": { "schema": { "$ref": "#/components/schemas/synckhub_server.routes.directory.contacts.PutContactMetadataDefinitionRequest" } } } } }, "get": { "operationId": "platform_get__repos__repo_id__contact_metadata_definition", "summary": "get contact metadata definition", "tags": [ "directory · contacts" ], "parameters": [ { "name": "repo_id", "in": "path", "required": true, "schema": { "type": "string" } } ], "description": "Authorization and validation are enforced by the owning service.", "x-handler": "get_contact_metadata_definition", "x-source-file": "crates/synckhub-server/src/routes/directory/contacts.rs", "x-source-line": 23, "responses": { "default": { "description": "Platform error; branch on HTTP status and stable code, not the human-readable message.", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } } }, "2XX": { "description": "Successful JSON response", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/synckhub_server.routes.directory.contacts.ContactMetadataDefinitionResponse" } } } } } }, "head": { "operationId": "platform_head__repos__repo_id__contact_metadata_definition", "summary": "get contact metadata definition", "tags": [ "directory · contacts" ], "parameters": [ { "name": "repo_id", "in": "path", "required": true, "schema": { "type": "string" } } ], "description": "Authorization and validation are enforced by the owning service.\n\nHEAD uses the GET handler and headers without a response body.", "x-handler": "get_contact_metadata_definition", "x-source-file": "crates/synckhub-server/src/routes/directory/contacts.rs", "x-source-line": 23, "x-implicit-head": true, "responses": { "default": { "description": "Platform error; branch on HTTP status and stable code, not the human-readable message." } } } }, "/repos/{repo_id}/contact-metadata-definition/rebuild-projection": { "post": { "operationId": "platform_post__repos__repo_id__contact_metadata_definition_rebuild_projection", "summary": "rebuild contact metadata projection", "tags": [ "directory · contacts" ], "parameters": [ { "name": "repo_id", "in": "path", "required": true, "schema": { "type": "string" } } ], "description": "Authorization and validation are enforced by the owning service.", "x-handler": "rebuild_contact_metadata_projection", "x-source-file": "crates/synckhub-server/src/routes/directory/contacts.rs", "x-source-line": 23, "responses": { "default": { "description": "Platform error; branch on HTTP status and stable code, not the human-readable message.", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } } }, "2XX": { "description": "Successful JSON response", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/synckhub_server.routes.directory.contacts.ContactMetadataProjectionRebuildResponse" } } } } } } }, "/repos/{repo_id}/contacts": { "post": { "operationId": "platform_post__repos__repo_id__contacts", "summary": "create contact", "tags": [ "directory · contacts" ], "parameters": [ { "name": "repo_id", "in": "path", "required": true, "schema": { "type": "string" } } ], "description": "Authorization and validation are enforced by the owning service.", "x-handler": "create_contact", "x-source-file": "crates/synckhub-server/src/routes/directory/contacts.rs", "x-source-line": 23, "responses": { "default": { "description": "Platform error; branch on HTTP status and stable code, not the human-readable message.", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } } }, "2XX": { "description": "Successful JSON response", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/synckhub_core.types.ContactDetail" } } } } }, "requestBody": { "required": true, "content": { "application/json": { "schema": { "$ref": "#/components/schemas/synckhub_server.routes.directory.contacts.CreateContactRequest" } } } } }, "get": { "operationId": "platform_get__repos__repo_id__contacts", "summary": "list contacts", "tags": [ "directory · contacts" ], "parameters": [ { "name": "repo_id", "in": "path", "required": true, "schema": { "type": "string" } }, { "name": "q", "in": "query", "required": false, "schema": { "anyOf": [ { "type": "string" }, { "type": "null" } ] } }, { "name": "scope", "in": "query", "required": false, "schema": { "anyOf": [ { "type": "string" }, { "type": "null" } ] } }, { "name": "include_suggested", "in": "query", "required": false, "schema": { "type": "boolean" } }, { "name": "curation_state", "in": "query", "required": false, "schema": { "anyOf": [ { "type": "string" }, { "type": "null" } ] } }, { "name": "company_folder_item_id", "in": "query", "required": false, "schema": { "anyOf": [ { "type": "string" }, { "type": "null" } ] } }, { "name": "limit", "in": "query", "required": false, "schema": { "anyOf": [ { "type": "integer", "minimum": 0 }, { "type": "null" } ] } }, { "name": "offset", "in": "query", "required": false, "schema": { "anyOf": [ { "type": "integer", "minimum": 0 }, { "type": "null" } ] } }, { "name": "cursor", "in": "query", "required": false, "schema": { "anyOf": [ { "type": "string" }, { "type": "null" } ] } } ], "description": "Authorization and validation are enforced by the owning service.", "x-handler": "list_contacts", "x-source-file": "crates/synckhub-server/src/routes/directory/contacts.rs", "x-source-line": 23, "responses": { "default": { "description": "Platform error; branch on HTTP status and stable code, not the human-readable message.", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } } }, "2XX": { "description": "Successful JSON response", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/synckhub_server.routes.directory.contacts.ListContactsResponse" } } } } } }, "head": { "operationId": "platform_head__repos__repo_id__contacts", "summary": "list contacts", "tags": [ "directory · contacts" ], "parameters": [ { "name": "repo_id", "in": "path", "required": true, "schema": { "type": "string" } }, { "name": "q", "in": "query", "required": false, "schema": { "anyOf": [ { "type": "string" }, { "type": "null" } ] } }, { "name": "scope", "in": "query", "required": false, "schema": { "anyOf": [ { "type": "string" }, { "type": "null" } ] } }, { "name": "include_suggested", "in": "query", "required": false, "schema": { "type": "boolean" } }, { "name": "curation_state", "in": "query", "required": false, "schema": { "anyOf": [ { "type": "string" }, { "type": "null" } ] } }, { "name": "company_folder_item_id", "in": "query", "required": false, "schema": { "anyOf": [ { "type": "string" }, { "type": "null" } ] } }, { "name": "limit", "in": "query", "required": false, "schema": { "anyOf": [ { "type": "integer", "minimum": 0 }, { "type": "null" } ] } }, { "name": "offset", "in": "query", "required": false, "schema": { "anyOf": [ { "type": "integer", "minimum": 0 }, { "type": "null" } ] } }, { "name": "cursor", "in": "query", "required": false, "schema": { "anyOf": [ { "type": "string" }, { "type": "null" } ] } } ], "description": "Authorization and validation are enforced by the owning service.\n\nHEAD uses the GET handler and headers without a response body.", "x-handler": "list_contacts", "x-source-file": "crates/synckhub-server/src/routes/directory/contacts.rs", "x-source-line": 23, "x-implicit-head": true, "responses": { "default": { "description": "Platform error; branch on HTTP status and stable code, not the human-readable message." } } } }, "/repos/{repo_id}/contacts/{contact_id}": { "patch": { "operationId": "platform_patch__repos__repo_id__contacts__contact_id_", "summary": "update contact", "tags": [ "directory · contacts" ], "parameters": [ { "name": "repo_id", "in": "path", "required": true, "schema": { "type": "string" } }, { "name": "contact_id", "in": "path", "required": true, "schema": { "type": "string" } } ], "description": "Authorization and validation are enforced by the owning service.", "x-handler": "update_contact", "x-source-file": "crates/synckhub-server/src/routes/directory/contacts.rs", "x-source-line": 23, "responses": { "default": { "description": "Platform error; branch on HTTP status and stable code, not the human-readable message.", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } } }, "2XX": { "description": "Successful JSON response", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/synckhub_core.types.ContactDetail" } } } } }, "requestBody": { "required": true, "content": { "application/json": { "schema": { "$ref": "#/components/schemas/synckhub_server.routes.directory.contacts.UpdateContactRequest" } } } } }, "get": { "operationId": "platform_get__repos__repo_id__contacts__contact_id_", "summary": "get contact", "tags": [ "directory · contacts" ], "parameters": [ { "name": "repo_id", "in": "path", "required": true, "schema": { "type": "string" } }, { "name": "contact_id", "in": "path", "required": true, "schema": { "type": "string" } } ], "description": "Authorization and validation are enforced by the owning service.", "x-handler": "get_contact", "x-source-file": "crates/synckhub-server/src/routes/directory/contacts.rs", "x-source-line": 23, "responses": { "default": { "description": "Platform error; branch on HTTP status and stable code, not the human-readable message.", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } } }, "2XX": { "description": "Successful JSON response", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/synckhub_core.types.ContactDetail" } } } } } }, "head": { "operationId": "platform_head__repos__repo_id__contacts__contact_id_", "summary": "get contact", "tags": [ "directory · contacts" ], "parameters": [ { "name": "repo_id", "in": "path", "required": true, "schema": { "type": "string" } }, { "name": "contact_id", "in": "path", "required": true, "schema": { "type": "string" } } ], "description": "Authorization and validation are enforced by the owning service.\n\nHEAD uses the GET handler and headers without a response body.", "x-handler": "get_contact", "x-source-file": "crates/synckhub-server/src/routes/directory/contacts.rs", "x-source-line": 23, "x-implicit-head": true, "responses": { "default": { "description": "Platform error; branch on HTTP status and stable code, not the human-readable message." } } } }, "/repos/{repo_id}/contacts/{contact_id}/archive": { "post": { "operationId": "platform_post__repos__repo_id__contacts__contact_id__archive", "summary": "archive contact", "tags": [ "directory · contacts" ], "parameters": [ { "name": "repo_id", "in": "path", "required": true, "schema": { "type": "string" } }, { "name": "contact_id", "in": "path", "required": true, "schema": { "type": "string" } } ], "description": "Authorization and validation are enforced by the owning service.", "x-handler": "archive_contact", "x-source-file": "crates/synckhub-server/src/routes/directory/contacts.rs", "x-source-line": 23, "responses": { "default": { "description": "Platform error; branch on HTTP status and stable code, not the human-readable message.", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } } }, "2XX": { "description": "Successful JSON response", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/synckhub_core.types.ContactDetail" } } } } } } }, "/repos/{repo_id}/contacts/{contact_id}/merge": { "post": { "operationId": "platform_post__repos__repo_id__contacts__contact_id__merge", "summary": "merge contacts", "tags": [ "directory · contacts" ], "parameters": [ { "name": "repo_id", "in": "path", "required": true, "schema": { "type": "string" } }, { "name": "contact_id", "in": "path", "required": true, "schema": { "type": "string" } } ], "description": "Authorization and validation are enforced by the owning service.", "x-handler": "merge_contacts", "x-source-file": "crates/synckhub-server/src/routes/directory/contacts.rs", "x-source-line": 23, "responses": { "default": { "description": "Platform error; branch on HTTP status and stable code, not the human-readable message.", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } } }, "2XX": { "description": "Successful JSON response", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/synckhub_core.types.ContactDetail" } } } } }, "requestBody": { "required": true, "content": { "application/json": { "schema": { "$ref": "#/components/schemas/synckhub_server.routes.directory.contacts.MergeContactsRequest" } } } } } }, "/repos/{repo_id}/contacts/{contact_id}/restore": { "post": { "operationId": "platform_post__repos__repo_id__contacts__contact_id__restore", "summary": "restore contact", "tags": [ "directory · contacts" ], "parameters": [ { "name": "repo_id", "in": "path", "required": true, "schema": { "type": "string" } }, { "name": "contact_id", "in": "path", "required": true, "schema": { "type": "string" } } ], "description": "Authorization and validation are enforced by the owning service.", "x-handler": "restore_contact", "x-source-file": "crates/synckhub-server/src/routes/directory/contacts.rs", "x-source-line": 23, "responses": { "default": { "description": "Platform error; branch on HTTP status and stable code, not the human-readable message.", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } } }, "2XX": { "description": "Successful JSON response", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/synckhub_core.types.ContactDetail" } } } } } } }, "/repos/{repo_id}/contacts/adopt-folder": { "post": { "operationId": "platform_post__repos__repo_id__contacts_adopt_folder", "summary": "retired contact folder write", "tags": [ "directory · contacts" ], "parameters": [ { "name": "repo_id", "in": "path", "required": true, "schema": { "type": "string" } } ], "description": "Authorization and validation are enforced by the owning service.", "x-handler": "retired_contact_folder_write", "x-source-file": "crates/synckhub-server/src/routes/directory/contacts.rs", "x-source-line": 23, "responses": { "default": { "description": "Platform error; branch on HTTP status and stable code, not the human-readable message.", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } } }, "2XX": { "description": "Successful JSON response", "content": { "application/json": { "schema": {} } } } }, "requestBody": { "required": true, "content": { "application/json": { "schema": {} } } } } }, "/repos/{repo_id}/contacts/aggregate": { "get": { "operationId": "platform_get__repos__repo_id__contacts_aggregate", "summary": "list aggregate contacts", "tags": [ "connected_accounts · provider_people" ], "parameters": [ { "name": "repo_id", "in": "path", "required": true, "schema": { "type": "string" } }, { "name": "q", "in": "query", "required": false, "schema": { "anyOf": [ { "type": "string" }, { "type": "null" } ] } }, { "name": "cursor", "in": "query", "required": false, "schema": { "anyOf": [ { "type": "string" }, { "type": "null" } ] } }, { "name": "limit", "in": "query", "required": false, "schema": { "anyOf": [ { "type": "integer", "minimum": 0 }, { "type": "null" } ] } }, { "name": "state", "in": "query", "required": false, "schema": { "$ref": "#/components/schemas/synckhub_server.routes.connected_accounts.provider_people.ContactListState" } } ], "description": "Authorization and validation are enforced by the owning service.", "x-handler": "list_aggregate_contacts", "x-source-file": "crates/synckhub-server/src/routes/connected_accounts/provider_people.rs", "x-source-line": 916, "responses": { "default": { "description": "Service response. Error status and envelope depend on the operation." }, "2XX": { "description": "Successful JSON response", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/synckhub_server.routes.connected_accounts.provider_people.AggregateContactsResponse" } } } } } }, "head": { "operationId": "platform_head__repos__repo_id__contacts_aggregate", "summary": "list aggregate contacts", "tags": [ "connected_accounts · provider_people" ], "parameters": [ { "name": "repo_id", "in": "path", "required": true, "schema": { "type": "string" } }, { "name": "q", "in": "query", "required": false, "schema": { "anyOf": [ { "type": "string" }, { "type": "null" } ] } }, { "name": "cursor", "in": "query", "required": false, "schema": { "anyOf": [ { "type": "string" }, { "type": "null" } ] } }, { "name": "limit", "in": "query", "required": false, "schema": { "anyOf": [ { "type": "integer", "minimum": 0 }, { "type": "null" } ] } }, { "name": "state", "in": "query", "required": false, "schema": { "$ref": "#/components/schemas/synckhub_server.routes.connected_accounts.provider_people.ContactListState" } } ], "description": "Authorization and validation are enforced by the owning service.\n\nHEAD uses the GET handler and headers without a response body.", "x-handler": "list_aggregate_contacts", "x-source-file": "crates/synckhub-server/src/routes/connected_accounts/provider_people.rs", "x-source-line": 916, "x-implicit-head": true, "responses": { "default": { "description": "Service response. Error status and envelope depend on the operation." } } } }, "/repos/{repo_id}/contacts/bulk/adopt-folder": { "post": { "operationId": "platform_post__repos__repo_id__contacts_bulk_adopt_folder", "summary": "retired contact folder write", "tags": [ "directory · contacts" ], "parameters": [ { "name": "repo_id", "in": "path", "required": true, "schema": { "type": "string" } } ], "description": "Authorization and validation are enforced by the owning service.", "x-handler": "retired_contact_folder_write", "x-source-file": "crates/synckhub-server/src/routes/directory/contacts.rs", "x-source-line": 23, "responses": { "default": { "description": "Platform error; branch on HTTP status and stable code, not the human-readable message.", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } } }, "2XX": { "description": "Successful JSON response", "content": { "application/json": { "schema": {} } } } }, "requestBody": { "required": true, "content": { "application/json": { "schema": {} } } } } }, "/repos/{repo_id}/contacts/bulk/release-folder": { "post": { "operationId": "platform_post__repos__repo_id__contacts_bulk_release_folder", "summary": "retired contact folder write", "tags": [ "directory · contacts" ], "parameters": [ { "name": "repo_id", "in": "path", "required": true, "schema": { "type": "string" } } ], "description": "Authorization and validation are enforced by the owning service.", "x-handler": "retired_contact_folder_write", "x-source-file": "crates/synckhub-server/src/routes/directory/contacts.rs", "x-source-line": 23, "responses": { "default": { "description": "Platform error; branch on HTTP status and stable code, not the human-readable message.", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } } }, "2XX": { "description": "Successful JSON response", "content": { "application/json": { "schema": {} } } } }, "requestBody": { "required": true, "content": { "application/json": { "schema": {} } } } } }, "/repos/{repo_id}/contacts/carddav/credentials": { "post": { "operationId": "platform_post__repos__repo_id__contacts_carddav_credentials", "summary": "create credential", "tags": [ "carddav" ], "parameters": [ { "name": "repo_id", "in": "path", "required": true, "schema": { "type": "string" } } ], "description": "Authorization and validation are enforced by the owning service.", "x-handler": "create_credential", "x-source-file": "crates/synckhub-server/src/routes/carddav.rs", "x-source-line": 32, "responses": { "default": { "description": "Platform error; branch on HTTP status and stable code, not the human-readable message.", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } } } }, "requestBody": { "required": true, "content": { "application/json": { "schema": { "$ref": "#/components/schemas/synckhub_server.routes.carddav.CreateCredentialRequest" } } } } }, "get": { "operationId": "platform_get__repos__repo_id__contacts_carddav_credentials", "summary": "list credentials", "tags": [ "carddav" ], "parameters": [ { "name": "repo_id", "in": "path", "required": true, "schema": { "type": "string" } } ], "description": "Authorization and validation are enforced by the owning service.", "x-handler": "list_credentials", "x-source-file": "crates/synckhub-server/src/routes/carddav.rs", "x-source-line": 32, "responses": { "default": { "description": "Platform error; branch on HTTP status and stable code, not the human-readable message.", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } } }, "2XX": { "description": "Successful JSON response", "content": { "application/json": { "schema": { "type": "array", "items": { "$ref": "#/components/schemas/synckhub_server.routes.carddav.CardDavCredentialSummary" } } } } } } }, "head": { "operationId": "platform_head__repos__repo_id__contacts_carddav_credentials", "summary": "list credentials", "tags": [ "carddav" ], "parameters": [ { "name": "repo_id", "in": "path", "required": true, "schema": { "type": "string" } } ], "description": "Authorization and validation are enforced by the owning service.\n\nHEAD uses the GET handler and headers without a response body.", "x-handler": "list_credentials", "x-source-file": "crates/synckhub-server/src/routes/carddav.rs", "x-source-line": 32, "x-implicit-head": true, "responses": { "default": { "description": "Platform error; branch on HTTP status and stable code, not the human-readable message." } } } }, "/repos/{repo_id}/contacts/carddav/credentials/{credential_id}": { "delete": { "operationId": "platform_delete__repos__repo_id__contacts_carddav_credentials__credential_id_", "summary": "revoke credential", "tags": [ "carddav" ], "parameters": [ { "name": "repo_id", "in": "path", "required": true, "schema": { "type": "string" } }, { "name": "credential_id", "in": "path", "required": true, "schema": { "type": "string" } } ], "description": "Authorization and validation are enforced by the owning service.", "x-handler": "revoke_credential", "x-source-file": "crates/synckhub-server/src/routes/carddav.rs", "x-source-line": 32, "responses": { "default": { "description": "Platform error; branch on HTTP status and stable code, not the human-readable message.", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } } } } } }, "/repos/{repo_id}/contacts/folders": { "get": { "operationId": "platform_get__repos__repo_id__contacts_folders", "summary": "get contacts folders", "tags": [ "directory · contacts" ], "parameters": [ { "name": "repo_id", "in": "path", "required": true, "schema": { "type": "string" } } ], "description": "Authorization and validation are enforced by the owning service.", "x-handler": "get_contacts_folders", "x-source-file": "crates/synckhub-server/src/routes/directory/contacts.rs", "x-source-line": 23, "responses": { "default": { "description": "Platform error; branch on HTTP status and stable code, not the human-readable message.", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } } }, "2XX": { "description": "Successful JSON response", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/synckhub_server.routes.directory.contacts.ContactsFoldersResponse" } } } } } }, "head": { "operationId": "platform_head__repos__repo_id__contacts_folders", "summary": "get contacts folders", "tags": [ "directory · contacts" ], "parameters": [ { "name": "repo_id", "in": "path", "required": true, "schema": { "type": "string" } } ], "description": "Authorization and validation are enforced by the owning service.\n\nHEAD uses the GET handler and headers without a response body.", "x-handler": "get_contacts_folders", "x-source-file": "crates/synckhub-server/src/routes/directory/contacts.rs", "x-source-line": 23, "x-implicit-head": true, "responses": { "default": { "description": "Platform error; branch on HTTP status and stable code, not the human-readable message." } } } }, "/repos/{repo_id}/contacts/import-provider": { "post": { "operationId": "platform_post__repos__repo_id__contacts_import_provider", "summary": "import provider contacts", "tags": [ "connected_accounts · provider_people" ], "parameters": [ { "name": "repo_id", "in": "path", "required": true, "schema": { "type": "string" } } ], "description": "Authorization and validation are enforced by the owning service.", "x-handler": "import_provider_contacts", "x-source-file": "crates/synckhub-server/src/routes/connected_accounts/provider_people.rs", "x-source-line": 916, "responses": { "default": { "description": "Service response. Error status and envelope depend on the operation." }, "2XX": { "description": "Successful JSON response", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/synckhub_server.routes.connected_accounts.provider_people.ImportProviderContactsResponse" } } } } }, "requestBody": { "required": true, "content": { "application/json": { "schema": { "$ref": "#/components/schemas/synckhub_server.routes.connected_accounts.provider_people.ImportProviderContactsRequest" } } } } } }, "/repos/{repo_id}/contacts/init": { "post": { "operationId": "platform_post__repos__repo_id__contacts_init", "summary": "contacts init", "tags": [ "directory · contacts" ], "parameters": [ { "name": "repo_id", "in": "path", "required": true, "schema": { "type": "string" } } ], "description": "Authorization and validation are enforced by the owning service.", "x-handler": "contacts_init", "x-source-file": "crates/synckhub-server/src/routes/directory/contacts.rs", "x-source-line": 23, "responses": { "default": { "description": "Platform error; branch on HTTP status and stable code, not the human-readable message.", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } } }, "2XX": { "description": "Successful JSON response", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/synckhub_core.types.ContactsInitResult" } } } } } } }, "/repos/{repo_id}/contacts/list": { "post": { "operationId": "platform_post__repos__repo_id__contacts_list", "summary": "list contacts post", "tags": [ "directory · contacts" ], "parameters": [ { "name": "repo_id", "in": "path", "required": true, "schema": { "type": "string" } } ], "description": "Authorization and validation are enforced by the owning service.", "x-handler": "list_contacts_post", "x-source-file": "crates/synckhub-server/src/routes/directory/contacts.rs", "x-source-line": 23, "responses": { "default": { "description": "Platform error; branch on HTTP status and stable code, not the human-readable message.", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } } }, "2XX": { "description": "Successful JSON response", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/synckhub_server.routes.directory.contacts.ListContactsResponse" } } } } }, "requestBody": { "required": true, "content": { "application/json": { "schema": { "$ref": "#/components/schemas/synckhub_server.routes.directory.contacts.ListContactsQuery" } } } } } }, "/repos/{repo_id}/contacts/native-private": { "post": { "operationId": "platform_post__repos__repo_id__contacts_native_private", "summary": "list native private contacts", "tags": [ "directory · contacts" ], "parameters": [ { "name": "repo_id", "in": "path", "required": true, "schema": { "type": "string" } } ], "description": "Authorization and validation are enforced by the owning service.", "x-handler": "list_native_private_contacts", "x-source-file": "crates/synckhub-server/src/routes/directory/contacts.rs", "x-source-line": 23, "responses": { "default": { "description": "Platform error; branch on HTTP status and stable code, not the human-readable message.", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } } }, "2XX": { "description": "Successful JSON response", "content": { "application/json": { "schema": { "type": "array", "items": { "$ref": "#/components/schemas/synckhub_core.types.NativePrivateContact" } } } } } }, "requestBody": { "required": true, "content": { "application/json": { "schema": { "$ref": "#/components/schemas/synckhub_server.routes.directory.contacts.ListNativePrivateContactsRequest" } } } } } }, "/repos/{repo_id}/contacts/private-folder/ensure": { "post": { "operationId": "platform_post__repos__repo_id__contacts_private_folder_ensure", "summary": "ensure private contacts folder", "tags": [ "directory · contacts" ], "parameters": [ { "name": "repo_id", "in": "path", "required": true, "schema": { "type": "string" } } ], "description": "Authorization and validation are enforced by the owning service.", "x-handler": "ensure_private_contacts_folder", "x-source-file": "crates/synckhub-server/src/routes/directory/contacts.rs", "x-source-line": 23, "responses": { "default": { "description": "Platform error; branch on HTTP status and stable code, not the human-readable message.", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } } }, "2XX": { "description": "Successful JSON response", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/synckhub_core.types.PrivateContactsFolderResult" } } } } } } }, "/repos/{repo_id}/contacts/release-folder": { "post": { "operationId": "platform_post__repos__repo_id__contacts_release_folder", "summary": "retired contact folder write", "tags": [ "directory · contacts" ], "parameters": [ { "name": "repo_id", "in": "path", "required": true, "schema": { "type": "string" } } ], "description": "Authorization and validation are enforced by the owning service.", "x-handler": "retired_contact_folder_write", "x-source-file": "crates/synckhub-server/src/routes/directory/contacts.rs", "x-source-line": 23, "responses": { "default": { "description": "Platform error; branch on HTTP status and stable code, not the human-readable message.", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } } }, "2XX": { "description": "Successful JSON response", "content": { "application/json": { "schema": {} } } } }, "requestBody": { "required": true, "content": { "application/json": { "schema": {} } } } } }, "/repos/{repo_id}/data/databases": { "get": { "operationId": "platform_get__repos__repo_id__data_databases", "summary": "get structured data databases", "tags": [ "structured_data" ], "parameters": [ { "name": "repo_id", "in": "path", "required": true, "schema": { "type": "string" } }, { "name": "include_archived", "in": "query", "required": false, "schema": { "type": "boolean" } } ], "description": "Authorization and validation are enforced by the owning service.", "x-handler": "get_structured_data_databases", "x-source-file": "crates/synckhub-server/src/routes/structured_data.rs", "x-source-line": 62, "responses": { "default": { "description": "Platform error; branch on HTTP status and stable code, not the human-readable message.", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } } }, "2XX": { "description": "Successful JSON response", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/synckhub_server.routes.structured_data.ListStructuredDataDatabasesResponse" } } } } } }, "head": { "operationId": "platform_head__repos__repo_id__data_databases", "summary": "get structured data databases", "tags": [ "structured_data" ], "parameters": [ { "name": "repo_id", "in": "path", "required": true, "schema": { "type": "string" } }, { "name": "include_archived", "in": "query", "required": false, "schema": { "type": "boolean" } } ], "description": "Authorization and validation are enforced by the owning service.\n\nHEAD uses the GET handler and headers without a response body.", "x-handler": "get_structured_data_databases", "x-source-file": "crates/synckhub-server/src/routes/structured_data.rs", "x-source-line": 62, "x-implicit-head": true, "responses": { "default": { "description": "Platform error; branch on HTTP status and stable code, not the human-readable message." } } } }, "/repos/{repo_id}/data/databases/{database_key}": { "put": { "operationId": "platform_put__repos__repo_id__data_databases__database_key_", "summary": "put structured data database", "tags": [ "structured_data" ], "parameters": [ { "name": "repo_id", "in": "path", "required": true, "schema": { "type": "string" } }, { "name": "database_key", "in": "path", "required": true, "schema": { "type": "string" } } ], "description": "Authorization and validation are enforced by the owning service.", "x-handler": "put_structured_data_database", "x-source-file": "crates/synckhub-server/src/routes/structured_data.rs", "x-source-line": 62, "responses": { "default": { "description": "Platform error; branch on HTTP status and stable code, not the human-readable message.", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } } }, "2XX": { "description": "Successful JSON response", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/synckhub_server.routes.structured_data.StructuredDataDatabaseResponse" } } } } }, "requestBody": { "required": true, "content": { "application/json": { "schema": { "$ref": "#/components/schemas/synckhub_server.routes.structured_data.PutStructuredDataDatabaseRequest" } } } } }, "get": { "operationId": "platform_get__repos__repo_id__data_databases__database_key_", "summary": "get structured data database", "tags": [ "structured_data" ], "parameters": [ { "name": "repo_id", "in": "path", "required": true, "schema": { "type": "string" } }, { "name": "database_key", "in": "path", "required": true, "schema": { "type": "string" } } ], "description": "Authorization and validation are enforced by the owning service.", "x-handler": "get_structured_data_database", "x-source-file": "crates/synckhub-server/src/routes/structured_data.rs", "x-source-line": 62, "responses": { "default": { "description": "Platform error; branch on HTTP status and stable code, not the human-readable message.", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } } }, "2XX": { "description": "Successful JSON response", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/synckhub_server.routes.structured_data.StructuredDataDatabaseResponse" } } } } } }, "head": { "operationId": "platform_head__repos__repo_id__data_databases__database_key_", "summary": "get structured data database", "tags": [ "structured_data" ], "parameters": [ { "name": "repo_id", "in": "path", "required": true, "schema": { "type": "string" } }, { "name": "database_key", "in": "path", "required": true, "schema": { "type": "string" } } ], "description": "Authorization and validation are enforced by the owning service.\n\nHEAD uses the GET handler and headers without a response body.", "x-handler": "get_structured_data_database", "x-source-file": "crates/synckhub-server/src/routes/structured_data.rs", "x-source-line": 62, "x-implicit-head": true, "responses": { "default": { "description": "Platform error; branch on HTTP status and stable code, not the human-readable message." } } } }, "/repos/{repo_id}/data/databases/{database_key}/history": { "get": { "operationId": "platform_get__repos__repo_id__data_databases__database_key__history", "summary": "get structured data database history", "tags": [ "structured_data" ], "parameters": [ { "name": "repo_id", "in": "path", "required": true, "schema": { "type": "string" } }, { "name": "database_key", "in": "path", "required": true, "schema": { "type": "string" } }, { "name": "limit", "in": "query", "required": false, "schema": { "anyOf": [ { "type": "integer" }, { "type": "null" } ] } } ], "description": "Authorization and validation are enforced by the owning service.", "x-handler": "get_structured_data_database_history", "x-source-file": "crates/synckhub-server/src/routes/structured_data.rs", "x-source-line": 62, "responses": { "default": { "description": "Platform error; branch on HTTP status and stable code, not the human-readable message.", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } } }, "2XX": { "description": "Successful JSON response", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/synckhub_server.routes.structured_data.ListStructuredDataHistoryResponse" } } } } } }, "head": { "operationId": "platform_head__repos__repo_id__data_databases__database_key__history", "summary": "get structured data database history", "tags": [ "structured_data" ], "parameters": [ { "name": "repo_id", "in": "path", "required": true, "schema": { "type": "string" } }, { "name": "database_key", "in": "path", "required": true, "schema": { "type": "string" } }, { "name": "limit", "in": "query", "required": false, "schema": { "anyOf": [ { "type": "integer" }, { "type": "null" } ] } } ], "description": "Authorization and validation are enforced by the owning service.\n\nHEAD uses the GET handler and headers without a response body.", "x-handler": "get_structured_data_database_history", "x-source-file": "crates/synckhub-server/src/routes/structured_data.rs", "x-source-line": 62, "x-implicit-head": true, "responses": { "default": { "description": "Platform error; branch on HTTP status and stable code, not the human-readable message." } } } }, "/repos/{repo_id}/data/databases/{database_key}/tables": { "get": { "operationId": "platform_get__repos__repo_id__data_databases__database_key__tables", "summary": "get structured data tables", "tags": [ "structured_data" ], "parameters": [ { "name": "repo_id", "in": "path", "required": true, "schema": { "type": "string" } }, { "name": "database_key", "in": "path", "required": true, "schema": { "type": "string" } }, { "name": "include_archived", "in": "query", "required": false, "schema": { "type": "boolean" } } ], "description": "Authorization and validation are enforced by the owning service.", "x-handler": "get_structured_data_tables", "x-source-file": "crates/synckhub-server/src/routes/structured_data.rs", "x-source-line": 62, "responses": { "default": { "description": "Platform error; branch on HTTP status and stable code, not the human-readable message.", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } } }, "2XX": { "description": "Successful JSON response", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/synckhub_server.routes.structured_data.ListStructuredDataTablesResponse" } } } } } }, "head": { "operationId": "platform_head__repos__repo_id__data_databases__database_key__tables", "summary": "get structured data tables", "tags": [ "structured_data" ], "parameters": [ { "name": "repo_id", "in": "path", "required": true, "schema": { "type": "string" } }, { "name": "database_key", "in": "path", "required": true, "schema": { "type": "string" } }, { "name": "include_archived", "in": "query", "required": false, "schema": { "type": "boolean" } } ], "description": "Authorization and validation are enforced by the owning service.\n\nHEAD uses the GET handler and headers without a response body.", "x-handler": "get_structured_data_tables", "x-source-file": "crates/synckhub-server/src/routes/structured_data.rs", "x-source-line": 62, "x-implicit-head": true, "responses": { "default": { "description": "Platform error; branch on HTTP status and stable code, not the human-readable message." } } } }, "/repos/{repo_id}/data/databases/{database_key}/tables/{table_key}": { "put": { "operationId": "platform_put__repos__repo_id__data_databases__database_key__tables__table_key_", "summary": "put structured data table", "tags": [ "structured_data" ], "parameters": [ { "name": "repo_id", "in": "path", "required": true, "schema": { "type": "string" } }, { "name": "database_key", "in": "path", "required": true, "schema": { "type": "string" } }, { "name": "table_key", "in": "path", "required": true, "schema": { "type": "string" } } ], "description": "Authorization and validation are enforced by the owning service.", "x-handler": "put_structured_data_table", "x-source-file": "crates/synckhub-server/src/routes/structured_data.rs", "x-source-line": 62, "responses": { "default": { "description": "Platform error; branch on HTTP status and stable code, not the human-readable message.", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } } }, "2XX": { "description": "Successful JSON response", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/synckhub_server.routes.structured_data.StructuredDataTableResponse" } } } } }, "requestBody": { "required": true, "content": { "application/json": { "schema": { "$ref": "#/components/schemas/synckhub_server.routes.structured_data.PutStructuredDataTableRequest" } } } } }, "get": { "operationId": "platform_get__repos__repo_id__data_databases__database_key__tables__table_key_", "summary": "get structured data table", "tags": [ "structured_data" ], "parameters": [ { "name": "repo_id", "in": "path", "required": true, "schema": { "type": "string" } }, { "name": "database_key", "in": "path", "required": true, "schema": { "type": "string" } }, { "name": "table_key", "in": "path", "required": true, "schema": { "type": "string" } } ], "description": "Authorization and validation are enforced by the owning service.", "x-handler": "get_structured_data_table", "x-source-file": "crates/synckhub-server/src/routes/structured_data.rs", "x-source-line": 62, "responses": { "default": { "description": "Platform error; branch on HTTP status and stable code, not the human-readable message.", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } } }, "2XX": { "description": "Successful JSON response", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/synckhub_server.routes.structured_data.StructuredDataTableResponse" } } } } } }, "head": { "operationId": "platform_head__repos__repo_id__data_databases__database_key__tables__table_key_", "summary": "get structured data table", "tags": [ "structured_data" ], "parameters": [ { "name": "repo_id", "in": "path", "required": true, "schema": { "type": "string" } }, { "name": "database_key", "in": "path", "required": true, "schema": { "type": "string" } }, { "name": "table_key", "in": "path", "required": true, "schema": { "type": "string" } } ], "description": "Authorization and validation are enforced by the owning service.\n\nHEAD uses the GET handler and headers without a response body.", "x-handler": "get_structured_data_table", "x-source-file": "crates/synckhub-server/src/routes/structured_data.rs", "x-source-line": 62, "x-implicit-head": true, "responses": { "default": { "description": "Platform error; branch on HTTP status and stable code, not the human-readable message." } } } }, "/repos/{repo_id}/data/databases/{database_key}/tables/{table_key}/batch/upsert": { "post": { "operationId": "platform_post__repos__repo_id__data_databases__database_key__tables__table_key__batch_upsert", "summary": "batch upsert structured data records", "tags": [ "structured_data" ], "parameters": [ { "name": "repo_id", "in": "path", "required": true, "schema": { "type": "string" } }, { "name": "database_key", "in": "path", "required": true, "schema": { "type": "string" } }, { "name": "table_key", "in": "path", "required": true, "schema": { "type": "string" } } ], "description": "Authorization and validation are enforced by the owning service.", "x-handler": "batch_upsert_structured_data_records", "x-source-file": "crates/synckhub-server/src/routes/structured_data.rs", "x-source-line": 62, "responses": { "default": { "description": "Platform error; branch on HTTP status and stable code, not the human-readable message.", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } } }, "2XX": { "description": "Successful JSON response", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/synckhub_server.routes.structured_data.BatchUpsertStructuredDataRecordsResponse" } } } } }, "requestBody": { "required": true, "content": { "application/json": { "schema": { "$ref": "#/components/schemas/synckhub_server.routes.structured_data.BatchUpsertStructuredDataRecordsRequest" } } } } } }, "/repos/{repo_id}/data/databases/{database_key}/tables/{table_key}/history": { "get": { "operationId": "platform_get__repos__repo_id__data_databases__database_key__tables__table_key__history", "summary": "get structured data table history", "tags": [ "structured_data" ], "parameters": [ { "name": "repo_id", "in": "path", "required": true, "schema": { "type": "string" } }, { "name": "database_key", "in": "path", "required": true, "schema": { "type": "string" } }, { "name": "table_key", "in": "path", "required": true, "schema": { "type": "string" } }, { "name": "limit", "in": "query", "required": false, "schema": { "anyOf": [ { "type": "integer" }, { "type": "null" } ] } } ], "description": "Authorization and validation are enforced by the owning service.", "x-handler": "get_structured_data_table_history", "x-source-file": "crates/synckhub-server/src/routes/structured_data.rs", "x-source-line": 62, "responses": { "default": { "description": "Platform error; branch on HTTP status and stable code, not the human-readable message.", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } } }, "2XX": { "description": "Successful JSON response", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/synckhub_server.routes.structured_data.ListStructuredDataHistoryResponse" } } } } } }, "head": { "operationId": "platform_head__repos__repo_id__data_databases__database_key__tables__table_key__history", "summary": "get structured data table history", "tags": [ "structured_data" ], "parameters": [ { "name": "repo_id", "in": "path", "required": true, "schema": { "type": "string" } }, { "name": "database_key", "in": "path", "required": true, "schema": { "type": "string" } }, { "name": "table_key", "in": "path", "required": true, "schema": { "type": "string" } }, { "name": "limit", "in": "query", "required": false, "schema": { "anyOf": [ { "type": "integer" }, { "type": "null" } ] } } ], "description": "Authorization and validation are enforced by the owning service.\n\nHEAD uses the GET handler and headers without a response body.", "x-handler": "get_structured_data_table_history", "x-source-file": "crates/synckhub-server/src/routes/structured_data.rs", "x-source-line": 62, "x-implicit-head": true, "responses": { "default": { "description": "Platform error; branch on HTTP status and stable code, not the human-readable message." } } } }, "/repos/{repo_id}/data/databases/{database_key}/tables/{table_key}/query": { "post": { "operationId": "platform_post__repos__repo_id__data_databases__database_key__tables__table_key__query", "summary": "query structured data records", "tags": [ "structured_data" ], "parameters": [ { "name": "repo_id", "in": "path", "required": true, "schema": { "type": "string" } }, { "name": "database_key", "in": "path", "required": true, "schema": { "type": "string" } }, { "name": "table_key", "in": "path", "required": true, "schema": { "type": "string" } } ], "description": "Authorization and validation are enforced by the owning service.", "x-handler": "query_structured_data_records", "x-source-file": "crates/synckhub-server/src/routes/structured_data.rs", "x-source-line": 62, "responses": { "default": { "description": "Platform error; branch on HTTP status and stable code, not the human-readable message.", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } } }, "2XX": { "description": "Successful JSON response", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/synckhub_server.routes.structured_data.QueryStructuredDataRecordsResponse" } } } } }, "requestBody": { "required": true, "content": { "application/json": { "schema": { "$ref": "#/components/schemas/synckhub_server.routes.structured_data.QueryStructuredDataRecordsRequest" } } } } } }, "/repos/{repo_id}/data/databases/{database_key}/tables/{table_key}/records": { "post": { "operationId": "platform_post__repos__repo_id__data_databases__database_key__tables__table_key__records", "summary": "create structured data record", "tags": [ "structured_data" ], "parameters": [ { "name": "repo_id", "in": "path", "required": true, "schema": { "type": "string" } }, { "name": "database_key", "in": "path", "required": true, "schema": { "type": "string" } }, { "name": "table_key", "in": "path", "required": true, "schema": { "type": "string" } } ], "description": "Authorization and validation are enforced by the owning service.", "x-handler": "create_structured_data_record", "x-source-file": "crates/synckhub-server/src/routes/structured_data.rs", "x-source-line": 62, "responses": { "default": { "description": "Platform error; branch on HTTP status and stable code, not the human-readable message.", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } } }, "2XX": { "description": "Successful JSON response", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/synckhub_server.routes.structured_data.StructuredDataRecordResponse" } } } } }, "requestBody": { "required": true, "content": { "application/json": { "schema": { "$ref": "#/components/schemas/synckhub_server.routes.structured_data.CreateStructuredDataRecordRequest" } } } } } }, "/repos/{repo_id}/data/databases/{database_key}/tables/{table_key}/records/{record_id}": { "put": { "operationId": "platform_put__repos__repo_id__data_databases__database_key__tables__table_key__records__record_id_", "summary": "put structured data record", "tags": [ "structured_data" ], "parameters": [ { "name": "repo_id", "in": "path", "required": true, "schema": { "type": "string" } }, { "name": "database_key", "in": "path", "required": true, "schema": { "type": "string" } }, { "name": "table_key", "in": "path", "required": true, "schema": { "type": "string" } }, { "name": "record_id", "in": "path", "required": true, "schema": { "type": "string" } } ], "description": "Authorization and validation are enforced by the owning service.", "x-handler": "put_structured_data_record", "x-source-file": "crates/synckhub-server/src/routes/structured_data.rs", "x-source-line": 62, "responses": { "default": { "description": "Platform error; branch on HTTP status and stable code, not the human-readable message.", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } } }, "2XX": { "description": "Successful JSON response", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/synckhub_server.routes.structured_data.StructuredDataRecordResponse" } } } } }, "requestBody": { "required": true, "content": { "application/json": { "schema": { "$ref": "#/components/schemas/synckhub_server.routes.structured_data.PutStructuredDataRecordRequest" } } } } }, "get": { "operationId": "platform_get__repos__repo_id__data_databases__database_key__tables__table_key__records__record_id_", "summary": "get structured data record", "tags": [ "structured_data" ], "parameters": [ { "name": "repo_id", "in": "path", "required": true, "schema": { "type": "string" } }, { "name": "database_key", "in": "path", "required": true, "schema": { "type": "string" } }, { "name": "table_key", "in": "path", "required": true, "schema": { "type": "string" } }, { "name": "record_id", "in": "path", "required": true, "schema": { "type": "string" } } ], "description": "Authorization and validation are enforced by the owning service.", "x-handler": "get_structured_data_record", "x-source-file": "crates/synckhub-server/src/routes/structured_data.rs", "x-source-line": 62, "responses": { "default": { "description": "Platform error; branch on HTTP status and stable code, not the human-readable message.", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } } }, "2XX": { "description": "Successful JSON response", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/synckhub_server.routes.structured_data.StructuredDataRecordResponse" } } } } } }, "head": { "operationId": "platform_head__repos__repo_id__data_databases__database_key__tables__table_key__records__record_id_", "summary": "get structured data record", "tags": [ "structured_data" ], "parameters": [ { "name": "repo_id", "in": "path", "required": true, "schema": { "type": "string" } }, { "name": "database_key", "in": "path", "required": true, "schema": { "type": "string" } }, { "name": "table_key", "in": "path", "required": true, "schema": { "type": "string" } }, { "name": "record_id", "in": "path", "required": true, "schema": { "type": "string" } } ], "description": "Authorization and validation are enforced by the owning service.\n\nHEAD uses the GET handler and headers without a response body.", "x-handler": "get_structured_data_record", "x-source-file": "crates/synckhub-server/src/routes/structured_data.rs", "x-source-line": 62, "x-implicit-head": true, "responses": { "default": { "description": "Platform error; branch on HTTP status and stable code, not the human-readable message." } } } }, "/repos/{repo_id}/data/databases/{database_key}/tables/{table_key}/records/{record_id}/comments": { "post": { "operationId": "platform_post__repos__repo_id__data_databases__database_key__tables__table_key__records__record_id__comments", "summary": "create structured data record comment", "tags": [ "structured_data" ], "parameters": [ { "name": "repo_id", "in": "path", "required": true, "schema": { "type": "string" } }, { "name": "database_key", "in": "path", "required": true, "schema": { "type": "string" } }, { "name": "table_key", "in": "path", "required": true, "schema": { "type": "string" } }, { "name": "record_id", "in": "path", "required": true, "schema": { "type": "string" } } ], "description": "Authorization and validation are enforced by the owning service.", "x-handler": "create_structured_data_record_comment", "x-source-file": "crates/synckhub-server/src/routes/structured_data.rs", "x-source-line": 62, "responses": { "default": { "description": "Platform error; branch on HTTP status and stable code, not the human-readable message.", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } } }, "2XX": { "description": "Successful JSON response", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/synckhub_server.routes.structured_data.StructuredDataRecordCommentResponse" } } } } }, "requestBody": { "required": true, "content": { "application/json": { "schema": { "$ref": "#/components/schemas/synckhub_server.routes.structured_data.CreateStructuredDataRecordCommentRequest" } } } } }, "get": { "operationId": "platform_get__repos__repo_id__data_databases__database_key__tables__table_key__records__record_id__comments", "summary": "get structured data record comments", "tags": [ "structured_data" ], "parameters": [ { "name": "repo_id", "in": "path", "required": true, "schema": { "type": "string" } }, { "name": "database_key", "in": "path", "required": true, "schema": { "type": "string" } }, { "name": "table_key", "in": "path", "required": true, "schema": { "type": "string" } }, { "name": "record_id", "in": "path", "required": true, "schema": { "type": "string" } } ], "description": "Authorization and validation are enforced by the owning service.", "x-handler": "get_structured_data_record_comments", "x-source-file": "crates/synckhub-server/src/routes/structured_data.rs", "x-source-line": 62, "responses": { "default": { "description": "Platform error; branch on HTTP status and stable code, not the human-readable message.", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } } }, "2XX": { "description": "Successful JSON response", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/synckhub_server.routes.structured_data.ListStructuredDataRecordCommentsResponse" } } } } } }, "head": { "operationId": "platform_head__repos__repo_id__data_databases__database_key__tables__table_key__records__record_id__comments", "summary": "get structured data record comments", "tags": [ "structured_data" ], "parameters": [ { "name": "repo_id", "in": "path", "required": true, "schema": { "type": "string" } }, { "name": "database_key", "in": "path", "required": true, "schema": { "type": "string" } }, { "name": "table_key", "in": "path", "required": true, "schema": { "type": "string" } }, { "name": "record_id", "in": "path", "required": true, "schema": { "type": "string" } } ], "description": "Authorization and validation are enforced by the owning service.\n\nHEAD uses the GET handler and headers without a response body.", "x-handler": "get_structured_data_record_comments", "x-source-file": "crates/synckhub-server/src/routes/structured_data.rs", "x-source-line": 62, "x-implicit-head": true, "responses": { "default": { "description": "Platform error; branch on HTTP status and stable code, not the human-readable message." } } } }, "/repos/{repo_id}/data/databases/{database_key}/tables/{table_key}/records/{record_id}/history": { "get": { "operationId": "platform_get__repos__repo_id__data_databases__database_key__tables__table_key__records__record_id__history", "summary": "get structured data record history", "tags": [ "structured_data" ], "parameters": [ { "name": "repo_id", "in": "path", "required": true, "schema": { "type": "string" } }, { "name": "database_key", "in": "path", "required": true, "schema": { "type": "string" } }, { "name": "table_key", "in": "path", "required": true, "schema": { "type": "string" } }, { "name": "record_id", "in": "path", "required": true, "schema": { "type": "string" } }, { "name": "limit", "in": "query", "required": false, "schema": { "anyOf": [ { "type": "integer" }, { "type": "null" } ] } } ], "description": "Authorization and validation are enforced by the owning service.", "x-handler": "get_structured_data_record_history", "x-source-file": "crates/synckhub-server/src/routes/structured_data.rs", "x-source-line": 62, "responses": { "default": { "description": "Platform error; branch on HTTP status and stable code, not the human-readable message.", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } } }, "2XX": { "description": "Successful JSON response", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/synckhub_server.routes.structured_data.ListStructuredDataHistoryResponse" } } } } } }, "head": { "operationId": "platform_head__repos__repo_id__data_databases__database_key__tables__table_key__records__record_id__history", "summary": "get structured data record history", "tags": [ "structured_data" ], "parameters": [ { "name": "repo_id", "in": "path", "required": true, "schema": { "type": "string" } }, { "name": "database_key", "in": "path", "required": true, "schema": { "type": "string" } }, { "name": "table_key", "in": "path", "required": true, "schema": { "type": "string" } }, { "name": "record_id", "in": "path", "required": true, "schema": { "type": "string" } }, { "name": "limit", "in": "query", "required": false, "schema": { "anyOf": [ { "type": "integer" }, { "type": "null" } ] } } ], "description": "Authorization and validation are enforced by the owning service.\n\nHEAD uses the GET handler and headers without a response body.", "x-handler": "get_structured_data_record_history", "x-source-file": "crates/synckhub-server/src/routes/structured_data.rs", "x-source-line": 62, "x-implicit-head": true, "responses": { "default": { "description": "Platform error; branch on HTTP status and stable code, not the human-readable message." } } } }, "/repos/{repo_id}/derived/ai-search/generations/start": { "post": { "operationId": "platform_post__repos__repo_id__derived_ai_search_generations_start", "summary": "ai search start generation", "tags": [ "ai · indexing" ], "parameters": [ { "name": "repo_id", "in": "path", "required": true, "schema": { "type": "string" } } ], "description": "Authorization and validation are enforced by the owning service.", "x-handler": "ai_search_start_generation", "x-source-file": "crates/synckhub-server/src/routes/ai/indexing.rs", "x-source-line": 7, "responses": { "default": { "description": "Platform error; branch on HTTP status and stable code, not the human-readable message.", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } } }, "2XX": { "description": "Successful JSON response", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/synckhub_server.routes.ai.indexing.AiSearchStartGenerationResponse" } } } } }, "requestBody": { "required": true, "content": { "application/json": { "schema": { "$ref": "#/components/schemas/synckhub_server.routes.ai.indexing.AiSearchStartGenerationRequest" } } } } } }, "/repos/{repo_id}/derived/ai-search/generations/stop": { "post": { "operationId": "platform_post__repos__repo_id__derived_ai_search_generations_stop", "summary": "ai search stop generation", "tags": [ "ai · indexing" ], "parameters": [ { "name": "repo_id", "in": "path", "required": true, "schema": { "type": "string" } } ], "description": "Authorization and validation are enforced by the owning service.", "x-handler": "ai_search_stop_generation", "x-source-file": "crates/synckhub-server/src/routes/ai/indexing.rs", "x-source-line": 7, "responses": { "default": { "description": "Platform error; branch on HTTP status and stable code, not the human-readable message.", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } } }, "2XX": { "description": "Successful JSON response", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/synckhub_server.routes.ai.indexing.AiSearchStopGenerationResponse" } } } } }, "requestBody": { "required": true, "content": { "application/json": { "schema": { "$ref": "#/components/schemas/synckhub_server.routes.ai.indexing.AiSearchStopGenerationRequest" } } } } } }, "/repos/{repo_id}/derived/ai-search/status": { "get": { "operationId": "platform_get__repos__repo_id__derived_ai_search_status", "summary": "ai search get status", "tags": [ "ai · indexing" ], "parameters": [ { "name": "repo_id", "in": "path", "required": true, "schema": { "type": "string" } } ], "description": "Authorization and validation are enforced by the owning service.", "x-handler": "ai_search_get_status", "x-source-file": "crates/synckhub-server/src/routes/ai/indexing.rs", "x-source-line": 7, "responses": { "default": { "description": "Platform error; branch on HTTP status and stable code, not the human-readable message.", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } } }, "2XX": { "description": "Successful JSON response", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/synckhub_server.routes.ai.indexing.AiSearchGenerationStatusResponse" } } } } } }, "head": { "operationId": "platform_head__repos__repo_id__derived_ai_search_status", "summary": "ai search get status", "tags": [ "ai · indexing" ], "parameters": [ { "name": "repo_id", "in": "path", "required": true, "schema": { "type": "string" } } ], "description": "Authorization and validation are enforced by the owning service.\n\nHEAD uses the GET handler and headers without a response body.", "x-handler": "ai_search_get_status", "x-source-file": "crates/synckhub-server/src/routes/ai/indexing.rs", "x-source-line": 7, "x-implicit-head": true, "responses": { "default": { "description": "Platform error; branch on HTTP status and stable code, not the human-readable message." } } } }, "/repos/{repo_id}/derived/ai-search/tasks/{item_id}/content": { "get": { "operationId": "platform_get__repos__repo_id__derived_ai_search_tasks__item_id__content", "summary": "ai search get task content", "tags": [ "ai · indexing" ], "parameters": [ { "name": "repo_id", "in": "path", "required": true, "schema": { "type": "string" } }, { "name": "item_id", "in": "path", "required": true, "schema": { "type": "string" } }, { "name": "generation_id", "in": "query", "required": true, "schema": { "type": "string" } }, { "name": "claimed_desired_repo_seq", "in": "query", "required": true, "schema": { "type": "integer" } }, { "name": "source_id", "in": "query", "required": false, "schema": { "anyOf": [ { "type": "string" }, { "type": "null" } ] } }, { "name": "content_item_seq", "in": "query", "required": false, "schema": { "anyOf": [ { "type": "integer" }, { "type": "null" } ] } } ], "description": "Authorization and validation are enforced by the owning service.", "x-handler": "ai_search_get_task_content", "x-source-file": "crates/synckhub-server/src/routes/ai/indexing.rs", "x-source-line": 7, "responses": { "default": { "description": "Platform error; branch on HTTP status and stable code, not the human-readable message.", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } } } } }, "head": { "operationId": "platform_head__repos__repo_id__derived_ai_search_tasks__item_id__content", "summary": "ai search get task content", "tags": [ "ai · indexing" ], "parameters": [ { "name": "repo_id", "in": "path", "required": true, "schema": { "type": "string" } }, { "name": "item_id", "in": "path", "required": true, "schema": { "type": "string" } }, { "name": "generation_id", "in": "query", "required": true, "schema": { "type": "string" } }, { "name": "claimed_desired_repo_seq", "in": "query", "required": true, "schema": { "type": "integer" } }, { "name": "source_id", "in": "query", "required": false, "schema": { "anyOf": [ { "type": "string" }, { "type": "null" } ] } }, { "name": "content_item_seq", "in": "query", "required": false, "schema": { "anyOf": [ { "type": "integer" }, { "type": "null" } ] } } ], "description": "Authorization and validation are enforced by the owning service.\n\nHEAD uses the GET handler and headers without a response body.", "x-handler": "ai_search_get_task_content", "x-source-file": "crates/synckhub-server/src/routes/ai/indexing.rs", "x-source-line": 7, "x-implicit-head": true, "responses": { "default": { "description": "Platform error; branch on HTTP status and stable code, not the human-readable message." } } } }, "/repos/{repo_id}/derived/ai-search/tasks/{item_id}/sources": { "get": { "operationId": "platform_get__repos__repo_id__derived_ai_search_tasks__item_id__sources", "summary": "ai search get task sources", "tags": [ "ai · indexing" ], "parameters": [ { "name": "repo_id", "in": "path", "required": true, "schema": { "type": "string" } }, { "name": "item_id", "in": "path", "required": true, "schema": { "type": "string" } }, { "name": "generation_id", "in": "query", "required": true, "schema": { "type": "string" } }, { "name": "claimed_desired_repo_seq", "in": "query", "required": true, "schema": { "type": "integer" } }, { "name": "cursor", "in": "query", "required": true, "schema": { "type": "string" } } ], "description": "Authorization and validation are enforced by the owning service.", "x-handler": "ai_search_get_task_sources", "x-source-file": "crates/synckhub-server/src/routes/ai/indexing.rs", "x-source-line": 7, "responses": { "default": { "description": "Platform error; branch on HTTP status and stable code, not the human-readable message.", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } } }, "2XX": { "description": "Successful JSON response", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/synckhub_server.routes.ai.indexing.AiSearchContentSourcesPageResponse" } } } } } }, "head": { "operationId": "platform_head__repos__repo_id__derived_ai_search_tasks__item_id__sources", "summary": "ai search get task sources", "tags": [ "ai · indexing" ], "parameters": [ { "name": "repo_id", "in": "path", "required": true, "schema": { "type": "string" } }, { "name": "item_id", "in": "path", "required": true, "schema": { "type": "string" } }, { "name": "generation_id", "in": "query", "required": true, "schema": { "type": "string" } }, { "name": "claimed_desired_repo_seq", "in": "query", "required": true, "schema": { "type": "integer" } }, { "name": "cursor", "in": "query", "required": true, "schema": { "type": "string" } } ], "description": "Authorization and validation are enforced by the owning service.\n\nHEAD uses the GET handler and headers without a response body.", "x-handler": "ai_search_get_task_sources", "x-source-file": "crates/synckhub-server/src/routes/ai/indexing.rs", "x-source-line": 7, "x-implicit-head": true, "responses": { "default": { "description": "Platform error; branch on HTTP status and stable code, not the human-readable message." } } } }, "/repos/{repo_id}/derived/ai-search/tasks/claim": { "post": { "operationId": "platform_post__repos__repo_id__derived_ai_search_tasks_claim", "summary": "ai search claim tasks", "tags": [ "ai · indexing" ], "parameters": [ { "name": "repo_id", "in": "path", "required": true, "schema": { "type": "string" } } ], "description": "Authorization and validation are enforced by the owning service.", "x-handler": "ai_search_claim_tasks", "x-source-file": "crates/synckhub-server/src/routes/ai/indexing.rs", "x-source-line": 7, "responses": { "default": { "description": "Platform error; branch on HTTP status and stable code, not the human-readable message.", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } } }, "2XX": { "description": "Successful JSON response", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/synckhub_server.routes.ai.indexing.AiSearchClaimTasksResponse" } } } } }, "requestBody": { "required": true, "content": { "application/json": { "schema": { "$ref": "#/components/schemas/synckhub_server.routes.ai.indexing.AiSearchClaimTasksRequest" } } } } } }, "/repos/{repo_id}/derived/ai-search/tasks/complete": { "post": { "operationId": "platform_post__repos__repo_id__derived_ai_search_tasks_complete", "summary": "ai search complete tasks", "tags": [ "ai · indexing" ], "parameters": [ { "name": "repo_id", "in": "path", "required": true, "schema": { "type": "string" } } ], "description": "Authorization and validation are enforced by the owning service.", "x-handler": "ai_search_complete_tasks", "x-source-file": "crates/synckhub-server/src/routes/ai/indexing.rs", "x-source-line": 7, "responses": { "default": { "description": "Platform error; branch on HTTP status and stable code, not the human-readable message.", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } } }, "2XX": { "description": "Successful JSON response", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/synckhub_server.routes.ai.indexing.AiSearchCompleteTasksResponse" } } } } }, "requestBody": { "required": true, "content": { "application/json": { "schema": { "$ref": "#/components/schemas/synckhub_server.routes.ai.indexing.AiSearchCompleteTasksRequest" } } } } } }, "/repos/{repo_id}/desktop-sync/v1/admission": { "get": { "operationId": "platform_get__repos__repo_id__desktop_sync_v1_admission", "summary": "company admission", "tags": [ "desktop_sync" ], "parameters": [ { "name": "repo_id", "in": "path", "required": true, "schema": { "type": "string" } } ], "description": "Authorization and validation are enforced by the owning service.", "x-handler": "company_admission", "x-source-file": "crates/synckhub-server/src/routes/desktop_sync.rs", "x-source-line": 1108, "responses": { "default": { "description": "Platform error; branch on HTTP status and stable code, not the human-readable message.", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } } } } }, "head": { "operationId": "platform_head__repos__repo_id__desktop_sync_v1_admission", "summary": "company admission", "tags": [ "desktop_sync" ], "parameters": [ { "name": "repo_id", "in": "path", "required": true, "schema": { "type": "string" } } ], "description": "Authorization and validation are enforced by the owning service.\n\nHEAD uses the GET handler and headers without a response body.", "x-handler": "company_admission", "x-source-file": "crates/synckhub-server/src/routes/desktop_sync.rs", "x-source-line": 1108, "x-implicit-head": true, "responses": { "default": { "description": "Platform error; branch on HTTP status and stable code, not the human-readable message." } } } }, "/repos/{repo_id}/desktop-sync/v1/checkpoint": { "get": { "operationId": "platform_get__repos__repo_id__desktop_sync_v1_checkpoint", "summary": "company checkpoint", "tags": [ "desktop_sync" ], "parameters": [ { "name": "repo_id", "in": "path", "required": true, "schema": { "type": "string" } }, { "name": "after_authz_seq", "in": "query", "required": false, "schema": { "anyOf": [ { "type": "integer" }, { "type": "null" } ] } }, { "name": "folder_authority_refresh", "in": "query", "required": false, "schema": { "type": "boolean" } } ], "description": "Authorization and validation are enforced by the owning service.", "x-handler": "company_checkpoint", "x-source-file": "crates/synckhub-server/src/routes/desktop_sync.rs", "x-source-line": 1108, "responses": { "default": { "description": "Platform error; branch on HTTP status and stable code, not the human-readable message.", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } } }, "2XX": { "description": "Successful JSON response", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/synckhub_server.routes.desktop_sync.CheckpointResponse" } } } } } }, "head": { "operationId": "platform_head__repos__repo_id__desktop_sync_v1_checkpoint", "summary": "company checkpoint", "tags": [ "desktop_sync" ], "parameters": [ { "name": "repo_id", "in": "path", "required": true, "schema": { "type": "string" } }, { "name": "after_authz_seq", "in": "query", "required": false, "schema": { "anyOf": [ { "type": "integer" }, { "type": "null" } ] } }, { "name": "folder_authority_refresh", "in": "query", "required": false, "schema": { "type": "boolean" } } ], "description": "Authorization and validation are enforced by the owning service.\n\nHEAD uses the GET handler and headers without a response body.", "x-handler": "company_checkpoint", "x-source-file": "crates/synckhub-server/src/routes/desktop_sync.rs", "x-source-line": 1108, "x-implicit-head": true, "responses": { "default": { "description": "Platform error; branch on HTTP status and stable code, not the human-readable message." } } } }, "/repos/{repo_id}/desktop-sync/v1/children": { "get": { "operationId": "platform_get__repos__repo_id__desktop_sync_v1_children", "summary": "company children", "tags": [ "desktop_sync" ], "parameters": [ { "name": "repo_id", "in": "path", "required": true, "schema": { "type": "string" } }, { "name": "parent_item_id", "in": "query", "required": false, "schema": { "anyOf": [ { "type": "string", "format": "uuid" }, { "type": "null" } ] } }, { "name": "after_name_key", "in": "query", "required": false, "schema": { "anyOf": [ { "type": "string" }, { "type": "null" } ] } }, { "name": "after_item_id", "in": "query", "required": false, "schema": { "anyOf": [ { "type": "string", "format": "uuid" }, { "type": "null" } ] } }, { "name": "applied_common_version", "in": "query", "required": true, "schema": { "type": "integer" } }, { "name": "common_materializer_version", "in": "query", "required": true, "schema": { "type": "integer" } }, { "name": "after_authz_seq", "in": "query", "required": true, "schema": { "type": "integer" } } ], "description": "Authorization and validation are enforced by the owning service.", "x-handler": "company_children", "x-source-file": "crates/synckhub-server/src/routes/desktop_sync.rs", "x-source-line": 1108, "responses": { "default": { "description": "Platform error; branch on HTTP status and stable code, not the human-readable message.", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } } }, "2XX": { "description": "Successful JSON response", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/synckhub_server.routes.desktop_sync.ChildrenResponse" } } } } } }, "head": { "operationId": "platform_head__repos__repo_id__desktop_sync_v1_children", "summary": "company children", "tags": [ "desktop_sync" ], "parameters": [ { "name": "repo_id", "in": "path", "required": true, "schema": { "type": "string" } }, { "name": "parent_item_id", "in": "query", "required": false, "schema": { "anyOf": [ { "type": "string", "format": "uuid" }, { "type": "null" } ] } }, { "name": "after_name_key", "in": "query", "required": false, "schema": { "anyOf": [ { "type": "string" }, { "type": "null" } ] } }, { "name": "after_item_id", "in": "query", "required": false, "schema": { "anyOf": [ { "type": "string", "format": "uuid" }, { "type": "null" } ] } }, { "name": "applied_common_version", "in": "query", "required": true, "schema": { "type": "integer" } }, { "name": "common_materializer_version", "in": "query", "required": true, "schema": { "type": "integer" } }, { "name": "after_authz_seq", "in": "query", "required": true, "schema": { "type": "integer" } } ], "description": "Authorization and validation are enforced by the owning service.\n\nHEAD uses the GET handler and headers without a response body.", "x-handler": "company_children", "x-source-file": "crates/synckhub-server/src/routes/desktop_sync.rs", "x-source-line": 1108, "x-implicit-head": true, "responses": { "default": { "description": "Platform error; branch on HTTP status and stable code, not the human-readable message." } } } }, "/repos/{repo_id}/desktop-sync/v1/children-batch": { "post": { "operationId": "platform_post__repos__repo_id__desktop_sync_v1_children_batch", "summary": "company children batch", "tags": [ "desktop_sync" ], "parameters": [ { "name": "repo_id", "in": "path", "required": true, "schema": { "type": "string" } }, { "name": "parent_item_id", "in": "query", "required": false, "schema": { "anyOf": [ { "type": "string", "format": "uuid" }, { "type": "null" } ] } }, { "name": "after_name_key", "in": "query", "required": false, "schema": { "anyOf": [ { "type": "string" }, { "type": "null" } ] } }, { "name": "after_item_id", "in": "query", "required": false, "schema": { "anyOf": [ { "type": "string", "format": "uuid" }, { "type": "null" } ] } }, { "name": "applied_common_version", "in": "query", "required": true, "schema": { "type": "integer" } }, { "name": "common_materializer_version", "in": "query", "required": true, "schema": { "type": "integer" } }, { "name": "after_authz_seq", "in": "query", "required": true, "schema": { "type": "integer" } } ], "description": "Authorization and validation are enforced by the owning service.", "x-handler": "company_children_batch", "x-source-file": "crates/synckhub-server/src/routes/desktop_sync.rs", "x-source-line": 1108, "responses": { "default": { "description": "Platform error; branch on HTTP status and stable code, not the human-readable message.", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } } }, "2XX": { "description": "Successful JSON response", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/synckhub_server.routes.desktop_sync.ChildrenBatchResponse" } } } } }, "requestBody": { "required": true, "content": { "application/json": { "schema": { "$ref": "#/components/schemas/synckhub_server.routes.desktop_sync.ChildrenBatchRequest" } } } } } }, "/repos/{repo_id}/desktop-sync/v1/feed": { "get": { "operationId": "platform_get__repos__repo_id__desktop_sync_v1_feed", "summary": "company feed", "tags": [ "desktop_sync" ], "parameters": [ { "name": "repo_id", "in": "path", "required": true, "schema": { "type": "string" } }, { "name": "after_repo_seq", "in": "query", "required": true, "schema": { "type": "integer" } }, { "name": "after_event_idx", "in": "query", "required": true, "schema": { "type": "integer" } }, { "name": "applied_common_version", "in": "query", "required": true, "schema": { "type": "integer" } }, { "name": "common_materializer_version", "in": "query", "required": true, "schema": { "type": "integer" } }, { "name": "after_authz_seq", "in": "query", "required": true, "schema": { "type": "integer" } } ], "description": "Authorization and validation are enforced by the owning service.", "x-handler": "company_feed", "x-source-file": "crates/synckhub-server/src/routes/desktop_sync.rs", "x-source-line": 1108, "responses": { "default": { "description": "Platform error; branch on HTTP status and stable code, not the human-readable message.", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } } }, "2XX": { "description": "Successful JSON response", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/synckhub_server.routes.desktop_sync.FeedResponse" } } } } } }, "head": { "operationId": "platform_head__repos__repo_id__desktop_sync_v1_feed", "summary": "company feed", "tags": [ "desktop_sync" ], "parameters": [ { "name": "repo_id", "in": "path", "required": true, "schema": { "type": "string" } }, { "name": "after_repo_seq", "in": "query", "required": true, "schema": { "type": "integer" } }, { "name": "after_event_idx", "in": "query", "required": true, "schema": { "type": "integer" } }, { "name": "applied_common_version", "in": "query", "required": true, "schema": { "type": "integer" } }, { "name": "common_materializer_version", "in": "query", "required": true, "schema": { "type": "integer" } }, { "name": "after_authz_seq", "in": "query", "required": true, "schema": { "type": "integer" } } ], "description": "Authorization and validation are enforced by the owning service.\n\nHEAD uses the GET handler and headers without a response body.", "x-handler": "company_feed", "x-source-file": "crates/synckhub-server/src/routes/desktop_sync.rs", "x-source-line": 1108, "x-implicit-head": true, "responses": { "default": { "description": "Platform error; branch on HTTP status and stable code, not the human-readable message." } } } }, "/repos/{repo_id}/desktop-sync/v1/realtime": { "get": { "operationId": "platform_get__repos__repo_id__desktop_sync_v1_realtime", "summary": "company realtime", "tags": [ "desktop_sync" ], "parameters": [ { "name": "repo_id", "in": "path", "required": true, "schema": { "type": "string" } } ], "description": "Authorization and validation are enforced by the owning service.", "x-handler": "company_realtime", "x-source-file": "crates/synckhub-server/src/routes/desktop_sync.rs", "x-source-line": 1108, "responses": { "default": { "description": "Platform error; branch on HTTP status and stable code, not the human-readable message.", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } } } } }, "head": { "operationId": "platform_head__repos__repo_id__desktop_sync_v1_realtime", "summary": "company realtime", "tags": [ "desktop_sync" ], "parameters": [ { "name": "repo_id", "in": "path", "required": true, "schema": { "type": "string" } } ], "description": "Authorization and validation are enforced by the owning service.\n\nHEAD uses the GET handler and headers without a response body.", "x-handler": "company_realtime", "x-source-file": "crates/synckhub-server/src/routes/desktop_sync.rs", "x-source-line": 1108, "x-implicit-head": true, "responses": { "default": { "description": "Platform error; branch on HTTP status and stable code, not the human-readable message." } } } }, "/repos/{repo_id}/desktop-sync/v1/roots": { "post": { "operationId": "platform_post__repos__repo_id__desktop_sync_v1_roots", "summary": "company roots", "tags": [ "desktop_sync" ], "parameters": [ { "name": "repo_id", "in": "path", "required": true, "schema": { "type": "string" } }, { "name": "kind", "in": "query", "required": true, "schema": { "type": "string" } }, { "name": "offset", "in": "query", "required": false, "schema": { "anyOf": [ { "type": "integer", "minimum": 0 }, { "type": "null" } ] } }, { "name": "applied_common_version", "in": "query", "required": true, "schema": { "type": "integer" } }, { "name": "common_materializer_version", "in": "query", "required": true, "schema": { "type": "integer" } }, { "name": "after_authz_seq", "in": "query", "required": true, "schema": { "type": "integer" } } ], "description": "Authorization and validation are enforced by the owning service.", "x-handler": "company_roots", "x-source-file": "crates/synckhub-server/src/routes/desktop_sync.rs", "x-source-line": 1108, "responses": { "default": { "description": "Platform error; branch on HTTP status and stable code, not the human-readable message.", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } } }, "2XX": { "description": "Successful JSON response", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/synckhub_server.routes.desktop_sync.RootsResponse" } } } } } }, "get": { "operationId": "platform_get__repos__repo_id__desktop_sync_v1_roots", "summary": "company roots", "tags": [ "desktop_sync" ], "parameters": [ { "name": "repo_id", "in": "path", "required": true, "schema": { "type": "string" } }, { "name": "kind", "in": "query", "required": true, "schema": { "type": "string" } }, { "name": "offset", "in": "query", "required": false, "schema": { "anyOf": [ { "type": "integer", "minimum": 0 }, { "type": "null" } ] } }, { "name": "applied_common_version", "in": "query", "required": true, "schema": { "type": "integer" } }, { "name": "common_materializer_version", "in": "query", "required": true, "schema": { "type": "integer" } }, { "name": "after_authz_seq", "in": "query", "required": true, "schema": { "type": "integer" } } ], "description": "Authorization and validation are enforced by the owning service.", "x-handler": "company_roots", "x-source-file": "crates/synckhub-server/src/routes/desktop_sync.rs", "x-source-line": 1108, "responses": { "default": { "description": "Platform error; branch on HTTP status and stable code, not the human-readable message.", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } } }, "2XX": { "description": "Successful JSON response", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/synckhub_server.routes.desktop_sync.RootsResponse" } } } } } }, "head": { "operationId": "platform_head__repos__repo_id__desktop_sync_v1_roots", "summary": "company roots", "tags": [ "desktop_sync" ], "parameters": [ { "name": "repo_id", "in": "path", "required": true, "schema": { "type": "string" } }, { "name": "kind", "in": "query", "required": true, "schema": { "type": "string" } }, { "name": "offset", "in": "query", "required": false, "schema": { "anyOf": [ { "type": "integer", "minimum": 0 }, { "type": "null" } ] } }, { "name": "applied_common_version", "in": "query", "required": true, "schema": { "type": "integer" } }, { "name": "common_materializer_version", "in": "query", "required": true, "schema": { "type": "integer" } }, { "name": "after_authz_seq", "in": "query", "required": true, "schema": { "type": "integer" } } ], "description": "Authorization and validation are enforced by the owning service.\n\nHEAD uses the GET handler and headers without a response body.", "x-handler": "company_roots", "x-source-file": "crates/synckhub-server/src/routes/desktop_sync.rs", "x-source-line": 1108, "x-implicit-head": true, "responses": { "default": { "description": "Platform error; branch on HTTP status and stable code, not the human-readable message." } } } }, "/repos/{repo_id}/docs/items/{item_id}/navigation": { "patch": { "operationId": "platform_patch__repos__repo_id__docs_items__item_id__navigation", "summary": "patch repo docs navigation", "tags": [ "docs" ], "parameters": [ { "name": "repo_id", "in": "path", "required": true, "schema": { "type": "string" } }, { "name": "item_id", "in": "path", "required": true, "schema": { "type": "string" } } ], "description": "Authorization and validation are enforced by the owning service.", "x-handler": "patch_repo_docs_navigation", "x-source-file": "crates/synckhub-server/src/routes/docs.rs", "x-source-line": 17, "responses": { "default": { "description": "Platform error; branch on HTTP status and stable code, not the human-readable message.", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } } }, "2XX": { "description": "Successful JSON response", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/synckhub_core.types.ItemWriteReceipt" } } } } }, "requestBody": { "required": true, "content": { "application/json": { "schema": { "$ref": "#/components/schemas/synckhub_server.routes.docs.PatchRepoDocsNavigationRequest" } } } } } }, "/repos/{repo_id}/docs/pages/{item_id}/markdown": { "get": { "operationId": "platform_get__repos__repo_id__docs_pages__item_id__markdown", "summary": "get repo docs page markdown", "tags": [ "docs" ], "parameters": [ { "name": "repo_id", "in": "path", "required": true, "schema": { "type": "string" } }, { "name": "item_id", "in": "path", "required": true, "schema": { "type": "string" } } ], "description": "Authorization and validation are enforced by the owning service.", "x-handler": "get_repo_docs_page_markdown", "x-source-file": "crates/synckhub-server/src/routes/docs.rs", "x-source-line": 17, "responses": { "default": { "description": "Platform error; branch on HTTP status and stable code, not the human-readable message.", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } } } } }, "head": { "operationId": "platform_head__repos__repo_id__docs_pages__item_id__markdown", "summary": "get repo docs page markdown", "tags": [ "docs" ], "parameters": [ { "name": "repo_id", "in": "path", "required": true, "schema": { "type": "string" } }, { "name": "item_id", "in": "path", "required": true, "schema": { "type": "string" } } ], "description": "Authorization and validation are enforced by the owning service.\n\nHEAD uses the GET handler and headers without a response body.", "x-handler": "get_repo_docs_page_markdown", "x-source-file": "crates/synckhub-server/src/routes/docs.rs", "x-source-line": 17, "x-implicit-head": true, "responses": { "default": { "description": "Platform error; branch on HTTP status and stable code, not the human-readable message." } } } }, "/repos/{repo_id}/docs/tree": { "get": { "operationId": "platform_get__repos__repo_id__docs_tree", "summary": "get repo docs tree", "tags": [ "docs" ], "parameters": [ { "name": "repo_id", "in": "path", "required": true, "schema": { "type": "string" } } ], "description": "Authorization and validation are enforced by the owning service.", "x-handler": "get_repo_docs_tree", "x-source-file": "crates/synckhub-server/src/routes/docs.rs", "x-source-line": 17, "responses": { "default": { "description": "Platform error; branch on HTTP status and stable code, not the human-readable message.", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } } } } }, "head": { "operationId": "platform_head__repos__repo_id__docs_tree", "summary": "get repo docs tree", "tags": [ "docs" ], "parameters": [ { "name": "repo_id", "in": "path", "required": true, "schema": { "type": "string" } } ], "description": "Authorization and validation are enforced by the owning service.\n\nHEAD uses the GET handler and headers without a response body.", "x-handler": "get_repo_docs_tree", "x-source-file": "crates/synckhub-server/src/routes/docs.rs", "x-source-line": 17, "x-implicit-head": true, "responses": { "default": { "description": "Platform error; branch on HTTP status and stable code, not the human-readable message." } } } }, "/repos/{repo_id}/export-manifest": { "post": { "operationId": "platform_post__repos__repo_id__export_manifest", "summary": "build normal export manifest", "tags": [ "files · exports" ], "parameters": [ { "name": "repo_id", "in": "path", "required": true, "schema": { "type": "string" } } ], "description": "Authorization and validation are enforced by the owning service.", "x-handler": "build_normal_export_manifest", "x-source-file": "crates/synckhub-server/src/routes/files/exports.rs", "x-source-line": 20, "responses": { "default": { "description": "Platform error; branch on HTTP status and stable code, not the human-readable message.", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } } }, "2XX": { "description": "Successful JSON response", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/synckhub_core.types.NormalExportManifestResponse" } } } } }, "requestBody": { "required": true, "content": { "application/json": { "schema": { "$ref": "#/components/schemas/synckhub_core.types.NormalExportManifestRequest" } } } } } }, "/repos/{repo_id}/export-manifest/{plan_id}/blob-pack": { "post": { "operationId": "platform_post__repos__repo_id__export_manifest__plan_id__blob_pack", "summary": "post normal export manifest blob pack", "tags": [ "files · exports" ], "parameters": [ { "name": "repo_id", "in": "path", "required": true, "schema": { "type": "string" } }, { "name": "plan_id", "in": "path", "required": true, "schema": { "type": "string" } } ], "description": "Authorization and validation are enforced by the owning service.", "x-handler": "post_normal_export_manifest_blob_pack", "x-source-file": "crates/synckhub-server/src/routes/files/exports.rs", "x-source-line": 20, "responses": { "default": { "description": "Platform error; branch on HTTP status and stable code, not the human-readable message.", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } } } }, "requestBody": { "required": true, "content": { "application/json": { "schema": { "$ref": "#/components/schemas/synckhub_server.routes.files.exports.NormalExportBlobPackRequest" } } } } } }, "/repos/{repo_id}/export-manifest/{plan_id}/entries/{ordinal}/blob/{blob_id}": { "get": { "operationId": "platform_get__repos__repo_id__export_manifest__plan_id__entries__ordinal__blob__blob_id_", "summary": "get normal export manifest entry blob", "tags": [ "files · exports" ], "parameters": [ { "name": "repo_id", "in": "path", "required": true, "schema": { "type": "string" } }, { "name": "plan_id", "in": "path", "required": true, "schema": { "type": "string" } }, { "name": "ordinal", "in": "path", "required": true, "schema": { "type": "integer" } }, { "name": "blob_id", "in": "path", "required": true, "schema": { "type": "string" } } ], "description": "Authorization and validation are enforced by the owning service.", "x-handler": "get_normal_export_manifest_entry_blob", "x-source-file": "crates/synckhub-server/src/routes/files/exports.rs", "x-source-line": 20, "responses": { "default": { "description": "Platform error; branch on HTTP status and stable code, not the human-readable message.", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } } } } }, "head": { "operationId": "platform_head__repos__repo_id__export_manifest__plan_id__entries__ordinal__blob__blob_id_", "summary": "get normal export manifest entry blob", "tags": [ "files · exports" ], "parameters": [ { "name": "repo_id", "in": "path", "required": true, "schema": { "type": "string" } }, { "name": "plan_id", "in": "path", "required": true, "schema": { "type": "string" } }, { "name": "ordinal", "in": "path", "required": true, "schema": { "type": "integer" } }, { "name": "blob_id", "in": "path", "required": true, "schema": { "type": "string" } } ], "description": "Authorization and validation are enforced by the owning service.\n\nHEAD uses the GET handler and headers without a response body.", "x-handler": "get_normal_export_manifest_entry_blob", "x-source-file": "crates/synckhub-server/src/routes/files/exports.rs", "x-source-line": 20, "x-implicit-head": true, "responses": { "default": { "description": "Platform error; branch on HTTP status and stable code, not the human-readable message." } } } }, "/repos/{repo_id}/exports/folders/{folder_id}": { "post": { "operationId": "platform_post__repos__repo_id__exports_folders__folder_id_", "summary": "export folder zip", "tags": [ "authz" ], "parameters": [ { "name": "repo_id", "in": "path", "required": true, "schema": { "type": "string" } }, { "name": "folder_id", "in": "path", "required": true, "schema": { "type": "string" } } ], "description": "Authorization and validation are enforced by the owning service.", "x-handler": "exports::export_folder_zip", "x-source-file": "crates/synckhub-server/src/routes/authz.rs", "x-source-line": 6602, "responses": { "default": { "description": "Platform error; branch on HTTP status and stable code, not the human-readable message.", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } } } }, "requestBody": { "required": true, "content": { "application/json": { "schema": { "$ref": "#/components/schemas/synckhub_server.exports.ExportRequest" } } } } } }, "/repos/{repo_id}/exports/folders/{folder_id}/preflight": { "post": { "operationId": "platform_post__repos__repo_id__exports_folders__folder_id__preflight", "summary": "export preflight folder", "tags": [ "authz" ], "parameters": [ { "name": "repo_id", "in": "path", "required": true, "schema": { "type": "string" } }, { "name": "folder_id", "in": "path", "required": true, "schema": { "type": "string" } }, { "name": "include_samples", "in": "query", "required": false, "schema": { "anyOf": [ { "type": "boolean" }, { "type": "null" } ] } } ], "description": "Authorization and validation are enforced by the owning service.", "x-handler": "exports::export_preflight_folder", "x-source-file": "crates/synckhub-server/src/routes/authz.rs", "x-source-line": 6602, "responses": { "default": { "description": "Platform error; branch on HTTP status and stable code, not the human-readable message.", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } } }, "2XX": { "description": "Successful JSON response", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/synckhub_server.exports.ExportPreflightResponse" } } } } } } }, "/repos/{repo_id}/federated-folders/mounts": { "post": { "operationId": "platform_post__repos__repo_id__federated_folders_mounts", "summary": "federated folder mount create", "tags": [ "federated_folders" ], "parameters": [ { "name": "repo_id", "in": "path", "required": true, "schema": { "type": "string" } } ], "description": "Authorization and validation are enforced by the owning service.", "x-handler": "federated_folder_mount_create", "x-source-file": "crates/synckhub-server/src/routes/federated_folders.rs", "x-source-line": 109, "responses": { "default": { "description": "Platform error; branch on HTTP status and stable code, not the human-readable message.", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } } }, "2XX": { "description": "Successful JSON response", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/synckhub_federation.clearinghouse.FederatedFolderMountSummary" } } } } }, "requestBody": { "required": true, "content": { "application/json": { "schema": { "$ref": "#/components/schemas/synckhub_server.routes.federated_folders.FederatedFolderMountCreateRequest" } } } } }, "get": { "operationId": "platform_get__repos__repo_id__federated_folders_mounts", "summary": "federated folder mount list", "tags": [ "federated_folders" ], "parameters": [ { "name": "repo_id", "in": "path", "required": true, "schema": { "type": "string" } }, { "name": "include_detached", "in": "query", "required": false, "schema": { "anyOf": [ { "type": "boolean" }, { "type": "null" } ] } }, { "name": "include_chat_unread", "in": "query", "required": false, "schema": { "anyOf": [ { "type": "boolean" }, { "type": "null" } ] } }, { "name": "tenant_id", "in": "query", "required": false, "schema": { "anyOf": [ { "type": "string" }, { "type": "null" } ], "description": "Optional override when auth is disabled." } } ], "description": "Authorization and validation are enforced by the owning service.", "x-handler": "federated_folder_mount_list", "x-source-file": "crates/synckhub-server/src/routes/federated_folders.rs", "x-source-line": 109, "responses": { "default": { "description": "Platform error; branch on HTTP status and stable code, not the human-readable message.", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } } }, "2XX": { "description": "Successful JSON response", "content": { "application/json": { "schema": { "type": "array", "items": { "$ref": "#/components/schemas/synckhub_federation.clearinghouse.FederatedFolderMountSummary" } } } } } } }, "head": { "operationId": "platform_head__repos__repo_id__federated_folders_mounts", "summary": "federated folder mount list", "tags": [ "federated_folders" ], "parameters": [ { "name": "repo_id", "in": "path", "required": true, "schema": { "type": "string" } }, { "name": "include_detached", "in": "query", "required": false, "schema": { "anyOf": [ { "type": "boolean" }, { "type": "null" } ] } }, { "name": "include_chat_unread", "in": "query", "required": false, "schema": { "anyOf": [ { "type": "boolean" }, { "type": "null" } ] } }, { "name": "tenant_id", "in": "query", "required": false, "schema": { "anyOf": [ { "type": "string" }, { "type": "null" } ], "description": "Optional override when auth is disabled." } } ], "description": "Authorization and validation are enforced by the owning service.\n\nHEAD uses the GET handler and headers without a response body.", "x-handler": "federated_folder_mount_list", "x-source-file": "crates/synckhub-server/src/routes/federated_folders.rs", "x-source-line": 109, "x-implicit-head": true, "responses": { "default": { "description": "Platform error; branch on HTTP status and stable code, not the human-readable message." } } } }, "/repos/{repo_id}/federated-folders/mounts/{mount_id}/detach": { "post": { "operationId": "platform_post__repos__repo_id__federated_folders_mounts__mount_id__detach", "summary": "federated folder mount detach", "tags": [ "federated_folders" ], "parameters": [ { "name": "repo_id", "in": "path", "required": true, "schema": { "type": "string" } }, { "name": "mount_id", "in": "path", "required": true, "schema": { "type": "string" } } ], "description": "Authorization and validation are enforced by the owning service.", "x-handler": "federated_folder_mount_detach", "x-source-file": "crates/synckhub-server/src/routes/federated_folders.rs", "x-source-line": 109, "responses": { "default": { "description": "Platform error; branch on HTTP status and stable code, not the human-readable message.", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } } }, "2XX": { "description": "Successful JSON response", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/synckhub_federation.clearinghouse.FederatedFolderMountDetachResult" } } } } }, "requestBody": { "required": true, "content": { "application/json": { "schema": { "$ref": "#/components/schemas/synckhub_server.routes.federated_folders.FederatedFolderMountDetachRequest" } } } } } }, "/repos/{repo_id}/federated-folders/mounts/{mount_id}/items": { "get": { "operationId": "platform_get__repos__repo_id__federated_folders_mounts__mount_id__items", "summary": "federated folder mount list items", "tags": [ "federated_folders" ], "parameters": [ { "name": "repo_id", "in": "path", "required": true, "schema": { "type": "string" } }, { "name": "mount_id", "in": "path", "required": true, "schema": { "type": "string" } }, { "name": "parent_item_id", "in": "query", "required": false, "schema": { "anyOf": [ { "type": "string" }, { "type": "null" } ] } }, { "name": "limit", "in": "query", "required": false, "schema": { "anyOf": [ { "type": "integer", "minimum": 0 }, { "type": "null" } ] } }, { "name": "offset", "in": "query", "required": false, "schema": { "anyOf": [ { "type": "integer", "minimum": 0 }, { "type": "null" } ] } }, { "name": "tenant_id", "in": "query", "required": false, "schema": { "anyOf": [ { "type": "string" }, { "type": "null" } ], "description": "Optional override when auth is disabled." } } ], "description": "Authorization and validation are enforced by the owning service.", "x-handler": "federated_folder_mount_list_items", "x-source-file": "crates/synckhub-server/src/routes/federated_folders.rs", "x-source-line": 109, "responses": { "default": { "description": "Platform error; branch on HTTP status and stable code, not the human-readable message.", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } } }, "2XX": { "description": "Successful JSON response", "content": { "application/json": { "schema": { "type": "array", "items": { "$ref": "#/components/schemas/synckhub_core.types.ItemSummary" } } } } } } }, "head": { "operationId": "platform_head__repos__repo_id__federated_folders_mounts__mount_id__items", "summary": "federated folder mount list items", "tags": [ "federated_folders" ], "parameters": [ { "name": "repo_id", "in": "path", "required": true, "schema": { "type": "string" } }, { "name": "mount_id", "in": "path", "required": true, "schema": { "type": "string" } }, { "name": "parent_item_id", "in": "query", "required": false, "schema": { "anyOf": [ { "type": "string" }, { "type": "null" } ] } }, { "name": "limit", "in": "query", "required": false, "schema": { "anyOf": [ { "type": "integer", "minimum": 0 }, { "type": "null" } ] } }, { "name": "offset", "in": "query", "required": false, "schema": { "anyOf": [ { "type": "integer", "minimum": 0 }, { "type": "null" } ] } }, { "name": "tenant_id", "in": "query", "required": false, "schema": { "anyOf": [ { "type": "string" }, { "type": "null" } ], "description": "Optional override when auth is disabled." } } ], "description": "Authorization and validation are enforced by the owning service.\n\nHEAD uses the GET handler and headers without a response body.", "x-handler": "federated_folder_mount_list_items", "x-source-file": "crates/synckhub-server/src/routes/federated_folders.rs", "x-source-line": 109, "x-implicit-head": true, "responses": { "default": { "description": "Platform error; branch on HTTP status and stable code, not the human-readable message." } } } }, "/repos/{repo_id}/federated-folders/mounts/{mount_id}/items/{item_id}": { "get": { "operationId": "platform_get__repos__repo_id__federated_folders_mounts__mount_id__items__item_id_", "summary": "federated folder mount get item", "tags": [ "federated_folders" ], "parameters": [ { "name": "repo_id", "in": "path", "required": true, "schema": { "type": "string" } }, { "name": "mount_id", "in": "path", "required": true, "schema": { "type": "string" } }, { "name": "item_id", "in": "path", "required": true, "schema": { "type": "string" } }, { "name": "tenant_id", "in": "query", "required": false, "schema": { "anyOf": [ { "type": "string" }, { "type": "null" } ], "description": "Optional override when auth is disabled." } } ], "description": "Authorization and validation are enforced by the owning service.", "x-handler": "federated_folder_mount_get_item", "x-source-file": "crates/synckhub-server/src/routes/federated_folders.rs", "x-source-line": 109, "responses": { "default": { "description": "Platform error; branch on HTTP status and stable code, not the human-readable message.", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } } }, "2XX": { "description": "Successful JSON response", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/synckhub_core.types.ItemSummary" } } } } } }, "head": { "operationId": "platform_head__repos__repo_id__federated_folders_mounts__mount_id__items__item_id_", "summary": "federated folder mount get item", "tags": [ "federated_folders" ], "parameters": [ { "name": "repo_id", "in": "path", "required": true, "schema": { "type": "string" } }, { "name": "mount_id", "in": "path", "required": true, "schema": { "type": "string" } }, { "name": "item_id", "in": "path", "required": true, "schema": { "type": "string" } }, { "name": "tenant_id", "in": "query", "required": false, "schema": { "anyOf": [ { "type": "string" }, { "type": "null" } ], "description": "Optional override when auth is disabled." } } ], "description": "Authorization and validation are enforced by the owning service.\n\nHEAD uses the GET handler and headers without a response body.", "x-handler": "federated_folder_mount_get_item", "x-source-file": "crates/synckhub-server/src/routes/federated_folders.rs", "x-source-line": 109, "x-implicit-head": true, "responses": { "default": { "description": "Platform error; branch on HTTP status and stable code, not the human-readable message." } } } }, "/repos/{repo_id}/federated-folders/mounts/{mount_id}/proposals": { "post": { "operationId": "platform_post__repos__repo_id__federated_folders_mounts__mount_id__proposals", "summary": "federated folder mount submit proposal", "tags": [ "federated_folders" ], "parameters": [ { "name": "repo_id", "in": "path", "required": true, "schema": { "type": "string" } }, { "name": "mount_id", "in": "path", "required": true, "schema": { "type": "string" } } ], "description": "Authorization and validation are enforced by the owning service.", "x-handler": "federated_folder_mount_submit_proposal", "x-source-file": "crates/synckhub-server/src/routes/federated_folders.rs", "x-source-line": 109, "responses": { "default": { "description": "Platform error; branch on HTTP status and stable code, not the human-readable message.", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } } }, "2XX": { "description": "Successful JSON response", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/synckhub_federation.clearinghouse.FederatedFolderSubmitProposalResult" } } } } }, "requestBody": { "required": true, "content": { "application/json": { "schema": { "$ref": "#/components/schemas/synckhub_server.routes.federated_folders.FederatedFolderSubmitProposalRequest" } } } } } }, "/repos/{repo_id}/federated-folders/mounts/{mount_id}/reconnect": { "post": { "operationId": "platform_post__repos__repo_id__federated_folders_mounts__mount_id__reconnect", "summary": "federated folder mount reconnect", "tags": [ "federated_folders" ], "parameters": [ { "name": "repo_id", "in": "path", "required": true, "schema": { "type": "string" } }, { "name": "mount_id", "in": "path", "required": true, "schema": { "type": "string" } } ], "description": "Authorization and validation are enforced by the owning service.", "x-handler": "federated_folder_mount_reconnect", "x-source-file": "crates/synckhub-server/src/routes/federated_folders.rs", "x-source-line": 109, "responses": { "default": { "description": "Platform error; branch on HTTP status and stable code, not the human-readable message.", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } } }, "2XX": { "description": "Successful JSON response", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/synckhub_federation.clearinghouse.FederatedFolderMountSyncResult" } } } } }, "requestBody": { "required": true, "content": { "application/json": { "schema": { "$ref": "#/components/schemas/synckhub_server.routes.federated_folders.FederatedFolderMountReconnectRequest" } } } } } }, "/repos/{repo_id}/federated-folders/mounts/{mount_id}/sync": { "post": { "operationId": "platform_post__repos__repo_id__federated_folders_mounts__mount_id__sync", "summary": "federated folder mount sync", "tags": [ "federated_folders" ], "parameters": [ { "name": "repo_id", "in": "path", "required": true, "schema": { "type": "string" } }, { "name": "mount_id", "in": "path", "required": true, "schema": { "type": "string" } }, { "name": "limit", "in": "query", "required": false, "schema": { "anyOf": [ { "type": "integer", "minimum": 0 }, { "type": "null" } ] } }, { "name": "tenant_id", "in": "query", "required": false, "schema": { "anyOf": [ { "type": "string" }, { "type": "null" } ], "description": "Optional override when auth is disabled." } } ], "description": "Authorization and validation are enforced by the owning service.", "x-handler": "federated_folder_mount_sync", "x-source-file": "crates/synckhub-server/src/routes/federated_folders.rs", "x-source-line": 109, "responses": { "default": { "description": "Platform error; branch on HTTP status and stable code, not the human-readable message.", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } } }, "2XX": { "description": "Successful JSON response", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/synckhub_federation.clearinghouse.FederatedFolderMountSyncResult" } } } } } } }, "/repos/{repo_id}/federated-folders/mounts/{mount_id}/task-cutover": { "post": { "operationId": "platform_post__repos__repo_id__federated_folders_mounts__mount_id__task_cutover", "summary": "federated folder mount task cutover command", "tags": [ "federated_folders" ], "parameters": [ { "name": "repo_id", "in": "path", "required": true, "schema": { "type": "string" } }, { "name": "mount_id", "in": "path", "required": true, "schema": { "type": "string" } }, { "name": "tenant_id", "in": "query", "required": false, "schema": { "anyOf": [ { "type": "string" }, { "type": "null" } ] } } ], "description": "Authorization and validation are enforced by the owning service.", "x-handler": "federated_folder_mount_task_cutover_command", "x-source-file": "crates/synckhub-server/src/routes/federated_folders.rs", "x-source-line": 109, "responses": { "default": { "description": "Platform error; branch on HTTP status and stable code, not the human-readable message.", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } } }, "2XX": { "description": "Successful JSON response", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/synckhub_federation_protocol.task_cutover.StateV1" } } } } }, "requestBody": { "required": true, "content": { "application/json": { "schema": { "$ref": "#/components/schemas/synckhub_federation_protocol.task_cutover.RequestV1" } } } } }, "get": { "operationId": "platform_get__repos__repo_id__federated_folders_mounts__mount_id__task_cutover", "summary": "federated folder mount task cutover get", "tags": [ "federated_folders" ], "parameters": [ { "name": "repo_id", "in": "path", "required": true, "schema": { "type": "string" } }, { "name": "mount_id", "in": "path", "required": true, "schema": { "type": "string" } }, { "name": "tenant_id", "in": "query", "required": false, "schema": { "anyOf": [ { "type": "string" }, { "type": "null" } ] } } ], "description": "Authorization and validation are enforced by the owning service.", "x-handler": "federated_folder_mount_task_cutover_get", "x-source-file": "crates/synckhub-server/src/routes/federated_folders.rs", "x-source-line": 109, "responses": { "default": { "description": "Platform error; branch on HTTP status and stable code, not the human-readable message.", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } } }, "2XX": { "description": "Successful JSON response", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/synckhub_federation_protocol.task_cutover.StateV1" } } } } } }, "head": { "operationId": "platform_head__repos__repo_id__federated_folders_mounts__mount_id__task_cutover", "summary": "federated folder mount task cutover get", "tags": [ "federated_folders" ], "parameters": [ { "name": "repo_id", "in": "path", "required": true, "schema": { "type": "string" } }, { "name": "mount_id", "in": "path", "required": true, "schema": { "type": "string" } }, { "name": "tenant_id", "in": "query", "required": false, "schema": { "anyOf": [ { "type": "string" }, { "type": "null" } ] } } ], "description": "Authorization and validation are enforced by the owning service.\n\nHEAD uses the GET handler and headers without a response body.", "x-handler": "federated_folder_mount_task_cutover_get", "x-source-file": "crates/synckhub-server/src/routes/federated_folders.rs", "x-source-line": 109, "x-implicit-head": true, "responses": { "default": { "description": "Platform error; branch on HTTP status and stable code, not the human-readable message." } } } }, "/repos/{repo_id}/federated-folders/mounts/{mount_id}/task-cutover/advance-local": { "post": { "operationId": "platform_post__repos__repo_id__federated_folders_mounts__mount_id__task_cutover_advance_local", "summary": "federated folder mount task cutover advance local", "tags": [ "federated_folders" ], "parameters": [ { "name": "repo_id", "in": "path", "required": true, "schema": { "type": "string" } }, { "name": "mount_id", "in": "path", "required": true, "schema": { "type": "string" } }, { "name": "tenant_id", "in": "query", "required": false, "schema": { "anyOf": [ { "type": "string" }, { "type": "null" } ] } } ], "description": "Authorization and validation are enforced by the owning service.", "x-handler": "federated_folder_mount_task_cutover_advance_local", "x-source-file": "crates/synckhub-server/src/routes/federated_folders.rs", "x-source-line": 109, "responses": { "default": { "description": "Platform error; branch on HTTP status and stable code, not the human-readable message.", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } } }, "2XX": { "description": "Successful JSON response", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/synckhub_federation.service.FederatedTaskCutoverAdvanceResult" } } } } } } }, "/repos/{repo_id}/federated-folders/status": { "get": { "operationId": "platform_get__repos__repo_id__federated_folders_status", "summary": "federated folder repo status", "tags": [ "federated_folders" ], "parameters": [ { "name": "repo_id", "in": "path", "required": true, "schema": { "type": "string" } }, { "name": "tenant_id", "in": "query", "required": false, "schema": { "anyOf": [ { "type": "string" }, { "type": "null" } ], "description": "Optional override when auth is disabled." } } ], "description": "Authorization and validation are enforced by the owning service.", "x-handler": "federated_folder_repo_status", "x-source-file": "crates/synckhub-server/src/routes/federated_folders.rs", "x-source-line": 109, "responses": { "default": { "description": "Platform error; branch on HTTP status and stable code, not the human-readable message.", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } } } } }, "head": { "operationId": "platform_head__repos__repo_id__federated_folders_status", "summary": "federated folder repo status", "tags": [ "federated_folders" ], "parameters": [ { "name": "repo_id", "in": "path", "required": true, "schema": { "type": "string" } }, { "name": "tenant_id", "in": "query", "required": false, "schema": { "anyOf": [ { "type": "string" }, { "type": "null" } ], "description": "Optional override when auth is disabled." } } ], "description": "Authorization and validation are enforced by the owning service.\n\nHEAD uses the GET handler and headers without a response body.", "x-handler": "federated_folder_repo_status", "x-source-file": "crates/synckhub-server/src/routes/federated_folders.rs", "x-source-line": 109, "x-implicit-head": true, "responses": { "default": { "description": "Platform error; branch on HTTP status and stable code, not the human-readable message." } } } }, "/repos/{repo_id}/federation/chat-connections": { "post": { "operationId": "platform_post__repos__repo_id__federation_chat_connections", "summary": "request connection", "tags": [ "chat · connections" ], "parameters": [ { "name": "repo_id", "in": "path", "required": true, "schema": { "type": "string" } } ], "description": "Authorization and validation are enforced by the owning service.", "x-handler": "request_connection", "x-source-file": "crates/synckhub-server/src/routes/chat/connections.rs", "x-source-line": 44, "responses": { "default": { "description": "Platform error; branch on HTTP status and stable code, not the human-readable message.", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } } }, "2XX": { "description": "Successful JSON response", "content": { "application/json": { "schema": {} } } } }, "requestBody": { "required": true, "content": { "application/json": { "schema": { "$ref": "#/components/schemas/synckhub_server.routes.chat.connections.RequestConnectionBody" } } } } }, "get": { "operationId": "platform_get__repos__repo_id__federation_chat_connections", "summary": "list connections", "tags": [ "chat · connections" ], "parameters": [ { "name": "repo_id", "in": "path", "required": true, "schema": { "type": "string" } } ], "description": "Authorization and validation are enforced by the owning service.", "x-handler": "list_connections", "x-source-file": "crates/synckhub-server/src/routes/chat/connections.rs", "x-source-line": 44, "responses": { "default": { "description": "Platform error; branch on HTTP status and stable code, not the human-readable message.", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } } }, "2XX": { "description": "Successful JSON response", "content": { "application/json": { "schema": {} } } } } }, "head": { "operationId": "platform_head__repos__repo_id__federation_chat_connections", "summary": "list connections", "tags": [ "chat · connections" ], "parameters": [ { "name": "repo_id", "in": "path", "required": true, "schema": { "type": "string" } } ], "description": "Authorization and validation are enforced by the owning service.\n\nHEAD uses the GET handler and headers without a response body.", "x-handler": "list_connections", "x-source-file": "crates/synckhub-server/src/routes/chat/connections.rs", "x-source-line": 44, "x-implicit-head": true, "responses": { "default": { "description": "Platform error; branch on HTTP status and stable code, not the human-readable message." } } } }, "/repos/{repo_id}/federation/chat-connections/{connection_id}/{action}": { "post": { "operationId": "platform_post__repos__repo_id__federation_chat_connections__connection_id___action_", "summary": "transition connection", "tags": [ "chat · connections" ], "parameters": [ { "name": "repo_id", "in": "path", "required": true, "schema": { "type": "string" } }, { "name": "connection_id", "in": "path", "required": true, "schema": { "type": "string", "format": "uuid" } }, { "name": "action", "in": "path", "required": true, "schema": { "type": "string" } } ], "description": "Authorization and validation are enforced by the owning service.", "x-handler": "transition_connection", "x-source-file": "crates/synckhub-server/src/routes/chat/connections.rs", "x-source-line": 44, "responses": { "default": { "description": "Platform error; branch on HTTP status and stable code, not the human-readable message.", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } } }, "2XX": { "description": "Successful JSON response", "content": { "application/json": { "schema": {} } } } } } }, "/repos/{repo_id}/federation/decision-threads": { "get": { "operationId": "platform_get__repos__repo_id__federation_decision_threads", "summary": "federation list decision threads", "tags": [ "authz" ], "parameters": [ { "name": "repo_id", "in": "path", "required": true, "schema": { "type": "string" } }, { "name": "kind", "in": "query", "required": false, "schema": { "anyOf": [ { "$ref": "#/components/schemas/synckhub_federation_protocol.types.DecisionThreadKindV1" }, { "type": "null" } ] } }, { "name": "view", "in": "query", "required": false, "schema": { "anyOf": [ { "$ref": "#/components/schemas/synckhub_federation_protocol.types.InviteListViewV1" }, { "type": "null" } ] } }, { "name": "status", "in": "query", "required": false, "schema": { "anyOf": [ { "$ref": "#/components/schemas/synckhub_federation_protocol.types.InviteListStatusFilterV1" }, { "type": "null" } ] } }, { "name": "limit", "in": "query", "required": false, "schema": { "anyOf": [ { "type": "integer", "minimum": 0 }, { "type": "null" } ] } } ], "description": "Authorization and validation are enforced by the owning service.", "x-handler": "federation_list_decision_threads", "x-source-file": "crates/synckhub-server/src/routes/authz.rs", "x-source-line": 6602, "responses": { "default": { "description": "Platform error; branch on HTTP status and stable code, not the human-readable message.", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } } }, "2XX": { "description": "Successful JSON response", "content": { "application/json": { "schema": { "type": "array", "items": { "$ref": "#/components/schemas/synckhub_server.routes.FederationDecisionThreadSummaryResponse" } } } } } } }, "head": { "operationId": "platform_head__repos__repo_id__federation_decision_threads", "summary": "federation list decision threads", "tags": [ "authz" ], "parameters": [ { "name": "repo_id", "in": "path", "required": true, "schema": { "type": "string" } }, { "name": "kind", "in": "query", "required": false, "schema": { "anyOf": [ { "$ref": "#/components/schemas/synckhub_federation_protocol.types.DecisionThreadKindV1" }, { "type": "null" } ] } }, { "name": "view", "in": "query", "required": false, "schema": { "anyOf": [ { "$ref": "#/components/schemas/synckhub_federation_protocol.types.InviteListViewV1" }, { "type": "null" } ] } }, { "name": "status", "in": "query", "required": false, "schema": { "anyOf": [ { "$ref": "#/components/schemas/synckhub_federation_protocol.types.InviteListStatusFilterV1" }, { "type": "null" } ] } }, { "name": "limit", "in": "query", "required": false, "schema": { "anyOf": [ { "type": "integer", "minimum": 0 }, { "type": "null" } ] } } ], "description": "Authorization and validation are enforced by the owning service.\n\nHEAD uses the GET handler and headers without a response body.", "x-handler": "federation_list_decision_threads", "x-source-file": "crates/synckhub-server/src/routes/authz.rs", "x-source-line": 6602, "x-implicit-head": true, "responses": { "default": { "description": "Platform error; branch on HTTP status and stable code, not the human-readable message." } } } }, "/repos/{repo_id}/federation/decision-threads/{thread_id}": { "get": { "operationId": "platform_get__repos__repo_id__federation_decision_threads__thread_id_", "summary": "federation get decision thread", "tags": [ "authz" ], "parameters": [ { "name": "repo_id", "in": "path", "required": true, "schema": { "type": "string" } }, { "name": "thread_id", "in": "path", "required": true, "schema": { "type": "string" } } ], "description": "Authorization and validation are enforced by the owning service.", "x-handler": "federation_get_decision_thread", "x-source-file": "crates/synckhub-server/src/routes/authz.rs", "x-source-line": 6602, "responses": { "default": { "description": "Platform error; branch on HTTP status and stable code, not the human-readable message.", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } } }, "2XX": { "description": "Successful JSON response", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/synckhub_server.routes.FederationDecisionThreadResponse" } } } } } }, "head": { "operationId": "platform_head__repos__repo_id__federation_decision_threads__thread_id_", "summary": "federation get decision thread", "tags": [ "authz" ], "parameters": [ { "name": "repo_id", "in": "path", "required": true, "schema": { "type": "string" } }, { "name": "thread_id", "in": "path", "required": true, "schema": { "type": "string" } } ], "description": "Authorization and validation are enforced by the owning service.\n\nHEAD uses the GET handler and headers without a response body.", "x-handler": "federation_get_decision_thread", "x-source-file": "crates/synckhub-server/src/routes/authz.rs", "x-source-line": 6602, "x-implicit-head": true, "responses": { "default": { "description": "Platform error; branch on HTTP status and stable code, not the human-readable message." } } } }, "/repos/{repo_id}/federation/decision-threads/{thread_id}/messages": { "post": { "operationId": "platform_post__repos__repo_id__federation_decision_threads__thread_id__messages", "summary": "federation post decision thread message", "tags": [ "authz" ], "parameters": [ { "name": "repo_id", "in": "path", "required": true, "schema": { "type": "string" } }, { "name": "thread_id", "in": "path", "required": true, "schema": { "type": "string" } } ], "description": "Authorization and validation are enforced by the owning service.", "x-handler": "federation_post_decision_thread_message", "x-source-file": "crates/synckhub-server/src/routes/authz.rs", "x-source-line": 6602, "responses": { "default": { "description": "Platform error; branch on HTTP status and stable code, not the human-readable message.", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } } }, "2XX": { "description": "Successful JSON response", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/synckhub_federation_protocol.types.DecisionThreadMessageV1" } } } } }, "requestBody": { "required": true, "content": { "application/json": { "schema": { "$ref": "#/components/schemas/synckhub_server.routes.FederationPostDecisionThreadMessageRequest" } } } } } }, "/repos/{repo_id}/federation/invites": { "get": { "operationId": "platform_get__repos__repo_id__federation_invites", "summary": "federation list invites", "tags": [ "authz" ], "parameters": [ { "name": "repo_id", "in": "path", "required": true, "schema": { "type": "string" } }, { "name": "view", "in": "query", "required": false, "schema": { "anyOf": [ { "$ref": "#/components/schemas/synckhub_federation_protocol.types.InviteListViewV1" }, { "type": "null" } ] } }, { "name": "status", "in": "query", "required": false, "schema": { "anyOf": [ { "$ref": "#/components/schemas/synckhub_federation_protocol.types.InviteListStatusFilterV1" }, { "type": "null" } ] } }, { "name": "limit", "in": "query", "required": false, "schema": { "anyOf": [ { "type": "integer", "minimum": 0 }, { "type": "null" } ] } } ], "description": "Authorization and validation are enforced by the owning service.", "x-handler": "federation_list_invites", "x-source-file": "crates/synckhub-server/src/routes/authz.rs", "x-source-line": 6602, "responses": { "default": { "description": "Platform error; branch on HTTP status and stable code, not the human-readable message.", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } } }, "2XX": { "description": "Successful JSON response", "content": { "application/json": { "schema": { "type": "array", "items": { "$ref": "#/components/schemas/synckhub_server.routes.FederationInviteSummaryResponse" } } } } } } }, "head": { "operationId": "platform_head__repos__repo_id__federation_invites", "summary": "federation list invites", "tags": [ "authz" ], "parameters": [ { "name": "repo_id", "in": "path", "required": true, "schema": { "type": "string" } }, { "name": "view", "in": "query", "required": false, "schema": { "anyOf": [ { "$ref": "#/components/schemas/synckhub_federation_protocol.types.InviteListViewV1" }, { "type": "null" } ] } }, { "name": "status", "in": "query", "required": false, "schema": { "anyOf": [ { "$ref": "#/components/schemas/synckhub_federation_protocol.types.InviteListStatusFilterV1" }, { "type": "null" } ] } }, { "name": "limit", "in": "query", "required": false, "schema": { "anyOf": [ { "type": "integer", "minimum": 0 }, { "type": "null" } ] } } ], "description": "Authorization and validation are enforced by the owning service.\n\nHEAD uses the GET handler and headers without a response body.", "x-handler": "federation_list_invites", "x-source-file": "crates/synckhub-server/src/routes/authz.rs", "x-source-line": 6602, "x-implicit-head": true, "responses": { "default": { "description": "Platform error; branch on HTTP status and stable code, not the human-readable message." } } } }, "/repos/{repo_id}/federation/invites/{invite_id}/reject": { "post": { "operationId": "platform_post__repos__repo_id__federation_invites__invite_id__reject", "summary": "federation reject invite", "tags": [ "authz" ], "parameters": [ { "name": "repo_id", "in": "path", "required": true, "schema": { "type": "string" } }, { "name": "invite_id", "in": "path", "required": true, "schema": { "type": "string" } } ], "description": "Authorization and validation are enforced by the owning service.", "x-handler": "federation_reject_invite", "x-source-file": "crates/synckhub-server/src/routes/authz.rs", "x-source-line": 6602, "responses": { "default": { "description": "Platform error; branch on HTTP status and stable code, not the human-readable message.", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } } }, "2XX": { "description": "Successful JSON response", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/synckhub_federation_protocol.types.RejectInviteResponseV1" } } } } } } }, "/repos/{repo_id}/federation/invites/{invite_id}/revoke": { "post": { "operationId": "platform_post__repos__repo_id__federation_invites__invite_id__revoke", "summary": "federation revoke invite", "tags": [ "authz" ], "parameters": [ { "name": "repo_id", "in": "path", "required": true, "schema": { "type": "string" } }, { "name": "invite_id", "in": "path", "required": true, "schema": { "type": "string" } } ], "description": "Authorization and validation are enforced by the owning service.", "x-handler": "federation_revoke_invite", "x-source-file": "crates/synckhub-server/src/routes/authz.rs", "x-source-line": 6602, "responses": { "default": { "description": "Platform error; branch on HTTP status and stable code, not the human-readable message.", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } } }, "2XX": { "description": "Successful JSON response", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/synckhub_federation_protocol.types.RevokeInviteResponseV1" } } } } } } }, "/repos/{repo_id}/federation/invites/accept": { "post": { "operationId": "platform_post__repos__repo_id__federation_invites_accept", "summary": "federation accept invite", "tags": [ "authz" ], "parameters": [ { "name": "repo_id", "in": "path", "required": true, "schema": { "type": "string" } } ], "description": "Authorization and validation are enforced by the owning service.", "x-handler": "federation_accept_invite", "x-source-file": "crates/synckhub-server/src/routes/authz.rs", "x-source-line": 6602, "responses": { "default": { "description": "Platform error; branch on HTTP status and stable code, not the human-readable message.", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } } }, "2XX": { "description": "Successful JSON response", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/synckhub_federation.clearinghouse.AcceptInviteResult" } } } } }, "requestBody": { "required": true, "content": { "application/json": { "schema": { "$ref": "#/components/schemas/synckhub_server.routes.FederationAcceptInviteRequest" } } } } } }, "/repos/{repo_id}/federation/recipient-key-document": { "post": { "operationId": "platform_post__repos__repo_id__federation_recipient_key_document", "summary": "export document", "tags": [ "federation · recipient_keys" ], "parameters": [ { "name": "repo_id", "in": "path", "required": true, "schema": { "type": "string" } } ], "description": "Authorization and validation are enforced by the owning service.", "x-handler": "export_document", "x-source-file": "crates/synckhub-server/src/routes/federation/recipient_keys.rs", "x-source-line": 27, "responses": { "default": { "description": "Platform error; branch on HTTP status and stable code, not the human-readable message.", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } } }, "2XX": { "description": "Successful JSON response", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/synckhub_federation.recipient_keys.RecipientKeyDocumentV1" } } } } }, "requestBody": { "required": true, "content": { "application/json": { "schema": { "$ref": "#/components/schemas/synckhub_server.routes.federation.recipient_keys.DomainBody" } } } } } }, "/repos/{repo_id}/federation/recipient-key-document/verify": { "post": { "operationId": "platform_post__repos__repo_id__federation_recipient_key_document_verify", "summary": "verify document", "tags": [ "federation · recipient_keys" ], "parameters": [ { "name": "repo_id", "in": "path", "required": true, "schema": { "type": "string" } } ], "description": "Authorization and validation are enforced by the owning service.", "x-handler": "verify_document", "x-source-file": "crates/synckhub-server/src/routes/federation/recipient_keys.rs", "x-source-line": 27, "responses": { "default": { "description": "Platform error; branch on HTTP status and stable code, not the human-readable message.", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } } }, "2XX": { "description": "Successful JSON response", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/synckhub_federation.recipient_keys.RecipientKeyDocumentV1" } } } } }, "requestBody": { "required": true, "content": { "application/json": { "schema": { "$ref": "#/components/schemas/synckhub_server.routes.federation.recipient_keys.DomainBody" } } } } } }, "/repos/{repo_id}/federation/recipient-keys": { "post": { "operationId": "platform_post__repos__repo_id__federation_recipient_keys", "summary": "generate key", "tags": [ "federation · recipient_keys" ], "parameters": [ { "name": "repo_id", "in": "path", "required": true, "schema": { "type": "string" } } ], "description": "Authorization and validation are enforced by the owning service.", "x-handler": "generate_key", "x-source-file": "crates/synckhub-server/src/routes/federation/recipient_keys.rs", "x-source-line": 27, "responses": { "default": { "description": "Platform error; branch on HTTP status and stable code, not the human-readable message.", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } } }, "2XX": { "description": "Successful JSON response", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/synckhub_server.routes.federation.recipient_keys.RecipientKeySummary" } } } } } }, "get": { "operationId": "platform_get__repos__repo_id__federation_recipient_keys", "summary": "list keys", "tags": [ "federation · recipient_keys" ], "parameters": [ { "name": "repo_id", "in": "path", "required": true, "schema": { "type": "string" } } ], "description": "Authorization and validation are enforced by the owning service.", "x-handler": "list_keys", "x-source-file": "crates/synckhub-server/src/routes/federation/recipient_keys.rs", "x-source-line": 27, "responses": { "default": { "description": "Platform error; branch on HTTP status and stable code, not the human-readable message.", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } } }, "2XX": { "description": "Successful JSON response", "content": { "application/json": { "schema": { "type": "array", "items": { "$ref": "#/components/schemas/synckhub_server.routes.federation.recipient_keys.RecipientKeySummary" } } } } } } }, "head": { "operationId": "platform_head__repos__repo_id__federation_recipient_keys", "summary": "list keys", "tags": [ "federation · recipient_keys" ], "parameters": [ { "name": "repo_id", "in": "path", "required": true, "schema": { "type": "string" } } ], "description": "Authorization and validation are enforced by the owning service.\n\nHEAD uses the GET handler and headers without a response body.", "x-handler": "list_keys", "x-source-file": "crates/synckhub-server/src/routes/federation/recipient_keys.rs", "x-source-line": 27, "x-implicit-head": true, "responses": { "default": { "description": "Platform error; branch on HTTP status and stable code, not the human-readable message." } } } }, "/repos/{repo_id}/federation/recipient-keys/{kid}/retire": { "post": { "operationId": "platform_post__repos__repo_id__federation_recipient_keys__kid__retire", "summary": "retire key", "tags": [ "federation · recipient_keys" ], "parameters": [ { "name": "repo_id", "in": "path", "required": true, "schema": { "type": "string" } }, { "name": "kid", "in": "path", "required": true, "schema": { "type": "string" } } ], "description": "Authorization and validation are enforced by the owning service.", "x-handler": "retire_key", "x-source-file": "crates/synckhub-server/src/routes/federation/recipient_keys.rs", "x-source-line": 27, "responses": { "default": { "description": "Platform error; branch on HTTP status and stable code, not the human-readable message.", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } } } } } }, "/repos/{repo_id}/federation/status": { "get": { "operationId": "platform_get__repos__repo_id__federation_status", "summary": "get repo federation status", "tags": [ "federation · status" ], "parameters": [ { "name": "repo_id", "in": "path", "required": true, "schema": { "type": "string" } }, { "name": "tenant_id", "in": "query", "required": false, "schema": { "anyOf": [ { "type": "string" }, { "type": "null" } ] } } ], "description": "Authorization and validation are enforced by the owning service.", "x-handler": "get_repo_federation_status", "x-source-file": "crates/synckhub-server/src/routes/federation/status.rs", "x-source-line": 8, "responses": { "default": { "description": "Platform error; branch on HTTP status and stable code, not the human-readable message.", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } } }, "2XX": { "description": "Successful JSON response", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/synckhub_server.routes.federation.status.RepoFederationStatusResponse" } } } } } }, "head": { "operationId": "platform_head__repos__repo_id__federation_status", "summary": "get repo federation status", "tags": [ "federation · status" ], "parameters": [ { "name": "repo_id", "in": "path", "required": true, "schema": { "type": "string" } }, { "name": "tenant_id", "in": "query", "required": false, "schema": { "anyOf": [ { "type": "string" }, { "type": "null" } ] } } ], "description": "Authorization and validation are enforced by the owning service.\n\nHEAD uses the GET handler and headers without a response body.", "x-handler": "get_repo_federation_status", "x-source-file": "crates/synckhub-server/src/routes/federation/status.rs", "x-source-line": 8, "x-implicit-head": true, "responses": { "default": { "description": "Platform error; branch on HTTP status and stable code, not the human-readable message." } } } }, "/repos/{repo_id}/federation/streams": { "post": { "operationId": "platform_post__repos__repo_id__federation_streams", "summary": "federation create stream", "tags": [ "authz" ], "parameters": [ { "name": "repo_id", "in": "path", "required": true, "schema": { "type": "string" } } ], "description": "Authorization and validation are enforced by the owning service.", "x-handler": "federation_create_stream", "x-source-file": "crates/synckhub-server/src/routes/authz.rs", "x-source-line": 6602, "responses": { "default": { "description": "Platform error; branch on HTTP status and stable code, not the human-readable message.", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } } }, "2XX": { "description": "Successful JSON response", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/synckhub_federation_protocol.types.CreateStreamResponseV1" } } } } }, "requestBody": { "required": true, "content": { "application/json": { "schema": { "$ref": "#/components/schemas/synckhub_server.routes.FederationCreateStreamRequest" } } } } } }, "/repos/{repo_id}/federation/streams/{federation_stream_id}/invites": { "post": { "operationId": "platform_post__repos__repo_id__federation_streams__federation_stream_id__invites", "summary": "federation create invite", "tags": [ "authz" ], "parameters": [ { "name": "repo_id", "in": "path", "required": true, "schema": { "type": "string" } }, { "name": "federation_stream_id", "in": "path", "required": true, "schema": { "type": "string" } } ], "description": "Authorization and validation are enforced by the owning service.", "x-handler": "federation_create_invite", "x-source-file": "crates/synckhub-server/src/routes/authz.rs", "x-source-line": 6602, "responses": { "default": { "description": "Platform error; branch on HTTP status and stable code, not the human-readable message.", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } } }, "2XX": { "description": "Successful JSON response", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/synckhub_server.routes.FederationCreateInvitesResponse" } } } } }, "requestBody": { "required": true, "content": { "application/json": { "schema": { "$ref": "#/components/schemas/synckhub_server.routes.FederationCreateInviteRequest" } } } } } }, "/repos/{repo_id}/federation/streams/{federation_stream_id}/members": { "get": { "operationId": "platform_get__repos__repo_id__federation_streams__federation_stream_id__members", "summary": "federation list members", "tags": [ "authz" ], "parameters": [ { "name": "repo_id", "in": "path", "required": true, "schema": { "type": "string" } }, { "name": "federation_stream_id", "in": "path", "required": true, "schema": { "type": "string" } } ], "description": "Authorization and validation are enforced by the owning service.", "x-handler": "federation_list_members", "x-source-file": "crates/synckhub-server/src/routes/authz.rs", "x-source-line": 6602, "responses": { "default": { "description": "Platform error; branch on HTTP status and stable code, not the human-readable message.", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } } }, "2XX": { "description": "Successful JSON response", "content": { "application/json": { "schema": { "type": "array", "items": { "$ref": "#/components/schemas/synckhub_federation_protocol.types.MemberV1" } } } } } } }, "head": { "operationId": "platform_head__repos__repo_id__federation_streams__federation_stream_id__members", "summary": "federation list members", "tags": [ "authz" ], "parameters": [ { "name": "repo_id", "in": "path", "required": true, "schema": { "type": "string" } }, { "name": "federation_stream_id", "in": "path", "required": true, "schema": { "type": "string" } } ], "description": "Authorization and validation are enforced by the owning service.\n\nHEAD uses the GET handler and headers without a response body.", "x-handler": "federation_list_members", "x-source-file": "crates/synckhub-server/src/routes/authz.rs", "x-source-line": 6602, "x-implicit-head": true, "responses": { "default": { "description": "Platform error; branch on HTTP status and stable code, not the human-readable message." } } } }, "/repos/{repo_id}/federation/streams/{federation_stream_id}/sync": { "post": { "operationId": "platform_post__repos__repo_id__federation_streams__federation_stream_id__sync", "summary": "federation sync stream", "tags": [ "authz" ], "parameters": [ { "name": "repo_id", "in": "path", "required": true, "schema": { "type": "string" } }, { "name": "federation_stream_id", "in": "path", "required": true, "schema": { "type": "string" } }, { "name": "limit", "in": "query", "required": false, "schema": { "anyOf": [ { "type": "integer", "minimum": 0 }, { "type": "null" } ] } } ], "description": "Authorization and validation are enforced by the owning service.", "x-handler": "federation_sync_stream", "x-source-file": "crates/synckhub-server/src/routes/authz.rs", "x-source-line": 6602, "responses": { "default": { "description": "Platform error; branch on HTTP status and stable code, not the human-readable message.", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } } }, "2XX": { "description": "Successful JSON response", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/synckhub_federation.clearinghouse.SyncStreamResult" } } } } } } }, "/repos/{repo_id}/folder-auto-join-links": { "post": { "operationId": "platform_post__repos__repo_id__folder_auto_join_links", "summary": "create folder auto join link", "tags": [ "sharing" ], "parameters": [ { "name": "repo_id", "in": "path", "required": true, "schema": { "type": "string" } } ], "description": "Authorization and validation are enforced by the owning service.", "x-handler": "crate::folder_auto_join_links::create_folder_auto_join_link", "x-source-file": "crates/synckhub-server/src/routes/sharing.rs", "x-source-line": 7, "responses": { "default": { "description": "Platform error; branch on HTTP status and stable code, not the human-readable message.", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } } }, "2XX": { "description": "Successful JSON response", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/synckhub_server.folder_auto_join_links.FolderAutoJoinLinkCreatedResponse" } } } } }, "requestBody": { "required": true, "content": { "application/json": { "schema": { "$ref": "#/components/schemas/synckhub_server.folder_auto_join_links.CreateFolderAutoJoinLinkRequest" } } } } }, "get": { "operationId": "platform_get__repos__repo_id__folder_auto_join_links", "summary": "list folder auto join links", "tags": [ "sharing" ], "parameters": [ { "name": "repo_id", "in": "path", "required": true, "schema": { "type": "string" } }, { "name": "root_folder_id", "in": "query", "required": false, "schema": { "anyOf": [ { "type": "string" }, { "type": "null" } ] } }, { "name": "include_revoked", "in": "query", "required": false, "schema": { "anyOf": [ { "type": "boolean" }, { "type": "null" } ] } }, { "name": "limit", "in": "query", "required": false, "schema": { "anyOf": [ { "type": "integer", "minimum": 0 }, { "type": "null" } ] } }, { "name": "offset", "in": "query", "required": false, "schema": { "anyOf": [ { "type": "integer", "minimum": 0 }, { "type": "null" } ] } } ], "description": "Authorization and validation are enforced by the owning service.", "x-handler": "crate::folder_auto_join_links::list_folder_auto_join_links", "x-source-file": "crates/synckhub-server/src/routes/sharing.rs", "x-source-line": 7, "responses": { "default": { "description": "Platform error; branch on HTTP status and stable code, not the human-readable message.", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } } }, "2XX": { "description": "Successful JSON response", "content": { "application/json": { "schema": { "type": "array", "items": { "$ref": "#/components/schemas/synckhub_server.folder_auto_join_links.FolderAutoJoinLinkSummaryResponse" } } } } } } }, "head": { "operationId": "platform_head__repos__repo_id__folder_auto_join_links", "summary": "list folder auto join links", "tags": [ "sharing" ], "parameters": [ { "name": "repo_id", "in": "path", "required": true, "schema": { "type": "string" } }, { "name": "root_folder_id", "in": "query", "required": false, "schema": { "anyOf": [ { "type": "string" }, { "type": "null" } ] } }, { "name": "include_revoked", "in": "query", "required": false, "schema": { "anyOf": [ { "type": "boolean" }, { "type": "null" } ] } }, { "name": "limit", "in": "query", "required": false, "schema": { "anyOf": [ { "type": "integer", "minimum": 0 }, { "type": "null" } ] } }, { "name": "offset", "in": "query", "required": false, "schema": { "anyOf": [ { "type": "integer", "minimum": 0 }, { "type": "null" } ] } } ], "description": "Authorization and validation are enforced by the owning service.\n\nHEAD uses the GET handler and headers without a response body.", "x-handler": "crate::folder_auto_join_links::list_folder_auto_join_links", "x-source-file": "crates/synckhub-server/src/routes/sharing.rs", "x-source-line": 7, "x-implicit-head": true, "responses": { "default": { "description": "Platform error; branch on HTTP status and stable code, not the human-readable message." } } } }, "/repos/{repo_id}/folder-auto-join-links/{folder_auto_join_link_id}/revoke": { "post": { "operationId": "platform_post__repos__repo_id__folder_auto_join_links__folder_auto_join_link_id__revoke", "summary": "revoke folder auto join link", "tags": [ "sharing" ], "parameters": [ { "name": "repo_id", "in": "path", "required": true, "schema": { "type": "string" } }, { "name": "folder_auto_join_link_id", "in": "path", "required": true, "schema": { "type": "string" } } ], "description": "Authorization and validation are enforced by the owning service.", "x-handler": "crate::folder_auto_join_links::revoke_folder_auto_join_link", "x-source-file": "crates/synckhub-server/src/routes/sharing.rs", "x-source-line": 7, "responses": { "default": { "description": "Platform error; branch on HTTP status and stable code, not the human-readable message.", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } } }, "2XX": { "description": "Successful JSON response", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/synckhub_server.folder_auto_join_links.OkResponse" } } } } } } }, "/repos/{repo_id}/folder-workflow-registry": { "put": { "operationId": "platform_put__repos__repo_id__folder_workflow_registry", "summary": "put folder workflow registry", "tags": [ "cases · mod" ], "parameters": [ { "name": "repo_id", "in": "path", "required": true, "schema": { "type": "string" } } ], "description": "Authorization and validation are enforced by the owning service.", "x-handler": "put_folder_workflow_registry", "x-source-file": "crates/synckhub-server/src/routes/cases/mod.rs", "x-source-line": 17, "responses": { "default": { "description": "Platform error; branch on HTTP status and stable code, not the human-readable message.", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } } }, "2XX": { "description": "Successful JSON response", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/synckhub_server.routes.cases.workflow.FolderWorkflowRegistryResponse" } } } } }, "requestBody": { "required": true, "content": { "application/json": { "schema": { "$ref": "#/components/schemas/synckhub_server.routes.cases.workflow.FolderWorkflowRegistryDocument" } } } } }, "get": { "operationId": "platform_get__repos__repo_id__folder_workflow_registry", "summary": "get folder workflow registry", "tags": [ "cases · mod" ], "parameters": [ { "name": "repo_id", "in": "path", "required": true, "schema": { "type": "string" } } ], "description": "Authorization and validation are enforced by the owning service.", "x-handler": "get_folder_workflow_registry", "x-source-file": "crates/synckhub-server/src/routes/cases/mod.rs", "x-source-line": 17, "responses": { "default": { "description": "Platform error; branch on HTTP status and stable code, not the human-readable message.", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } } }, "2XX": { "description": "Successful JSON response", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/synckhub_server.routes.cases.workflow.FolderWorkflowRegistryResponse" } } } } } }, "head": { "operationId": "platform_head__repos__repo_id__folder_workflow_registry", "summary": "get folder workflow registry", "tags": [ "cases · mod" ], "parameters": [ { "name": "repo_id", "in": "path", "required": true, "schema": { "type": "string" } } ], "description": "Authorization and validation are enforced by the owning service.\n\nHEAD uses the GET handler and headers without a response body.", "x-handler": "get_folder_workflow_registry", "x-source-file": "crates/synckhub-server/src/routes/cases/mod.rs", "x-source-line": 17, "x-implicit-head": true, "responses": { "default": { "description": "Platform error; branch on HTTP status and stable code, not the human-readable message." } } } }, "/repos/{repo_id}/guest-intents": { "post": { "operationId": "platform_post__repos__repo_id__guest_intents", "summary": "create guest intent", "tags": [ "authz" ], "parameters": [ { "name": "repo_id", "in": "path", "required": true, "schema": { "type": "string" } } ], "description": "Authorization and validation are enforced by the owning service.", "x-handler": "create_guest_intent", "x-source-file": "crates/synckhub-server/src/routes/authz.rs", "x-source-line": 6602, "responses": { "default": { "description": "Platform error; branch on HTTP status and stable code, not the human-readable message.", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } } }, "2XX": { "description": "Successful JSON response", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/synckhub_server.routes.authz.GuestIntentResponse" } } } } }, "requestBody": { "required": true, "content": { "application/json": { "schema": { "$ref": "#/components/schemas/synckhub_server.routes.authz.GuestIntentCreateRequest" } } } } }, "get": { "operationId": "platform_get__repos__repo_id__guest_intents", "summary": "list guest intents", "tags": [ "authz" ], "parameters": [ { "name": "repo_id", "in": "path", "required": true, "schema": { "type": "string" } }, { "name": "status", "in": "query", "required": false, "schema": { "anyOf": [ { "type": "string" }, { "type": "null" } ] } } ], "description": "Authorization and validation are enforced by the owning service.", "x-handler": "list_guest_intents", "x-source-file": "crates/synckhub-server/src/routes/authz.rs", "x-source-line": 6602, "responses": { "default": { "description": "Platform error; branch on HTTP status and stable code, not the human-readable message.", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } } }, "2XX": { "description": "Successful JSON response", "content": { "application/json": { "schema": { "type": "array", "items": { "$ref": "#/components/schemas/synckhub_server.routes.authz.GuestIntentResponse" } } } } } } }, "head": { "operationId": "platform_head__repos__repo_id__guest_intents", "summary": "list guest intents", "tags": [ "authz" ], "parameters": [ { "name": "repo_id", "in": "path", "required": true, "schema": { "type": "string" } }, { "name": "status", "in": "query", "required": false, "schema": { "anyOf": [ { "type": "string" }, { "type": "null" } ] } } ], "description": "Authorization and validation are enforced by the owning service.\n\nHEAD uses the GET handler and headers without a response body.", "x-handler": "list_guest_intents", "x-source-file": "crates/synckhub-server/src/routes/authz.rs", "x-source-line": 6602, "x-implicit-head": true, "responses": { "default": { "description": "Platform error; branch on HTTP status and stable code, not the human-readable message." } } } }, "/repos/{repo_id}/guest-intents/{intent_id}/cancel": { "post": { "operationId": "platform_post__repos__repo_id__guest_intents__intent_id__cancel", "summary": "cancel guest intent", "tags": [ "authz" ], "parameters": [ { "name": "repo_id", "in": "path", "required": true, "schema": { "type": "string" } }, { "name": "intent_id", "in": "path", "required": true, "schema": { "type": "string" } } ], "description": "Authorization and validation are enforced by the owning service.", "x-handler": "cancel_guest_intent", "x-source-file": "crates/synckhub-server/src/routes/authz.rs", "x-source-line": 6602, "responses": { "default": { "description": "Platform error; branch on HTTP status and stable code, not the human-readable message.", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } } }, "2XX": { "description": "Successful JSON response", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/synckhub_server.routes.authz.GuestIntentResponse" } } } } } } }, "/repos/{repo_id}/guest-intents/{intent_id}/resend": { "post": { "operationId": "platform_post__repos__repo_id__guest_intents__intent_id__resend", "summary": "resend guest intent", "tags": [ "authz" ], "parameters": [ { "name": "repo_id", "in": "path", "required": true, "schema": { "type": "string" } }, { "name": "intent_id", "in": "path", "required": true, "schema": { "type": "string" } } ], "description": "Authorization and validation are enforced by the owning service.", "x-handler": "resend_guest_intent", "x-source-file": "crates/synckhub-server/src/routes/authz.rs", "x-source-line": 6602, "responses": { "default": { "description": "Platform error; branch on HTTP status and stable code, not the human-readable message.", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } } }, "2XX": { "description": "Successful JSON response", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/synckhub_server.routes.authz.GuestIntentResponse" } } } } } } }, "/repos/{repo_id}/integrations/api-tokens": { "post": { "operationId": "platform_post__repos__repo_id__integrations_api_tokens", "summary": "create repo api token", "tags": [ "integrations" ], "parameters": [ { "name": "repo_id", "in": "path", "required": true, "schema": { "type": "string" } } ], "description": "Authorization and validation are enforced by the owning service.", "x-handler": "create_repo_api_token", "x-source-file": "crates/synckhub-server/src/routes/integrations.rs", "x-source-line": 729, "responses": { "default": { "description": "Platform error; branch on HTTP status and stable code, not the human-readable message.", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } } }, "2XX": { "description": "Successful JSON response", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/synckhub_server.routes.integrations.RepoApiTokenCreateResponse" } } } } }, "requestBody": { "required": true, "content": { "application/json": { "schema": { "$ref": "#/components/schemas/synckhub_server.routes.integrations.CreateRepoApiTokenRequest" } } } } }, "get": { "operationId": "platform_get__repos__repo_id__integrations_api_tokens", "summary": "list repo api tokens", "tags": [ "integrations" ], "parameters": [ { "name": "repo_id", "in": "path", "required": true, "schema": { "type": "string" } } ], "description": "Authorization and validation are enforced by the owning service.", "x-handler": "list_repo_api_tokens", "x-source-file": "crates/synckhub-server/src/routes/integrations.rs", "x-source-line": 729, "responses": { "default": { "description": "Platform error; branch on HTTP status and stable code, not the human-readable message.", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } } }, "2XX": { "description": "Successful JSON response", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/synckhub_server.routes.integrations.ListRepoApiTokensResponse" } } } } } }, "head": { "operationId": "platform_head__repos__repo_id__integrations_api_tokens", "summary": "list repo api tokens", "tags": [ "integrations" ], "parameters": [ { "name": "repo_id", "in": "path", "required": true, "schema": { "type": "string" } } ], "description": "Authorization and validation are enforced by the owning service.\n\nHEAD uses the GET handler and headers without a response body.", "x-handler": "list_repo_api_tokens", "x-source-file": "crates/synckhub-server/src/routes/integrations.rs", "x-source-line": 729, "x-implicit-head": true, "responses": { "default": { "description": "Platform error; branch on HTTP status and stable code, not the human-readable message." } } } }, "/repos/{repo_id}/integrations/api-tokens/{token_id}/revoke": { "post": { "operationId": "platform_post__repos__repo_id__integrations_api_tokens__token_id__revoke", "summary": "revoke repo api token", "tags": [ "integrations" ], "parameters": [ { "name": "repo_id", "in": "path", "required": true, "schema": { "type": "string" } }, { "name": "token_id", "in": "path", "required": true, "schema": { "type": "string" } } ], "description": "Authorization and validation are enforced by the owning service.", "x-handler": "revoke_repo_api_token", "x-source-file": "crates/synckhub-server/src/routes/integrations.rs", "x-source-line": 729, "responses": { "default": { "description": "Platform error; branch on HTTP status and stable code, not the human-readable message.", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } } } } } }, "/repos/{repo_id}/integrations/api-tokens/{token_id}/rotate": { "post": { "operationId": "platform_post__repos__repo_id__integrations_api_tokens__token_id__rotate", "summary": "rotate repo api token", "tags": [ "integrations" ], "parameters": [ { "name": "repo_id", "in": "path", "required": true, "schema": { "type": "string" } }, { "name": "token_id", "in": "path", "required": true, "schema": { "type": "string" } } ], "description": "Authorization and validation are enforced by the owning service.", "x-handler": "rotate_repo_api_token", "x-source-file": "crates/synckhub-server/src/routes/integrations.rs", "x-source-line": 729, "responses": { "default": { "description": "Platform error; branch on HTTP status and stable code, not the human-readable message.", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } } }, "2XX": { "description": "Successful JSON response", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/synckhub_server.routes.integrations.RepoApiTokenRotateResponse" } } } } } } }, "/repos/{repo_id}/integrations/outbox": { "get": { "operationId": "platform_get__repos__repo_id__integrations_outbox", "summary": "get integration outbox", "tags": [ "integrations" ], "parameters": [ { "name": "repo_id", "in": "path", "required": true, "schema": { "type": "string" } }, { "name": "connector_key", "in": "query", "required": false, "schema": { "anyOf": [ { "type": "string" }, { "type": "null" } ] } }, { "name": "status", "in": "query", "required": false, "schema": { "anyOf": [ { "type": "string" }, { "type": "null" } ] } }, { "name": "limit", "in": "query", "required": false, "schema": { "anyOf": [ { "type": "integer" }, { "type": "null" } ] } } ], "description": "Authorization and validation are enforced by the owning service.", "x-handler": "get_integration_outbox", "x-source-file": "crates/synckhub-server/src/routes/integrations.rs", "x-source-line": 729, "responses": { "default": { "description": "Platform error; branch on HTTP status and stable code, not the human-readable message.", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } } }, "2XX": { "description": "Successful JSON response", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/synckhub_server.routes.integrations.ListIntegrationOutboxResponse" } } } } } }, "head": { "operationId": "platform_head__repos__repo_id__integrations_outbox", "summary": "get integration outbox", "tags": [ "integrations" ], "parameters": [ { "name": "repo_id", "in": "path", "required": true, "schema": { "type": "string" } }, { "name": "connector_key", "in": "query", "required": false, "schema": { "anyOf": [ { "type": "string" }, { "type": "null" } ] } }, { "name": "status", "in": "query", "required": false, "schema": { "anyOf": [ { "type": "string" }, { "type": "null" } ] } }, { "name": "limit", "in": "query", "required": false, "schema": { "anyOf": [ { "type": "integer" }, { "type": "null" } ] } } ], "description": "Authorization and validation are enforced by the owning service.\n\nHEAD uses the GET handler and headers without a response body.", "x-handler": "get_integration_outbox", "x-source-file": "crates/synckhub-server/src/routes/integrations.rs", "x-source-line": 729, "x-implicit-head": true, "responses": { "default": { "description": "Platform error; branch on HTTP status and stable code, not the human-readable message." } } } }, "/repos/{repo_id}/integrations/outbox/{outbox_id}/replay": { "post": { "operationId": "platform_post__repos__repo_id__integrations_outbox__outbox_id__replay", "summary": "replay integration outbox entry", "tags": [ "integrations" ], "parameters": [ { "name": "repo_id", "in": "path", "required": true, "schema": { "type": "string" } }, { "name": "outbox_id", "in": "path", "required": true, "schema": { "type": "string" } } ], "description": "Authorization and validation are enforced by the owning service.", "x-handler": "replay_integration_outbox_entry", "x-source-file": "crates/synckhub-server/src/routes/integrations.rs", "x-source-line": 729, "responses": { "default": { "description": "Platform error; branch on HTTP status and stable code, not the human-readable message.", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } } }, "2XX": { "description": "Successful JSON response", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/synckhub_server.routes.integrations.IntegrationOutboxEntry" } } } } } } }, "/repos/{repo_id}/integrations/profiles": { "get": { "operationId": "platform_get__repos__repo_id__integrations_profiles", "summary": "get integration profiles", "tags": [ "integrations" ], "parameters": [ { "name": "repo_id", "in": "path", "required": true, "schema": { "type": "string" } } ], "description": "Authorization and validation are enforced by the owning service.", "x-handler": "get_integration_profiles", "x-source-file": "crates/synckhub-server/src/routes/integrations.rs", "x-source-line": 729, "responses": { "default": { "description": "Platform error; branch on HTTP status and stable code, not the human-readable message.", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } } }, "2XX": { "description": "Successful JSON response", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/synckhub_server.routes.integrations.ListIntegrationProfilesResponse" } } } } } }, "head": { "operationId": "platform_head__repos__repo_id__integrations_profiles", "summary": "get integration profiles", "tags": [ "integrations" ], "parameters": [ { "name": "repo_id", "in": "path", "required": true, "schema": { "type": "string" } } ], "description": "Authorization and validation are enforced by the owning service.\n\nHEAD uses the GET handler and headers without a response body.", "x-handler": "get_integration_profiles", "x-source-file": "crates/synckhub-server/src/routes/integrations.rs", "x-source-line": 729, "x-implicit-head": true, "responses": { "default": { "description": "Platform error; branch on HTTP status and stable code, not the human-readable message." } } } }, "/repos/{repo_id}/integrations/profiles/{connector_key}": { "put": { "operationId": "platform_put__repos__repo_id__integrations_profiles__connector_key_", "summary": "put integration profile", "tags": [ "integrations" ], "parameters": [ { "name": "repo_id", "in": "path", "required": true, "schema": { "type": "string" } }, { "name": "connector_key", "in": "path", "required": true, "schema": { "type": "string" } } ], "description": "Authorization and validation are enforced by the owning service.", "x-handler": "put_integration_profile", "x-source-file": "crates/synckhub-server/src/routes/integrations.rs", "x-source-line": 729, "responses": { "default": { "description": "Platform error; branch on HTTP status and stable code, not the human-readable message.", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } } }, "2XX": { "description": "Successful JSON response", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/synckhub_server.routes.integrations.IntegrationProfileResponse" } } } } }, "requestBody": { "required": true, "content": { "application/json": { "schema": { "$ref": "#/components/schemas/synckhub_server.routes.integrations.PutIntegrationProfileRequest" } } } } } }, "/repos/{repo_id}/item-metadata-definitions": { "get": { "operationId": "platform_get__repos__repo_id__item_metadata_definitions", "summary": "list item metadata definitions", "tags": [ "items · metadata" ], "parameters": [ { "name": "repo_id", "in": "path", "required": true, "schema": { "type": "string" } }, { "name": "item_type", "in": "query", "required": false, "schema": { "anyOf": [ { "type": "string" }, { "type": "null" } ] } } ], "description": "Authorization and validation are enforced by the owning service.", "x-handler": "list_item_metadata_definitions", "x-source-file": "crates/synckhub-server/src/routes/items/metadata.rs", "x-source-line": 7, "responses": { "default": { "description": "Platform error; branch on HTTP status and stable code, not the human-readable message.", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } } }, "2XX": { "description": "Successful JSON response", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/synckhub_server.routes.items.metadata.ListItemMetadataDefinitionsResponse" } } } } } }, "head": { "operationId": "platform_head__repos__repo_id__item_metadata_definitions", "summary": "list item metadata definitions", "tags": [ "items · metadata" ], "parameters": [ { "name": "repo_id", "in": "path", "required": true, "schema": { "type": "string" } }, { "name": "item_type", "in": "query", "required": false, "schema": { "anyOf": [ { "type": "string" }, { "type": "null" } ] } } ], "description": "Authorization and validation are enforced by the owning service.\n\nHEAD uses the GET handler and headers without a response body.", "x-handler": "list_item_metadata_definitions", "x-source-file": "crates/synckhub-server/src/routes/items/metadata.rs", "x-source-line": 7, "x-implicit-head": true, "responses": { "default": { "description": "Platform error; branch on HTTP status and stable code, not the human-readable message." } } } }, "/repos/{repo_id}/item-metadata-definitions/{item_type}/{subtype_key}": { "delete": { "operationId": "platform_delete__repos__repo_id__item_metadata_definitions__item_type___subtype_key_", "summary": "delete item metadata definition", "tags": [ "items · metadata" ], "parameters": [ { "name": "repo_id", "in": "path", "required": true, "schema": { "type": "string" } }, { "name": "item_type", "in": "path", "required": true, "schema": { "type": "string" } }, { "name": "subtype_key", "in": "path", "required": true, "schema": { "type": "string" } } ], "description": "Authorization and validation are enforced by the owning service.", "x-handler": "delete_item_metadata_definition", "x-source-file": "crates/synckhub-server/src/routes/items/metadata.rs", "x-source-line": 7, "responses": { "default": { "description": "Platform error; branch on HTTP status and stable code, not the human-readable message.", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } } } } }, "put": { "operationId": "platform_put__repos__repo_id__item_metadata_definitions__item_type___subtype_key_", "summary": "put item metadata definition", "tags": [ "items · metadata" ], "parameters": [ { "name": "repo_id", "in": "path", "required": true, "schema": { "type": "string" } }, { "name": "item_type", "in": "path", "required": true, "schema": { "type": "string" } }, { "name": "subtype_key", "in": "path", "required": true, "schema": { "type": "string" } } ], "description": "Authorization and validation are enforced by the owning service.", "x-handler": "put_item_metadata_definition", "x-source-file": "crates/synckhub-server/src/routes/items/metadata.rs", "x-source-line": 7, "responses": { "default": { "description": "Platform error; branch on HTTP status and stable code, not the human-readable message.", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } } }, "2XX": { "description": "Successful JSON response", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/synckhub_server.routes.items.metadata.ItemSubtypeDefinitionResponse" } } } } }, "requestBody": { "required": true, "content": { "application/json": { "schema": { "$ref": "#/components/schemas/synckhub_server.routes.items.metadata.PutItemSubtypeDefinitionRequest" } } } } } }, "/repos/{repo_id}/item-metadata-definitions/{item_type}/{subtype_key}/rebuild-projection": { "post": { "operationId": "platform_post__repos__repo_id__item_metadata_definitions__item_type___subtype_key__rebuild_projection", "summary": "rebuild item metadata projection", "tags": [ "items · metadata" ], "parameters": [ { "name": "repo_id", "in": "path", "required": true, "schema": { "type": "string" } }, { "name": "item_type", "in": "path", "required": true, "schema": { "type": "string" } }, { "name": "subtype_key", "in": "path", "required": true, "schema": { "type": "string" } } ], "description": "Authorization and validation are enforced by the owning service.", "x-handler": "rebuild_item_metadata_projection", "x-source-file": "crates/synckhub-server/src/routes/items/metadata.rs", "x-source-line": 7, "responses": { "default": { "description": "Platform error; branch on HTTP status and stable code, not the human-readable message.", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } } }, "2XX": { "description": "Successful JSON response", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/synckhub_server.routes.items.metadata.ItemMetadataProjectionRebuildResponse" } } } } } } }, "/repos/{repo_id}/item-metadata-supported-item-types": { "get": { "operationId": "platform_get__repos__repo_id__item_metadata_supported_item_types", "summary": "list item metadata supported item types", "tags": [ "items · metadata" ], "parameters": [ { "name": "repo_id", "in": "path", "required": true, "schema": { "type": "string" } } ], "description": "Authorization and validation are enforced by the owning service.", "x-handler": "list_item_metadata_supported_item_types", "x-source-file": "crates/synckhub-server/src/routes/items/metadata.rs", "x-source-line": 7, "responses": { "default": { "description": "Platform error; branch on HTTP status and stable code, not the human-readable message.", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } } }, "2XX": { "description": "Successful JSON response", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/synckhub_server.routes.items.metadata.ItemMetadataSupportedItemTypesResponse" } } } } } }, "head": { "operationId": "platform_head__repos__repo_id__item_metadata_supported_item_types", "summary": "list item metadata supported item types", "tags": [ "items · metadata" ], "parameters": [ { "name": "repo_id", "in": "path", "required": true, "schema": { "type": "string" } } ], "description": "Authorization and validation are enforced by the owning service.\n\nHEAD uses the GET handler and headers without a response body.", "x-handler": "list_item_metadata_supported_item_types", "x-source-file": "crates/synckhub-server/src/routes/items/metadata.rs", "x-source-line": 7, "x-implicit-head": true, "responses": { "default": { "description": "Platform error; branch on HTTP status and stable code, not the human-readable message." } } } }, "/repos/{repo_id}/item-subtypes": { "get": { "operationId": "platform_get__repos__repo_id__item_subtypes", "summary": "retired item subtypes list", "tags": [ "items · metadata" ], "parameters": [ { "name": "repo_id", "in": "path", "required": true, "schema": { "type": "string" } } ], "description": "Authorization and validation are enforced by the owning service.", "x-handler": "retired_item_subtypes_list", "x-source-file": "crates/synckhub-server/src/routes/items/metadata.rs", "x-source-line": 7, "responses": { "default": { "description": "Platform error; branch on HTTP status and stable code, not the human-readable message.", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } } } } }, "head": { "operationId": "platform_head__repos__repo_id__item_subtypes", "summary": "retired item subtypes list", "tags": [ "items · metadata" ], "parameters": [ { "name": "repo_id", "in": "path", "required": true, "schema": { "type": "string" } } ], "description": "Authorization and validation are enforced by the owning service.\n\nHEAD uses the GET handler and headers without a response body.", "x-handler": "retired_item_subtypes_list", "x-source-file": "crates/synckhub-server/src/routes/items/metadata.rs", "x-source-line": 7, "x-implicit-head": true, "responses": { "default": { "description": "Platform error; branch on HTTP status and stable code, not the human-readable message." } } } }, "/repos/{repo_id}/item-subtypes/{item_type}/{subtype_key}": { "delete": { "operationId": "platform_delete__repos__repo_id__item_subtypes__item_type___subtype_key_", "summary": "retired item subtypes mutation delete", "tags": [ "items · metadata" ], "parameters": [ { "name": "repo_id", "in": "path", "required": true, "schema": { "type": "string" } }, { "name": "item_type", "in": "path", "required": true, "schema": { "type": "string" } }, { "name": "subtype_key", "in": "path", "required": true, "schema": { "type": "string" } } ], "description": "Authorization and validation are enforced by the owning service.", "x-handler": "retired_item_subtypes_mutation_delete", "x-source-file": "crates/synckhub-server/src/routes/items/metadata.rs", "x-source-line": 7, "responses": { "default": { "description": "Platform error; branch on HTTP status and stable code, not the human-readable message.", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } } } } }, "put": { "operationId": "platform_put__repos__repo_id__item_subtypes__item_type___subtype_key_", "summary": "retired item subtypes mutation put", "tags": [ "items · metadata" ], "parameters": [ { "name": "repo_id", "in": "path", "required": true, "schema": { "type": "string" } }, { "name": "item_type", "in": "path", "required": true, "schema": { "type": "string" } }, { "name": "subtype_key", "in": "path", "required": true, "schema": { "type": "string" } } ], "description": "Authorization and validation are enforced by the owning service.", "x-handler": "retired_item_subtypes_mutation_put", "x-source-file": "crates/synckhub-server/src/routes/items/metadata.rs", "x-source-line": 7, "responses": { "default": { "description": "Platform error; branch on HTTP status and stable code, not the human-readable message.", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } } } } } }, "/repos/{repo_id}/items": { "get": { "operationId": "platform_get__repos__repo_id__items", "summary": "List repository items", "tags": [ "items · read" ], "parameters": [ { "$ref": "#/components/parameters/RepoId" }, { "name": "item_type", "in": "query", "description": "Item-type filter. Explicit selection includes types otherwise hidden from inventory: DATABASE, TABLE, and FILE_VERSION_SET. Repeat this parameter for multiple types.", "schema": { "type": "array", "items": { "type": "string" } }, "style": "form", "explode": true, "example": [ "FILE" ] }, { "name": "item_type_exclude", "in": "query", "required": false, "schema": { "type": "array", "items": { "type": "string" } }, "style": "form", "explode": true }, { "name": "item_subtype", "in": "query", "required": false, "schema": { "type": "array", "items": { "type": "string" } }, "style": "form", "explode": true }, { "name": "case_status", "in": "query", "required": false, "schema": { "type": "array", "items": { "type": "string" } }, "style": "form", "explode": true }, { "name": "file_extension", "in": "query", "description": "Repeatable lowercase extension filter. Requires item_type=FILE.", "schema": { "type": "array", "items": { "type": "string" } }, "style": "form", "explode": true }, { "name": "file_extension_exclude", "in": "query", "required": false, "schema": { "type": "array", "items": { "type": "string" }, "description": "Optional FILE-branch exclusion (repeatable; ANY match), e.g. `file_extension_exclude=eml`." }, "style": "form", "explode": true }, { "name": "quick_access", "in": "query", "required": false, "schema": { "anyOf": [ { "type": "boolean" }, { "type": "null" } ] } }, { "name": "parent_folder_id", "in": "query", "description": "Parent folder ID. An empty value selects repository-root children; omit for all visible repository items.", "schema": { "type": "string" }, "example": "33333333-3333-4333-8333-333333333333" }, { "name": "in_trash", "in": "query", "required": false, "schema": { "anyOf": [ { "type": "boolean" }, { "type": "null" } ] } }, { "name": "tombstoned", "in": "query", "required": false, "schema": { "anyOf": [ { "type": "boolean" }, { "type": "null" } ] } }, { "name": "limit", "in": "query", "description": "Page size. Defaults to 1000.", "schema": { "type": "integer", "minimum": 1, "default": 1000 }, "example": 200 }, { "$ref": "#/components/parameters/Offset" }, { "name": "sort", "in": "query", "schema": { "type": "string", "enum": [ "name", "date", "modified", "size", "extension" ], "default": "name" } }, { "name": "order", "in": "query", "schema": { "type": "string", "enum": [ "asc", "desc" ], "default": "asc" } }, { "name": "folders_first", "in": "query", "required": false, "schema": { "anyOf": [ { "type": "boolean" }, { "type": "null" } ] } }, { "name": "after_name", "in": "query", "schema": { "type": "string" }, "description": "Pass together with the other cursor field, sort=name, order=asc, and offset=0." }, { "name": "after_item_id", "in": "query", "schema": { "type": "string" }, "description": "Pass together with the other cursor field, sort=name, order=asc, and offset=0." }, { "name": "include", "in": "query", "required": false, "schema": { "anyOf": [ { "type": "string" }, { "type": "null" } ], "description": "Optional expansions (comma-separated), e.g. `include=breadcrumbs`." } } ], "description": "Lists visible live items. Omit parent_folder_id to scan across repository folders. Without item_type, DATABASE, TABLE, and FILE_VERSION_SET are excluded; request those types explicitly to include them. For cursor paging, use sort=name, order=asc, and pass both next_cursor values as after_name and after_item_id. Do not combine a cursor with a nonzero offset. next_cursor is absent on the final cursor page. Pages are read independently, not as an atomic snapshot.", "x-handler": "list_items", "x-source-file": "crates/synckhub-server/src/routes/items/read.rs", "x-source-line": 27, "responses": { "200": { "description": "List page with another cursor page available", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/ItemList" }, "example": { "items": [ { "repo_id": "11111111-1111-4111-8111-111111111111", "item_id": "22222222-2222-4222-8222-222222222222", "item_type": "FILE", "item_subtype": "STANDARD", "name": "report.pdf", "file_extension": "pdf", "parent_folder_id": "33333333-3333-4333-8333-333333333333", "path": "33333333-3333-4333-8333-333333333333.22222222-2222-4222-8222-222222222222", "lifecycle_state": "LIVE", "size": 2048, "head_revision_item_seq": 7, "last_updated_at": "2026-10-08T10:00:00Z", "last_updated_by": "service:api-token:44444444-4444-4444-8444-444444444444", "locks": [] } ], "next_cursor": { "after_name": "report.pdf", "after_item_id": "22222222-2222-4222-8222-222222222222" } } } } }, "400": { "$ref": "#/components/responses/Error" }, "401": { "$ref": "#/components/responses/Error" }, "403": { "$ref": "#/components/responses/Error" } } }, "head": { "operationId": "platform_head__repos__repo_id__items", "summary": "list items", "tags": [ "items · read" ], "parameters": [ { "name": "repo_id", "in": "path", "required": true, "schema": { "type": "string" } }, { "name": "item_type", "in": "query", "required": false, "schema": { "type": "array", "items": { "type": "string" } }, "style": "form", "explode": true }, { "name": "item_type_exclude", "in": "query", "required": false, "schema": { "type": "array", "items": { "type": "string" } }, "style": "form", "explode": true }, { "name": "item_subtype", "in": "query", "required": false, "schema": { "type": "array", "items": { "type": "string" } }, "style": "form", "explode": true }, { "name": "case_status", "in": "query", "required": false, "schema": { "type": "array", "items": { "type": "string" } }, "style": "form", "explode": true }, { "name": "file_extension", "in": "query", "required": false, "schema": { "type": "array", "items": { "type": "string" }, "description": "Optional FILE-branch filter (repeatable; ANY match), e.g. `file_extension=pdf`.\n\nValues are normalized to lowercase ASCII and stored without a leading dot." }, "style": "form", "explode": true }, { "name": "file_extension_exclude", "in": "query", "required": false, "schema": { "type": "array", "items": { "type": "string" }, "description": "Optional FILE-branch exclusion (repeatable; ANY match), e.g. `file_extension_exclude=eml`." }, "style": "form", "explode": true }, { "name": "quick_access", "in": "query", "required": false, "schema": { "anyOf": [ { "type": "boolean" }, { "type": "null" } ] } }, { "name": "parent_folder_id", "in": "query", "required": false, "schema": { "anyOf": [ { "type": "string" }, { "type": "null" } ], "description": "Optional parent folder filter:\n- `None` means no parent filter (all items in the repo).\n- `Some(id)` means direct children of the given folder id.\n- `Some(\"\")` means root items only (no parent folder)." } }, { "name": "in_trash", "in": "query", "required": false, "schema": { "anyOf": [ { "type": "boolean" }, { "type": "null" } ] } }, { "name": "tombstoned", "in": "query", "required": false, "schema": { "anyOf": [ { "type": "boolean" }, { "type": "null" } ] } }, { "name": "limit", "in": "query", "required": false, "schema": { "anyOf": [ { "type": "integer", "minimum": 0 }, { "type": "null" } ] } }, { "name": "offset", "in": "query", "required": false, "schema": { "anyOf": [ { "type": "integer", "minimum": 0 }, { "type": "null" } ] } }, { "name": "sort", "in": "query", "required": false, "schema": { "anyOf": [ { "$ref": "#/components/schemas/synckhub_core.types.ListItemsSort" }, { "type": "null" } ] } }, { "name": "order", "in": "query", "required": false, "schema": { "anyOf": [ { "$ref": "#/components/schemas/synckhub_core.types.ListItemsOrder" }, { "type": "null" } ] } }, { "name": "folders_first", "in": "query", "required": false, "schema": { "anyOf": [ { "type": "boolean" }, { "type": "null" } ] } }, { "name": "after_name", "in": "query", "required": false, "schema": { "anyOf": [ { "type": "string" }, { "type": "null" } ] } }, { "name": "after_item_id", "in": "query", "required": false, "schema": { "anyOf": [ { "type": "string" }, { "type": "null" } ] } }, { "name": "include", "in": "query", "required": false, "schema": { "anyOf": [ { "type": "string" }, { "type": "null" } ], "description": "Optional expansions (comma-separated), e.g. `include=breadcrumbs`." } } ], "description": "Authorization and validation are enforced by the owning service.\n\nHEAD uses the GET handler and headers without a response body.", "x-handler": "list_items", "x-source-file": "crates/synckhub-server/src/routes/items/read.rs", "x-source-line": 27, "x-implicit-head": true, "responses": { "default": { "description": "Platform error; branch on HTTP status and stable code, not the human-readable message." } } } }, "/repos/{repo_id}/items/{chat_item_id}/chat/ai/assistants": { "get": { "operationId": "platform_get__repos__repo_id__items__chat_item_id__chat_ai_assistants", "summary": "ai list chat assistants", "tags": [ "ai · assistants" ], "parameters": [ { "name": "repo_id", "in": "path", "required": true, "schema": { "type": "string" } }, { "name": "chat_item_id", "in": "path", "required": true, "schema": { "type": "string" } } ], "description": "Authorization and validation are enforced by the owning service.", "x-handler": "ai_list_chat_assistants", "x-source-file": "crates/synckhub-server/src/routes/ai/assistants.rs", "x-source-line": 12, "responses": { "default": { "description": "Platform error; branch on HTTP status and stable code, not the human-readable message.", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } } }, "2XX": { "description": "Successful JSON response", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/synckhub_server.routes.ai.assistants.AiAssistantsListResponse" } } } } } }, "head": { "operationId": "platform_head__repos__repo_id__items__chat_item_id__chat_ai_assistants", "summary": "ai list chat assistants", "tags": [ "ai · assistants" ], "parameters": [ { "name": "repo_id", "in": "path", "required": true, "schema": { "type": "string" } }, { "name": "chat_item_id", "in": "path", "required": true, "schema": { "type": "string" } } ], "description": "Authorization and validation are enforced by the owning service.\n\nHEAD uses the GET handler and headers without a response body.", "x-handler": "ai_list_chat_assistants", "x-source-file": "crates/synckhub-server/src/routes/ai/assistants.rs", "x-source-line": 12, "x-implicit-head": true, "responses": { "default": { "description": "Platform error; branch on HTTP status and stable code, not the human-readable message." } } } }, "/repos/{repo_id}/items/{chat_item_id}/chat/ai/runs": { "post": { "operationId": "platform_post__repos__repo_id__items__chat_item_id__chat_ai_runs", "summary": "Create AI run", "tags": [ "ai · runs" ], "parameters": [ { "name": "repo_id", "in": "path", "required": true, "schema": { "type": "string", "format": "uuid" } }, { "name": "chat_item_id", "in": "path", "required": true, "schema": { "type": "string", "format": "uuid" } } ], "description": "Authorization and validation are enforced by the owning service.", "x-handler": "ai_create_run", "x-source-file": "crates/synckhub-server/src/routes/ai/runs.rs", "x-source-line": 15, "responses": { "200": { "description": "Run summary", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/AiRunSummaryResponse" } } } } }, "requestBody": { "required": true, "content": { "application/json": { "schema": { "$ref": "#/components/schemas/AiRunStartRequest" } } } } }, "get": { "operationId": "platform_get__repos__repo_id__items__chat_item_id__chat_ai_runs", "summary": "List AI runs for chat", "tags": [ "ai · runs" ], "parameters": [ { "name": "repo_id", "in": "path", "required": true, "schema": { "type": "string", "format": "uuid" } }, { "name": "chat_item_id", "in": "path", "required": true, "schema": { "type": "string", "format": "uuid" } }, { "name": "request_id", "in": "query", "schema": { "type": "string" }, "description": "Find an initiating-user-owned request receipt; pruned accepted history returns CONFLICT." }, { "name": "limit", "in": "query", "required": false, "schema": { "type": "integer", "minimum": 1, "maximum": 100 } } ], "description": "Authorization and validation are enforced by the owning service.", "x-handler": "ai_list_runs", "x-source-file": "crates/synckhub-server/src/routes/ai/runs.rs", "x-source-line": 15, "responses": { "200": { "description": "Runs list", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/AiRunsListResponse" } } } } } }, "head": { "operationId": "platform_head__repos__repo_id__items__chat_item_id__chat_ai_runs", "summary": "ai list runs", "tags": [ "ai · runs" ], "parameters": [ { "name": "repo_id", "in": "path", "required": true, "schema": { "type": "string" } }, { "name": "chat_item_id", "in": "path", "required": true, "schema": { "type": "string" } }, { "name": "request_id", "in": "query", "required": false, "schema": { "anyOf": [ { "type": "string" }, { "type": "null" } ] } }, { "name": "limit", "in": "query", "required": false, "schema": { "anyOf": [ { "type": "integer", "minimum": 0 }, { "type": "null" } ] } } ], "description": "Authorization and validation are enforced by the owning service.\n\nHEAD uses the GET handler and headers without a response body.", "x-handler": "ai_list_runs", "x-source-file": "crates/synckhub-server/src/routes/ai/runs.rs", "x-source-line": 15, "x-implicit-head": true, "responses": { "default": { "description": "Platform error; branch on HTTP status and stable code, not the human-readable message." } } } }, "/repos/{repo_id}/items/{chat_item_id}/chat/ai/runs/{run_id}": { "get": { "operationId": "platform_get__repos__repo_id__items__chat_item_id__chat_ai_runs__run_id_", "summary": "Get AI run state", "tags": [ "ai · runs" ], "parameters": [ { "name": "repo_id", "in": "path", "required": true, "schema": { "type": "string", "format": "uuid" } }, { "name": "chat_item_id", "in": "path", "required": true, "schema": { "type": "string", "format": "uuid" } }, { "name": "run_id", "in": "path", "required": true, "schema": { "type": "string", "format": "uuid" } } ], "description": "Authorization and validation are enforced by the owning service.", "x-handler": "ai_get_run", "x-source-file": "crates/synckhub-server/src/routes/ai/runs.rs", "x-source-line": 15, "responses": { "200": { "description": "Run state", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/AiRunStateResponse" } } } } } }, "head": { "operationId": "platform_head__repos__repo_id__items__chat_item_id__chat_ai_runs__run_id_", "summary": "ai get run", "tags": [ "ai · runs" ], "parameters": [ { "name": "repo_id", "in": "path", "required": true, "schema": { "type": "string" } }, { "name": "chat_item_id", "in": "path", "required": true, "schema": { "type": "string" } }, { "name": "run_id", "in": "path", "required": true, "schema": { "type": "string" } } ], "description": "Authorization and validation are enforced by the owning service.\n\nHEAD uses the GET handler and headers without a response body.", "x-handler": "ai_get_run", "x-source-file": "crates/synckhub-server/src/routes/ai/runs.rs", "x-source-line": 15, "x-implicit-head": true, "responses": { "default": { "description": "Platform error; branch on HTTP status and stable code, not the human-readable message." } } } }, "/repos/{repo_id}/items/{chat_item_id}/chat/ai/runs/{run_id}/cancel": { "post": { "operationId": "platform_post__repos__repo_id__items__chat_item_id__chat_ai_runs__run_id__cancel", "summary": "Request run cancellation", "tags": [ "ai · runs" ], "parameters": [ { "name": "repo_id", "in": "path", "required": true, "schema": { "type": "string", "format": "uuid" } }, { "name": "chat_item_id", "in": "path", "required": true, "schema": { "type": "string", "format": "uuid" } }, { "name": "run_id", "in": "path", "required": true, "schema": { "type": "string", "format": "uuid" } } ], "description": "Authorization and validation are enforced by the owning service.", "x-handler": "ai_cancel_run", "x-source-file": "crates/synckhub-server/src/routes/ai/runs.rs", "x-source-line": 15, "responses": { "200": { "description": "Run summary", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/AiRunSummaryResponse" } } } } } } }, "/repos/{repo_id}/items/{chat_item_id}/chat/ai/runs/{run_id}/events": { "get": { "operationId": "platform_get__repos__repo_id__items__chat_item_id__chat_ai_runs__run_id__events", "summary": "Replay run events", "tags": [ "ai · runs" ], "parameters": [ { "name": "repo_id", "in": "path", "required": true, "schema": { "type": "string", "format": "uuid" } }, { "name": "chat_item_id", "in": "path", "required": true, "schema": { "type": "string", "format": "uuid" } }, { "name": "run_id", "in": "path", "required": true, "schema": { "type": "string", "format": "uuid" } }, { "name": "after_seq", "in": "query", "required": false, "schema": { "type": "integer", "minimum": 0 } }, { "name": "limit", "in": "query", "required": false, "schema": { "type": "integer", "minimum": 1, "maximum": 1000 } } ], "description": "Authorization and validation are enforced by the owning service.", "x-handler": "ai_get_run_events", "x-source-file": "crates/synckhub-server/src/routes/ai/runs.rs", "x-source-line": 15, "responses": { "200": { "description": "Run events", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/AiRunEventsListResponse" } } } } } }, "head": { "operationId": "platform_head__repos__repo_id__items__chat_item_id__chat_ai_runs__run_id__events", "summary": "ai get run events", "tags": [ "ai · runs" ], "parameters": [ { "name": "repo_id", "in": "path", "required": true, "schema": { "type": "string" } }, { "name": "chat_item_id", "in": "path", "required": true, "schema": { "type": "string" } }, { "name": "run_id", "in": "path", "required": true, "schema": { "type": "string" } }, { "name": "after_seq", "in": "query", "required": false, "schema": { "anyOf": [ { "type": "integer" }, { "type": "null" } ] } }, { "name": "limit", "in": "query", "required": false, "schema": { "anyOf": [ { "type": "integer", "minimum": 0 }, { "type": "null" } ] } } ], "description": "Authorization and validation are enforced by the owning service.\n\nHEAD uses the GET handler and headers without a response body.", "x-handler": "ai_get_run_events", "x-source-file": "crates/synckhub-server/src/routes/ai/runs.rs", "x-source-line": 15, "x-implicit-head": true, "responses": { "default": { "description": "Platform error; branch on HTTP status and stable code, not the human-readable message." } } } }, "/repos/{repo_id}/items/{chat_item_id}/chat/ai/runs/{run_id}/retry": { "post": { "operationId": "platform_post__repos__repo_id__items__chat_item_id__chat_ai_runs__run_id__retry", "summary": "Create a safe linked retry of a failed run", "tags": [ "ai · runs" ], "parameters": [ { "name": "repo_id", "in": "path", "required": true, "schema": { "type": "string", "format": "uuid" } }, { "name": "chat_item_id", "in": "path", "required": true, "schema": { "type": "string", "format": "uuid" } }, { "name": "run_id", "in": "path", "required": true, "schema": { "type": "string", "format": "uuid" } } ], "description": "Authorization and validation are enforced by the owning service.", "x-handler": "ai_retry_run", "x-source-file": "crates/synckhub-server/src/routes/ai/runs.rs", "x-source-line": 15, "responses": { "200": { "description": "Linked retry run summary", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/AiRunSummaryResponse" } } } }, "409": { "description": "Run is not safely retryable or the request identity conflicts" } }, "requestBody": { "required": true, "content": { "application/json": { "schema": { "type": "object", "additionalProperties": false, "required": [ "request_id" ], "properties": { "request_id": { "type": "string", "minLength": 1, "maxLength": 128 } } } } } } } }, "/repos/{repo_id}/items/{chat_item_id}/chat/ai/runs/{run_id}/tool-approvals": { "post": { "operationId": "platform_post__repos__repo_id__items__chat_item_id__chat_ai_runs__run_id__tool_approvals", "summary": "Approve or deny pending tool call", "tags": [ "ai · runs" ], "parameters": [ { "name": "repo_id", "in": "path", "required": true, "schema": { "type": "string", "format": "uuid" } }, { "name": "chat_item_id", "in": "path", "required": true, "schema": { "type": "string", "format": "uuid" } }, { "name": "run_id", "in": "path", "required": true, "schema": { "type": "string", "format": "uuid" } } ], "description": "Authorization and validation are enforced by the owning service.", "x-handler": "ai_decide_tool_approval", "x-source-file": "crates/synckhub-server/src/routes/ai/runs.rs", "x-source-line": 15, "responses": { "200": { "description": "Approval decision", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/AiToolApprovalDecisionResponse" } } } } }, "requestBody": { "required": true, "content": { "application/json": { "schema": { "$ref": "#/components/schemas/AiToolApprovalDecisionRequest" } } } } } }, "/repos/{repo_id}/items/{chat_item_id}/chat/ai/transcriptions": { "post": { "operationId": "platform_post__repos__repo_id__items__chat_item_id__chat_ai_transcriptions", "summary": "Transcribe a bounded existing agent-chat dictation recording", "tags": [ "ai · transcriptions" ], "parameters": [ { "name": "repo_id", "in": "path", "required": true, "schema": { "type": "string", "format": "uuid" } }, { "name": "chat_item_id", "in": "path", "required": true, "schema": { "type": "string", "format": "uuid" } }, { "name": "X-SynckHub-Audio-Duration-Ms", "in": "header", "required": true, "schema": { "type": "integer", "minimum": 1, "maximum": 300000 } } ], "description": "Requires the same direct chat write authorization as message posting and AI-run creation. Uses the authoritative repository tenant's active OpenAI BYOK credential without requiring a Common Copilot billing snapshot. Audio and transcript content are not persisted and this operation does not create an AI run or usage-ledger entry.", "x-handler": "ai_create_chat_transcription", "x-source-file": "crates/synckhub-server/src/routes/ai/transcriptions.rs", "x-source-line": 21, "responses": { "200": { "description": "Trimmed plain-text transcript", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/AiTranscriptionResponse" } } } }, "400": { "description": "Missing/invalid duration or empty audio" }, "403": { "description": "Direct chat write access is required" }, "404": { "description": "Chat write target is not visible or does not exist" }, "409": { "description": "OpenAI credential is missing or disabled" }, "413": { "description": "Audio exceeds 10 MiB" }, "415": { "description": "Unsupported recorder media type" }, "422": { "description": "Provider produced no speech transcript" }, "429": { "description": "A transcription is already active for this user" }, "502": { "description": "Provider authentication or response failure" }, "503": { "description": "Provider is rate-limited or unavailable" }, "504": { "description": "Provider transcription timeout" } }, "requestBody": { "required": true, "content": { "audio/webm": { "schema": { "type": "string", "format": "binary", "maxLength": 10485760 } }, "audio/mp4": { "schema": { "type": "string", "format": "binary", "maxLength": 10485760 } }, "video/mp4": { "schema": { "type": "string", "format": "binary", "maxLength": 10485760 } }, "audio/x-m4a": { "schema": { "type": "string", "format": "binary", "maxLength": 10485760 } } } } } }, "/repos/{repo_id}/items/{chat_item_id}/chat/ai/workflows": { "post": { "operationId": "platform_post__repos__repo_id__items__chat_item_id__chat_ai_workflows", "summary": "ai create workflow", "tags": [ "ai · workflows" ], "parameters": [ { "name": "repo_id", "in": "path", "required": true, "schema": { "type": "string" } }, { "name": "chat_item_id", "in": "path", "required": true, "schema": { "type": "string" } } ], "description": "Authorization and validation are enforced by the owning service.", "x-handler": "ai_create_workflow", "x-source-file": "crates/synckhub-server/src/routes/ai/workflows.rs", "x-source-line": 10, "responses": { "default": { "description": "Platform error; branch on HTTP status and stable code, not the human-readable message.", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } } }, "2XX": { "description": "Successful JSON response", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/synckhub_server.routes.ai.workflows.AiWorkflowSessionResponse" } } } } }, "requestBody": { "required": true, "content": { "application/json": { "schema": { "$ref": "#/components/schemas/synckhub_server.routes.ai.workflows.AiCreateWorkflowRequest" } } } } }, "get": { "operationId": "platform_get__repos__repo_id__items__chat_item_id__chat_ai_workflows", "summary": "ai list workflows", "tags": [ "ai · workflows" ], "parameters": [ { "name": "repo_id", "in": "path", "required": true, "schema": { "type": "string" } }, { "name": "chat_item_id", "in": "path", "required": true, "schema": { "type": "string" } }, { "name": "limit", "in": "query", "required": false, "schema": { "anyOf": [ { "type": "integer", "minimum": 0 }, { "type": "null" } ] } } ], "description": "Authorization and validation are enforced by the owning service.", "x-handler": "ai_list_workflows", "x-source-file": "crates/synckhub-server/src/routes/ai/workflows.rs", "x-source-line": 10, "responses": { "default": { "description": "Platform error; branch on HTTP status and stable code, not the human-readable message.", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } } }, "2XX": { "description": "Successful JSON response", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/synckhub_server.routes.ai.workflows.AiWorkflowSessionsListResponse" } } } } } }, "head": { "operationId": "platform_head__repos__repo_id__items__chat_item_id__chat_ai_workflows", "summary": "ai list workflows", "tags": [ "ai · workflows" ], "parameters": [ { "name": "repo_id", "in": "path", "required": true, "schema": { "type": "string" } }, { "name": "chat_item_id", "in": "path", "required": true, "schema": { "type": "string" } }, { "name": "limit", "in": "query", "required": false, "schema": { "anyOf": [ { "type": "integer", "minimum": 0 }, { "type": "null" } ] } } ], "description": "Authorization and validation are enforced by the owning service.\n\nHEAD uses the GET handler and headers without a response body.", "x-handler": "ai_list_workflows", "x-source-file": "crates/synckhub-server/src/routes/ai/workflows.rs", "x-source-line": 10, "x-implicit-head": true, "responses": { "default": { "description": "Platform error; branch on HTTP status and stable code, not the human-readable message." } } } }, "/repos/{repo_id}/items/{chat_item_id}/chat/ai/workflows/{workflow_id}": { "get": { "operationId": "platform_get__repos__repo_id__items__chat_item_id__chat_ai_workflows__workflow_id_", "summary": "ai get workflow", "tags": [ "ai · workflows" ], "parameters": [ { "name": "repo_id", "in": "path", "required": true, "schema": { "type": "string" } }, { "name": "chat_item_id", "in": "path", "required": true, "schema": { "type": "string" } }, { "name": "workflow_id", "in": "path", "required": true, "schema": { "type": "string" } } ], "description": "Authorization and validation are enforced by the owning service.", "x-handler": "ai_get_workflow", "x-source-file": "crates/synckhub-server/src/routes/ai/workflows.rs", "x-source-line": 10, "responses": { "default": { "description": "Platform error; branch on HTTP status and stable code, not the human-readable message.", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } } }, "2XX": { "description": "Successful JSON response", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/synckhub_server.routes.ai.workflows.AiWorkflowSessionResponse" } } } } } }, "head": { "operationId": "platform_head__repos__repo_id__items__chat_item_id__chat_ai_workflows__workflow_id_", "summary": "ai get workflow", "tags": [ "ai · workflows" ], "parameters": [ { "name": "repo_id", "in": "path", "required": true, "schema": { "type": "string" } }, { "name": "chat_item_id", "in": "path", "required": true, "schema": { "type": "string" } }, { "name": "workflow_id", "in": "path", "required": true, "schema": { "type": "string" } } ], "description": "Authorization and validation are enforced by the owning service.\n\nHEAD uses the GET handler and headers without a response body.", "x-handler": "ai_get_workflow", "x-source-file": "crates/synckhub-server/src/routes/ai/workflows.rs", "x-source-line": 10, "x-implicit-head": true, "responses": { "default": { "description": "Platform error; branch on HTTP status and stable code, not the human-readable message." } } } }, "/repos/{repo_id}/items/{chat_item_id}/chat/ai/workflows/{workflow_id}/apply": { "post": { "operationId": "platform_post__repos__repo_id__items__chat_item_id__chat_ai_workflows__workflow_id__apply", "summary": "ai apply workflow", "tags": [ "ai · workflows" ], "parameters": [ { "name": "repo_id", "in": "path", "required": true, "schema": { "type": "string" } }, { "name": "chat_item_id", "in": "path", "required": true, "schema": { "type": "string" } }, { "name": "workflow_id", "in": "path", "required": true, "schema": { "type": "string" } } ], "description": "Authorization and validation are enforced by the owning service.", "x-handler": "ai_apply_workflow", "x-source-file": "crates/synckhub-server/src/routes/ai/workflows.rs", "x-source-line": 10, "responses": { "default": { "description": "Platform error; branch on HTTP status and stable code, not the human-readable message.", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } } }, "2XX": { "description": "Successful JSON response", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/synckhub_server.routes.ai.workflows.AiWorkflowSessionResponse" } } } } }, "requestBody": { "required": true, "content": { "application/json": { "schema": { "$ref": "#/components/schemas/synckhub_server.routes.ai.workflows.AiApplyWorkflowRequest" } } } } } }, "/repos/{repo_id}/items/{chat_item_id}/chat/attachments/{attachment_item_seq}/organize": { "post": { "operationId": "platform_post__repos__repo_id__items__chat_item_id__chat_attachments__attachment_item_seq__organize", "summary": "chat organize attachment", "tags": [ "chat · files" ], "parameters": [ { "name": "repo_id", "in": "path", "required": true, "schema": { "type": "string" } }, { "name": "chat_item_id", "in": "path", "required": true, "schema": { "type": "string" } }, { "name": "attachment_item_seq", "in": "path", "required": true, "schema": { "type": "integer" } } ], "description": "Authorization and validation are enforced by the owning service.", "x-handler": "chat_organize_attachment", "x-source-file": "crates/synckhub-server/src/routes/chat/files.rs", "x-source-line": 11, "responses": { "default": { "description": "Platform error; branch on HTTP status and stable code, not the human-readable message.", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } } }, "2XX": { "description": "Successful JSON response", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/synckhub_server.routes.chat.files.ChatAttachmentOrganizeResponse" } } } } }, "requestBody": { "required": true, "content": { "application/json": { "schema": { "$ref": "#/components/schemas/synckhub_server.routes.chat.files.ChatAttachmentOrganizeRequest" } } } } } }, "/repos/{repo_id}/items/{chat_item_id}/chat/attachments/{attachment_item_seq}/revisions": { "post": { "operationId": "platform_post__repos__repo_id__items__chat_item_id__chat_attachments__attachment_item_seq__revisions", "summary": "chat publish attachment revision", "tags": [ "chat · files" ], "parameters": [ { "name": "repo_id", "in": "path", "required": true, "schema": { "type": "string" } }, { "name": "chat_item_id", "in": "path", "required": true, "schema": { "type": "string" } }, { "name": "attachment_item_seq", "in": "path", "required": true, "schema": { "type": "integer" } } ], "description": "Authorization and validation are enforced by the owning service.", "x-handler": "chat_publish_attachment_revision", "x-source-file": "crates/synckhub-server/src/routes/chat/files.rs", "x-source-line": 11, "responses": { "default": { "description": "Platform error; branch on HTTP status and stable code, not the human-readable message.", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } } }, "2XX": { "description": "Successful JSON response", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/synckhub_core.types.SubitemSummary" } } } } }, "requestBody": { "required": true, "content": { "application/json": { "schema": { "$ref": "#/components/schemas/synckhub_server.routes.chat.files.ChatAttachmentPublishRevisionRequest" } } } } }, "get": { "operationId": "platform_get__repos__repo_id__items__chat_item_id__chat_attachments__attachment_item_seq__revisions", "summary": "chat list attachment revisions", "tags": [ "chat · files" ], "parameters": [ { "name": "repo_id", "in": "path", "required": true, "schema": { "type": "string" } }, { "name": "chat_item_id", "in": "path", "required": true, "schema": { "type": "string" } }, { "name": "attachment_item_seq", "in": "path", "required": true, "schema": { "type": "integer" } }, { "name": "limit", "in": "query", "required": false, "schema": { "anyOf": [ { "type": "integer", "minimum": 0 }, { "type": "null" } ] } }, { "name": "offset", "in": "query", "required": false, "schema": { "anyOf": [ { "type": "integer", "minimum": 0 }, { "type": "null" } ] } } ], "description": "Authorization and validation are enforced by the owning service.", "x-handler": "chat_list_attachment_revisions", "x-source-file": "crates/synckhub-server/src/routes/chat/files.rs", "x-source-line": 11, "responses": { "default": { "description": "Platform error; branch on HTTP status and stable code, not the human-readable message.", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } } }, "2XX": { "description": "Successful JSON response", "content": { "application/json": { "schema": { "type": "array", "items": { "$ref": "#/components/schemas/synckhub_core.types.ChatAttachmentRevisionSummary" } } } } } } }, "head": { "operationId": "platform_head__repos__repo_id__items__chat_item_id__chat_attachments__attachment_item_seq__revisions", "summary": "chat list attachment revisions", "tags": [ "chat · files" ], "parameters": [ { "name": "repo_id", "in": "path", "required": true, "schema": { "type": "string" } }, { "name": "chat_item_id", "in": "path", "required": true, "schema": { "type": "string" } }, { "name": "attachment_item_seq", "in": "path", "required": true, "schema": { "type": "integer" } }, { "name": "limit", "in": "query", "required": false, "schema": { "anyOf": [ { "type": "integer", "minimum": 0 }, { "type": "null" } ] } }, { "name": "offset", "in": "query", "required": false, "schema": { "anyOf": [ { "type": "integer", "minimum": 0 }, { "type": "null" } ] } } ], "description": "Authorization and validation are enforced by the owning service.\n\nHEAD uses the GET handler and headers without a response body.", "x-handler": "chat_list_attachment_revisions", "x-source-file": "crates/synckhub-server/src/routes/chat/files.rs", "x-source-line": 11, "x-implicit-head": true, "responses": { "default": { "description": "Platform error; branch on HTTP status and stable code, not the human-readable message." } } } }, "/repos/{repo_id}/items/{chat_item_id}/chat/file-folders": { "post": { "operationId": "platform_post__repos__repo_id__items__chat_item_id__chat_file_folders", "summary": "chat create file folder", "tags": [ "chat · files" ], "parameters": [ { "name": "repo_id", "in": "path", "required": true, "schema": { "type": "string" } }, { "name": "chat_item_id", "in": "path", "required": true, "schema": { "type": "string" } } ], "description": "Authorization and validation are enforced by the owning service.", "x-handler": "chat_create_file_folder", "x-source-file": "crates/synckhub-server/src/routes/chat/files.rs", "x-source-line": 11, "responses": { "default": { "description": "Platform error; branch on HTTP status and stable code, not the human-readable message.", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } } }, "2XX": { "description": "Successful JSON response", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/synckhub_server.routes.chat.files.ChatFileFolderSummary" } } } } }, "requestBody": { "required": true, "content": { "application/json": { "schema": { "$ref": "#/components/schemas/synckhub_server.routes.chat.files.ChatFileFolderWriteRequest" } } } } }, "get": { "operationId": "platform_get__repos__repo_id__items__chat_item_id__chat_file_folders", "summary": "chat list file folders", "tags": [ "chat · files" ], "parameters": [ { "name": "repo_id", "in": "path", "required": true, "schema": { "type": "string" } }, { "name": "chat_item_id", "in": "path", "required": true, "schema": { "type": "string" } } ], "description": "Authorization and validation are enforced by the owning service.", "x-handler": "chat_list_file_folders", "x-source-file": "crates/synckhub-server/src/routes/chat/files.rs", "x-source-line": 11, "responses": { "default": { "description": "Platform error; branch on HTTP status and stable code, not the human-readable message.", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } } }, "2XX": { "description": "Successful JSON response", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/synckhub_server.routes.chat.files.ChatFileFoldersResponse" } } } } } }, "head": { "operationId": "platform_head__repos__repo_id__items__chat_item_id__chat_file_folders", "summary": "chat list file folders", "tags": [ "chat · files" ], "parameters": [ { "name": "repo_id", "in": "path", "required": true, "schema": { "type": "string" } }, { "name": "chat_item_id", "in": "path", "required": true, "schema": { "type": "string" } } ], "description": "Authorization and validation are enforced by the owning service.\n\nHEAD uses the GET handler and headers without a response body.", "x-handler": "chat_list_file_folders", "x-source-file": "crates/synckhub-server/src/routes/chat/files.rs", "x-source-line": 11, "x-implicit-head": true, "responses": { "default": { "description": "Platform error; branch on HTTP status and stable code, not the human-readable message." } } } }, "/repos/{repo_id}/items/{chat_item_id}/chat/file-folders/{folder_id}": { "delete": { "operationId": "platform_delete__repos__repo_id__items__chat_item_id__chat_file_folders__folder_id_", "summary": "chat delete file folder", "tags": [ "chat · files" ], "parameters": [ { "name": "repo_id", "in": "path", "required": true, "schema": { "type": "string" } }, { "name": "chat_item_id", "in": "path", "required": true, "schema": { "type": "string" } }, { "name": "folder_id", "in": "path", "required": true, "schema": { "type": "string" } } ], "description": "Authorization and validation are enforced by the owning service.", "x-handler": "chat_delete_file_folder", "x-source-file": "crates/synckhub-server/src/routes/chat/files.rs", "x-source-line": 11, "responses": { "default": { "description": "Platform error; branch on HTTP status and stable code, not the human-readable message.", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } } }, "2XX": { "description": "Successful JSON response", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/synckhub_server.routes.chat.files.ChatFileFolderSummary" } } } } } }, "patch": { "operationId": "platform_patch__repos__repo_id__items__chat_item_id__chat_file_folders__folder_id_", "summary": "chat rename file folder", "tags": [ "chat · files" ], "parameters": [ { "name": "repo_id", "in": "path", "required": true, "schema": { "type": "string" } }, { "name": "chat_item_id", "in": "path", "required": true, "schema": { "type": "string" } }, { "name": "folder_id", "in": "path", "required": true, "schema": { "type": "string" } } ], "description": "Authorization and validation are enforced by the owning service.", "x-handler": "chat_rename_file_folder", "x-source-file": "crates/synckhub-server/src/routes/chat/files.rs", "x-source-line": 11, "responses": { "default": { "description": "Platform error; branch on HTTP status and stable code, not the human-readable message.", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } } }, "2XX": { "description": "Successful JSON response", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/synckhub_server.routes.chat.files.ChatFileFolderSummary" } } } } }, "requestBody": { "required": true, "content": { "application/json": { "schema": { "$ref": "#/components/schemas/synckhub_server.routes.chat.files.ChatFileFolderWriteRequest" } } } } }, "put": { "operationId": "platform_put__repos__repo_id__items__chat_item_id__chat_file_folders__folder_id_", "summary": "chat rename file folder", "tags": [ "chat · files" ], "parameters": [ { "name": "repo_id", "in": "path", "required": true, "schema": { "type": "string" } }, { "name": "chat_item_id", "in": "path", "required": true, "schema": { "type": "string" } }, { "name": "folder_id", "in": "path", "required": true, "schema": { "type": "string" } } ], "description": "Authorization and validation are enforced by the owning service.", "x-handler": "chat_rename_file_folder", "x-source-file": "crates/synckhub-server/src/routes/chat/files.rs", "x-source-line": 11, "responses": { "default": { "description": "Platform error; branch on HTTP status and stable code, not the human-readable message.", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } } }, "2XX": { "description": "Successful JSON response", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/synckhub_server.routes.chat.files.ChatFileFolderSummary" } } } } }, "requestBody": { "required": true, "content": { "application/json": { "schema": { "$ref": "#/components/schemas/synckhub_server.routes.chat.files.ChatFileFolderWriteRequest" } } } } } }, "/repos/{repo_id}/items/{chat_item_id}/chat/file-space/children": { "get": { "operationId": "platform_get__repos__repo_id__items__chat_item_id__chat_file_space_children", "summary": "chat file space children", "tags": [ "chat · files" ], "parameters": [ { "name": "repo_id", "in": "path", "required": true, "schema": { "type": "string" } }, { "name": "chat_item_id", "in": "path", "required": true, "schema": { "type": "string" } }, { "name": "parent_folder_id", "in": "query", "required": false, "schema": { "anyOf": [ { "type": "string" }, { "type": "null" } ] } }, { "name": "lifecycle", "in": "query", "required": false, "schema": { "anyOf": [ { "type": "string" }, { "type": "null" } ] } }, { "name": "limit", "in": "query", "required": false, "schema": { "anyOf": [ { "type": "integer", "minimum": 0 }, { "type": "null" } ] } }, { "name": "offset", "in": "query", "required": false, "schema": { "anyOf": [ { "type": "integer", "minimum": 0 }, { "type": "null" } ] } } ], "description": "Authorization and validation are enforced by the owning service.", "x-handler": "chat_file_space_children", "x-source-file": "crates/synckhub-server/src/routes/chat/files.rs", "x-source-line": 11, "responses": { "default": { "description": "Platform error; branch on HTTP status and stable code, not the human-readable message.", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } } }, "2XX": { "description": "Successful JSON response", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/synckhub_server.routes.chat.files.ChatFileChildrenResponse" } } } } } }, "head": { "operationId": "platform_head__repos__repo_id__items__chat_item_id__chat_file_space_children", "summary": "chat file space children", "tags": [ "chat · files" ], "parameters": [ { "name": "repo_id", "in": "path", "required": true, "schema": { "type": "string" } }, { "name": "chat_item_id", "in": "path", "required": true, "schema": { "type": "string" } }, { "name": "parent_folder_id", "in": "query", "required": false, "schema": { "anyOf": [ { "type": "string" }, { "type": "null" } ] } }, { "name": "lifecycle", "in": "query", "required": false, "schema": { "anyOf": [ { "type": "string" }, { "type": "null" } ] } }, { "name": "limit", "in": "query", "required": false, "schema": { "anyOf": [ { "type": "integer", "minimum": 0 }, { "type": "null" } ] } }, { "name": "offset", "in": "query", "required": false, "schema": { "anyOf": [ { "type": "integer", "minimum": 0 }, { "type": "null" } ] } } ], "description": "Authorization and validation are enforced by the owning service.\n\nHEAD uses the GET handler and headers without a response body.", "x-handler": "chat_file_space_children", "x-source-file": "crates/synckhub-server/src/routes/chat/files.rs", "x-source-line": 11, "x-implicit-head": true, "responses": { "default": { "description": "Platform error; branch on HTTP status and stable code, not the human-readable message." } } } }, "/repos/{repo_id}/items/{chat_item_id}/chat/file-space/entries/{entry_id}": { "patch": { "operationId": "platform_patch__repos__repo_id__items__chat_item_id__chat_file_space_entries__entry_id_", "summary": "chat file space update entry", "tags": [ "chat · files" ], "parameters": [ { "name": "repo_id", "in": "path", "required": true, "schema": { "type": "string" } }, { "name": "chat_item_id", "in": "path", "required": true, "schema": { "type": "string" } }, { "name": "entry_id", "in": "path", "required": true, "schema": { "type": "string" } } ], "description": "Authorization and validation are enforced by the owning service.", "x-handler": "chat_file_space_update_entry", "x-source-file": "crates/synckhub-server/src/routes/chat/files.rs", "x-source-line": 11, "responses": { "default": { "description": "Platform error; branch on HTTP status and stable code, not the human-readable message.", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } } }, "2XX": { "description": "Successful JSON response", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/synckhub_server.routes.chat.files.ChatFileEntrySummary" } } } } }, "requestBody": { "required": true, "content": { "application/json": { "schema": { "$ref": "#/components/schemas/synckhub_server.routes.chat.files.ChatFileSpaceUpdateEntryRequest" } } } } }, "get": { "operationId": "platform_get__repos__repo_id__items__chat_item_id__chat_file_space_entries__entry_id_", "summary": "chat file space entry", "tags": [ "chat · files" ], "parameters": [ { "name": "repo_id", "in": "path", "required": true, "schema": { "type": "string" } }, { "name": "chat_item_id", "in": "path", "required": true, "schema": { "type": "string" } }, { "name": "entry_id", "in": "path", "required": true, "schema": { "type": "string" } } ], "description": "Authorization and validation are enforced by the owning service.", "x-handler": "chat_file_space_entry", "x-source-file": "crates/synckhub-server/src/routes/chat/files.rs", "x-source-line": 11, "responses": { "default": { "description": "Platform error; branch on HTTP status and stable code, not the human-readable message.", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } } }, "2XX": { "description": "Successful JSON response", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/synckhub_server.routes.chat.files.ChatFileEntrySummary" } } } } } }, "head": { "operationId": "platform_head__repos__repo_id__items__chat_item_id__chat_file_space_entries__entry_id_", "summary": "chat file space entry", "tags": [ "chat · files" ], "parameters": [ { "name": "repo_id", "in": "path", "required": true, "schema": { "type": "string" } }, { "name": "chat_item_id", "in": "path", "required": true, "schema": { "type": "string" } }, { "name": "entry_id", "in": "path", "required": true, "schema": { "type": "string" } } ], "description": "Authorization and validation are enforced by the owning service.\n\nHEAD uses the GET handler and headers without a response body.", "x-handler": "chat_file_space_entry", "x-source-file": "crates/synckhub-server/src/routes/chat/files.rs", "x-source-line": 11, "x-implicit-head": true, "responses": { "default": { "description": "Platform error; branch on HTTP status and stable code, not the human-readable message." } } } }, "/repos/{repo_id}/items/{chat_item_id}/chat/file-space/entries/{entry_id}/breadcrumbs": { "get": { "operationId": "platform_get__repos__repo_id__items__chat_item_id__chat_file_space_entries__entry_id__breadcrumbs", "summary": "chat file space breadcrumbs", "tags": [ "chat · files" ], "parameters": [ { "name": "repo_id", "in": "path", "required": true, "schema": { "type": "string" } }, { "name": "chat_item_id", "in": "path", "required": true, "schema": { "type": "string" } }, { "name": "entry_id", "in": "path", "required": true, "schema": { "type": "string" } } ], "description": "Authorization and validation are enforced by the owning service.", "x-handler": "chat_file_space_breadcrumbs", "x-source-file": "crates/synckhub-server/src/routes/chat/files.rs", "x-source-line": 11, "responses": { "default": { "description": "Platform error; branch on HTTP status and stable code, not the human-readable message.", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } } }, "2XX": { "description": "Successful JSON response", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/synckhub_server.routes.chat.files.ChatFileBreadcrumbsResponse" } } } } } }, "head": { "operationId": "platform_head__repos__repo_id__items__chat_item_id__chat_file_space_entries__entry_id__breadcrumbs", "summary": "chat file space breadcrumbs", "tags": [ "chat · files" ], "parameters": [ { "name": "repo_id", "in": "path", "required": true, "schema": { "type": "string" } }, { "name": "chat_item_id", "in": "path", "required": true, "schema": { "type": "string" } }, { "name": "entry_id", "in": "path", "required": true, "schema": { "type": "string" } } ], "description": "Authorization and validation are enforced by the owning service.\n\nHEAD uses the GET handler and headers without a response body.", "x-handler": "chat_file_space_breadcrumbs", "x-source-file": "crates/synckhub-server/src/routes/chat/files.rs", "x-source-line": 11, "x-implicit-head": true, "responses": { "default": { "description": "Platform error; branch on HTTP status and stable code, not the human-readable message." } } } }, "/repos/{repo_id}/items/{chat_item_id}/chat/file-space/entries/{entry_id}/restore": { "post": { "operationId": "platform_post__repos__repo_id__items__chat_item_id__chat_file_space_entries__entry_id__restore", "summary": "chat file space restore entry", "tags": [ "chat · files" ], "parameters": [ { "name": "repo_id", "in": "path", "required": true, "schema": { "type": "string" } }, { "name": "chat_item_id", "in": "path", "required": true, "schema": { "type": "string" } }, { "name": "entry_id", "in": "path", "required": true, "schema": { "type": "string" } } ], "description": "Authorization and validation are enforced by the owning service.", "x-handler": "chat_file_space_restore_entry", "x-source-file": "crates/synckhub-server/src/routes/chat/files.rs", "x-source-line": 11, "responses": { "default": { "description": "Platform error; branch on HTTP status and stable code, not the human-readable message.", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } } }, "2XX": { "description": "Successful JSON response", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/synckhub_server.routes.chat.files.ChatFileSpaceRestoreResponse" } } } } }, "requestBody": { "required": true, "content": { "application/json": { "schema": { "$ref": "#/components/schemas/synckhub_server.routes.chat.files.ChatFileSpaceRestoreEntryRequest" } } } } } }, "/repos/{repo_id}/items/{chat_item_id}/chat/file-space/entries/{entry_id}/trash": { "post": { "operationId": "platform_post__repos__repo_id__items__chat_item_id__chat_file_space_entries__entry_id__trash", "summary": "chat file space trash entry", "tags": [ "chat · files" ], "parameters": [ { "name": "repo_id", "in": "path", "required": true, "schema": { "type": "string" } }, { "name": "chat_item_id", "in": "path", "required": true, "schema": { "type": "string" } }, { "name": "entry_id", "in": "path", "required": true, "schema": { "type": "string" } } ], "description": "Authorization and validation are enforced by the owning service.", "x-handler": "chat_file_space_trash_entry", "x-source-file": "crates/synckhub-server/src/routes/chat/files.rs", "x-source-line": 11, "responses": { "default": { "description": "Platform error; branch on HTTP status and stable code, not the human-readable message.", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } } }, "2XX": { "description": "Successful JSON response", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/synckhub_server.routes.chat.files.ChatFileSpaceTrashResponse" } } } } }, "requestBody": { "required": true, "content": { "application/json": { "schema": { "$ref": "#/components/schemas/synckhub_server.routes.chat.files.ChatFileSpaceTrashEntryRequest" } } } } } }, "/repos/{repo_id}/items/{chat_item_id}/chat/file-space/file-links": { "post": { "operationId": "platform_post__repos__repo_id__items__chat_item_id__chat_file_space_file_links", "summary": "chat file space create file link", "tags": [ "chat · files" ], "parameters": [ { "name": "repo_id", "in": "path", "required": true, "schema": { "type": "string" } }, { "name": "chat_item_id", "in": "path", "required": true, "schema": { "type": "string" } } ], "description": "Authorization and validation are enforced by the owning service.", "x-handler": "chat_file_space_create_file_link", "x-source-file": "crates/synckhub-server/src/routes/chat/files.rs", "x-source-line": 11, "responses": { "default": { "description": "Platform error; branch on HTTP status and stable code, not the human-readable message.", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } } }, "2XX": { "description": "Successful JSON response", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/synckhub_server.routes.chat.files.ChatFileEntrySummary" } } } } }, "requestBody": { "required": true, "content": { "application/json": { "schema": { "$ref": "#/components/schemas/synckhub_server.routes.chat.files.ChatFileSpaceCreateFileLinkRequest" } } } } } }, "/repos/{repo_id}/items/{chat_item_id}/chat/file-space/files": { "post": { "operationId": "platform_post__repos__repo_id__items__chat_item_id__chat_file_space_files", "summary": "chat file space create file", "tags": [ "chat · files" ], "parameters": [ { "name": "repo_id", "in": "path", "required": true, "schema": { "type": "string" } }, { "name": "chat_item_id", "in": "path", "required": true, "schema": { "type": "string" } } ], "description": "Authorization and validation are enforced by the owning service.", "x-handler": "chat_file_space_create_file", "x-source-file": "crates/synckhub-server/src/routes/chat/files.rs", "x-source-line": 11, "responses": { "default": { "description": "Platform error; branch on HTTP status and stable code, not the human-readable message.", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } } }, "2XX": { "description": "Successful JSON response", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/synckhub_server.routes.chat.files.ChatFileEntrySummary" } } } } }, "requestBody": { "required": true, "content": { "application/json": { "schema": { "$ref": "#/components/schemas/synckhub_server.routes.chat.files.ChatFileSpaceCreateFileRequest" } } } } } }, "/repos/{repo_id}/items/{chat_item_id}/chat/file-space/files/{file_id}/content": { "post": { "operationId": "platform_post__repos__repo_id__items__chat_item_id__chat_file_space_files__file_id__content", "summary": "chat file space publish file content", "tags": [ "chat · files" ], "parameters": [ { "name": "repo_id", "in": "path", "required": true, "schema": { "type": "string" } }, { "name": "chat_item_id", "in": "path", "required": true, "schema": { "type": "string" } }, { "name": "file_id", "in": "path", "required": true, "schema": { "type": "string" } } ], "description": "Authorization and validation are enforced by the owning service.", "x-handler": "chat_file_space_publish_file_content", "x-source-file": "crates/synckhub-server/src/routes/chat/files.rs", "x-source-line": 11, "responses": { "default": { "description": "Platform error; branch on HTTP status and stable code, not the human-readable message.", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } } }, "2XX": { "description": "Successful JSON response", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/synckhub_server.routes.chat.files.ChatFileEntrySummary" } } } } }, "requestBody": { "required": true, "content": { "application/json": { "schema": { "$ref": "#/components/schemas/synckhub_server.routes.chat.files.ChatFileSpacePublishContentRequest" } } } } } }, "/repos/{repo_id}/items/{chat_item_id}/chat/file-space/files/{file_id}/locks/exclusive": { "delete": { "operationId": "platform_delete__repos__repo_id__items__chat_item_id__chat_file_space_files__file_id__locks_exclusive", "summary": "chat file space release exclusive lock", "tags": [ "chat · files" ], "parameters": [ { "name": "repo_id", "in": "path", "required": true, "schema": { "type": "string" } }, { "name": "chat_item_id", "in": "path", "required": true, "schema": { "type": "string" } }, { "name": "file_id", "in": "path", "required": true, "schema": { "type": "string" } } ], "description": "Authorization and validation are enforced by the owning service.", "x-handler": "chat_file_space_release_exclusive_lock", "x-source-file": "crates/synckhub-server/src/routes/chat/files.rs", "x-source-line": 11, "responses": { "default": { "description": "Platform error; branch on HTTP status and stable code, not the human-readable message.", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } } }, "2XX": { "description": "Successful JSON response", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/synckhub_server.routes.chat.files.ChatFileReleaseLockResponse" } } } } }, "requestBody": { "required": true, "content": { "application/json": { "schema": { "$ref": "#/components/schemas/synckhub_server.routes.chat.files.ChatFileSpaceReleaseLockRequest" } } } } }, "post": { "operationId": "platform_post__repos__repo_id__items__chat_item_id__chat_file_space_files__file_id__locks_exclusive", "summary": "chat file space acquire exclusive lock", "tags": [ "chat · files" ], "parameters": [ { "name": "repo_id", "in": "path", "required": true, "schema": { "type": "string" } }, { "name": "chat_item_id", "in": "path", "required": true, "schema": { "type": "string" } }, { "name": "file_id", "in": "path", "required": true, "schema": { "type": "string" } } ], "description": "Authorization and validation are enforced by the owning service.", "x-handler": "chat_file_space_acquire_exclusive_lock", "x-source-file": "crates/synckhub-server/src/routes/chat/files.rs", "x-source-line": 11, "responses": { "default": { "description": "Platform error; branch on HTTP status and stable code, not the human-readable message.", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } } }, "2XX": { "description": "Successful JSON response", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/synckhub_server.routes.chat.files.ChatFileExclusiveLockResponse" } } } } }, "requestBody": { "required": true, "content": { "application/json": { "schema": { "$ref": "#/components/schemas/synckhub_server.routes.chat.files.ChatFileSpaceAcquireLockRequest" } } } } }, "get": { "operationId": "platform_get__repos__repo_id__items__chat_item_id__chat_file_space_files__file_id__locks_exclusive", "summary": "chat file space get exclusive lock", "tags": [ "chat · files" ], "parameters": [ { "name": "repo_id", "in": "path", "required": true, "schema": { "type": "string" } }, { "name": "chat_item_id", "in": "path", "required": true, "schema": { "type": "string" } }, { "name": "file_id", "in": "path", "required": true, "schema": { "type": "string" } } ], "description": "Authorization and validation are enforced by the owning service.", "x-handler": "chat_file_space_get_exclusive_lock", "x-source-file": "crates/synckhub-server/src/routes/chat/files.rs", "x-source-line": 11, "responses": { "default": { "description": "Platform error; branch on HTTP status and stable code, not the human-readable message.", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } } }, "2XX": { "description": "Successful JSON response", "content": { "application/json": { "schema": { "anyOf": [ { "$ref": "#/components/schemas/synckhub_server.routes.chat.files.ChatFileExclusiveLockResponse" }, { "type": "null" } ] } } } } } }, "head": { "operationId": "platform_head__repos__repo_id__items__chat_item_id__chat_file_space_files__file_id__locks_exclusive", "summary": "chat file space get exclusive lock", "tags": [ "chat · files" ], "parameters": [ { "name": "repo_id", "in": "path", "required": true, "schema": { "type": "string" } }, { "name": "chat_item_id", "in": "path", "required": true, "schema": { "type": "string" } }, { "name": "file_id", "in": "path", "required": true, "schema": { "type": "string" } } ], "description": "Authorization and validation are enforced by the owning service.\n\nHEAD uses the GET handler and headers without a response body.", "x-handler": "chat_file_space_get_exclusive_lock", "x-source-file": "crates/synckhub-server/src/routes/chat/files.rs", "x-source-line": 11, "x-implicit-head": true, "responses": { "default": { "description": "Platform error; branch on HTTP status and stable code, not the human-readable message." } } } }, "/repos/{repo_id}/items/{chat_item_id}/chat/file-space/files/{file_id}/revisions": { "get": { "operationId": "platform_get__repos__repo_id__items__chat_item_id__chat_file_space_files__file_id__revisions", "summary": "chat file space file revisions", "tags": [ "chat · files" ], "parameters": [ { "name": "repo_id", "in": "path", "required": true, "schema": { "type": "string" } }, { "name": "chat_item_id", "in": "path", "required": true, "schema": { "type": "string" } }, { "name": "file_id", "in": "path", "required": true, "schema": { "type": "string" } }, { "name": "parent_folder_id", "in": "query", "required": false, "schema": { "anyOf": [ { "type": "string" }, { "type": "null" } ] } }, { "name": "lifecycle", "in": "query", "required": false, "schema": { "anyOf": [ { "type": "string" }, { "type": "null" } ] } }, { "name": "limit", "in": "query", "required": false, "schema": { "anyOf": [ { "type": "integer", "minimum": 0 }, { "type": "null" } ] } }, { "name": "offset", "in": "query", "required": false, "schema": { "anyOf": [ { "type": "integer", "minimum": 0 }, { "type": "null" } ] } } ], "description": "Authorization and validation are enforced by the owning service.", "x-handler": "chat_file_space_file_revisions", "x-source-file": "crates/synckhub-server/src/routes/chat/files.rs", "x-source-line": 11, "responses": { "default": { "description": "Platform error; branch on HTTP status and stable code, not the human-readable message.", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } } }, "2XX": { "description": "Successful JSON response", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/synckhub_server.routes.chat.files.ChatFileRevisionsResponse" } } } } } }, "head": { "operationId": "platform_head__repos__repo_id__items__chat_item_id__chat_file_space_files__file_id__revisions", "summary": "chat file space file revisions", "tags": [ "chat · files" ], "parameters": [ { "name": "repo_id", "in": "path", "required": true, "schema": { "type": "string" } }, { "name": "chat_item_id", "in": "path", "required": true, "schema": { "type": "string" } }, { "name": "file_id", "in": "path", "required": true, "schema": { "type": "string" } }, { "name": "parent_folder_id", "in": "query", "required": false, "schema": { "anyOf": [ { "type": "string" }, { "type": "null" } ] } }, { "name": "lifecycle", "in": "query", "required": false, "schema": { "anyOf": [ { "type": "string" }, { "type": "null" } ] } }, { "name": "limit", "in": "query", "required": false, "schema": { "anyOf": [ { "type": "integer", "minimum": 0 }, { "type": "null" } ] } }, { "name": "offset", "in": "query", "required": false, "schema": { "anyOf": [ { "type": "integer", "minimum": 0 }, { "type": "null" } ] } } ], "description": "Authorization and validation are enforced by the owning service.\n\nHEAD uses the GET handler and headers without a response body.", "x-handler": "chat_file_space_file_revisions", "x-source-file": "crates/synckhub-server/src/routes/chat/files.rs", "x-source-line": 11, "x-implicit-head": true, "responses": { "default": { "description": "Platform error; branch on HTTP status and stable code, not the human-readable message." } } } }, "/repos/{repo_id}/items/{chat_item_id}/chat/file-space/files/{file_id}/revisions/{revision_item_seq}/restore": { "post": { "operationId": "platform_post__repos__repo_id__items__chat_item_id__chat_file_space_files__file_id__revisions__revision_item_seq__restore", "summary": "chat file space restore file revision", "tags": [ "chat · files" ], "parameters": [ { "name": "repo_id", "in": "path", "required": true, "schema": { "type": "string" } }, { "name": "chat_item_id", "in": "path", "required": true, "schema": { "type": "string" } }, { "name": "file_id", "in": "path", "required": true, "schema": { "type": "string" } }, { "name": "revision_item_seq", "in": "path", "required": true, "schema": { "type": "integer" } } ], "description": "Authorization and validation are enforced by the owning service.", "x-handler": "chat_file_space_restore_file_revision", "x-source-file": "crates/synckhub-server/src/routes/chat/files.rs", "x-source-line": 11, "responses": { "default": { "description": "Platform error; branch on HTTP status and stable code, not the human-readable message.", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } } }, "2XX": { "description": "Successful JSON response", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/synckhub_server.routes.chat.files.ChatFileEntrySummary" } } } } }, "requestBody": { "required": true, "content": { "application/json": { "schema": { "$ref": "#/components/schemas/synckhub_server.routes.chat.files.ChatFileSpaceRestoreRevisionRequest" } } } } } }, "/repos/{repo_id}/items/{chat_item_id}/chat/file-space/folder-manifests": { "post": { "operationId": "platform_post__repos__repo_id__items__chat_item_id__chat_file_space_folder_manifests", "summary": "chat file space create folder manifest", "tags": [ "chat · files" ], "parameters": [ { "name": "repo_id", "in": "path", "required": true, "schema": { "type": "string" } }, { "name": "chat_item_id", "in": "path", "required": true, "schema": { "type": "string" } } ], "description": "Authorization and validation are enforced by the owning service.", "x-handler": "chat_file_space_create_folder_manifest", "x-source-file": "crates/synckhub-server/src/routes/chat/files.rs", "x-source-line": 11, "responses": { "default": { "description": "Platform error; branch on HTTP status and stable code, not the human-readable message.", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } } }, "2XX": { "description": "Successful JSON response", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/synckhub_server.routes.chat.files.ChatFileSpaceFolderManifestResponse" } } } } }, "requestBody": { "required": true, "content": { "application/json": { "schema": { "$ref": "#/components/schemas/synckhub_server.routes.chat.files.ChatFileSpaceFolderManifestRequest" } } } } } }, "/repos/{repo_id}/items/{chat_item_id}/chat/file-space/folders": { "post": { "operationId": "platform_post__repos__repo_id__items__chat_item_id__chat_file_space_folders", "summary": "chat file space create folder", "tags": [ "chat · files" ], "parameters": [ { "name": "repo_id", "in": "path", "required": true, "schema": { "type": "string" } }, { "name": "chat_item_id", "in": "path", "required": true, "schema": { "type": "string" } } ], "description": "Authorization and validation are enforced by the owning service.", "x-handler": "chat_file_space_create_folder", "x-source-file": "crates/synckhub-server/src/routes/chat/files.rs", "x-source-line": 11, "responses": { "default": { "description": "Platform error; branch on HTTP status and stable code, not the human-readable message.", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } } }, "2XX": { "description": "Successful JSON response", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/synckhub_server.routes.chat.files.ChatFileEntrySummary" } } } } }, "requestBody": { "required": true, "content": { "application/json": { "schema": { "$ref": "#/components/schemas/synckhub_server.routes.chat.files.ChatFileSpaceCreateFolderRequest" } } } } } }, "/repos/{repo_id}/items/{chat_item_id}/chat/file-space/message-file-refs/{ref_item_seq}/resolve": { "get": { "operationId": "platform_get__repos__repo_id__items__chat_item_id__chat_file_space_message_file_refs__ref_item_seq__resolve", "summary": "chat file space resolve message ref", "tags": [ "chat · files" ], "parameters": [ { "name": "repo_id", "in": "path", "required": true, "schema": { "type": "string" } }, { "name": "chat_item_id", "in": "path", "required": true, "schema": { "type": "string" } }, { "name": "ref_item_seq", "in": "path", "required": true, "schema": { "type": "integer" } } ], "description": "Authorization and validation are enforced by the owning service.", "x-handler": "chat_file_space_resolve_message_ref", "x-source-file": "crates/synckhub-server/src/routes/chat/files.rs", "x-source-line": 11, "responses": { "default": { "description": "Platform error; branch on HTTP status and stable code, not the human-readable message.", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } } }, "2XX": { "description": "Successful JSON response", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/synckhub_server.routes.chat.files.ChatFileRefResolveResponse" } } } } } }, "head": { "operationId": "platform_head__repos__repo_id__items__chat_item_id__chat_file_space_message_file_refs__ref_item_seq__resolve", "summary": "chat file space resolve message ref", "tags": [ "chat · files" ], "parameters": [ { "name": "repo_id", "in": "path", "required": true, "schema": { "type": "string" } }, { "name": "chat_item_id", "in": "path", "required": true, "schema": { "type": "string" } }, { "name": "ref_item_seq", "in": "path", "required": true, "schema": { "type": "integer" } } ], "description": "Authorization and validation are enforced by the owning service.\n\nHEAD uses the GET handler and headers without a response body.", "x-handler": "chat_file_space_resolve_message_ref", "x-source-file": "crates/synckhub-server/src/routes/chat/files.rs", "x-source-line": 11, "x-implicit-head": true, "responses": { "default": { "description": "Platform error; branch on HTTP status and stable code, not the human-readable message." } } } }, "/repos/{repo_id}/items/{chat_item_id}/chat/file-space/search": { "get": { "operationId": "platform_get__repos__repo_id__items__chat_item_id__chat_file_space_search", "summary": "chat file space search", "tags": [ "chat · files" ], "parameters": [ { "name": "repo_id", "in": "path", "required": true, "schema": { "type": "string" } }, { "name": "chat_item_id", "in": "path", "required": true, "schema": { "type": "string" } }, { "name": "q", "in": "query", "required": true, "schema": { "type": "string" } }, { "name": "lifecycle", "in": "query", "required": false, "schema": { "anyOf": [ { "type": "string" }, { "type": "null" } ] } }, { "name": "limit", "in": "query", "required": false, "schema": { "anyOf": [ { "type": "integer", "minimum": 0 }, { "type": "null" } ] } }, { "name": "offset", "in": "query", "required": false, "schema": { "anyOf": [ { "type": "integer", "minimum": 0 }, { "type": "null" } ] } } ], "description": "Authorization and validation are enforced by the owning service.", "x-handler": "chat_file_space_search", "x-source-file": "crates/synckhub-server/src/routes/chat/files.rs", "x-source-line": 11, "responses": { "default": { "description": "Platform error; branch on HTTP status and stable code, not the human-readable message.", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } } }, "2XX": { "description": "Successful JSON response", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/synckhub_server.routes.chat.files.ChatFileSearchResponse" } } } } } }, "head": { "operationId": "platform_head__repos__repo_id__items__chat_item_id__chat_file_space_search", "summary": "chat file space search", "tags": [ "chat · files" ], "parameters": [ { "name": "repo_id", "in": "path", "required": true, "schema": { "type": "string" } }, { "name": "chat_item_id", "in": "path", "required": true, "schema": { "type": "string" } }, { "name": "q", "in": "query", "required": true, "schema": { "type": "string" } }, { "name": "lifecycle", "in": "query", "required": false, "schema": { "anyOf": [ { "type": "string" }, { "type": "null" } ] } }, { "name": "limit", "in": "query", "required": false, "schema": { "anyOf": [ { "type": "integer", "minimum": 0 }, { "type": "null" } ] } }, { "name": "offset", "in": "query", "required": false, "schema": { "anyOf": [ { "type": "integer", "minimum": 0 }, { "type": "null" } ] } } ], "description": "Authorization and validation are enforced by the owning service.\n\nHEAD uses the GET handler and headers without a response body.", "x-handler": "chat_file_space_search", "x-source-file": "crates/synckhub-server/src/routes/chat/files.rs", "x-source-line": 11, "x-implicit-head": true, "responses": { "default": { "description": "Platform error; branch on HTTP status and stable code, not the human-readable message." } } } }, "/repos/{repo_id}/items/{chat_item_id}/chat/files": { "get": { "operationId": "platform_get__repos__repo_id__items__chat_item_id__chat_files", "summary": "chat list files", "tags": [ "chat · files" ], "parameters": [ { "name": "repo_id", "in": "path", "required": true, "schema": { "type": "string" } }, { "name": "chat_item_id", "in": "path", "required": true, "schema": { "type": "string" } }, { "name": "folder_id", "in": "query", "required": false, "schema": { "anyOf": [ { "type": "string" }, { "type": "null" } ] } }, { "name": "kind", "in": "query", "required": false, "schema": { "anyOf": [ { "type": "string" }, { "type": "null" } ] } }, { "name": "q", "in": "query", "required": false, "schema": { "anyOf": [ { "type": "string" }, { "type": "null" } ] } }, { "name": "limit", "in": "query", "required": false, "schema": { "anyOf": [ { "type": "integer", "minimum": 0 }, { "type": "null" } ] } }, { "name": "offset", "in": "query", "required": false, "schema": { "anyOf": [ { "type": "integer", "minimum": 0 }, { "type": "null" } ] } } ], "description": "Authorization and validation are enforced by the owning service.", "x-handler": "chat_list_files", "x-source-file": "crates/synckhub-server/src/routes/chat/files.rs", "x-source-line": 11, "responses": { "default": { "description": "Platform error; branch on HTTP status and stable code, not the human-readable message.", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } } }, "2XX": { "description": "Successful JSON response", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/synckhub_server.routes.chat.files.ChatFilesResponse" } } } } } }, "head": { "operationId": "platform_head__repos__repo_id__items__chat_item_id__chat_files", "summary": "chat list files", "tags": [ "chat · files" ], "parameters": [ { "name": "repo_id", "in": "path", "required": true, "schema": { "type": "string" } }, { "name": "chat_item_id", "in": "path", "required": true, "schema": { "type": "string" } }, { "name": "folder_id", "in": "query", "required": false, "schema": { "anyOf": [ { "type": "string" }, { "type": "null" } ] } }, { "name": "kind", "in": "query", "required": false, "schema": { "anyOf": [ { "type": "string" }, { "type": "null" } ] } }, { "name": "q", "in": "query", "required": false, "schema": { "anyOf": [ { "type": "string" }, { "type": "null" } ] } }, { "name": "limit", "in": "query", "required": false, "schema": { "anyOf": [ { "type": "integer", "minimum": 0 }, { "type": "null" } ] } }, { "name": "offset", "in": "query", "required": false, "schema": { "anyOf": [ { "type": "integer", "minimum": 0 }, { "type": "null" } ] } } ], "description": "Authorization and validation are enforced by the owning service.\n\nHEAD uses the GET handler and headers without a response body.", "x-handler": "chat_list_files", "x-source-file": "crates/synckhub-server/src/routes/chat/files.rs", "x-source-line": 11, "x-implicit-head": true, "responses": { "default": { "description": "Platform error; branch on HTTP status and stable code, not the human-readable message." } } } }, "/repos/{repo_id}/items/{chat_item_id}/chat/files/{chat_file_id}/audio-preview": { "get": { "operationId": "platform_get__repos__repo_id__items__chat_item_id__chat_files__chat_file_id__audio_preview", "summary": "chat file audio preview", "tags": [ "chat · files" ], "parameters": [ { "name": "repo_id", "in": "path", "required": true, "schema": { "type": "string" } }, { "name": "chat_item_id", "in": "path", "required": true, "schema": { "type": "string" } }, { "name": "chat_file_id", "in": "path", "required": true, "schema": { "type": "string" } } ], "description": "Authorization and validation are enforced by the owning service.", "x-handler": "chat_file_audio_preview", "x-source-file": "crates/synckhub-server/src/routes/chat/files.rs", "x-source-line": 11, "responses": { "default": { "description": "Platform error; branch on HTTP status and stable code, not the human-readable message.", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } } }, "2XX": { "description": "Successful JSON response", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/synckhub_server.routes.chat.files.ChatAudioPreviewResponse" } } } } } }, "head": { "operationId": "platform_head__repos__repo_id__items__chat_item_id__chat_files__chat_file_id__audio_preview", "summary": "chat file audio preview", "tags": [ "chat · files" ], "parameters": [ { "name": "repo_id", "in": "path", "required": true, "schema": { "type": "string" } }, { "name": "chat_item_id", "in": "path", "required": true, "schema": { "type": "string" } }, { "name": "chat_file_id", "in": "path", "required": true, "schema": { "type": "string" } } ], "description": "Authorization and validation are enforced by the owning service.\n\nHEAD uses the GET handler and headers without a response body.", "x-handler": "chat_file_audio_preview", "x-source-file": "crates/synckhub-server/src/routes/chat/files.rs", "x-source-line": 11, "x-implicit-head": true, "responses": { "default": { "description": "Platform error; branch on HTTP status and stable code, not the human-readable message." } } } }, "/repos/{repo_id}/items/{chat_item_id}/chat/files/{chat_file_id}/content-url": { "get": { "operationId": "platform_get__repos__repo_id__items__chat_item_id__chat_files__chat_file_id__content_url", "summary": "chat file content url", "tags": [ "chat · files" ], "parameters": [ { "name": "repo_id", "in": "path", "required": true, "schema": { "type": "string" } }, { "name": "chat_item_id", "in": "path", "required": true, "schema": { "type": "string" } }, { "name": "chat_file_id", "in": "path", "required": true, "schema": { "type": "string" } } ], "description": "Authorization and validation are enforced by the owning service.", "x-handler": "chat_file_content_url", "x-source-file": "crates/synckhub-server/src/routes/chat/files.rs", "x-source-line": 11, "responses": { "default": { "description": "Platform error; branch on HTTP status and stable code, not the human-readable message.", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } } }, "2XX": { "description": "Successful JSON response", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/synckhub_server.routes.files.content.CreateDownloadUrlResponse" } } } } } }, "head": { "operationId": "platform_head__repos__repo_id__items__chat_item_id__chat_files__chat_file_id__content_url", "summary": "chat file content url", "tags": [ "chat · files" ], "parameters": [ { "name": "repo_id", "in": "path", "required": true, "schema": { "type": "string" } }, { "name": "chat_item_id", "in": "path", "required": true, "schema": { "type": "string" } }, { "name": "chat_file_id", "in": "path", "required": true, "schema": { "type": "string" } } ], "description": "Authorization and validation are enforced by the owning service.\n\nHEAD uses the GET handler and headers without a response body.", "x-handler": "chat_file_content_url", "x-source-file": "crates/synckhub-server/src/routes/chat/files.rs", "x-source-line": 11, "x-implicit-head": true, "responses": { "default": { "description": "Platform error; branch on HTTP status and stable code, not the human-readable message." } } } }, "/repos/{repo_id}/items/{chat_item_id}/chat/files/{chat_file_id}/thumbnail": { "get": { "operationId": "platform_get__repos__repo_id__items__chat_item_id__chat_files__chat_file_id__thumbnail", "summary": "chat file thumbnail", "tags": [ "chat · files" ], "parameters": [ { "name": "repo_id", "in": "path", "required": true, "schema": { "type": "string" } }, { "name": "chat_item_id", "in": "path", "required": true, "schema": { "type": "string" } }, { "name": "chat_file_id", "in": "path", "required": true, "schema": { "type": "string" } } ], "description": "Authorization and validation are enforced by the owning service.", "x-handler": "chat_file_thumbnail", "x-source-file": "crates/synckhub-server/src/routes/chat/files.rs", "x-source-line": 11, "responses": { "default": { "description": "Platform error; branch on HTTP status and stable code, not the human-readable message.", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } } } } }, "head": { "operationId": "platform_head__repos__repo_id__items__chat_item_id__chat_files__chat_file_id__thumbnail", "summary": "chat file thumbnail", "tags": [ "chat · files" ], "parameters": [ { "name": "repo_id", "in": "path", "required": true, "schema": { "type": "string" } }, { "name": "chat_item_id", "in": "path", "required": true, "schema": { "type": "string" } }, { "name": "chat_file_id", "in": "path", "required": true, "schema": { "type": "string" } } ], "description": "Authorization and validation are enforced by the owning service.\n\nHEAD uses the GET handler and headers without a response body.", "x-handler": "chat_file_thumbnail", "x-source-file": "crates/synckhub-server/src/routes/chat/files.rs", "x-source-line": 11, "x-implicit-head": true, "responses": { "default": { "description": "Platform error; branch on HTTP status and stable code, not the human-readable message." } } } }, "/repos/{repo_id}/items/{chat_item_id}/chat/hide": { "post": { "operationId": "platform_post__repos__repo_id__items__chat_item_id__chat_hide", "summary": "chat hide", "tags": [ "chat · rooms" ], "parameters": [ { "name": "repo_id", "in": "path", "required": true, "schema": { "type": "string" } }, { "name": "chat_item_id", "in": "path", "required": true, "schema": { "type": "string" } } ], "description": "Authorization and validation are enforced by the owning service.", "x-handler": "chat_hide", "x-source-file": "crates/synckhub-server/src/routes/chat/rooms.rs", "x-source-line": 11, "responses": { "default": { "description": "Platform error; branch on HTTP status and stable code, not the human-readable message.", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } } }, "2XX": { "description": "Successful JSON response", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/synckhub_server.routes.chat.rooms.ChatStateResponse" } } } } } } }, "/repos/{repo_id}/items/{chat_item_id}/chat/messages": { "post": { "operationId": "platform_post__repos__repo_id__items__chat_item_id__chat_messages", "summary": "Post chat message and optionally start AI run", "tags": [ "chat · messages" ], "parameters": [ { "name": "repo_id", "in": "path", "required": true, "schema": { "type": "string", "format": "uuid" } }, { "name": "chat_item_id", "in": "path", "required": true, "schema": { "type": "string", "format": "uuid" } } ], "description": "Authorization and validation are enforced by the owning service.", "x-handler": "chat_post_message", "x-source-file": "crates/synckhub-server/src/routes/chat/messages.rs", "x-source-line": 21, "responses": { "200": { "description": "Posted message summary", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/ChatPostMessageResponse" } } } } }, "requestBody": { "required": true, "content": { "application/json": { "schema": { "$ref": "#/components/schemas/ChatPostMessageRequest" } } } } }, "get": { "operationId": "platform_get__repos__repo_id__items__chat_item_id__chat_messages", "summary": "chat list messages", "tags": [ "chat · messages" ], "parameters": [ { "name": "repo_id", "in": "path", "required": true, "schema": { "type": "string" } }, { "name": "chat_item_id", "in": "path", "required": true, "schema": { "type": "string" } }, { "name": "limit", "in": "query", "required": false, "schema": { "anyOf": [ { "type": "integer", "minimum": 0 }, { "type": "null" } ] } }, { "name": "before_item_seq", "in": "query", "required": false, "schema": { "anyOf": [ { "type": "integer" }, { "type": "null" } ] } }, { "name": "after_item_seq", "in": "query", "required": false, "schema": { "anyOf": [ { "type": "integer" }, { "type": "null" } ] } }, { "name": "filter", "in": "query", "required": false, "schema": { "anyOf": [ { "$ref": "#/components/schemas/synckhub_server.routes.chat.messages.ChatMessageFilter" }, { "type": "null" } ] } } ], "description": "Authorization and validation are enforced by the owning service.", "x-handler": "chat_list_messages", "x-source-file": "crates/synckhub-server/src/routes/chat/messages.rs", "x-source-line": 21, "responses": { "default": { "description": "Platform error; branch on HTTP status and stable code, not the human-readable message.", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } } }, "2XX": { "description": "Successful JSON response", "content": { "application/json": { "schema": { "type": "array", "items": { "$ref": "#/components/schemas/synckhub_server.routes.chat.messages.ChatMessageSummary" } } } } } } }, "head": { "operationId": "platform_head__repos__repo_id__items__chat_item_id__chat_messages", "summary": "chat list messages", "tags": [ "chat · messages" ], "parameters": [ { "name": "repo_id", "in": "path", "required": true, "schema": { "type": "string" } }, { "name": "chat_item_id", "in": "path", "required": true, "schema": { "type": "string" } }, { "name": "limit", "in": "query", "required": false, "schema": { "anyOf": [ { "type": "integer", "minimum": 0 }, { "type": "null" } ] } }, { "name": "before_item_seq", "in": "query", "required": false, "schema": { "anyOf": [ { "type": "integer" }, { "type": "null" } ] } }, { "name": "after_item_seq", "in": "query", "required": false, "schema": { "anyOf": [ { "type": "integer" }, { "type": "null" } ] } }, { "name": "filter", "in": "query", "required": false, "schema": { "anyOf": [ { "$ref": "#/components/schemas/synckhub_server.routes.chat.messages.ChatMessageFilter" }, { "type": "null" } ] } } ], "description": "Authorization and validation are enforced by the owning service.\n\nHEAD uses the GET handler and headers without a response body.", "x-handler": "chat_list_messages", "x-source-file": "crates/synckhub-server/src/routes/chat/messages.rs", "x-source-line": 21, "x-implicit-head": true, "responses": { "default": { "description": "Platform error; branch on HTTP status and stable code, not the human-readable message." } } } }, "/repos/{repo_id}/items/{chat_item_id}/chat/messages/{message_item_seq}/marker": { "delete": { "operationId": "platform_delete__repos__repo_id__items__chat_item_id__chat_messages__message_item_seq__marker", "summary": "chat unmark message", "tags": [ "chat · messages" ], "parameters": [ { "name": "repo_id", "in": "path", "required": true, "schema": { "type": "string" } }, { "name": "chat_item_id", "in": "path", "required": true, "schema": { "type": "string" } }, { "name": "message_item_seq", "in": "path", "required": true, "schema": { "type": "integer" } } ], "description": "Authorization and validation are enforced by the owning service.", "x-handler": "chat_unmark_message", "x-source-file": "crates/synckhub-server/src/routes/chat/messages.rs", "x-source-line": 21, "responses": { "default": { "description": "Platform error; branch on HTTP status and stable code, not the human-readable message.", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } } }, "2XX": { "description": "Successful JSON response", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/synckhub_server.routes.chat.messages.ChatMessageMarkerResponse" } } } } } }, "put": { "operationId": "platform_put__repos__repo_id__items__chat_item_id__chat_messages__message_item_seq__marker", "summary": "chat mark message", "tags": [ "chat · messages" ], "parameters": [ { "name": "repo_id", "in": "path", "required": true, "schema": { "type": "string" } }, { "name": "chat_item_id", "in": "path", "required": true, "schema": { "type": "string" } }, { "name": "message_item_seq", "in": "path", "required": true, "schema": { "type": "integer" } } ], "description": "Authorization and validation are enforced by the owning service.", "x-handler": "chat_mark_message", "x-source-file": "crates/synckhub-server/src/routes/chat/messages.rs", "x-source-line": 21, "responses": { "default": { "description": "Platform error; branch on HTTP status and stable code, not the human-readable message.", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } } }, "2XX": { "description": "Successful JSON response", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/synckhub_server.routes.chat.messages.ChatMessageMarkerResponse" } } } } } } }, "/repos/{repo_id}/items/{chat_item_id}/chat/participants": { "post": { "operationId": "platform_post__repos__repo_id__items__chat_item_id__chat_participants", "summary": "chat add participants", "tags": [ "chat · participants" ], "parameters": [ { "name": "repo_id", "in": "path", "required": true, "schema": { "type": "string" } }, { "name": "chat_item_id", "in": "path", "required": true, "schema": { "type": "string" } } ], "description": "Authorization and validation are enforced by the owning service.", "x-handler": "chat_add_participants", "x-source-file": "crates/synckhub-server/src/routes/chat/participants.rs", "x-source-line": 10, "responses": { "default": { "description": "Platform error; branch on HTTP status and stable code, not the human-readable message.", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } } }, "2XX": { "description": "Successful JSON response", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/synckhub_server.routes.chat.participants.ChatParticipantsResponse" } } } } }, "requestBody": { "required": true, "content": { "application/json": { "schema": { "$ref": "#/components/schemas/synckhub_server.routes.chat.participants.ChatParticipantAddRequest" } } } } }, "get": { "operationId": "platform_get__repos__repo_id__items__chat_item_id__chat_participants", "summary": "chat list participants", "tags": [ "chat · participants" ], "parameters": [ { "name": "repo_id", "in": "path", "required": true, "schema": { "type": "string" } }, { "name": "chat_item_id", "in": "path", "required": true, "schema": { "type": "string" } } ], "description": "Authorization and validation are enforced by the owning service.", "x-handler": "chat_list_participants", "x-source-file": "crates/synckhub-server/src/routes/chat/participants.rs", "x-source-line": 10, "responses": { "default": { "description": "Platform error; branch on HTTP status and stable code, not the human-readable message.", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } } }, "2XX": { "description": "Successful JSON response", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/synckhub_server.routes.chat.participants.ChatParticipantsResponse" } } } } } }, "head": { "operationId": "platform_head__repos__repo_id__items__chat_item_id__chat_participants", "summary": "chat list participants", "tags": [ "chat · participants" ], "parameters": [ { "name": "repo_id", "in": "path", "required": true, "schema": { "type": "string" } }, { "name": "chat_item_id", "in": "path", "required": true, "schema": { "type": "string" } } ], "description": "Authorization and validation are enforced by the owning service.\n\nHEAD uses the GET handler and headers without a response body.", "x-handler": "chat_list_participants", "x-source-file": "crates/synckhub-server/src/routes/chat/participants.rs", "x-source-line": 10, "x-implicit-head": true, "responses": { "default": { "description": "Platform error; branch on HTTP status and stable code, not the human-readable message." } } } }, "/repos/{repo_id}/items/{chat_item_id}/chat/participants/assistants": { "post": { "operationId": "platform_post__repos__repo_id__items__chat_item_id__chat_participants_assistants", "summary": "chat add assistant participant", "tags": [ "chat · participants" ], "parameters": [ { "name": "repo_id", "in": "path", "required": true, "schema": { "type": "string" } }, { "name": "chat_item_id", "in": "path", "required": true, "schema": { "type": "string" } } ], "description": "Authorization and validation are enforced by the owning service.", "x-handler": "chat_add_assistant_participant", "x-source-file": "crates/synckhub-server/src/routes/chat/participants.rs", "x-source-line": 10, "responses": { "default": { "description": "Platform error; branch on HTTP status and stable code, not the human-readable message.", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } } }, "2XX": { "description": "Successful JSON response", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/synckhub_server.routes.chat.participants.ChatParticipantsResponse" } } } } }, "requestBody": { "required": true, "content": { "application/json": { "schema": { "$ref": "#/components/schemas/synckhub_server.routes.chat.participants.ChatAssistantParticipantRequest" } } } } } }, "/repos/{repo_id}/items/{chat_item_id}/chat/participants/assistants/{assistant_id}": { "delete": { "operationId": "platform_delete__repos__repo_id__items__chat_item_id__chat_participants_assistants__assistant_id_", "summary": "chat remove assistant participant", "tags": [ "chat · participants" ], "parameters": [ { "name": "repo_id", "in": "path", "required": true, "schema": { "type": "string" } }, { "name": "chat_item_id", "in": "path", "required": true, "schema": { "type": "string" } }, { "name": "assistant_id", "in": "path", "required": true, "schema": { "type": "string" } } ], "description": "Authorization and validation are enforced by the owning service.", "x-handler": "chat_remove_assistant_participant", "x-source-file": "crates/synckhub-server/src/routes/chat/participants.rs", "x-source-line": 10, "responses": { "default": { "description": "Platform error; branch on HTTP status and stable code, not the human-readable message.", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } } }, "2XX": { "description": "Successful JSON response", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/synckhub_server.routes.chat.participants.ChatParticipantsResponse" } } } } } } }, "/repos/{repo_id}/items/{chat_item_id}/chat/participants/intents/{intent_id}/revoke": { "post": { "operationId": "platform_post__repos__repo_id__items__chat_item_id__chat_participants_intents__intent_id__revoke", "summary": "chat revoke participant intent", "tags": [ "chat · participants" ], "parameters": [ { "name": "repo_id", "in": "path", "required": true, "schema": { "type": "string" } }, { "name": "chat_item_id", "in": "path", "required": true, "schema": { "type": "string" } }, { "name": "intent_id", "in": "path", "required": true, "schema": { "type": "string" } } ], "description": "Authorization and validation are enforced by the owning service.", "x-handler": "chat_revoke_participant_intent", "x-source-file": "crates/synckhub-server/src/routes/chat/participants.rs", "x-source-line": 10, "responses": { "default": { "description": "Platform error; branch on HTTP status and stable code, not the human-readable message.", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } } }, "2XX": { "description": "Successful JSON response", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/synckhub_server.routes.chat.participants.ChatParticipantsResponse" } } } } } } }, "/repos/{repo_id}/items/{chat_item_id}/chat/participants/join": { "post": { "operationId": "platform_post__repos__repo_id__items__chat_item_id__chat_participants_join", "summary": "chat join", "tags": [ "chat · participants" ], "parameters": [ { "name": "repo_id", "in": "path", "required": true, "schema": { "type": "string" } }, { "name": "chat_item_id", "in": "path", "required": true, "schema": { "type": "string" } } ], "description": "Authorization and validation are enforced by the owning service.", "x-handler": "chat_join", "x-source-file": "crates/synckhub-server/src/routes/chat/participants.rs", "x-source-line": 10, "responses": { "default": { "description": "Platform error; branch on HTTP status and stable code, not the human-readable message.", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } } }, "2XX": { "description": "Successful JSON response", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/synckhub_server.routes.chat.participants.ChatJoinResponse" } } } } }, "requestBody": { "required": true, "content": { "application/json": { "schema": { "$ref": "#/components/schemas/synckhub_server.routes.chat.participants.ChatMembershipCommand" } } } } } }, "/repos/{repo_id}/items/{chat_item_id}/chat/participants/leave": { "post": { "operationId": "platform_post__repos__repo_id__items__chat_item_id__chat_participants_leave", "summary": "chat leave", "tags": [ "chat · participants" ], "parameters": [ { "name": "repo_id", "in": "path", "required": true, "schema": { "type": "string" } }, { "name": "chat_item_id", "in": "path", "required": true, "schema": { "type": "string" } } ], "description": "Authorization and validation are enforced by the owning service.", "x-handler": "chat_leave", "x-source-file": "crates/synckhub-server/src/routes/chat/participants.rs", "x-source-line": 10, "responses": { "default": { "description": "Platform error; branch on HTTP status and stable code, not the human-readable message.", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } } } }, "requestBody": { "required": true, "content": { "application/json": { "schema": { "$ref": "#/components/schemas/synckhub_server.routes.chat.participants.ChatMembershipCommand" } } } } } }, "/repos/{repo_id}/items/{chat_item_id}/chat/read": { "get": { "operationId": "platform_get__repos__repo_id__items__chat_item_id__chat_read", "summary": "chat read", "tags": [ "chat · messages" ], "parameters": [ { "name": "repo_id", "in": "path", "required": true, "schema": { "type": "string" } }, { "name": "chat_item_id", "in": "path", "required": true, "schema": { "type": "string" } }, { "name": "limit", "in": "query", "required": false, "schema": { "anyOf": [ { "type": "integer", "minimum": 0 }, { "type": "null" } ] } }, { "name": "before_item_seq", "in": "query", "required": false, "schema": { "anyOf": [ { "type": "integer" }, { "type": "null" } ] } }, { "name": "after_item_seq", "in": "query", "required": false, "schema": { "anyOf": [ { "type": "integer" }, { "type": "null" } ] } }, { "name": "filter", "in": "query", "required": false, "schema": { "anyOf": [ { "$ref": "#/components/schemas/synckhub_server.routes.chat.messages.ChatMessageFilter" }, { "type": "null" } ] } } ], "description": "Authorization and validation are enforced by the owning service.", "x-handler": "chat_read", "x-source-file": "crates/synckhub-server/src/routes/chat/messages.rs", "x-source-line": 21, "responses": { "default": { "description": "Platform error; branch on HTTP status and stable code, not the human-readable message.", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } } }, "2XX": { "description": "Successful JSON response", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/synckhub_server.routes.ai.tools.ChatReadResponse" } } } } } }, "head": { "operationId": "platform_head__repos__repo_id__items__chat_item_id__chat_read", "summary": "chat read", "tags": [ "chat · messages" ], "parameters": [ { "name": "repo_id", "in": "path", "required": true, "schema": { "type": "string" } }, { "name": "chat_item_id", "in": "path", "required": true, "schema": { "type": "string" } }, { "name": "limit", "in": "query", "required": false, "schema": { "anyOf": [ { "type": "integer", "minimum": 0 }, { "type": "null" } ] } }, { "name": "before_item_seq", "in": "query", "required": false, "schema": { "anyOf": [ { "type": "integer" }, { "type": "null" } ] } }, { "name": "after_item_seq", "in": "query", "required": false, "schema": { "anyOf": [ { "type": "integer" }, { "type": "null" } ] } }, { "name": "filter", "in": "query", "required": false, "schema": { "anyOf": [ { "$ref": "#/components/schemas/synckhub_server.routes.chat.messages.ChatMessageFilter" }, { "type": "null" } ] } } ], "description": "Authorization and validation are enforced by the owning service.\n\nHEAD uses the GET handler and headers without a response body.", "x-handler": "chat_read", "x-source-file": "crates/synckhub-server/src/routes/chat/messages.rs", "x-source-line": 21, "x-implicit-head": true, "responses": { "default": { "description": "Platform error; branch on HTTP status and stable code, not the human-readable message." } } } }, "/repos/{repo_id}/items/{chat_item_id}/chat/read-state": { "post": { "operationId": "platform_post__repos__repo_id__items__chat_item_id__chat_read_state", "summary": "chat set read state", "tags": [ "chat · rooms" ], "parameters": [ { "name": "repo_id", "in": "path", "required": true, "schema": { "type": "string" } }, { "name": "chat_item_id", "in": "path", "required": true, "schema": { "type": "string" } } ], "description": "Authorization and validation are enforced by the owning service.", "x-handler": "chat_set_read_state", "x-source-file": "crates/synckhub-server/src/routes/chat/rooms.rs", "x-source-line": 11, "responses": { "default": { "description": "Platform error; branch on HTTP status and stable code, not the human-readable message.", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } } }, "2XX": { "description": "Successful JSON response", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/synckhub_server.routes.chat.rooms.ChatSetReadStateResponse" } } } } }, "requestBody": { "required": true, "content": { "application/json": { "schema": { "$ref": "#/components/schemas/synckhub_server.routes.chat.rooms.ChatSetReadStateRequest" } } } } } }, "/repos/{repo_id}/items/{chat_item_id}/chat/read-states": { "get": { "operationId": "platform_get__repos__repo_id__items__chat_item_id__chat_read_states", "summary": "chat list read states", "tags": [ "chat · rooms" ], "parameters": [ { "name": "repo_id", "in": "path", "required": true, "schema": { "type": "string" } }, { "name": "chat_item_id", "in": "path", "required": true, "schema": { "type": "string" } }, { "name": "limit", "in": "query", "required": false, "schema": { "anyOf": [ { "type": "integer", "minimum": 0 }, { "type": "null" } ] } }, { "name": "offset", "in": "query", "required": false, "schema": { "anyOf": [ { "type": "integer", "minimum": 0 }, { "type": "null" } ] } } ], "description": "Authorization and validation are enforced by the owning service.", "x-handler": "chat_list_read_states", "x-source-file": "crates/synckhub-server/src/routes/chat/rooms.rs", "x-source-line": 11, "responses": { "default": { "description": "Platform error; branch on HTTP status and stable code, not the human-readable message.", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } } }, "2XX": { "description": "Successful JSON response", "content": { "application/json": { "schema": { "type": "array", "items": { "$ref": "#/components/schemas/synckhub_server.routes.chat.rooms.ChatReadStateEntry" } } } } } } }, "head": { "operationId": "platform_head__repos__repo_id__items__chat_item_id__chat_read_states", "summary": "chat list read states", "tags": [ "chat · rooms" ], "parameters": [ { "name": "repo_id", "in": "path", "required": true, "schema": { "type": "string" } }, { "name": "chat_item_id", "in": "path", "required": true, "schema": { "type": "string" } }, { "name": "limit", "in": "query", "required": false, "schema": { "anyOf": [ { "type": "integer", "minimum": 0 }, { "type": "null" } ] } }, { "name": "offset", "in": "query", "required": false, "schema": { "anyOf": [ { "type": "integer", "minimum": 0 }, { "type": "null" } ] } } ], "description": "Authorization and validation are enforced by the owning service.\n\nHEAD uses the GET handler and headers without a response body.", "x-handler": "chat_list_read_states", "x-source-file": "crates/synckhub-server/src/routes/chat/rooms.rs", "x-source-line": 11, "x-implicit-head": true, "responses": { "default": { "description": "Platform error; branch on HTTP status and stable code, not the human-readable message." } } } }, "/repos/{repo_id}/items/{chat_item_id}/chat/realtime/events": { "get": { "operationId": "platform_get__repos__repo_id__items__chat_item_id__chat_realtime_events", "summary": "realtime chat events", "tags": [ "chat · rooms" ], "parameters": [ { "name": "repo_id", "in": "path", "required": true, "schema": { "type": "string" } }, { "name": "chat_item_id", "in": "path", "required": true, "schema": { "type": "string" } } ], "description": "Authorization and validation are enforced by the owning service.", "x-handler": "realtime_chat_events", "x-source-file": "crates/synckhub-server/src/routes/chat/rooms.rs", "x-source-line": 11, "responses": { "default": { "description": "Platform error; branch on HTTP status and stable code, not the human-readable message.", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } } } } }, "head": { "operationId": "platform_head__repos__repo_id__items__chat_item_id__chat_realtime_events", "summary": "realtime chat events", "tags": [ "chat · rooms" ], "parameters": [ { "name": "repo_id", "in": "path", "required": true, "schema": { "type": "string" } }, { "name": "chat_item_id", "in": "path", "required": true, "schema": { "type": "string" } } ], "description": "Authorization and validation are enforced by the owning service.\n\nHEAD uses the GET handler and headers without a response body.", "x-handler": "realtime_chat_events", "x-source-file": "crates/synckhub-server/src/routes/chat/rooms.rs", "x-source-line": 11, "x-implicit-head": true, "responses": { "default": { "description": "Platform error; branch on HTTP status and stable code, not the human-readable message." } } } }, "/repos/{repo_id}/items/{chat_item_id}/chat/search": { "get": { "operationId": "platform_get__repos__repo_id__items__chat_item_id__chat_search", "summary": "chat search", "tags": [ "chat · messages" ], "parameters": [ { "name": "repo_id", "in": "path", "required": true, "schema": { "type": "string" } }, { "name": "chat_item_id", "in": "path", "required": true, "schema": { "type": "string" } }, { "name": "q", "in": "query", "required": true, "schema": { "type": "string" } }, { "name": "limit", "in": "query", "required": false, "schema": { "anyOf": [ { "type": "integer", "minimum": 0 }, { "type": "null" } ] } }, { "name": "offset", "in": "query", "required": false, "schema": { "anyOf": [ { "type": "integer", "minimum": 0 }, { "type": "null" } ] } } ], "description": "Authorization and validation are enforced by the owning service.", "x-handler": "chat_search", "x-source-file": "crates/synckhub-server/src/routes/chat/messages.rs", "x-source-line": 21, "responses": { "default": { "description": "Platform error; branch on HTTP status and stable code, not the human-readable message.", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } } }, "2XX": { "description": "Successful JSON response", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/synckhub_server.routes.chat.messages.ChatSearchResponse" } } } } } }, "head": { "operationId": "platform_head__repos__repo_id__items__chat_item_id__chat_search", "summary": "chat search", "tags": [ "chat · messages" ], "parameters": [ { "name": "repo_id", "in": "path", "required": true, "schema": { "type": "string" } }, { "name": "chat_item_id", "in": "path", "required": true, "schema": { "type": "string" } }, { "name": "q", "in": "query", "required": true, "schema": { "type": "string" } }, { "name": "limit", "in": "query", "required": false, "schema": { "anyOf": [ { "type": "integer", "minimum": 0 }, { "type": "null" } ] } }, { "name": "offset", "in": "query", "required": false, "schema": { "anyOf": [ { "type": "integer", "minimum": 0 }, { "type": "null" } ] } } ], "description": "Authorization and validation are enforced by the owning service.\n\nHEAD uses the GET handler and headers without a response body.", "x-handler": "chat_search", "x-source-file": "crates/synckhub-server/src/routes/chat/messages.rs", "x-source-line": 21, "x-implicit-head": true, "responses": { "default": { "description": "Platform error; branch on HTTP status and stable code, not the human-readable message." } } } }, "/repos/{repo_id}/items/{chat_item_id}/chat/state": { "get": { "operationId": "platform_get__repos__repo_id__items__chat_item_id__chat_state", "summary": "chat get state", "tags": [ "chat · rooms" ], "parameters": [ { "name": "repo_id", "in": "path", "required": true, "schema": { "type": "string" } }, { "name": "chat_item_id", "in": "path", "required": true, "schema": { "type": "string" } } ], "description": "Authorization and validation are enforced by the owning service.", "x-handler": "chat_get_state", "x-source-file": "crates/synckhub-server/src/routes/chat/rooms.rs", "x-source-line": 11, "responses": { "default": { "description": "Platform error; branch on HTTP status and stable code, not the human-readable message.", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } } }, "2XX": { "description": "Successful JSON response", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/synckhub_server.routes.chat.rooms.ChatStateResponse" } } } } } }, "head": { "operationId": "platform_head__repos__repo_id__items__chat_item_id__chat_state", "summary": "chat get state", "tags": [ "chat · rooms" ], "parameters": [ { "name": "repo_id", "in": "path", "required": true, "schema": { "type": "string" } }, { "name": "chat_item_id", "in": "path", "required": true, "schema": { "type": "string" } } ], "description": "Authorization and validation are enforced by the owning service.\n\nHEAD uses the GET handler and headers without a response body.", "x-handler": "chat_get_state", "x-source-file": "crates/synckhub-server/src/routes/chat/rooms.rs", "x-source-line": 11, "x-implicit-head": true, "responses": { "default": { "description": "Platform error; branch on HTTP status and stable code, not the human-readable message." } } } }, "/repos/{repo_id}/items/{chat_item_id}/chat/typing": { "post": { "operationId": "platform_post__repos__repo_id__items__chat_item_id__chat_typing", "summary": "chat typing", "tags": [ "chat · rooms" ], "parameters": [ { "name": "repo_id", "in": "path", "required": true, "schema": { "type": "string" } }, { "name": "chat_item_id", "in": "path", "required": true, "schema": { "type": "string" } } ], "description": "Authorization and validation are enforced by the owning service.", "x-handler": "chat_typing", "x-source-file": "crates/synckhub-server/src/routes/chat/rooms.rs", "x-source-line": 11, "responses": { "default": { "description": "Platform error; branch on HTTP status and stable code, not the human-readable message.", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } } } }, "requestBody": { "required": true, "content": { "application/json": { "schema": { "$ref": "#/components/schemas/synckhub_server.routes.chat.rooms.ChatTypingRequest" } } } } } }, "/repos/{repo_id}/items/{chat_item_id}/chat/unhide": { "post": { "operationId": "platform_post__repos__repo_id__items__chat_item_id__chat_unhide", "summary": "chat unhide", "tags": [ "chat · rooms" ], "parameters": [ { "name": "repo_id", "in": "path", "required": true, "schema": { "type": "string" } }, { "name": "chat_item_id", "in": "path", "required": true, "schema": { "type": "string" } } ], "description": "Authorization and validation are enforced by the owning service.", "x-handler": "chat_unhide", "x-source-file": "crates/synckhub-server/src/routes/chat/rooms.rs", "x-source-line": 11, "responses": { "default": { "description": "Platform error; branch on HTTP status and stable code, not the human-readable message.", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } } }, "2XX": { "description": "Successful JSON response", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/synckhub_server.routes.chat.rooms.ChatStateResponse" } } } } } } }, "/repos/{repo_id}/items/{file_id}/shared-file-link": { "put": { "operationId": "platform_put__repos__repo_id__items__file_id__shared_file_link", "summary": "put shared file link", "tags": [ "sharing" ], "parameters": [ { "name": "repo_id", "in": "path", "required": true, "schema": { "type": "string" } }, { "name": "file_id", "in": "path", "required": true, "schema": { "type": "string" } } ], "description": "Authorization and validation are enforced by the owning service.", "x-handler": "crate::shared_file_links::put_shared_file_link", "x-source-file": "crates/synckhub-server/src/routes/sharing.rs", "x-source-line": 7, "responses": { "default": { "description": "Platform error; branch on HTTP status and stable code, not the human-readable message.", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } } }, "2XX": { "description": "Successful JSON response", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/synckhub_server.shared_file_links.SharedFileLinkResponse" } } } } }, "requestBody": { "required": true, "content": { "application/json": { "schema": { "$ref": "#/components/schemas/synckhub_server.shared_file_links.PutSharedFileLinkRequest" } } } } }, "get": { "operationId": "platform_get__repos__repo_id__items__file_id__shared_file_link", "summary": "get shared file link", "tags": [ "sharing" ], "parameters": [ { "name": "repo_id", "in": "path", "required": true, "schema": { "type": "string" } }, { "name": "file_id", "in": "path", "required": true, "schema": { "type": "string" } } ], "description": "Authorization and validation are enforced by the owning service.", "x-handler": "crate::shared_file_links::get_shared_file_link", "x-source-file": "crates/synckhub-server/src/routes/sharing.rs", "x-source-line": 7, "responses": { "default": { "description": "Platform error; branch on HTTP status and stable code, not the human-readable message.", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } } }, "2XX": { "description": "Successful JSON response", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/synckhub_server.shared_file_links.SharedFileLinkResponse" } } } } } }, "head": { "operationId": "platform_head__repos__repo_id__items__file_id__shared_file_link", "summary": "get shared file link", "tags": [ "sharing" ], "parameters": [ { "name": "repo_id", "in": "path", "required": true, "schema": { "type": "string" } }, { "name": "file_id", "in": "path", "required": true, "schema": { "type": "string" } } ], "description": "Authorization and validation are enforced by the owning service.\n\nHEAD uses the GET handler and headers without a response body.", "x-handler": "crate::shared_file_links::get_shared_file_link", "x-source-file": "crates/synckhub-server/src/routes/sharing.rs", "x-source-line": 7, "x-implicit-head": true, "responses": { "default": { "description": "Platform error; branch on HTTP status and stable code, not the human-readable message." } } } }, "/repos/{repo_id}/items/{item_id}": { "get": { "operationId": "platform_get__repos__repo_id__items__item_id_", "summary": "Get item metadata", "tags": [ "items · read" ], "parameters": [ { "$ref": "#/components/parameters/RepoId" }, { "$ref": "#/components/parameters/ItemId" }, { "name": "include", "in": "query", "required": false, "schema": { "anyOf": [ { "type": "string" }, { "type": "null" } ] } } ], "description": "Authorization and validation are enforced by the owning service.", "x-handler": "get_item", "x-source-file": "crates/synckhub-server/src/routes/items/read.rs", "x-source-line": 27, "responses": { "200": { "description": "Item metadata", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Item" }, "example": { "repo_id": "11111111-1111-4111-8111-111111111111", "item_id": "22222222-2222-4222-8222-222222222222", "item_type": "FILE", "item_subtype": "STANDARD", "name": "report.pdf", "file_extension": "pdf", "parent_folder_id": "33333333-3333-4333-8333-333333333333", "path": "33333333-3333-4333-8333-333333333333.22222222-2222-4222-8222-222222222222", "lifecycle_state": "LIVE", "size": 2048, "head_revision_item_seq": 7, "last_updated_at": "2026-10-08T10:00:00Z", "last_updated_by": "service:api-token:44444444-4444-4444-8444-444444444444", "locks": [] } } } }, "401": { "$ref": "#/components/responses/Error" }, "403": { "$ref": "#/components/responses/Error" }, "404": { "$ref": "#/components/responses/Error" } } }, "head": { "operationId": "platform_head__repos__repo_id__items__item_id_", "summary": "get item", "tags": [ "items · read" ], "parameters": [ { "name": "repo_id", "in": "path", "required": true, "schema": { "type": "string" } }, { "name": "item_id", "in": "path", "required": true, "schema": { "type": "string" } }, { "name": "include", "in": "query", "required": false, "schema": { "anyOf": [ { "type": "string" }, { "type": "null" } ] } } ], "description": "Authorization and validation are enforced by the owning service.\n\nHEAD uses the GET handler and headers without a response body.", "x-handler": "get_item", "x-source-file": "crates/synckhub-server/src/routes/items/read.rs", "x-source-line": 27, "x-implicit-head": true, "responses": { "default": { "description": "Platform error; branch on HTTP status and stable code, not the human-readable message." } } } }, "/repos/{repo_id}/items/{item_id}/coauthoring/sessions": { "post": { "operationId": "platform_post__repos__repo_id__items__item_id__coauthoring_sessions", "summary": "start coauthoring session", "tags": [ "coauthoring" ], "parameters": [ { "name": "repo_id", "in": "path", "required": true, "schema": { "type": "string" } }, { "name": "item_id", "in": "path", "required": true, "schema": { "type": "string" } } ], "description": "Authorization and validation are enforced by the owning service.", "x-handler": "start_coauthoring_session", "x-source-file": "crates/synckhub-server/src/routes/coauthoring.rs", "x-source-line": 66, "responses": { "default": { "description": "Platform error; branch on HTTP status and stable code, not the human-readable message.", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } } }, "2XX": { "description": "Successful JSON response", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/synckhub_server.routes.coauthoring.StartSessionResponse" } } } } }, "requestBody": { "required": true, "content": { "application/json": { "schema": { "$ref": "#/components/schemas/synckhub_server.routes.coauthoring.StartSessionRequest" } } } } } }, "/repos/{repo_id}/items/{item_id}/coauthoring/sessions/{session_id}/abandon": { "post": { "operationId": "platform_post__repos__repo_id__items__item_id__coauthoring_sessions__session_id__abandon", "summary": "abandon coauthoring session", "tags": [ "coauthoring" ], "parameters": [ { "name": "repo_id", "in": "path", "required": true, "schema": { "type": "string" } }, { "name": "item_id", "in": "path", "required": true, "schema": { "type": "string" } }, { "name": "session_id", "in": "path", "required": true, "schema": { "type": "string" } } ], "description": "Authorization and validation are enforced by the owning service.", "x-handler": "abandon_coauthoring_session", "x-source-file": "crates/synckhub-server/src/routes/coauthoring.rs", "x-source-line": 66, "responses": { "default": { "description": "Platform error; branch on HTTP status and stable code, not the human-readable message.", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } } }, "2XX": { "description": "Successful JSON response", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/synckhub_server.routes.coauthoring.AbandonSessionResponse" } } } } } } }, "/repos/{repo_id}/items/{item_id}/coauthoring/sessions/{session_id}/commit": { "post": { "operationId": "platform_post__repos__repo_id__items__item_id__coauthoring_sessions__session_id__commit", "summary": "commit coauthoring session", "tags": [ "coauthoring" ], "parameters": [ { "name": "repo_id", "in": "path", "required": true, "schema": { "type": "string" } }, { "name": "item_id", "in": "path", "required": true, "schema": { "type": "string" } }, { "name": "session_id", "in": "path", "required": true, "schema": { "type": "string" } } ], "description": "Authorization and validation are enforced by the owning service.", "x-handler": "commit_coauthoring_session", "x-source-file": "crates/synckhub-server/src/routes/coauthoring.rs", "x-source-line": 66, "responses": { "default": { "description": "Platform error; branch on HTTP status and stable code, not the human-readable message.", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } } }, "2XX": { "description": "Successful JSON response", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/synckhub_server.routes.coauthoring.CommitSessionResponse" } } } } } } }, "/repos/{repo_id}/items/{item_id}/coauthoring/sessions/{session_id}/download-url": { "get": { "operationId": "platform_get__repos__repo_id__items__item_id__coauthoring_sessions__session_id__download_url", "summary": "get coauthoring session download url", "tags": [ "coauthoring" ], "parameters": [ { "name": "repo_id", "in": "path", "required": true, "schema": { "type": "string" } }, { "name": "item_id", "in": "path", "required": true, "schema": { "type": "string" } }, { "name": "session_id", "in": "path", "required": true, "schema": { "type": "string" } } ], "description": "Authorization and validation are enforced by the owning service.", "x-handler": "get_coauthoring_session_download_url", "x-source-file": "crates/synckhub-server/src/routes/coauthoring.rs", "x-source-line": 66, "responses": { "default": { "description": "Platform error; branch on HTTP status and stable code, not the human-readable message.", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } } }, "2XX": { "description": "Successful JSON response", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/synckhub_server.routes.coauthoring.CoauthoringDownloadUrlResponse" } } } } } }, "head": { "operationId": "platform_head__repos__repo_id__items__item_id__coauthoring_sessions__session_id__download_url", "summary": "get coauthoring session download url", "tags": [ "coauthoring" ], "parameters": [ { "name": "repo_id", "in": "path", "required": true, "schema": { "type": "string" } }, { "name": "item_id", "in": "path", "required": true, "schema": { "type": "string" } }, { "name": "session_id", "in": "path", "required": true, "schema": { "type": "string" } } ], "description": "Authorization and validation are enforced by the owning service.\n\nHEAD uses the GET handler and headers without a response body.", "x-handler": "get_coauthoring_session_download_url", "x-source-file": "crates/synckhub-server/src/routes/coauthoring.rs", "x-source-line": 66, "x-implicit-head": true, "responses": { "default": { "description": "Platform error; branch on HTTP status and stable code, not the human-readable message." } } } }, "/repos/{repo_id}/items/{item_id}/conditional-write": { "post": { "operationId": "platform_post__repos__repo_id__items__item_id__conditional_write", "summary": "conditional write file", "tags": [ "files · drafts" ], "parameters": [ { "name": "repo_id", "in": "path", "required": true, "schema": { "type": "string" } }, { "name": "item_id", "in": "path", "required": true, "schema": { "type": "string" } }, { "name": "x-synck-expected-head-blob-id", "in": "header", "required": true, "schema": { "type": "string" } }, { "name": "x-synck-expected-head-item-seq", "in": "header", "required": true, "schema": { "type": "integer", "minimum": 1 } }, { "name": "x-synck-mounted-write-id", "in": "header", "required": true, "schema": { "type": "string" } }, { "name": "x-synck-content-sha256", "in": "header", "required": true, "schema": { "type": "string", "pattern": "^[0-9a-f]{64}$" } }, { "name": "x-synck-content-size", "in": "header", "required": true, "schema": { "type": "integer", "minimum": 0 } } ], "description": "Authorization and validation are enforced by the owning service.\n\nThe request body contains the raw file bytes. Expected-head headers describe the persisted head, not a draft. The content size and SHA-256 must match the bytes; mounted-write-id identifies the write for idempotent retries.", "x-handler": "conditional_write_file", "x-source-file": "crates/synckhub-server/src/routes/files/drafts.rs", "x-source-line": 11, "responses": { "default": { "description": "Platform error; branch on HTTP status and stable code, not the human-readable message.", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } } }, "2XX": { "description": "Successful JSON response", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/synckhub_server.routes.files.drafts.MountedWriteFileResponse" } } } } }, "requestBody": { "required": true, "content": { "application/octet-stream": { "schema": { "type": "string", "format": "binary" } } } } } }, "/repos/{repo_id}/items/{item_id}/content": { "get": { "operationId": "platform_get__repos__repo_id__items__item_id__content", "summary": "Download current file bytes", "tags": [ "files · content" ], "parameters": [ { "$ref": "#/components/parameters/RepoId" }, { "$ref": "#/components/parameters/ItemId" }, { "name": "chat_item_id", "in": "query", "required": false, "schema": { "anyOf": [ { "type": "string" }, { "type": "null" } ] } }, { "name": "inline_media", "in": "query", "required": false, "schema": { "type": "boolean" } }, { "name": "Range", "in": "header", "description": "A single byte range for resumable downloads.", "schema": { "type": "string" }, "example": "bytes=0-1023" } ], "description": "Returns the stored file bytes, not derived text. Supports a single Range: bytes=… request when the blob store supports seeking. Federated blob reads may reject ranges with 501 RANGE_NOT_SUPPORTED.", "x-handler": "get_item_content", "x-source-file": "crates/synckhub-server/src/routes/files/content.rs", "x-source-line": 20, "responses": { "200": { "description": "Raw file bytes", "headers": { "Content-Length": { "schema": { "type": "integer" } }, "ETag": { "description": "Quoted blob identity.", "schema": { "type": "string" } }, "Accept-Ranges": { "description": "bytes when seeking is supported; otherwise none.", "schema": { "type": "string" } } }, "content": { "application/octet-stream": { "schema": { "type": "string", "format": "binary" } } } }, "206": { "description": "Requested byte range", "headers": { "Content-Length": { "schema": { "type": "integer" } }, "ETag": { "description": "Quoted blob identity.", "schema": { "type": "string" } }, "Accept-Ranges": { "description": "bytes when seeking is supported; otherwise none.", "schema": { "type": "string" } }, "Content-Range": { "schema": { "type": "string" }, "example": "bytes 0-1023/2048" } }, "content": { "application/octet-stream": { "schema": { "type": "string", "format": "binary" } } } }, "401": { "$ref": "#/components/responses/Error" }, "403": { "$ref": "#/components/responses/Error" }, "404": { "$ref": "#/components/responses/Error" }, "416": { "description": "Invalid or unsatisfiable byte range.", "headers": { "Content-Range": { "schema": { "type": "string" }, "example": "bytes */2048" } }, "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" }, "example": { "code": "RANGE_NOT_SATISFIABLE", "message": "range not satisfiable" } } } }, "501": { "description": "Ranges are unsupported for this blob source.", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" }, "example": { "code": "RANGE_NOT_SUPPORTED", "message": "range requests are not supported for federated blob reads" } } } } } }, "head": { "operationId": "platform_head__repos__repo_id__items__item_id__content", "summary": "get item content", "tags": [ "files · content" ], "parameters": [ { "name": "repo_id", "in": "path", "required": true, "schema": { "type": "string" } }, { "name": "item_id", "in": "path", "required": true, "schema": { "type": "string" } }, { "name": "chat_item_id", "in": "query", "required": false, "schema": { "anyOf": [ { "type": "string" }, { "type": "null" } ] } }, { "name": "inline_media", "in": "query", "required": false, "schema": { "type": "boolean" } } ], "description": "Authorization and validation are enforced by the owning service.\n\nHEAD uses the GET handler and headers without a response body.", "x-handler": "get_item_content", "x-source-file": "crates/synckhub-server/src/routes/files/content.rs", "x-source-line": 20, "x-implicit-head": true, "responses": { "default": { "description": "Platform error; branch on HTTP status and stable code, not the human-readable message." } } } }, "/repos/{repo_id}/items/{item_id}/content-head": { "get": { "operationId": "platform_get__repos__repo_id__items__item_id__content_head", "summary": "get item content head", "tags": [ "files · content" ], "parameters": [ { "name": "repo_id", "in": "path", "required": true, "schema": { "type": "string" } }, { "name": "item_id", "in": "path", "required": true, "schema": { "type": "string" } }, { "name": "chat_item_id", "in": "query", "required": false, "schema": { "anyOf": [ { "type": "string" }, { "type": "null" } ] } }, { "name": "inline_media", "in": "query", "required": false, "schema": { "type": "boolean" } } ], "description": "Authorization and validation are enforced by the owning service.", "x-handler": "get_item_content_head", "x-source-file": "crates/synckhub-server/src/routes/files/content.rs", "x-source-line": 20, "responses": { "default": { "description": "Platform error; branch on HTTP status and stable code, not the human-readable message.", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } } }, "2XX": { "description": "Successful JSON response", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/synckhub_core.types.FileContentHeadSummary" } } } } } }, "head": { "operationId": "platform_head__repos__repo_id__items__item_id__content_head", "summary": "get item content head", "tags": [ "files · content" ], "parameters": [ { "name": "repo_id", "in": "path", "required": true, "schema": { "type": "string" } }, { "name": "item_id", "in": "path", "required": true, "schema": { "type": "string" } }, { "name": "chat_item_id", "in": "query", "required": false, "schema": { "anyOf": [ { "type": "string" }, { "type": "null" } ] } }, { "name": "inline_media", "in": "query", "required": false, "schema": { "type": "boolean" } } ], "description": "Authorization and validation are enforced by the owning service.\n\nHEAD uses the GET handler and headers without a response body.", "x-handler": "get_item_content_head", "x-source-file": "crates/synckhub-server/src/routes/files/content.rs", "x-source-line": 20, "x-implicit-head": true, "responses": { "default": { "description": "Platform error; branch on HTTP status and stable code, not the human-readable message." } } } }, "/repos/{repo_id}/items/{item_id}/content-revisions": { "get": { "operationId": "platform_get__repos__repo_id__items__item_id__content_revisions", "summary": "List file content revisions", "tags": [ "files · versions" ], "parameters": [ { "$ref": "#/components/parameters/RepoId" }, { "$ref": "#/components/parameters/ItemId" }, { "$ref": "#/components/parameters/Limit" }, { "$ref": "#/components/parameters/Offset" } ], "description": "Lists immutable content revisions. Named business labels are available from the file-versions endpoint.", "x-handler": "list_file_content_revisions", "x-source-file": "crates/synckhub-server/src/routes/files/versions.rs", "x-source-line": 10, "responses": { "200": { "description": "Content revisions", "content": { "application/json": { "schema": { "type": "array", "items": { "$ref": "#/components/schemas/ContentRevision" } }, "example": [ { "repo_id": "11111111-1111-4111-8111-111111111111", "item_id": "22222222-2222-4222-8222-222222222222", "item_seq": 7, "commit_id": "55555555-5555-4555-8555-555555555555", "commit_event_idx": 0, "event_type": "FILE::SET_CONTENT", "file_name": "report.pdf", "revision_origin": "LOCAL", "updated_at": "2026-10-08T10:00:00Z", "updated_by": "service:api-token:44444444-4444-4444-8444-444444444444", "suppression_state": "AVAILABLE" } ] } } }, "401": { "$ref": "#/components/responses/Error" }, "403": { "$ref": "#/components/responses/Error" }, "404": { "$ref": "#/components/responses/Error" } } }, "head": { "operationId": "platform_head__repos__repo_id__items__item_id__content_revisions", "summary": "list file content revisions", "tags": [ "files · versions" ], "parameters": [ { "name": "repo_id", "in": "path", "required": true, "schema": { "type": "string" } }, { "name": "item_id", "in": "path", "required": true, "schema": { "type": "string" } }, { "name": "limit", "in": "query", "required": false, "schema": { "anyOf": [ { "type": "integer", "minimum": 0 }, { "type": "null" } ] } }, { "name": "offset", "in": "query", "required": false, "schema": { "anyOf": [ { "type": "integer", "minimum": 0 }, { "type": "null" } ] } } ], "description": "Authorization and validation are enforced by the owning service.\n\nHEAD uses the GET handler and headers without a response body.", "x-handler": "list_file_content_revisions", "x-source-file": "crates/synckhub-server/src/routes/files/versions.rs", "x-source-line": 10, "x-implicit-head": true, "responses": { "default": { "description": "Platform error; branch on HTTP status and stable code, not the human-readable message." } } } }, "/repos/{repo_id}/items/{item_id}/content-revisions/{item_seq}": { "get": { "operationId": "platform_get__repos__repo_id__items__item_id__content_revisions__item_seq_", "summary": "Get one file content revision", "tags": [ "files · versions" ], "parameters": [ { "$ref": "#/components/parameters/RepoId" }, { "$ref": "#/components/parameters/ItemId" }, { "$ref": "#/components/parameters/ItemSeq" } ], "description": "Returns revision metadata and blob_id. Download the revision bytes from the blob endpoint.", "x-handler": "get_file_content_revision", "x-source-file": "crates/synckhub-server/src/routes/files/versions.rs", "x-source-line": 10, "responses": { "200": { "description": "Content revision", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/ContentRevisionDetail" }, "example": { "repo_id": "11111111-1111-4111-8111-111111111111", "item_id": "22222222-2222-4222-8222-222222222222", "item_seq": 7, "blob_id": "aaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaa", "size": 2048, "commit_id": "55555555-5555-4555-8555-555555555555", "commit_event_idx": 0, "updated_at": "2026-10-08T10:00:00Z", "updated_by": "service:api-token:44444444-4444-4444-8444-444444444444", "suppression_state": "AVAILABLE" } } } }, "401": { "$ref": "#/components/responses/Error" }, "403": { "$ref": "#/components/responses/Error" }, "404": { "$ref": "#/components/responses/Error" } } }, "head": { "operationId": "platform_head__repos__repo_id__items__item_id__content_revisions__item_seq_", "summary": "get file content revision", "tags": [ "files · versions" ], "parameters": [ { "name": "repo_id", "in": "path", "required": true, "schema": { "type": "string" } }, { "name": "item_id", "in": "path", "required": true, "schema": { "type": "string" } }, { "name": "item_seq", "in": "path", "required": true, "schema": { "type": "integer" } } ], "description": "Authorization and validation are enforced by the owning service.\n\nHEAD uses the GET handler and headers without a response body.", "x-handler": "get_file_content_revision", "x-source-file": "crates/synckhub-server/src/routes/files/versions.rs", "x-source-line": 10, "x-implicit-head": true, "responses": { "default": { "description": "Platform error; branch on HTTP status and stable code, not the human-readable message." } } } }, "/repos/{repo_id}/items/{item_id}/content-revisions/{item_seq}/restore": { "post": { "operationId": "platform_post__repos__repo_id__items__item_id__content_revisions__item_seq__restore", "summary": "restore file content revision", "tags": [ "files · versions" ], "parameters": [ { "name": "repo_id", "in": "path", "required": true, "schema": { "type": "string" } }, { "name": "item_id", "in": "path", "required": true, "schema": { "type": "string" } }, { "name": "item_seq", "in": "path", "required": true, "schema": { "type": "integer" } } ], "description": "Authorization and validation are enforced by the owning service.", "x-handler": "restore_file_content_revision", "x-source-file": "crates/synckhub-server/src/routes/files/versions.rs", "x-source-line": 10, "responses": { "default": { "description": "Platform error; branch on HTTP status and stable code, not the human-readable message.", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } } }, "2XX": { "description": "Successful JSON response", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/synckhub_server.routes.files.versions.RestoreFileContentRevisionResponse" } } } } }, "requestBody": { "required": true, "content": { "application/json": { "schema": { "$ref": "#/components/schemas/synckhub_server.routes.files.versions.RestoreFileContentRevisionRequest" } } } } } }, "/repos/{repo_id}/items/{item_id}/content-revisions/{item_seq}/suppress": { "post": { "operationId": "platform_post__repos__repo_id__items__item_id__content_revisions__item_seq__suppress", "summary": "suppress file content revision", "tags": [ "files · versions" ], "parameters": [ { "name": "repo_id", "in": "path", "required": true, "schema": { "type": "string" } }, { "name": "item_id", "in": "path", "required": true, "schema": { "type": "string" } }, { "name": "item_seq", "in": "path", "required": true, "schema": { "type": "integer" } } ], "description": "Authorization and validation are enforced by the owning service.", "x-handler": "suppress_file_content_revision", "x-source-file": "crates/synckhub-server/src/routes/files/versions.rs", "x-source-line": 10, "responses": { "default": { "description": "Platform error; branch on HTTP status and stable code, not the human-readable message.", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } } }, "2XX": { "description": "Successful JSON response", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/synckhub_core.types.SuppressFileRevisionResult" } } } } }, "requestBody": { "required": true, "content": { "application/json": { "schema": { "$ref": "#/components/schemas/synckhub_server.routes.files.versions.SuppressFileContentRevisionRequest" } } } } } }, "/repos/{repo_id}/items/{item_id}/content-revisions/{item_seq}/unsuppress": { "post": { "operationId": "platform_post__repos__repo_id__items__item_id__content_revisions__item_seq__unsuppress", "summary": "unsuppress file content revision", "tags": [ "files · versions" ], "parameters": [ { "name": "repo_id", "in": "path", "required": true, "schema": { "type": "string" } }, { "name": "item_id", "in": "path", "required": true, "schema": { "type": "string" } }, { "name": "item_seq", "in": "path", "required": true, "schema": { "type": "integer" } } ], "description": "Authorization and validation are enforced by the owning service.", "x-handler": "unsuppress_file_content_revision", "x-source-file": "crates/synckhub-server/src/routes/files/versions.rs", "x-source-line": 10, "responses": { "default": { "description": "Platform error; branch on HTTP status and stable code, not the human-readable message.", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } } }, "2XX": { "description": "Successful JSON response", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/synckhub_core.types.UnsuppressFileRevisionResult" } } } } }, "requestBody": { "required": true, "content": { "application/json": { "schema": { "$ref": "#/components/schemas/synckhub_server.routes.files.versions.UnsuppressFileContentRevisionRequest" } } } } } }, "/repos/{repo_id}/items/{item_id}/content-revisions/append-from-item": { "post": { "operationId": "platform_post__repos__repo_id__items__item_id__content_revisions_append_from_item", "summary": "append file content from item", "tags": [ "files · versions" ], "parameters": [ { "name": "repo_id", "in": "path", "required": true, "schema": { "type": "string" } }, { "name": "item_id", "in": "path", "required": true, "schema": { "type": "string" } } ], "description": "Authorization and validation are enforced by the owning service.", "x-handler": "append_file_content_from_item", "x-source-file": "crates/synckhub-server/src/routes/files/versions.rs", "x-source-line": 10, "responses": { "default": { "description": "Platform error; branch on HTTP status and stable code, not the human-readable message.", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } } }, "2XX": { "description": "Successful JSON response", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/synckhub_server.routes.files.versions.AppendFileContentFromItemResponse" } } } } }, "requestBody": { "required": true, "content": { "application/json": { "schema": { "$ref": "#/components/schemas/synckhub_server.routes.files.versions.AppendFileContentFromItemRequest" } } } } } }, "/repos/{repo_id}/items/{item_id}/content-url": { "get": { "operationId": "platform_get__repos__repo_id__items__item_id__content_url", "summary": "Create a short-lived download URL", "tags": [ "files · content" ], "parameters": [ { "$ref": "#/components/parameters/RepoId" }, { "$ref": "#/components/parameters/ItemId" }, { "name": "chat_item_id", "in": "query", "required": false, "schema": { "anyOf": [ { "type": "string" }, { "type": "null" } ] } }, { "name": "inline_media", "in": "query", "required": false, "schema": { "type": "boolean" } } ], "description": "Returns an expiring download capability. Use the returned URL promptly; do not store it as a durable file address or log its token. expires_at is an RFC3339 timestamp.", "x-handler": "get_item_content_url", "x-source-file": "crates/synckhub-server/src/routes/files/content.rs", "x-source-line": 20, "responses": { "200": { "description": "Short-lived download URL", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/DownloadUrl" }, "example": { "url": "https://api.example.synckhub.com/v1/downloads/EXAMPLE_TOKEN", "path": "/v1/downloads/EXAMPLE_TOKEN", "expires_at": "2026-10-08T10:05:00Z", "download_name": "report.pdf", "blob_id": "aaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaa", "size_bytes": 2048 } } } }, "401": { "$ref": "#/components/responses/Error" }, "403": { "$ref": "#/components/responses/Error" }, "404": { "$ref": "#/components/responses/Error" } } }, "head": { "operationId": "platform_head__repos__repo_id__items__item_id__content_url", "summary": "get item content url", "tags": [ "files · content" ], "parameters": [ { "name": "repo_id", "in": "path", "required": true, "schema": { "type": "string" } }, { "name": "item_id", "in": "path", "required": true, "schema": { "type": "string" } }, { "name": "chat_item_id", "in": "query", "required": false, "schema": { "anyOf": [ { "type": "string" }, { "type": "null" } ] } }, { "name": "inline_media", "in": "query", "required": false, "schema": { "type": "boolean" } } ], "description": "Authorization and validation are enforced by the owning service.\n\nHEAD uses the GET handler and headers without a response body.", "x-handler": "get_item_content_url", "x-source-file": "crates/synckhub-server/src/routes/files/content.rs", "x-source-line": 20, "x-implicit-head": true, "responses": { "default": { "description": "Platform error; branch on HTTP status and stable code, not the human-readable message." } } } }, "/repos/{repo_id}/items/{item_id}/convert-to-email": { "post": { "operationId": "platform_post__repos__repo_id__items__item_id__convert_to_email", "summary": "convert email file", "tags": [ "mail · archive" ], "parameters": [ { "name": "repo_id", "in": "path", "required": true, "schema": { "type": "string" } }, { "name": "item_id", "in": "path", "required": true, "schema": { "type": "string" } } ], "description": "Authorization and validation are enforced by the owning service.", "x-handler": "convert_email_file", "x-source-file": "crates/synckhub-server/src/routes/mail/archive.rs", "x-source-line": 100, "responses": { "default": { "description": "Platform error; branch on HTTP status and stable code, not the human-readable message.", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } } }, "2XX": { "description": "Successful JSON response", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/synckhub_server.routes.mail.archive.ConvertEmailFileResponse" } } } } }, "requestBody": { "required": true, "content": { "application/json": { "schema": { "$ref": "#/components/schemas/synckhub_server.routes.mail.archive.SimpleItemActionRequest" } } } } } }, "/repos/{repo_id}/items/{item_id}/copy-email": { "post": { "operationId": "platform_post__repos__repo_id__items__item_id__copy_email", "summary": "copy email", "tags": [ "items · copy" ], "parameters": [ { "name": "repo_id", "in": "path", "required": true, "schema": { "type": "string" } }, { "name": "item_id", "in": "path", "required": true, "schema": { "type": "string" } } ], "description": "Authorization and validation are enforced by the owning service.", "x-handler": "copy_email", "x-source-file": "crates/synckhub-server/src/routes/items/copy.rs", "x-source-line": 8, "responses": { "default": { "description": "Platform error; branch on HTTP status and stable code, not the human-readable message.", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } } }, "2XX": { "description": "Successful JSON response", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/synckhub_core.types.ItemSummary" } } } } }, "requestBody": { "required": true, "content": { "application/json": { "schema": { "$ref": "#/components/schemas/synckhub_server.routes.items.copy.CopyEmailRequest" } } } } } }, "/repos/{repo_id}/items/{item_id}/data-links": { "get": { "operationId": "platform_get__repos__repo_id__items__item_id__data_links", "summary": "get item data links", "tags": [ "structured_data" ], "parameters": [ { "name": "repo_id", "in": "path", "required": true, "schema": { "type": "string" } }, { "name": "item_id", "in": "path", "required": true, "schema": { "type": "string" } } ], "description": "Authorization and validation are enforced by the owning service.", "x-handler": "get_item_data_links", "x-source-file": "crates/synckhub-server/src/routes/structured_data.rs", "x-source-line": 62, "responses": { "default": { "description": "Platform error; branch on HTTP status and stable code, not the human-readable message.", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } } }, "2XX": { "description": "Successful JSON response", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/synckhub_server.routes.structured_data.ListStructuredDataItemLinksResponse" } } } } } }, "head": { "operationId": "platform_head__repos__repo_id__items__item_id__data_links", "summary": "get item data links", "tags": [ "structured_data" ], "parameters": [ { "name": "repo_id", "in": "path", "required": true, "schema": { "type": "string" } }, { "name": "item_id", "in": "path", "required": true, "schema": { "type": "string" } } ], "description": "Authorization and validation are enforced by the owning service.\n\nHEAD uses the GET handler and headers without a response body.", "x-handler": "get_item_data_links", "x-source-file": "crates/synckhub-server/src/routes/structured_data.rs", "x-source-line": 62, "x-implicit-head": true, "responses": { "default": { "description": "Platform error; branch on HTTP status and stable code, not the human-readable message." } } } }, "/repos/{repo_id}/items/{item_id}/data-links/{link_key}": { "delete": { "operationId": "platform_delete__repos__repo_id__items__item_id__data_links__link_key_", "summary": "delete item data link", "tags": [ "structured_data" ], "parameters": [ { "name": "repo_id", "in": "path", "required": true, "schema": { "type": "string" } }, { "name": "item_id", "in": "path", "required": true, "schema": { "type": "string" } }, { "name": "link_key", "in": "path", "required": true, "schema": { "type": "string" } } ], "description": "Authorization and validation are enforced by the owning service.", "x-handler": "delete_item_data_link", "x-source-file": "crates/synckhub-server/src/routes/structured_data.rs", "x-source-line": 62, "responses": { "default": { "description": "Platform error; branch on HTTP status and stable code, not the human-readable message.", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } } } } }, "put": { "operationId": "platform_put__repos__repo_id__items__item_id__data_links__link_key_", "summary": "put item data link", "tags": [ "structured_data" ], "parameters": [ { "name": "repo_id", "in": "path", "required": true, "schema": { "type": "string" } }, { "name": "item_id", "in": "path", "required": true, "schema": { "type": "string" } }, { "name": "link_key", "in": "path", "required": true, "schema": { "type": "string" } } ], "description": "Authorization and validation are enforced by the owning service.", "x-handler": "put_item_data_link", "x-source-file": "crates/synckhub-server/src/routes/structured_data.rs", "x-source-line": 62, "responses": { "default": { "description": "Platform error; branch on HTTP status and stable code, not the human-readable message.", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } } }, "2XX": { "description": "Successful JSON response", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/synckhub_server.routes.structured_data.StructuredDataItemLinkResponse" } } } } }, "requestBody": { "required": true, "content": { "application/json": { "schema": { "$ref": "#/components/schemas/synckhub_server.routes.structured_data.PutStructuredDataItemLinkRequest" } } } } } }, "/repos/{repo_id}/items/{item_id}/draft": { "put": { "operationId": "platform_put__repos__repo_id__items__item_id__draft", "summary": "put file draft", "tags": [ "files · drafts" ], "parameters": [ { "name": "repo_id", "in": "path", "required": true, "schema": { "type": "string" } }, { "name": "item_id", "in": "path", "required": true, "schema": { "type": "string" } }, { "name": "x-synck-expected-head-blob-id", "in": "header", "required": false, "schema": { "type": "string" } }, { "name": "x-synck-expected-head-item-seq", "in": "header", "required": false, "schema": { "type": "integer", "minimum": 1 } }, { "name": "x-synck-lock-token", "in": "header", "schema": { "type": "string" } }, { "name": "x-wopi-lock", "in": "header", "schema": { "type": "string" } } ], "description": "Authorization and validation are enforced by the owning service.\n\nThe request body contains the raw file bytes. Expected-head headers describe the persisted head, not a draft. Supply the active exclusive lock token in x-synck-lock-token or x-wopi-lock. If either expected-head header is supplied, both are required.", "x-handler": "put_file_draft", "x-source-file": "crates/synckhub-server/src/routes/files/drafts.rs", "x-source-line": 11, "responses": { "default": { "description": "Platform error; branch on HTTP status and stable code, not the human-readable message.", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } } }, "2XX": { "description": "Successful JSON response", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/synckhub_server.routes.files.drafts.PutFileDraftResponse" } } } } }, "requestBody": { "required": true, "content": { "application/octet-stream": { "schema": { "type": "string", "format": "binary" } } } } }, "get": { "operationId": "platform_get__repos__repo_id__items__item_id__draft", "summary": "get file draft", "tags": [ "files · drafts" ], "parameters": [ { "name": "repo_id", "in": "path", "required": true, "schema": { "type": "string" } }, { "name": "item_id", "in": "path", "required": true, "schema": { "type": "string" } } ], "description": "Authorization and validation are enforced by the owning service.", "x-handler": "get_file_draft", "x-source-file": "crates/synckhub-server/src/routes/files/drafts.rs", "x-source-line": 11, "responses": { "default": { "description": "Platform error; branch on HTTP status and stable code, not the human-readable message.", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } } } } }, "head": { "operationId": "platform_head__repos__repo_id__items__item_id__draft", "summary": "get file draft", "tags": [ "files · drafts" ], "parameters": [ { "name": "repo_id", "in": "path", "required": true, "schema": { "type": "string" } }, { "name": "item_id", "in": "path", "required": true, "schema": { "type": "string" } } ], "description": "Authorization and validation are enforced by the owning service.\n\nHEAD uses the GET handler and headers without a response body.", "x-handler": "get_file_draft", "x-source-file": "crates/synckhub-server/src/routes/files/drafts.rs", "x-source-line": 11, "x-implicit-head": true, "responses": { "default": { "description": "Platform error; branch on HTTP status and stable code, not the human-readable message." } } } }, "/repos/{repo_id}/items/{item_id}/draft-history": { "get": { "operationId": "platform_get__repos__repo_id__items__item_id__draft_history", "summary": "list file draft history", "tags": [ "files · drafts" ], "parameters": [ { "name": "repo_id", "in": "path", "required": true, "schema": { "type": "string" } }, { "name": "item_id", "in": "path", "required": true, "schema": { "type": "string" } } ], "description": "Authorization and validation are enforced by the owning service.", "x-handler": "list_file_draft_history", "x-source-file": "crates/synckhub-server/src/routes/files/drafts.rs", "x-source-line": 11, "responses": { "default": { "description": "Platform error; branch on HTTP status and stable code, not the human-readable message.", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } } }, "2XX": { "description": "Successful JSON response", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/synckhub_server.routes.files.drafts.DraftHistoryListResponse" } } } } } }, "head": { "operationId": "platform_head__repos__repo_id__items__item_id__draft_history", "summary": "list file draft history", "tags": [ "files · drafts" ], "parameters": [ { "name": "repo_id", "in": "path", "required": true, "schema": { "type": "string" } }, { "name": "item_id", "in": "path", "required": true, "schema": { "type": "string" } } ], "description": "Authorization and validation are enforced by the owning service.\n\nHEAD uses the GET handler and headers without a response body.", "x-handler": "list_file_draft_history", "x-source-file": "crates/synckhub-server/src/routes/files/drafts.rs", "x-source-line": 11, "x-implicit-head": true, "responses": { "default": { "description": "Platform error; branch on HTTP status and stable code, not the human-readable message." } } } }, "/repos/{repo_id}/items/{item_id}/draft-history/{snapshot_id}": { "get": { "operationId": "platform_get__repos__repo_id__items__item_id__draft_history__snapshot_id_", "summary": "get file draft history snapshot", "tags": [ "files · drafts" ], "parameters": [ { "name": "repo_id", "in": "path", "required": true, "schema": { "type": "string" } }, { "name": "item_id", "in": "path", "required": true, "schema": { "type": "string" } }, { "name": "snapshot_id", "in": "path", "required": true, "schema": { "type": "string" } } ], "description": "Authorization and validation are enforced by the owning service.", "x-handler": "get_file_draft_history_snapshot", "x-source-file": "crates/synckhub-server/src/routes/files/drafts.rs", "x-source-line": 11, "responses": { "default": { "description": "Platform error; branch on HTTP status and stable code, not the human-readable message.", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } } } } }, "head": { "operationId": "platform_head__repos__repo_id__items__item_id__draft_history__snapshot_id_", "summary": "get file draft history snapshot", "tags": [ "files · drafts" ], "parameters": [ { "name": "repo_id", "in": "path", "required": true, "schema": { "type": "string" } }, { "name": "item_id", "in": "path", "required": true, "schema": { "type": "string" } }, { "name": "snapshot_id", "in": "path", "required": true, "schema": { "type": "string" } } ], "description": "Authorization and validation are enforced by the owning service.\n\nHEAD uses the GET handler and headers without a response body.", "x-handler": "get_file_draft_history_snapshot", "x-source-file": "crates/synckhub-server/src/routes/files/drafts.rs", "x-source-line": 11, "x-implicit-head": true, "responses": { "default": { "description": "Platform error; branch on HTTP status and stable code, not the human-readable message." } } } }, "/repos/{repo_id}/items/{item_id}/draft/{draft_id}": { "delete": { "operationId": "platform_delete__repos__repo_id__items__item_id__draft__draft_id_", "summary": "delete file draft", "tags": [ "files · drafts" ], "parameters": [ { "name": "repo_id", "in": "path", "required": true, "schema": { "type": "string" } }, { "name": "item_id", "in": "path", "required": true, "schema": { "type": "string" } }, { "name": "draft_id", "in": "path", "required": true, "schema": { "type": "string" } } ], "description": "Authorization and validation are enforced by the owning service.", "x-handler": "delete_file_draft", "x-source-file": "crates/synckhub-server/src/routes/files/drafts.rs", "x-source-line": 11, "responses": { "default": { "description": "Platform error; branch on HTTP status and stable code, not the human-readable message.", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } } } } } }, "/repos/{repo_id}/items/{item_id}/draft/publish": { "post": { "operationId": "platform_post__repos__repo_id__items__item_id__draft_publish", "summary": "publish file draft", "tags": [ "files · drafts" ], "parameters": [ { "name": "repo_id", "in": "path", "required": true, "schema": { "type": "string" } }, { "name": "item_id", "in": "path", "required": true, "schema": { "type": "string" } } ], "description": "Authorization and validation are enforced by the owning service.", "x-handler": "publish_file_draft", "x-source-file": "crates/synckhub-server/src/routes/files/drafts.rs", "x-source-line": 11, "responses": { "default": { "description": "Platform error; branch on HTTP status and stable code, not the human-readable message.", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } } }, "2XX": { "description": "Successful JSON response", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/synckhub_server.routes.files.drafts.PublishFileDraftResponse" } } } } }, "requestBody": { "required": true, "content": { "application/json": { "schema": { "$ref": "#/components/schemas/synckhub_server.routes.files.drafts.PublishFileDraftRequest" } } } } } }, "/repos/{repo_id}/items/{item_id}/draft/publish-conditional": { "post": { "operationId": "platform_post__repos__repo_id__items__item_id__draft_publish_conditional", "summary": "publish file draft conditionally", "tags": [ "files · drafts" ], "parameters": [ { "name": "repo_id", "in": "path", "required": true, "schema": { "type": "string" } }, { "name": "item_id", "in": "path", "required": true, "schema": { "type": "string" } } ], "description": "Authorization and validation are enforced by the owning service.", "x-handler": "publish_file_draft_conditionally", "x-source-file": "crates/synckhub-server/src/routes/files/drafts.rs", "x-source-line": 11, "responses": { "default": { "description": "Platform error; branch on HTTP status and stable code, not the human-readable message.", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } } }, "2XX": { "description": "Successful JSON response", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/synckhub_server.routes.files.drafts.ConditionalPublishFileDraftResponse" } } } } }, "requestBody": { "required": true, "content": { "application/json": { "schema": { "$ref": "#/components/schemas/synckhub_server.routes.files.drafts.ConditionalPublishFileDraftRequest" } } } } } }, "/repos/{repo_id}/items/{item_id}/events": { "get": { "operationId": "platform_get__repos__repo_id__items__item_id__events", "summary": "list item events", "tags": [ "items · read" ], "parameters": [ { "name": "repo_id", "in": "path", "required": true, "schema": { "type": "string" } }, { "name": "item_id", "in": "path", "required": true, "schema": { "type": "string" } }, { "name": "limit", "in": "query", "required": false, "schema": { "anyOf": [ { "type": "integer", "minimum": 0 }, { "type": "null" } ] } }, { "name": "offset", "in": "query", "required": false, "schema": { "anyOf": [ { "type": "integer", "minimum": 0 }, { "type": "null" } ] } }, { "name": "before_repo_seq", "in": "query", "required": false, "schema": { "anyOf": [ { "type": "integer" }, { "type": "null" } ] } }, { "name": "before_commit_event_idx", "in": "query", "required": false, "schema": { "anyOf": [ { "type": "integer" }, { "type": "null" } ] } }, { "name": "include_payload", "in": "query", "required": false, "schema": { "anyOf": [ { "type": "boolean" }, { "type": "null" } ] } }, { "name": "item_level_only", "in": "query", "required": false, "schema": { "anyOf": [ { "type": "boolean" }, { "type": "null" } ] } } ], "description": "Authorization and validation are enforced by the owning service.", "x-handler": "list_item_events", "x-source-file": "crates/synckhub-server/src/routes/items/read.rs", "x-source-line": 27, "responses": { "default": { "description": "Platform error; branch on HTTP status and stable code, not the human-readable message.", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } } }, "2XX": { "description": "Successful JSON response", "content": { "application/json": { "schema": { "type": "array", "items": { "$ref": "#/components/schemas/synckhub_core.types.ItemEventEntry" } } } } } } }, "head": { "operationId": "platform_head__repos__repo_id__items__item_id__events", "summary": "list item events", "tags": [ "items · read" ], "parameters": [ { "name": "repo_id", "in": "path", "required": true, "schema": { "type": "string" } }, { "name": "item_id", "in": "path", "required": true, "schema": { "type": "string" } }, { "name": "limit", "in": "query", "required": false, "schema": { "anyOf": [ { "type": "integer", "minimum": 0 }, { "type": "null" } ] } }, { "name": "offset", "in": "query", "required": false, "schema": { "anyOf": [ { "type": "integer", "minimum": 0 }, { "type": "null" } ] } }, { "name": "before_repo_seq", "in": "query", "required": false, "schema": { "anyOf": [ { "type": "integer" }, { "type": "null" } ] } }, { "name": "before_commit_event_idx", "in": "query", "required": false, "schema": { "anyOf": [ { "type": "integer" }, { "type": "null" } ] } }, { "name": "include_payload", "in": "query", "required": false, "schema": { "anyOf": [ { "type": "boolean" }, { "type": "null" } ] } }, { "name": "item_level_only", "in": "query", "required": false, "schema": { "anyOf": [ { "type": "boolean" }, { "type": "null" } ] } } ], "description": "Authorization and validation are enforced by the owning service.\n\nHEAD uses the GET handler and headers without a response body.", "x-handler": "list_item_events", "x-source-file": "crates/synckhub-server/src/routes/items/read.rs", "x-source-line": 27, "x-implicit-head": true, "responses": { "default": { "description": "Platform error; branch on HTTP status and stable code, not the human-readable message." } } } }, "/repos/{repo_id}/items/{item_id}/federate": { "post": { "operationId": "platform_post__repos__repo_id__items__item_id__federate", "summary": "federate item", "tags": [ "federation · items" ], "parameters": [ { "name": "repo_id", "in": "path", "required": true, "schema": { "type": "string" } }, { "name": "item_id", "in": "path", "required": true, "schema": { "type": "string" } } ], "description": "Authorization and validation are enforced by the owning service.", "x-handler": "federate_item", "x-source-file": "crates/synckhub-server/src/routes/federation/items.rs", "x-source-line": 9, "responses": { "default": { "description": "Platform error; branch on HTTP status and stable code, not the human-readable message.", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } } }, "2XX": { "description": "Successful JSON response", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/synckhub_federation.clearinghouse.FederationEnsureItemResult" } } } } }, "requestBody": { "required": true, "content": { "application/json": { "schema": { "$ref": "#/components/schemas/synckhub_server.routes.federation.items.FederateItemRequest" } } } } } }, "/repos/{repo_id}/items/{item_id}/file-versions": { "post": { "operationId": "platform_post__repos__repo_id__items__item_id__file_versions", "summary": "create file version from head", "tags": [ "files · versions" ], "parameters": [ { "name": "repo_id", "in": "path", "required": true, "schema": { "type": "string" } }, { "name": "item_id", "in": "path", "required": true, "schema": { "type": "string" } } ], "description": "Authorization and validation are enforced by the owning service.", "x-handler": "create_file_version_from_head", "x-source-file": "crates/synckhub-server/src/routes/files/versions.rs", "x-source-line": 10, "responses": { "default": { "description": "Platform error; branch on HTTP status and stable code, not the human-readable message.", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } } }, "2XX": { "description": "Successful JSON response", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/synckhub_core.types.FileVersionWriteSummary" } } } } }, "requestBody": { "required": true, "content": { "application/json": { "schema": { "$ref": "#/components/schemas/synckhub_server.routes.files.versions.CreateFileVersionFromHeadRequest" } } } } }, "get": { "operationId": "platform_get__repos__repo_id__items__item_id__file_versions", "summary": "List named file versions", "tags": [ "files · versions" ], "parameters": [ { "$ref": "#/components/parameters/RepoId" }, { "$ref": "#/components/parameters/ItemId" }, { "$ref": "#/components/parameters/Limit" }, { "$ref": "#/components/parameters/Offset" } ], "description": "Lists named business labels, separate from immutable content revisions. Defaults to 100 labels per page; advance offset by the number returned and continue until an empty page.", "x-handler": "list_file_versions", "x-source-file": "crates/synckhub-server/src/routes/files/versions.rs", "x-source-line": 10, "responses": { "200": { "description": "Named file versions", "content": { "application/json": { "schema": { "type": "array", "items": { "$ref": "#/components/schemas/NamedFileVersion" } }, "example": [ { "repo_id": "11111111-1111-4111-8111-111111111111", "item_id": "22222222-2222-4222-8222-222222222222", "version_id": "66666666-6666-4666-8666-666666666666", "lifecycle_state": "LIVE", "kind": "MAJOR", "label_source": "INTERNAL", "order_key": 1, "version_major": 1, "version_minor": 0, "description": "Approved report", "comment": null, "blob_id": "aaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaa", "size": 2048, "source_item_seq": 7, "last_commit_id": "55555555-5555-4555-8555-555555555555", "last_commit_event_idx": 0 } ] } } }, "401": { "$ref": "#/components/responses/Error" }, "403": { "$ref": "#/components/responses/Error" }, "404": { "$ref": "#/components/responses/Error" } } }, "head": { "operationId": "platform_head__repos__repo_id__items__item_id__file_versions", "summary": "list file versions", "tags": [ "files · versions" ], "parameters": [ { "name": "repo_id", "in": "path", "required": true, "schema": { "type": "string" } }, { "name": "item_id", "in": "path", "required": true, "schema": { "type": "string" } }, { "name": "limit", "in": "query", "required": false, "schema": { "anyOf": [ { "type": "integer", "minimum": 0 }, { "type": "null" } ] } }, { "name": "offset", "in": "query", "required": false, "schema": { "anyOf": [ { "type": "integer", "minimum": 0 }, { "type": "null" } ] } } ], "description": "Authorization and validation are enforced by the owning service.\n\nHEAD uses the GET handler and headers without a response body.", "x-handler": "list_file_versions", "x-source-file": "crates/synckhub-server/src/routes/files/versions.rs", "x-source-line": 10, "x-implicit-head": true, "responses": { "default": { "description": "Platform error; branch on HTTP status and stable code, not the human-readable message." } } } }, "/repos/{repo_id}/items/{item_id}/file-versions/{item_seq}/replace-from-head": { "post": { "operationId": "platform_post__repos__repo_id__items__item_id__file_versions__item_seq__replace_from_head", "summary": "replace file version from head", "tags": [ "files · versions" ], "parameters": [ { "name": "repo_id", "in": "path", "required": true, "schema": { "type": "string" } }, { "name": "item_id", "in": "path", "required": true, "schema": { "type": "string" } }, { "name": "item_seq", "in": "path", "required": true, "schema": { "type": "string" } } ], "description": "Authorization and validation are enforced by the owning service.", "x-handler": "replace_file_version_from_head", "x-source-file": "crates/synckhub-server/src/routes/files/versions.rs", "x-source-line": 10, "responses": { "default": { "description": "Platform error; branch on HTTP status and stable code, not the human-readable message.", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } } }, "2XX": { "description": "Successful JSON response", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/synckhub_core.types.FileVersionWriteSummary" } } } } }, "requestBody": { "required": true, "content": { "application/json": { "schema": { "$ref": "#/components/schemas/synckhub_server.routes.files.versions.ReplaceFileVersionFromHeadRequest" } } } } } }, "/repos/{repo_id}/items/{item_id}/file-versions/{item_seq}/replace-from-revision": { "post": { "operationId": "platform_post__repos__repo_id__items__item_id__file_versions__item_seq__replace_from_revision", "summary": "replace file version from revision", "tags": [ "files · versions" ], "parameters": [ { "name": "repo_id", "in": "path", "required": true, "schema": { "type": "string" } }, { "name": "item_id", "in": "path", "required": true, "schema": { "type": "string" } }, { "name": "item_seq", "in": "path", "required": true, "schema": { "type": "string" } } ], "description": "Authorization and validation are enforced by the owning service.", "x-handler": "replace_file_version_from_revision", "x-source-file": "crates/synckhub-server/src/routes/files/versions.rs", "x-source-line": 10, "responses": { "default": { "description": "Platform error; branch on HTTP status and stable code, not the human-readable message.", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } } }, "2XX": { "description": "Successful JSON response", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/synckhub_core.types.FileVersionWriteSummary" } } } } }, "requestBody": { "required": true, "content": { "application/json": { "schema": { "$ref": "#/components/schemas/synckhub_server.routes.files.versions.ReplaceFileVersionFromRevisionRequest" } } } } } }, "/repos/{repo_id}/items/{item_id}/file-versions/{item_seq}/restore": { "post": { "operationId": "platform_post__repos__repo_id__items__item_id__file_versions__item_seq__restore", "summary": "restore file version", "tags": [ "files · versions" ], "parameters": [ { "name": "repo_id", "in": "path", "required": true, "schema": { "type": "string" } }, { "name": "item_id", "in": "path", "required": true, "schema": { "type": "string" } }, { "name": "item_seq", "in": "path", "required": true, "schema": { "type": "string" } } ], "description": "Authorization and validation are enforced by the owning service.", "x-handler": "restore_file_version", "x-source-file": "crates/synckhub-server/src/routes/files/versions.rs", "x-source-line": 10, "responses": { "default": { "description": "Platform error; branch on HTTP status and stable code, not the human-readable message.", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } } }, "2XX": { "description": "Successful JSON response", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/synckhub_server.routes.files.versions.RestoreFileVersionResponse" } } } } }, "requestBody": { "required": true, "content": { "application/json": { "schema": { "$ref": "#/components/schemas/synckhub_server.routes.files.versions.RestoreFileVersionRequest" } } } } } }, "/repos/{repo_id}/items/{item_id}/file-versions/{item_seq}/set": { "post": { "operationId": "platform_post__repos__repo_id__items__item_id__file_versions__item_seq__set", "summary": "set file version", "tags": [ "files · versions" ], "parameters": [ { "name": "repo_id", "in": "path", "required": true, "schema": { "type": "string" } }, { "name": "item_id", "in": "path", "required": true, "schema": { "type": "string" } }, { "name": "item_seq", "in": "path", "required": true, "schema": { "type": "string" } } ], "description": "Authorization and validation are enforced by the owning service.", "x-handler": "set_file_version", "x-source-file": "crates/synckhub-server/src/routes/files/versions.rs", "x-source-line": 10, "responses": { "default": { "description": "Platform error; branch on HTTP status and stable code, not the human-readable message.", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } } }, "2XX": { "description": "Successful JSON response", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/synckhub_core.types.FileVersionWriteSummary" } } } } }, "requestBody": { "required": true, "content": { "application/json": { "schema": { "$ref": "#/components/schemas/synckhub_server.routes.files.versions.SetFileVersionRequest" } } } } } }, "/repos/{repo_id}/items/{item_id}/file-versions/{item_seq}/tombstone": { "post": { "operationId": "platform_post__repos__repo_id__items__item_id__file_versions__item_seq__tombstone", "summary": "tombstone file version", "tags": [ "files · versions" ], "parameters": [ { "name": "repo_id", "in": "path", "required": true, "schema": { "type": "string" } }, { "name": "item_id", "in": "path", "required": true, "schema": { "type": "string" } }, { "name": "item_seq", "in": "path", "required": true, "schema": { "type": "string" } } ], "description": "Authorization and validation are enforced by the owning service.", "x-handler": "tombstone_file_version", "x-source-file": "crates/synckhub-server/src/routes/files/versions.rs", "x-source-line": 10, "responses": { "default": { "description": "Platform error; branch on HTTP status and stable code, not the human-readable message.", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } } }, "2XX": { "description": "Successful JSON response", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/synckhub_core.types.FileVersionWriteSummary" } } } } }, "requestBody": { "required": true, "content": { "application/json": { "schema": { "$ref": "#/components/schemas/synckhub_server.routes.files.versions.TombstoneFileVersionRequest" } } } } } }, "/repos/{repo_id}/items/{item_id}/file-versions/from-revision": { "post": { "operationId": "platform_post__repos__repo_id__items__item_id__file_versions_from_revision", "summary": "create file version from revision", "tags": [ "files · versions" ], "parameters": [ { "name": "repo_id", "in": "path", "required": true, "schema": { "type": "string" } }, { "name": "item_id", "in": "path", "required": true, "schema": { "type": "string" } } ], "description": "Authorization and validation are enforced by the owning service.", "x-handler": "create_file_version_from_revision", "x-source-file": "crates/synckhub-server/src/routes/files/versions.rs", "x-source-line": 10, "responses": { "default": { "description": "Platform error; branch on HTTP status and stable code, not the human-readable message.", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } } }, "2XX": { "description": "Successful JSON response", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/synckhub_core.types.FileVersionWriteSummary" } } } } }, "requestBody": { "required": true, "content": { "application/json": { "schema": { "$ref": "#/components/schemas/synckhub_server.routes.files.versions.CreateFileVersionFromRevisionRequest" } } } } } }, "/repos/{repo_id}/items/{item_id}/leave-federation": { "post": { "operationId": "platform_post__repos__repo_id__items__item_id__leave_federation", "summary": "leave federation item", "tags": [ "federation · items" ], "parameters": [ { "name": "repo_id", "in": "path", "required": true, "schema": { "type": "string" } }, { "name": "item_id", "in": "path", "required": true, "schema": { "type": "string" } } ], "description": "Authorization and validation are enforced by the owning service.", "x-handler": "leave_federation_item", "x-source-file": "crates/synckhub-server/src/routes/federation/items.rs", "x-source-line": 9, "responses": { "default": { "description": "Platform error; branch on HTTP status and stable code, not the human-readable message.", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } } }, "2XX": { "description": "Successful JSON response", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/synckhub_core.types.ItemSummary" } } } } }, "requestBody": { "required": true, "content": { "application/json": { "schema": { "$ref": "#/components/schemas/synckhub_server.routes.items.lifecycle.SimpleItemActionRequest" } } } } } }, "/repos/{repo_id}/items/{item_id}/locks/exclusive": { "post": { "operationId": "platform_post__repos__repo_id__items__item_id__locks_exclusive", "summary": "acquire exclusive lock", "tags": [ "files · drafts" ], "parameters": [ { "name": "repo_id", "in": "path", "required": true, "schema": { "type": "string" } }, { "name": "item_id", "in": "path", "required": true, "schema": { "type": "string" } }, { "name": "chat_item_id", "in": "query", "required": false, "schema": { "anyOf": [ { "type": "string" }, { "type": "null" } ] } }, { "name": "inline_media", "in": "query", "required": false, "schema": { "type": "boolean" } } ], "description": "Authorization and validation are enforced by the owning service.", "x-handler": "acquire_exclusive_lock", "x-source-file": "crates/synckhub-server/src/routes/files/drafts.rs", "x-source-line": 11, "responses": { "default": { "description": "Platform error; branch on HTTP status and stable code, not the human-readable message.", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } } }, "2XX": { "description": "Successful JSON response", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/synckhub_core.types.LockSummary" } } } } }, "requestBody": { "required": true, "content": { "application/json": { "schema": { "$ref": "#/components/schemas/synckhub_server.routes.files.drafts.AcquireExclusiveLockRequest" } } } } }, "get": { "operationId": "platform_get__repos__repo_id__items__item_id__locks_exclusive", "summary": "get exclusive lock", "tags": [ "files · drafts" ], "parameters": [ { "name": "repo_id", "in": "path", "required": true, "schema": { "type": "string" } }, { "name": "item_id", "in": "path", "required": true, "schema": { "type": "string" } }, { "name": "chat_item_id", "in": "query", "required": false, "schema": { "anyOf": [ { "type": "string" }, { "type": "null" } ] } }, { "name": "inline_media", "in": "query", "required": false, "schema": { "type": "boolean" } } ], "description": "Authorization and validation are enforced by the owning service.", "x-handler": "get_exclusive_lock", "x-source-file": "crates/synckhub-server/src/routes/files/drafts.rs", "x-source-line": 11, "responses": { "default": { "description": "Platform error; branch on HTTP status and stable code, not the human-readable message.", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } } }, "2XX": { "description": "Successful JSON response", "content": { "application/json": { "schema": { "anyOf": [ { "$ref": "#/components/schemas/synckhub_core.types.LockSummary" }, { "type": "null" } ] } } } } } }, "head": { "operationId": "platform_head__repos__repo_id__items__item_id__locks_exclusive", "summary": "get exclusive lock", "tags": [ "files · drafts" ], "parameters": [ { "name": "repo_id", "in": "path", "required": true, "schema": { "type": "string" } }, { "name": "item_id", "in": "path", "required": true, "schema": { "type": "string" } }, { "name": "chat_item_id", "in": "query", "required": false, "schema": { "anyOf": [ { "type": "string" }, { "type": "null" } ] } }, { "name": "inline_media", "in": "query", "required": false, "schema": { "type": "boolean" } } ], "description": "Authorization and validation are enforced by the owning service.\n\nHEAD uses the GET handler and headers without a response body.", "x-handler": "get_exclusive_lock", "x-source-file": "crates/synckhub-server/src/routes/files/drafts.rs", "x-source-line": 11, "x-implicit-head": true, "responses": { "default": { "description": "Platform error; branch on HTTP status and stable code, not the human-readable message." } } } }, "/repos/{repo_id}/items/{item_id}/locks/exclusive/release": { "post": { "operationId": "platform_post__repos__repo_id__items__item_id__locks_exclusive_release", "summary": "release exclusive lock", "tags": [ "files · drafts" ], "parameters": [ { "name": "repo_id", "in": "path", "required": true, "schema": { "type": "string" } }, { "name": "item_id", "in": "path", "required": true, "schema": { "type": "string" } }, { "name": "chat_item_id", "in": "query", "required": false, "schema": { "anyOf": [ { "type": "string" }, { "type": "null" } ] } }, { "name": "inline_media", "in": "query", "required": false, "schema": { "type": "boolean" } } ], "description": "Authorization and validation are enforced by the owning service.", "x-handler": "release_exclusive_lock", "x-source-file": "crates/synckhub-server/src/routes/files/drafts.rs", "x-source-line": 11, "responses": { "default": { "description": "Platform error; branch on HTTP status and stable code, not the human-readable message.", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } } } } } }, "/repos/{repo_id}/items/{item_id}/locks/force-unlock": { "post": { "operationId": "platform_post__repos__repo_id__items__item_id__locks_force_unlock", "summary": "force unlock", "tags": [ "files · drafts" ], "parameters": [ { "name": "repo_id", "in": "path", "required": true, "schema": { "type": "string" } }, { "name": "item_id", "in": "path", "required": true, "schema": { "type": "string" } } ], "description": "Authorization and validation are enforced by the owning service.", "x-handler": "force_unlock", "x-source-file": "crates/synckhub-server/src/routes/files/drafts.rs", "x-source-line": 11, "responses": { "default": { "description": "Platform error; branch on HTTP status and stable code, not the human-readable message.", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } } }, "2XX": { "description": "Successful JSON response", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/synckhub_server.routes.files.drafts.ForceUnlockResponse" } } } } }, "requestBody": { "required": true, "content": { "application/json": { "schema": { "$ref": "#/components/schemas/synckhub_server.routes.files.drafts.ForceUnlockRequest" } } } } } }, "/repos/{repo_id}/items/{item_id}/markdown": { "get": { "operationId": "platform_get__repos__repo_id__items__item_id__markdown", "summary": "get item markdown", "tags": [ "files · content" ], "parameters": [ { "name": "repo_id", "in": "path", "required": true, "schema": { "type": "string" } }, { "name": "item_id", "in": "path", "required": true, "schema": { "type": "string" } }, { "name": "chat_item_id", "in": "query", "required": false, "schema": { "anyOf": [ { "type": "string" }, { "type": "null" } ] } }, { "name": "inline_media", "in": "query", "required": false, "schema": { "type": "boolean" } } ], "description": "Authorization and validation are enforced by the owning service.", "x-handler": "get_item_markdown", "x-source-file": "crates/synckhub-server/src/routes/files/content.rs", "x-source-line": 20, "responses": { "default": { "description": "Platform error; branch on HTTP status and stable code, not the human-readable message.", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } } } } }, "head": { "operationId": "platform_head__repos__repo_id__items__item_id__markdown", "summary": "get item markdown", "tags": [ "files · content" ], "parameters": [ { "name": "repo_id", "in": "path", "required": true, "schema": { "type": "string" } }, { "name": "item_id", "in": "path", "required": true, "schema": { "type": "string" } }, { "name": "chat_item_id", "in": "query", "required": false, "schema": { "anyOf": [ { "type": "string" }, { "type": "null" } ] } }, { "name": "inline_media", "in": "query", "required": false, "schema": { "type": "boolean" } } ], "description": "Authorization and validation are enforced by the owning service.\n\nHEAD uses the GET handler and headers without a response body.", "x-handler": "get_item_markdown", "x-source-file": "crates/synckhub-server/src/routes/files/content.rs", "x-source-line": 20, "x-implicit-head": true, "responses": { "default": { "description": "Platform error; branch on HTTP status and stable code, not the human-readable message." } } } }, "/repos/{repo_id}/items/{item_id}/mounted-write": { "post": { "operationId": "platform_post__repos__repo_id__items__item_id__mounted_write", "summary": "conditional write file", "tags": [ "files · drafts" ], "parameters": [ { "name": "repo_id", "in": "path", "required": true, "schema": { "type": "string" } }, { "name": "item_id", "in": "path", "required": true, "schema": { "type": "string" } }, { "name": "x-synck-expected-head-blob-id", "in": "header", "required": true, "schema": { "type": "string" } }, { "name": "x-synck-expected-head-item-seq", "in": "header", "required": true, "schema": { "type": "integer", "minimum": 1 } }, { "name": "x-synck-mounted-write-id", "in": "header", "required": true, "schema": { "type": "string" } }, { "name": "x-synck-content-sha256", "in": "header", "required": true, "schema": { "type": "string", "pattern": "^[0-9a-f]{64}$" } }, { "name": "x-synck-content-size", "in": "header", "required": true, "schema": { "type": "integer", "minimum": 0 } } ], "description": "Authorization and validation are enforced by the owning service.\n\nThe request body contains the raw file bytes. Expected-head headers describe the persisted head, not a draft. The content size and SHA-256 must match the bytes; mounted-write-id identifies the write for idempotent retries.", "x-handler": "conditional_write_file", "x-source-file": "crates/synckhub-server/src/routes/files/drafts.rs", "x-source-line": 11, "responses": { "default": { "description": "Platform error; branch on HTTP status and stable code, not the human-readable message.", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } } }, "2XX": { "description": "Successful JSON response", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/synckhub_server.routes.files.drafts.MountedWriteFileResponse" } } } } }, "requestBody": { "required": true, "content": { "application/octet-stream": { "schema": { "type": "string", "format": "binary" } } } } } }, "/repos/{repo_id}/items/{item_id}/neighbors": { "get": { "operationId": "platform_get__repos__repo_id__items__item_id__neighbors", "summary": "get item neighbors", "tags": [ "items · read" ], "parameters": [ { "name": "repo_id", "in": "path", "required": true, "schema": { "type": "string" } }, { "name": "item_id", "in": "path", "required": true, "schema": { "type": "string" } }, { "name": "file_extensions", "in": "query", "required": true, "schema": { "type": "string" } }, { "name": "sort", "in": "query", "required": false, "schema": { "anyOf": [ { "type": "string" }, { "type": "null" } ] } }, { "name": "order", "in": "query", "required": false, "schema": { "anyOf": [ { "type": "string" }, { "type": "null" } ] } } ], "description": "Authorization and validation are enforced by the owning service.", "x-handler": "get_item_neighbors", "x-source-file": "crates/synckhub-server/src/routes/items/read.rs", "x-source-line": 27, "responses": { "default": { "description": "Platform error; branch on HTTP status and stable code, not the human-readable message.", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } } }, "2XX": { "description": "Successful JSON response", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/synckhub_server.routes.items.read.ItemNeighborsResponse" } } } } } }, "head": { "operationId": "platform_head__repos__repo_id__items__item_id__neighbors", "summary": "get item neighbors", "tags": [ "items · read" ], "parameters": [ { "name": "repo_id", "in": "path", "required": true, "schema": { "type": "string" } }, { "name": "item_id", "in": "path", "required": true, "schema": { "type": "string" } }, { "name": "file_extensions", "in": "query", "required": true, "schema": { "type": "string" } }, { "name": "sort", "in": "query", "required": false, "schema": { "anyOf": [ { "type": "string" }, { "type": "null" } ] } }, { "name": "order", "in": "query", "required": false, "schema": { "anyOf": [ { "type": "string" }, { "type": "null" } ] } } ], "description": "Authorization and validation are enforced by the owning service.\n\nHEAD uses the GET handler and headers without a response body.", "x-handler": "get_item_neighbors", "x-source-file": "crates/synckhub-server/src/routes/items/read.rs", "x-source-line": 27, "x-implicit-head": true, "responses": { "default": { "description": "Platform error; branch on HTTP status and stable code, not the human-readable message." } } } }, "/repos/{repo_id}/items/{item_id}/ocr": { "post": { "operationId": "platform_post__repos__repo_id__items__item_id__ocr", "summary": "request", "tags": [ "files · file_ocr" ], "parameters": [ { "name": "repo_id", "in": "path", "required": true, "schema": { "type": "string" } }, { "name": "item_id", "in": "path", "required": true, "schema": { "type": "string" } } ], "description": "Authorization and validation are enforced by the owning service.", "x-handler": "request", "x-source-file": "crates/synckhub-server/src/routes/files/file_ocr.rs", "x-source-line": 8, "responses": { "default": { "description": "Platform error; branch on HTTP status and stable code, not the human-readable message.", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } } } }, "requestBody": { "required": true, "content": { "application/json": { "schema": { "$ref": "#/components/schemas/synckhub_core_postgres.service.file_ocr.FileOcrRequest" } } } } }, "get": { "operationId": "platform_get__repos__repo_id__items__item_id__ocr", "summary": "status", "tags": [ "files · file_ocr" ], "parameters": [ { "name": "repo_id", "in": "path", "required": true, "schema": { "type": "string" } }, { "name": "item_id", "in": "path", "required": true, "schema": { "type": "string" } } ], "description": "Authorization and validation are enforced by the owning service.", "x-handler": "status", "x-source-file": "crates/synckhub-server/src/routes/files/file_ocr.rs", "x-source-line": 8, "responses": { "default": { "description": "Platform error; branch on HTTP status and stable code, not the human-readable message.", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } } }, "2XX": { "description": "Successful JSON response", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/synckhub_core_postgres.service.file_ocr.FileOcrStatus" } } } } } }, "head": { "operationId": "platform_head__repos__repo_id__items__item_id__ocr", "summary": "status", "tags": [ "files · file_ocr" ], "parameters": [ { "name": "repo_id", "in": "path", "required": true, "schema": { "type": "string" } }, { "name": "item_id", "in": "path", "required": true, "schema": { "type": "string" } } ], "description": "Authorization and validation are enforced by the owning service.\n\nHEAD uses the GET handler and headers without a response body.", "x-handler": "status", "x-source-file": "crates/synckhub-server/src/routes/files/file_ocr.rs", "x-source-line": 8, "x-implicit-head": true, "responses": { "default": { "description": "Platform error; branch on HTTP status and stable code, not the human-readable message." } } } }, "/repos/{repo_id}/items/{item_id}/people": { "put": { "operationId": "platform_put__repos__repo_id__items__item_id__people", "summary": "put note people", "tags": [ "items · metadata" ], "parameters": [ { "name": "repo_id", "in": "path", "required": true, "schema": { "type": "string" } }, { "name": "item_id", "in": "path", "required": true, "schema": { "type": "string" } } ], "description": "Authorization and validation are enforced by the owning service.", "x-handler": "put_note_people", "x-source-file": "crates/synckhub-server/src/routes/items/metadata.rs", "x-source-line": 7, "responses": { "default": { "description": "Platform error; branch on HTTP status and stable code, not the human-readable message.", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } } }, "2XX": { "description": "Successful JSON response", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/synckhub_server.routes.items.metadata.NotePeopleResponse" } } } } }, "requestBody": { "required": true, "content": { "application/json": { "schema": { "$ref": "#/components/schemas/synckhub_server.routes.items.metadata.PutNotePeopleRequest" } } } } }, "get": { "operationId": "platform_get__repos__repo_id__items__item_id__people", "summary": "get note people", "tags": [ "items · metadata" ], "parameters": [ { "name": "repo_id", "in": "path", "required": true, "schema": { "type": "string" } }, { "name": "item_id", "in": "path", "required": true, "schema": { "type": "string" } } ], "description": "Authorization and validation are enforced by the owning service.", "x-handler": "get_note_people", "x-source-file": "crates/synckhub-server/src/routes/items/metadata.rs", "x-source-line": 7, "responses": { "default": { "description": "Platform error; branch on HTTP status and stable code, not the human-readable message.", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } } }, "2XX": { "description": "Successful JSON response", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/synckhub_server.routes.items.metadata.NotePeopleResponse" } } } } } }, "head": { "operationId": "platform_head__repos__repo_id__items__item_id__people", "summary": "get note people", "tags": [ "items · metadata" ], "parameters": [ { "name": "repo_id", "in": "path", "required": true, "schema": { "type": "string" } }, { "name": "item_id", "in": "path", "required": true, "schema": { "type": "string" } } ], "description": "Authorization and validation are enforced by the owning service.\n\nHEAD uses the GET handler and headers without a response body.", "x-handler": "get_note_people", "x-source-file": "crates/synckhub-server/src/routes/items/metadata.rs", "x-source-line": 7, "x-implicit-head": true, "responses": { "default": { "description": "Platform error; branch on HTTP status and stable code, not the human-readable message." } } } }, "/repos/{repo_id}/items/{item_id}/quick-access": { "delete": { "operationId": "platform_delete__repos__repo_id__items__item_id__quick_access", "summary": "unpin item quick access", "tags": [ "items · read" ], "parameters": [ { "name": "repo_id", "in": "path", "required": true, "schema": { "type": "string" } }, { "name": "item_id", "in": "path", "required": true, "schema": { "type": "string" } } ], "description": "Authorization and validation are enforced by the owning service.", "x-handler": "unpin_item_quick_access", "x-source-file": "crates/synckhub-server/src/routes/items/read.rs", "x-source-line": 27, "responses": { "default": { "description": "Platform error; branch on HTTP status and stable code, not the human-readable message.", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } } } } }, "put": { "operationId": "platform_put__repos__repo_id__items__item_id__quick_access", "summary": "pin item quick access", "tags": [ "items · read" ], "parameters": [ { "name": "repo_id", "in": "path", "required": true, "schema": { "type": "string" } }, { "name": "item_id", "in": "path", "required": true, "schema": { "type": "string" } } ], "description": "Authorization and validation are enforced by the owning service.", "x-handler": "pin_item_quick_access", "x-source-file": "crates/synckhub-server/src/routes/items/read.rs", "x-source-line": 27, "responses": { "default": { "description": "Platform error; branch on HTTP status and stable code, not the human-readable message.", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } } } } } }, "/repos/{repo_id}/items/{item_id}/reconnect-federation": { "post": { "operationId": "platform_post__repos__repo_id__items__item_id__reconnect_federation", "summary": "reconnect federation item", "tags": [ "federation · items" ], "parameters": [ { "name": "repo_id", "in": "path", "required": true, "schema": { "type": "string" } }, { "name": "item_id", "in": "path", "required": true, "schema": { "type": "string" } } ], "description": "Authorization and validation are enforced by the owning service.", "x-handler": "reconnect_federation_item", "x-source-file": "crates/synckhub-server/src/routes/federation/items.rs", "x-source-line": 9, "responses": { "default": { "description": "Platform error; branch on HTTP status and stable code, not the human-readable message.", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } } }, "2XX": { "description": "Successful JSON response", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/synckhub_core.types.ItemSummary" } } } } }, "requestBody": { "required": true, "content": { "application/json": { "schema": { "$ref": "#/components/schemas/synckhub_server.routes.items.lifecycle.SimpleItemActionRequest" } } } } } }, "/repos/{repo_id}/items/{item_id}/restore": { "post": { "operationId": "platform_post__repos__repo_id__items__item_id__restore", "summary": "restore item", "tags": [ "items · lifecycle" ], "parameters": [ { "name": "repo_id", "in": "path", "required": true, "schema": { "type": "string" } }, { "name": "item_id", "in": "path", "required": true, "schema": { "type": "string" } } ], "description": "Authorization and validation are enforced by the owning service.", "x-handler": "restore_item", "x-source-file": "crates/synckhub-server/src/routes/items/lifecycle.rs", "x-source-line": 35, "responses": { "default": { "description": "Platform error; branch on HTTP status and stable code, not the human-readable message.", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } } }, "2XX": { "description": "Successful JSON response", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/synckhub_core.types.ItemSummary" } } } } }, "requestBody": { "required": true, "content": { "application/json": { "schema": { "$ref": "#/components/schemas/synckhub_server.routes.items.lifecycle.SimpleItemActionRequest" } } } } } }, "/repos/{repo_id}/items/{item_id}/restore-to": { "post": { "operationId": "platform_post__repos__repo_id__items__item_id__restore_to", "summary": "restore item to", "tags": [ "items · lifecycle" ], "parameters": [ { "name": "repo_id", "in": "path", "required": true, "schema": { "type": "string" } }, { "name": "item_id", "in": "path", "required": true, "schema": { "type": "string" } } ], "description": "Authorization and validation are enforced by the owning service.", "x-handler": "restore_item_to", "x-source-file": "crates/synckhub-server/src/routes/items/lifecycle.rs", "x-source-line": 35, "responses": { "default": { "description": "Platform error; branch on HTTP status and stable code, not the human-readable message.", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } } }, "2XX": { "description": "Successful JSON response", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/synckhub_core.types.ItemSummary" } } } } }, "requestBody": { "required": true, "content": { "application/json": { "schema": { "$ref": "#/components/schemas/synckhub_server.routes.items.lifecycle.RestoreToItemRequest" } } } } } }, "/repos/{repo_id}/items/{item_id}/rtc/livekit/call-links": { "post": { "operationId": "platform_post__repos__repo_id__items__item_id__rtc_livekit_call_links", "summary": "create livekit call link", "tags": [ "livekit" ], "parameters": [ { "name": "repo_id", "in": "path", "required": true, "schema": { "type": "string" } }, { "name": "item_id", "in": "path", "required": true, "schema": { "type": "string" } } ], "description": "Authorization and validation are enforced by the owning service.", "x-handler": "create_livekit_call_link", "x-source-file": "crates/synckhub-server/src/routes/livekit.rs", "x-source-line": 29, "responses": { "default": { "description": "Platform error; branch on HTTP status and stable code, not the human-readable message.", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } } }, "2XX": { "description": "Successful JSON response", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/synckhub_server.routes.livekit.CreateLivekitCallLinkResponse" } } } } }, "requestBody": { "required": true, "content": { "application/json": { "schema": { "$ref": "#/components/schemas/synckhub_server.routes.livekit.CreateLivekitCallLinkRequest" } } } } } }, "/repos/{repo_id}/items/{item_id}/set-color-metadata": { "post": { "operationId": "platform_post__repos__repo_id__items__item_id__set_color_metadata", "summary": "set item color metadata", "tags": [ "items · metadata" ], "parameters": [ { "name": "repo_id", "in": "path", "required": true, "schema": { "type": "string" } }, { "name": "item_id", "in": "path", "required": true, "schema": { "type": "string" } } ], "description": "Authorization and validation are enforced by the owning service.", "x-handler": "set_item_color_metadata", "x-source-file": "crates/synckhub-server/src/routes/items/metadata.rs", "x-source-line": 7, "responses": { "default": { "description": "Platform error; branch on HTTP status and stable code, not the human-readable message.", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } } }, "2XX": { "description": "Successful JSON response", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/synckhub_core.types.ItemWriteReceipt" } } } } }, "requestBody": { "required": true, "content": { "application/json": { "schema": { "$ref": "#/components/schemas/synckhub_server.routes.items.metadata.SetItemColorMetadataRequest" } } } } } }, "/repos/{repo_id}/items/{item_id}/set-content": { "post": { "operationId": "platform_post__repos__repo_id__items__item_id__set_content", "summary": "set item content", "tags": [ "items · write" ], "parameters": [ { "name": "repo_id", "in": "path", "required": true, "schema": { "type": "string" } }, { "name": "item_id", "in": "path", "required": true, "schema": { "type": "string" } }, { "name": "chat_item_id", "in": "query", "required": false, "schema": { "anyOf": [ { "type": "string" }, { "type": "null" } ] } }, { "name": "inline_media", "in": "query", "required": false, "schema": { "type": "boolean" } } ], "description": "Authorization and validation are enforced by the owning service.", "x-handler": "set_item_content", "x-source-file": "crates/synckhub-server/src/routes/items/write.rs", "x-source-line": 10, "responses": { "default": { "description": "Platform error; branch on HTTP status and stable code, not the human-readable message.", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } } }, "2XX": { "description": "Successful JSON response", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/synckhub_core.types.ItemWriteReceipt" } } } } }, "requestBody": { "required": true, "content": { "application/json": { "schema": { "$ref": "#/components/schemas/synckhub_server.routes.items.write.SetItemContentRequest" } } } } } }, "/repos/{repo_id}/items/{item_id}/set-metadata": { "post": { "operationId": "platform_post__repos__repo_id__items__item_id__set_metadata", "summary": "set item metadata", "tags": [ "items · metadata" ], "parameters": [ { "name": "repo_id", "in": "path", "required": true, "schema": { "type": "string" } }, { "name": "item_id", "in": "path", "required": true, "schema": { "type": "string" } } ], "description": "Authorization and validation are enforced by the owning service.", "x-handler": "set_item_metadata", "x-source-file": "crates/synckhub-server/src/routes/items/metadata.rs", "x-source-line": 7, "responses": { "default": { "description": "Platform error; branch on HTTP status and stable code, not the human-readable message.", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } } }, "2XX": { "description": "Successful JSON response", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/synckhub_core.types.ItemWriteReceipt" } } } } }, "requestBody": { "required": true, "content": { "application/json": { "schema": { "$ref": "#/components/schemas/synckhub_server.routes.items.metadata.SetItemMetadataRequest" } } } } } }, "/repos/{repo_id}/items/{item_id}/set-name": { "post": { "operationId": "platform_post__repos__repo_id__items__item_id__set_name", "summary": "set item name", "tags": [ "items · write" ], "parameters": [ { "name": "repo_id", "in": "path", "required": true, "schema": { "type": "string" } }, { "name": "item_id", "in": "path", "required": true, "schema": { "type": "string" } } ], "description": "Authorization and validation are enforced by the owning service.", "x-handler": "set_item_name", "x-source-file": "crates/synckhub-server/src/routes/items/write.rs", "x-source-line": 10, "responses": { "default": { "description": "Platform error; branch on HTTP status and stable code, not the human-readable message.", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } } }, "2XX": { "description": "Successful JSON response", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/synckhub_core.types.ItemSummary" } } } } }, "requestBody": { "required": true, "content": { "application/json": { "schema": { "$ref": "#/components/schemas/synckhub_server.routes.items.write.SetItemNameRequest" } } } } } }, "/repos/{repo_id}/items/{item_id}/set-parent": { "post": { "operationId": "platform_post__repos__repo_id__items__item_id__set_parent", "summary": "set item parent", "tags": [ "items · write" ], "parameters": [ { "name": "repo_id", "in": "path", "required": true, "schema": { "type": "string" } }, { "name": "item_id", "in": "path", "required": true, "schema": { "type": "string" } } ], "description": "Authorization and validation are enforced by the owning service.", "x-handler": "set_item_parent", "x-source-file": "crates/synckhub-server/src/routes/items/write.rs", "x-source-line": 10, "responses": { "default": { "description": "Platform error; branch on HTTP status and stable code, not the human-readable message.", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } } }, "2XX": { "description": "Successful JSON response", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/synckhub_core.types.ItemSummary" } } } } }, "requestBody": { "required": true, "content": { "application/json": { "schema": { "$ref": "#/components/schemas/synckhub_server.routes.items.write.SetItemParentRequest" } } } } } }, "/repos/{repo_id}/items/{item_id}/set-parent/preflight": { "post": { "operationId": "platform_post__repos__repo_id__items__item_id__set_parent_preflight", "summary": "preflight set item parent", "tags": [ "items · write" ], "parameters": [ { "name": "repo_id", "in": "path", "required": true, "schema": { "type": "string" } }, { "name": "item_id", "in": "path", "required": true, "schema": { "type": "string" } } ], "description": "Authorization and validation are enforced by the owning service.", "x-handler": "preflight_set_item_parent", "x-source-file": "crates/synckhub-server/src/routes/items/write.rs", "x-source-line": 10, "responses": { "default": { "description": "Platform error; branch on HTTP status and stable code, not the human-readable message.", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } } }, "2XX": { "description": "Successful JSON response", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/synckhub_server.routes.authz.MovePreflightResponse" } } } } }, "requestBody": { "required": true, "content": { "application/json": { "schema": { "$ref": "#/components/schemas/synckhub_server.routes.items.write.SetItemParentRequest" } } } } } }, "/repos/{repo_id}/items/{item_id}/shares": { "get": { "operationId": "platform_get__repos__repo_id__items__item_id__shares", "summary": "list item shares", "tags": [ "authz" ], "parameters": [ { "name": "repo_id", "in": "path", "required": true, "schema": { "type": "string" } }, { "name": "item_id", "in": "path", "required": true, "schema": { "type": "string" } } ], "description": "Authorization and validation are enforced by the owning service.", "x-handler": "list_item_shares", "x-source-file": "crates/synckhub-server/src/routes/authz.rs", "x-source-line": 6602, "responses": { "default": { "description": "Platform error; branch on HTTP status and stable code, not the human-readable message.", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } } }, "2XX": { "description": "Successful JSON response", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/synckhub_server.routes.authz.ItemSharesResponse" } } } } } }, "head": { "operationId": "platform_head__repos__repo_id__items__item_id__shares", "summary": "list item shares", "tags": [ "authz" ], "parameters": [ { "name": "repo_id", "in": "path", "required": true, "schema": { "type": "string" } }, { "name": "item_id", "in": "path", "required": true, "schema": { "type": "string" } } ], "description": "Authorization and validation are enforced by the owning service.\n\nHEAD uses the GET handler and headers without a response body.", "x-handler": "list_item_shares", "x-source-file": "crates/synckhub-server/src/routes/authz.rs", "x-source-line": 6602, "x-implicit-head": true, "responses": { "default": { "description": "Platform error; branch on HTTP status and stable code, not the human-readable message." } } } }, "/repos/{repo_id}/items/{item_id}/shares/delete": { "post": { "operationId": "platform_post__repos__repo_id__items__item_id__shares_delete", "summary": "delete item share", "tags": [ "authz" ], "parameters": [ { "name": "repo_id", "in": "path", "required": true, "schema": { "type": "string" } }, { "name": "item_id", "in": "path", "required": true, "schema": { "type": "string" } } ], "description": "Authorization and validation are enforced by the owning service.", "x-handler": "delete_item_share", "x-source-file": "crates/synckhub-server/src/routes/authz.rs", "x-source-line": 6602, "responses": { "default": { "description": "Platform error; branch on HTTP status and stable code, not the human-readable message.", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } } } }, "requestBody": { "required": true, "content": { "application/json": { "schema": { "$ref": "#/components/schemas/synckhub_server.routes.authz.ItemShareDeleteRequest" } } } } } }, "/repos/{repo_id}/items/{item_id}/shares/recover-admin": { "post": { "operationId": "platform_post__repos__repo_id__items__item_id__shares_recover_admin", "summary": "recover item admin", "tags": [ "authz" ], "parameters": [ { "name": "repo_id", "in": "path", "required": true, "schema": { "type": "string" } }, { "name": "item_id", "in": "path", "required": true, "schema": { "type": "string" } } ], "description": "Authorization and validation are enforced by the owning service.", "x-handler": "recover_item_admin", "x-source-file": "crates/synckhub-server/src/routes/authz.rs", "x-source-line": 6602, "responses": { "default": { "description": "Platform error; branch on HTTP status and stable code, not the human-readable message.", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } } } }, "requestBody": { "required": true, "content": { "application/json": { "schema": { "$ref": "#/components/schemas/synckhub_server.routes.authz.ItemAdminRecoveryRequest" } } } } } }, "/repos/{repo_id}/items/{item_id}/shares/upsert": { "post": { "operationId": "platform_post__repos__repo_id__items__item_id__shares_upsert", "summary": "upsert item share", "tags": [ "authz" ], "parameters": [ { "name": "repo_id", "in": "path", "required": true, "schema": { "type": "string" } }, { "name": "item_id", "in": "path", "required": true, "schema": { "type": "string" } } ], "description": "Authorization and validation are enforced by the owning service.", "x-handler": "upsert_item_share", "x-source-file": "crates/synckhub-server/src/routes/authz.rs", "x-source-line": 6602, "responses": { "default": { "description": "Platform error; branch on HTTP status and stable code, not the human-readable message.", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } } } }, "requestBody": { "required": true, "content": { "application/json": { "schema": { "$ref": "#/components/schemas/synckhub_server.routes.authz.ItemShareUpsertRequest" } } } } } }, "/repos/{repo_id}/items/{item_id}/subitems": { "get": { "operationId": "platform_get__repos__repo_id__items__item_id__subitems", "summary": "list subitems", "tags": [ "items · subitems" ], "parameters": [ { "name": "repo_id", "in": "path", "required": true, "schema": { "type": "string" } }, { "name": "item_id", "in": "path", "required": true, "schema": { "type": "string" } }, { "name": "subitem_type", "in": "query", "required": false, "schema": { "anyOf": [ { "type": "string" }, { "type": "null" } ] } }, { "name": "limit", "in": "query", "required": false, "schema": { "anyOf": [ { "type": "integer", "minimum": 0 }, { "type": "null" } ] } }, { "name": "offset", "in": "query", "required": false, "schema": { "anyOf": [ { "type": "integer", "minimum": 0 }, { "type": "null" } ] } }, { "name": "before_item_seq", "in": "query", "required": false, "schema": { "anyOf": [ { "type": "integer" }, { "type": "null" } ] } }, { "name": "after_item_seq", "in": "query", "required": false, "schema": { "anyOf": [ { "type": "integer" }, { "type": "null" } ] } } ], "description": "Authorization and validation are enforced by the owning service.", "x-handler": "list_subitems", "x-source-file": "crates/synckhub-server/src/routes/items/subitems.rs", "x-source-line": 53, "responses": { "default": { "description": "Platform error; branch on HTTP status and stable code, not the human-readable message.", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } } }, "2XX": { "description": "Successful JSON response", "content": { "application/json": { "schema": { "type": "array", "items": { "$ref": "#/components/schemas/synckhub_core.types.SubitemSummary" } } } } } } }, "head": { "operationId": "platform_head__repos__repo_id__items__item_id__subitems", "summary": "list subitems", "tags": [ "items · subitems" ], "parameters": [ { "name": "repo_id", "in": "path", "required": true, "schema": { "type": "string" } }, { "name": "item_id", "in": "path", "required": true, "schema": { "type": "string" } }, { "name": "subitem_type", "in": "query", "required": false, "schema": { "anyOf": [ { "type": "string" }, { "type": "null" } ] } }, { "name": "limit", "in": "query", "required": false, "schema": { "anyOf": [ { "type": "integer", "minimum": 0 }, { "type": "null" } ] } }, { "name": "offset", "in": "query", "required": false, "schema": { "anyOf": [ { "type": "integer", "minimum": 0 }, { "type": "null" } ] } }, { "name": "before_item_seq", "in": "query", "required": false, "schema": { "anyOf": [ { "type": "integer" }, { "type": "null" } ] } }, { "name": "after_item_seq", "in": "query", "required": false, "schema": { "anyOf": [ { "type": "integer" }, { "type": "null" } ] } } ], "description": "Authorization and validation are enforced by the owning service.\n\nHEAD uses the GET handler and headers without a response body.", "x-handler": "list_subitems", "x-source-file": "crates/synckhub-server/src/routes/items/subitems.rs", "x-source-line": 53, "x-implicit-head": true, "responses": { "default": { "description": "Platform error; branch on HTTP status and stable code, not the human-readable message." } } } }, "/repos/{repo_id}/items/{item_id}/subitems/{item_seq}/edit-meta": { "post": { "operationId": "platform_post__repos__repo_id__items__item_id__subitems__item_seq__edit_meta", "summary": "edit subitem", "tags": [ "items · subitems" ], "parameters": [ { "name": "repo_id", "in": "path", "required": true, "schema": { "type": "string" } }, { "name": "item_id", "in": "path", "required": true, "schema": { "type": "string" } }, { "name": "item_seq", "in": "path", "required": true, "schema": { "type": "integer" } } ], "description": "Authorization and validation are enforced by the owning service.", "x-handler": "edit_subitem", "x-source-file": "crates/synckhub-server/src/routes/items/subitems.rs", "x-source-line": 53, "responses": { "default": { "description": "Platform error; branch on HTTP status and stable code, not the human-readable message.", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } } }, "2XX": { "description": "Successful JSON response", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/synckhub_core.types.SubitemSummary" } } } } }, "requestBody": { "required": true, "content": { "application/json": { "schema": { "$ref": "#/components/schemas/synckhub_server.routes.items.subitems.EditSubitemRequest" } } } } } }, "/repos/{repo_id}/items/{item_id}/subitems/{item_seq}/restore": { "post": { "operationId": "platform_post__repos__repo_id__items__item_id__subitems__item_seq__restore", "summary": "restore subitem", "tags": [ "items · subitems" ], "parameters": [ { "name": "repo_id", "in": "path", "required": true, "schema": { "type": "string" } }, { "name": "item_id", "in": "path", "required": true, "schema": { "type": "string" } }, { "name": "item_seq", "in": "path", "required": true, "schema": { "type": "integer" } } ], "description": "Authorization and validation are enforced by the owning service.", "x-handler": "restore_subitem", "x-source-file": "crates/synckhub-server/src/routes/items/subitems.rs", "x-source-line": 53, "responses": { "default": { "description": "Platform error; branch on HTTP status and stable code, not the human-readable message.", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } } }, "2XX": { "description": "Successful JSON response", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/synckhub_core.types.SubitemSummary" } } } } }, "requestBody": { "required": true, "content": { "application/json": { "schema": { "$ref": "#/components/schemas/synckhub_server.routes.items.subitems.SubitemActionRequest" } } } } } }, "/repos/{repo_id}/items/{item_id}/subitems/{item_seq}/tombstone": { "post": { "operationId": "platform_post__repos__repo_id__items__item_id__subitems__item_seq__tombstone", "summary": "tombstone subitem", "tags": [ "items · subitems" ], "parameters": [ { "name": "repo_id", "in": "path", "required": true, "schema": { "type": "string" } }, { "name": "item_id", "in": "path", "required": true, "schema": { "type": "string" } }, { "name": "item_seq", "in": "path", "required": true, "schema": { "type": "integer" } } ], "description": "Authorization and validation are enforced by the owning service.", "x-handler": "tombstone_subitem", "x-source-file": "crates/synckhub-server/src/routes/items/subitems.rs", "x-source-line": 53, "responses": { "default": { "description": "Platform error; branch on HTTP status and stable code, not the human-readable message.", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } } }, "2XX": { "description": "Successful JSON response", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/synckhub_core.types.SubitemSummary" } } } } }, "requestBody": { "required": true, "content": { "application/json": { "schema": { "$ref": "#/components/schemas/synckhub_server.routes.items.subitems.SubitemActionRequest" } } } } } }, "/repos/{repo_id}/items/{item_id}/subitems/{item_seq}/trash": { "post": { "operationId": "platform_post__repos__repo_id__items__item_id__subitems__item_seq__trash", "summary": "trash subitem", "tags": [ "items · subitems" ], "parameters": [ { "name": "repo_id", "in": "path", "required": true, "schema": { "type": "string" } }, { "name": "item_id", "in": "path", "required": true, "schema": { "type": "string" } }, { "name": "item_seq", "in": "path", "required": true, "schema": { "type": "integer" } } ], "description": "Authorization and validation are enforced by the owning service.", "x-handler": "trash_subitem", "x-source-file": "crates/synckhub-server/src/routes/items/subitems.rs", "x-source-line": 53, "responses": { "default": { "description": "Platform error; branch on HTTP status and stable code, not the human-readable message.", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } } }, "2XX": { "description": "Successful JSON response", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/synckhub_core.types.SubitemSummary" } } } } }, "requestBody": { "required": true, "content": { "application/json": { "schema": { "$ref": "#/components/schemas/synckhub_server.routes.items.subitems.SubitemActionRequest" } } } } } }, "/repos/{repo_id}/items/{item_id}/subitems/add": { "post": { "operationId": "platform_post__repos__repo_id__items__item_id__subitems_add", "summary": "add subitem", "tags": [ "items · subitems" ], "parameters": [ { "name": "repo_id", "in": "path", "required": true, "schema": { "type": "string" } }, { "name": "item_id", "in": "path", "required": true, "schema": { "type": "string" } } ], "description": "Authorization and validation are enforced by the owning service.", "x-handler": "add_subitem", "x-source-file": "crates/synckhub-server/src/routes/items/subitems.rs", "x-source-line": 53, "responses": { "default": { "description": "Platform error; branch on HTTP status and stable code, not the human-readable message.", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } } }, "2XX": { "description": "Successful JSON response", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/synckhub_core.types.SubitemSummary" } } } } }, "requestBody": { "required": true, "content": { "application/json": { "schema": { "$ref": "#/components/schemas/synckhub_server.routes.items.subitems.AddSubitemRequest" } } } } } }, "/repos/{repo_id}/items/{item_id}/subtype": { "put": { "operationId": "platform_put__repos__repo_id__items__item_id__subtype", "summary": "put item subtype", "tags": [ "items · metadata" ], "parameters": [ { "name": "repo_id", "in": "path", "required": true, "schema": { "type": "string" } }, { "name": "item_id", "in": "path", "required": true, "schema": { "type": "string" } } ], "description": "Authorization and validation are enforced by the owning service.", "x-handler": "put_item_subtype", "x-source-file": "crates/synckhub-server/src/routes/items/metadata.rs", "x-source-line": 7, "responses": { "default": { "description": "Platform error; branch on HTTP status and stable code, not the human-readable message.", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } } }, "2XX": { "description": "Successful JSON response", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/synckhub_core.types.ItemSummary" } } } } }, "requestBody": { "required": true, "content": { "application/json": { "schema": { "$ref": "#/components/schemas/synckhub_server.routes.items.metadata.PutItemSubtypeRequest" } } } } }, "get": { "operationId": "platform_get__repos__repo_id__items__item_id__subtype", "summary": "get item subtype", "tags": [ "items · metadata" ], "parameters": [ { "name": "repo_id", "in": "path", "required": true, "schema": { "type": "string" } }, { "name": "item_id", "in": "path", "required": true, "schema": { "type": "string" } } ], "description": "Authorization and validation are enforced by the owning service.", "x-handler": "get_item_subtype", "x-source-file": "crates/synckhub-server/src/routes/items/metadata.rs", "x-source-line": 7, "responses": { "default": { "description": "Platform error; branch on HTTP status and stable code, not the human-readable message.", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } } }, "2XX": { "description": "Successful JSON response", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/synckhub_server.routes.items.metadata.ItemSubtypeResponse" } } } } } }, "head": { "operationId": "platform_head__repos__repo_id__items__item_id__subtype", "summary": "get item subtype", "tags": [ "items · metadata" ], "parameters": [ { "name": "repo_id", "in": "path", "required": true, "schema": { "type": "string" } }, { "name": "item_id", "in": "path", "required": true, "schema": { "type": "string" } } ], "description": "Authorization and validation are enforced by the owning service.\n\nHEAD uses the GET handler and headers without a response body.", "x-handler": "get_item_subtype", "x-source-file": "crates/synckhub-server/src/routes/items/metadata.rs", "x-source-line": 7, "x-implicit-head": true, "responses": { "default": { "description": "Platform error; branch on HTTP status and stable code, not the human-readable message." } } } }, "/repos/{repo_id}/items/{item_id}/thumbnail": { "get": { "operationId": "platform_get__repos__repo_id__items__item_id__thumbnail", "summary": "get item thumbnail", "tags": [ "files · content" ], "parameters": [ { "name": "repo_id", "in": "path", "required": true, "schema": { "type": "string" } }, { "name": "item_id", "in": "path", "required": true, "schema": { "type": "string" } }, { "name": "chat_item_id", "in": "query", "required": false, "schema": { "anyOf": [ { "type": "string" }, { "type": "null" } ] } }, { "name": "inline_media", "in": "query", "required": false, "schema": { "type": "boolean" } } ], "description": "Authorization and validation are enforced by the owning service.", "x-handler": "get_item_thumbnail", "x-source-file": "crates/synckhub-server/src/routes/files/content.rs", "x-source-line": 20, "responses": { "default": { "description": "Platform error; branch on HTTP status and stable code, not the human-readable message.", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } } } } }, "head": { "operationId": "platform_head__repos__repo_id__items__item_id__thumbnail", "summary": "get item thumbnail", "tags": [ "files · content" ], "parameters": [ { "name": "repo_id", "in": "path", "required": true, "schema": { "type": "string" } }, { "name": "item_id", "in": "path", "required": true, "schema": { "type": "string" } }, { "name": "chat_item_id", "in": "query", "required": false, "schema": { "anyOf": [ { "type": "string" }, { "type": "null" } ] } }, { "name": "inline_media", "in": "query", "required": false, "schema": { "type": "boolean" } } ], "description": "Authorization and validation are enforced by the owning service.\n\nHEAD uses the GET handler and headers without a response body.", "x-handler": "get_item_thumbnail", "x-source-file": "crates/synckhub-server/src/routes/files/content.rs", "x-source-line": 20, "x-implicit-head": true, "responses": { "default": { "description": "Platform error; branch on HTTP status and stable code, not the human-readable message." } } } }, "/repos/{repo_id}/items/{item_id}/tombstone": { "post": { "operationId": "platform_post__repos__repo_id__items__item_id__tombstone", "summary": "tombstone item", "tags": [ "items · lifecycle" ], "parameters": [ { "name": "repo_id", "in": "path", "required": true, "schema": { "type": "string" } }, { "name": "item_id", "in": "path", "required": true, "schema": { "type": "string" } } ], "description": "Authorization and validation are enforced by the owning service.", "x-handler": "tombstone_item", "x-source-file": "crates/synckhub-server/src/routes/items/lifecycle.rs", "x-source-line": 35, "responses": { "default": { "description": "Platform error; branch on HTTP status and stable code, not the human-readable message.", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } } }, "2XX": { "description": "Successful JSON response", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/synckhub_core.types.ItemSummary" } } } } }, "requestBody": { "required": true, "content": { "application/json": { "schema": { "$ref": "#/components/schemas/synckhub_server.routes.items.lifecycle.SimpleItemActionRequest" } } } } } }, "/repos/{repo_id}/items/{item_id}/trash": { "post": { "operationId": "platform_post__repos__repo_id__items__item_id__trash", "summary": "trash item", "tags": [ "items · lifecycle" ], "parameters": [ { "name": "repo_id", "in": "path", "required": true, "schema": { "type": "string" } }, { "name": "item_id", "in": "path", "required": true, "schema": { "type": "string" } } ], "description": "Authorization and validation are enforced by the owning service.", "x-handler": "trash_item", "x-source-file": "crates/synckhub-server/src/routes/items/lifecycle.rs", "x-source-line": 35, "responses": { "default": { "description": "Platform error; branch on HTTP status and stable code, not the human-readable message.", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } } }, "2XX": { "description": "Successful JSON response", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/synckhub_core.types.ItemSummary" } } } } }, "requestBody": { "required": true, "content": { "application/json": { "schema": { "$ref": "#/components/schemas/synckhub_server.routes.items.lifecycle.SimpleItemActionRequest" } } } } } }, "/repos/{repo_id}/items/{item_id}/wopi/action-url": { "post": { "operationId": "platform_post__repos__repo_id__items__item_id__wopi_action_url", "summary": "mint office action url", "tags": [ "wopi" ], "parameters": [ { "name": "repo_id", "in": "path", "required": true, "schema": { "type": "string" } }, { "name": "item_id", "in": "path", "required": true, "schema": { "type": "string" } } ], "description": "Authorization and validation are enforced by the owning service.", "x-handler": "mint_office_action_url", "x-source-file": "crates/synckhub-server/src/routes/wopi.rs", "x-source-line": 258, "responses": { "default": { "description": "Platform error; branch on HTTP status and stable code, not the human-readable message.", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } } }, "2XX": { "description": "Successful JSON response", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/synckhub_server.routes.wopi.MintOfficeActionUrlResponse" } } } } }, "requestBody": { "required": true, "content": { "application/json": { "schema": { "$ref": "#/components/schemas/synckhub_server.routes.wopi.MintOfficeActionUrlRequest" } } } } } }, "/repos/{repo_id}/items/{item_id}/workflow/assign": { "post": { "operationId": "platform_post__repos__repo_id__items__item_id__workflow_assign", "summary": "assign folder workflow state", "tags": [ "cases · mod" ], "parameters": [ { "name": "repo_id", "in": "path", "required": true, "schema": { "type": "string" } }, { "name": "item_id", "in": "path", "required": true, "schema": { "type": "string" } } ], "description": "Authorization and validation are enforced by the owning service.", "x-handler": "assign_folder_workflow_state", "x-source-file": "crates/synckhub-server/src/routes/cases/mod.rs", "x-source-line": 17, "responses": { "default": { "description": "Platform error; branch on HTTP status and stable code, not the human-readable message.", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } } }, "2XX": { "description": "Successful JSON response", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/synckhub_core.types.ItemSummary" } } } } }, "requestBody": { "required": true, "content": { "application/json": { "schema": { "$ref": "#/components/schemas/synckhub_server.routes.cases.workflow.AssignFolderWorkflowStateRequest" } } } } } }, "/repos/{repo_id}/items/{item_id}/workflow/run-log": { "get": { "operationId": "platform_get__repos__repo_id__items__item_id__workflow_run_log", "summary": "get folder workflow run log", "tags": [ "cases · mod" ], "parameters": [ { "name": "repo_id", "in": "path", "required": true, "schema": { "type": "string" } }, { "name": "item_id", "in": "path", "required": true, "schema": { "type": "string" } }, { "name": "limit", "in": "query", "required": false, "schema": { "anyOf": [ { "type": "integer" }, { "type": "null" } ] } } ], "description": "Authorization and validation are enforced by the owning service.", "x-handler": "get_folder_workflow_run_log", "x-source-file": "crates/synckhub-server/src/routes/cases/mod.rs", "x-source-line": 17, "responses": { "default": { "description": "Platform error; branch on HTTP status and stable code, not the human-readable message.", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } } }, "2XX": { "description": "Successful JSON response", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/synckhub_server.routes.cases.workflow.FolderWorkflowRunLogResponse" } } } } } }, "head": { "operationId": "platform_head__repos__repo_id__items__item_id__workflow_run_log", "summary": "get folder workflow run log", "tags": [ "cases · mod" ], "parameters": [ { "name": "repo_id", "in": "path", "required": true, "schema": { "type": "string" } }, { "name": "item_id", "in": "path", "required": true, "schema": { "type": "string" } }, { "name": "limit", "in": "query", "required": false, "schema": { "anyOf": [ { "type": "integer" }, { "type": "null" } ] } } ], "description": "Authorization and validation are enforced by the owning service.\n\nHEAD uses the GET handler and headers without a response body.", "x-handler": "get_folder_workflow_run_log", "x-source-file": "crates/synckhub-server/src/routes/cases/mod.rs", "x-source-line": 17, "x-implicit-head": true, "responses": { "default": { "description": "Platform error; branch on HTTP status and stable code, not the human-readable message." } } } }, "/repos/{repo_id}/items/{item_id}/workflow/transition": { "post": { "operationId": "platform_post__repos__repo_id__items__item_id__workflow_transition", "summary": "apply folder workflow transition", "tags": [ "cases · mod" ], "parameters": [ { "name": "repo_id", "in": "path", "required": true, "schema": { "type": "string" } }, { "name": "item_id", "in": "path", "required": true, "schema": { "type": "string" } } ], "description": "Authorization and validation are enforced by the owning service.", "x-handler": "apply_folder_workflow_transition", "x-source-file": "crates/synckhub-server/src/routes/cases/mod.rs", "x-source-line": 17, "responses": { "default": { "description": "Platform error; branch on HTTP status and stable code, not the human-readable message.", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } } }, "2XX": { "description": "Successful JSON response", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/synckhub_core.types.ItemSummary" } } } } }, "requestBody": { "required": true, "content": { "application/json": { "schema": { "$ref": "#/components/schemas/synckhub_server.routes.cases.workflow.ApplyFolderWorkflowTransitionRequest" } } } } } }, "/repos/{repo_id}/items/{item_id}/workflow/validate-transition": { "post": { "operationId": "platform_post__repos__repo_id__items__item_id__workflow_validate_transition", "summary": "validate folder workflow transition", "tags": [ "cases · mod" ], "parameters": [ { "name": "repo_id", "in": "path", "required": true, "schema": { "type": "string" } }, { "name": "item_id", "in": "path", "required": true, "schema": { "type": "string" } } ], "description": "Authorization and validation are enforced by the owning service.", "x-handler": "validate_folder_workflow_transition", "x-source-file": "crates/synckhub-server/src/routes/cases/mod.rs", "x-source-line": 17, "responses": { "default": { "description": "Platform error; branch on HTTP status and stable code, not the human-readable message.", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } } }, "2XX": { "description": "Successful JSON response", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/synckhub_server.routes.cases.workflow.FolderWorkflowTransitionValidationResponse" } } } } }, "requestBody": { "required": true, "content": { "application/json": { "schema": { "$ref": "#/components/schemas/synckhub_server.routes.cases.workflow.ValidateFolderWorkflowTransitionRequest" } } } } } }, "/repos/{repo_id}/items/{item_id}/workflow/version": { "get": { "operationId": "platform_get__repos__repo_id__items__item_id__workflow_version", "summary": "get case workflow version", "tags": [ "cases · mod" ], "parameters": [ { "name": "repo_id", "in": "path", "required": true, "schema": { "type": "string" } }, { "name": "item_id", "in": "path", "required": true, "schema": { "type": "string" } } ], "description": "Authorization and validation are enforced by the owning service.", "x-handler": "get_case_workflow_version", "x-source-file": "crates/synckhub-server/src/routes/cases/mod.rs", "x-source-line": 17, "responses": { "default": { "description": "Platform error; branch on HTTP status and stable code, not the human-readable message.", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } } }, "2XX": { "description": "Successful JSON response", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/synckhub_server.routes.cases.workflow.CaseWorkflowVersionResponse" } } } } } }, "head": { "operationId": "platform_head__repos__repo_id__items__item_id__workflow_version", "summary": "get case workflow version", "tags": [ "cases · mod" ], "parameters": [ { "name": "repo_id", "in": "path", "required": true, "schema": { "type": "string" } }, { "name": "item_id", "in": "path", "required": true, "schema": { "type": "string" } } ], "description": "Authorization and validation are enforced by the owning service.\n\nHEAD uses the GET handler and headers without a response body.", "x-handler": "get_case_workflow_version", "x-source-file": "crates/synckhub-server/src/routes/cases/mod.rs", "x-source-line": 17, "x-implicit-head": true, "responses": { "default": { "description": "Platform error; branch on HTTP status and stable code, not the human-readable message." } } } }, "/repos/{repo_id}/items/batch/create": { "post": { "operationId": "platform_post__repos__repo_id__items_batch_create", "summary": "batch create items", "tags": [ "items · write" ], "parameters": [ { "name": "repo_id", "in": "path", "required": true, "schema": { "type": "string" } } ], "description": "Authorization and validation are enforced by the owning service.", "x-handler": "batch_create_items", "x-source-file": "crates/synckhub-server/src/routes/items/write.rs", "x-source-line": 10, "responses": { "default": { "description": "Platform error; branch on HTTP status and stable code, not the human-readable message.", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } } }, "2XX": { "description": "Successful JSON response", "content": { "application/json": { "schema": { "type": "array", "items": { "$ref": "#/components/schemas/synckhub_core.types.ItemSummary" } } } } } }, "requestBody": { "required": true, "content": { "application/json": { "schema": { "$ref": "#/components/schemas/synckhub_server.routes.items.write.BatchCreateItemsRequest" } } } } } }, "/repos/{repo_id}/items/batch/operations": { "post": { "operationId": "platform_post__repos__repo_id__items_batch_operations", "summary": "batch item operations", "tags": [ "items · write" ], "parameters": [ { "name": "repo_id", "in": "path", "required": true, "schema": { "type": "string" } } ], "description": "Authorization and validation are enforced by the owning service.", "x-handler": "batch_item_operations", "x-source-file": "crates/synckhub-server/src/routes/items/write.rs", "x-source-line": 10, "responses": { "default": { "description": "Platform error; branch on HTTP status and stable code, not the human-readable message.", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } } }, "2XX": { "description": "Successful JSON response", "content": { "application/json": { "schema": { "type": "array", "items": { "$ref": "#/components/schemas/synckhub_core.types.ItemSummary" } } } } } }, "requestBody": { "required": true, "content": { "application/json": { "schema": { "$ref": "#/components/schemas/synckhub_server.routes.items.write.BatchItemOperationsRequest" } } } } } }, "/repos/{repo_id}/items/batch/restore": { "post": { "operationId": "platform_post__repos__repo_id__items_batch_restore", "summary": "batch restore items", "tags": [ "items · lifecycle" ], "parameters": [ { "name": "repo_id", "in": "path", "required": true, "schema": { "type": "string" } } ], "description": "Authorization and validation are enforced by the owning service.", "x-handler": "batch_restore_items", "x-source-file": "crates/synckhub-server/src/routes/items/lifecycle.rs", "x-source-line": 35, "responses": { "default": { "description": "Platform error; branch on HTTP status and stable code, not the human-readable message.", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } } }, "2XX": { "description": "Successful JSON response", "content": { "application/json": { "schema": { "type": "array", "items": { "$ref": "#/components/schemas/synckhub_core.types.ItemSummary" } } } } } }, "requestBody": { "required": true, "content": { "application/json": { "schema": { "$ref": "#/components/schemas/synckhub_server.routes.items.lifecycle.BatchItemActionRequest" } } } } } }, "/repos/{repo_id}/items/batch/set-metadata": { "post": { "operationId": "platform_post__repos__repo_id__items_batch_set_metadata", "summary": "batch set item metadata", "tags": [ "items · metadata" ], "parameters": [ { "name": "repo_id", "in": "path", "required": true, "schema": { "type": "string" } } ], "description": "Authorization and validation are enforced by the owning service.", "x-handler": "batch_set_item_metadata", "x-source-file": "crates/synckhub-server/src/routes/items/metadata.rs", "x-source-line": 7, "responses": { "default": { "description": "Platform error; branch on HTTP status and stable code, not the human-readable message.", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } } }, "2XX": { "description": "Successful JSON response", "content": { "application/json": { "schema": { "type": "array", "items": { "$ref": "#/components/schemas/synckhub_core.types.ItemWriteReceipt" } } } } } }, "requestBody": { "required": true, "content": { "application/json": { "schema": { "$ref": "#/components/schemas/synckhub_server.routes.items.metadata.BatchSetItemMetadataRequest" } } } } } }, "/repos/{repo_id}/items/batch/set-name": { "post": { "operationId": "platform_post__repos__repo_id__items_batch_set_name", "summary": "batch set item names", "tags": [ "items · write" ], "parameters": [ { "name": "repo_id", "in": "path", "required": true, "schema": { "type": "string" } } ], "description": "Authorization and validation are enforced by the owning service.", "x-handler": "batch_set_item_names", "x-source-file": "crates/synckhub-server/src/routes/items/write.rs", "x-source-line": 10, "responses": { "default": { "description": "Platform error; branch on HTTP status and stable code, not the human-readable message.", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } } }, "2XX": { "description": "Successful JSON response", "content": { "application/json": { "schema": { "type": "array", "items": { "$ref": "#/components/schemas/synckhub_core.types.ItemSummary" } } } } } }, "requestBody": { "required": true, "content": { "application/json": { "schema": { "$ref": "#/components/schemas/synckhub_server.routes.items.write.BatchSetItemNamesRequest" } } } } } }, "/repos/{repo_id}/items/batch/set-parent": { "post": { "operationId": "platform_post__repos__repo_id__items_batch_set_parent", "summary": "batch set item parents", "tags": [ "items · write" ], "parameters": [ { "name": "repo_id", "in": "path", "required": true, "schema": { "type": "string" } } ], "description": "Authorization and validation are enforced by the owning service.", "x-handler": "batch_set_item_parents", "x-source-file": "crates/synckhub-server/src/routes/items/write.rs", "x-source-line": 10, "responses": { "default": { "description": "Platform error; branch on HTTP status and stable code, not the human-readable message.", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } } }, "2XX": { "description": "Successful JSON response", "content": { "application/json": { "schema": { "type": "array", "items": { "$ref": "#/components/schemas/synckhub_core.types.ItemSummary" } } } } } }, "requestBody": { "required": true, "content": { "application/json": { "schema": { "$ref": "#/components/schemas/synckhub_server.routes.items.write.BatchSetItemParentsRequest" } } } } } }, "/repos/{repo_id}/items/batch/set-parent/preflight": { "post": { "operationId": "platform_post__repos__repo_id__items_batch_set_parent_preflight", "summary": "preflight batch set item parents", "tags": [ "items · write" ], "parameters": [ { "name": "repo_id", "in": "path", "required": true, "schema": { "type": "string" } } ], "description": "Authorization and validation are enforced by the owning service.", "x-handler": "preflight_batch_set_item_parents", "x-source-file": "crates/synckhub-server/src/routes/items/write.rs", "x-source-line": 10, "responses": { "default": { "description": "Platform error; branch on HTTP status and stable code, not the human-readable message.", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } } }, "2XX": { "description": "Successful JSON response", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/synckhub_server.routes.authz.MovePreflightResponse" } } } } }, "requestBody": { "required": true, "content": { "application/json": { "schema": { "$ref": "#/components/schemas/synckhub_server.routes.items.write.BatchSetItemParentsRequest" } } } } } }, "/repos/{repo_id}/items/batch/set-subtype": { "post": { "operationId": "platform_post__repos__repo_id__items_batch_set_subtype", "summary": "batch set item subtypes", "tags": [ "items · metadata" ], "parameters": [ { "name": "repo_id", "in": "path", "required": true, "schema": { "type": "string" } } ], "description": "Authorization and validation are enforced by the owning service.", "x-handler": "batch_set_item_subtypes", "x-source-file": "crates/synckhub-server/src/routes/items/metadata.rs", "x-source-line": 7, "responses": { "default": { "description": "Platform error; branch on HTTP status and stable code, not the human-readable message.", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } } }, "2XX": { "description": "Successful JSON response", "content": { "application/json": { "schema": { "type": "array", "items": { "$ref": "#/components/schemas/synckhub_core.types.ItemWriteReceipt" } } } } } }, "requestBody": { "required": true, "content": { "application/json": { "schema": { "$ref": "#/components/schemas/synckhub_server.routes.items.metadata.BatchSetItemSubtypesRequest" } } } } } }, "/repos/{repo_id}/items/batch/tombstone": { "post": { "operationId": "platform_post__repos__repo_id__items_batch_tombstone", "summary": "batch tombstone items", "tags": [ "items · lifecycle" ], "parameters": [ { "name": "repo_id", "in": "path", "required": true, "schema": { "type": "string" } } ], "description": "Authorization and validation are enforced by the owning service.", "x-handler": "batch_tombstone_items", "x-source-file": "crates/synckhub-server/src/routes/items/lifecycle.rs", "x-source-line": 35, "responses": { "default": { "description": "Platform error; branch on HTTP status and stable code, not the human-readable message.", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } } }, "2XX": { "description": "Successful JSON response", "content": { "application/json": { "schema": { "type": "array", "items": { "$ref": "#/components/schemas/synckhub_core.types.ItemSummary" } } } } } }, "requestBody": { "required": true, "content": { "application/json": { "schema": { "$ref": "#/components/schemas/synckhub_server.routes.items.lifecycle.BatchItemActionRequest" } } } } } }, "/repos/{repo_id}/items/batch/trash": { "post": { "operationId": "platform_post__repos__repo_id__items_batch_trash", "summary": "batch trash items", "tags": [ "items · lifecycle" ], "parameters": [ { "name": "repo_id", "in": "path", "required": true, "schema": { "type": "string" } } ], "description": "Authorization and validation are enforced by the owning service.", "x-handler": "batch_trash_items", "x-source-file": "crates/synckhub-server/src/routes/items/lifecycle.rs", "x-source-line": 35, "responses": { "default": { "description": "Platform error; branch on HTTP status and stable code, not the human-readable message.", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } } }, "2XX": { "description": "Successful JSON response", "content": { "application/json": { "schema": { "type": "array", "items": { "$ref": "#/components/schemas/synckhub_core.types.ItemSummary" } } } } } }, "requestBody": { "required": true, "content": { "application/json": { "schema": { "$ref": "#/components/schemas/synckhub_server.routes.items.lifecycle.BatchItemActionRequest" } } } } } }, "/repos/{repo_id}/items/by-path/{item_path}": { "get": { "operationId": "platform_get__repos__repo_id__items_by_path__item_path_", "summary": "get item by path", "tags": [ "items · read" ], "parameters": [ { "name": "repo_id", "in": "path", "required": true, "schema": { "type": "string" } }, { "name": "item_path", "in": "path", "required": true, "schema": { "type": "string" }, "description": "Catch-all path; may contain slash-separated segments." }, { "name": "include", "in": "query", "required": false, "schema": { "anyOf": [ { "type": "string" }, { "type": "null" } ] } } ], "description": "Authorization and validation are enforced by the owning service.", "x-handler": "get_item_by_path", "x-source-file": "crates/synckhub-server/src/routes/items/read.rs", "x-source-line": 27, "responses": { "default": { "description": "Platform error; branch on HTTP status and stable code, not the human-readable message.", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } } }, "2XX": { "description": "Successful JSON response", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/synckhub_core.types.ItemSummary" } } } } } }, "head": { "operationId": "platform_head__repos__repo_id__items_by_path__item_path_", "summary": "get item by path", "tags": [ "items · read" ], "parameters": [ { "name": "repo_id", "in": "path", "required": true, "schema": { "type": "string" } }, { "name": "item_path", "in": "path", "required": true, "schema": { "type": "string" }, "description": "Catch-all path; may contain slash-separated segments." }, { "name": "include", "in": "query", "required": false, "schema": { "anyOf": [ { "type": "string" }, { "type": "null" } ] } } ], "description": "Authorization and validation are enforced by the owning service.\n\nHEAD uses the GET handler and headers without a response body.", "x-handler": "get_item_by_path", "x-source-file": "crates/synckhub-server/src/routes/items/read.rs", "x-source-line": 27, "x-implicit-head": true, "responses": { "default": { "description": "Platform error; branch on HTTP status and stable code, not the human-readable message." } } } }, "/repos/{repo_id}/items/by-type/{item_type}": { "get": { "operationId": "platform_get__repos__repo_id__items_by_type__item_type_", "summary": "list items by type", "tags": [ "items · read" ], "parameters": [ { "name": "repo_id", "in": "path", "required": true, "schema": { "type": "string" } }, { "name": "item_type", "in": "path", "required": true, "schema": { "type": "string" } }, { "name": "item_type", "in": "query", "required": false, "schema": { "type": "array", "items": { "type": "string" } }, "style": "form", "explode": true }, { "name": "item_type_exclude", "in": "query", "required": false, "schema": { "type": "array", "items": { "type": "string" } }, "style": "form", "explode": true }, { "name": "item_subtype", "in": "query", "required": false, "schema": { "type": "array", "items": { "type": "string" } }, "style": "form", "explode": true }, { "name": "case_status", "in": "query", "required": false, "schema": { "type": "array", "items": { "type": "string" } }, "style": "form", "explode": true }, { "name": "file_extension", "in": "query", "required": false, "schema": { "type": "array", "items": { "type": "string" }, "description": "Optional FILE-branch filter (repeatable; ANY match), e.g. `file_extension=pdf`.\n\nValues are normalized to lowercase ASCII and stored without a leading dot." }, "style": "form", "explode": true }, { "name": "file_extension_exclude", "in": "query", "required": false, "schema": { "type": "array", "items": { "type": "string" }, "description": "Optional FILE-branch exclusion (repeatable; ANY match), e.g. `file_extension_exclude=eml`." }, "style": "form", "explode": true }, { "name": "quick_access", "in": "query", "required": false, "schema": { "anyOf": [ { "type": "boolean" }, { "type": "null" } ] } }, { "name": "parent_folder_id", "in": "query", "required": false, "schema": { "anyOf": [ { "type": "string" }, { "type": "null" } ], "description": "Optional parent folder filter:\n- `None` means no parent filter (all items in the repo).\n- `Some(id)` means direct children of the given folder id.\n- `Some(\"\")` means root items only (no parent folder)." } }, { "name": "in_trash", "in": "query", "required": false, "schema": { "anyOf": [ { "type": "boolean" }, { "type": "null" } ] } }, { "name": "tombstoned", "in": "query", "required": false, "schema": { "anyOf": [ { "type": "boolean" }, { "type": "null" } ] } }, { "name": "limit", "in": "query", "required": false, "schema": { "anyOf": [ { "type": "integer", "minimum": 0 }, { "type": "null" } ] } }, { "name": "offset", "in": "query", "required": false, "schema": { "anyOf": [ { "type": "integer", "minimum": 0 }, { "type": "null" } ] } }, { "name": "sort", "in": "query", "required": false, "schema": { "anyOf": [ { "$ref": "#/components/schemas/synckhub_core.types.ListItemsSort" }, { "type": "null" } ] } }, { "name": "order", "in": "query", "required": false, "schema": { "anyOf": [ { "$ref": "#/components/schemas/synckhub_core.types.ListItemsOrder" }, { "type": "null" } ] } }, { "name": "folders_first", "in": "query", "required": false, "schema": { "anyOf": [ { "type": "boolean" }, { "type": "null" } ] } }, { "name": "after_name", "in": "query", "required": false, "schema": { "anyOf": [ { "type": "string" }, { "type": "null" } ] } }, { "name": "after_item_id", "in": "query", "required": false, "schema": { "anyOf": [ { "type": "string" }, { "type": "null" } ] } }, { "name": "include", "in": "query", "required": false, "schema": { "anyOf": [ { "type": "string" }, { "type": "null" } ], "description": "Optional expansions (comma-separated), e.g. `include=breadcrumbs`." } } ], "description": "List items of a given type in a repository.\n\nAuthorization and validation are enforced by the owning service.", "x-handler": "list_items_by_type", "x-source-file": "crates/synckhub-server/src/routes/items/read.rs", "x-source-line": 27, "responses": { "default": { "description": "Platform error; branch on HTTP status and stable code, not the human-readable message.", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } } }, "2XX": { "description": "Successful JSON response", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/synckhub_server.routes.ListItemsResponse" } } } } } }, "head": { "operationId": "platform_head__repos__repo_id__items_by_type__item_type_", "summary": "list items by type", "tags": [ "items · read" ], "parameters": [ { "name": "repo_id", "in": "path", "required": true, "schema": { "type": "string" } }, { "name": "item_type", "in": "path", "required": true, "schema": { "type": "string" } }, { "name": "item_type", "in": "query", "required": false, "schema": { "type": "array", "items": { "type": "string" } }, "style": "form", "explode": true }, { "name": "item_type_exclude", "in": "query", "required": false, "schema": { "type": "array", "items": { "type": "string" } }, "style": "form", "explode": true }, { "name": "item_subtype", "in": "query", "required": false, "schema": { "type": "array", "items": { "type": "string" } }, "style": "form", "explode": true }, { "name": "case_status", "in": "query", "required": false, "schema": { "type": "array", "items": { "type": "string" } }, "style": "form", "explode": true }, { "name": "file_extension", "in": "query", "required": false, "schema": { "type": "array", "items": { "type": "string" }, "description": "Optional FILE-branch filter (repeatable; ANY match), e.g. `file_extension=pdf`.\n\nValues are normalized to lowercase ASCII and stored without a leading dot." }, "style": "form", "explode": true }, { "name": "file_extension_exclude", "in": "query", "required": false, "schema": { "type": "array", "items": { "type": "string" }, "description": "Optional FILE-branch exclusion (repeatable; ANY match), e.g. `file_extension_exclude=eml`." }, "style": "form", "explode": true }, { "name": "quick_access", "in": "query", "required": false, "schema": { "anyOf": [ { "type": "boolean" }, { "type": "null" } ] } }, { "name": "parent_folder_id", "in": "query", "required": false, "schema": { "anyOf": [ { "type": "string" }, { "type": "null" } ], "description": "Optional parent folder filter:\n- `None` means no parent filter (all items in the repo).\n- `Some(id)` means direct children of the given folder id.\n- `Some(\"\")` means root items only (no parent folder)." } }, { "name": "in_trash", "in": "query", "required": false, "schema": { "anyOf": [ { "type": "boolean" }, { "type": "null" } ] } }, { "name": "tombstoned", "in": "query", "required": false, "schema": { "anyOf": [ { "type": "boolean" }, { "type": "null" } ] } }, { "name": "limit", "in": "query", "required": false, "schema": { "anyOf": [ { "type": "integer", "minimum": 0 }, { "type": "null" } ] } }, { "name": "offset", "in": "query", "required": false, "schema": { "anyOf": [ { "type": "integer", "minimum": 0 }, { "type": "null" } ] } }, { "name": "sort", "in": "query", "required": false, "schema": { "anyOf": [ { "$ref": "#/components/schemas/synckhub_core.types.ListItemsSort" }, { "type": "null" } ] } }, { "name": "order", "in": "query", "required": false, "schema": { "anyOf": [ { "$ref": "#/components/schemas/synckhub_core.types.ListItemsOrder" }, { "type": "null" } ] } }, { "name": "folders_first", "in": "query", "required": false, "schema": { "anyOf": [ { "type": "boolean" }, { "type": "null" } ] } }, { "name": "after_name", "in": "query", "required": false, "schema": { "anyOf": [ { "type": "string" }, { "type": "null" } ] } }, { "name": "after_item_id", "in": "query", "required": false, "schema": { "anyOf": [ { "type": "string" }, { "type": "null" } ] } }, { "name": "include", "in": "query", "required": false, "schema": { "anyOf": [ { "type": "string" }, { "type": "null" } ], "description": "Optional expansions (comma-separated), e.g. `include=breadcrumbs`." } } ], "description": "List items of a given type in a repository.\n\nAuthorization and validation are enforced by the owning service.\n\nHEAD uses the GET handler and headers without a response body.", "x-handler": "list_items_by_type", "x-source-file": "crates/synckhub-server/src/routes/items/read.rs", "x-source-line": 27, "x-implicit-head": true, "responses": { "default": { "description": "Platform error; branch on HTTP status and stable code, not the human-readable message." } } } }, "/repos/{repo_id}/items/create": { "post": { "operationId": "platform_post__repos__repo_id__items_create", "summary": "create item", "tags": [ "items · write" ], "parameters": [ { "name": "repo_id", "in": "path", "required": true, "schema": { "type": "string" } } ], "description": "Authorization and validation are enforced by the owning service.", "x-handler": "create_item", "x-source-file": "crates/synckhub-server/src/routes/items/write.rs", "x-source-line": 10, "responses": { "default": { "description": "Platform error; branch on HTTP status and stable code, not the human-readable message.", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } } }, "2XX": { "description": "Successful JSON response", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/synckhub_core.types.ItemSummary" } } } } }, "requestBody": { "required": true, "content": { "application/json": { "schema": { "$ref": "#/components/schemas/synckhub_server.routes.items.write.CreateItemRequest" } } } } } }, "/repos/{repo_id}/items/create-file": { "post": { "operationId": "platform_post__repos__repo_id__items_create_file", "summary": "create file", "tags": [ "items · write" ], "parameters": [ { "name": "repo_id", "in": "path", "required": true, "schema": { "type": "string" } } ], "description": "Authorization and validation are enforced by the owning service.", "x-handler": "create_file", "x-source-file": "crates/synckhub-server/src/routes/items/write.rs", "x-source-line": 10, "responses": { "default": { "description": "Platform error; branch on HTTP status and stable code, not the human-readable message.", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } } }, "2XX": { "description": "Successful JSON response", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/synckhub_core.types.ItemSummary" } } } } }, "requestBody": { "required": true, "content": { "application/json": { "schema": { "$ref": "#/components/schemas/synckhub_server.routes.items.write.CreateFileRequest" } } } } } }, "/repos/{repo_id}/items/default-parent": { "get": { "operationId": "platform_get__repos__repo_id__items_default_parent", "summary": "get default item parent", "tags": [ "items · read" ], "parameters": [ { "name": "repo_id", "in": "path", "required": true, "schema": { "type": "string" } }, { "name": "surface", "in": "query", "required": false, "schema": { "anyOf": [ { "type": "string" }, { "type": "null" } ] } }, { "name": "scope", "in": "query", "required": false, "schema": { "anyOf": [ { "type": "string" }, { "type": "null" } ] } }, { "name": "item_type", "in": "query", "required": false, "schema": { "anyOf": [ { "type": "string" }, { "type": "null" } ] } } ], "description": "Authorization and validation are enforced by the owning service.", "x-handler": "get_default_item_parent", "x-source-file": "crates/synckhub-server/src/routes/items/read.rs", "x-source-line": 27, "responses": { "default": { "description": "Platform error; branch on HTTP status and stable code, not the human-readable message.", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } } }, "2XX": { "description": "Successful JSON response", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/synckhub_server.routes.items.read.DefaultItemParentResponse" } } } } } }, "head": { "operationId": "platform_head__repos__repo_id__items_default_parent", "summary": "get default item parent", "tags": [ "items · read" ], "parameters": [ { "name": "repo_id", "in": "path", "required": true, "schema": { "type": "string" } }, { "name": "surface", "in": "query", "required": false, "schema": { "anyOf": [ { "type": "string" }, { "type": "null" } ] } }, { "name": "scope", "in": "query", "required": false, "schema": { "anyOf": [ { "type": "string" }, { "type": "null" } ] } }, { "name": "item_type", "in": "query", "required": false, "schema": { "anyOf": [ { "type": "string" }, { "type": "null" } ] } } ], "description": "Authorization and validation are enforced by the owning service.\n\nHEAD uses the GET handler and headers without a response body.", "x-handler": "get_default_item_parent", "x-source-file": "crates/synckhub-server/src/routes/items/read.rs", "x-source-line": 27, "x-implicit-head": true, "responses": { "default": { "description": "Platform error; branch on HTTP status and stable code, not the human-readable message." } } } }, "/repos/{repo_id}/items/download-url": { "post": { "operationId": "platform_post__repos__repo_id__items_download_url", "summary": "create selection download url", "tags": [ "files · content" ], "parameters": [ { "name": "repo_id", "in": "path", "required": true, "schema": { "type": "string" } } ], "description": "Authorization and validation are enforced by the owning service.", "x-handler": "create_selection_download_url", "x-source-file": "crates/synckhub-server/src/routes/files/content.rs", "x-source-line": 20, "responses": { "default": { "description": "Platform error; branch on HTTP status and stable code, not the human-readable message.", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } } }, "2XX": { "description": "Successful JSON response", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/synckhub_server.routes.files.content.CreateDownloadUrlResponse" } } } } }, "requestBody": { "required": true, "content": { "application/json": { "schema": { "$ref": "#/components/schemas/synckhub_server.routes.files.content.CreateSelectionDownloadUrlRequest" } } } } } }, "/repos/{repo_id}/items/duplicate": { "post": { "operationId": "platform_post__repos__repo_id__items_duplicate", "summary": "duplicate items", "tags": [ "items · copy" ], "parameters": [ { "name": "repo_id", "in": "path", "required": true, "schema": { "type": "string" } } ], "description": "Authorization and validation are enforced by the owning service.", "x-handler": "duplicate_items", "x-source-file": "crates/synckhub-server/src/routes/items/copy.rs", "x-source-line": 8, "responses": { "default": { "description": "Platform error; branch on HTTP status and stable code, not the human-readable message.", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } } }, "2XX": { "description": "Successful JSON response", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/synckhub_server.routes.items.copy.DuplicateItemsResponse" } } } } }, "requestBody": { "required": true, "content": { "application/json": { "schema": { "$ref": "#/components/schemas/synckhub_server.routes.items.copy.DuplicateItemsRequest" } } } } } }, "/repos/{repo_id}/items/folder-dashboard": { "get": { "operationId": "platform_get__repos__repo_id__items_folder_dashboard", "summary": "get folder dashboard", "tags": [ "items · read" ], "parameters": [ { "name": "repo_id", "in": "path", "required": true, "schema": { "type": "string" } }, { "name": "folder_id", "in": "query", "required": false, "schema": { "anyOf": [ { "type": "string" }, { "type": "null" } ], "description": "Folder item id. Use `\"\"` (empty) or omit for the root folder." } }, { "name": "scope", "in": "query", "required": true, "schema": { "$ref": "#/components/schemas/synckhub_server.routes.items.read.FolderDashboardScope" } }, { "name": "docs_limit", "in": "query", "required": false, "schema": { "anyOf": [ { "type": "integer", "minimum": 0 }, { "type": "null" } ] } }, { "name": "notes_limit", "in": "query", "required": false, "schema": { "anyOf": [ { "type": "integer", "minimum": 0 }, { "type": "null" } ] } }, { "name": "interactions_limit", "in": "query", "required": false, "schema": { "anyOf": [ { "type": "integer", "minimum": 0 }, { "type": "null" } ] } }, { "name": "chats_limit", "in": "query", "required": false, "schema": { "anyOf": [ { "type": "integer", "minimum": 0 }, { "type": "null" } ] } }, { "name": "messages_limit", "in": "query", "required": false, "schema": { "anyOf": [ { "type": "integer", "minimum": 0 }, { "type": "null" } ] } }, { "name": "events_limit", "in": "query", "required": false, "schema": { "anyOf": [ { "type": "integer", "minimum": 0 }, { "type": "null" } ] } }, { "name": "task_lists_limit", "in": "query", "required": false, "schema": { "anyOf": [ { "type": "integer", "minimum": 0 }, { "type": "null" } ] } }, { "name": "crm", "in": "query", "required": false, "schema": { "anyOf": [ { "type": "boolean" }, { "type": "null" } ] } } ], "description": "Authorization and validation are enforced by the owning service.", "x-handler": "get_folder_dashboard", "x-source-file": "crates/synckhub-server/src/routes/items/read.rs", "x-source-line": 27, "responses": { "default": { "description": "Platform error; branch on HTTP status and stable code, not the human-readable message.", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } } }, "2XX": { "description": "Successful JSON response", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/synckhub_server.routes.items.read.FolderDashboardResponse" } } } } } }, "head": { "operationId": "platform_head__repos__repo_id__items_folder_dashboard", "summary": "get folder dashboard", "tags": [ "items · read" ], "parameters": [ { "name": "repo_id", "in": "path", "required": true, "schema": { "type": "string" } }, { "name": "folder_id", "in": "query", "required": false, "schema": { "anyOf": [ { "type": "string" }, { "type": "null" } ], "description": "Folder item id. Use `\"\"` (empty) or omit for the root folder." } }, { "name": "scope", "in": "query", "required": true, "schema": { "$ref": "#/components/schemas/synckhub_server.routes.items.read.FolderDashboardScope" } }, { "name": "docs_limit", "in": "query", "required": false, "schema": { "anyOf": [ { "type": "integer", "minimum": 0 }, { "type": "null" } ] } }, { "name": "notes_limit", "in": "query", "required": false, "schema": { "anyOf": [ { "type": "integer", "minimum": 0 }, { "type": "null" } ] } }, { "name": "interactions_limit", "in": "query", "required": false, "schema": { "anyOf": [ { "type": "integer", "minimum": 0 }, { "type": "null" } ] } }, { "name": "chats_limit", "in": "query", "required": false, "schema": { "anyOf": [ { "type": "integer", "minimum": 0 }, { "type": "null" } ] } }, { "name": "messages_limit", "in": "query", "required": false, "schema": { "anyOf": [ { "type": "integer", "minimum": 0 }, { "type": "null" } ] } }, { "name": "events_limit", "in": "query", "required": false, "schema": { "anyOf": [ { "type": "integer", "minimum": 0 }, { "type": "null" } ] } }, { "name": "task_lists_limit", "in": "query", "required": false, "schema": { "anyOf": [ { "type": "integer", "minimum": 0 }, { "type": "null" } ] } }, { "name": "crm", "in": "query", "required": false, "schema": { "anyOf": [ { "type": "boolean" }, { "type": "null" } ] } } ], "description": "Authorization and validation are enforced by the owning service.\n\nHEAD uses the GET handler and headers without a response body.", "x-handler": "get_folder_dashboard", "x-source-file": "crates/synckhub-server/src/routes/items/read.rs", "x-source-line": 27, "x-implicit-head": true, "responses": { "default": { "description": "Platform error; branch on HTTP status and stable code, not the human-readable message." } } } }, "/repos/{repo_id}/items/folder-stats": { "get": { "operationId": "platform_get__repos__repo_id__items_folder_stats", "summary": "get folder stats", "tags": [ "items · read" ], "parameters": [ { "name": "repo_id", "in": "path", "required": true, "schema": { "type": "string" } }, { "name": "folder_id", "in": "query", "required": false, "schema": { "anyOf": [ { "type": "string" }, { "type": "null" } ], "description": "Folder item id. Use `\"\"` (empty) or omit for the root folder." } } ], "description": "Authorization and validation are enforced by the owning service.", "x-handler": "get_folder_stats", "x-source-file": "crates/synckhub-server/src/routes/items/read.rs", "x-source-line": 27, "responses": { "default": { "description": "Platform error; branch on HTTP status and stable code, not the human-readable message.", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } } }, "2XX": { "description": "Successful JSON response", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/synckhub_server.routes.items.read.FolderStatsResponse" } } } } } }, "head": { "operationId": "platform_head__repos__repo_id__items_folder_stats", "summary": "get folder stats", "tags": [ "items · read" ], "parameters": [ { "name": "repo_id", "in": "path", "required": true, "schema": { "type": "string" } }, { "name": "folder_id", "in": "query", "required": false, "schema": { "anyOf": [ { "type": "string" }, { "type": "null" } ], "description": "Folder item id. Use `\"\"` (empty) or omit for the root folder." } } ], "description": "Authorization and validation are enforced by the owning service.\n\nHEAD uses the GET handler and headers without a response body.", "x-handler": "get_folder_stats", "x-source-file": "crates/synckhub-server/src/routes/items/read.rs", "x-source-line": 27, "x-implicit-head": true, "responses": { "default": { "description": "Platform error; branch on HTTP status and stable code, not the human-readable message." } } } }, "/repos/{repo_id}/items/list": { "post": { "operationId": "platform_post__repos__repo_id__items_list", "summary": "list items post", "tags": [ "items · search" ], "parameters": [ { "name": "repo_id", "in": "path", "required": true, "schema": { "type": "string" } } ], "description": "POST alias for listing items with JSON body filters.\n\nSemantics are identical to `GET /repos/{repo_id}/items`; the body mirrors\nthe query parameters handled by `ListItemsQueryParams`. This exists primarily as a\nfixed-URL, body-driven endpoint so frontends can reuse CORS preflight\ncaches while varying filters.\n\nAuthorization and validation are enforced by the owning service.", "x-handler": "list_items_post", "x-source-file": "crates/synckhub-server/src/routes/items/search.rs", "x-source-line": 12, "responses": { "default": { "description": "Platform error; branch on HTTP status and stable code, not the human-readable message.", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } } }, "2XX": { "description": "Successful JSON response", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/synckhub_server.routes.ListItemsResponse" } } } } }, "requestBody": { "required": true, "content": { "application/json": { "schema": { "$ref": "#/components/schemas/synckhub_server.routes.items.read.ListItemsQuery" } } } } } }, "/repos/{repo_id}/items/locks/exclusive": { "get": { "operationId": "platform_get__repos__repo_id__items_locks_exclusive", "summary": "list exclusive locks", "tags": [ "files · drafts" ], "parameters": [ { "name": "repo_id", "in": "path", "required": true, "schema": { "type": "string" } }, { "name": "owner_id", "in": "query", "required": false, "schema": { "anyOf": [ { "type": "string" }, { "type": "null" } ] } } ], "description": "Authorization and validation are enforced by the owning service.", "x-handler": "list_exclusive_locks", "x-source-file": "crates/synckhub-server/src/routes/files/drafts.rs", "x-source-line": 11, "responses": { "default": { "description": "Platform error; branch on HTTP status and stable code, not the human-readable message.", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } } }, "2XX": { "description": "Successful JSON response", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/synckhub_server.routes.files.drafts.ListExclusiveLocksResponse" } } } } } }, "head": { "operationId": "platform_head__repos__repo_id__items_locks_exclusive", "summary": "list exclusive locks", "tags": [ "files · drafts" ], "parameters": [ { "name": "repo_id", "in": "path", "required": true, "schema": { "type": "string" } }, { "name": "owner_id", "in": "query", "required": false, "schema": { "anyOf": [ { "type": "string" }, { "type": "null" } ] } } ], "description": "Authorization and validation are enforced by the owning service.\n\nHEAD uses the GET handler and headers without a response body.", "x-handler": "list_exclusive_locks", "x-source-file": "crates/synckhub-server/src/routes/files/drafts.rs", "x-source-line": 11, "x-implicit-head": true, "responses": { "default": { "description": "Platform error; branch on HTTP status and stable code, not the human-readable message." } } } }, "/repos/{repo_id}/items/locks/exclusive/bulk-acquire": { "post": { "operationId": "platform_post__repos__repo_id__items_locks_exclusive_bulk_acquire", "summary": "bulk acquire exclusive locks", "tags": [ "files · drafts" ], "parameters": [ { "name": "repo_id", "in": "path", "required": true, "schema": { "type": "string" } } ], "description": "Authorization and validation are enforced by the owning service.", "x-handler": "bulk_acquire_exclusive_locks", "x-source-file": "crates/synckhub-server/src/routes/files/drafts.rs", "x-source-line": 11, "responses": { "default": { "description": "Platform error; branch on HTTP status and stable code, not the human-readable message.", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } } }, "2XX": { "description": "Successful JSON response", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/synckhub_server.routes.files.drafts.BulkAcquireExclusiveLocksResponse" } } } } }, "requestBody": { "required": true, "content": { "application/json": { "schema": { "$ref": "#/components/schemas/synckhub_server.routes.files.drafts.BulkAcquireExclusiveLocksRequest" } } } } } }, "/repos/{repo_id}/items/locks/exclusive/bulk-release": { "post": { "operationId": "platform_post__repos__repo_id__items_locks_exclusive_bulk_release", "summary": "bulk release exclusive locks", "tags": [ "files · drafts" ], "parameters": [ { "name": "repo_id", "in": "path", "required": true, "schema": { "type": "string" } } ], "description": "Authorization and validation are enforced by the owning service.", "x-handler": "bulk_release_exclusive_locks", "x-source-file": "crates/synckhub-server/src/routes/files/drafts.rs", "x-source-line": 11, "responses": { "default": { "description": "Platform error; branch on HTTP status and stable code, not the human-readable message.", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } } }, "2XX": { "description": "Successful JSON response", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/synckhub_server.routes.files.drafts.BulkReleaseExclusiveLocksResponse" } } } } }, "requestBody": { "required": true, "content": { "application/json": { "schema": { "$ref": "#/components/schemas/synckhub_server.routes.files.drafts.BulkReleaseExclusiveLocksRequest" } } } } } }, "/repos/{repo_id}/items/metadata": { "post": { "operationId": "platform_post__repos__repo_id__items_metadata", "summary": "get items metadata", "tags": [ "items · search" ], "parameters": [ { "name": "repo_id", "in": "path", "required": true, "schema": { "type": "string" } } ], "description": "Authorization and validation are enforced by the owning service.", "x-handler": "get_items_metadata", "x-source-file": "crates/synckhub-server/src/routes/items/search.rs", "x-source-line": 12, "responses": { "default": { "description": "Platform error; branch on HTTP status and stable code, not the human-readable message.", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } } }, "2XX": { "description": "Successful JSON response", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/synckhub_core.types.BatchItemMetadataResponse" } } } } }, "requestBody": { "required": true, "content": { "application/json": { "schema": { "$ref": "#/components/schemas/synckhub_server.routes.items.search.BatchItemMetadataRequest" } } } } } }, "/repos/{repo_id}/items/navigation-roots": { "get": { "operationId": "platform_get__repos__repo_id__items_navigation_roots", "summary": "list navigation roots", "tags": [ "items · read" ], "parameters": [ { "name": "repo_id", "in": "path", "required": true, "schema": { "type": "string" } }, { "name": "limit", "in": "query", "required": false, "schema": { "anyOf": [ { "type": "integer", "minimum": 0 }, { "type": "null" } ] } }, { "name": "offset", "in": "query", "required": false, "schema": { "anyOf": [ { "type": "integer", "minimum": 0 }, { "type": "null" } ] } }, { "name": "include", "in": "query", "required": false, "schema": { "anyOf": [ { "type": "string" }, { "type": "null" } ] } } ], "description": "Authorization and validation are enforced by the owning service.", "x-handler": "list_navigation_roots", "x-source-file": "crates/synckhub-server/src/routes/items/read.rs", "x-source-line": 27, "responses": { "default": { "description": "Platform error; branch on HTTP status and stable code, not the human-readable message.", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } } }, "2XX": { "description": "Successful JSON response", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/synckhub_server.routes.ListItemsResponse" } } } } } }, "head": { "operationId": "platform_head__repos__repo_id__items_navigation_roots", "summary": "list navigation roots", "tags": [ "items · read" ], "parameters": [ { "name": "repo_id", "in": "path", "required": true, "schema": { "type": "string" } }, { "name": "limit", "in": "query", "required": false, "schema": { "anyOf": [ { "type": "integer", "minimum": 0 }, { "type": "null" } ] } }, { "name": "offset", "in": "query", "required": false, "schema": { "anyOf": [ { "type": "integer", "minimum": 0 }, { "type": "null" } ] } }, { "name": "include", "in": "query", "required": false, "schema": { "anyOf": [ { "type": "string" }, { "type": "null" } ] } } ], "description": "Authorization and validation are enforced by the owning service.\n\nHEAD uses the GET handler and headers without a response body.", "x-handler": "list_navigation_roots", "x-source-file": "crates/synckhub-server/src/routes/items/read.rs", "x-source-line": 27, "x-implicit-head": true, "responses": { "default": { "description": "Platform error; branch on HTTP status and stable code, not the human-readable message." } } } }, "/repos/{repo_id}/items/recents": { "get": { "operationId": "platform_get__repos__repo_id__items_recents", "summary": "list recent files", "tags": [ "items · read" ], "parameters": [ { "name": "repo_id", "in": "path", "required": true, "schema": { "type": "string" } }, { "name": "limit", "in": "query", "required": false, "schema": { "anyOf": [ { "type": "integer", "minimum": 0 }, { "type": "null" } ] } }, { "name": "offset", "in": "query", "required": false, "schema": { "anyOf": [ { "type": "integer", "minimum": 0 }, { "type": "null" } ] } }, { "name": "file_extension", "in": "query", "required": false, "schema": { "anyOf": [ { "type": "string" }, { "type": "null" } ], "description": "Optional comma-separated FILE-only extension filters, e.g. `file_extension=md,markdown`." } }, { "name": "file_extension_exclude", "in": "query", "required": false, "schema": { "anyOf": [ { "type": "string" }, { "type": "null" } ], "description": "Optional comma-separated FILE extension exclusions." } }, { "name": "include", "in": "query", "required": false, "schema": { "anyOf": [ { "type": "string" }, { "type": "null" } ], "description": "Optional expansions (comma-separated), e.g. `include=breadcrumbs`." } } ], "description": "Authorization and validation are enforced by the owning service.", "x-handler": "list_recent_files", "x-source-file": "crates/synckhub-server/src/routes/items/read.rs", "x-source-line": 27, "responses": { "default": { "description": "Platform error; branch on HTTP status and stable code, not the human-readable message.", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } } }, "2XX": { "description": "Successful JSON response", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/synckhub_server.routes.ListRecentFilesResponse" } } } } } }, "head": { "operationId": "platform_head__repos__repo_id__items_recents", "summary": "list recent files", "tags": [ "items · read" ], "parameters": [ { "name": "repo_id", "in": "path", "required": true, "schema": { "type": "string" } }, { "name": "limit", "in": "query", "required": false, "schema": { "anyOf": [ { "type": "integer", "minimum": 0 }, { "type": "null" } ] } }, { "name": "offset", "in": "query", "required": false, "schema": { "anyOf": [ { "type": "integer", "minimum": 0 }, { "type": "null" } ] } }, { "name": "file_extension", "in": "query", "required": false, "schema": { "anyOf": [ { "type": "string" }, { "type": "null" } ], "description": "Optional comma-separated FILE-only extension filters, e.g. `file_extension=md,markdown`." } }, { "name": "file_extension_exclude", "in": "query", "required": false, "schema": { "anyOf": [ { "type": "string" }, { "type": "null" } ], "description": "Optional comma-separated FILE extension exclusions." } }, { "name": "include", "in": "query", "required": false, "schema": { "anyOf": [ { "type": "string" }, { "type": "null" } ], "description": "Optional expansions (comma-separated), e.g. `include=breadcrumbs`." } } ], "description": "Authorization and validation are enforced by the owning service.\n\nHEAD uses the GET handler and headers without a response body.", "x-handler": "list_recent_files", "x-source-file": "crates/synckhub-server/src/routes/items/read.rs", "x-source-line": 27, "x-implicit-head": true, "responses": { "default": { "description": "Platform error; branch on HTTP status and stable code, not the human-readable message." } } } }, "/repos/{repo_id}/items/recents-folders": { "get": { "operationId": "platform_get__repos__repo_id__items_recents_folders", "summary": "list recent folders", "tags": [ "items · read" ], "parameters": [ { "name": "repo_id", "in": "path", "required": true, "schema": { "type": "string" } }, { "name": "limit", "in": "query", "required": false, "schema": { "anyOf": [ { "type": "integer", "minimum": 0 }, { "type": "null" } ] } }, { "name": "offset", "in": "query", "required": false, "schema": { "anyOf": [ { "type": "integer", "minimum": 0 }, { "type": "null" } ] } }, { "name": "include", "in": "query", "required": false, "schema": { "anyOf": [ { "type": "string" }, { "type": "null" } ], "description": "Optional expansions (comma-separated), e.g. `include=breadcrumbs`." } } ], "description": "Authorization and validation are enforced by the owning service.", "x-handler": "list_recent_folders", "x-source-file": "crates/synckhub-server/src/routes/items/read.rs", "x-source-line": 27, "responses": { "default": { "description": "Platform error; branch on HTTP status and stable code, not the human-readable message.", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } } }, "2XX": { "description": "Successful JSON response", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/synckhub_server.routes.ListRecentFoldersResponse" } } } } } }, "head": { "operationId": "platform_head__repos__repo_id__items_recents_folders", "summary": "list recent folders", "tags": [ "items · read" ], "parameters": [ { "name": "repo_id", "in": "path", "required": true, "schema": { "type": "string" } }, { "name": "limit", "in": "query", "required": false, "schema": { "anyOf": [ { "type": "integer", "minimum": 0 }, { "type": "null" } ] } }, { "name": "offset", "in": "query", "required": false, "schema": { "anyOf": [ { "type": "integer", "minimum": 0 }, { "type": "null" } ] } }, { "name": "include", "in": "query", "required": false, "schema": { "anyOf": [ { "type": "string" }, { "type": "null" } ], "description": "Optional expansions (comma-separated), e.g. `include=breadcrumbs`." } } ], "description": "Authorization and validation are enforced by the owning service.\n\nHEAD uses the GET handler and headers without a response body.", "x-handler": "list_recent_folders", "x-source-file": "crates/synckhub-server/src/routes/items/read.rs", "x-source-line": 27, "x-implicit-head": true, "responses": { "default": { "description": "Platform error; branch on HTTP status and stable code, not the human-readable message." } } } }, "/repos/{repo_id}/items/reveal-folder-path": { "post": { "operationId": "platform_post__repos__repo_id__items_reveal_folder_path", "summary": "reveal folder path", "tags": [ "items · search" ], "parameters": [ { "name": "repo_id", "in": "path", "required": true, "schema": { "type": "string" } } ], "description": "Authorization and validation are enforced by the owning service.", "x-handler": "reveal_folder_path", "x-source-file": "crates/synckhub-server/src/routes/items/search.rs", "x-source-line": 12, "responses": { "default": { "description": "Platform error; branch on HTTP status and stable code, not the human-readable message.", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } } }, "2XX": { "description": "Successful JSON response", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/synckhub_server.routes.items.read.RevealFolderPathResponse" } } } } }, "requestBody": { "required": true, "content": { "application/json": { "schema": { "$ref": "#/components/schemas/synckhub_server.routes.items.read.RevealFolderPathRequest" } } } } } }, "/repos/{repo_id}/items/search": { "post": { "operationId": "platform_post__repos__repo_id__items_search", "summary": "search items structured", "tags": [ "items · search" ], "parameters": [ { "name": "repo_id", "in": "path", "required": true, "schema": { "type": "string" } } ], "description": "Authorization and validation are enforced by the owning service.", "x-handler": "search_items_structured", "x-source-file": "crates/synckhub-server/src/routes/items/search.rs", "x-source-line": 12, "responses": { "default": { "description": "Platform error; branch on HTTP status and stable code, not the human-readable message.", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } } }, "2XX": { "description": "Successful JSON response", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/synckhub_server.routes.ListItemsResponse" } } } } }, "requestBody": { "required": true, "content": { "application/json": { "schema": { "$ref": "#/components/schemas/synckhub_server.routes.items.search.SearchItemsStructuredRequest" } } } } }, "get": { "operationId": "platform_get__repos__repo_id__items_search", "summary": "Search and filter repository items", "tags": [ "items · search" ], "parameters": [ { "$ref": "#/components/parameters/RepoId" }, { "name": "q", "in": "query", "schema": { "type": "string" }, "description": "Item-name query, not file-body full-text search.", "example": "report" }, { "name": "case_status", "in": "query", "required": false, "schema": { "anyOf": [ { "type": "string" }, { "type": "null" } ], "description": "Optional comma-separated canonical case statuses (`open` or `closed`)." } }, { "name": "parent_folder_id", "in": "query", "schema": { "type": "string" }, "example": "33333333-3333-4333-8333-333333333333" }, { "name": "recursive", "in": "query", "schema": { "type": "boolean", "default": false } }, { "name": "include", "in": "query", "required": false, "schema": { "anyOf": [ { "type": "string" }, { "type": "null" } ], "description": "Optional expansions (comma-separated), e.g. `include=breadcrumbs`." } }, { "name": "item_type", "in": "query", "schema": { "type": "string" }, "description": "Item-type filter. Explicit selection includes types otherwise hidden from inventory: DATABASE, TABLE, and FILE_VERSION_SET. Select one type.", "example": "FILE" }, { "name": "file_extension", "in": "query", "description": "Comma-separated lowercase file extensions.", "schema": { "type": "string" } }, { "name": "file_extension_exclude", "in": "query", "required": false, "schema": { "anyOf": [ { "type": "string" }, { "type": "null" } ] } }, { "name": "file_extension_missing", "in": "query", "required": false, "schema": { "anyOf": [ { "type": "boolean" }, { "type": "null" } ] } }, { "name": "updated_by", "in": "query", "description": "Comma-separated actor IDs.", "schema": { "type": "string" } }, { "name": "updated_at", "in": "query", "required": false, "schema": { "anyOf": [ { "type": "string" }, { "type": "null" } ], "description": "Legacy single-point/single-day filter." } }, { "name": "updated_at_from", "in": "query", "schema": { "type": "string", "format": "date-time" }, "example": "2026-10-01T00:00:00Z" }, { "name": "updated_at_to", "in": "query", "schema": { "type": "string", "format": "date-time" }, "example": "2026-10-08T23:59:59Z" }, { "name": "in_trash", "in": "query", "required": false, "schema": { "anyOf": [ { "type": "boolean" }, { "type": "null" } ] } }, { "name": "tombstoned", "in": "query", "required": false, "schema": { "anyOf": [ { "type": "boolean" }, { "type": "null" } ] } }, { "name": "limit", "in": "query", "description": "Page size. Values above 200 are capped at 200.", "schema": { "type": "integer", "minimum": 1, "default": 50, "maximum": 200 }, "example": 200 }, { "$ref": "#/components/parameters/Offset" }, { "name": "sort", "in": "query", "schema": { "type": "string", "enum": [ "name", "date", "modified", "size", "extension", "location" ] } }, { "name": "order", "in": "query", "schema": { "type": "string", "enum": [ "asc", "desc" ] } } ], "description": "The q parameter searches item names and is optional; omit it for a filtered inventory. Set parent_folder_id and recursive=true for a folder subtree. Without item_type, DATABASE, TABLE, and FILE_VERSION_SET are excluded. Search uses offset paging, not next_cursor: inspect page.has_next and advance offset by page.returned. Pages are read independently, not as an atomic snapshot. sort=location requires recursive=true.", "x-handler": "search_items", "x-source-file": "crates/synckhub-server/src/routes/items/search.rs", "x-source-line": 12, "responses": { "200": { "description": "Final offset-paged search result", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/ItemList" }, "example": { "items": [ { "repo_id": "11111111-1111-4111-8111-111111111111", "item_id": "22222222-2222-4222-8222-222222222222", "item_type": "FILE", "item_subtype": "STANDARD", "name": "report.pdf", "file_extension": "pdf", "parent_folder_id": "33333333-3333-4333-8333-333333333333", "path": "33333333-3333-4333-8333-333333333333.22222222-2222-4222-8222-222222222222", "lifecycle_state": "LIVE", "size": 2048, "head_revision_item_seq": 7, "last_updated_at": "2026-10-08T10:00:00Z", "last_updated_by": "service:api-token:44444444-4444-4444-8444-444444444444", "locks": [] } ], "page": { "limit": 50, "offset": 0, "returned": 1, "has_prev": false, "has_next": false, "total_items": 1 } } } } }, "400": { "$ref": "#/components/responses/Error" }, "401": { "$ref": "#/components/responses/Error" }, "403": { "$ref": "#/components/responses/Error" } } }, "head": { "operationId": "platform_head__repos__repo_id__items_search", "summary": "search items", "tags": [ "items · search" ], "parameters": [ { "name": "repo_id", "in": "path", "required": true, "schema": { "type": "string" } }, { "name": "q", "in": "query", "required": false, "schema": { "anyOf": [ { "type": "string" }, { "type": "null" } ] } }, { "name": "case_status", "in": "query", "required": false, "schema": { "anyOf": [ { "type": "string" }, { "type": "null" } ], "description": "Optional comma-separated canonical case statuses (`open` or `closed`)." } }, { "name": "parent_folder_id", "in": "query", "required": false, "schema": { "anyOf": [ { "type": "string" }, { "type": "null" } ] } }, { "name": "recursive", "in": "query", "required": false, "schema": { "anyOf": [ { "type": "boolean" }, { "type": "null" } ] } }, { "name": "include", "in": "query", "required": false, "schema": { "anyOf": [ { "type": "string" }, { "type": "null" } ], "description": "Optional expansions (comma-separated), e.g. `include=breadcrumbs`." } }, { "name": "item_type", "in": "query", "required": false, "schema": { "anyOf": [ { "type": "string" }, { "type": "null" } ] } }, { "name": "file_extension", "in": "query", "required": false, "schema": { "anyOf": [ { "type": "string" }, { "type": "null" } ] } }, { "name": "file_extension_exclude", "in": "query", "required": false, "schema": { "anyOf": [ { "type": "string" }, { "type": "null" } ] } }, { "name": "file_extension_missing", "in": "query", "required": false, "schema": { "anyOf": [ { "type": "boolean" }, { "type": "null" } ] } }, { "name": "updated_by", "in": "query", "required": false, "schema": { "anyOf": [ { "type": "string" }, { "type": "null" } ], "description": "Optional updated-by filter (comma-separated actor ids)." } }, { "name": "updated_at", "in": "query", "required": false, "schema": { "anyOf": [ { "type": "string" }, { "type": "null" } ], "description": "Legacy single-point/single-day filter." } }, { "name": "updated_at_from", "in": "query", "required": false, "schema": { "anyOf": [ { "type": "string" }, { "type": "null" } ] } }, { "name": "updated_at_to", "in": "query", "required": false, "schema": { "anyOf": [ { "type": "string" }, { "type": "null" } ] } }, { "name": "in_trash", "in": "query", "required": false, "schema": { "anyOf": [ { "type": "boolean" }, { "type": "null" } ] } }, { "name": "tombstoned", "in": "query", "required": false, "schema": { "anyOf": [ { "type": "boolean" }, { "type": "null" } ] } }, { "name": "limit", "in": "query", "required": false, "schema": { "anyOf": [ { "type": "integer", "minimum": 0 }, { "type": "null" } ] } }, { "name": "offset", "in": "query", "required": false, "schema": { "anyOf": [ { "type": "integer", "minimum": 0 }, { "type": "null" } ] } }, { "name": "sort", "in": "query", "required": false, "schema": { "anyOf": [ { "$ref": "#/components/schemas/synckhub_server.routes.items.search.SearchItemsSort" }, { "type": "null" } ] } }, { "name": "order", "in": "query", "required": false, "schema": { "anyOf": [ { "$ref": "#/components/schemas/synckhub_core.types.ListItemsOrder" }, { "type": "null" } ] } } ], "description": "Authorization and validation are enforced by the owning service.\n\nHEAD uses the GET handler and headers without a response body.", "x-handler": "search_items", "x-source-file": "crates/synckhub-server/src/routes/items/search.rs", "x-source-line": 12, "x-implicit-head": true, "responses": { "default": { "description": "Platform error; branch on HTTP status and stable code, not the human-readable message." } } } }, "/repos/{repo_id}/items/search_fulltext": { "get": { "operationId": "platform_get__repos__repo_id__items_search_fulltext", "summary": "search items fulltext", "tags": [ "items · search" ], "parameters": [ { "name": "repo_id", "in": "path", "required": true, "schema": { "type": "string" } }, { "name": "q", "in": "query", "required": true, "schema": { "type": "string" } }, { "name": "name_q", "in": "query", "required": false, "schema": { "anyOf": [ { "type": "string" }, { "type": "null" } ] } }, { "name": "include", "in": "query", "required": false, "schema": { "anyOf": [ { "type": "string" }, { "type": "null" } ], "description": "Optional expansions (comma-separated), e.g. `include=breadcrumbs`." } }, { "name": "parent_folder_id", "in": "query", "required": false, "schema": { "anyOf": [ { "type": "string" }, { "type": "null" } ] } }, { "name": "item_id", "in": "query", "required": false, "schema": { "anyOf": [ { "type": "string" }, { "type": "null" } ] } }, { "name": "recursive", "in": "query", "required": false, "schema": { "anyOf": [ { "type": "boolean" }, { "type": "null" } ] } }, { "name": "item_type", "in": "query", "required": false, "schema": { "anyOf": [ { "type": "string" }, { "type": "null" } ] } }, { "name": "file_extension", "in": "query", "required": false, "schema": { "anyOf": [ { "type": "string" }, { "type": "null" } ] } }, { "name": "content_source", "in": "query", "required": false, "schema": { "anyOf": [ { "type": "string" }, { "type": "null" } ] } }, { "name": "updated_by", "in": "query", "required": false, "schema": { "anyOf": [ { "type": "string" }, { "type": "null" } ], "description": "Optional updated-by filter (comma-separated actor ids)." } }, { "name": "updated_at", "in": "query", "required": false, "schema": { "anyOf": [ { "type": "string" }, { "type": "null" } ], "description": "Legacy single-point/single-day filter." } }, { "name": "updated_at_from", "in": "query", "required": false, "schema": { "anyOf": [ { "type": "string" }, { "type": "null" } ] } }, { "name": "updated_at_to", "in": "query", "required": false, "schema": { "anyOf": [ { "type": "string" }, { "type": "null" } ] } }, { "name": "in_trash", "in": "query", "required": false, "schema": { "anyOf": [ { "type": "boolean" }, { "type": "null" } ] } }, { "name": "tombstoned", "in": "query", "required": false, "schema": { "anyOf": [ { "type": "boolean" }, { "type": "null" } ] } }, { "name": "limit", "in": "query", "required": false, "schema": { "anyOf": [ { "type": "integer", "minimum": 0 }, { "type": "null" } ] } }, { "name": "offset", "in": "query", "required": false, "schema": { "anyOf": [ { "type": "integer", "minimum": 0 }, { "type": "null" } ] } }, { "name": "include_formatted", "in": "query", "required": false, "schema": { "anyOf": [ { "type": "boolean" }, { "type": "null" } ] } }, { "name": "include_match_positions", "in": "query", "required": false, "schema": { "anyOf": [ { "type": "boolean" }, { "type": "null" } ] } }, { "name": "mode", "in": "query", "required": false, "schema": { "anyOf": [ { "type": "string" }, { "type": "null" } ] } }, { "name": "hits_per_item", "in": "query", "required": false, "schema": { "anyOf": [ { "type": "integer", "minimum": 0 }, { "type": "null" } ] } }, { "name": "include_hit_counts", "in": "query", "required": false, "schema": { "anyOf": [ { "type": "boolean" }, { "type": "null" } ] } } ], "description": "Authorization and validation are enforced by the owning service.", "x-handler": "search_items_fulltext", "x-source-file": "crates/synckhub-server/src/routes/items/search.rs", "x-source-line": 12, "responses": { "default": { "description": "Platform error; branch on HTTP status and stable code, not the human-readable message.", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } } }, "2XX": { "description": "Successful JSON response", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/synckhub_server.routes.ListItemsResponse" } } } } } }, "head": { "operationId": "platform_head__repos__repo_id__items_search_fulltext", "summary": "search items fulltext", "tags": [ "items · search" ], "parameters": [ { "name": "repo_id", "in": "path", "required": true, "schema": { "type": "string" } }, { "name": "q", "in": "query", "required": true, "schema": { "type": "string" } }, { "name": "name_q", "in": "query", "required": false, "schema": { "anyOf": [ { "type": "string" }, { "type": "null" } ] } }, { "name": "include", "in": "query", "required": false, "schema": { "anyOf": [ { "type": "string" }, { "type": "null" } ], "description": "Optional expansions (comma-separated), e.g. `include=breadcrumbs`." } }, { "name": "parent_folder_id", "in": "query", "required": false, "schema": { "anyOf": [ { "type": "string" }, { "type": "null" } ] } }, { "name": "item_id", "in": "query", "required": false, "schema": { "anyOf": [ { "type": "string" }, { "type": "null" } ] } }, { "name": "recursive", "in": "query", "required": false, "schema": { "anyOf": [ { "type": "boolean" }, { "type": "null" } ] } }, { "name": "item_type", "in": "query", "required": false, "schema": { "anyOf": [ { "type": "string" }, { "type": "null" } ] } }, { "name": "file_extension", "in": "query", "required": false, "schema": { "anyOf": [ { "type": "string" }, { "type": "null" } ] } }, { "name": "content_source", "in": "query", "required": false, "schema": { "anyOf": [ { "type": "string" }, { "type": "null" } ] } }, { "name": "updated_by", "in": "query", "required": false, "schema": { "anyOf": [ { "type": "string" }, { "type": "null" } ], "description": "Optional updated-by filter (comma-separated actor ids)." } }, { "name": "updated_at", "in": "query", "required": false, "schema": { "anyOf": [ { "type": "string" }, { "type": "null" } ], "description": "Legacy single-point/single-day filter." } }, { "name": "updated_at_from", "in": "query", "required": false, "schema": { "anyOf": [ { "type": "string" }, { "type": "null" } ] } }, { "name": "updated_at_to", "in": "query", "required": false, "schema": { "anyOf": [ { "type": "string" }, { "type": "null" } ] } }, { "name": "in_trash", "in": "query", "required": false, "schema": { "anyOf": [ { "type": "boolean" }, { "type": "null" } ] } }, { "name": "tombstoned", "in": "query", "required": false, "schema": { "anyOf": [ { "type": "boolean" }, { "type": "null" } ] } }, { "name": "limit", "in": "query", "required": false, "schema": { "anyOf": [ { "type": "integer", "minimum": 0 }, { "type": "null" } ] } }, { "name": "offset", "in": "query", "required": false, "schema": { "anyOf": [ { "type": "integer", "minimum": 0 }, { "type": "null" } ] } }, { "name": "include_formatted", "in": "query", "required": false, "schema": { "anyOf": [ { "type": "boolean" }, { "type": "null" } ] } }, { "name": "include_match_positions", "in": "query", "required": false, "schema": { "anyOf": [ { "type": "boolean" }, { "type": "null" } ] } }, { "name": "mode", "in": "query", "required": false, "schema": { "anyOf": [ { "type": "string" }, { "type": "null" } ] } }, { "name": "hits_per_item", "in": "query", "required": false, "schema": { "anyOf": [ { "type": "integer", "minimum": 0 }, { "type": "null" } ] } }, { "name": "include_hit_counts", "in": "query", "required": false, "schema": { "anyOf": [ { "type": "boolean" }, { "type": "null" } ] } } ], "description": "Authorization and validation are enforced by the owning service.\n\nHEAD uses the GET handler and headers without a response body.", "x-handler": "search_items_fulltext", "x-source-file": "crates/synckhub-server/src/routes/items/search.rs", "x-source-line": 12, "x-implicit-head": true, "responses": { "default": { "description": "Platform error; branch on HTTP status and stable code, not the human-readable message." } } } }, "/repos/{repo_id}/items/search_profile": { "post": { "operationId": "platform_post__repos__repo_id__items_search_profile", "summary": "search items profile", "tags": [ "items · search" ], "parameters": [ { "name": "repo_id", "in": "path", "required": true, "schema": { "type": "string" } } ], "description": "Authorization and validation are enforced by the owning service.", "x-handler": "search_items_profile", "x-source-file": "crates/synckhub-server/src/routes/items/search.rs", "x-source-line": 12, "responses": { "default": { "description": "Platform error; branch on HTTP status and stable code, not the human-readable message.", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } } }, "2XX": { "description": "Successful JSON response", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/synckhub_server.routes.ListItemsResponse" } } } } }, "requestBody": { "required": true, "content": { "application/json": { "schema": { "$ref": "#/components/schemas/synckhub_server.routes.items.search.SearchItemsProfileRequest" } } } } } }, "/repos/{repo_id}/items/shared-direct-files": { "get": { "operationId": "platform_get__repos__repo_id__items_shared_direct_files", "summary": "list shared direct files", "tags": [ "items · read" ], "parameters": [ { "name": "repo_id", "in": "path", "required": true, "schema": { "type": "string" } }, { "name": "limit", "in": "query", "required": false, "schema": { "anyOf": [ { "type": "integer", "minimum": 0 }, { "type": "null" } ] } }, { "name": "offset", "in": "query", "required": false, "schema": { "anyOf": [ { "type": "integer", "minimum": 0 }, { "type": "null" } ] } }, { "name": "name_q", "in": "query", "required": false, "schema": { "anyOf": [ { "type": "string" }, { "type": "null" } ], "description": "Optional case-insensitive literal substring match on the file name." } }, { "name": "include", "in": "query", "required": false, "schema": { "anyOf": [ { "type": "string" }, { "type": "null" } ], "description": "Optional expansions (comma-separated), e.g. `include=breadcrumbs`." } } ], "description": "Authorization and validation are enforced by the owning service.", "x-handler": "list_shared_direct_files", "x-source-file": "crates/synckhub-server/src/routes/items/read.rs", "x-source-line": 27, "responses": { "default": { "description": "Platform error; branch on HTTP status and stable code, not the human-readable message.", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } } }, "2XX": { "description": "Successful JSON response", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/synckhub_server.routes.ListItemsResponse" } } } } } }, "head": { "operationId": "platform_head__repos__repo_id__items_shared_direct_files", "summary": "list shared direct files", "tags": [ "items · read" ], "parameters": [ { "name": "repo_id", "in": "path", "required": true, "schema": { "type": "string" } }, { "name": "limit", "in": "query", "required": false, "schema": { "anyOf": [ { "type": "integer", "minimum": 0 }, { "type": "null" } ] } }, { "name": "offset", "in": "query", "required": false, "schema": { "anyOf": [ { "type": "integer", "minimum": 0 }, { "type": "null" } ] } }, { "name": "name_q", "in": "query", "required": false, "schema": { "anyOf": [ { "type": "string" }, { "type": "null" } ], "description": "Optional case-insensitive literal substring match on the file name." } }, { "name": "include", "in": "query", "required": false, "schema": { "anyOf": [ { "type": "string" }, { "type": "null" } ], "description": "Optional expansions (comma-separated), e.g. `include=breadcrumbs`." } } ], "description": "Authorization and validation are enforced by the owning service.\n\nHEAD uses the GET handler and headers without a response body.", "x-handler": "list_shared_direct_files", "x-source-file": "crates/synckhub-server/src/routes/items/read.rs", "x-source-line": 27, "x-implicit-head": true, "responses": { "default": { "description": "Platform error; branch on HTTP status and stable code, not the human-readable message." } } } }, "/repos/{repo_id}/items/subtree": { "post": { "operationId": "platform_post__repos__repo_id__items_subtree", "summary": "list items subtree post", "tags": [ "items · read" ], "parameters": [ { "name": "repo_id", "in": "path", "required": true, "schema": { "type": "string" } } ], "description": "Authorization and validation are enforced by the owning service.", "x-handler": "list_items_subtree_post", "x-source-file": "crates/synckhub-server/src/routes/items/read.rs", "x-source-line": 27, "responses": { "default": { "description": "Platform error; branch on HTTP status and stable code, not the human-readable message.", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } } }, "2XX": { "description": "Successful JSON response", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/synckhub_server.routes.items.read.ListItemsSubtreeResponse" } } } } }, "requestBody": { "required": true, "content": { "application/json": { "schema": { "$ref": "#/components/schemas/synckhub_server.routes.items.read.ListItemsSubtreeQuery" } } } } }, "get": { "operationId": "platform_get__repos__repo_id__items_subtree", "summary": "list items subtree get", "tags": [ "items · read" ], "parameters": [ { "name": "repo_id", "in": "path", "required": true, "schema": { "type": "string" } }, { "name": "folder_id", "in": "query", "required": false, "schema": { "anyOf": [ { "type": "string" }, { "type": "null" } ], "description": "Root folder item id. Use `\"\"` (empty) or omit for the root folder." } }, { "name": "include_root", "in": "query", "required": false, "schema": { "anyOf": [ { "type": "boolean" }, { "type": "null" } ] } }, { "name": "limit", "in": "query", "required": false, "schema": { "anyOf": [ { "type": "integer", "minimum": 0 }, { "type": "null" } ] } }, { "name": "offset", "in": "query", "required": false, "schema": { "anyOf": [ { "type": "integer", "minimum": 0 }, { "type": "null" } ] } }, { "name": "cursor", "in": "query", "required": false, "schema": { "anyOf": [ { "type": "string" }, { "type": "null" } ] } }, { "name": "sort", "in": "query", "required": false, "schema": { "anyOf": [ { "$ref": "#/components/schemas/synckhub_server.routes.items.read.ListItemsSubtreeSort" }, { "type": "null" } ] } }, { "name": "order", "in": "query", "required": false, "schema": { "anyOf": [ { "$ref": "#/components/schemas/synckhub_core.types.ListItemsOrder" }, { "type": "null" } ] } }, { "name": "folders_first", "in": "query", "required": false, "schema": { "anyOf": [ { "type": "boolean" }, { "type": "null" } ] } }, { "name": "item_type", "in": "query", "required": false, "schema": { "anyOf": [ { "type": "string" }, { "type": "null" } ], "description": "Optional item type, with FILE extension union semantics matching items/list." } }, { "name": "file_extension", "in": "query", "required": false, "schema": { "anyOf": [ { "type": "string" }, { "type": "null" } ] } }, { "name": "file_extension_exclude", "in": "query", "required": false, "schema": { "anyOf": [ { "type": "string" }, { "type": "null" } ], "description": "Optional comma-separated FILE extension exclusions." } }, { "name": "case_status", "in": "query", "required": false, "schema": { "anyOf": [ { "type": "string" }, { "type": "null" } ], "description": "Optional comma-separated canonical case workflow statuses." } }, { "name": "include", "in": "query", "required": false, "schema": { "anyOf": [ { "type": "string" }, { "type": "null" } ] } } ], "description": "Authorization and validation are enforced by the owning service.", "x-handler": "list_items_subtree_get", "x-source-file": "crates/synckhub-server/src/routes/items/read.rs", "x-source-line": 27, "responses": { "default": { "description": "Platform error; branch on HTTP status and stable code, not the human-readable message.", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } } }, "2XX": { "description": "Successful JSON response", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/synckhub_server.routes.items.read.ListItemsSubtreeResponse" } } } } } }, "head": { "operationId": "platform_head__repos__repo_id__items_subtree", "summary": "list items subtree get", "tags": [ "items · read" ], "parameters": [ { "name": "repo_id", "in": "path", "required": true, "schema": { "type": "string" } }, { "name": "folder_id", "in": "query", "required": false, "schema": { "anyOf": [ { "type": "string" }, { "type": "null" } ], "description": "Root folder item id. Use `\"\"` (empty) or omit for the root folder." } }, { "name": "include_root", "in": "query", "required": false, "schema": { "anyOf": [ { "type": "boolean" }, { "type": "null" } ] } }, { "name": "limit", "in": "query", "required": false, "schema": { "anyOf": [ { "type": "integer", "minimum": 0 }, { "type": "null" } ] } }, { "name": "offset", "in": "query", "required": false, "schema": { "anyOf": [ { "type": "integer", "minimum": 0 }, { "type": "null" } ] } }, { "name": "cursor", "in": "query", "required": false, "schema": { "anyOf": [ { "type": "string" }, { "type": "null" } ] } }, { "name": "sort", "in": "query", "required": false, "schema": { "anyOf": [ { "$ref": "#/components/schemas/synckhub_server.routes.items.read.ListItemsSubtreeSort" }, { "type": "null" } ] } }, { "name": "order", "in": "query", "required": false, "schema": { "anyOf": [ { "$ref": "#/components/schemas/synckhub_core.types.ListItemsOrder" }, { "type": "null" } ] } }, { "name": "folders_first", "in": "query", "required": false, "schema": { "anyOf": [ { "type": "boolean" }, { "type": "null" } ] } }, { "name": "item_type", "in": "query", "required": false, "schema": { "anyOf": [ { "type": "string" }, { "type": "null" } ], "description": "Optional item type, with FILE extension union semantics matching items/list." } }, { "name": "file_extension", "in": "query", "required": false, "schema": { "anyOf": [ { "type": "string" }, { "type": "null" } ] } }, { "name": "file_extension_exclude", "in": "query", "required": false, "schema": { "anyOf": [ { "type": "string" }, { "type": "null" } ], "description": "Optional comma-separated FILE extension exclusions." } }, { "name": "case_status", "in": "query", "required": false, "schema": { "anyOf": [ { "type": "string" }, { "type": "null" } ], "description": "Optional comma-separated canonical case workflow statuses." } }, { "name": "include", "in": "query", "required": false, "schema": { "anyOf": [ { "type": "string" }, { "type": "null" } ] } } ], "description": "Authorization and validation are enforced by the owning service.\n\nHEAD uses the GET handler and headers without a response body.", "x-handler": "list_items_subtree_get", "x-source-file": "crates/synckhub-server/src/routes/items/read.rs", "x-source-line": 27, "x-implicit-head": true, "responses": { "default": { "description": "Platform error; branch on HTTP status and stable code, not the human-readable message." } } } }, "/repos/{repo_id}/items/subtree/events": { "get": { "operationId": "platform_get__repos__repo_id__items_subtree_events", "summary": "list items subtree events", "tags": [ "items · read" ], "parameters": [ { "name": "repo_id", "in": "path", "required": true, "schema": { "type": "string" } }, { "name": "folder_id", "in": "query", "required": false, "schema": { "anyOf": [ { "type": "string" }, { "type": "null" } ], "description": "Root folder item id. Use `\"\"` (empty) or omit for the root folder." } }, { "name": "include_root", "in": "query", "required": false, "schema": { "anyOf": [ { "type": "boolean" }, { "type": "null" } ] } }, { "name": "limit", "in": "query", "required": false, "schema": { "anyOf": [ { "type": "integer", "minimum": 0 }, { "type": "null" } ] } }, { "name": "after_repo_seq", "in": "query", "required": false, "schema": { "anyOf": [ { "type": "integer" }, { "type": "null" } ] } }, { "name": "after_commit_event_idx", "in": "query", "required": false, "schema": { "anyOf": [ { "type": "integer" }, { "type": "null" } ] } } ], "description": "Authorization and validation are enforced by the owning service.", "x-handler": "list_items_subtree_events", "x-source-file": "crates/synckhub-server/src/routes/items/read.rs", "x-source-line": 27, "responses": { "default": { "description": "Platform error; branch on HTTP status and stable code, not the human-readable message.", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } } }, "2XX": { "description": "Successful JSON response", "content": { "application/json": { "schema": { "type": "array", "items": { "$ref": "#/components/schemas/synckhub_core.types.ItemEventEntry" } } } } } } }, "head": { "operationId": "platform_head__repos__repo_id__items_subtree_events", "summary": "list items subtree events", "tags": [ "items · read" ], "parameters": [ { "name": "repo_id", "in": "path", "required": true, "schema": { "type": "string" } }, { "name": "folder_id", "in": "query", "required": false, "schema": { "anyOf": [ { "type": "string" }, { "type": "null" } ], "description": "Root folder item id. Use `\"\"` (empty) or omit for the root folder." } }, { "name": "include_root", "in": "query", "required": false, "schema": { "anyOf": [ { "type": "boolean" }, { "type": "null" } ] } }, { "name": "limit", "in": "query", "required": false, "schema": { "anyOf": [ { "type": "integer", "minimum": 0 }, { "type": "null" } ] } }, { "name": "after_repo_seq", "in": "query", "required": false, "schema": { "anyOf": [ { "type": "integer" }, { "type": "null" } ] } }, { "name": "after_commit_event_idx", "in": "query", "required": false, "schema": { "anyOf": [ { "type": "integer" }, { "type": "null" } ] } } ], "description": "Authorization and validation are enforced by the owning service.\n\nHEAD uses the GET handler and headers without a response body.", "x-handler": "list_items_subtree_events", "x-source-file": "crates/synckhub-server/src/routes/items/read.rs", "x-source-line": 27, "x-implicit-head": true, "responses": { "default": { "description": "Platform error; branch on HTTP status and stable code, not the human-readable message." } } } }, "/repos/{repo_id}/items/trash": { "get": { "operationId": "platform_get__repos__repo_id__items_trash", "summary": "list trashed items", "tags": [ "items · read" ], "parameters": [ { "name": "repo_id", "in": "path", "required": true, "schema": { "type": "string" } }, { "name": "item_type", "in": "query", "required": false, "schema": { "type": "array", "items": { "type": "string" } }, "style": "form", "explode": true }, { "name": "item_type_exclude", "in": "query", "required": false, "schema": { "type": "array", "items": { "type": "string" } }, "style": "form", "explode": true }, { "name": "item_subtype", "in": "query", "required": false, "schema": { "type": "array", "items": { "type": "string" } }, "style": "form", "explode": true }, { "name": "case_status", "in": "query", "required": false, "schema": { "type": "array", "items": { "type": "string" } }, "style": "form", "explode": true }, { "name": "file_extension", "in": "query", "required": false, "schema": { "type": "array", "items": { "type": "string" }, "description": "Optional FILE-branch filter (repeatable; ANY match), e.g. `file_extension=pdf`.\n\nValues are normalized to lowercase ASCII and stored without a leading dot." }, "style": "form", "explode": true }, { "name": "file_extension_exclude", "in": "query", "required": false, "schema": { "type": "array", "items": { "type": "string" }, "description": "Optional FILE-branch exclusion (repeatable; ANY match), e.g. `file_extension_exclude=eml`." }, "style": "form", "explode": true }, { "name": "quick_access", "in": "query", "required": false, "schema": { "anyOf": [ { "type": "boolean" }, { "type": "null" } ] } }, { "name": "parent_folder_id", "in": "query", "required": false, "schema": { "anyOf": [ { "type": "string" }, { "type": "null" } ], "description": "Optional parent folder filter:\n- `None` means no parent filter (all items in the repo).\n- `Some(id)` means direct children of the given folder id.\n- `Some(\"\")` means root items only (no parent folder)." } }, { "name": "in_trash", "in": "query", "required": false, "schema": { "anyOf": [ { "type": "boolean" }, { "type": "null" } ] } }, { "name": "tombstoned", "in": "query", "required": false, "schema": { "anyOf": [ { "type": "boolean" }, { "type": "null" } ] } }, { "name": "limit", "in": "query", "required": false, "schema": { "anyOf": [ { "type": "integer", "minimum": 0 }, { "type": "null" } ] } }, { "name": "offset", "in": "query", "required": false, "schema": { "anyOf": [ { "type": "integer", "minimum": 0 }, { "type": "null" } ] } }, { "name": "sort", "in": "query", "required": false, "schema": { "anyOf": [ { "$ref": "#/components/schemas/synckhub_core.types.ListItemsSort" }, { "type": "null" } ] } }, { "name": "order", "in": "query", "required": false, "schema": { "anyOf": [ { "$ref": "#/components/schemas/synckhub_core.types.ListItemsOrder" }, { "type": "null" } ] } }, { "name": "folders_first", "in": "query", "required": false, "schema": { "anyOf": [ { "type": "boolean" }, { "type": "null" } ] } }, { "name": "after_name", "in": "query", "required": false, "schema": { "anyOf": [ { "type": "string" }, { "type": "null" } ] } }, { "name": "after_item_id", "in": "query", "required": false, "schema": { "anyOf": [ { "type": "string" }, { "type": "null" } ] } }, { "name": "include", "in": "query", "required": false, "schema": { "anyOf": [ { "type": "string" }, { "type": "null" } ], "description": "Optional expansions (comma-separated), e.g. `include=breadcrumbs`." } } ], "description": "List trashed items in a repository.\n\nAuthorization and validation are enforced by the owning service.", "x-handler": "list_trashed_items", "x-source-file": "crates/synckhub-server/src/routes/items/read.rs", "x-source-line": 27, "responses": { "default": { "description": "Platform error; branch on HTTP status and stable code, not the human-readable message.", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } } }, "2XX": { "description": "Successful JSON response", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/synckhub_server.routes.ListItemsResponse" } } } } } }, "head": { "operationId": "platform_head__repos__repo_id__items_trash", "summary": "list trashed items", "tags": [ "items · read" ], "parameters": [ { "name": "repo_id", "in": "path", "required": true, "schema": { "type": "string" } }, { "name": "item_type", "in": "query", "required": false, "schema": { "type": "array", "items": { "type": "string" } }, "style": "form", "explode": true }, { "name": "item_type_exclude", "in": "query", "required": false, "schema": { "type": "array", "items": { "type": "string" } }, "style": "form", "explode": true }, { "name": "item_subtype", "in": "query", "required": false, "schema": { "type": "array", "items": { "type": "string" } }, "style": "form", "explode": true }, { "name": "case_status", "in": "query", "required": false, "schema": { "type": "array", "items": { "type": "string" } }, "style": "form", "explode": true }, { "name": "file_extension", "in": "query", "required": false, "schema": { "type": "array", "items": { "type": "string" }, "description": "Optional FILE-branch filter (repeatable; ANY match), e.g. `file_extension=pdf`.\n\nValues are normalized to lowercase ASCII and stored without a leading dot." }, "style": "form", "explode": true }, { "name": "file_extension_exclude", "in": "query", "required": false, "schema": { "type": "array", "items": { "type": "string" }, "description": "Optional FILE-branch exclusion (repeatable; ANY match), e.g. `file_extension_exclude=eml`." }, "style": "form", "explode": true }, { "name": "quick_access", "in": "query", "required": false, "schema": { "anyOf": [ { "type": "boolean" }, { "type": "null" } ] } }, { "name": "parent_folder_id", "in": "query", "required": false, "schema": { "anyOf": [ { "type": "string" }, { "type": "null" } ], "description": "Optional parent folder filter:\n- `None` means no parent filter (all items in the repo).\n- `Some(id)` means direct children of the given folder id.\n- `Some(\"\")` means root items only (no parent folder)." } }, { "name": "in_trash", "in": "query", "required": false, "schema": { "anyOf": [ { "type": "boolean" }, { "type": "null" } ] } }, { "name": "tombstoned", "in": "query", "required": false, "schema": { "anyOf": [ { "type": "boolean" }, { "type": "null" } ] } }, { "name": "limit", "in": "query", "required": false, "schema": { "anyOf": [ { "type": "integer", "minimum": 0 }, { "type": "null" } ] } }, { "name": "offset", "in": "query", "required": false, "schema": { "anyOf": [ { "type": "integer", "minimum": 0 }, { "type": "null" } ] } }, { "name": "sort", "in": "query", "required": false, "schema": { "anyOf": [ { "$ref": "#/components/schemas/synckhub_core.types.ListItemsSort" }, { "type": "null" } ] } }, { "name": "order", "in": "query", "required": false, "schema": { "anyOf": [ { "$ref": "#/components/schemas/synckhub_core.types.ListItemsOrder" }, { "type": "null" } ] } }, { "name": "folders_first", "in": "query", "required": false, "schema": { "anyOf": [ { "type": "boolean" }, { "type": "null" } ] } }, { "name": "after_name", "in": "query", "required": false, "schema": { "anyOf": [ { "type": "string" }, { "type": "null" } ] } }, { "name": "after_item_id", "in": "query", "required": false, "schema": { "anyOf": [ { "type": "string" }, { "type": "null" } ] } }, { "name": "include", "in": "query", "required": false, "schema": { "anyOf": [ { "type": "string" }, { "type": "null" } ], "description": "Optional expansions (comma-separated), e.g. `include=breadcrumbs`." } } ], "description": "List trashed items in a repository.\n\nAuthorization and validation are enforced by the owning service.\n\nHEAD uses the GET handler and headers without a response body.", "x-handler": "list_trashed_items", "x-source-file": "crates/synckhub-server/src/routes/items/read.rs", "x-source-line": 27, "x-implicit-head": true, "responses": { "default": { "description": "Platform error; branch on HTTP status and stable code, not the human-readable message." } } } }, "/repos/{repo_id}/items/unzip": { "post": { "operationId": "platform_post__repos__repo_id__items_unzip", "summary": "unzip item", "tags": [ "files · archive" ], "parameters": [ { "name": "repo_id", "in": "path", "required": true, "schema": { "type": "string" } } ], "description": "Authorization and validation are enforced by the owning service.", "x-handler": "unzip_item", "x-source-file": "crates/synckhub-server/src/routes/files/archive.rs", "x-source-line": 10, "responses": { "default": { "description": "Platform error; branch on HTTP status and stable code, not the human-readable message.", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } } }, "2XX": { "description": "Successful JSON response", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/synckhub_server.routes.files.archive.UnzipItemResponse" } } } } }, "requestBody": { "required": true, "content": { "application/json": { "schema": { "$ref": "#/components/schemas/synckhub_server.routes.files.archive.UnzipItemRequest" } } } } } }, "/repos/{repo_id}/items/user-overview": { "get": { "operationId": "platform_get__repos__repo_id__items_user_overview", "summary": "get user overview", "tags": [ "items · read" ], "parameters": [ { "name": "repo_id", "in": "path", "required": true, "schema": { "type": "string" } }, { "name": "tasks_limit", "in": "query", "required": false, "schema": { "anyOf": [ { "type": "integer", "minimum": 0 }, { "type": "null" } ] } }, { "name": "chat_messages_limit", "in": "query", "required": false, "schema": { "anyOf": [ { "type": "integer", "minimum": 0 }, { "type": "null" } ] } }, { "name": "files_limit", "in": "query", "required": false, "schema": { "anyOf": [ { "type": "integer", "minimum": 0 }, { "type": "null" } ] } }, { "name": "notes_limit", "in": "query", "required": false, "schema": { "anyOf": [ { "type": "integer", "minimum": 0 }, { "type": "null" } ] } }, { "name": "activity_limit", "in": "query", "required": false, "schema": { "anyOf": [ { "type": "integer", "minimum": 0 }, { "type": "null" } ] } }, { "name": "commits_tz", "in": "query", "required": false, "schema": { "anyOf": [ { "type": "string" }, { "type": "null" } ] } }, { "name": "mail_accounts_limit", "in": "query", "required": false, "schema": { "anyOf": [ { "type": "integer", "minimum": 0 }, { "type": "null" } ] } }, { "name": "mail_messages_per_account", "in": "query", "required": false, "schema": { "anyOf": [ { "type": "integer", "minimum": 0 }, { "type": "null" } ] } }, { "name": "calendar_events_per_account", "in": "query", "required": false, "schema": { "anyOf": [ { "type": "integer", "minimum": 0 }, { "type": "null" } ] } }, { "name": "calendar_range_days", "in": "query", "required": false, "schema": { "anyOf": [ { "type": "integer" }, { "type": "null" } ] } } ], "description": "Authorization and validation are enforced by the owning service.", "x-handler": "get_user_overview", "x-source-file": "crates/synckhub-server/src/routes/items/read.rs", "x-source-line": 27, "responses": { "default": { "description": "Platform error; branch on HTTP status and stable code, not the human-readable message.", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } } }, "2XX": { "description": "Successful JSON response", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/synckhub_server.routes.items.read.UserOverviewResponse" } } } } } }, "head": { "operationId": "platform_head__repos__repo_id__items_user_overview", "summary": "get user overview", "tags": [ "items · read" ], "parameters": [ { "name": "repo_id", "in": "path", "required": true, "schema": { "type": "string" } }, { "name": "tasks_limit", "in": "query", "required": false, "schema": { "anyOf": [ { "type": "integer", "minimum": 0 }, { "type": "null" } ] } }, { "name": "chat_messages_limit", "in": "query", "required": false, "schema": { "anyOf": [ { "type": "integer", "minimum": 0 }, { "type": "null" } ] } }, { "name": "files_limit", "in": "query", "required": false, "schema": { "anyOf": [ { "type": "integer", "minimum": 0 }, { "type": "null" } ] } }, { "name": "notes_limit", "in": "query", "required": false, "schema": { "anyOf": [ { "type": "integer", "minimum": 0 }, { "type": "null" } ] } }, { "name": "activity_limit", "in": "query", "required": false, "schema": { "anyOf": [ { "type": "integer", "minimum": 0 }, { "type": "null" } ] } }, { "name": "commits_tz", "in": "query", "required": false, "schema": { "anyOf": [ { "type": "string" }, { "type": "null" } ] } }, { "name": "mail_accounts_limit", "in": "query", "required": false, "schema": { "anyOf": [ { "type": "integer", "minimum": 0 }, { "type": "null" } ] } }, { "name": "mail_messages_per_account", "in": "query", "required": false, "schema": { "anyOf": [ { "type": "integer", "minimum": 0 }, { "type": "null" } ] } }, { "name": "calendar_events_per_account", "in": "query", "required": false, "schema": { "anyOf": [ { "type": "integer", "minimum": 0 }, { "type": "null" } ] } }, { "name": "calendar_range_days", "in": "query", "required": false, "schema": { "anyOf": [ { "type": "integer" }, { "type": "null" } ] } } ], "description": "Authorization and validation are enforced by the owning service.\n\nHEAD uses the GET handler and headers without a response body.", "x-handler": "get_user_overview", "x-source-file": "crates/synckhub-server/src/routes/items/read.rs", "x-source-line": 27, "x-implicit-head": true, "responses": { "default": { "description": "Platform error; branch on HTTP status and stable code, not the human-readable message." } } } }, "/repos/{repo_id}/items/zip": { "post": { "operationId": "platform_post__repos__repo_id__items_zip", "summary": "zip items", "tags": [ "files · archive" ], "parameters": [ { "name": "repo_id", "in": "path", "required": true, "schema": { "type": "string" } } ], "description": "Authorization and validation are enforced by the owning service.", "x-handler": "zip_items", "x-source-file": "crates/synckhub-server/src/routes/files/archive.rs", "x-source-line": 10, "responses": { "default": { "description": "Platform error; branch on HTTP status and stable code, not the human-readable message.", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } } }, "2XX": { "description": "Successful JSON response", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/synckhub_server.routes.files.archive.ZipItemsResponse" } } } } }, "requestBody": { "required": true, "content": { "application/json": { "schema": { "$ref": "#/components/schemas/synckhub_server.routes.files.archive.ZipItemsRequest" } } } } } }, "/repos/{repo_id}/leave": { "post": { "operationId": "platform_post__repos__repo_id__leave", "summary": "leave repo", "tags": [ "authz" ], "parameters": [ { "name": "repo_id", "in": "path", "required": true, "schema": { "type": "string" } } ], "description": "Authorization and validation are enforced by the owning service.", "x-handler": "leave_repo", "x-source-file": "crates/synckhub-server/src/routes/authz.rs", "x-source-line": 6602, "responses": { "default": { "description": "Platform error; branch on HTTP status and stable code, not the human-readable message.", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } } }, "2XX": { "description": "Successful JSON response", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/synckhub_server.routes.authz.LeaveRepoResponse" } } } } } } }, "/repos/{repo_id}/mail/team-inboxes": { "post": { "operationId": "platform_post__repos__repo_id__mail_team_inboxes", "summary": "create team inbox", "tags": [ "tasks · mail_team_work" ], "parameters": [ { "name": "repo_id", "in": "path", "required": true, "schema": { "type": "string" } } ], "description": "Authorization and validation are enforced by the owning service.", "x-handler": "create_team_inbox", "x-source-file": "crates/synckhub-server/src/routes/tasks/mail_team_work.rs", "x-source-line": 10, "responses": { "default": { "description": "Platform error; branch on HTTP status and stable code, not the human-readable message.", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } } } }, "requestBody": { "required": true, "content": { "application/json": { "schema": { "$ref": "#/components/schemas/synckhub_server.routes.tasks.mail_team_work.CreateTeamInboxRequest" } } } } }, "get": { "operationId": "platform_get__repos__repo_id__mail_team_inboxes", "summary": "list team inboxes", "tags": [ "tasks · mail_team_work" ], "parameters": [ { "name": "repo_id", "in": "path", "required": true, "schema": { "type": "string" } }, { "name": "include_all", "in": "query", "required": false, "schema": { "type": "boolean" } } ], "description": "Authorization and validation are enforced by the owning service.", "x-handler": "list_team_inboxes", "x-source-file": "crates/synckhub-server/src/routes/tasks/mail_team_work.rs", "x-source-line": 10, "responses": { "default": { "description": "Platform error; branch on HTTP status and stable code, not the human-readable message.", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } } }, "2XX": { "description": "Successful JSON response", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/synckhub_server.routes.tasks.mail_team_work.TeamInboxesResponse" } } } } } }, "head": { "operationId": "platform_head__repos__repo_id__mail_team_inboxes", "summary": "list team inboxes", "tags": [ "tasks · mail_team_work" ], "parameters": [ { "name": "repo_id", "in": "path", "required": true, "schema": { "type": "string" } }, { "name": "include_all", "in": "query", "required": false, "schema": { "type": "boolean" } } ], "description": "Authorization and validation are enforced by the owning service.\n\nHEAD uses the GET handler and headers without a response body.", "x-handler": "list_team_inboxes", "x-source-file": "crates/synckhub-server/src/routes/tasks/mail_team_work.rs", "x-source-line": 10, "x-implicit-head": true, "responses": { "default": { "description": "Platform error; branch on HTTP status and stable code, not the human-readable message." } } } }, "/repos/{repo_id}/mail/team-inboxes/{task_list_item_id}": { "delete": { "operationId": "platform_delete__repos__repo_id__mail_team_inboxes__task_list_item_id_", "summary": "delete team inbox", "tags": [ "tasks · mail_team_work" ], "parameters": [ { "name": "repo_id", "in": "path", "required": true, "schema": { "type": "string" } }, { "name": "task_list_item_id", "in": "path", "required": true, "schema": { "type": "string" } } ], "description": "Authorization and validation are enforced by the owning service.", "x-handler": "delete_team_inbox", "x-source-file": "crates/synckhub-server/src/routes/tasks/mail_team_work.rs", "x-source-line": 10, "responses": { "default": { "description": "Platform error; branch on HTTP status and stable code, not the human-readable message.", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } } } } }, "patch": { "operationId": "platform_patch__repos__repo_id__mail_team_inboxes__task_list_item_id_", "summary": "set team inbox enabled", "tags": [ "tasks · mail_team_work" ], "parameters": [ { "name": "repo_id", "in": "path", "required": true, "schema": { "type": "string" } }, { "name": "task_list_item_id", "in": "path", "required": true, "schema": { "type": "string" } } ], "description": "Authorization and validation are enforced by the owning service.", "x-handler": "set_team_inbox_enabled", "x-source-file": "crates/synckhub-server/src/routes/tasks/mail_team_work.rs", "x-source-line": 10, "responses": { "default": { "description": "Platform error; branch on HTTP status and stable code, not the human-readable message.", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } } }, "2XX": { "description": "Successful JSON response", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/synckhub_server.routes.tasks.mail_team_work.TeamInboxAdminView" } } } } }, "requestBody": { "required": true, "content": { "application/json": { "schema": { "$ref": "#/components/schemas/synckhub_server.routes.tasks.mail_team_work.SetTeamInboxEnabledRequest" } } } } } }, "/repos/{repo_id}/mail/team-inboxes/{task_list_item_id}/assignees": { "get": { "operationId": "platform_get__repos__repo_id__mail_team_inboxes__task_list_item_id__assignees", "summary": "list team inbox assignees", "tags": [ "tasks · mail_team_work" ], "parameters": [ { "name": "repo_id", "in": "path", "required": true, "schema": { "type": "string" } }, { "name": "task_list_item_id", "in": "path", "required": true, "schema": { "type": "string" } }, { "name": "q", "in": "query", "required": false, "schema": { "anyOf": [ { "type": "string" }, { "type": "null" } ] } }, { "name": "limit", "in": "query", "required": false, "schema": { "anyOf": [ { "type": "integer" }, { "type": "null" } ] } } ], "description": "Authorization and validation are enforced by the owning service.", "x-handler": "list_team_inbox_assignees", "x-source-file": "crates/synckhub-server/src/routes/tasks/mail_team_work.rs", "x-source-line": 10, "responses": { "default": { "description": "Platform error; branch on HTTP status and stable code, not the human-readable message.", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } } }, "2XX": { "description": "Successful JSON response", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/synckhub_server.routes.tasks.mail_team_work.AssigneesResponse" } } } } } }, "head": { "operationId": "platform_head__repos__repo_id__mail_team_inboxes__task_list_item_id__assignees", "summary": "list team inbox assignees", "tags": [ "tasks · mail_team_work" ], "parameters": [ { "name": "repo_id", "in": "path", "required": true, "schema": { "type": "string" } }, { "name": "task_list_item_id", "in": "path", "required": true, "schema": { "type": "string" } }, { "name": "q", "in": "query", "required": false, "schema": { "anyOf": [ { "type": "string" }, { "type": "null" } ] } }, { "name": "limit", "in": "query", "required": false, "schema": { "anyOf": [ { "type": "integer" }, { "type": "null" } ] } } ], "description": "Authorization and validation are enforced by the owning service.\n\nHEAD uses the GET handler and headers without a response body.", "x-handler": "list_team_inbox_assignees", "x-source-file": "crates/synckhub-server/src/routes/tasks/mail_team_work.rs", "x-source-line": 10, "x-implicit-head": true, "responses": { "default": { "description": "Platform error; branch on HTTP status and stable code, not the human-readable message." } } } }, "/repos/{repo_id}/naming-presets": { "get": { "operationId": "platform_get__repos__repo_id__naming_presets", "summary": "list naming presets", "tags": [ "naming" ], "parameters": [ { "name": "repo_id", "in": "path", "required": true, "schema": { "type": "string" } } ], "description": "Authorization and validation are enforced by the owning service.", "x-handler": "list_naming_presets", "x-source-file": "crates/synckhub-server/src/routes/naming.rs", "x-source-line": 14, "responses": { "default": { "description": "Platform error; branch on HTTP status and stable code, not the human-readable message.", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } } }, "2XX": { "description": "Successful JSON response", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/synckhub_server.routes.naming.NamingPresetsResponse" } } } } } }, "head": { "operationId": "platform_head__repos__repo_id__naming_presets", "summary": "list naming presets", "tags": [ "naming" ], "parameters": [ { "name": "repo_id", "in": "path", "required": true, "schema": { "type": "string" } } ], "description": "Authorization and validation are enforced by the owning service.\n\nHEAD uses the GET handler and headers without a response body.", "x-handler": "list_naming_presets", "x-source-file": "crates/synckhub-server/src/routes/naming.rs", "x-source-line": 14, "x-implicit-head": true, "responses": { "default": { "description": "Platform error; branch on HTTP status and stable code, not the human-readable message." } } } }, "/repos/{repo_id}/naming-presets/{preset_key}": { "delete": { "operationId": "platform_delete__repos__repo_id__naming_presets__preset_key_", "summary": "delete naming preset", "tags": [ "naming" ], "parameters": [ { "name": "repo_id", "in": "path", "required": true, "schema": { "type": "string" } }, { "name": "preset_key", "in": "path", "required": true, "schema": { "type": "string" } } ], "description": "Authorization and validation are enforced by the owning service.", "x-handler": "delete_naming_preset", "x-source-file": "crates/synckhub-server/src/routes/naming.rs", "x-source-line": 14, "responses": { "default": { "description": "Platform error; branch on HTTP status and stable code, not the human-readable message.", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } } } } }, "put": { "operationId": "platform_put__repos__repo_id__naming_presets__preset_key_", "summary": "put naming preset", "tags": [ "naming" ], "parameters": [ { "name": "repo_id", "in": "path", "required": true, "schema": { "type": "string" } }, { "name": "preset_key", "in": "path", "required": true, "schema": { "type": "string" } } ], "description": "Authorization and validation are enforced by the owning service.", "x-handler": "put_naming_preset", "x-source-file": "crates/synckhub-server/src/routes/naming.rs", "x-source-line": 14, "responses": { "default": { "description": "Platform error; branch on HTTP status and stable code, not the human-readable message.", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } } }, "2XX": { "description": "Successful JSON response", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/synckhub_server.naming_presets.NamingPreset" } } } } }, "requestBody": { "required": true, "content": { "application/json": { "schema": { "$ref": "#/components/schemas/synckhub_server.routes.naming.PutNamingPresetRequest" } } } } } }, "/repos/{repo_id}/naming-suggestions": { "post": { "operationId": "platform_post__repos__repo_id__naming_suggestions", "summary": "render naming suggestions", "tags": [ "naming" ], "parameters": [ { "name": "repo_id", "in": "path", "required": true, "schema": { "type": "string" } } ], "description": "Authorization and validation are enforced by the owning service.", "x-handler": "render_naming_suggestions", "x-source-file": "crates/synckhub-server/src/routes/naming.rs", "x-source-line": 14, "responses": { "default": { "description": "Platform error; branch on HTTP status and stable code, not the human-readable message.", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } } }, "2XX": { "description": "Successful JSON response", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/synckhub_server.routes.naming.NamingSuggestionsResponse" } } } } }, "requestBody": { "required": true, "content": { "application/json": { "schema": { "$ref": "#/components/schemas/synckhub_server.routes.naming.NamingSuggestionsRequest" } } } } } }, "/repos/{repo_id}/naming-suggestions/items": { "post": { "operationId": "platform_post__repos__repo_id__naming_suggestions_items", "summary": "render item naming suggestions", "tags": [ "naming" ], "parameters": [ { "name": "repo_id", "in": "path", "required": true, "schema": { "type": "string" } } ], "description": "Authorization and validation are enforced by the owning service.", "x-handler": "render_item_naming_suggestions", "x-source-file": "crates/synckhub-server/src/routes/naming.rs", "x-source-line": 14, "responses": { "default": { "description": "Platform error; branch on HTTP status and stable code, not the human-readable message.", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } } }, "2XX": { "description": "Successful JSON response", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/synckhub_server.routes.naming.ItemNamingSuggestionsResponse" } } } } }, "requestBody": { "required": true, "content": { "application/json": { "schema": { "$ref": "#/components/schemas/synckhub_server.routes.naming.ItemNamingSuggestionsRequest" } } } } } }, "/repos/{repo_id}/party-links": { "post": { "operationId": "platform_post__repos__repo_id__party_links", "summary": "create party role link", "tags": [ "directory · party_links" ], "parameters": [ { "name": "repo_id", "in": "path", "required": true, "schema": { "type": "string" } } ], "description": "Authorization and validation are enforced by the owning service.", "x-handler": "create_party_role_link", "x-source-file": "crates/synckhub-server/src/routes/directory/party_links.rs", "x-source-line": 7, "responses": { "default": { "description": "Platform error; branch on HTTP status and stable code, not the human-readable message.", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } } }, "2XX": { "description": "Successful JSON response", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/synckhub_server.routes.directory.party_links.PartyRoleLinkSummary" } } } } }, "requestBody": { "required": true, "content": { "application/json": { "schema": { "$ref": "#/components/schemas/synckhub_server.routes.directory.party_links.CreatePartyRoleLinkRequest" } } } } }, "get": { "operationId": "platform_get__repos__repo_id__party_links", "summary": "list party role links", "tags": [ "directory · party_links" ], "parameters": [ { "name": "repo_id", "in": "path", "required": true, "schema": { "type": "string" } }, { "name": "from_party_item_id", "in": "query", "required": false, "schema": { "anyOf": [ { "type": "string" }, { "type": "null" } ] } }, { "name": "to_party_item_id", "in": "query", "required": false, "schema": { "anyOf": [ { "type": "string" }, { "type": "null" } ] } }, { "name": "role_key", "in": "query", "required": false, "schema": { "anyOf": [ { "type": "string" }, { "type": "null" } ] } }, { "name": "status", "in": "query", "required": false, "schema": { "anyOf": [ { "type": "string" }, { "type": "null" } ] } } ], "description": "Authorization and validation are enforced by the owning service.", "x-handler": "list_party_role_links", "x-source-file": "crates/synckhub-server/src/routes/directory/party_links.rs", "x-source-line": 7, "responses": { "default": { "description": "Platform error; branch on HTTP status and stable code, not the human-readable message.", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } } }, "2XX": { "description": "Successful JSON response", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/synckhub_server.routes.directory.party_links.PartyRoleLinksResponse" } } } } } }, "head": { "operationId": "platform_head__repos__repo_id__party_links", "summary": "list party role links", "tags": [ "directory · party_links" ], "parameters": [ { "name": "repo_id", "in": "path", "required": true, "schema": { "type": "string" } }, { "name": "from_party_item_id", "in": "query", "required": false, "schema": { "anyOf": [ { "type": "string" }, { "type": "null" } ] } }, { "name": "to_party_item_id", "in": "query", "required": false, "schema": { "anyOf": [ { "type": "string" }, { "type": "null" } ] } }, { "name": "role_key", "in": "query", "required": false, "schema": { "anyOf": [ { "type": "string" }, { "type": "null" } ] } }, { "name": "status", "in": "query", "required": false, "schema": { "anyOf": [ { "type": "string" }, { "type": "null" } ] } } ], "description": "Authorization and validation are enforced by the owning service.\n\nHEAD uses the GET handler and headers without a response body.", "x-handler": "list_party_role_links", "x-source-file": "crates/synckhub-server/src/routes/directory/party_links.rs", "x-source-line": 7, "x-implicit-head": true, "responses": { "default": { "description": "Platform error; branch on HTTP status and stable code, not the human-readable message." } } } }, "/repos/{repo_id}/party-links/{link_id}/archive": { "post": { "operationId": "platform_post__repos__repo_id__party_links__link_id__archive", "summary": "archive party role link", "tags": [ "directory · party_links" ], "parameters": [ { "name": "repo_id", "in": "path", "required": true, "schema": { "type": "string" } }, { "name": "link_id", "in": "path", "required": true, "schema": { "type": "string" } } ], "description": "Authorization and validation are enforced by the owning service.", "x-handler": "archive_party_role_link", "x-source-file": "crates/synckhub-server/src/routes/directory/party_links.rs", "x-source-line": 7, "responses": { "default": { "description": "Platform error; branch on HTTP status and stable code, not the human-readable message.", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } } }, "2XX": { "description": "Successful JSON response", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/synckhub_server.routes.directory.party_links.PartyRoleLinkSummary" } } } } } } }, "/repos/{repo_id}/party-links/bulk": { "post": { "operationId": "platform_post__repos__repo_id__party_links_bulk", "summary": "bulk party role links", "tags": [ "directory · party_links" ], "parameters": [ { "name": "repo_id", "in": "path", "required": true, "schema": { "type": "string" } } ], "description": "Authorization and validation are enforced by the owning service.", "x-handler": "bulk_party_role_links", "x-source-file": "crates/synckhub-server/src/routes/directory/party_links.rs", "x-source-line": 7, "responses": { "default": { "description": "Platform error; branch on HTTP status and stable code, not the human-readable message.", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } } }, "2XX": { "description": "Successful JSON response", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/synckhub_server.routes.directory.party_links.BulkPartyRoleLinksResponse" } } } } }, "requestBody": { "required": true, "content": { "application/json": { "schema": { "$ref": "#/components/schemas/synckhub_server.routes.directory.party_links.BulkPartyRoleLinksRequest" } } } } } }, "/repos/{repo_id}/people/suggested": { "get": { "operationId": "platform_get__repos__repo_id__people_suggested", "summary": "list suggested people", "tags": [ "connected_accounts · provider_people" ], "parameters": [ { "name": "repo_id", "in": "path", "required": true, "schema": { "type": "string" } }, { "name": "q", "in": "query", "required": false, "schema": { "anyOf": [ { "type": "string" }, { "type": "null" } ] } }, { "name": "cursor", "in": "query", "required": false, "schema": { "anyOf": [ { "type": "string" }, { "type": "null" } ] } }, { "name": "limit", "in": "query", "required": false, "schema": { "anyOf": [ { "type": "integer", "minimum": 0 }, { "type": "null" } ] } } ], "description": "Authorization and validation are enforced by the owning service.", "x-handler": "list_suggested_people", "x-source-file": "crates/synckhub-server/src/routes/connected_accounts/provider_people.rs", "x-source-line": 916, "responses": { "default": { "description": "Service response. Error status and envelope depend on the operation." }, "2XX": { "description": "Successful JSON response", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/synckhub_server.routes.connected_accounts.provider_people.SuggestedPeopleResponse" } } } } } }, "head": { "operationId": "platform_head__repos__repo_id__people_suggested", "summary": "list suggested people", "tags": [ "connected_accounts · provider_people" ], "parameters": [ { "name": "repo_id", "in": "path", "required": true, "schema": { "type": "string" } }, { "name": "q", "in": "query", "required": false, "schema": { "anyOf": [ { "type": "string" }, { "type": "null" } ] } }, { "name": "cursor", "in": "query", "required": false, "schema": { "anyOf": [ { "type": "string" }, { "type": "null" } ] } }, { "name": "limit", "in": "query", "required": false, "schema": { "anyOf": [ { "type": "integer", "minimum": 0 }, { "type": "null" } ] } } ], "description": "Authorization and validation are enforced by the owning service.\n\nHEAD uses the GET handler and headers without a response body.", "x-handler": "list_suggested_people", "x-source-file": "crates/synckhub-server/src/routes/connected_accounts/provider_people.rs", "x-source-line": 916, "x-implicit-head": true, "responses": { "default": { "description": "Service response. Error status and envelope depend on the operation." } } } }, "/repos/{repo_id}/people/suggested/delete": { "post": { "operationId": "platform_post__repos__repo_id__people_suggested_delete", "summary": "delete suggested people", "tags": [ "connected_accounts · provider_people" ], "parameters": [ { "name": "repo_id", "in": "path", "required": true, "schema": { "type": "string" } } ], "description": "Authorization and validation are enforced by the owning service.", "x-handler": "delete_suggested_people", "x-source-file": "crates/synckhub-server/src/routes/connected_accounts/provider_people.rs", "x-source-line": 916, "responses": { "default": { "description": "Service response. Error status and envelope depend on the operation." }, "2XX": { "description": "Successful JSON response", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/synckhub_server.routes.connected_accounts.provider_people.DeleteSuggestedPeopleResponse" } } } } }, "requestBody": { "required": true, "content": { "application/json": { "schema": { "$ref": "#/components/schemas/synckhub_server.routes.connected_accounts.provider_people.DeleteSuggestedPeopleRequest" } } } } } }, "/repos/{repo_id}/people/suggested/merge": { "post": { "operationId": "platform_post__repos__repo_id__people_suggested_merge", "summary": "merge suggested person", "tags": [ "connected_accounts · provider_people" ], "parameters": [ { "name": "repo_id", "in": "path", "required": true, "schema": { "type": "string" } } ], "description": "Authorization and validation are enforced by the owning service.", "x-handler": "merge_suggested_person", "x-source-file": "crates/synckhub-server/src/routes/connected_accounts/provider_people.rs", "x-source-line": 916, "responses": { "default": { "description": "Service response. Error status and envelope depend on the operation." }, "2XX": { "description": "Successful JSON response", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/synckhub_server.routes.connected_accounts.provider_people.SuggestedPeopleMutationResponse" } } } } }, "requestBody": { "required": true, "content": { "application/json": { "schema": { "$ref": "#/components/schemas/synckhub_server.routes.connected_accounts.provider_people.MergeSuggestedPersonRequest" } } } } } }, "/repos/{repo_id}/people/suggested/merge-candidates": { "get": { "operationId": "platform_get__repos__repo_id__people_suggested_merge_candidates", "summary": "list suggested people merge candidates", "tags": [ "connected_accounts · provider_people" ], "parameters": [ { "name": "repo_id", "in": "path", "required": true, "schema": { "type": "string" } }, { "name": "email", "in": "query", "required": true, "schema": { "type": "string" } }, { "name": "name", "in": "query", "required": false, "schema": { "anyOf": [ { "type": "string" }, { "type": "null" } ] } }, { "name": "organization", "in": "query", "required": false, "schema": { "anyOf": [ { "type": "string" }, { "type": "null" } ] } } ], "description": "Authorization and validation are enforced by the owning service.", "x-handler": "list_suggested_people_merge_candidates", "x-source-file": "crates/synckhub-server/src/routes/connected_accounts/provider_people.rs", "x-source-line": 916, "responses": { "default": { "description": "Service response. Error status and envelope depend on the operation." }, "2XX": { "description": "Successful JSON response", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/synckhub_server.routes.connected_accounts.provider_people.MergeCandidatesResponse" } } } } } }, "head": { "operationId": "platform_head__repos__repo_id__people_suggested_merge_candidates", "summary": "list suggested people merge candidates", "tags": [ "connected_accounts · provider_people" ], "parameters": [ { "name": "repo_id", "in": "path", "required": true, "schema": { "type": "string" } }, { "name": "email", "in": "query", "required": true, "schema": { "type": "string" } }, { "name": "name", "in": "query", "required": false, "schema": { "anyOf": [ { "type": "string" }, { "type": "null" } ] } }, { "name": "organization", "in": "query", "required": false, "schema": { "anyOf": [ { "type": "string" }, { "type": "null" } ] } } ], "description": "Authorization and validation are enforced by the owning service.\n\nHEAD uses the GET handler and headers without a response body.", "x-handler": "list_suggested_people_merge_candidates", "x-source-file": "crates/synckhub-server/src/routes/connected_accounts/provider_people.rs", "x-source-line": 916, "x-implicit-head": true, "responses": { "default": { "description": "Service response. Error status and envelope depend on the operation." } } } }, "/repos/{repo_id}/people/suggested/promote": { "post": { "operationId": "platform_post__repos__repo_id__people_suggested_promote", "summary": "promote suggested people", "tags": [ "connected_accounts · provider_people" ], "parameters": [ { "name": "repo_id", "in": "path", "required": true, "schema": { "type": "string" } } ], "description": "Authorization and validation are enforced by the owning service.", "x-handler": "promote_suggested_people", "x-source-file": "crates/synckhub-server/src/routes/connected_accounts/provider_people.rs", "x-source-line": 916, "responses": { "default": { "description": "Service response. Error status and envelope depend on the operation." }, "2XX": { "description": "Successful JSON response", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/synckhub_server.routes.connected_accounts.provider_people.SuggestedPeopleMutationResponse" } } } } }, "requestBody": { "required": true, "content": { "application/json": { "schema": { "$ref": "#/components/schemas/synckhub_server.routes.connected_accounts.provider_people.PromoteSuggestedPeopleRequest" } } } } } }, "/repos/{repo_id}/permission-approval-requests": { "post": { "operationId": "platform_post__repos__repo_id__permission_approval_requests", "summary": "create permission approval request", "tags": [ "sharing" ], "parameters": [ { "name": "repo_id", "in": "path", "required": true, "schema": { "type": "string" } } ], "description": "Authorization and validation are enforced by the owning service.", "x-handler": "crate::permission_approval_threads::create_permission_approval_request", "x-source-file": "crates/synckhub-server/src/routes/sharing.rs", "x-source-line": 7, "responses": { "default": { "description": "Platform error; branch on HTTP status and stable code, not the human-readable message.", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } } }, "2XX": { "description": "Successful JSON response", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/synckhub_server.permission_approval_threads.PermissionApprovalDetail" } } } } }, "requestBody": { "required": true, "content": { "application/json": { "schema": { "$ref": "#/components/schemas/synckhub_server.permission_approval_threads.CreatePermissionApprovalRequest" } } } } }, "get": { "operationId": "platform_get__repos__repo_id__permission_approval_requests", "summary": "list permission approval requests", "tags": [ "sharing" ], "parameters": [ { "name": "repo_id", "in": "path", "required": true, "schema": { "type": "string" } }, { "name": "view", "in": "query", "required": false, "schema": { "anyOf": [ { "type": "string" }, { "type": "null" } ] } }, { "name": "status", "in": "query", "required": false, "schema": { "anyOf": [ { "type": "string" }, { "type": "null" } ] } }, { "name": "limit", "in": "query", "required": false, "schema": { "anyOf": [ { "type": "integer" }, { "type": "null" } ] } }, { "name": "cursor", "in": "query", "required": false, "schema": { "anyOf": [ { "type": "string" }, { "type": "null" } ] } } ], "description": "Authorization and validation are enforced by the owning service.", "x-handler": "crate::permission_approval_threads::list_permission_approval_requests", "x-source-file": "crates/synckhub-server/src/routes/sharing.rs", "x-source-line": 7, "responses": { "default": { "description": "Platform error; branch on HTTP status and stable code, not the human-readable message.", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } } }, "2XX": { "description": "Successful JSON response", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/synckhub_server.permission_approval_threads.PermissionApprovalListResponse" } } } } } }, "head": { "operationId": "platform_head__repos__repo_id__permission_approval_requests", "summary": "list permission approval requests", "tags": [ "sharing" ], "parameters": [ { "name": "repo_id", "in": "path", "required": true, "schema": { "type": "string" } }, { "name": "view", "in": "query", "required": false, "schema": { "anyOf": [ { "type": "string" }, { "type": "null" } ] } }, { "name": "status", "in": "query", "required": false, "schema": { "anyOf": [ { "type": "string" }, { "type": "null" } ] } }, { "name": "limit", "in": "query", "required": false, "schema": { "anyOf": [ { "type": "integer" }, { "type": "null" } ] } }, { "name": "cursor", "in": "query", "required": false, "schema": { "anyOf": [ { "type": "string" }, { "type": "null" } ] } } ], "description": "Authorization and validation are enforced by the owning service.\n\nHEAD uses the GET handler and headers without a response body.", "x-handler": "crate::permission_approval_threads::list_permission_approval_requests", "x-source-file": "crates/synckhub-server/src/routes/sharing.rs", "x-source-line": 7, "x-implicit-head": true, "responses": { "default": { "description": "Platform error; branch on HTTP status and stable code, not the human-readable message." } } } }, "/repos/{repo_id}/permission-approval-requests/{request_id}": { "get": { "operationId": "platform_get__repos__repo_id__permission_approval_requests__request_id_", "summary": "get permission approval request", "tags": [ "sharing" ], "parameters": [ { "name": "repo_id", "in": "path", "required": true, "schema": { "type": "string" } }, { "name": "request_id", "in": "path", "required": true, "schema": { "type": "string" } } ], "description": "Authorization and validation are enforced by the owning service.", "x-handler": "crate::permission_approval_threads::get_permission_approval_request", "x-source-file": "crates/synckhub-server/src/routes/sharing.rs", "x-source-line": 7, "responses": { "default": { "description": "Platform error; branch on HTTP status and stable code, not the human-readable message.", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } } }, "2XX": { "description": "Successful JSON response", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/synckhub_server.permission_approval_threads.PermissionApprovalDetail" } } } } } }, "head": { "operationId": "platform_head__repos__repo_id__permission_approval_requests__request_id_", "summary": "get permission approval request", "tags": [ "sharing" ], "parameters": [ { "name": "repo_id", "in": "path", "required": true, "schema": { "type": "string" } }, { "name": "request_id", "in": "path", "required": true, "schema": { "type": "string" } } ], "description": "Authorization and validation are enforced by the owning service.\n\nHEAD uses the GET handler and headers without a response body.", "x-handler": "crate::permission_approval_threads::get_permission_approval_request", "x-source-file": "crates/synckhub-server/src/routes/sharing.rs", "x-source-line": 7, "x-implicit-head": true, "responses": { "default": { "description": "Platform error; branch on HTTP status and stable code, not the human-readable message." } } } }, "/repos/{repo_id}/permission-approval-requests/{request_id}/cancel": { "post": { "operationId": "platform_post__repos__repo_id__permission_approval_requests__request_id__cancel", "summary": "cancel permission approval request", "tags": [ "sharing" ], "parameters": [ { "name": "repo_id", "in": "path", "required": true, "schema": { "type": "string" } }, { "name": "request_id", "in": "path", "required": true, "schema": { "type": "string" } } ], "description": "Authorization and validation are enforced by the owning service.", "x-handler": "crate::permission_approval_threads::cancel_permission_approval_request", "x-source-file": "crates/synckhub-server/src/routes/sharing.rs", "x-source-line": 7, "responses": { "default": { "description": "Platform error; branch on HTTP status and stable code, not the human-readable message.", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } } }, "2XX": { "description": "Successful JSON response", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/synckhub_server.permission_approval_threads.PermissionApprovalDetail" } } } } } } }, "/repos/{repo_id}/permission-approval-requests/{request_id}/decide": { "post": { "operationId": "platform_post__repos__repo_id__permission_approval_requests__request_id__decide", "summary": "decide permission approval request", "tags": [ "sharing" ], "parameters": [ { "name": "repo_id", "in": "path", "required": true, "schema": { "type": "string" } }, { "name": "request_id", "in": "path", "required": true, "schema": { "type": "string" } } ], "description": "Authorization and validation are enforced by the owning service.", "x-handler": "crate::permission_approval_threads::decide_permission_approval_request", "x-source-file": "crates/synckhub-server/src/routes/sharing.rs", "x-source-line": 7, "responses": { "default": { "description": "Platform error; branch on HTTP status and stable code, not the human-readable message.", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } } }, "2XX": { "description": "Successful JSON response", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/synckhub_server.permission_approval_threads.PermissionApprovalDetail" } } } } }, "requestBody": { "required": true, "content": { "application/json": { "schema": { "$ref": "#/components/schemas/synckhub_server.permission_approval_threads.DecidePermissionApprovalRequest" } } } } } }, "/repos/{repo_id}/permission-approval-requests/{request_id}/messages": { "post": { "operationId": "platform_post__repos__repo_id__permission_approval_requests__request_id__messages", "summary": "post permission approval message", "tags": [ "sharing" ], "parameters": [ { "name": "repo_id", "in": "path", "required": true, "schema": { "type": "string" } }, { "name": "request_id", "in": "path", "required": true, "schema": { "type": "string" } } ], "description": "Authorization and validation are enforced by the owning service.", "x-handler": "crate::permission_approval_threads::post_permission_approval_message", "x-source-file": "crates/synckhub-server/src/routes/sharing.rs", "x-source-line": 7, "responses": { "default": { "description": "Platform error; branch on HTTP status and stable code, not the human-readable message.", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } } }, "2XX": { "description": "Successful JSON response", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/synckhub_server.permission_approval_threads.PermissionApprovalDetail" } } } } }, "requestBody": { "required": true, "content": { "application/json": { "schema": { "$ref": "#/components/schemas/synckhub_server.permission_approval_threads.PostPermissionApprovalMessageRequest" } } } } } }, "/repos/{repo_id}/posts": { "post": { "operationId": "platform_post__repos__repo_id__posts", "summary": "create repo post draft", "tags": [ "repo_posts" ], "parameters": [ { "name": "repo_id", "in": "path", "required": true, "schema": { "type": "string" } } ], "description": "Authorization and validation are enforced by the owning service.", "x-handler": "create_repo_post_draft", "x-source-file": "crates/synckhub-server/src/routes/repo_posts.rs", "x-source-line": 36, "responses": { "default": { "description": "Platform error; branch on HTTP status and stable code, not the human-readable message.", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } } }, "2XX": { "description": "Successful JSON response", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/synckhub_core.types.RepoPostSummary" } } } } }, "requestBody": { "required": true, "content": { "application/json": { "schema": { "$ref": "#/components/schemas/synckhub_server.routes.repo_posts.CreatePostRequest" } } } } }, "get": { "operationId": "platform_get__repos__repo_id__posts", "summary": "list repo posts", "tags": [ "repo_posts" ], "parameters": [ { "name": "repo_id", "in": "path", "required": true, "schema": { "type": "string" } }, { "name": "channel_id", "in": "query", "required": false, "schema": { "anyOf": [ { "type": "string" }, { "type": "null" } ] } }, { "name": "include_drafts", "in": "query", "required": false, "schema": { "type": "boolean" } }, { "name": "name_q", "in": "query", "required": false, "schema": { "anyOf": [ { "type": "string" }, { "type": "null" } ] } }, { "name": "limit", "in": "query", "required": false, "schema": { "type": "integer" } } ], "description": "Authorization and validation are enforced by the owning service.", "x-handler": "list_repo_posts", "x-source-file": "crates/synckhub-server/src/routes/repo_posts.rs", "x-source-line": 36, "responses": { "default": { "description": "Platform error; branch on HTTP status and stable code, not the human-readable message.", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } } }, "2XX": { "description": "Successful JSON response", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/synckhub_core.types.RepoPostFeedPage" } } } } } }, "head": { "operationId": "platform_head__repos__repo_id__posts", "summary": "list repo posts", "tags": [ "repo_posts" ], "parameters": [ { "name": "repo_id", "in": "path", "required": true, "schema": { "type": "string" } }, { "name": "channel_id", "in": "query", "required": false, "schema": { "anyOf": [ { "type": "string" }, { "type": "null" } ] } }, { "name": "include_drafts", "in": "query", "required": false, "schema": { "type": "boolean" } }, { "name": "name_q", "in": "query", "required": false, "schema": { "anyOf": [ { "type": "string" }, { "type": "null" } ] } }, { "name": "limit", "in": "query", "required": false, "schema": { "type": "integer" } } ], "description": "Authorization and validation are enforced by the owning service.\n\nHEAD uses the GET handler and headers without a response body.", "x-handler": "list_repo_posts", "x-source-file": "crates/synckhub-server/src/routes/repo_posts.rs", "x-source-line": 36, "x-implicit-head": true, "responses": { "default": { "description": "Platform error; branch on HTTP status and stable code, not the human-readable message." } } } }, "/repos/{repo_id}/posts/{post_item_id}": { "patch": { "operationId": "platform_patch__repos__repo_id__posts__post_item_id_", "summary": "update repo post", "tags": [ "repo_posts" ], "parameters": [ { "name": "repo_id", "in": "path", "required": true, "schema": { "type": "string" } }, { "name": "post_item_id", "in": "path", "required": true, "schema": { "type": "string" } } ], "description": "Authorization and validation are enforced by the owning service.", "x-handler": "update_repo_post", "x-source-file": "crates/synckhub-server/src/routes/repo_posts.rs", "x-source-line": 36, "responses": { "default": { "description": "Platform error; branch on HTTP status and stable code, not the human-readable message.", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } } }, "2XX": { "description": "Successful JSON response", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/synckhub_core.types.RepoPostSummary" } } } } }, "requestBody": { "required": true, "content": { "application/json": { "schema": { "$ref": "#/components/schemas/synckhub_server.routes.repo_posts.UpdatePostRequest" } } } } }, "get": { "operationId": "platform_get__repos__repo_id__posts__post_item_id_", "summary": "get repo post", "tags": [ "repo_posts" ], "parameters": [ { "name": "repo_id", "in": "path", "required": true, "schema": { "type": "string" } }, { "name": "post_item_id", "in": "path", "required": true, "schema": { "type": "string" } } ], "description": "Authorization and validation are enforced by the owning service.", "x-handler": "get_repo_post", "x-source-file": "crates/synckhub-server/src/routes/repo_posts.rs", "x-source-line": 36, "responses": { "default": { "description": "Platform error; branch on HTTP status and stable code, not the human-readable message.", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } } }, "2XX": { "description": "Successful JSON response", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/synckhub_core.types.RepoPostDetail" } } } } } }, "head": { "operationId": "platform_head__repos__repo_id__posts__post_item_id_", "summary": "get repo post", "tags": [ "repo_posts" ], "parameters": [ { "name": "repo_id", "in": "path", "required": true, "schema": { "type": "string" } }, { "name": "post_item_id", "in": "path", "required": true, "schema": { "type": "string" } } ], "description": "Authorization and validation are enforced by the owning service.\n\nHEAD uses the GET handler and headers without a response body.", "x-handler": "get_repo_post", "x-source-file": "crates/synckhub-server/src/routes/repo_posts.rs", "x-source-line": 36, "x-implicit-head": true, "responses": { "default": { "description": "Platform error; branch on HTTP status and stable code, not the human-readable message." } } } }, "/repos/{repo_id}/posts/{post_item_id}/archive": { "post": { "operationId": "platform_post__repos__repo_id__posts__post_item_id__archive", "summary": "archive repo post", "tags": [ "repo_posts" ], "parameters": [ { "name": "repo_id", "in": "path", "required": true, "schema": { "type": "string" } }, { "name": "post_item_id", "in": "path", "required": true, "schema": { "type": "string" } } ], "description": "Authorization and validation are enforced by the owning service.", "x-handler": "archive_repo_post", "x-source-file": "crates/synckhub-server/src/routes/repo_posts.rs", "x-source-line": 36, "responses": { "default": { "description": "Platform error; branch on HTTP status and stable code, not the human-readable message.", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } } }, "2XX": { "description": "Successful JSON response", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/synckhub_core.types.RepoPostSummary" } } } } } } }, "/repos/{repo_id}/posts/{post_item_id}/assets": { "post": { "operationId": "platform_post__repos__repo_id__posts__post_item_id__assets", "summary": "create repo post asset", "tags": [ "repo_posts" ], "parameters": [ { "name": "repo_id", "in": "path", "required": true, "schema": { "type": "string" } }, { "name": "post_item_id", "in": "path", "required": true, "schema": { "type": "string" } } ], "description": "Authorization and validation are enforced by the owning service.", "x-handler": "create_repo_post_asset", "x-source-file": "crates/synckhub-server/src/routes/repo_posts.rs", "x-source-line": 36, "responses": { "default": { "description": "Platform error; branch on HTTP status and stable code, not the human-readable message.", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } } }, "2XX": { "description": "Successful JSON response", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/synckhub_server.routes.repo_posts.CreatePostAssetResponse" } } } } }, "requestBody": { "required": true, "content": { "application/json": { "schema": { "$ref": "#/components/schemas/synckhub_server.routes.repo_posts.CreatePostAssetRequest" } } } } } }, "/repos/{repo_id}/posts/{post_item_id}/assets/{asset_id}/blob": { "get": { "operationId": "platform_get__repos__repo_id__posts__post_item_id__assets__asset_id__blob", "summary": "get repo post asset blob", "tags": [ "repo_posts" ], "parameters": [ { "name": "repo_id", "in": "path", "required": true, "schema": { "type": "string" } }, { "name": "post_item_id", "in": "path", "required": true, "schema": { "type": "string" } }, { "name": "asset_id", "in": "path", "required": true, "schema": { "type": "string" } } ], "description": "Authorization and validation are enforced by the owning service.", "x-handler": "get_repo_post_asset_blob", "x-source-file": "crates/synckhub-server/src/routes/repo_posts.rs", "x-source-line": 36, "responses": { "default": { "description": "Platform error; branch on HTTP status and stable code, not the human-readable message.", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } } } } }, "head": { "operationId": "platform_head__repos__repo_id__posts__post_item_id__assets__asset_id__blob", "summary": "get repo post asset blob", "tags": [ "repo_posts" ], "parameters": [ { "name": "repo_id", "in": "path", "required": true, "schema": { "type": "string" } }, { "name": "post_item_id", "in": "path", "required": true, "schema": { "type": "string" } }, { "name": "asset_id", "in": "path", "required": true, "schema": { "type": "string" } } ], "description": "Authorization and validation are enforced by the owning service.\n\nHEAD uses the GET handler and headers without a response body.", "x-handler": "get_repo_post_asset_blob", "x-source-file": "crates/synckhub-server/src/routes/repo_posts.rs", "x-source-line": 36, "x-implicit-head": true, "responses": { "default": { "description": "Platform error; branch on HTTP status and stable code, not the human-readable message." } } } }, "/repos/{repo_id}/posts/{post_item_id}/assets/{asset_id}/tombstone": { "post": { "operationId": "platform_post__repos__repo_id__posts__post_item_id__assets__asset_id__tombstone", "summary": "tombstone repo post asset", "tags": [ "repo_posts" ], "parameters": [ { "name": "repo_id", "in": "path", "required": true, "schema": { "type": "string" } }, { "name": "post_item_id", "in": "path", "required": true, "schema": { "type": "string" } }, { "name": "asset_id", "in": "path", "required": true, "schema": { "type": "string" } } ], "description": "Authorization and validation are enforced by the owning service.", "x-handler": "tombstone_repo_post_asset", "x-source-file": "crates/synckhub-server/src/routes/repo_posts.rs", "x-source-line": 36, "responses": { "default": { "description": "Platform error; branch on HTTP status and stable code, not the human-readable message.", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } } }, "2XX": { "description": "Successful JSON response", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/synckhub_server.routes.repo_posts.MarkReadResponse" } } } } } } }, "/repos/{repo_id}/posts/{post_item_id}/assets/reconcile": { "post": { "operationId": "platform_post__repos__repo_id__posts__post_item_id__assets_reconcile", "summary": "reconcile repo post assets", "tags": [ "repo_posts" ], "parameters": [ { "name": "repo_id", "in": "path", "required": true, "schema": { "type": "string" } }, { "name": "post_item_id", "in": "path", "required": true, "schema": { "type": "string" } } ], "description": "Authorization and validation are enforced by the owning service.", "x-handler": "reconcile_repo_post_assets", "x-source-file": "crates/synckhub-server/src/routes/repo_posts.rs", "x-source-line": 36, "responses": { "default": { "description": "Platform error; branch on HTTP status and stable code, not the human-readable message.", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } } }, "2XX": { "description": "Successful JSON response", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/synckhub_server.routes.repo_posts.MarkReadResponse" } } } } }, "requestBody": { "required": true, "content": { "application/json": { "schema": { "$ref": "#/components/schemas/synckhub_server.routes.repo_posts.ReconcilePostAssetsRequest" } } } } } }, "/repos/{repo_id}/posts/{post_item_id}/body": { "get": { "operationId": "platform_get__repos__repo_id__posts__post_item_id__body", "summary": "get repo post body", "tags": [ "repo_posts" ], "parameters": [ { "name": "repo_id", "in": "path", "required": true, "schema": { "type": "string" } }, { "name": "post_item_id", "in": "path", "required": true, "schema": { "type": "string" } } ], "description": "Authorization and validation are enforced by the owning service.", "x-handler": "get_repo_post_body", "x-source-file": "crates/synckhub-server/src/routes/repo_posts.rs", "x-source-line": 36, "responses": { "default": { "description": "Platform error; branch on HTTP status and stable code, not the human-readable message.", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } } } } }, "head": { "operationId": "platform_head__repos__repo_id__posts__post_item_id__body", "summary": "get repo post body", "tags": [ "repo_posts" ], "parameters": [ { "name": "repo_id", "in": "path", "required": true, "schema": { "type": "string" } }, { "name": "post_item_id", "in": "path", "required": true, "schema": { "type": "string" } } ], "description": "Authorization and validation are enforced by the owning service.\n\nHEAD uses the GET handler and headers without a response body.", "x-handler": "get_repo_post_body", "x-source-file": "crates/synckhub-server/src/routes/repo_posts.rs", "x-source-line": 36, "x-implicit-head": true, "responses": { "default": { "description": "Platform error; branch on HTTP status and stable code, not the human-readable message." } } } }, "/repos/{repo_id}/posts/{post_item_id}/comments": { "post": { "operationId": "platform_post__repos__repo_id__posts__post_item_id__comments", "summary": "create repo post comment", "tags": [ "repo_posts" ], "parameters": [ { "name": "repo_id", "in": "path", "required": true, "schema": { "type": "string" } }, { "name": "post_item_id", "in": "path", "required": true, "schema": { "type": "string" } } ], "description": "Authorization and validation are enforced by the owning service.", "x-handler": "create_repo_post_comment", "x-source-file": "crates/synckhub-server/src/routes/repo_posts.rs", "x-source-line": 36, "responses": { "default": { "description": "Platform error; branch on HTTP status and stable code, not the human-readable message.", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } } }, "2XX": { "description": "Successful JSON response", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/synckhub_core.types.RepoPostCommentSummary" } } } } }, "requestBody": { "required": true, "content": { "application/json": { "schema": { "$ref": "#/components/schemas/synckhub_server.routes.repo_posts.CreateCommentRequest" } } } } } }, "/repos/{repo_id}/posts/{post_item_id}/publish": { "post": { "operationId": "platform_post__repos__repo_id__posts__post_item_id__publish", "summary": "publish repo post", "tags": [ "repo_posts" ], "parameters": [ { "name": "repo_id", "in": "path", "required": true, "schema": { "type": "string" } }, { "name": "post_item_id", "in": "path", "required": true, "schema": { "type": "string" } } ], "description": "Authorization and validation are enforced by the owning service.", "x-handler": "publish_repo_post", "x-source-file": "crates/synckhub-server/src/routes/repo_posts.rs", "x-source-line": 36, "responses": { "default": { "description": "Platform error; branch on HTTP status and stable code, not the human-readable message.", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } } }, "2XX": { "description": "Successful JSON response", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/synckhub_core.types.RepoPostSummary" } } } } } } }, "/repos/{repo_id}/posts/body-blobs": { "post": { "operationId": "platform_post__repos__repo_id__posts_body_blobs", "summary": "create repo post body blob", "tags": [ "repo_posts" ], "parameters": [ { "name": "repo_id", "in": "path", "required": true, "schema": { "type": "string" } } ], "description": "Authorization and validation are enforced by the owning service.", "x-handler": "create_repo_post_body_blob", "x-source-file": "crates/synckhub-server/src/routes/repo_posts.rs", "x-source-line": 36, "responses": { "default": { "description": "Platform error; branch on HTTP status and stable code, not the human-readable message.", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } } }, "2XX": { "description": "Successful JSON response", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/synckhub_server.routes.repo_posts.CreatePostBodyBlobResponse" } } } } }, "requestBody": { "required": true, "content": { "application/json": { "schema": { "$ref": "#/components/schemas/synckhub_server.routes.repo_posts.CreatePostBodyBlobRequest" } } } } } }, "/repos/{repo_id}/posts/channels": { "post": { "operationId": "platform_post__repos__repo_id__posts_channels", "summary": "create post channel", "tags": [ "repo_posts" ], "parameters": [ { "name": "repo_id", "in": "path", "required": true, "schema": { "type": "string" } } ], "description": "Authorization and validation are enforced by the owning service.", "x-handler": "create_post_channel", "x-source-file": "crates/synckhub-server/src/routes/repo_posts.rs", "x-source-line": 36, "responses": { "default": { "description": "Platform error; branch on HTTP status and stable code, not the human-readable message.", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } } }, "2XX": { "description": "Successful JSON response", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/synckhub_core.types.RepoPostChannelSummary" } } } } }, "requestBody": { "required": true, "content": { "application/json": { "schema": { "$ref": "#/components/schemas/synckhub_server.routes.repo_posts.CreateChannelRequest" } } } } }, "get": { "operationId": "platform_get__repos__repo_id__posts_channels", "summary": "list post channels", "tags": [ "repo_posts" ], "parameters": [ { "name": "repo_id", "in": "path", "required": true, "schema": { "type": "string" } } ], "description": "Authorization and validation are enforced by the owning service.", "x-handler": "list_post_channels", "x-source-file": "crates/synckhub-server/src/routes/repo_posts.rs", "x-source-line": 36, "responses": { "default": { "description": "Platform error; branch on HTTP status and stable code, not the human-readable message.", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } } }, "2XX": { "description": "Successful JSON response", "content": { "application/json": { "schema": { "type": "array", "items": { "$ref": "#/components/schemas/synckhub_core.types.RepoPostChannelSummary" } } } } } } }, "head": { "operationId": "platform_head__repos__repo_id__posts_channels", "summary": "list post channels", "tags": [ "repo_posts" ], "parameters": [ { "name": "repo_id", "in": "path", "required": true, "schema": { "type": "string" } } ], "description": "Authorization and validation are enforced by the owning service.\n\nHEAD uses the GET handler and headers without a response body.", "x-handler": "list_post_channels", "x-source-file": "crates/synckhub-server/src/routes/repo_posts.rs", "x-source-line": 36, "x-implicit-head": true, "responses": { "default": { "description": "Platform error; branch on HTTP status and stable code, not the human-readable message." } } } }, "/repos/{repo_id}/posts/channels/{channel_id}/publish-rules": { "post": { "operationId": "platform_post__repos__repo_id__posts_channels__channel_id__publish_rules", "summary": "set post channel publish rule", "tags": [ "repo_posts" ], "parameters": [ { "name": "repo_id", "in": "path", "required": true, "schema": { "type": "string" } }, { "name": "channel_id", "in": "path", "required": true, "schema": { "type": "string" } } ], "description": "Authorization and validation are enforced by the owning service.", "x-handler": "set_post_channel_publish_rule", "x-source-file": "crates/synckhub-server/src/routes/repo_posts.rs", "x-source-line": 36, "responses": { "default": { "description": "Platform error; branch on HTTP status and stable code, not the human-readable message.", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } } }, "2XX": { "description": "Successful JSON response", "content": { "application/json": { "schema": { "type": "array", "items": { "$ref": "#/components/schemas/synckhub_core.types.RepoPostPublishRuleSummary" } } } } } }, "requestBody": { "required": true, "content": { "application/json": { "schema": { "$ref": "#/components/schemas/synckhub_server.routes.repo_posts.SetPublishRuleRequest" } } } } }, "get": { "operationId": "platform_get__repos__repo_id__posts_channels__channel_id__publish_rules", "summary": "list post channel publish rules", "tags": [ "repo_posts" ], "parameters": [ { "name": "repo_id", "in": "path", "required": true, "schema": { "type": "string" } }, { "name": "channel_id", "in": "path", "required": true, "schema": { "type": "string" } } ], "description": "Authorization and validation are enforced by the owning service.", "x-handler": "list_post_channel_publish_rules", "x-source-file": "crates/synckhub-server/src/routes/repo_posts.rs", "x-source-line": 36, "responses": { "default": { "description": "Platform error; branch on HTTP status and stable code, not the human-readable message.", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } } }, "2XX": { "description": "Successful JSON response", "content": { "application/json": { "schema": { "type": "array", "items": { "$ref": "#/components/schemas/synckhub_core.types.RepoPostPublishRuleSummary" } } } } } } }, "head": { "operationId": "platform_head__repos__repo_id__posts_channels__channel_id__publish_rules", "summary": "list post channel publish rules", "tags": [ "repo_posts" ], "parameters": [ { "name": "repo_id", "in": "path", "required": true, "schema": { "type": "string" } }, { "name": "channel_id", "in": "path", "required": true, "schema": { "type": "string" } } ], "description": "Authorization and validation are enforced by the owning service.\n\nHEAD uses the GET handler and headers without a response body.", "x-handler": "list_post_channel_publish_rules", "x-source-file": "crates/synckhub-server/src/routes/repo_posts.rs", "x-source-line": 36, "x-implicit-head": true, "responses": { "default": { "description": "Platform error; branch on HTTP status and stable code, not the human-readable message." } } } }, "/repos/{repo_id}/posts/channels/general/ensure": { "post": { "operationId": "platform_post__repos__repo_id__posts_channels_general_ensure", "summary": "ensure general post channel", "tags": [ "repo_posts" ], "parameters": [ { "name": "repo_id", "in": "path", "required": true, "schema": { "type": "string" } } ], "description": "Authorization and validation are enforced by the owning service.", "x-handler": "ensure_general_post_channel", "x-source-file": "crates/synckhub-server/src/routes/repo_posts.rs", "x-source-line": 36, "responses": { "default": { "description": "Platform error; branch on HTTP status and stable code, not the human-readable message.", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } } }, "2XX": { "description": "Successful JSON response", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/synckhub_core.types.RepoPostChannelSummary" } } } } } } }, "/repos/{repo_id}/posts/read-state": { "post": { "operationId": "platform_post__repos__repo_id__posts_read_state", "summary": "mark repo posts read", "tags": [ "repo_posts" ], "parameters": [ { "name": "repo_id", "in": "path", "required": true, "schema": { "type": "string" } } ], "description": "Authorization and validation are enforced by the owning service.", "x-handler": "mark_repo_posts_read", "x-source-file": "crates/synckhub-server/src/routes/repo_posts.rs", "x-source-line": 36, "responses": { "default": { "description": "Platform error; branch on HTTP status and stable code, not the human-readable message.", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } } }, "2XX": { "description": "Successful JSON response", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/synckhub_server.routes.repo_posts.MarkReadResponse" } } } } }, "requestBody": { "required": true, "content": { "application/json": { "schema": { "$ref": "#/components/schemas/synckhub_server.routes.repo_posts.MarkReadRequest" } } } } } }, "/repos/{repo_id}/realtime/events": { "get": { "operationId": "platform_get__repos__repo_id__realtime_events", "summary": "realtime repo events", "tags": [ "chat · rooms" ], "parameters": [ { "name": "repo_id", "in": "path", "required": true, "schema": { "type": "string" } } ], "description": "Authorization and validation are enforced by the owning service.", "x-handler": "realtime_repo_events", "x-source-file": "crates/synckhub-server/src/routes/chat/rooms.rs", "x-source-line": 11, "responses": { "default": { "description": "Platform error; branch on HTTP status and stable code, not the human-readable message.", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } } } } }, "head": { "operationId": "platform_head__repos__repo_id__realtime_events", "summary": "realtime repo events", "tags": [ "chat · rooms" ], "parameters": [ { "name": "repo_id", "in": "path", "required": true, "schema": { "type": "string" } } ], "description": "Authorization and validation are enforced by the owning service.\n\nHEAD uses the GET handler and headers without a response body.", "x-handler": "realtime_repo_events", "x-source-file": "crates/synckhub-server/src/routes/chat/rooms.rs", "x-source-line": 11, "x-implicit-head": true, "responses": { "default": { "description": "Platform error; branch on HTTP status and stable code, not the human-readable message." } } } }, "/repos/{repo_id}/recents/visit": { "post": { "operationId": "platform_post__repos__repo_id__recents_visit", "summary": "visit", "tags": [ "recents" ], "parameters": [ { "name": "repo_id", "in": "path", "required": true, "schema": { "type": "string" } } ], "description": "Authorization and validation are enforced by the owning service.", "x-handler": "visit", "x-source-file": "crates/synckhub-server/src/routes/recents.rs", "x-source-line": 23, "responses": { "default": { "description": "Platform error; branch on HTTP status and stable code, not the human-readable message.", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } } }, "2XX": { "description": "Successful JSON response", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/synckhub_server.routes.recents.VisitResponse" } } } } }, "requestBody": { "required": true, "content": { "application/json": { "schema": { "$ref": "#/components/schemas/synckhub_server.routes.recents.VisitRequest" } } } } } }, "/repos/{repo_id}/rtc/calls": { "post": { "operationId": "platform_post__repos__repo_id__rtc_calls", "summary": "create", "tags": [ "rtc" ], "parameters": [ { "name": "repo_id", "in": "path", "required": true, "schema": { "type": "string" } } ], "description": "Authorization and validation are enforced by the owning service.", "x-handler": "create", "x-source-file": "crates/synckhub-server/src/routes/rtc.rs", "x-source-line": 15, "responses": { "default": { "description": "Platform error; branch on HTTP status and stable code, not the human-readable message.", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } } }, "2XX": { "description": "Successful JSON response", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/synckhub_server.routes.rtc.CallDetail" } } } } }, "requestBody": { "required": true, "content": { "application/json": { "schema": { "$ref": "#/components/schemas/synckhub_server.routes.rtc.CreateRequest" } } } } }, "get": { "operationId": "platform_get__repos__repo_id__rtc_calls", "summary": "list", "tags": [ "rtc" ], "parameters": [ { "name": "repo_id", "in": "path", "required": true, "schema": { "type": "string" } }, { "name": "filter", "in": "query", "required": false, "schema": { "$ref": "#/components/schemas/synckhub_server.routes.rtc_history.Filter" } }, { "name": "limit", "in": "query", "required": false, "schema": { "anyOf": [ { "type": "integer", "minimum": 0 }, { "type": "null" } ] } }, { "name": "cursor", "in": "query", "required": false, "schema": { "anyOf": [ { "type": "string" }, { "type": "null" } ] } } ], "description": "Authorization and validation are enforced by the owning service.", "x-handler": "super::rtc_history::list", "x-source-file": "crates/synckhub-server/src/routes/rtc.rs", "x-source-line": 15, "responses": { "default": { "description": "Platform error; branch on HTTP status and stable code, not the human-readable message.", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } } }, "2XX": { "description": "Successful JSON response", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/synckhub_server.routes.rtc_history.Response" } } } } } }, "head": { "operationId": "platform_head__repos__repo_id__rtc_calls", "summary": "list", "tags": [ "rtc" ], "parameters": [ { "name": "repo_id", "in": "path", "required": true, "schema": { "type": "string" } }, { "name": "filter", "in": "query", "required": false, "schema": { "$ref": "#/components/schemas/synckhub_server.routes.rtc_history.Filter" } }, { "name": "limit", "in": "query", "required": false, "schema": { "anyOf": [ { "type": "integer", "minimum": 0 }, { "type": "null" } ] } }, { "name": "cursor", "in": "query", "required": false, "schema": { "anyOf": [ { "type": "string" }, { "type": "null" } ] } } ], "description": "Authorization and validation are enforced by the owning service.\n\nHEAD uses the GET handler and headers without a response body.", "x-handler": "super::rtc_history::list", "x-source-file": "crates/synckhub-server/src/routes/rtc.rs", "x-source-line": 15, "x-implicit-head": true, "responses": { "default": { "description": "Platform error; branch on HTTP status and stable code, not the human-readable message." } } } }, "/repos/{repo_id}/rtc/calls/{call_id}": { "get": { "operationId": "platform_get__repos__repo_id__rtc_calls__call_id_", "summary": "detail", "tags": [ "rtc" ], "parameters": [ { "name": "repo_id", "in": "path", "required": true, "schema": { "type": "string" } }, { "name": "call_id", "in": "path", "required": true, "schema": { "type": "string" } } ], "description": "Authorization and validation are enforced by the owning service.", "x-handler": "detail", "x-source-file": "crates/synckhub-server/src/routes/rtc.rs", "x-source-line": 15, "responses": { "default": { "description": "Platform error; branch on HTTP status and stable code, not the human-readable message.", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } } }, "2XX": { "description": "Successful JSON response", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/synckhub_server.routes.rtc.CallDetail" } } } } } }, "head": { "operationId": "platform_head__repos__repo_id__rtc_calls__call_id_", "summary": "detail", "tags": [ "rtc" ], "parameters": [ { "name": "repo_id", "in": "path", "required": true, "schema": { "type": "string" } }, { "name": "call_id", "in": "path", "required": true, "schema": { "type": "string" } } ], "description": "Authorization and validation are enforced by the owning service.\n\nHEAD uses the GET handler and headers without a response body.", "x-handler": "detail", "x-source-file": "crates/synckhub-server/src/routes/rtc.rs", "x-source-line": 15, "x-implicit-head": true, "responses": { "default": { "description": "Platform error; branch on HTTP status and stable code, not the human-readable message." } } } }, "/repos/{repo_id}/rtc/calls/{call_id}/decline": { "post": { "operationId": "platform_post__repos__repo_id__rtc_calls__call_id__decline", "summary": "decline", "tags": [ "rtc" ], "parameters": [ { "name": "repo_id", "in": "path", "required": true, "schema": { "type": "string" } }, { "name": "call_id", "in": "path", "required": true, "schema": { "type": "string" } } ], "description": "Authorization and validation are enforced by the owning service.", "x-handler": "decline", "x-source-file": "crates/synckhub-server/src/routes/rtc.rs", "x-source-line": 15, "responses": { "default": { "description": "Platform error; branch on HTTP status and stable code, not the human-readable message.", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } } }, "2XX": { "description": "Successful JSON response", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/synckhub_server.routes.rtc.CallDetail" } } } } }, "requestBody": { "required": true, "content": { "application/json": { "schema": { "$ref": "#/components/schemas/synckhub_server.routes.rtc.CommandRequest" } } } } } }, "/repos/{repo_id}/rtc/calls/{call_id}/end": { "post": { "operationId": "platform_post__repos__repo_id__rtc_calls__call_id__end", "summary": "end", "tags": [ "rtc" ], "parameters": [ { "name": "repo_id", "in": "path", "required": true, "schema": { "type": "string" } }, { "name": "call_id", "in": "path", "required": true, "schema": { "type": "string" } } ], "description": "Authorization and validation are enforced by the owning service.", "x-handler": "end", "x-source-file": "crates/synckhub-server/src/routes/rtc.rs", "x-source-line": 15, "responses": { "default": { "description": "Platform error; branch on HTTP status and stable code, not the human-readable message.", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } } }, "2XX": { "description": "Successful JSON response", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/synckhub_server.routes.rtc.CallDetail" } } } } }, "requestBody": { "required": true, "content": { "application/json": { "schema": { "$ref": "#/components/schemas/synckhub_server.routes.rtc.CommandRequest" } } } } } }, "/repos/{repo_id}/rtc/calls/{call_id}/join": { "post": { "operationId": "platform_post__repos__repo_id__rtc_calls__call_id__join", "summary": "join", "tags": [ "rtc" ], "parameters": [ { "name": "repo_id", "in": "path", "required": true, "schema": { "type": "string" } }, { "name": "call_id", "in": "path", "required": true, "schema": { "type": "string" } } ], "description": "Authorization and validation are enforced by the owning service.", "x-handler": "join", "x-source-file": "crates/synckhub-server/src/routes/rtc.rs", "x-source-line": 15, "responses": { "default": { "description": "Platform error; branch on HTTP status and stable code, not the human-readable message.", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } } }, "2XX": { "description": "Successful JSON response", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/synckhub_server.routes.rtc.JoinSession" } } } } }, "requestBody": { "required": true, "content": { "application/json": { "schema": { "$ref": "#/components/schemas/synckhub_server.routes.rtc.CommandRequest" } } } } } }, "/repos/{repo_id}/rtc/calls/{call_id}/leave": { "post": { "operationId": "platform_post__repos__repo_id__rtc_calls__call_id__leave", "summary": "leave", "tags": [ "rtc" ], "parameters": [ { "name": "repo_id", "in": "path", "required": true, "schema": { "type": "string" } }, { "name": "call_id", "in": "path", "required": true, "schema": { "type": "string" } } ], "description": "Authorization and validation are enforced by the owning service.", "x-handler": "leave", "x-source-file": "crates/synckhub-server/src/routes/rtc.rs", "x-source-line": 15, "responses": { "default": { "description": "Platform error; branch on HTTP status and stable code, not the human-readable message.", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } } }, "2XX": { "description": "Successful JSON response", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/synckhub_server.routes.rtc.CallDetail" } } } } }, "requestBody": { "required": true, "content": { "application/json": { "schema": { "$ref": "#/components/schemas/synckhub_server.routes.rtc.CommandRequest" } } } } } }, "/repos/{repo_id}/rtc/calls/{call_id}/signal": { "get": { "operationId": "platform_get__repos__repo_id__rtc_calls__call_id__signal", "summary": "signal", "tags": [ "rtc" ], "parameters": [ { "name": "repo_id", "in": "path", "required": true, "schema": { "type": "string" } }, { "name": "call_id", "in": "path", "required": true, "schema": { "type": "string" } } ], "description": "Authorization and validation are enforced by the owning service.\n\nThis route does not require the normal user bearer session. Link/download tokens, OAuth state, or webhook verification are validated by its handler where applicable.", "x-handler": "super::rtc_signaling::signal", "x-source-file": "crates/synckhub-server/src/routes/rtc.rs", "x-source-line": 15, "responses": { "default": { "description": "Service response. Error status and envelope depend on the operation." } }, "security": [] }, "head": { "operationId": "platform_head__repos__repo_id__rtc_calls__call_id__signal", "summary": "signal", "tags": [ "rtc" ], "parameters": [ { "name": "repo_id", "in": "path", "required": true, "schema": { "type": "string" } }, { "name": "call_id", "in": "path", "required": true, "schema": { "type": "string" } } ], "description": "Authorization and validation are enforced by the owning service.\n\nHEAD uses the GET handler and headers without a response body.", "x-handler": "super::rtc_signaling::signal", "x-source-file": "crates/synckhub-server/src/routes/rtc.rs", "x-source-line": 15, "x-implicit-head": true, "responses": { "default": { "description": "Service response. Error status and envelope depend on the operation." } } } }, "/repos/{repo_id}/rtc/capabilities": { "get": { "operationId": "platform_get__repos__repo_id__rtc_capabilities", "summary": "capabilities", "tags": [ "rtc" ], "parameters": [ { "name": "repo_id", "in": "path", "required": true, "schema": { "type": "string" } } ], "description": "Authorization and validation are enforced by the owning service.", "x-handler": "capabilities", "x-source-file": "crates/synckhub-server/src/routes/rtc.rs", "x-source-line": 15, "responses": { "default": { "description": "Platform error; branch on HTTP status and stable code, not the human-readable message.", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } } }, "2XX": { "description": "Successful JSON response", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/synckhub_server.routes.rtc.Capabilities" } } } } } }, "head": { "operationId": "platform_head__repos__repo_id__rtc_capabilities", "summary": "capabilities", "tags": [ "rtc" ], "parameters": [ { "name": "repo_id", "in": "path", "required": true, "schema": { "type": "string" } } ], "description": "Authorization and validation are enforced by the owning service.\n\nHEAD uses the GET handler and headers without a response body.", "x-handler": "capabilities", "x-source-file": "crates/synckhub-server/src/routes/rtc.rs", "x-source-line": 15, "x-implicit-head": true, "responses": { "default": { "description": "Platform error; branch on HTTP status and stable code, not the human-readable message." } } } }, "/repos/{repo_id}/rtc/livekit/calls": { "get": { "operationId": "platform_get__repos__repo_id__rtc_livekit_calls", "summary": "list calls", "tags": [ "livekit" ], "parameters": [ { "name": "repo_id", "in": "path", "required": true, "schema": { "type": "string" } }, { "name": "filter", "in": "query", "required": false, "schema": { "$ref": "#/components/schemas/synckhub_server.routes.livekit.history.Filter" } }, { "name": "limit", "in": "query", "required": false, "schema": { "anyOf": [ { "type": "integer", "minimum": 0 }, { "type": "null" } ] } }, { "name": "cursor", "in": "query", "required": false, "schema": { "anyOf": [ { "type": "string" }, { "type": "null" } ] } } ], "description": "Authorization and validation are enforced by the owning service.", "x-handler": "history::list_calls", "x-source-file": "crates/synckhub-server/src/routes/livekit.rs", "x-source-line": 29, "responses": { "default": { "description": "Platform error; branch on HTTP status and stable code, not the human-readable message.", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } } }, "2XX": { "description": "Successful JSON response", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/synckhub_server.routes.livekit.history.HistoryResponse" } } } } } }, "head": { "operationId": "platform_head__repos__repo_id__rtc_livekit_calls", "summary": "list calls", "tags": [ "livekit" ], "parameters": [ { "name": "repo_id", "in": "path", "required": true, "schema": { "type": "string" } }, { "name": "filter", "in": "query", "required": false, "schema": { "$ref": "#/components/schemas/synckhub_server.routes.livekit.history.Filter" } }, { "name": "limit", "in": "query", "required": false, "schema": { "anyOf": [ { "type": "integer", "minimum": 0 }, { "type": "null" } ] } }, { "name": "cursor", "in": "query", "required": false, "schema": { "anyOf": [ { "type": "string" }, { "type": "null" } ] } } ], "description": "Authorization and validation are enforced by the owning service.\n\nHEAD uses the GET handler and headers without a response body.", "x-handler": "history::list_calls", "x-source-file": "crates/synckhub-server/src/routes/livekit.rs", "x-source-line": 29, "x-implicit-head": true, "responses": { "default": { "description": "Platform error; branch on HTTP status and stable code, not the human-readable message." } } } }, "/repos/{repo_id}/rtc/livekit/calls/{call_id}": { "get": { "operationId": "platform_get__repos__repo_id__rtc_livekit_calls__call_id_", "summary": "detail", "tags": [ "livekit" ], "parameters": [ { "name": "repo_id", "in": "path", "required": true, "schema": { "type": "string" } }, { "name": "call_id", "in": "path", "required": true, "schema": { "type": "string" } } ], "description": "Authorization and validation are enforced by the owning service.", "x-handler": "call_items::detail", "x-source-file": "crates/synckhub-server/src/routes/livekit.rs", "x-source-line": 29, "responses": { "default": { "description": "Platform error; branch on HTTP status and stable code, not the human-readable message.", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } } }, "2XX": { "description": "Successful JSON response", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/synckhub_server.routes.livekit.call_items.Detail" } } } } } }, "head": { "operationId": "platform_head__repos__repo_id__rtc_livekit_calls__call_id_", "summary": "detail", "tags": [ "livekit" ], "parameters": [ { "name": "repo_id", "in": "path", "required": true, "schema": { "type": "string" } }, { "name": "call_id", "in": "path", "required": true, "schema": { "type": "string" } } ], "description": "Authorization and validation are enforced by the owning service.\n\nHEAD uses the GET handler and headers without a response body.", "x-handler": "call_items::detail", "x-source-file": "crates/synckhub-server/src/routes/livekit.rs", "x-source-line": 29, "x-implicit-head": true, "responses": { "default": { "description": "Platform error; branch on HTTP status and stable code, not the human-readable message." } } } }, "/repos/{repo_id}/rtc/livekit/recipients": { "get": { "operationId": "platform_get__repos__repo_id__rtc_livekit_recipients", "summary": "search", "tags": [ "livekit" ], "parameters": [ { "name": "repo_id", "in": "path", "required": true, "schema": { "type": "string" } }, { "name": "q", "in": "query", "required": true, "schema": { "type": "string" } }, { "name": "after", "in": "query", "required": false, "schema": { "anyOf": [ { "type": "string" }, { "type": "null" } ] } } ], "description": "Authorization and validation are enforced by the owning service.", "x-handler": "recipients::search", "x-source-file": "crates/synckhub-server/src/routes/livekit.rs", "x-source-line": 29, "responses": { "default": { "description": "Platform error; branch on HTTP status and stable code, not the human-readable message.", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } } }, "2XX": { "description": "Successful JSON response", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/synckhub_server.routes.livekit.recipients.Recipients" } } } } } }, "head": { "operationId": "platform_head__repos__repo_id__rtc_livekit_recipients", "summary": "search", "tags": [ "livekit" ], "parameters": [ { "name": "repo_id", "in": "path", "required": true, "schema": { "type": "string" } }, { "name": "q", "in": "query", "required": true, "schema": { "type": "string" } }, { "name": "after", "in": "query", "required": false, "schema": { "anyOf": [ { "type": "string" }, { "type": "null" } ] } } ], "description": "Authorization and validation are enforced by the owning service.\n\nHEAD uses the GET handler and headers without a response body.", "x-handler": "recipients::search", "x-source-file": "crates/synckhub-server/src/routes/livekit.rs", "x-source-line": 29, "x-implicit-head": true, "responses": { "default": { "description": "Platform error; branch on HTTP status and stable code, not the human-readable message." } } } }, "/repos/{repo_id}/rtc/livekit/recipients/{user_id}/chat": { "post": { "operationId": "platform_post__repos__repo_id__rtc_livekit_recipients__user_id__chat", "summary": "prepare", "tags": [ "livekit" ], "parameters": [ { "name": "repo_id", "in": "path", "required": true, "schema": { "type": "string" } }, { "name": "user_id", "in": "path", "required": true, "schema": { "type": "string" } } ], "description": "Authorization and validation are enforced by the owning service.", "x-handler": "recipients::prepare", "x-source-file": "crates/synckhub-server/src/routes/livekit.rs", "x-source-line": 29, "responses": { "default": { "description": "Platform error; branch on HTTP status and stable code, not the human-readable message.", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } } }, "2XX": { "description": "Successful JSON response", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/synckhub_server.routes.chat.rooms.ChatListEntry" } } } } } } }, "/repos/{repo_id}/rtc/recipients": { "get": { "operationId": "platform_get__repos__repo_id__rtc_recipients", "summary": "search", "tags": [ "rtc" ], "parameters": [ { "name": "repo_id", "in": "path", "required": true, "schema": { "type": "string" } }, { "name": "q", "in": "query", "required": true, "schema": { "type": "string" } }, { "name": "after", "in": "query", "required": false, "schema": { "anyOf": [ { "type": "string" }, { "type": "null" } ] } } ], "description": "Authorization and validation are enforced by the owning service.", "x-handler": "super::livekit::recipients::search", "x-source-file": "crates/synckhub-server/src/routes/rtc.rs", "x-source-line": 15, "responses": { "default": { "description": "Platform error; branch on HTTP status and stable code, not the human-readable message.", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } } }, "2XX": { "description": "Successful JSON response", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/synckhub_server.routes.livekit.recipients.Recipients" } } } } } }, "head": { "operationId": "platform_head__repos__repo_id__rtc_recipients", "summary": "search", "tags": [ "rtc" ], "parameters": [ { "name": "repo_id", "in": "path", "required": true, "schema": { "type": "string" } }, { "name": "q", "in": "query", "required": true, "schema": { "type": "string" } }, { "name": "after", "in": "query", "required": false, "schema": { "anyOf": [ { "type": "string" }, { "type": "null" } ] } } ], "description": "Authorization and validation are enforced by the owning service.\n\nHEAD uses the GET handler and headers without a response body.", "x-handler": "super::livekit::recipients::search", "x-source-file": "crates/synckhub-server/src/routes/rtc.rs", "x-source-line": 15, "x-implicit-head": true, "responses": { "default": { "description": "Platform error; branch on HTTP status and stable code, not the human-readable message." } } } }, "/repos/{repo_id}/rtc/recipients/{user_id}/chat": { "post": { "operationId": "platform_post__repos__repo_id__rtc_recipients__user_id__chat", "summary": "prepare", "tags": [ "rtc" ], "parameters": [ { "name": "repo_id", "in": "path", "required": true, "schema": { "type": "string" } }, { "name": "user_id", "in": "path", "required": true, "schema": { "type": "string" } } ], "description": "Authorization and validation are enforced by the owning service.", "x-handler": "super::livekit::recipients::prepare", "x-source-file": "crates/synckhub-server/src/routes/rtc.rs", "x-source-line": 15, "responses": { "default": { "description": "Platform error; branch on HTTP status and stable code, not the human-readable message.", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } } }, "2XX": { "description": "Successful JSON response", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/synckhub_server.routes.chat.rooms.ChatListEntry" } } } } } } }, "/repos/{repo_id}/service-tokens": { "post": { "operationId": "platform_post__repos__repo_id__service_tokens", "summary": "create repo service token", "tags": [ "ai · indexing" ], "parameters": [ { "name": "repo_id", "in": "path", "required": true, "schema": { "type": "string" } } ], "description": "Authorization and validation are enforced by the owning service.", "x-handler": "create_repo_service_token", "x-source-file": "crates/synckhub-server/src/routes/ai/indexing.rs", "x-source-line": 7, "responses": { "default": { "description": "Platform error; branch on HTTP status and stable code, not the human-readable message.", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } } }, "2XX": { "description": "Successful JSON response", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/synckhub_server.routes.ai.indexing.CreateRepoServiceTokenResponse" } } } } }, "requestBody": { "required": true, "content": { "application/json": { "schema": { "$ref": "#/components/schemas/synckhub_server.routes.ai.indexing.CreateRepoServiceTokenRequest" } } } } }, "get": { "operationId": "platform_get__repos__repo_id__service_tokens", "summary": "list repo service tokens", "tags": [ "ai · indexing" ], "parameters": [ { "name": "repo_id", "in": "path", "required": true, "schema": { "type": "string" } } ], "description": "Authorization and validation are enforced by the owning service.", "x-handler": "list_repo_service_tokens", "x-source-file": "crates/synckhub-server/src/routes/ai/indexing.rs", "x-source-line": 7, "responses": { "default": { "description": "Platform error; branch on HTTP status and stable code, not the human-readable message.", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } } }, "2XX": { "description": "Successful JSON response", "content": { "application/json": { "schema": { "type": "array", "items": { "$ref": "#/components/schemas/synckhub_server.routes.ai.indexing.RepoServiceTokenInfoResponse" } } } } } } }, "head": { "operationId": "platform_head__repos__repo_id__service_tokens", "summary": "list repo service tokens", "tags": [ "ai · indexing" ], "parameters": [ { "name": "repo_id", "in": "path", "required": true, "schema": { "type": "string" } } ], "description": "Authorization and validation are enforced by the owning service.\n\nHEAD uses the GET handler and headers without a response body.", "x-handler": "list_repo_service_tokens", "x-source-file": "crates/synckhub-server/src/routes/ai/indexing.rs", "x-source-line": 7, "x-implicit-head": true, "responses": { "default": { "description": "Platform error; branch on HTTP status and stable code, not the human-readable message." } } } }, "/repos/{repo_id}/service-tokens/{token_id}/revoke": { "post": { "operationId": "platform_post__repos__repo_id__service_tokens__token_id__revoke", "summary": "revoke repo service token", "tags": [ "ai · indexing" ], "parameters": [ { "name": "repo_id", "in": "path", "required": true, "schema": { "type": "string" } }, { "name": "token_id", "in": "path", "required": true, "schema": { "type": "string" } } ], "description": "Authorization and validation are enforced by the owning service.", "x-handler": "revoke_repo_service_token", "x-source-file": "crates/synckhub-server/src/routes/ai/indexing.rs", "x-source-line": 7, "responses": { "default": { "description": "Platform error; branch on HTTP status and stable code, not the human-readable message.", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } } }, "2XX": { "description": "Successful JSON response", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/synckhub_server.routes.ai.indexing.RevokeRepoServiceTokenResponse" } } } } } } }, "/repos/{repo_id}/settings": { "patch": { "operationId": "platform_patch__repos__repo_id__settings", "summary": "patch repo settings", "tags": [ "repo_settings" ], "parameters": [ { "name": "repo_id", "in": "path", "required": true, "schema": { "type": "string" } } ], "description": "Authorization and validation are enforced by the owning service.", "x-handler": "patch_repo_settings", "x-source-file": "crates/synckhub-server/src/routes/repo_settings.rs", "x-source-line": 9, "responses": { "default": { "description": "Platform error; branch on HTTP status and stable code, not the human-readable message.", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } } }, "2XX": { "description": "Successful JSON response", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/synckhub_server.routes.repo_settings.RepoSettingsResponse" } } } } }, "requestBody": { "required": true, "content": { "application/json": { "schema": { "$ref": "#/components/schemas/synckhub_server.routes.repo_settings.PatchRepoSettingsRequest" } } } } }, "get": { "operationId": "platform_get__repos__repo_id__settings", "summary": "get repo settings", "tags": [ "repo_settings" ], "parameters": [ { "name": "repo_id", "in": "path", "required": true, "schema": { "type": "string" } } ], "description": "Authorization and validation are enforced by the owning service.", "x-handler": "get_repo_settings", "x-source-file": "crates/synckhub-server/src/routes/repo_settings.rs", "x-source-line": 9, "responses": { "default": { "description": "Platform error; branch on HTTP status and stable code, not the human-readable message.", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } } }, "2XX": { "description": "Successful JSON response", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/synckhub_server.routes.repo_settings.RepoSettingsResponse" } } } } } }, "head": { "operationId": "platform_head__repos__repo_id__settings", "summary": "get repo settings", "tags": [ "repo_settings" ], "parameters": [ { "name": "repo_id", "in": "path", "required": true, "schema": { "type": "string" } } ], "description": "Authorization and validation are enforced by the owning service.\n\nHEAD uses the GET handler and headers without a response body.", "x-handler": "get_repo_settings", "x-source-file": "crates/synckhub-server/src/routes/repo_settings.rs", "x-source-line": 9, "x-implicit-head": true, "responses": { "default": { "description": "Platform error; branch on HTTP status and stable code, not the human-readable message." } } } }, "/repos/{repo_id}/shared-file-collections": { "post": { "operationId": "platform_post__repos__repo_id__shared_file_collections", "summary": "create", "tags": [ "sharing" ], "parameters": [ { "name": "repo_id", "in": "path", "required": true, "schema": { "type": "string" } } ], "description": "Authorization and validation are enforced by the owning service.", "x-handler": "crate::shared_file_collections::create", "x-source-file": "crates/synckhub-server/src/routes/sharing.rs", "x-source-line": 7, "responses": { "default": { "description": "Platform error; branch on HTTP status and stable code, not the human-readable message.", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } } }, "2XX": { "description": "Successful JSON response", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/synckhub_server.shared_file_collections.CollectionSummary" } } } } }, "requestBody": { "required": true, "content": { "application/json": { "schema": { "$ref": "#/components/schemas/synckhub_server.shared_file_collections.CreateRequest" } } } } }, "get": { "operationId": "platform_get__repos__repo_id__shared_file_collections", "summary": "list", "tags": [ "sharing" ], "parameters": [ { "name": "repo_id", "in": "path", "required": true, "schema": { "type": "string" } }, { "name": "limit", "in": "query", "required": false, "schema": { "anyOf": [ { "type": "integer" }, { "type": "null" } ] } }, { "name": "offset", "in": "query", "required": false, "schema": { "anyOf": [ { "type": "integer" }, { "type": "null" } ] } } ], "description": "Authorization and validation are enforced by the owning service.", "x-handler": "crate::shared_file_collections::list", "x-source-file": "crates/synckhub-server/src/routes/sharing.rs", "x-source-line": 7, "responses": { "default": { "description": "Platform error; branch on HTTP status and stable code, not the human-readable message.", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } } }, "2XX": { "description": "Successful JSON response", "content": { "application/json": { "schema": { "type": "array", "items": { "$ref": "#/components/schemas/synckhub_server.shared_file_collections.CollectionSummary" } } } } } } }, "head": { "operationId": "platform_head__repos__repo_id__shared_file_collections", "summary": "list", "tags": [ "sharing" ], "parameters": [ { "name": "repo_id", "in": "path", "required": true, "schema": { "type": "string" } }, { "name": "limit", "in": "query", "required": false, "schema": { "anyOf": [ { "type": "integer" }, { "type": "null" } ] } }, { "name": "offset", "in": "query", "required": false, "schema": { "anyOf": [ { "type": "integer" }, { "type": "null" } ] } } ], "description": "Authorization and validation are enforced by the owning service.\n\nHEAD uses the GET handler and headers without a response body.", "x-handler": "crate::shared_file_collections::list", "x-source-file": "crates/synckhub-server/src/routes/sharing.rs", "x-source-line": 7, "x-implicit-head": true, "responses": { "default": { "description": "Platform error; branch on HTTP status and stable code, not the human-readable message." } } } }, "/repos/{repo_id}/shared-file-collections/{collection_id}/revoke": { "post": { "operationId": "platform_post__repos__repo_id__shared_file_collections__collection_id__revoke", "summary": "revoke", "tags": [ "sharing" ], "parameters": [ { "name": "repo_id", "in": "path", "required": true, "schema": { "type": "string" } }, { "name": "collection_id", "in": "path", "required": true, "schema": { "type": "string" } } ], "description": "Authorization and validation are enforced by the owning service.", "x-handler": "crate::shared_file_collections::revoke", "x-source-file": "crates/synckhub-server/src/routes/sharing.rs", "x-source-line": 7, "responses": { "default": { "description": "Platform error; branch on HTTP status and stable code, not the human-readable message.", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } } }, "2XX": { "description": "Successful JSON response", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/synckhub_server.shared_file_collections.OkResponse" } } } } } } }, "/repos/{repo_id}/shared-file-links": { "get": { "operationId": "platform_get__repos__repo_id__shared_file_links", "summary": "list shared file links", "tags": [ "sharing" ], "parameters": [ { "name": "repo_id", "in": "path", "required": true, "schema": { "type": "string" } }, { "name": "file_id", "in": "query", "required": false, "schema": { "anyOf": [ { "type": "string" }, { "type": "null" } ] } }, { "name": "include_inactive", "in": "query", "required": false, "schema": { "anyOf": [ { "type": "boolean" }, { "type": "null" } ] } }, { "name": "limit", "in": "query", "required": false, "schema": { "anyOf": [ { "type": "integer", "minimum": 0 }, { "type": "null" } ] } }, { "name": "offset", "in": "query", "required": false, "schema": { "anyOf": [ { "type": "integer", "minimum": 0 }, { "type": "null" } ] } } ], "description": "Authorization and validation are enforced by the owning service.", "x-handler": "crate::shared_file_links::list_shared_file_links", "x-source-file": "crates/synckhub-server/src/routes/sharing.rs", "x-source-line": 7, "responses": { "default": { "description": "Platform error; branch on HTTP status and stable code, not the human-readable message.", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } } }, "2XX": { "description": "Successful JSON response", "content": { "application/json": { "schema": { "type": "array", "items": { "$ref": "#/components/schemas/synckhub_server.shared_file_links.SharedFileLinkListItem" } } } } } } }, "head": { "operationId": "platform_head__repos__repo_id__shared_file_links", "summary": "list shared file links", "tags": [ "sharing" ], "parameters": [ { "name": "repo_id", "in": "path", "required": true, "schema": { "type": "string" } }, { "name": "file_id", "in": "query", "required": false, "schema": { "anyOf": [ { "type": "string" }, { "type": "null" } ] } }, { "name": "include_inactive", "in": "query", "required": false, "schema": { "anyOf": [ { "type": "boolean" }, { "type": "null" } ] } }, { "name": "limit", "in": "query", "required": false, "schema": { "anyOf": [ { "type": "integer", "minimum": 0 }, { "type": "null" } ] } }, { "name": "offset", "in": "query", "required": false, "schema": { "anyOf": [ { "type": "integer", "minimum": 0 }, { "type": "null" } ] } } ], "description": "Authorization and validation are enforced by the owning service.\n\nHEAD uses the GET handler and headers without a response body.", "x-handler": "crate::shared_file_links::list_shared_file_links", "x-source-file": "crates/synckhub-server/src/routes/sharing.rs", "x-source-line": 7, "x-implicit-head": true, "responses": { "default": { "description": "Platform error; branch on HTTP status and stable code, not the human-readable message." } } } }, "/repos/{repo_id}/shared-file-links/{shared_file_link_id}/revoke": { "post": { "operationId": "platform_post__repos__repo_id__shared_file_links__shared_file_link_id__revoke", "summary": "revoke shared file link", "tags": [ "sharing" ], "parameters": [ { "name": "repo_id", "in": "path", "required": true, "schema": { "type": "string" } }, { "name": "shared_file_link_id", "in": "path", "required": true, "schema": { "type": "string" } } ], "description": "Authorization and validation are enforced by the owning service.", "x-handler": "crate::shared_file_links::revoke_shared_file_link", "x-source-file": "crates/synckhub-server/src/routes/sharing.rs", "x-source-line": 7, "responses": { "default": { "description": "Platform error; branch on HTTP status and stable code, not the human-readable message.", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } } }, "2XX": { "description": "Successful JSON response", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/synckhub_server.shared_file_links.OkResponse" } } } } } } }, "/repos/{repo_id}/shared-folder-link-statistics": { "get": { "operationId": "platform_get__repos__repo_id__shared_folder_link_statistics", "summary": "list shared link statistics", "tags": [ "activity" ], "parameters": [ { "name": "repo_id", "in": "path", "required": true, "schema": { "type": "string" } }, { "name": "year", "in": "query", "required": true, "schema": { "type": "integer" } }, { "name": "after_link_id", "in": "query", "required": false, "schema": { "anyOf": [ { "type": "string", "format": "uuid" }, { "type": "null" } ] } }, { "name": "link_id", "in": "query", "required": false, "schema": { "anyOf": [ { "type": "string", "format": "uuid" }, { "type": "null" } ] } } ], "description": "Authorization and validation are enforced by the owning service.", "x-handler": "list_shared_link_statistics", "x-source-file": "crates/synckhub-server/src/routes/activity.rs", "x-source-line": 11, "responses": { "default": { "description": "Platform error; branch on HTTP status and stable code, not the human-readable message.", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } } }, "2XX": { "description": "Successful JSON response", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/synckhub_server.shared_link_statistics.UsageReport" } } } } } }, "head": { "operationId": "platform_head__repos__repo_id__shared_folder_link_statistics", "summary": "list shared link statistics", "tags": [ "activity" ], "parameters": [ { "name": "repo_id", "in": "path", "required": true, "schema": { "type": "string" } }, { "name": "year", "in": "query", "required": true, "schema": { "type": "integer" } }, { "name": "after_link_id", "in": "query", "required": false, "schema": { "anyOf": [ { "type": "string", "format": "uuid" }, { "type": "null" } ] } }, { "name": "link_id", "in": "query", "required": false, "schema": { "anyOf": [ { "type": "string", "format": "uuid" }, { "type": "null" } ] } } ], "description": "Authorization and validation are enforced by the owning service.\n\nHEAD uses the GET handler and headers without a response body.", "x-handler": "list_shared_link_statistics", "x-source-file": "crates/synckhub-server/src/routes/activity.rs", "x-source-line": 11, "x-implicit-head": true, "responses": { "default": { "description": "Platform error; branch on HTTP status and stable code, not the human-readable message." } } } }, "/repos/{repo_id}/shared-folder-links": { "post": { "operationId": "platform_post__repos__repo_id__shared_folder_links", "summary": "create shared folder link", "tags": [ "sharing" ], "parameters": [ { "name": "repo_id", "in": "path", "required": true, "schema": { "type": "string" } } ], "description": "Authorization and validation are enforced by the owning service.", "x-handler": "crate::shared_folder_links::create_shared_folder_link", "x-source-file": "crates/synckhub-server/src/routes/sharing.rs", "x-source-line": 7, "responses": { "default": { "description": "Platform error; branch on HTTP status and stable code, not the human-readable message.", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } } }, "2XX": { "description": "Successful JSON response", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/synckhub_server.shared_folder_links.SharedFolderLinkCreatedResponse" } } } } }, "requestBody": { "required": true, "content": { "application/json": { "schema": { "$ref": "#/components/schemas/synckhub_server.shared_folder_links.CreateSharedFolderLinkRequest" } } } } }, "get": { "operationId": "platform_get__repos__repo_id__shared_folder_links", "summary": "list shared folder links", "tags": [ "sharing" ], "parameters": [ { "name": "repo_id", "in": "path", "required": true, "schema": { "type": "string" } }, { "name": "root_folder_id", "in": "query", "required": false, "schema": { "anyOf": [ { "type": "string" }, { "type": "null" } ] } }, { "name": "include_inactive", "in": "query", "required": false, "schema": { "anyOf": [ { "type": "string" }, { "type": "null" } ] } }, { "name": "limit", "in": "query", "required": false, "schema": { "anyOf": [ { "type": "integer", "minimum": 0 }, { "type": "null" } ] } }, { "name": "offset", "in": "query", "required": false, "schema": { "anyOf": [ { "type": "integer", "minimum": 0 }, { "type": "null" } ] } } ], "description": "Authorization and validation are enforced by the owning service.", "x-handler": "crate::shared_folder_links::list_shared_folder_links", "x-source-file": "crates/synckhub-server/src/routes/sharing.rs", "x-source-line": 7, "responses": { "default": { "description": "Platform error; branch on HTTP status and stable code, not the human-readable message.", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } } }, "2XX": { "description": "Successful JSON response", "content": { "application/json": { "schema": { "type": "array", "items": { "$ref": "#/components/schemas/synckhub_server.shared_folder_links.SharedFolderLinkSummaryResponse" } } } } } } }, "head": { "operationId": "platform_head__repos__repo_id__shared_folder_links", "summary": "list shared folder links", "tags": [ "sharing" ], "parameters": [ { "name": "repo_id", "in": "path", "required": true, "schema": { "type": "string" } }, { "name": "root_folder_id", "in": "query", "required": false, "schema": { "anyOf": [ { "type": "string" }, { "type": "null" } ] } }, { "name": "include_inactive", "in": "query", "required": false, "schema": { "anyOf": [ { "type": "string" }, { "type": "null" } ] } }, { "name": "limit", "in": "query", "required": false, "schema": { "anyOf": [ { "type": "integer", "minimum": 0 }, { "type": "null" } ] } }, { "name": "offset", "in": "query", "required": false, "schema": { "anyOf": [ { "type": "integer", "minimum": 0 }, { "type": "null" } ] } } ], "description": "Authorization and validation are enforced by the owning service.\n\nHEAD uses the GET handler and headers without a response body.", "x-handler": "crate::shared_folder_links::list_shared_folder_links", "x-source-file": "crates/synckhub-server/src/routes/sharing.rs", "x-source-line": 7, "x-implicit-head": true, "responses": { "default": { "description": "Platform error; branch on HTTP status and stable code, not the human-readable message." } } } }, "/repos/{repo_id}/shared-folder-links/{shared_folder_link_id}/public-url": { "get": { "operationId": "platform_get__repos__repo_id__shared_folder_links__shared_folder_link_id__public_url", "summary": "get shared folder link public url", "tags": [ "sharing" ], "parameters": [ { "name": "repo_id", "in": "path", "required": true, "schema": { "type": "string" } }, { "name": "shared_folder_link_id", "in": "path", "required": true, "schema": { "type": "string" } } ], "description": "Authorization and validation are enforced by the owning service.", "x-handler": "crate::shared_folder_links::get_shared_folder_link_public_url", "x-source-file": "crates/synckhub-server/src/routes/sharing.rs", "x-source-line": 7, "responses": { "default": { "description": "Platform error; branch on HTTP status and stable code, not the human-readable message.", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } } }, "2XX": { "description": "Successful JSON response", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/synckhub_server.shared_folder_links.SharedFolderLinkPublicUrlResponse" } } } } } }, "head": { "operationId": "platform_head__repos__repo_id__shared_folder_links__shared_folder_link_id__public_url", "summary": "get shared folder link public url", "tags": [ "sharing" ], "parameters": [ { "name": "repo_id", "in": "path", "required": true, "schema": { "type": "string" } }, { "name": "shared_folder_link_id", "in": "path", "required": true, "schema": { "type": "string" } } ], "description": "Authorization and validation are enforced by the owning service.\n\nHEAD uses the GET handler and headers without a response body.", "x-handler": "crate::shared_folder_links::get_shared_folder_link_public_url", "x-source-file": "crates/synckhub-server/src/routes/sharing.rs", "x-source-line": 7, "x-implicit-head": true, "responses": { "default": { "description": "Platform error; branch on HTTP status and stable code, not the human-readable message." } } } }, "/repos/{repo_id}/shared-folder-links/{shared_folder_link_id}/revoke": { "post": { "operationId": "platform_post__repos__repo_id__shared_folder_links__shared_folder_link_id__revoke", "summary": "revoke shared folder link", "tags": [ "sharing" ], "parameters": [ { "name": "repo_id", "in": "path", "required": true, "schema": { "type": "string" } }, { "name": "shared_folder_link_id", "in": "path", "required": true, "schema": { "type": "string" } } ], "description": "Authorization and validation are enforced by the owning service.", "x-handler": "crate::shared_folder_links::revoke_shared_folder_link", "x-source-file": "crates/synckhub-server/src/routes/sharing.rs", "x-source-line": 7, "responses": { "default": { "description": "Platform error; branch on HTTP status and stable code, not the human-readable message.", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } } }, "2XX": { "description": "Successful JSON response", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/synckhub_server.shared_folder_links.OkResponse" } } } } } } }, "/repos/{repo_id}/storage-measurement": { "post": { "operationId": "platform_post__repos__repo_id__storage_measurement", "summary": "advance", "tags": [ "repository_storage" ], "parameters": [ { "name": "repo_id", "in": "path", "required": true, "schema": { "type": "string" } } ], "description": "Authorization and validation are enforced by the owning service.", "x-handler": "advance", "x-source-file": "crates/synckhub-server/src/routes/repository_storage.rs", "x-source-line": 59, "responses": { "default": { "description": "Platform error; branch on HTTP status and stable code, not the human-readable message.", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } } } }, "requestBody": { "required": true, "content": { "application/json": { "schema": { "$ref": "#/components/schemas/synckhub_server.routes.repository_storage.Request" } } } } }, "get": { "operationId": "platform_get__repos__repo_id__storage_measurement", "summary": "read", "tags": [ "repository_storage" ], "parameters": [ { "name": "repo_id", "in": "path", "required": true, "schema": { "type": "string" } } ], "description": "Authorization and validation are enforced by the owning service.", "x-handler": "read", "x-source-file": "crates/synckhub-server/src/routes/repository_storage.rs", "x-source-line": 59, "responses": { "default": { "description": "Platform error; branch on HTTP status and stable code, not the human-readable message.", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } } } } }, "head": { "operationId": "platform_head__repos__repo_id__storage_measurement", "summary": "read", "tags": [ "repository_storage" ], "parameters": [ { "name": "repo_id", "in": "path", "required": true, "schema": { "type": "string" } } ], "description": "Authorization and validation are enforced by the owning service.\n\nHEAD uses the GET handler and headers without a response body.", "x-handler": "read", "x-source-file": "crates/synckhub-server/src/routes/repository_storage.rs", "x-source-line": 59, "x-implicit-head": true, "responses": { "default": { "description": "Platform error; branch on HTTP status and stable code, not the human-readable message." } } } }, "/repos/{repo_id}/task-lists/relevant": { "get": { "operationId": "platform_get__repos__repo_id__task_lists_relevant", "summary": "get relevant task lists", "tags": [ "tasks · lists" ], "parameters": [ { "name": "repo_id", "in": "path", "required": true, "schema": { "type": "string" } }, { "name": "include", "in": "query", "required": false, "schema": { "anyOf": [ { "type": "string" }, { "type": "null" } ] } }, { "name": "limit", "in": "query", "required": false, "schema": { "anyOf": [ { "type": "integer", "minimum": 0 }, { "type": "null" } ] } }, { "name": "offset", "in": "query", "required": false, "schema": { "anyOf": [ { "type": "integer", "minimum": 0 }, { "type": "null" } ] } }, { "name": "scope", "in": "query", "required": false, "schema": { "anyOf": [ { "type": "string" }, { "type": "null" } ] } }, { "name": "status_scope", "in": "query", "required": false, "schema": { "anyOf": [ { "type": "string" }, { "type": "null" } ] } }, { "name": "relationships", "in": "query", "required": false, "schema": { "anyOf": [ { "type": "string" }, { "type": "null" } ] } }, { "name": "statuses", "in": "query", "required": false, "schema": { "anyOf": [ { "type": "string" }, { "type": "null" } ] } }, { "name": "purpose", "in": "query", "required": false, "schema": { "anyOf": [ { "type": "string" }, { "type": "null" } ] } }, { "name": "search", "in": "query", "required": false, "schema": { "anyOf": [ { "type": "string" }, { "type": "null" } ] } } ], "description": "Authorization and validation are enforced by the owning service.", "x-handler": "get_relevant_task_lists", "x-source-file": "crates/synckhub-server/src/routes/tasks/lists.rs", "x-source-line": 9, "responses": { "default": { "description": "Platform error; branch on HTTP status and stable code, not the human-readable message.", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } } }, "2XX": { "description": "Successful JSON response", "content": { "application/json": { "schema": {} } } } } }, "head": { "operationId": "platform_head__repos__repo_id__task_lists_relevant", "summary": "get relevant task lists", "tags": [ "tasks · lists" ], "parameters": [ { "name": "repo_id", "in": "path", "required": true, "schema": { "type": "string" } }, { "name": "include", "in": "query", "required": false, "schema": { "anyOf": [ { "type": "string" }, { "type": "null" } ] } }, { "name": "limit", "in": "query", "required": false, "schema": { "anyOf": [ { "type": "integer", "minimum": 0 }, { "type": "null" } ] } }, { "name": "offset", "in": "query", "required": false, "schema": { "anyOf": [ { "type": "integer", "minimum": 0 }, { "type": "null" } ] } }, { "name": "scope", "in": "query", "required": false, "schema": { "anyOf": [ { "type": "string" }, { "type": "null" } ] } }, { "name": "status_scope", "in": "query", "required": false, "schema": { "anyOf": [ { "type": "string" }, { "type": "null" } ] } }, { "name": "relationships", "in": "query", "required": false, "schema": { "anyOf": [ { "type": "string" }, { "type": "null" } ] } }, { "name": "statuses", "in": "query", "required": false, "schema": { "anyOf": [ { "type": "string" }, { "type": "null" } ] } }, { "name": "purpose", "in": "query", "required": false, "schema": { "anyOf": [ { "type": "string" }, { "type": "null" } ] } }, { "name": "search", "in": "query", "required": false, "schema": { "anyOf": [ { "type": "string" }, { "type": "null" } ] } } ], "description": "Authorization and validation are enforced by the owning service.\n\nHEAD uses the GET handler and headers without a response body.", "x-handler": "get_relevant_task_lists", "x-source-file": "crates/synckhub-server/src/routes/tasks/lists.rs", "x-source-line": 9, "x-implicit-head": true, "responses": { "default": { "description": "Platform error; branch on HTTP status and stable code, not the human-readable message." } } } }, "/repos/{repo_id}/tasks": { "get": { "operationId": "platform_get__repos__repo_id__tasks", "summary": "get collection", "tags": [ "tasks · collections" ], "parameters": [ { "name": "repo_id", "in": "path", "required": true, "schema": { "type": "string" } }, { "name": "scope", "in": "query", "required": true, "schema": { "$ref": "#/components/schemas/synckhub_server.routes.tasks.collections.Scope" } }, { "name": "task_list_id", "in": "query", "required": false, "schema": { "anyOf": [ { "type": "string" }, { "type": "null" } ] } }, { "name": "root_task_id", "in": "query", "required": false, "schema": { "anyOf": [ { "type": "string" }, { "type": "null" } ] } }, { "name": "status", "in": "query", "required": false, "schema": { "anyOf": [ { "type": "string" }, { "type": "null" } ] } }, { "name": "priority", "in": "query", "required": false, "schema": { "anyOf": [ { "type": "string" }, { "type": "null" } ] } }, { "name": "name_q", "in": "query", "required": false, "schema": { "anyOf": [ { "type": "string" }, { "type": "null" } ] } }, { "name": "has_attachments", "in": "query", "required": false, "schema": { "anyOf": [ { "type": "boolean" }, { "type": "null" } ] } }, { "name": "unreviewed", "in": "query", "required": false, "schema": { "anyOf": [ { "type": "boolean" }, { "type": "null" } ] } }, { "name": "sort", "in": "query", "required": false, "schema": { "anyOf": [ { "$ref": "#/components/schemas/synckhub_server.routes.tasks.collections.Sort" }, { "type": "null" } ] } }, { "name": "order", "in": "query", "required": false, "schema": { "anyOf": [ { "$ref": "#/components/schemas/synckhub_server.routes.tasks.collections.SortOrder" }, { "type": "null" } ] } }, { "name": "include_read", "in": "query", "required": false, "schema": { "type": "boolean" } }, { "name": "limit", "in": "query", "required": false, "schema": { "anyOf": [ { "type": "integer", "minimum": 0 }, { "type": "null" } ] } }, { "name": "after", "in": "query", "required": false, "schema": { "anyOf": [ { "type": "string" }, { "type": "null" } ] } } ], "description": "Authorization and validation are enforced by the owning service.", "x-handler": "get_collection", "x-source-file": "crates/synckhub-server/src/routes/tasks/collections.rs", "x-source-line": 210, "responses": { "default": { "description": "Platform error; branch on HTTP status and stable code, not the human-readable message.", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } } } } }, "head": { "operationId": "platform_head__repos__repo_id__tasks", "summary": "get collection", "tags": [ "tasks · collections" ], "parameters": [ { "name": "repo_id", "in": "path", "required": true, "schema": { "type": "string" } }, { "name": "scope", "in": "query", "required": true, "schema": { "$ref": "#/components/schemas/synckhub_server.routes.tasks.collections.Scope" } }, { "name": "task_list_id", "in": "query", "required": false, "schema": { "anyOf": [ { "type": "string" }, { "type": "null" } ] } }, { "name": "root_task_id", "in": "query", "required": false, "schema": { "anyOf": [ { "type": "string" }, { "type": "null" } ] } }, { "name": "status", "in": "query", "required": false, "schema": { "anyOf": [ { "type": "string" }, { "type": "null" } ] } }, { "name": "priority", "in": "query", "required": false, "schema": { "anyOf": [ { "type": "string" }, { "type": "null" } ] } }, { "name": "name_q", "in": "query", "required": false, "schema": { "anyOf": [ { "type": "string" }, { "type": "null" } ] } }, { "name": "has_attachments", "in": "query", "required": false, "schema": { "anyOf": [ { "type": "boolean" }, { "type": "null" } ] } }, { "name": "unreviewed", "in": "query", "required": false, "schema": { "anyOf": [ { "type": "boolean" }, { "type": "null" } ] } }, { "name": "sort", "in": "query", "required": false, "schema": { "anyOf": [ { "$ref": "#/components/schemas/synckhub_server.routes.tasks.collections.Sort" }, { "type": "null" } ] } }, { "name": "order", "in": "query", "required": false, "schema": { "anyOf": [ { "$ref": "#/components/schemas/synckhub_server.routes.tasks.collections.SortOrder" }, { "type": "null" } ] } }, { "name": "include_read", "in": "query", "required": false, "schema": { "type": "boolean" } }, { "name": "limit", "in": "query", "required": false, "schema": { "anyOf": [ { "type": "integer", "minimum": 0 }, { "type": "null" } ] } }, { "name": "after", "in": "query", "required": false, "schema": { "anyOf": [ { "type": "string" }, { "type": "null" } ] } } ], "description": "Authorization and validation are enforced by the owning service.\n\nHEAD uses the GET handler and headers without a response body.", "x-handler": "get_collection", "x-source-file": "crates/synckhub-server/src/routes/tasks/collections.rs", "x-source-line": 210, "x-implicit-head": true, "responses": { "default": { "description": "Platform error; branch on HTTP status and stable code, not the human-readable message." } } } }, "/repos/{repo_id}/tasks/{task_id}": { "get": { "operationId": "platform_get__repos__repo_id__tasks__task_id_", "summary": "get task", "tags": [ "tasks · records" ], "parameters": [ { "name": "repo_id", "in": "path", "required": true, "schema": { "type": "string" } }, { "name": "task_id", "in": "path", "required": true, "schema": { "type": "string" } } ], "description": "Authorization and validation are enforced by the owning service.", "x-handler": "get_task", "x-source-file": "crates/synckhub-server/src/routes/tasks/records.rs", "x-source-line": 332, "responses": { "default": { "description": "Platform error; branch on HTTP status and stable code, not the human-readable message.", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } } } } }, "head": { "operationId": "platform_head__repos__repo_id__tasks__task_id_", "summary": "get task", "tags": [ "tasks · records" ], "parameters": [ { "name": "repo_id", "in": "path", "required": true, "schema": { "type": "string" } }, { "name": "task_id", "in": "path", "required": true, "schema": { "type": "string" } } ], "description": "Authorization and validation are enforced by the owning service.\n\nHEAD uses the GET handler and headers without a response body.", "x-handler": "get_task", "x-source-file": "crates/synckhub-server/src/routes/tasks/records.rs", "x-source-line": 332, "x-implicit-head": true, "responses": { "default": { "description": "Platform error; branch on HTTP status and stable code, not the human-readable message." } } } }, "/repos/{repo_id}/tasks/{task_id}/activity": { "get": { "operationId": "platform_get__repos__repo_id__tasks__task_id__activity", "summary": "get", "tags": [ "tasks · records" ], "parameters": [ { "name": "repo_id", "in": "path", "required": true, "schema": { "type": "string" } }, { "name": "task_id", "in": "path", "required": true, "schema": { "type": "string" } }, { "name": "after", "in": "query", "required": false, "schema": { "anyOf": [ { "type": "string" }, { "type": "null" } ] } }, { "name": "limit", "in": "query", "required": false, "schema": { "anyOf": [ { "type": "integer", "minimum": 0 }, { "type": "null" } ] } }, { "name": "filter", "in": "query", "required": false, "schema": { "anyOf": [ { "$ref": "#/components/schemas/synckhub_server.routes.tasks.records.activity.Filter" }, { "type": "null" } ] } } ], "description": "Authorization and validation are enforced by the owning service.", "x-handler": "activity::get", "x-source-file": "crates/synckhub-server/src/routes/tasks/records.rs", "x-source-line": 332, "responses": { "default": { "description": "Platform error; branch on HTTP status and stable code, not the human-readable message.", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } } } } }, "head": { "operationId": "platform_head__repos__repo_id__tasks__task_id__activity", "summary": "get", "tags": [ "tasks · records" ], "parameters": [ { "name": "repo_id", "in": "path", "required": true, "schema": { "type": "string" } }, { "name": "task_id", "in": "path", "required": true, "schema": { "type": "string" } }, { "name": "after", "in": "query", "required": false, "schema": { "anyOf": [ { "type": "string" }, { "type": "null" } ] } }, { "name": "limit", "in": "query", "required": false, "schema": { "anyOf": [ { "type": "integer", "minimum": 0 }, { "type": "null" } ] } }, { "name": "filter", "in": "query", "required": false, "schema": { "anyOf": [ { "$ref": "#/components/schemas/synckhub_server.routes.tasks.records.activity.Filter" }, { "type": "null" } ] } } ], "description": "Authorization and validation are enforced by the owning service.\n\nHEAD uses the GET handler and headers without a response body.", "x-handler": "activity::get", "x-source-file": "crates/synckhub-server/src/routes/tasks/records.rs", "x-source-line": 332, "x-implicit-head": true, "responses": { "default": { "description": "Platform error; branch on HTTP status and stable code, not the human-readable message." } } } }, "/repos/{repo_id}/tasks/{task_id}/comments": { "get": { "operationId": "platform_get__repos__repo_id__tasks__task_id__comments", "summary": "get comments", "tags": [ "tasks · records" ], "parameters": [ { "name": "repo_id", "in": "path", "required": true, "schema": { "type": "string" } }, { "name": "task_id", "in": "path", "required": true, "schema": { "type": "string" } }, { "name": "after", "in": "query", "required": false, "schema": { "anyOf": [ { "type": "string" }, { "type": "null" } ] } }, { "name": "limit", "in": "query", "required": false, "schema": { "anyOf": [ { "type": "integer", "minimum": 0 }, { "type": "null" } ] } } ], "description": "Authorization and validation are enforced by the owning service.", "x-handler": "get_comments", "x-source-file": "crates/synckhub-server/src/routes/tasks/records.rs", "x-source-line": 332, "responses": { "default": { "description": "Platform error; branch on HTTP status and stable code, not the human-readable message.", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } } } } }, "head": { "operationId": "platform_head__repos__repo_id__tasks__task_id__comments", "summary": "get comments", "tags": [ "tasks · records" ], "parameters": [ { "name": "repo_id", "in": "path", "required": true, "schema": { "type": "string" } }, { "name": "task_id", "in": "path", "required": true, "schema": { "type": "string" } }, { "name": "after", "in": "query", "required": false, "schema": { "anyOf": [ { "type": "string" }, { "type": "null" } ] } }, { "name": "limit", "in": "query", "required": false, "schema": { "anyOf": [ { "type": "integer", "minimum": 0 }, { "type": "null" } ] } } ], "description": "Authorization and validation are enforced by the owning service.\n\nHEAD uses the GET handler and headers without a response body.", "x-handler": "get_comments", "x-source-file": "crates/synckhub-server/src/routes/tasks/records.rs", "x-source-line": 332, "x-implicit-head": true, "responses": { "default": { "description": "Platform error; branch on HTTP status and stable code, not the human-readable message." } } } }, "/repos/{repo_id}/tasks/{task_id}/email": { "get": { "operationId": "platform_get__repos__repo_id__tasks__task_id__email", "summary": "get source", "tags": [ "tasks · email_source" ], "parameters": [ { "name": "repo_id", "in": "path", "required": true, "schema": { "type": "string" } }, { "name": "task_id", "in": "path", "required": true, "schema": { "type": "string" } } ], "description": "Authorization and validation are enforced by the owning service.", "x-handler": "get_source", "x-source-file": "crates/synckhub-server/src/routes/tasks/email_source.rs", "x-source-line": 17, "responses": { "default": { "description": "Platform error; branch on HTTP status and stable code, not the human-readable message.", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } } } } }, "head": { "operationId": "platform_head__repos__repo_id__tasks__task_id__email", "summary": "get source", "tags": [ "tasks · email_source" ], "parameters": [ { "name": "repo_id", "in": "path", "required": true, "schema": { "type": "string" } }, { "name": "task_id", "in": "path", "required": true, "schema": { "type": "string" } } ], "description": "Authorization and validation are enforced by the owning service.\n\nHEAD uses the GET handler and headers without a response body.", "x-handler": "get_source", "x-source-file": "crates/synckhub-server/src/routes/tasks/email_source.rs", "x-source-line": 17, "x-implicit-head": true, "responses": { "default": { "description": "Platform error; branch on HTTP status and stable code, not the human-readable message." } } } }, "/repos/{repo_id}/tasks/{task_id}/email/{part}": { "get": { "operationId": "platform_get__repos__repo_id__tasks__task_id__email__part_", "summary": "get part", "tags": [ "tasks · email_source" ], "parameters": [ { "name": "repo_id", "in": "path", "required": true, "schema": { "type": "string" } }, { "name": "task_id", "in": "path", "required": true, "schema": { "type": "string" } }, { "name": "part", "in": "path", "required": true, "schema": { "type": "string" } } ], "description": "Authorization and validation are enforced by the owning service.", "x-handler": "get_part", "x-source-file": "crates/synckhub-server/src/routes/tasks/email_source.rs", "x-source-line": 17, "responses": { "default": { "description": "Platform error; branch on HTTP status and stable code, not the human-readable message.", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } } } } }, "head": { "operationId": "platform_head__repos__repo_id__tasks__task_id__email__part_", "summary": "get part", "tags": [ "tasks · email_source" ], "parameters": [ { "name": "repo_id", "in": "path", "required": true, "schema": { "type": "string" } }, { "name": "task_id", "in": "path", "required": true, "schema": { "type": "string" } }, { "name": "part", "in": "path", "required": true, "schema": { "type": "string" } } ], "description": "Authorization and validation are enforced by the owning service.\n\nHEAD uses the GET handler and headers without a response body.", "x-handler": "get_part", "x-source-file": "crates/synckhub-server/src/routes/tasks/email_source.rs", "x-source-line": 17, "x-implicit-head": true, "responses": { "default": { "description": "Platform error; branch on HTTP status and stable code, not the human-readable message." } } } }, "/repos/{repo_id}/tasks/{task_id}/email/attachments/{attachment_id}": { "get": { "operationId": "platform_get__repos__repo_id__tasks__task_id__email_attachments__attachment_id_", "summary": "get attachment", "tags": [ "tasks · email_source" ], "parameters": [ { "name": "repo_id", "in": "path", "required": true, "schema": { "type": "string" } }, { "name": "task_id", "in": "path", "required": true, "schema": { "type": "string" } }, { "name": "attachment_id", "in": "path", "required": true, "schema": { "type": "string" } } ], "description": "Authorization and validation are enforced by the owning service.", "x-handler": "get_attachment", "x-source-file": "crates/synckhub-server/src/routes/tasks/email_source.rs", "x-source-line": 17, "responses": { "default": { "description": "Platform error; branch on HTTP status and stable code, not the human-readable message.", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } } } } }, "head": { "operationId": "platform_head__repos__repo_id__tasks__task_id__email_attachments__attachment_id_", "summary": "get attachment", "tags": [ "tasks · email_source" ], "parameters": [ { "name": "repo_id", "in": "path", "required": true, "schema": { "type": "string" } }, { "name": "task_id", "in": "path", "required": true, "schema": { "type": "string" } }, { "name": "attachment_id", "in": "path", "required": true, "schema": { "type": "string" } } ], "description": "Authorization and validation are enforced by the owning service.\n\nHEAD uses the GET handler and headers without a response body.", "x-handler": "get_attachment", "x-source-file": "crates/synckhub-server/src/routes/tasks/email_source.rs", "x-source-line": 17, "x-implicit-head": true, "responses": { "default": { "description": "Platform error; branch on HTTP status and stable code, not the human-readable message." } } } }, "/repos/{repo_id}/tasks/{task_id}/followers": { "post": { "operationId": "platform_post__repos__repo_id__tasks__task_id__followers", "summary": "follow", "tags": [ "tasks · write" ], "parameters": [ { "name": "repo_id", "in": "path", "required": true, "schema": { "type": "string" } }, { "name": "task_id", "in": "path", "required": true, "schema": { "type": "string" } } ], "description": "Authorization and validation are enforced by the owning service.", "x-handler": "follow", "x-source-file": "crates/synckhub-server/src/routes/tasks/write.rs", "x-source-line": 17, "responses": { "default": { "description": "Platform error; branch on HTTP status and stable code, not the human-readable message.", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } } } }, "requestBody": { "required": true, "content": { "application/json": { "schema": { "$ref": "#/components/schemas/synckhub_core.tasks.commands.Follow" } } } } } }, "/repos/{repo_id}/tasks/{task_id}/seen": { "post": { "operationId": "platform_post__repos__repo_id__tasks__task_id__seen", "summary": "mark seen", "tags": [ "tasks · seen" ], "parameters": [ { "name": "repo_id", "in": "path", "required": true, "schema": { "type": "string" } }, { "name": "task_id", "in": "path", "required": true, "schema": { "type": "string" } } ], "description": "Authorization and validation are enforced by the owning service.", "x-handler": "mark_seen", "x-source-file": "crates/synckhub-server/src/routes/tasks/seen.rs", "x-source-line": 266, "responses": { "default": { "description": "Platform error; branch on HTTP status and stable code, not the human-readable message.", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } } } }, "requestBody": { "required": true, "content": { "application/json": { "schema": { "$ref": "#/components/schemas/synckhub_server.routes.tasks.seen.Request" } } } } } }, "/repos/{repo_id}/tasks/attention-summary": { "get": { "operationId": "platform_get__repos__repo_id__tasks_attention_summary", "summary": "get task attention summary", "tags": [ "tasks · attention" ], "parameters": [ { "name": "repo_id", "in": "path", "required": true, "schema": { "type": "string" } } ], "description": "Authorization and validation are enforced by the owning service.", "x-handler": "get_task_attention_summary", "x-source-file": "crates/synckhub-server/src/routes/tasks/attention.rs", "x-source-line": 12, "responses": { "default": { "description": "Platform error; branch on HTTP status and stable code, not the human-readable message.", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } } }, "2XX": { "description": "Successful JSON response", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/synckhub_server.routes.tasks.attention.TaskAttentionSummaryResponse" } } } } } }, "head": { "operationId": "platform_head__repos__repo_id__tasks_attention_summary", "summary": "get task attention summary", "tags": [ "tasks · attention" ], "parameters": [ { "name": "repo_id", "in": "path", "required": true, "schema": { "type": "string" } } ], "description": "Authorization and validation are enforced by the owning service.\n\nHEAD uses the GET handler and headers without a response body.", "x-handler": "get_task_attention_summary", "x-source-file": "crates/synckhub-server/src/routes/tasks/attention.rs", "x-source-line": 12, "x-implicit-head": true, "responses": { "default": { "description": "Platform error; branch on HTTP status and stable code, not the human-readable message." } } } }, "/repos/{repo_id}/tasks/calendar": { "get": { "operationId": "platform_get__repos__repo_id__tasks_calendar", "summary": "get task calendar rows", "tags": [ "tasks · calendar" ], "parameters": [ { "name": "repo_id", "in": "path", "required": true, "schema": { "type": "string" } }, { "name": "start", "in": "query", "required": true, "schema": { "type": "string" } }, { "name": "end", "in": "query", "required": true, "schema": { "type": "string" } }, { "name": "timezone", "in": "query", "required": false, "schema": { "anyOf": [ { "type": "string" }, { "type": "null" } ] } }, { "name": "scope", "in": "query", "required": false, "schema": { "anyOf": [ { "type": "string" }, { "type": "null" } ] } }, { "name": "status_scope", "in": "query", "required": false, "schema": { "anyOf": [ { "type": "string" }, { "type": "null" } ] } }, { "name": "limit", "in": "query", "required": false, "schema": { "anyOf": [ { "type": "integer", "minimum": 0 }, { "type": "null" } ] } }, { "name": "after", "in": "query", "required": false, "schema": { "anyOf": [ { "type": "string" }, { "type": "null" } ] } } ], "description": "Authorization and validation are enforced by the owning service.", "x-handler": "get_task_calendar_rows", "x-source-file": "crates/synckhub-server/src/routes/tasks/calendar.rs", "x-source-line": 14, "responses": { "default": { "description": "Platform error; branch on HTTP status and stable code, not the human-readable message.", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } } } } }, "head": { "operationId": "platform_head__repos__repo_id__tasks_calendar", "summary": "get task calendar rows", "tags": [ "tasks · calendar" ], "parameters": [ { "name": "repo_id", "in": "path", "required": true, "schema": { "type": "string" } }, { "name": "start", "in": "query", "required": true, "schema": { "type": "string" } }, { "name": "end", "in": "query", "required": true, "schema": { "type": "string" } }, { "name": "timezone", "in": "query", "required": false, "schema": { "anyOf": [ { "type": "string" }, { "type": "null" } ] } }, { "name": "scope", "in": "query", "required": false, "schema": { "anyOf": [ { "type": "string" }, { "type": "null" } ] } }, { "name": "status_scope", "in": "query", "required": false, "schema": { "anyOf": [ { "type": "string" }, { "type": "null" } ] } }, { "name": "limit", "in": "query", "required": false, "schema": { "anyOf": [ { "type": "integer", "minimum": 0 }, { "type": "null" } ] } }, { "name": "after", "in": "query", "required": false, "schema": { "anyOf": [ { "type": "string" }, { "type": "null" } ] } } ], "description": "Authorization and validation are enforced by the owning service.\n\nHEAD uses the GET handler and headers without a response body.", "x-handler": "get_task_calendar_rows", "x-source-file": "crates/synckhub-server/src/routes/tasks/calendar.rs", "x-source-line": 14, "x-implicit-head": true, "responses": { "default": { "description": "Platform error; branch on HTTP status and stable code, not the human-readable message." } } } }, "/repos/{repo_id}/tasks/commands": { "post": { "operationId": "platform_post__repos__repo_id__tasks_commands", "summary": "execute", "tags": [ "tasks · write" ], "parameters": [ { "name": "repo_id", "in": "path", "required": true, "schema": { "type": "string" } } ], "description": "Authorization and validation are enforced by the owning service.", "x-handler": "execute", "x-source-file": "crates/synckhub-server/src/routes/tasks/write.rs", "x-source-line": 17, "responses": { "default": { "description": "Platform error; branch on HTTP status and stable code, not the human-readable message.", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } } } }, "requestBody": { "required": true, "content": { "application/json": { "schema": { "$ref": "#/components/schemas/synckhub_core.tasks.commands.Command" } } } } } }, "/repos/{repo_id}/tasks/due": { "get": { "operationId": "platform_get__repos__repo_id__tasks_due", "summary": "get due tasks", "tags": [ "tasks · attention" ], "parameters": [ { "name": "repo_id", "in": "path", "required": true, "schema": { "type": "string" } }, { "name": "scope", "in": "query", "required": false, "schema": { "anyOf": [ { "type": "string" }, { "type": "null" } ] } }, { "name": "bucket", "in": "query", "required": false, "schema": { "anyOf": [ { "type": "string" }, { "type": "null" } ] } }, { "name": "timezone", "in": "query", "required": false, "schema": { "anyOf": [ { "type": "string" }, { "type": "null" } ] } }, { "name": "limit", "in": "query", "required": false, "schema": { "anyOf": [ { "type": "integer", "minimum": 0 }, { "type": "null" } ] } }, { "name": "offset", "in": "query", "required": false, "schema": { "anyOf": [ { "type": "integer", "minimum": 0 }, { "type": "null" } ] } } ], "description": "Authorization and validation are enforced by the owning service.", "x-handler": "get_due_tasks", "x-source-file": "crates/synckhub-server/src/routes/tasks/attention.rs", "x-source-line": 12, "responses": { "default": { "description": "Platform error; branch on HTTP status and stable code, not the human-readable message.", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } } }, "2XX": { "description": "Successful JSON response", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/synckhub_server.routes.tasks.attention.DueTasksResponse" } } } } } }, "head": { "operationId": "platform_head__repos__repo_id__tasks_due", "summary": "get due tasks", "tags": [ "tasks · attention" ], "parameters": [ { "name": "repo_id", "in": "path", "required": true, "schema": { "type": "string" } }, { "name": "scope", "in": "query", "required": false, "schema": { "anyOf": [ { "type": "string" }, { "type": "null" } ] } }, { "name": "bucket", "in": "query", "required": false, "schema": { "anyOf": [ { "type": "string" }, { "type": "null" } ] } }, { "name": "timezone", "in": "query", "required": false, "schema": { "anyOf": [ { "type": "string" }, { "type": "null" } ] } }, { "name": "limit", "in": "query", "required": false, "schema": { "anyOf": [ { "type": "integer", "minimum": 0 }, { "type": "null" } ] } }, { "name": "offset", "in": "query", "required": false, "schema": { "anyOf": [ { "type": "integer", "minimum": 0 }, { "type": "null" } ] } } ], "description": "Authorization and validation are enforced by the owning service.\n\nHEAD uses the GET handler and headers without a response body.", "x-handler": "get_due_tasks", "x-source-file": "crates/synckhub-server/src/routes/tasks/attention.rs", "x-source-line": 12, "x-implicit-head": true, "responses": { "default": { "description": "Platform error; branch on HTTP status and stable code, not the human-readable message." } } } }, "/repos/{repo_id}/tasks/email-status": { "post": { "operationId": "platform_post__repos__repo_id__tasks_email_status", "summary": "get", "tags": [ "tasks · email_status" ], "parameters": [ { "name": "repo_id", "in": "path", "required": true, "schema": { "type": "string" } } ], "description": "Authorization and validation are enforced by the owning service.", "x-handler": "get", "x-source-file": "crates/synckhub-server/src/routes/tasks/email_status.rs", "x-source-line": 36, "responses": { "default": { "description": "Platform error; branch on HTTP status and stable code, not the human-readable message.", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } } } }, "requestBody": { "required": true, "content": { "application/json": { "schema": { "$ref": "#/components/schemas/synckhub_server.routes.tasks.email_status.Request" } } } } } }, "/repos/{repo_id}/tasks/legacy/{task_list_id}/{task_item_seq}": { "get": { "operationId": "platform_get__repos__repo_id__tasks_legacy__task_list_id___task_item_seq_", "summary": "get legacy link", "tags": [ "tasks · records" ], "parameters": [ { "name": "repo_id", "in": "path", "required": true, "schema": { "type": "string" } }, { "name": "task_list_id", "in": "path", "required": true, "schema": { "type": "string" } }, { "name": "task_item_seq", "in": "path", "required": true, "schema": { "type": "integer" } } ], "description": "Authorization and validation are enforced by the owning service.", "x-handler": "get_legacy_link", "x-source-file": "crates/synckhub-server/src/routes/tasks/records.rs", "x-source-line": 332, "responses": { "default": { "description": "Platform error; branch on HTTP status and stable code, not the human-readable message.", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } } } } }, "head": { "operationId": "platform_head__repos__repo_id__tasks_legacy__task_list_id___task_item_seq_", "summary": "get legacy link", "tags": [ "tasks · records" ], "parameters": [ { "name": "repo_id", "in": "path", "required": true, "schema": { "type": "string" } }, { "name": "task_list_id", "in": "path", "required": true, "schema": { "type": "string" } }, { "name": "task_item_seq", "in": "path", "required": true, "schema": { "type": "integer" } } ], "description": "Authorization and validation are enforced by the owning service.\n\nHEAD uses the GET handler and headers without a response body.", "x-handler": "get_legacy_link", "x-source-file": "crates/synckhub-server/src/routes/tasks/records.rs", "x-source-line": 332, "x-implicit-head": true, "responses": { "default": { "description": "Platform error; branch on HTTP status and stable code, not the human-readable message." } } } }, "/repos/{repo_id}/tasks/updates": { "get": { "operationId": "platform_get__repos__repo_id__tasks_updates", "summary": "get task updates", "tags": [ "tasks · attention" ], "parameters": [ { "name": "repo_id", "in": "path", "required": true, "schema": { "type": "string" } }, { "name": "limit", "in": "query", "required": false, "schema": { "anyOf": [ { "type": "integer", "minimum": 0 }, { "type": "null" } ] } }, { "name": "cursor", "in": "query", "required": false, "schema": { "anyOf": [ { "type": "string" }, { "type": "null" } ] } } ], "description": "Authorization and validation are enforced by the owning service.", "x-handler": "super::updates::get_task_updates", "x-source-file": "crates/synckhub-server/src/routes/tasks/attention.rs", "x-source-line": 12, "responses": { "default": { "description": "Platform error; branch on HTTP status and stable code, not the human-readable message.", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } } }, "2XX": { "description": "Successful JSON response", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/synckhub_server.routes.tasks.updates.TaskUpdatesResponse" } } } } } }, "head": { "operationId": "platform_head__repos__repo_id__tasks_updates", "summary": "get task updates", "tags": [ "tasks · attention" ], "parameters": [ { "name": "repo_id", "in": "path", "required": true, "schema": { "type": "string" } }, { "name": "limit", "in": "query", "required": false, "schema": { "anyOf": [ { "type": "integer", "minimum": 0 }, { "type": "null" } ] } }, { "name": "cursor", "in": "query", "required": false, "schema": { "anyOf": [ { "type": "string" }, { "type": "null" } ] } } ], "description": "Authorization and validation are enforced by the owning service.\n\nHEAD uses the GET handler and headers without a response body.", "x-handler": "super::updates::get_task_updates", "x-source-file": "crates/synckhub-server/src/routes/tasks/attention.rs", "x-source-line": 12, "x-implicit-head": true, "responses": { "default": { "description": "Platform error; branch on HTTP status and stable code, not the human-readable message." } } } }, "/repos/{repo_id}/templates": { "get": { "operationId": "platform_get__repos__repo_id__templates", "summary": "list templates", "tags": [ "items · copy" ], "parameters": [ { "name": "repo_id", "in": "path", "required": true, "schema": { "type": "string" } }, { "name": "item_type", "in": "query", "required": false, "schema": { "type": "array", "items": { "type": "string" } }, "style": "form", "explode": true }, { "name": "item_type_exclude", "in": "query", "required": false, "schema": { "type": "array", "items": { "type": "string" } }, "style": "form", "explode": true }, { "name": "item_subtype", "in": "query", "required": false, "schema": { "type": "array", "items": { "type": "string" } }, "style": "form", "explode": true }, { "name": "case_status", "in": "query", "required": false, "schema": { "type": "array", "items": { "type": "string" } }, "style": "form", "explode": true }, { "name": "file_extension", "in": "query", "required": false, "schema": { "type": "array", "items": { "type": "string" }, "description": "Optional FILE-branch filter (repeatable; ANY match), e.g. `file_extension=pdf`.\n\nValues are normalized to lowercase ASCII and stored without a leading dot." }, "style": "form", "explode": true }, { "name": "file_extension_exclude", "in": "query", "required": false, "schema": { "type": "array", "items": { "type": "string" }, "description": "Optional FILE-branch exclusion (repeatable; ANY match), e.g. `file_extension_exclude=eml`." }, "style": "form", "explode": true }, { "name": "quick_access", "in": "query", "required": false, "schema": { "anyOf": [ { "type": "boolean" }, { "type": "null" } ] } }, { "name": "parent_folder_id", "in": "query", "required": false, "schema": { "anyOf": [ { "type": "string" }, { "type": "null" } ], "description": "Optional parent folder filter:\n- `None` means no parent filter (all items in the repo).\n- `Some(id)` means direct children of the given folder id.\n- `Some(\"\")` means root items only (no parent folder)." } }, { "name": "in_trash", "in": "query", "required": false, "schema": { "anyOf": [ { "type": "boolean" }, { "type": "null" } ] } }, { "name": "tombstoned", "in": "query", "required": false, "schema": { "anyOf": [ { "type": "boolean" }, { "type": "null" } ] } }, { "name": "limit", "in": "query", "required": false, "schema": { "anyOf": [ { "type": "integer", "minimum": 0 }, { "type": "null" } ] } }, { "name": "offset", "in": "query", "required": false, "schema": { "anyOf": [ { "type": "integer", "minimum": 0 }, { "type": "null" } ] } }, { "name": "sort", "in": "query", "required": false, "schema": { "anyOf": [ { "$ref": "#/components/schemas/synckhub_core.types.ListItemsSort" }, { "type": "null" } ] } }, { "name": "order", "in": "query", "required": false, "schema": { "anyOf": [ { "$ref": "#/components/schemas/synckhub_core.types.ListItemsOrder" }, { "type": "null" } ] } }, { "name": "folders_first", "in": "query", "required": false, "schema": { "anyOf": [ { "type": "boolean" }, { "type": "null" } ] } }, { "name": "after_name", "in": "query", "required": false, "schema": { "anyOf": [ { "type": "string" }, { "type": "null" } ] } }, { "name": "after_item_id", "in": "query", "required": false, "schema": { "anyOf": [ { "type": "string" }, { "type": "null" } ] } }, { "name": "include", "in": "query", "required": false, "schema": { "anyOf": [ { "type": "string" }, { "type": "null" } ], "description": "Optional expansions (comma-separated), e.g. `include=breadcrumbs`." } }, { "name": "scope", "in": "query", "required": false, "schema": { "anyOf": [ { "type": "string" }, { "type": "null" } ] } } ], "description": "Authorization and validation are enforced by the owning service.", "x-handler": "list_templates", "x-source-file": "crates/synckhub-server/src/routes/items/copy.rs", "x-source-line": 8, "responses": { "default": { "description": "Platform error; branch on HTTP status and stable code, not the human-readable message.", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } } }, "2XX": { "description": "Successful JSON response", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/synckhub_server.routes.items.copy.TemplatesListResponse" } } } } } }, "head": { "operationId": "platform_head__repos__repo_id__templates", "summary": "list templates", "tags": [ "items · copy" ], "parameters": [ { "name": "repo_id", "in": "path", "required": true, "schema": { "type": "string" } }, { "name": "item_type", "in": "query", "required": false, "schema": { "type": "array", "items": { "type": "string" } }, "style": "form", "explode": true }, { "name": "item_type_exclude", "in": "query", "required": false, "schema": { "type": "array", "items": { "type": "string" } }, "style": "form", "explode": true }, { "name": "item_subtype", "in": "query", "required": false, "schema": { "type": "array", "items": { "type": "string" } }, "style": "form", "explode": true }, { "name": "case_status", "in": "query", "required": false, "schema": { "type": "array", "items": { "type": "string" } }, "style": "form", "explode": true }, { "name": "file_extension", "in": "query", "required": false, "schema": { "type": "array", "items": { "type": "string" }, "description": "Optional FILE-branch filter (repeatable; ANY match), e.g. `file_extension=pdf`.\n\nValues are normalized to lowercase ASCII and stored without a leading dot." }, "style": "form", "explode": true }, { "name": "file_extension_exclude", "in": "query", "required": false, "schema": { "type": "array", "items": { "type": "string" }, "description": "Optional FILE-branch exclusion (repeatable; ANY match), e.g. `file_extension_exclude=eml`." }, "style": "form", "explode": true }, { "name": "quick_access", "in": "query", "required": false, "schema": { "anyOf": [ { "type": "boolean" }, { "type": "null" } ] } }, { "name": "parent_folder_id", "in": "query", "required": false, "schema": { "anyOf": [ { "type": "string" }, { "type": "null" } ], "description": "Optional parent folder filter:\n- `None` means no parent filter (all items in the repo).\n- `Some(id)` means direct children of the given folder id.\n- `Some(\"\")` means root items only (no parent folder)." } }, { "name": "in_trash", "in": "query", "required": false, "schema": { "anyOf": [ { "type": "boolean" }, { "type": "null" } ] } }, { "name": "tombstoned", "in": "query", "required": false, "schema": { "anyOf": [ { "type": "boolean" }, { "type": "null" } ] } }, { "name": "limit", "in": "query", "required": false, "schema": { "anyOf": [ { "type": "integer", "minimum": 0 }, { "type": "null" } ] } }, { "name": "offset", "in": "query", "required": false, "schema": { "anyOf": [ { "type": "integer", "minimum": 0 }, { "type": "null" } ] } }, { "name": "sort", "in": "query", "required": false, "schema": { "anyOf": [ { "$ref": "#/components/schemas/synckhub_core.types.ListItemsSort" }, { "type": "null" } ] } }, { "name": "order", "in": "query", "required": false, "schema": { "anyOf": [ { "$ref": "#/components/schemas/synckhub_core.types.ListItemsOrder" }, { "type": "null" } ] } }, { "name": "folders_first", "in": "query", "required": false, "schema": { "anyOf": [ { "type": "boolean" }, { "type": "null" } ] } }, { "name": "after_name", "in": "query", "required": false, "schema": { "anyOf": [ { "type": "string" }, { "type": "null" } ] } }, { "name": "after_item_id", "in": "query", "required": false, "schema": { "anyOf": [ { "type": "string" }, { "type": "null" } ] } }, { "name": "include", "in": "query", "required": false, "schema": { "anyOf": [ { "type": "string" }, { "type": "null" } ], "description": "Optional expansions (comma-separated), e.g. `include=breadcrumbs`." } }, { "name": "scope", "in": "query", "required": false, "schema": { "anyOf": [ { "type": "string" }, { "type": "null" } ] } } ], "description": "Authorization and validation are enforced by the owning service.\n\nHEAD uses the GET handler and headers without a response body.", "x-handler": "list_templates", "x-source-file": "crates/synckhub-server/src/routes/items/copy.rs", "x-source-line": 8, "x-implicit-head": true, "responses": { "default": { "description": "Platform error; branch on HTTP status and stable code, not the human-readable message." } } } }, "/repos/{repo_id}/templates/insert": { "post": { "operationId": "platform_post__repos__repo_id__templates_insert", "summary": "insert template", "tags": [ "items · copy" ], "parameters": [ { "name": "repo_id", "in": "path", "required": true, "schema": { "type": "string" } } ], "description": "Authorization and validation are enforced by the owning service.", "x-handler": "insert_template", "x-source-file": "crates/synckhub-server/src/routes/items/copy.rs", "x-source-line": 8, "responses": { "default": { "description": "Platform error; branch on HTTP status and stable code, not the human-readable message.", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } } }, "2XX": { "description": "Successful JSON response", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/synckhub_server.routes.items.copy.TemplatesInsertResponse" } } } } }, "requestBody": { "required": true, "content": { "application/json": { "schema": { "$ref": "#/components/schemas/synckhub_server.routes.items.copy.TemplatesInsertRequest" } } } } } }, "/repos/{repo_id}/time": { "get": { "operationId": "platform_get__repos__repo_id__time", "summary": "bootstrap", "tags": [ "time_tracking" ], "parameters": [ { "name": "repo_id", "in": "path", "required": true, "schema": { "type": "string" } } ], "description": "Authorization and validation are enforced by the owning service.", "x-handler": "bootstrap", "x-source-file": "crates/synckhub-server/src/routes/time_tracking.rs", "x-source-line": 18, "responses": { "default": { "description": "Platform error; branch on HTTP status and stable code, not the human-readable message.", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } } }, "2XX": { "description": "Successful JSON response", "content": { "application/json": { "schema": {} } } } } }, "head": { "operationId": "platform_head__repos__repo_id__time", "summary": "bootstrap", "tags": [ "time_tracking" ], "parameters": [ { "name": "repo_id", "in": "path", "required": true, "schema": { "type": "string" } } ], "description": "Authorization and validation are enforced by the owning service.\n\nHEAD uses the GET handler and headers without a response body.", "x-handler": "bootstrap", "x-source-file": "crates/synckhub-server/src/routes/time_tracking.rs", "x-source-line": 18, "x-implicit-head": true, "responses": { "default": { "description": "Platform error; branch on HTTP status and stable code, not the human-readable message." } } } }, "/repos/{repo_id}/time/active": { "get": { "operationId": "platform_get__repos__repo_id__time_active", "summary": "active", "tags": [ "time_tracking" ], "parameters": [ { "name": "repo_id", "in": "path", "required": true, "schema": { "type": "string" } } ], "description": "Authorization and validation are enforced by the owning service.", "x-handler": "active", "x-source-file": "crates/synckhub-server/src/routes/time_tracking.rs", "x-source-line": 18, "responses": { "default": { "description": "Platform error; branch on HTTP status and stable code, not the human-readable message.", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } } }, "2XX": { "description": "Successful JSON response", "content": { "application/json": { "schema": { "anyOf": [ { "$ref": "#/components/schemas/synckhub_server.routes.time_tracking.PublicEntry" }, { "type": "null" } ] } } } } } }, "head": { "operationId": "platform_head__repos__repo_id__time_active", "summary": "active", "tags": [ "time_tracking" ], "parameters": [ { "name": "repo_id", "in": "path", "required": true, "schema": { "type": "string" } } ], "description": "Authorization and validation are enforced by the owning service.\n\nHEAD uses the GET handler and headers without a response body.", "x-handler": "active", "x-source-file": "crates/synckhub-server/src/routes/time_tracking.rs", "x-source-line": 18, "x-implicit-head": true, "responses": { "default": { "description": "Platform error; branch on HTTP status and stable code, not the human-readable message." } } } }, "/repos/{repo_id}/time/assignments": { "get": { "operationId": "platform_get__repos__repo_id__time_assignments", "summary": "assignments", "tags": [ "time_tracking" ], "parameters": [ { "name": "repo_id", "in": "path", "required": true, "schema": { "type": "string" } }, { "name": "kind", "in": "query", "required": true, "schema": { "type": "string" } }, { "name": "q", "in": "query", "required": true, "schema": { "type": "string" } }, { "name": "id", "in": "query", "required": false, "schema": { "anyOf": [ { "type": "string", "format": "uuid" }, { "type": "null" } ] } } ], "description": "Authorization and validation are enforced by the owning service.", "x-handler": "assignments", "x-source-file": "crates/synckhub-server/src/routes/time_tracking.rs", "x-source-line": 18, "responses": { "default": { "description": "Platform error; branch on HTTP status and stable code, not the human-readable message.", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } } }, "2XX": { "description": "Successful JSON response", "content": { "application/json": { "schema": { "type": "array", "items": {} } } } } } }, "head": { "operationId": "platform_head__repos__repo_id__time_assignments", "summary": "assignments", "tags": [ "time_tracking" ], "parameters": [ { "name": "repo_id", "in": "path", "required": true, "schema": { "type": "string" } }, { "name": "kind", "in": "query", "required": true, "schema": { "type": "string" } }, { "name": "q", "in": "query", "required": true, "schema": { "type": "string" } }, { "name": "id", "in": "query", "required": false, "schema": { "anyOf": [ { "type": "string", "format": "uuid" }, { "type": "null" } ] } } ], "description": "Authorization and validation are enforced by the owning service.\n\nHEAD uses the GET handler and headers without a response body.", "x-handler": "assignments", "x-source-file": "crates/synckhub-server/src/routes/time_tracking.rs", "x-source-line": 18, "x-implicit-head": true, "responses": { "default": { "description": "Platform error; branch on HTTP status and stable code, not the human-readable message." } } } }, "/repos/{repo_id}/time/commands": { "post": { "operationId": "platform_post__repos__repo_id__time_commands", "summary": "command", "tags": [ "time_tracking" ], "parameters": [ { "name": "repo_id", "in": "path", "required": true, "schema": { "type": "string" } } ], "description": "Authorization and validation are enforced by the owning service.", "x-handler": "command", "x-source-file": "crates/synckhub-server/src/routes/time_tracking.rs", "x-source-line": 18, "responses": { "default": { "description": "Platform error; branch on HTTP status and stable code, not the human-readable message.", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } } }, "2XX": { "description": "Successful JSON response", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/synckhub_core_postgres.service.time_tracking.Receipt" } } } } }, "requestBody": { "required": true, "content": { "application/json": { "schema": { "$ref": "#/components/schemas/synckhub_core.time_tracking.Command" } } } } } }, "/repos/{repo_id}/time/entries": { "get": { "operationId": "platform_get__repos__repo_id__time_entries", "summary": "entries", "tags": [ "time_tracking" ], "parameters": [ { "name": "repo_id", "in": "path", "required": true, "schema": { "type": "string" } }, { "name": "from", "in": "query", "required": true, "schema": { "type": "string", "format": "date" } }, { "name": "to", "in": "query", "required": true, "schema": { "type": "string", "format": "date" } }, { "name": "user_id", "in": "query", "required": false, "schema": { "anyOf": [ { "type": "string" }, { "type": "null" } ] } }, { "name": "status", "in": "query", "required": false, "schema": { "anyOf": [ { "type": "string" }, { "type": "null" } ] } }, { "name": "case_id", "in": "query", "required": false, "schema": { "anyOf": [ { "type": "string", "format": "uuid" }, { "type": "null" } ] } }, { "name": "company_id", "in": "query", "required": false, "schema": { "anyOf": [ { "type": "string", "format": "uuid" }, { "type": "null" } ] } }, { "name": "after_date", "in": "query", "required": false, "schema": { "anyOf": [ { "type": "string", "format": "date" }, { "type": "null" } ] } }, { "name": "after_id", "in": "query", "required": false, "schema": { "anyOf": [ { "type": "string", "format": "uuid" }, { "type": "null" } ] } }, { "name": "limit", "in": "query", "required": false, "schema": { "anyOf": [ { "type": "integer" }, { "type": "null" } ] } }, { "name": "group", "in": "query", "required": false, "schema": { "anyOf": [ { "type": "string" }, { "type": "null" } ] } } ], "description": "Authorization and validation are enforced by the owning service.", "x-handler": "entries", "x-source-file": "crates/synckhub-server/src/routes/time_tracking.rs", "x-source-line": 18, "responses": { "default": { "description": "Platform error; branch on HTTP status and stable code, not the human-readable message.", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } } }, "2XX": { "description": "Successful JSON response", "content": { "application/json": { "schema": {} } } } } }, "head": { "operationId": "platform_head__repos__repo_id__time_entries", "summary": "entries", "tags": [ "time_tracking" ], "parameters": [ { "name": "repo_id", "in": "path", "required": true, "schema": { "type": "string" } }, { "name": "from", "in": "query", "required": true, "schema": { "type": "string", "format": "date" } }, { "name": "to", "in": "query", "required": true, "schema": { "type": "string", "format": "date" } }, { "name": "user_id", "in": "query", "required": false, "schema": { "anyOf": [ { "type": "string" }, { "type": "null" } ] } }, { "name": "status", "in": "query", "required": false, "schema": { "anyOf": [ { "type": "string" }, { "type": "null" } ] } }, { "name": "case_id", "in": "query", "required": false, "schema": { "anyOf": [ { "type": "string", "format": "uuid" }, { "type": "null" } ] } }, { "name": "company_id", "in": "query", "required": false, "schema": { "anyOf": [ { "type": "string", "format": "uuid" }, { "type": "null" } ] } }, { "name": "after_date", "in": "query", "required": false, "schema": { "anyOf": [ { "type": "string", "format": "date" }, { "type": "null" } ] } }, { "name": "after_id", "in": "query", "required": false, "schema": { "anyOf": [ { "type": "string", "format": "uuid" }, { "type": "null" } ] } }, { "name": "limit", "in": "query", "required": false, "schema": { "anyOf": [ { "type": "integer" }, { "type": "null" } ] } }, { "name": "group", "in": "query", "required": false, "schema": { "anyOf": [ { "type": "string" }, { "type": "null" } ] } } ], "description": "Authorization and validation are enforced by the owning service.\n\nHEAD uses the GET handler and headers without a response body.", "x-handler": "entries", "x-source-file": "crates/synckhub-server/src/routes/time_tracking.rs", "x-source-line": 18, "x-implicit-head": true, "responses": { "default": { "description": "Platform error; branch on HTTP status and stable code, not the human-readable message." } } } }, "/repos/{repo_id}/time/entries/{entry_id}": { "get": { "operationId": "platform_get__repos__repo_id__time_entries__entry_id_", "summary": "detail", "tags": [ "time_tracking" ], "parameters": [ { "name": "repo_id", "in": "path", "required": true, "schema": { "type": "string" } }, { "name": "entry_id", "in": "path", "required": true, "schema": { "type": "string" } } ], "description": "Authorization and validation are enforced by the owning service.", "x-handler": "detail", "x-source-file": "crates/synckhub-server/src/routes/time_tracking.rs", "x-source-line": 18, "responses": { "default": { "description": "Platform error; branch on HTTP status and stable code, not the human-readable message.", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } } }, "2XX": { "description": "Successful JSON response", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/synckhub_server.routes.time_tracking.PublicEntry" } } } } } }, "head": { "operationId": "platform_head__repos__repo_id__time_entries__entry_id_", "summary": "detail", "tags": [ "time_tracking" ], "parameters": [ { "name": "repo_id", "in": "path", "required": true, "schema": { "type": "string" } }, { "name": "entry_id", "in": "path", "required": true, "schema": { "type": "string" } } ], "description": "Authorization and validation are enforced by the owning service.\n\nHEAD uses the GET handler and headers without a response body.", "x-handler": "detail", "x-source-file": "crates/synckhub-server/src/routes/time_tracking.rs", "x-source-line": 18, "x-implicit-head": true, "responses": { "default": { "description": "Platform error; branch on HTTP status and stable code, not the human-readable message." } } } }, "/repos/{repo_id}/time/entries/{entry_id}/history": { "get": { "operationId": "platform_get__repos__repo_id__time_entries__entry_id__history", "summary": "history", "tags": [ "time_tracking" ], "parameters": [ { "name": "repo_id", "in": "path", "required": true, "schema": { "type": "string" } }, { "name": "entry_id", "in": "path", "required": true, "schema": { "type": "string" } }, { "name": "before_version", "in": "query", "required": false, "schema": { "anyOf": [ { "type": "integer" }, { "type": "null" } ] } } ], "description": "Authorization and validation are enforced by the owning service.", "x-handler": "history", "x-source-file": "crates/synckhub-server/src/routes/time_tracking.rs", "x-source-line": 18, "responses": { "default": { "description": "Platform error; branch on HTTP status and stable code, not the human-readable message.", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } } }, "2XX": { "description": "Successful JSON response", "content": { "application/json": { "schema": {} } } } } }, "head": { "operationId": "platform_head__repos__repo_id__time_entries__entry_id__history", "summary": "history", "tags": [ "time_tracking" ], "parameters": [ { "name": "repo_id", "in": "path", "required": true, "schema": { "type": "string" } }, { "name": "entry_id", "in": "path", "required": true, "schema": { "type": "string" } }, { "name": "before_version", "in": "query", "required": false, "schema": { "anyOf": [ { "type": "integer" }, { "type": "null" } ] } } ], "description": "Authorization and validation are enforced by the owning service.\n\nHEAD uses the GET handler and headers without a response body.", "x-handler": "history", "x-source-file": "crates/synckhub-server/src/routes/time_tracking.rs", "x-source-line": 18, "x-implicit-head": true, "responses": { "default": { "description": "Platform error; branch on HTTP status and stable code, not the human-readable message." } } } }, "/repos/{repo_id}/time/export": { "get": { "operationId": "platform_get__repos__repo_id__time_export", "summary": "export", "tags": [ "time_tracking" ], "parameters": [ { "name": "repo_id", "in": "path", "required": true, "schema": { "type": "string" } }, { "name": "from", "in": "query", "required": true, "schema": { "type": "string", "format": "date" } }, { "name": "to", "in": "query", "required": true, "schema": { "type": "string", "format": "date" } }, { "name": "user_id", "in": "query", "required": false, "schema": { "anyOf": [ { "type": "string" }, { "type": "null" } ] } }, { "name": "status", "in": "query", "required": false, "schema": { "anyOf": [ { "type": "string" }, { "type": "null" } ] } }, { "name": "case_id", "in": "query", "required": false, "schema": { "anyOf": [ { "type": "string", "format": "uuid" }, { "type": "null" } ] } }, { "name": "company_id", "in": "query", "required": false, "schema": { "anyOf": [ { "type": "string", "format": "uuid" }, { "type": "null" } ] } }, { "name": "after_date", "in": "query", "required": false, "schema": { "anyOf": [ { "type": "string", "format": "date" }, { "type": "null" } ] } }, { "name": "after_id", "in": "query", "required": false, "schema": { "anyOf": [ { "type": "string", "format": "uuid" }, { "type": "null" } ] } }, { "name": "limit", "in": "query", "required": false, "schema": { "anyOf": [ { "type": "integer" }, { "type": "null" } ] } }, { "name": "group", "in": "query", "required": false, "schema": { "anyOf": [ { "type": "string" }, { "type": "null" } ] } } ], "description": "Authorization and validation are enforced by the owning service.", "x-handler": "export", "x-source-file": "crates/synckhub-server/src/routes/time_tracking.rs", "x-source-line": 18, "responses": { "default": { "description": "Platform error; branch on HTTP status and stable code, not the human-readable message.", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } } } } }, "head": { "operationId": "platform_head__repos__repo_id__time_export", "summary": "export", "tags": [ "time_tracking" ], "parameters": [ { "name": "repo_id", "in": "path", "required": true, "schema": { "type": "string" } }, { "name": "from", "in": "query", "required": true, "schema": { "type": "string", "format": "date" } }, { "name": "to", "in": "query", "required": true, "schema": { "type": "string", "format": "date" } }, { "name": "user_id", "in": "query", "required": false, "schema": { "anyOf": [ { "type": "string" }, { "type": "null" } ] } }, { "name": "status", "in": "query", "required": false, "schema": { "anyOf": [ { "type": "string" }, { "type": "null" } ] } }, { "name": "case_id", "in": "query", "required": false, "schema": { "anyOf": [ { "type": "string", "format": "uuid" }, { "type": "null" } ] } }, { "name": "company_id", "in": "query", "required": false, "schema": { "anyOf": [ { "type": "string", "format": "uuid" }, { "type": "null" } ] } }, { "name": "after_date", "in": "query", "required": false, "schema": { "anyOf": [ { "type": "string", "format": "date" }, { "type": "null" } ] } }, { "name": "after_id", "in": "query", "required": false, "schema": { "anyOf": [ { "type": "string", "format": "uuid" }, { "type": "null" } ] } }, { "name": "limit", "in": "query", "required": false, "schema": { "anyOf": [ { "type": "integer" }, { "type": "null" } ] } }, { "name": "group", "in": "query", "required": false, "schema": { "anyOf": [ { "type": "string" }, { "type": "null" } ] } } ], "description": "Authorization and validation are enforced by the owning service.\n\nHEAD uses the GET handler and headers without a response body.", "x-handler": "export", "x-source-file": "crates/synckhub-server/src/routes/time_tracking.rs", "x-source-line": 18, "x-implicit-head": true, "responses": { "default": { "description": "Platform error; branch on HTTP status and stable code, not the human-readable message." } } } }, "/repos/{repo_id}/time/people": { "get": { "operationId": "platform_get__repos__repo_id__time_people", "summary": "people", "tags": [ "time_tracking" ], "parameters": [ { "name": "repo_id", "in": "path", "required": true, "schema": { "type": "string" } }, { "name": "kind", "in": "query", "required": true, "schema": { "type": "string" } }, { "name": "q", "in": "query", "required": true, "schema": { "type": "string" } }, { "name": "id", "in": "query", "required": false, "schema": { "anyOf": [ { "type": "string", "format": "uuid" }, { "type": "null" } ] } } ], "description": "Authorization and validation are enforced by the owning service.", "x-handler": "people", "x-source-file": "crates/synckhub-server/src/routes/time_tracking.rs", "x-source-line": 18, "responses": { "default": { "description": "Platform error; branch on HTTP status and stable code, not the human-readable message.", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } } }, "2XX": { "description": "Successful JSON response", "content": { "application/json": { "schema": { "type": "array", "items": {} } } } } } }, "head": { "operationId": "platform_head__repos__repo_id__time_people", "summary": "people", "tags": [ "time_tracking" ], "parameters": [ { "name": "repo_id", "in": "path", "required": true, "schema": { "type": "string" } }, { "name": "kind", "in": "query", "required": true, "schema": { "type": "string" } }, { "name": "q", "in": "query", "required": true, "schema": { "type": "string" } }, { "name": "id", "in": "query", "required": false, "schema": { "anyOf": [ { "type": "string", "format": "uuid" }, { "type": "null" } ] } } ], "description": "Authorization and validation are enforced by the owning service.\n\nHEAD uses the GET handler and headers without a response body.", "x-handler": "people", "x-source-file": "crates/synckhub-server/src/routes/time_tracking.rs", "x-source-line": 18, "x-implicit-head": true, "responses": { "default": { "description": "Platform error; branch on HTTP status and stable code, not the human-readable message." } } } }, "/repos/{repo_id}/time/reports": { "get": { "operationId": "platform_get__repos__repo_id__time_reports", "summary": "report", "tags": [ "time_tracking" ], "parameters": [ { "name": "repo_id", "in": "path", "required": true, "schema": { "type": "string" } }, { "name": "from", "in": "query", "required": true, "schema": { "type": "string", "format": "date" } }, { "name": "to", "in": "query", "required": true, "schema": { "type": "string", "format": "date" } }, { "name": "user_id", "in": "query", "required": false, "schema": { "anyOf": [ { "type": "string" }, { "type": "null" } ] } }, { "name": "status", "in": "query", "required": false, "schema": { "anyOf": [ { "type": "string" }, { "type": "null" } ] } }, { "name": "case_id", "in": "query", "required": false, "schema": { "anyOf": [ { "type": "string", "format": "uuid" }, { "type": "null" } ] } }, { "name": "company_id", "in": "query", "required": false, "schema": { "anyOf": [ { "type": "string", "format": "uuid" }, { "type": "null" } ] } }, { "name": "after_date", "in": "query", "required": false, "schema": { "anyOf": [ { "type": "string", "format": "date" }, { "type": "null" } ] } }, { "name": "after_id", "in": "query", "required": false, "schema": { "anyOf": [ { "type": "string", "format": "uuid" }, { "type": "null" } ] } }, { "name": "limit", "in": "query", "required": false, "schema": { "anyOf": [ { "type": "integer" }, { "type": "null" } ] } }, { "name": "group", "in": "query", "required": false, "schema": { "anyOf": [ { "type": "string" }, { "type": "null" } ] } } ], "description": "Authorization and validation are enforced by the owning service.", "x-handler": "report", "x-source-file": "crates/synckhub-server/src/routes/time_tracking.rs", "x-source-line": 18, "responses": { "default": { "description": "Platform error; branch on HTTP status and stable code, not the human-readable message.", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } } }, "2XX": { "description": "Successful JSON response", "content": { "application/json": { "schema": {} } } } } }, "head": { "operationId": "platform_head__repos__repo_id__time_reports", "summary": "report", "tags": [ "time_tracking" ], "parameters": [ { "name": "repo_id", "in": "path", "required": true, "schema": { "type": "string" } }, { "name": "from", "in": "query", "required": true, "schema": { "type": "string", "format": "date" } }, { "name": "to", "in": "query", "required": true, "schema": { "type": "string", "format": "date" } }, { "name": "user_id", "in": "query", "required": false, "schema": { "anyOf": [ { "type": "string" }, { "type": "null" } ] } }, { "name": "status", "in": "query", "required": false, "schema": { "anyOf": [ { "type": "string" }, { "type": "null" } ] } }, { "name": "case_id", "in": "query", "required": false, "schema": { "anyOf": [ { "type": "string", "format": "uuid" }, { "type": "null" } ] } }, { "name": "company_id", "in": "query", "required": false, "schema": { "anyOf": [ { "type": "string", "format": "uuid" }, { "type": "null" } ] } }, { "name": "after_date", "in": "query", "required": false, "schema": { "anyOf": [ { "type": "string", "format": "date" }, { "type": "null" } ] } }, { "name": "after_id", "in": "query", "required": false, "schema": { "anyOf": [ { "type": "string", "format": "uuid" }, { "type": "null" } ] } }, { "name": "limit", "in": "query", "required": false, "schema": { "anyOf": [ { "type": "integer" }, { "type": "null" } ] } }, { "name": "group", "in": "query", "required": false, "schema": { "anyOf": [ { "type": "string" }, { "type": "null" } ] } } ], "description": "Authorization and validation are enforced by the owning service.\n\nHEAD uses the GET handler and headers without a response body.", "x-handler": "report", "x-source-file": "crates/synckhub-server/src/routes/time_tracking.rs", "x-source-line": 18, "x-implicit-head": true, "responses": { "default": { "description": "Platform error; branch on HTTP status and stable code, not the human-readable message." } } } }, "/repos/{repo_id}/users": { "get": { "operationId": "platform_get__repos__repo_id__users", "summary": "list repo users", "tags": [ "authz" ], "parameters": [ { "name": "repo_id", "in": "path", "required": true, "schema": { "type": "string" } } ], "description": "Authorization and validation are enforced by the owning service.", "x-handler": "list_repo_users", "x-source-file": "crates/synckhub-server/src/routes/authz.rs", "x-source-line": 6602, "responses": { "default": { "description": "Platform error; branch on HTTP status and stable code, not the human-readable message.", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } } }, "2XX": { "description": "Successful JSON response", "content": { "application/json": { "schema": { "type": "array", "items": { "$ref": "#/components/schemas/synckhub_server.routes.authz.RepoUserSummary" } } } } } } }, "head": { "operationId": "platform_head__repos__repo_id__users", "summary": "list repo users", "tags": [ "authz" ], "parameters": [ { "name": "repo_id", "in": "path", "required": true, "schema": { "type": "string" } } ], "description": "Authorization and validation are enforced by the owning service.\n\nHEAD uses the GET handler and headers without a response body.", "x-handler": "list_repo_users", "x-source-file": "crates/synckhub-server/src/routes/authz.rs", "x-source-line": 6602, "x-implicit-head": true, "responses": { "default": { "description": "Platform error; branch on HTTP status and stable code, not the human-readable message." } } } }, "/repos/{repo_id}/vcs-replica/checkpoint": { "get": { "operationId": "platform_get__repos__repo_id__vcs_replica_checkpoint", "summary": "get checkpoint", "tags": [ "vcs_replica" ], "parameters": [ { "name": "repo_id", "in": "path", "required": true, "schema": { "type": "string" } } ], "description": "Authorization and validation are enforced by the owning service.", "x-handler": "get_checkpoint", "x-source-file": "crates/synckhub-server/src/routes/vcs_replica.rs", "x-source-line": 33, "responses": { "default": { "description": "Platform error; branch on HTTP status and stable code, not the human-readable message.", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } } } } }, "head": { "operationId": "platform_head__repos__repo_id__vcs_replica_checkpoint", "summary": "get checkpoint", "tags": [ "vcs_replica" ], "parameters": [ { "name": "repo_id", "in": "path", "required": true, "schema": { "type": "string" } } ], "description": "Authorization and validation are enforced by the owning service.\n\nHEAD uses the GET handler and headers without a response body.", "x-handler": "get_checkpoint", "x-source-file": "crates/synckhub-server/src/routes/vcs_replica.rs", "x-source-line": 33, "x-implicit-head": true, "responses": { "default": { "description": "Platform error; branch on HTTP status and stable code, not the human-readable message." } } } }, "/repos/{repo_id}/vcs-replica/commits": { "get": { "operationId": "platform_get__repos__repo_id__vcs_replica_commits", "summary": "get commits", "tags": [ "vcs_replica" ], "parameters": [ { "name": "repo_id", "in": "path", "required": true, "schema": { "type": "string" } }, { "name": "after_repo_seq", "in": "query", "required": true, "schema": { "type": "integer" } }, { "name": "through_repo_seq", "in": "query", "required": true, "schema": { "type": "integer" } } ], "description": "Authorization and validation are enforced by the owning service.", "x-handler": "get_commits", "x-source-file": "crates/synckhub-server/src/routes/vcs_replica.rs", "x-source-line": 33, "responses": { "default": { "description": "Platform error; branch on HTTP status and stable code, not the human-readable message.", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } } } } }, "head": { "operationId": "platform_head__repos__repo_id__vcs_replica_commits", "summary": "get commits", "tags": [ "vcs_replica" ], "parameters": [ { "name": "repo_id", "in": "path", "required": true, "schema": { "type": "string" } }, { "name": "after_repo_seq", "in": "query", "required": true, "schema": { "type": "integer" } }, { "name": "through_repo_seq", "in": "query", "required": true, "schema": { "type": "integer" } } ], "description": "Authorization and validation are enforced by the owning service.\n\nHEAD uses the GET handler and headers without a response body.", "x-handler": "get_commits", "x-source-file": "crates/synckhub-server/src/routes/vcs_replica.rs", "x-source-line": 33, "x-implicit-head": true, "responses": { "default": { "description": "Platform error; branch on HTTP status and stable code, not the human-readable message." } } } }, "/repos/{repo_id}/workspace-shortcuts": { "get": { "operationId": "platform_get__repos__repo_id__workspace_shortcuts", "summary": "list workspace shortcuts", "tags": [ "items · read" ], "parameters": [ { "name": "repo_id", "in": "path", "required": true, "schema": { "type": "string" } } ], "description": "Authorization and validation are enforced by the owning service.", "x-handler": "list_workspace_shortcuts", "x-source-file": "crates/synckhub-server/src/routes/items/read.rs", "x-source-line": 27, "responses": { "default": { "description": "Platform error; branch on HTTP status and stable code, not the human-readable message.", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } } }, "2XX": { "description": "Successful JSON response", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/synckhub_server.routes.items.read.WorkspaceShortcutsResponse" } } } } } }, "head": { "operationId": "platform_head__repos__repo_id__workspace_shortcuts", "summary": "list workspace shortcuts", "tags": [ "items · read" ], "parameters": [ { "name": "repo_id", "in": "path", "required": true, "schema": { "type": "string" } } ], "description": "Authorization and validation are enforced by the owning service.\n\nHEAD uses the GET handler and headers without a response body.", "x-handler": "list_workspace_shortcuts", "x-source-file": "crates/synckhub-server/src/routes/items/read.rs", "x-source-line": 27, "x-implicit-head": true, "responses": { "default": { "description": "Platform error; branch on HTTP status and stable code, not the human-readable message." } } } }, "/repos/{repo_id}/workspace-shortcuts/{shortcut_id}": { "delete": { "operationId": "platform_delete__repos__repo_id__workspace_shortcuts__shortcut_id_", "summary": "delete workspace shortcut", "tags": [ "items · read" ], "parameters": [ { "name": "repo_id", "in": "path", "required": true, "schema": { "type": "string" } }, { "name": "shortcut_id", "in": "path", "required": true, "schema": { "type": "string" } } ], "description": "Authorization and validation are enforced by the owning service.", "x-handler": "delete_workspace_shortcut", "x-source-file": "crates/synckhub-server/src/routes/items/read.rs", "x-source-line": 27, "responses": { "default": { "description": "Platform error; branch on HTTP status and stable code, not the human-readable message.", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } } } } }, "put": { "operationId": "platform_put__repos__repo_id__workspace_shortcuts__shortcut_id_", "summary": "upsert workspace shortcut", "tags": [ "items · read" ], "parameters": [ { "name": "repo_id", "in": "path", "required": true, "schema": { "type": "string" } }, { "name": "shortcut_id", "in": "path", "required": true, "schema": { "type": "string" } } ], "description": "Authorization and validation are enforced by the owning service.", "x-handler": "upsert_workspace_shortcut", "x-source-file": "crates/synckhub-server/src/routes/items/read.rs", "x-source-line": 27, "responses": { "default": { "description": "Platform error; branch on HTTP status and stable code, not the human-readable message.", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } } }, "2XX": { "description": "Successful JSON response", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/synckhub_server.routes.items.read.WorkspaceShortcut" } } } } }, "requestBody": { "required": true, "content": { "application/json": { "schema": { "$ref": "#/components/schemas/synckhub_server.routes.items.read.UpsertWorkspaceShortcutRequest" } } } } } }, "/repos/{repo}/calendar-events/{event}/remote-participants": { "post": { "operationId": "platform_post__repos__repo__calendar_events__event__remote_participants", "summary": "invite", "tags": [ "native_calendars · peer" ], "parameters": [ { "name": "repo", "in": "path", "required": true, "schema": { "type": "string" } }, { "name": "event", "in": "path", "required": true, "schema": { "type": "string" } } ], "description": "Authorization and validation are enforced by the owning service.", "x-handler": "invite", "x-source-file": "crates/synckhub-server/src/routes/native_calendars/peer.rs", "x-source-line": 15, "responses": { "default": { "description": "Platform error; branch on HTTP status and stable code, not the human-readable message.", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } } }, "2XX": { "description": "Successful JSON response", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/synckhub_core_postgres.service.native_calendars.commands.CommandReceipt" } } } } }, "requestBody": { "required": true, "content": { "application/json": { "schema": { "$ref": "#/components/schemas/synckhub_core.native_calendars.commands.InviteRemote" } } } } } }, "/tus/files": { "post": { "operationId": "platform_post__tus_files", "summary": "post files", "tags": [ "mod" ], "parameters": [ { "name": "Tus-Resumable", "in": "header", "required": true, "schema": { "type": "string", "const": "1.0.0" } }, { "name": "Upload-Length", "in": "header", "required": true, "schema": { "type": "integer", "minimum": 0 } }, { "name": "Upload-Metadata", "in": "header", "required": true, "description": "Comma-separated upload_intent_id and upload_token, each followed by a space and its base64-encoded UTF-8 value.", "schema": { "type": "string" } } ], "description": "Authorization and validation are enforced by the owning service.\n\nTus 1.0 upload protocol. Create an upload intent first; use its upload credentials. PATCH transmits application/offset+octet-stream bytes at Upload-Offset. OPTIONS advertises capabilities; HEAD returns upload length and offset.", "x-handler": "post_files", "x-source-file": "crates/synckhub-server/src/routes/mod.rs", "x-source-line": 2473, "responses": { "201": { "description": "Successful tus protocol response; no JSON body.", "headers": { "Tus-Resumable": { "schema": { "type": "string", "const": "1.0.0" } }, "Location": { "description": "/tus/files/{upload_intent_id}", "schema": { "type": "string" } } } }, "400": { "description": "Invalid tus headers or metadata.", "headers": { "Tus-Resumable": { "schema": { "type": "string", "const": "1.0.0" } } } }, "404": { "description": "Intent absent, inaccessible or upload token mismatch.", "headers": { "Tus-Resumable": { "schema": { "type": "string", "const": "1.0.0" } } } }, "409": { "description": "Upload state or offset conflict. Read the current offset before resuming.", "headers": { "Tus-Resumable": { "schema": { "type": "string", "const": "1.0.0" } } } }, "412": { "description": "Tus-Resumable must be 1.0.0.", "headers": { "Tus-Resumable": { "schema": { "type": "string", "const": "1.0.0" } } } }, "413": { "description": "Upload size, storage quota or staging capacity exceeded." }, "default": { "description": "Tus protocol error; a response body is not guaranteed to be JSON." } }, "security": [ { "bearerAuth": [] }, { "uploadCapability": [] } ] }, "options": { "operationId": "platform_options__tus_files", "summary": "options files", "tags": [ "mod" ], "parameters": [], "description": "Authorization and validation are enforced by the owning service.\n\nTus 1.0 upload protocol. Create an upload intent first; use its upload credentials. PATCH transmits application/offset+octet-stream bytes at Upload-Offset. OPTIONS advertises capabilities; HEAD returns upload length and offset.", "x-handler": "options_files", "x-source-file": "crates/synckhub-server/src/routes/mod.rs", "x-source-line": 2473, "responses": { "204": { "description": "Successful tus protocol response; no JSON body.", "headers": { "Tus-Resumable": { "schema": { "type": "string", "const": "1.0.0" } }, "Tus-Version": { "schema": { "type": "string", "const": "1.0.0" } }, "Tus-Extension": { "schema": { "type": "string", "const": "creation" } }, "Tus-Max-Size": { "schema": { "type": "integer", "minimum": 0 } } } }, "default": { "description": "Tus protocol error; a response body is not guaranteed to be JSON." } }, "security": [] } }, "/tus/files/": { "post": { "operationId": "platform_post__tus_files_", "summary": "post files", "tags": [ "mod" ], "parameters": [ { "name": "Tus-Resumable", "in": "header", "required": true, "schema": { "type": "string", "const": "1.0.0" } }, { "name": "Upload-Length", "in": "header", "required": true, "schema": { "type": "integer", "minimum": 0 } }, { "name": "Upload-Metadata", "in": "header", "required": true, "description": "Comma-separated upload_intent_id and upload_token, each followed by a space and its base64-encoded UTF-8 value.", "schema": { "type": "string" } } ], "description": "Authorization and validation are enforced by the owning service.\n\nTus 1.0 upload protocol. Create an upload intent first; use its upload credentials. PATCH transmits application/offset+octet-stream bytes at Upload-Offset. OPTIONS advertises capabilities; HEAD returns upload length and offset.", "x-handler": "post_files", "x-source-file": "crates/synckhub-server/src/routes/mod.rs", "x-source-line": 2473, "responses": { "201": { "description": "Successful tus protocol response; no JSON body.", "headers": { "Tus-Resumable": { "schema": { "type": "string", "const": "1.0.0" } }, "Location": { "description": "/tus/files/{upload_intent_id}", "schema": { "type": "string" } } } }, "400": { "description": "Invalid tus headers or metadata.", "headers": { "Tus-Resumable": { "schema": { "type": "string", "const": "1.0.0" } } } }, "404": { "description": "Intent absent, inaccessible or upload token mismatch.", "headers": { "Tus-Resumable": { "schema": { "type": "string", "const": "1.0.0" } } } }, "409": { "description": "Upload state or offset conflict. Read the current offset before resuming.", "headers": { "Tus-Resumable": { "schema": { "type": "string", "const": "1.0.0" } } } }, "412": { "description": "Tus-Resumable must be 1.0.0.", "headers": { "Tus-Resumable": { "schema": { "type": "string", "const": "1.0.0" } } } }, "413": { "description": "Upload size, storage quota or staging capacity exceeded." }, "default": { "description": "Tus protocol error; a response body is not guaranteed to be JSON." } }, "security": [ { "bearerAuth": [] }, { "uploadCapability": [] } ] }, "options": { "operationId": "platform_options__tus_files_", "summary": "options files", "tags": [ "mod" ], "parameters": [], "description": "Authorization and validation are enforced by the owning service.\n\nTus 1.0 upload protocol. Create an upload intent first; use its upload credentials. PATCH transmits application/offset+octet-stream bytes at Upload-Offset. OPTIONS advertises capabilities; HEAD returns upload length and offset.", "x-handler": "options_files", "x-source-file": "crates/synckhub-server/src/routes/mod.rs", "x-source-line": 2473, "responses": { "204": { "description": "Successful tus protocol response; no JSON body.", "headers": { "Tus-Resumable": { "schema": { "type": "string", "const": "1.0.0" } }, "Tus-Version": { "schema": { "type": "string", "const": "1.0.0" } }, "Tus-Extension": { "schema": { "type": "string", "const": "creation" } }, "Tus-Max-Size": { "schema": { "type": "integer", "minimum": 0 } } } }, "default": { "description": "Tus protocol error; a response body is not guaranteed to be JSON." } }, "security": [] } }, "/tus/files/{id}": { "patch": { "operationId": "platform_patch__tus_files__id_", "summary": "patch file", "tags": [ "mod" ], "parameters": [ { "name": "id", "in": "path", "required": true, "schema": { "type": "string" } }, { "name": "Tus-Resumable", "in": "header", "required": true, "schema": { "type": "string", "const": "1.0.0" } }, { "name": "Upload-Offset", "in": "header", "required": true, "schema": { "type": "integer", "minimum": 0 } } ], "description": "Authorization and validation are enforced by the owning service.\n\nTus 1.0 upload protocol. Create an upload intent first; use its upload credentials. PATCH transmits application/offset+octet-stream bytes at Upload-Offset. OPTIONS advertises capabilities; HEAD returns upload length and offset.", "x-handler": "patch_file", "x-source-file": "crates/synckhub-server/src/routes/mod.rs", "x-source-line": 2473, "responses": { "204": { "description": "Successful tus protocol response; no JSON body.", "headers": { "Tus-Resumable": { "schema": { "type": "string", "const": "1.0.0" } }, "Upload-Offset": { "schema": { "type": "integer", "minimum": 0 } } } }, "400": { "description": "Invalid tus headers or metadata.", "headers": { "Tus-Resumable": { "schema": { "type": "string", "const": "1.0.0" } } } }, "404": { "description": "Intent absent, inaccessible or upload token mismatch.", "headers": { "Tus-Resumable": { "schema": { "type": "string", "const": "1.0.0" } } } }, "409": { "description": "Upload state or offset conflict. Read the current offset before resuming.", "headers": { "Tus-Resumable": { "schema": { "type": "string", "const": "1.0.0" } } } }, "412": { "description": "Tus-Resumable must be 1.0.0.", "headers": { "Tus-Resumable": { "schema": { "type": "string", "const": "1.0.0" } } } }, "413": { "description": "Upload size, storage quota or staging capacity exceeded." }, "415": { "description": "Content-Type must be application/offset+octet-stream." }, "default": { "description": "Tus protocol error; a response body is not guaranteed to be JSON." } }, "security": [ { "bearerAuth": [] }, { "uploadCapability": [] } ], "requestBody": { "required": true, "content": { "application/offset+octet-stream": { "schema": { "type": "string", "format": "binary" } } } } }, "head": { "operationId": "platform_head__tus_files__id_", "summary": "head file", "tags": [ "mod" ], "parameters": [ { "name": "id", "in": "path", "required": true, "schema": { "type": "string" } }, { "name": "Tus-Resumable", "in": "header", "required": true, "schema": { "type": "string", "const": "1.0.0" } } ], "description": "Authorization and validation are enforced by the owning service.\n\nTus 1.0 upload protocol. Create an upload intent first; use its upload credentials. PATCH transmits application/offset+octet-stream bytes at Upload-Offset. OPTIONS advertises capabilities; HEAD returns upload length and offset.", "x-handler": "head_file", "x-source-file": "crates/synckhub-server/src/routes/mod.rs", "x-source-line": 2473, "responses": { "200": { "description": "Successful tus protocol response; no JSON body.", "headers": { "Tus-Resumable": { "schema": { "type": "string", "const": "1.0.0" } }, "Upload-Length": { "schema": { "type": "integer", "minimum": 0 } }, "Upload-Offset": { "schema": { "type": "integer", "minimum": 0 } } } }, "400": { "description": "Invalid tus headers or metadata.", "headers": { "Tus-Resumable": { "schema": { "type": "string", "const": "1.0.0" } } } }, "404": { "description": "Intent absent, inaccessible or upload token mismatch.", "headers": { "Tus-Resumable": { "schema": { "type": "string", "const": "1.0.0" } } } }, "409": { "description": "Upload state or offset conflict. Read the current offset before resuming.", "headers": { "Tus-Resumable": { "schema": { "type": "string", "const": "1.0.0" } } } }, "412": { "description": "Tus-Resumable must be 1.0.0.", "headers": { "Tus-Resumable": { "schema": { "type": "string", "const": "1.0.0" } } } }, "default": { "description": "Tus protocol error; a response body is not guaranteed to be JSON." } }, "security": [ { "bearerAuth": [] }, { "uploadCapability": [] } ] }, "options": { "operationId": "platform_options__tus_files__id_", "summary": "options file", "tags": [ "mod" ], "parameters": [ { "name": "id", "in": "path", "required": true, "schema": { "type": "string" } } ], "description": "Authorization and validation are enforced by the owning service.\n\nTus 1.0 upload protocol. Create an upload intent first; use its upload credentials. PATCH transmits application/offset+octet-stream bytes at Upload-Offset. OPTIONS advertises capabilities; HEAD returns upload length and offset.", "x-handler": "options_file", "x-source-file": "crates/synckhub-server/src/routes/mod.rs", "x-source-line": 2473, "responses": { "204": { "description": "Successful tus protocol response; no JSON body.", "headers": { "Tus-Resumable": { "schema": { "type": "string", "const": "1.0.0" } }, "Tus-Version": { "schema": { "type": "string", "const": "1.0.0" } }, "Tus-Extension": { "schema": { "type": "string", "const": "creation" } }, "Tus-Max-Size": { "schema": { "type": "integer", "minimum": 0 } } } }, "default": { "description": "Tus protocol error; a response body is not guaranteed to be JSON." } }, "security": [] } }, "/tus/files/{id}/": { "patch": { "operationId": "platform_patch__tus_files__id__", "summary": "patch file", "tags": [ "mod" ], "parameters": [ { "name": "id", "in": "path", "required": true, "schema": { "type": "string" } }, { "name": "Tus-Resumable", "in": "header", "required": true, "schema": { "type": "string", "const": "1.0.0" } }, { "name": "Upload-Offset", "in": "header", "required": true, "schema": { "type": "integer", "minimum": 0 } } ], "description": "Authorization and validation are enforced by the owning service.\n\nTus 1.0 upload protocol. Create an upload intent first; use its upload credentials. PATCH transmits application/offset+octet-stream bytes at Upload-Offset. OPTIONS advertises capabilities; HEAD returns upload length and offset.", "x-handler": "patch_file", "x-source-file": "crates/synckhub-server/src/routes/mod.rs", "x-source-line": 2473, "responses": { "204": { "description": "Successful tus protocol response; no JSON body.", "headers": { "Tus-Resumable": { "schema": { "type": "string", "const": "1.0.0" } }, "Upload-Offset": { "schema": { "type": "integer", "minimum": 0 } } } }, "400": { "description": "Invalid tus headers or metadata.", "headers": { "Tus-Resumable": { "schema": { "type": "string", "const": "1.0.0" } } } }, "404": { "description": "Intent absent, inaccessible or upload token mismatch.", "headers": { "Tus-Resumable": { "schema": { "type": "string", "const": "1.0.0" } } } }, "409": { "description": "Upload state or offset conflict. Read the current offset before resuming.", "headers": { "Tus-Resumable": { "schema": { "type": "string", "const": "1.0.0" } } } }, "412": { "description": "Tus-Resumable must be 1.0.0.", "headers": { "Tus-Resumable": { "schema": { "type": "string", "const": "1.0.0" } } } }, "413": { "description": "Upload size, storage quota or staging capacity exceeded." }, "415": { "description": "Content-Type must be application/offset+octet-stream." }, "default": { "description": "Tus protocol error; a response body is not guaranteed to be JSON." } }, "security": [ { "bearerAuth": [] }, { "uploadCapability": [] } ], "requestBody": { "required": true, "content": { "application/offset+octet-stream": { "schema": { "type": "string", "format": "binary" } } } } }, "head": { "operationId": "platform_head__tus_files__id__", "summary": "head file", "tags": [ "mod" ], "parameters": [ { "name": "id", "in": "path", "required": true, "schema": { "type": "string" } }, { "name": "Tus-Resumable", "in": "header", "required": true, "schema": { "type": "string", "const": "1.0.0" } } ], "description": "Authorization and validation are enforced by the owning service.\n\nTus 1.0 upload protocol. Create an upload intent first; use its upload credentials. PATCH transmits application/offset+octet-stream bytes at Upload-Offset. OPTIONS advertises capabilities; HEAD returns upload length and offset.", "x-handler": "head_file", "x-source-file": "crates/synckhub-server/src/routes/mod.rs", "x-source-line": 2473, "responses": { "200": { "description": "Successful tus protocol response; no JSON body.", "headers": { "Tus-Resumable": { "schema": { "type": "string", "const": "1.0.0" } }, "Upload-Length": { "schema": { "type": "integer", "minimum": 0 } }, "Upload-Offset": { "schema": { "type": "integer", "minimum": 0 } } } }, "400": { "description": "Invalid tus headers or metadata.", "headers": { "Tus-Resumable": { "schema": { "type": "string", "const": "1.0.0" } } } }, "404": { "description": "Intent absent, inaccessible or upload token mismatch.", "headers": { "Tus-Resumable": { "schema": { "type": "string", "const": "1.0.0" } } } }, "409": { "description": "Upload state or offset conflict. Read the current offset before resuming.", "headers": { "Tus-Resumable": { "schema": { "type": "string", "const": "1.0.0" } } } }, "412": { "description": "Tus-Resumable must be 1.0.0.", "headers": { "Tus-Resumable": { "schema": { "type": "string", "const": "1.0.0" } } } }, "default": { "description": "Tus protocol error; a response body is not guaranteed to be JSON." } }, "security": [ { "bearerAuth": [] }, { "uploadCapability": [] } ] }, "options": { "operationId": "platform_options__tus_files__id__", "summary": "options file", "tags": [ "mod" ], "parameters": [ { "name": "id", "in": "path", "required": true, "schema": { "type": "string" } } ], "description": "Authorization and validation are enforced by the owning service.\n\nTus 1.0 upload protocol. Create an upload intent first; use its upload credentials. PATCH transmits application/offset+octet-stream bytes at Upload-Offset. OPTIONS advertises capabilities; HEAD returns upload length and offset.", "x-handler": "options_file", "x-source-file": "crates/synckhub-server/src/routes/mod.rs", "x-source-line": 2473, "responses": { "204": { "description": "Successful tus protocol response; no JSON body.", "headers": { "Tus-Resumable": { "schema": { "type": "string", "const": "1.0.0" } }, "Tus-Version": { "schema": { "type": "string", "const": "1.0.0" } }, "Tus-Extension": { "schema": { "type": "string", "const": "creation" } }, "Tus-Max-Size": { "schema": { "type": "integer", "minimum": 0 } } } }, "default": { "description": "Tus protocol error; a response body is not guaranteed to be JSON." } }, "security": [] } }, "/v0/yjs-wopi/callback/close": { "post": { "operationId": "platform_post__v0_yjs_wopi_callback_close", "summary": "callback close", "tags": [ "yjs_wopi" ], "parameters": [], "description": "Authorization and validation are enforced by the owning service.", "x-handler": "callback_close", "x-source-file": "crates/synckhub-server/src/routes/yjs_wopi.rs", "x-source-line": 220, "responses": { "default": { "description": "Platform error; branch on HTTP status and stable code, not the human-readable message.", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } } }, "2XX": { "description": "Successful JSON response", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/synckhub_server.routes.yjs_wopi.CallbackCloseResponse" } } } } }, "requestBody": { "required": true, "content": { "application/json": { "schema": { "$ref": "#/components/schemas/synckhub_server.routes.yjs_wopi.CallbackCloseRequest" } } } }, "security": [ { "yjsWopiSecret": [] } ] } }, "/v0/yjs-wopi/callback/open": { "post": { "operationId": "platform_post__v0_yjs_wopi_callback_open", "summary": "callback open", "tags": [ "yjs_wopi" ], "parameters": [], "description": "Authorization and validation are enforced by the owning service.", "x-handler": "callback_open", "x-source-file": "crates/synckhub-server/src/routes/yjs_wopi.rs", "x-source-line": 220, "responses": { "default": { "description": "Platform error; branch on HTTP status and stable code, not the human-readable message.", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } } }, "2XX": { "description": "Successful JSON response", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/synckhub_server.routes.yjs_wopi.CallbackOpenResponse" } } } } }, "requestBody": { "required": true, "content": { "application/json": { "schema": { "$ref": "#/components/schemas/synckhub_server.routes.yjs_wopi.CallbackOpenRequest" } } } }, "security": [ { "yjsWopiSecret": [] } ] } }, "/v0/yjs-wopi/callback/publish": { "post": { "operationId": "platform_post__v0_yjs_wopi_callback_publish", "summary": "callback publish", "tags": [ "yjs_wopi" ], "parameters": [], "description": "Authorization and validation are enforced by the owning service.", "x-handler": "callback_publish", "x-source-file": "crates/synckhub-server/src/routes/yjs_wopi.rs", "x-source-line": 220, "responses": { "default": { "description": "Platform error; branch on HTTP status and stable code, not the human-readable message.", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } } }, "2XX": { "description": "Successful JSON response", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/synckhub_server.routes.yjs_wopi.CallbackPublishResponse" } } } } }, "requestBody": { "required": true, "content": { "application/json": { "schema": { "$ref": "#/components/schemas/synckhub_server.routes.yjs_wopi.CallbackPublishRequest" } } } }, "security": [ { "yjsWopiSecret": [] } ] } }, "/v0/yjs-wopi/callback/renew": { "post": { "operationId": "platform_post__v0_yjs_wopi_callback_renew", "summary": "callback renew", "tags": [ "yjs_wopi" ], "parameters": [], "description": "Authorization and validation are enforced by the owning service.", "x-handler": "callback_renew", "x-source-file": "crates/synckhub-server/src/routes/yjs_wopi.rs", "x-source-line": 220, "responses": { "default": { "description": "Platform error; branch on HTTP status and stable code, not the human-readable message.", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } } }, "2XX": { "description": "Successful JSON response", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/synckhub_server.routes.yjs_wopi.CallbackRenewResponse" } } } } }, "requestBody": { "required": true, "content": { "application/json": { "schema": { "$ref": "#/components/schemas/synckhub_server.routes.yjs_wopi.CallbackRenewRequest" } } } }, "security": [ { "yjsWopiSecret": [] } ] } }, "/v0/yjs-wopi/callback/save": { "post": { "operationId": "platform_post__v0_yjs_wopi_callback_save", "summary": "callback save", "tags": [ "yjs_wopi" ], "parameters": [], "description": "Authorization and validation are enforced by the owning service.", "x-handler": "callback_save", "x-source-file": "crates/synckhub-server/src/routes/yjs_wopi.rs", "x-source-line": 220, "responses": { "default": { "description": "Platform error; branch on HTTP status and stable code, not the human-readable message.", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } } }, "2XX": { "description": "Successful JSON response", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/synckhub_server.routes.yjs_wopi.CallbackSaveResponse" } } } } }, "requestBody": { "required": true, "content": { "application/json": { "schema": { "$ref": "#/components/schemas/synckhub_server.routes.yjs_wopi.CallbackSaveRequest" } } } }, "security": [ { "yjsWopiSecret": [] } ] } }, "/v0/yjs-wopi/repos/{repo_id}/items/{item_id}/sessions": { "post": { "operationId": "platform_post__v0_yjs_wopi_repos__repo_id__items__item_id__sessions", "summary": "start session", "tags": [ "yjs_wopi" ], "parameters": [ { "name": "repo_id", "in": "path", "required": true, "schema": { "type": "string" } }, { "name": "item_id", "in": "path", "required": true, "schema": { "type": "string" } } ], "description": "Authorization and validation are enforced by the owning service.", "x-handler": "start_session", "x-source-file": "crates/synckhub-server/src/routes/yjs_wopi.rs", "x-source-line": 220, "responses": { "default": { "description": "Platform error; branch on HTTP status and stable code, not the human-readable message.", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } } }, "2XX": { "description": "Successful JSON response", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/synckhub_server.routes.yjs_wopi.StartSessionResponse" } } } } }, "requestBody": { "required": true, "content": { "application/json": { "schema": { "$ref": "#/components/schemas/synckhub_server.routes.yjs_wopi.StartSessionRequest" } } } } } }, "/v1/admin/domain-company-onboarding/personal-data-migrate": { "post": { "operationId": "platform_post__v1_admin_domain_company_onboarding_personal_data_migrate", "summary": "domain company personal data migrate", "tags": [ "admin_onboarding" ], "parameters": [], "description": "Authorization and validation are enforced by the owning service.", "x-handler": "domain_company_personal_data_migrate", "x-source-file": "crates/synckhub-server/src/routes/admin_onboarding.rs", "x-source-line": 9, "responses": { "default": { "description": "Platform error; branch on HTTP status and stable code, not the human-readable message.", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } } }, "2XX": { "description": "Successful JSON response", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/synckhub_server.routes.admin_onboarding.DomainCompanyPersonalDataMigrateResponse" } } } } }, "requestBody": { "required": true, "content": { "application/json": { "schema": { "$ref": "#/components/schemas/synckhub_server.routes.admin_onboarding.DomainCompanyPersonalDataMigrateRequest" } } } } } }, "/v1/admin/domain-company-onboarding/personal-data-preflight": { "post": { "operationId": "platform_post__v1_admin_domain_company_onboarding_personal_data_preflight", "summary": "domain company personal data preflight", "tags": [ "admin_onboarding" ], "parameters": [], "description": "Authorization and validation are enforced by the owning service.", "x-handler": "domain_company_personal_data_preflight", "x-source-file": "crates/synckhub-server/src/routes/admin_onboarding.rs", "x-source-line": 9, "responses": { "default": { "description": "Platform error; branch on HTTP status and stable code, not the human-readable message.", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } } }, "2XX": { "description": "Successful JSON response", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/synckhub_server.routes.admin_onboarding.DomainCompanyPersonalDataPreflightResponse" } } } } }, "requestBody": { "required": true, "content": { "application/json": { "schema": { "$ref": "#/components/schemas/synckhub_server.routes.admin_onboarding.DomainCompanyPersonalDataPreflightRequest" } } } } } }, "/v1/admin/native-mail/domains/{domain}/dns": { "post": { "operationId": "platform_post__v1_admin_native_mail_domains__domain__dns", "summary": "check domain", "tags": [ "mail · native_dns" ], "parameters": [ { "name": "domain", "in": "path", "required": true, "schema": { "type": "string" } } ], "description": "Authorization and validation are enforced by the owning service.", "x-handler": "check_domain", "x-source-file": "crates/synckhub-server/src/routes/mail/native_dns.rs", "x-source-line": 23, "responses": { "default": { "description": "Service response. Error status and envelope depend on the operation." } } } }, "/v1/admin/native-mail/mailboxes/{account_id}/calendar-scheduling": { "get": { "operationId": "platform_get__v1_admin_native_mail_mailboxes__account_id__calendar_scheduling", "summary": "calendar scheduling admin", "tags": [ "mail · native_status" ], "parameters": [ { "name": "account_id", "in": "path", "required": true, "schema": { "type": "string", "format": "uuid" } } ], "description": "Authorization and validation are enforced by the owning service.", "x-handler": "calendar_scheduling_admin", "x-source-file": "crates/synckhub-server/src/routes/mail/native_status.rs", "x-source-line": 28, "responses": { "default": { "description": "Service response. Error status and envelope depend on the operation." } } }, "head": { "operationId": "platform_head__v1_admin_native_mail_mailboxes__account_id__calendar_scheduling", "summary": "calendar scheduling admin", "tags": [ "mail · native_status" ], "parameters": [ { "name": "account_id", "in": "path", "required": true, "schema": { "type": "string", "format": "uuid" } } ], "description": "Authorization and validation are enforced by the owning service.\n\nHEAD uses the GET handler and headers without a response body.", "x-handler": "calendar_scheduling_admin", "x-source-file": "crates/synckhub-server/src/routes/mail/native_status.rs", "x-source-line": 28, "x-implicit-head": true, "responses": { "default": { "description": "Service response. Error status and envelope depend on the operation." } } } }, "/v1/admin/native-mail/mailboxes/{account_id}/incoming-status": { "get": { "operationId": "platform_get__v1_admin_native_mail_mailboxes__account_id__incoming_status", "summary": "incoming admin", "tags": [ "mail · native_status" ], "parameters": [ { "name": "account_id", "in": "path", "required": true, "schema": { "type": "string", "format": "uuid" } }, { "name": "before", "in": "query", "required": false, "schema": { "anyOf": [ { "type": "string" }, { "type": "null" } ] } }, { "name": "limit", "in": "query", "required": false, "schema": { "anyOf": [ { "type": "integer", "minimum": 0 }, { "type": "null" } ] } } ], "description": "Authorization and validation are enforced by the owning service.", "x-handler": "incoming_admin", "x-source-file": "crates/synckhub-server/src/routes/mail/native_status.rs", "x-source-line": 28, "responses": { "default": { "description": "Service response. Error status and envelope depend on the operation." } } }, "head": { "operationId": "platform_head__v1_admin_native_mail_mailboxes__account_id__incoming_status", "summary": "incoming admin", "tags": [ "mail · native_status" ], "parameters": [ { "name": "account_id", "in": "path", "required": true, "schema": { "type": "string", "format": "uuid" } }, { "name": "before", "in": "query", "required": false, "schema": { "anyOf": [ { "type": "string" }, { "type": "null" } ] } }, { "name": "limit", "in": "query", "required": false, "schema": { "anyOf": [ { "type": "integer", "minimum": 0 }, { "type": "null" } ] } } ], "description": "Authorization and validation are enforced by the owning service.\n\nHEAD uses the GET handler and headers without a response body.", "x-handler": "incoming_admin", "x-source-file": "crates/synckhub-server/src/routes/mail/native_status.rs", "x-source-line": 28, "x-implicit-head": true, "responses": { "default": { "description": "Service response. Error status and envelope depend on the operation." } } } }, "/v1/admin/native-mail/mailboxes/{account_id}/status": { "get": { "operationId": "platform_get__v1_admin_native_mail_mailboxes__account_id__status", "summary": "admin", "tags": [ "mail · native_status" ], "parameters": [ { "name": "account_id", "in": "path", "required": true, "schema": { "type": "string", "format": "uuid" } }, { "name": "before", "in": "query", "required": false, "schema": { "anyOf": [ { "type": "string", "format": "uuid" }, { "type": "null" } ] } }, { "name": "limit", "in": "query", "required": false, "schema": { "anyOf": [ { "type": "integer", "minimum": 0 }, { "type": "null" } ] } } ], "description": "Authorization and validation are enforced by the owning service.", "x-handler": "admin", "x-source-file": "crates/synckhub-server/src/routes/mail/native_status.rs", "x-source-line": 28, "responses": { "default": { "description": "Service response. Error status and envelope depend on the operation." } } }, "head": { "operationId": "platform_head__v1_admin_native_mail_mailboxes__account_id__status", "summary": "admin", "tags": [ "mail · native_status" ], "parameters": [ { "name": "account_id", "in": "path", "required": true, "schema": { "type": "string", "format": "uuid" } }, { "name": "before", "in": "query", "required": false, "schema": { "anyOf": [ { "type": "string", "format": "uuid" }, { "type": "null" } ] } }, { "name": "limit", "in": "query", "required": false, "schema": { "anyOf": [ { "type": "integer", "minimum": 0 }, { "type": "null" } ] } } ], "description": "Authorization and validation are enforced by the owning service.\n\nHEAD uses the GET handler and headers without a response body.", "x-handler": "admin", "x-source-file": "crates/synckhub-server/src/routes/mail/native_status.rs", "x-source-line": 28, "x-implicit-head": true, "responses": { "default": { "description": "Service response. Error status and envelope depend on the operation." } } } }, "/v1/admin/native-mail/mailboxes/{account_id}/submissions/{command_id}/transport-status": { "get": { "operationId": "platform_get__v1_admin_native_mail_mailboxes__account_id__submissions__command_id__transport_status", "summary": "transport admin", "tags": [ "mail · native_status" ], "parameters": [ { "name": "account_id", "in": "path", "required": true, "schema": { "type": "string", "format": "uuid" } }, { "name": "command_id", "in": "path", "required": true, "schema": { "type": "string", "format": "uuid" } } ], "description": "Authorization and validation are enforced by the owning service.", "x-handler": "transport_admin", "x-source-file": "crates/synckhub-server/src/routes/mail/native_status.rs", "x-source-line": 28, "responses": { "default": { "description": "Service response. Error status and envelope depend on the operation." } } }, "head": { "operationId": "platform_head__v1_admin_native_mail_mailboxes__account_id__submissions__command_id__transport_status", "summary": "transport admin", "tags": [ "mail · native_status" ], "parameters": [ { "name": "account_id", "in": "path", "required": true, "schema": { "type": "string", "format": "uuid" } }, { "name": "command_id", "in": "path", "required": true, "schema": { "type": "string", "format": "uuid" } } ], "description": "Authorization and validation are enforced by the owning service.\n\nHEAD uses the GET handler and headers without a response body.", "x-handler": "transport_admin", "x-source-file": "crates/synckhub-server/src/routes/mail/native_status.rs", "x-source-line": 28, "x-implicit-head": true, "responses": { "default": { "description": "Service response. Error status and envelope depend on the operation." } } } }, "/v1/admin/native-mail/mailboxes/{mailbox_id}/business-address": { "get": { "operationId": "platform_get__v1_admin_native_mail_mailboxes__mailbox_id__business_address", "summary": "context", "tags": [ "mail · native_shared" ], "parameters": [ { "name": "mailbox_id", "in": "path", "required": true, "schema": { "type": "string", "format": "uuid" } }, { "name": "q", "in": "query", "required": false, "schema": { "type": "string" } } ], "description": "Authorization and validation are enforced by the owning service.", "x-handler": "context", "x-source-file": "crates/synckhub-server/src/routes/mail/native_shared.rs", "x-source-line": 27, "responses": { "default": { "description": "Service response. Error status and envelope depend on the operation." } } }, "head": { "operationId": "platform_head__v1_admin_native_mail_mailboxes__mailbox_id__business_address", "summary": "context", "tags": [ "mail · native_shared" ], "parameters": [ { "name": "mailbox_id", "in": "path", "required": true, "schema": { "type": "string", "format": "uuid" } }, { "name": "q", "in": "query", "required": false, "schema": { "type": "string" } } ], "description": "Authorization and validation are enforced by the owning service.\n\nHEAD uses the GET handler and headers without a response body.", "x-handler": "context", "x-source-file": "crates/synckhub-server/src/routes/mail/native_shared.rs", "x-source-line": 27, "x-implicit-head": true, "responses": { "default": { "description": "Service response. Error status and envelope depend on the operation." } } } }, "/v1/admin/native-mail/mailboxes/{mailbox_id}/dns": { "post": { "operationId": "platform_post__v1_admin_native_mail_mailboxes__mailbox_id__dns", "summary": "check", "tags": [ "mail · native_dns" ], "parameters": [ { "name": "mailbox_id", "in": "path", "required": true, "schema": { "type": "string", "format": "uuid" } } ], "description": "Authorization and validation are enforced by the owning service.", "x-handler": "check", "x-source-file": "crates/synckhub-server/src/routes/mail/native_dns.rs", "x-source-line": 23, "responses": { "default": { "description": "Service response. Error status and envelope depend on the operation." } } } }, "/v1/admin/native-mail/mailboxes/{mailbox_id}/group": { "put": { "operationId": "platform_put__v1_admin_native_mail_mailboxes__mailbox_id__group", "summary": "configure group", "tags": [ "mail · native_shared" ], "parameters": [ { "name": "mailbox_id", "in": "path", "required": true, "schema": { "type": "string", "format": "uuid" } } ], "description": "Authorization and validation are enforced by the owning service.", "x-handler": "configure_group", "x-source-file": "crates/synckhub-server/src/routes/mail/native_shared.rs", "x-source-line": 27, "responses": { "default": { "description": "Service response. Error status and envelope depend on the operation." } }, "requestBody": { "required": true, "content": { "application/json": { "schema": { "$ref": "#/components/schemas/synckhub_server.native_mail.groups.ConfigureGroup" } } } } }, "get": { "operationId": "platform_get__v1_admin_native_mail_mailboxes__mailbox_id__group", "summary": "group", "tags": [ "mail · native_shared" ], "parameters": [ { "name": "mailbox_id", "in": "path", "required": true, "schema": { "type": "string", "format": "uuid" } } ], "description": "Authorization and validation are enforced by the owning service.", "x-handler": "group", "x-source-file": "crates/synckhub-server/src/routes/mail/native_shared.rs", "x-source-line": 27, "responses": { "default": { "description": "Service response. Error status and envelope depend on the operation." } } }, "head": { "operationId": "platform_head__v1_admin_native_mail_mailboxes__mailbox_id__group", "summary": "group", "tags": [ "mail · native_shared" ], "parameters": [ { "name": "mailbox_id", "in": "path", "required": true, "schema": { "type": "string", "format": "uuid" } } ], "description": "Authorization and validation are enforced by the owning service.\n\nHEAD uses the GET handler and headers without a response body.", "x-handler": "group", "x-source-file": "crates/synckhub-server/src/routes/mail/native_shared.rs", "x-source-line": 27, "x-implicit-head": true, "responses": { "default": { "description": "Service response. Error status and envelope depend on the operation." } } } }, "/v1/admin/native-mail/mailboxes/{mailbox_id}/shared-access": { "put": { "operationId": "platform_put__v1_admin_native_mail_mailboxes__mailbox_id__shared_access", "summary": "configure", "tags": [ "mail · native_shared" ], "parameters": [ { "name": "mailbox_id", "in": "path", "required": true, "schema": { "type": "string", "format": "uuid" } } ], "description": "Authorization and validation are enforced by the owning service.", "x-handler": "configure", "x-source-file": "crates/synckhub-server/src/routes/mail/native_shared.rs", "x-source-line": 27, "responses": { "default": { "description": "Service response. Error status and envelope depend on the operation." } }, "requestBody": { "required": true, "content": { "application/json": { "schema": { "$ref": "#/components/schemas/synckhub_server.native_mail.shared.Configure" } } } } }, "get": { "operationId": "platform_get__v1_admin_native_mail_mailboxes__mailbox_id__shared_access", "summary": "read", "tags": [ "mail · native_shared" ], "parameters": [ { "name": "mailbox_id", "in": "path", "required": true, "schema": { "type": "string", "format": "uuid" } } ], "description": "Authorization and validation are enforced by the owning service.", "x-handler": "read", "x-source-file": "crates/synckhub-server/src/routes/mail/native_shared.rs", "x-source-line": 27, "responses": { "default": { "description": "Service response. Error status and envelope depend on the operation." } } }, "head": { "operationId": "platform_head__v1_admin_native_mail_mailboxes__mailbox_id__shared_access", "summary": "read", "tags": [ "mail · native_shared" ], "parameters": [ { "name": "mailbox_id", "in": "path", "required": true, "schema": { "type": "string", "format": "uuid" } } ], "description": "Authorization and validation are enforced by the owning service.\n\nHEAD uses the GET handler and headers without a response body.", "x-handler": "read", "x-source-file": "crates/synckhub-server/src/routes/mail/native_shared.rs", "x-source-line": 27, "x-implicit-head": true, "responses": { "default": { "description": "Service response. Error status and envelope depend on the operation." } } } }, "/v1/admin/native-mail/quarantine-health": { "get": { "operationId": "platform_get__v1_admin_native_mail_quarantine_health", "summary": "health", "tags": [ "mail · native_quarantine" ], "parameters": [], "description": "Authorization and validation are enforced by the owning service.", "x-handler": "health", "x-source-file": "crates/synckhub-server/src/routes/mail/native_quarantine.rs", "x-source-line": 22, "responses": { "default": { "description": "Service response. Error status and envelope depend on the operation." } } }, "head": { "operationId": "platform_head__v1_admin_native_mail_quarantine_health", "summary": "health", "tags": [ "mail · native_quarantine" ], "parameters": [], "description": "Authorization and validation are enforced by the owning service.\n\nHEAD uses the GET handler and headers without a response body.", "x-handler": "health", "x-source-file": "crates/synckhub-server/src/routes/mail/native_quarantine.rs", "x-source-line": 22, "x-implicit-head": true, "responses": { "default": { "description": "Service response. Error status and envelope depend on the operation." } } } }, "/v1/agent/peek_hit": { "post": { "operationId": "platform_post__v1_agent_peek_hit", "summary": "agent peek hit", "tags": [ "retrieval" ], "parameters": [], "description": "Authorization and validation are enforced by the owning service.", "x-handler": "agent_peek_hit", "x-source-file": "crates/synckhub-server/src/routes/retrieval.rs", "x-source-line": 9, "responses": { "default": { "description": "Platform error; branch on HTTP status and stable code, not the human-readable message.", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } } }, "2XX": { "description": "Successful JSON response", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/synckhub_server.routes.retrieval.AgentReadHitsResponse" } } } } }, "requestBody": { "required": true, "content": { "application/json": { "schema": { "$ref": "#/components/schemas/synckhub_server.routes.retrieval.AgentPeekHitRequest" } } } } } }, "/v1/agent/read_hits": { "post": { "operationId": "platform_post__v1_agent_read_hits", "summary": "agent read hits", "tags": [ "retrieval" ], "parameters": [], "description": "Authorization and validation are enforced by the owning service.", "x-handler": "agent_read_hits", "x-source-file": "crates/synckhub-server/src/routes/retrieval.rs", "x-source-line": 9, "responses": { "default": { "description": "Platform error; branch on HTTP status and stable code, not the human-readable message.", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } } }, "2XX": { "description": "Successful JSON response", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/synckhub_server.routes.retrieval.AgentReadHitsResponse" } } } } }, "requestBody": { "required": true, "content": { "application/json": { "schema": { "$ref": "#/components/schemas/synckhub_server.routes.retrieval.AgentReadHitsRequest" } } } } } }, "/v1/agent/text_search_multi": { "post": { "operationId": "platform_post__v1_agent_text_search_multi", "summary": "agent text search multi", "tags": [ "retrieval" ], "parameters": [], "description": "Authorization and validation are enforced by the owning service.", "x-handler": "agent_text_search_multi", "x-source-file": "crates/synckhub-server/src/routes/retrieval.rs", "x-source-line": 9, "responses": { "default": { "description": "Platform error; branch on HTTP status and stable code, not the human-readable message.", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } } }, "2XX": { "description": "Successful JSON response", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/synckhub_server.routes.retrieval.AgentTextSearchMultiResponse" } } } } }, "requestBody": { "required": true, "content": { "application/json": { "schema": { "$ref": "#/components/schemas/synckhub_server.routes.retrieval.AgentTextSearchMultiRequest" } } } } } }, "/v1/ai/usage": { "get": { "operationId": "platform_get__v1_ai_usage", "summary": "Read tenant-bound AI token usage", "tags": [ "ai · runs" ], "parameters": [ { "name": "scope", "in": "query", "required": true, "schema": { "type": "string", "enum": [ "user", "tenant" ] } }, { "name": "tenant_id", "in": "query", "required": true, "schema": { "type": "string", "minLength": 1 } }, { "name": "from", "in": "query", "required": false, "schema": { "type": "string", "format": "date-time" } }, { "name": "to", "in": "query", "required": false, "schema": { "type": "string", "format": "date-time" } } ], "description": "Authorization and validation are enforced by the owning service.", "x-handler": "ai_get_usage", "x-source-file": "crates/synckhub-server/src/routes/ai/runs.rs", "x-source-line": 15, "responses": { "200": { "description": "Token usage summary", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/AiUsageResponse" } } } }, "403": { "description": "Caller is not authorized for the requested tenant scope" } } }, "head": { "operationId": "platform_head__v1_ai_usage", "summary": "ai get usage", "tags": [ "ai · runs" ], "parameters": [ { "name": "scope", "in": "query", "required": true, "schema": { "type": "string" } }, { "name": "tenant_id", "in": "query", "required": true, "schema": { "type": "string" } }, { "name": "from", "in": "query", "required": false, "schema": { "anyOf": [ { "type": "string" }, { "type": "null" } ] } }, { "name": "to", "in": "query", "required": false, "schema": { "anyOf": [ { "type": "string" }, { "type": "null" } ] } } ], "description": "Authorization and validation are enforced by the owning service.\n\nHEAD uses the GET handler and headers without a response body.", "x-handler": "ai_get_usage", "x-source-file": "crates/synckhub-server/src/routes/ai/runs.rs", "x-source-line": 15, "x-implicit-head": true, "responses": { "default": { "description": "Platform error; branch on HTTP status and stable code, not the human-readable message." } } } }, "/v1/ai/usage/users": { "get": { "operationId": "platform_get__v1_ai_usage_users", "summary": "Read paginated per-user AI token usage for a tenant", "tags": [ "ai · runs" ], "parameters": [ { "name": "tenant_id", "in": "query", "required": true, "schema": { "type": "string", "minLength": 1 } }, { "name": "from", "in": "query", "required": false, "schema": { "type": "string", "format": "date-time" } }, { "name": "to", "in": "query", "required": false, "schema": { "type": "string", "format": "date-time" } }, { "name": "limit", "in": "query", "required": false, "schema": { "type": "integer", "minimum": 1, "maximum": 100, "default": 50 } }, { "name": "offset", "in": "query", "required": false, "schema": { "type": "integer", "minimum": 0, "default": 0 } } ], "description": "Authorization and validation are enforced by the owning service.", "x-handler": "ai_get_usage_users", "x-source-file": "crates/synckhub-server/src/routes/ai/runs.rs", "x-source-line": 15, "responses": { "200": { "description": "Paginated tenant user token usage", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/AiUsageUsersResponse" } } } }, "403": { "description": "Caller is not a tenant AI administrator" } } }, "head": { "operationId": "platform_head__v1_ai_usage_users", "summary": "ai get usage users", "tags": [ "ai · runs" ], "parameters": [ { "name": "tenant_id", "in": "query", "required": true, "schema": { "type": "string" } }, { "name": "from", "in": "query", "required": false, "schema": { "anyOf": [ { "type": "string" }, { "type": "null" } ] } }, { "name": "to", "in": "query", "required": false, "schema": { "anyOf": [ { "type": "string" }, { "type": "null" } ] } }, { "name": "limit", "in": "query", "required": false, "schema": { "anyOf": [ { "type": "integer", "minimum": 0 }, { "type": "null" } ] } }, { "name": "offset", "in": "query", "required": false, "schema": { "anyOf": [ { "type": "integer", "minimum": 0 }, { "type": "null" } ] } } ], "description": "Authorization and validation are enforced by the owning service.\n\nHEAD uses the GET handler and headers without a response body.", "x-handler": "ai_get_usage_users", "x-source-file": "crates/synckhub-server/src/routes/ai/runs.rs", "x-source-line": 15, "x-implicit-head": true, "responses": { "default": { "description": "Platform error; branch on HTTP status and stable code, not the human-readable message." } } } }, "/v1/auth/native/authorize": { "get": { "operationId": "platform_get__v1_auth_native_authorize", "summary": "native authorize", "tags": [ "self_hosted_auth" ], "parameters": [ { "name": "response_type", "in": "query", "required": true, "schema": { "type": "string" } }, { "name": "client_id", "in": "query", "required": true, "schema": { "type": "string" } }, { "name": "redirect_uri", "in": "query", "required": true, "schema": { "type": "string" } }, { "name": "code_challenge", "in": "query", "required": true, "schema": { "type": "string" } }, { "name": "code_challenge_method", "in": "query", "required": true, "schema": { "type": "string" } }, { "name": "state", "in": "query", "required": true, "schema": { "type": "string" } } ], "description": "Authorization and validation are enforced by the owning service.", "x-handler": "native_authorize", "x-source-file": "crates/synckhub-server/src/self_hosted_auth.rs", "x-source-line": 2784, "responses": { "default": { "description": "Service response. Error status and envelope depend on the operation." } }, "security": [] }, "head": { "operationId": "platform_head__v1_auth_native_authorize", "summary": "native authorize", "tags": [ "self_hosted_auth" ], "parameters": [ { "name": "response_type", "in": "query", "required": true, "schema": { "type": "string" } }, { "name": "client_id", "in": "query", "required": true, "schema": { "type": "string" } }, { "name": "redirect_uri", "in": "query", "required": true, "schema": { "type": "string" } }, { "name": "code_challenge", "in": "query", "required": true, "schema": { "type": "string" } }, { "name": "code_challenge_method", "in": "query", "required": true, "schema": { "type": "string" } }, { "name": "state", "in": "query", "required": true, "schema": { "type": "string" } } ], "description": "Authorization and validation are enforced by the owning service.\n\nHEAD uses the GET handler and headers without a response body.", "x-handler": "native_authorize", "x-source-file": "crates/synckhub-server/src/self_hosted_auth.rs", "x-source-line": 2784, "x-implicit-head": true, "responses": { "default": { "description": "Service response. Error status and envelope depend on the operation." } }, "security": [] } }, "/v1/auth/native/authorize/complete": { "post": { "operationId": "platform_post__v1_auth_native_authorize_complete", "summary": "native authorize complete", "tags": [ "self_hosted_auth" ], "parameters": [], "description": "Authorization and validation are enforced by the owning service.", "x-handler": "native_authorize_complete", "x-source-file": "crates/synckhub-server/src/self_hosted_auth.rs", "x-source-line": 2813, "responses": { "default": { "description": "Service response. Error status and envelope depend on the operation." } }, "requestBody": { "required": true, "content": { "application/json": { "schema": { "$ref": "#/components/schemas/synckhub_server.self_hosted_auth.NativeAuthorizeRequest" } } } } } }, "/v1/auth/native/revoke": { "post": { "operationId": "platform_post__v1_auth_native_revoke", "summary": "native revoke", "tags": [ "self_hosted_auth" ], "parameters": [], "description": "Authorization and validation are enforced by the owning service.", "x-handler": "native_revoke", "x-source-file": "crates/synckhub-server/src/self_hosted_auth.rs", "x-source-line": 2784, "responses": { "default": { "description": "Service response. Error status and envelope depend on the operation." } }, "requestBody": { "required": true, "content": { "application/x-www-form-urlencoded": { "schema": { "$ref": "#/components/schemas/synckhub_server.self_hosted_auth.NativeRevokeRequest" } } } }, "security": [] } }, "/v1/auth/native/token": { "post": { "operationId": "platform_post__v1_auth_native_token", "summary": "native token", "tags": [ "self_hosted_auth" ], "parameters": [], "description": "Authorization and validation are enforced by the owning service.", "x-handler": "native_token", "x-source-file": "crates/synckhub-server/src/self_hosted_auth.rs", "x-source-line": 2784, "responses": { "default": { "description": "Service response. Error status and envelope depend on the operation." } }, "requestBody": { "required": true, "content": { "application/x-www-form-urlencoded": { "schema": { "$ref": "#/components/schemas/synckhub_server.self_hosted_auth.NativeTokenRequest" } } } }, "security": [] } }, "/v1/downloads/{token}": { "get": { "operationId": "platform_get__v1_downloads__token_", "summary": "download by token", "tags": [ "command_runner" ], "parameters": [ { "name": "token", "in": "path", "required": true, "schema": { "type": "string" } } ], "description": "Authorization and validation are enforced by the owning service.\n\nThis route does not require the normal user bearer session. Link/download tokens, OAuth state, or webhook verification are validated by its handler where applicable.", "x-handler": "download_by_token", "x-source-file": "crates/synckhub-server/src/routes/command_runner.rs", "x-source-line": 11, "responses": { "default": { "description": "Platform error; branch on HTTP status and stable code, not the human-readable message.", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } } } }, "security": [] }, "head": { "operationId": "platform_head__v1_downloads__token_", "summary": "download by token", "tags": [ "command_runner" ], "parameters": [ { "name": "token", "in": "path", "required": true, "schema": { "type": "string" } } ], "description": "Authorization and validation are enforced by the owning service.\n\nHEAD uses the GET handler and headers without a response body.", "x-handler": "download_by_token", "x-source-file": "crates/synckhub-server/src/routes/command_runner.rs", "x-source-line": 11, "x-implicit-head": true, "responses": { "default": { "description": "Platform error; branch on HTTP status and stable code, not the human-readable message." } } } }, "/v1/folder-auto-join-links/{folder_auto_join_link_token}/claim": { "post": { "operationId": "platform_post__v1_folder_auto_join_links__folder_auto_join_link_token__claim", "summary": "authenticated claim folder auto join link", "tags": [ "sharing" ], "parameters": [ { "name": "folder_auto_join_link_token", "in": "path", "required": true, "schema": { "type": "string" } } ], "description": "Authorization and validation are enforced by the owning service.", "x-handler": "crate::folder_auto_join_links::authenticated_claim_folder_auto_join_link", "x-source-file": "crates/synckhub-server/src/routes/sharing.rs", "x-source-line": 7, "responses": { "default": { "description": "Platform error; branch on HTTP status and stable code, not the human-readable message.", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } } }, "2XX": { "description": "Successful JSON response", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/synckhub_server.folder_auto_join_links.VerifyFolderAutoJoinLinkClaimResponse" } } } } } } }, "/v1/folders/tree": { "post": { "operationId": "platform_post__v1_folders_tree", "summary": "create folder tree", "tags": [ "uploads" ], "parameters": [], "description": "Authorization and validation are enforced by the owning service.", "x-handler": "create_folder_tree", "x-source-file": "crates/synckhub-server/src/routes/uploads.rs", "x-source-line": 980, "responses": { "default": { "description": "Platform error; branch on HTTP status and stable code, not the human-readable message.", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } } }, "2XX": { "description": "Successful JSON response", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/synckhub_server.routes.uploads.CreateFolderTreeResponse" } } } } }, "requestBody": { "required": true, "content": { "application/json": { "schema": { "$ref": "#/components/schemas/synckhub_server.routes.uploads.CreateFolderTreeRequest" } } } } } }, "/v1/integrations/mailcal/accounts": { "get": { "operationId": "platform_get__v1_integrations_mailcal_accounts", "summary": "list accounts", "tags": [ "connected_accounts · accounts" ], "parameters": [], "description": "Authorization and validation are enforced by the owning service.", "x-handler": "list_accounts", "x-source-file": "crates/synckhub-server/src/routes/connected_accounts/accounts.rs", "x-source-line": 51, "responses": { "default": { "description": "Service response. Error status and envelope depend on the operation." }, "2XX": { "description": "Successful JSON response", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/synckhub_server.routes.connected_accounts.accounts.AccountsResponse" } } } } } }, "head": { "operationId": "platform_head__v1_integrations_mailcal_accounts", "summary": "list accounts", "tags": [ "connected_accounts · accounts" ], "parameters": [], "description": "Authorization and validation are enforced by the owning service.\n\nHEAD uses the GET handler and headers without a response body.", "x-handler": "list_accounts", "x-source-file": "crates/synckhub-server/src/routes/connected_accounts/accounts.rs", "x-source-line": 51, "x-implicit-head": true, "responses": { "default": { "description": "Service response. Error status and envelope depend on the operation." } } } }, "/v1/integrations/mailcal/accounts/{account_id}": { "delete": { "operationId": "platform_delete__v1_integrations_mailcal_accounts__account_id_", "summary": "delete account", "tags": [ "connected_accounts · accounts" ], "parameters": [ { "name": "account_id", "in": "path", "required": true, "schema": { "type": "string" } } ], "description": "Authorization and validation are enforced by the owning service.", "x-handler": "delete_account", "x-source-file": "crates/synckhub-server/src/routes/connected_accounts/accounts.rs", "x-source-line": 51, "responses": { "default": { "description": "Service response. Error status and envelope depend on the operation." } } } }, "/v1/integrations/mailcal/accounts/{account_id}/calendar-invitations": { "get": { "operationId": "platform_get__v1_integrations_mailcal_accounts__account_id__calendar_invitations", "summary": "list", "tags": [ "mail · native_calendar_invitations" ], "parameters": [ { "name": "account_id", "in": "path", "required": true, "schema": { "type": "string", "format": "uuid" } }, { "name": "before", "in": "query", "required": false, "schema": { "anyOf": [ { "type": "string", "format": "uuid" }, { "type": "null" } ] } } ], "description": "Authorization and validation are enforced by the owning service.", "x-handler": "list", "x-source-file": "crates/synckhub-server/src/routes/mail/native_calendar_invitations.rs", "x-source-line": 29, "responses": { "default": { "description": "Service response. Error status and envelope depend on the operation." } } }, "head": { "operationId": "platform_head__v1_integrations_mailcal_accounts__account_id__calendar_invitations", "summary": "list", "tags": [ "mail · native_calendar_invitations" ], "parameters": [ { "name": "account_id", "in": "path", "required": true, "schema": { "type": "string", "format": "uuid" } }, { "name": "before", "in": "query", "required": false, "schema": { "anyOf": [ { "type": "string", "format": "uuid" }, { "type": "null" } ] } } ], "description": "Authorization and validation are enforced by the owning service.\n\nHEAD uses the GET handler and headers without a response body.", "x-handler": "list", "x-source-file": "crates/synckhub-server/src/routes/mail/native_calendar_invitations.rs", "x-source-line": 29, "x-implicit-head": true, "responses": { "default": { "description": "Service response. Error status and envelope depend on the operation." } } } }, "/v1/integrations/mailcal/accounts/{account_id}/calendar-invitations/{invitation_id}": { "get": { "operationId": "platform_get__v1_integrations_mailcal_accounts__account_id__calendar_invitations__invitation_id_", "summary": "preview", "tags": [ "mail · native_calendar_invitations" ], "parameters": [ { "name": "account_id", "in": "path", "required": true, "schema": { "type": "string", "format": "uuid" } }, { "name": "invitation_id", "in": "path", "required": true, "schema": { "type": "string", "format": "uuid" } }, { "name": "time_zone", "in": "query", "required": true, "schema": { "type": "string" } } ], "description": "Authorization and validation are enforced by the owning service.", "x-handler": "preview", "x-source-file": "crates/synckhub-server/src/routes/mail/native_calendar_invitations.rs", "x-source-line": 29, "responses": { "default": { "description": "Service response. Error status and envelope depend on the operation." } } }, "head": { "operationId": "platform_head__v1_integrations_mailcal_accounts__account_id__calendar_invitations__invitation_id_", "summary": "preview", "tags": [ "mail · native_calendar_invitations" ], "parameters": [ { "name": "account_id", "in": "path", "required": true, "schema": { "type": "string", "format": "uuid" } }, { "name": "invitation_id", "in": "path", "required": true, "schema": { "type": "string", "format": "uuid" } }, { "name": "time_zone", "in": "query", "required": true, "schema": { "type": "string" } } ], "description": "Authorization and validation are enforced by the owning service.\n\nHEAD uses the GET handler and headers without a response body.", "x-handler": "preview", "x-source-file": "crates/synckhub-server/src/routes/mail/native_calendar_invitations.rs", "x-source-line": 29, "x-implicit-head": true, "responses": { "default": { "description": "Service response. Error status and envelope depend on the operation." } } } }, "/v1/integrations/mailcal/accounts/{account_id}/calendar-invitations/{invitation_id}/dismiss": { "post": { "operationId": "platform_post__v1_integrations_mailcal_accounts__account_id__calendar_invitations__invitation_id__dismiss", "summary": "dismiss", "tags": [ "mail · native_calendar_invitations" ], "parameters": [ { "name": "account_id", "in": "path", "required": true, "schema": { "type": "string", "format": "uuid" } }, { "name": "invitation_id", "in": "path", "required": true, "schema": { "type": "string", "format": "uuid" } } ], "description": "Authorization and validation are enforced by the owning service.", "x-handler": "dismiss", "x-source-file": "crates/synckhub-server/src/routes/mail/native_calendar_invitations.rs", "x-source-line": 29, "responses": { "default": { "description": "Service response. Error status and envelope depend on the operation." } } } }, "/v1/integrations/mailcal/accounts/{account_id}/calendar-invitations/{invitation_id}/response": { "post": { "operationId": "platform_post__v1_integrations_mailcal_accounts__account_id__calendar_invitations__invitation_id__response", "summary": "response", "tags": [ "mail · native_calendar_invitations" ], "parameters": [ { "name": "account_id", "in": "path", "required": true, "schema": { "type": "string", "format": "uuid" } }, { "name": "invitation_id", "in": "path", "required": true, "schema": { "type": "string", "format": "uuid" } } ], "description": "Authorization and validation are enforced by the owning service.", "x-handler": "response", "x-source-file": "crates/synckhub-server/src/routes/mail/native_calendar_invitations.rs", "x-source-line": 29, "responses": { "default": { "description": "Service response. Error status and envelope depend on the operation." } }, "requestBody": { "required": true, "content": { "application/json": { "schema": { "$ref": "#/components/schemas/synckhub_core.external_scheduling.state.RespondIncomingInvitation" } } } } } }, "/v1/integrations/mailcal/accounts/{account_id}/calendar-invitations/{invitation_id}/source": { "get": { "operationId": "platform_get__v1_integrations_mailcal_accounts__account_id__calendar_invitations__invitation_id__source", "summary": "source", "tags": [ "mail · native_calendar_invitations" ], "parameters": [ { "name": "account_id", "in": "path", "required": true, "schema": { "type": "string", "format": "uuid" } }, { "name": "invitation_id", "in": "path", "required": true, "schema": { "type": "string", "format": "uuid" } } ], "description": "Authorization and validation are enforced by the owning service.", "x-handler": "source", "x-source-file": "crates/synckhub-server/src/routes/mail/native_calendar_invitations.rs", "x-source-line": 29, "responses": { "default": { "description": "Service response. Error status and envelope depend on the operation." } } }, "head": { "operationId": "platform_head__v1_integrations_mailcal_accounts__account_id__calendar_invitations__invitation_id__source", "summary": "source", "tags": [ "mail · native_calendar_invitations" ], "parameters": [ { "name": "account_id", "in": "path", "required": true, "schema": { "type": "string", "format": "uuid" } }, { "name": "invitation_id", "in": "path", "required": true, "schema": { "type": "string", "format": "uuid" } } ], "description": "Authorization and validation are enforced by the owning service.\n\nHEAD uses the GET handler and headers without a response body.", "x-handler": "source", "x-source-file": "crates/synckhub-server/src/routes/mail/native_calendar_invitations.rs", "x-source-line": 29, "x-implicit-head": true, "responses": { "default": { "description": "Service response. Error status and envelope depend on the operation." } } } }, "/v1/integrations/mailcal/accounts/{account_id}/calendar/availability/query": { "post": { "operationId": "platform_post__v1_integrations_mailcal_accounts__account_id__calendar_availability_query", "summary": "query availability", "tags": [ "calendar · scheduling" ], "parameters": [ { "name": "account_id", "in": "path", "required": true, "schema": { "type": "string" } } ], "description": "Authorization and validation are enforced by the owning service.", "x-handler": "query_availability", "x-source-file": "crates/synckhub-server/src/routes/calendar/scheduling.rs", "x-source-line": 25, "responses": { "default": { "description": "Service response. Error status and envelope depend on the operation." }, "2XX": { "description": "Successful JSON response", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/synckhub_server.routes.calendar.scheduling.CalendarAvailabilityResponse" } } } } }, "requestBody": { "required": true, "content": { "application/json": { "schema": { "$ref": "#/components/schemas/synckhub_mailcal.types.CalendarAvailabilityQuery" } } } } } }, "/v1/integrations/mailcal/accounts/{account_id}/calendar/calendars": { "get": { "operationId": "platform_get__v1_integrations_mailcal_accounts__account_id__calendar_calendars", "summary": "list calendars", "tags": [ "calendar · collections" ], "parameters": [ { "name": "account_id", "in": "path", "required": true, "schema": { "type": "string" } } ], "description": "Authorization and validation are enforced by the owning service.", "x-handler": "list_calendars", "x-source-file": "crates/synckhub-server/src/routes/calendar/collections.rs", "x-source-line": 22, "responses": { "default": { "description": "Service response. Error status and envelope depend on the operation." }, "2XX": { "description": "Successful JSON response", "content": { "application/json": { "schema": {} } } } } }, "head": { "operationId": "platform_head__v1_integrations_mailcal_accounts__account_id__calendar_calendars", "summary": "list calendars", "tags": [ "calendar · collections" ], "parameters": [ { "name": "account_id", "in": "path", "required": true, "schema": { "type": "string" } } ], "description": "Authorization and validation are enforced by the owning service.\n\nHEAD uses the GET handler and headers without a response body.", "x-handler": "list_calendars", "x-source-file": "crates/synckhub-server/src/routes/calendar/collections.rs", "x-source-line": 22, "x-implicit-head": true, "responses": { "default": { "description": "Service response. Error status and envelope depend on the operation." } } } }, "/v1/integrations/mailcal/accounts/{account_id}/calendar/capabilities": { "get": { "operationId": "platform_get__v1_integrations_mailcal_accounts__account_id__calendar_capabilities", "summary": "calendar capabilities", "tags": [ "calendar · collections" ], "parameters": [ { "name": "account_id", "in": "path", "required": true, "schema": { "type": "string" } } ], "description": "Authorization and validation are enforced by the owning service.", "x-handler": "calendar_capabilities", "x-source-file": "crates/synckhub-server/src/routes/calendar/collections.rs", "x-source-line": 22, "responses": { "default": { "description": "Service response. Error status and envelope depend on the operation." }, "2XX": { "description": "Successful JSON response", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/synckhub_mailcal.types.CalendarCapabilities" } } } } } }, "head": { "operationId": "platform_head__v1_integrations_mailcal_accounts__account_id__calendar_capabilities", "summary": "calendar capabilities", "tags": [ "calendar · collections" ], "parameters": [ { "name": "account_id", "in": "path", "required": true, "schema": { "type": "string" } } ], "description": "Authorization and validation are enforced by the owning service.\n\nHEAD uses the GET handler and headers without a response body.", "x-handler": "calendar_capabilities", "x-source-file": "crates/synckhub-server/src/routes/calendar/collections.rs", "x-source-line": 22, "x-implicit-head": true, "responses": { "default": { "description": "Service response. Error status and envelope depend on the operation." } } } }, "/v1/integrations/mailcal/accounts/{account_id}/calendar/commands": { "post": { "operationId": "platform_post__v1_integrations_mailcal_accounts__account_id__calendar_commands", "summary": "enqueue calendar command", "tags": [ "calendar · commands" ], "parameters": [ { "name": "account_id", "in": "path", "required": true, "schema": { "type": "string" } } ], "description": "Authorization and validation are enforced by the owning service.", "x-handler": "enqueue_calendar_command", "x-source-file": "crates/synckhub-server/src/routes/calendar/commands.rs", "x-source-line": 20, "responses": { "default": { "description": "Service response. Error status and envelope depend on the operation." }, "2XX": { "description": "Successful JSON response", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/synckhub_server.routes.calendar.commands.CalendarCommandResponse" } } } } }, "requestBody": { "required": true, "content": { "application/json": { "schema": { "$ref": "#/components/schemas/synckhub_server.mailcal.calendar_command.CalendarCommandEnvelope" } } } } } }, "/v1/integrations/mailcal/accounts/{account_id}/calendar/commands/{job_id}": { "get": { "operationId": "platform_get__v1_integrations_mailcal_accounts__account_id__calendar_commands__job_id_", "summary": "get calendar command", "tags": [ "calendar · commands" ], "parameters": [ { "name": "account_id", "in": "path", "required": true, "schema": { "type": "string" } }, { "name": "job_id", "in": "path", "required": true, "schema": { "type": "string" } } ], "description": "Authorization and validation are enforced by the owning service.", "x-handler": "get_calendar_command", "x-source-file": "crates/synckhub-server/src/routes/calendar/commands.rs", "x-source-line": 20, "responses": { "default": { "description": "Service response. Error status and envelope depend on the operation." }, "2XX": { "description": "Successful JSON response", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/synckhub_server.routes.calendar.commands.CalendarCommandResponse" } } } } } }, "head": { "operationId": "platform_head__v1_integrations_mailcal_accounts__account_id__calendar_commands__job_id_", "summary": "get calendar command", "tags": [ "calendar · commands" ], "parameters": [ { "name": "account_id", "in": "path", "required": true, "schema": { "type": "string" } }, { "name": "job_id", "in": "path", "required": true, "schema": { "type": "string" } } ], "description": "Authorization and validation are enforced by the owning service.\n\nHEAD uses the GET handler and headers without a response body.", "x-handler": "get_calendar_command", "x-source-file": "crates/synckhub-server/src/routes/calendar/commands.rs", "x-source-line": 20, "x-implicit-head": true, "responses": { "default": { "description": "Service response. Error status and envelope depend on the operation." } } } }, "/v1/integrations/mailcal/accounts/{account_id}/calendar/events": { "post": { "operationId": "platform_post__v1_integrations_mailcal_accounts__account_id__calendar_events", "summary": "create event", "tags": [ "calendar · events" ], "parameters": [ { "name": "account_id", "in": "path", "required": true, "schema": { "type": "string" } }, { "name": "calendar_id", "in": "query", "required": false, "schema": { "anyOf": [ { "type": "string" }, { "type": "null" } ] } }, { "name": "edit_scope", "in": "query", "required": false, "schema": { "anyOf": [ { "type": "string" }, { "type": "null" } ] } }, { "name": "provider_version", "in": "query", "required": false, "schema": { "anyOf": [ { "type": "string" }, { "type": "null" } ] } } ], "description": "Authorization and validation are enforced by the owning service.", "x-handler": "create_event", "x-source-file": "crates/synckhub-server/src/routes/calendar/events.rs", "x-source-line": 42, "responses": { "default": { "description": "Service response. Error status and envelope depend on the operation." }, "2XX": { "description": "Successful JSON response", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/synckhub_mailcal.types.CalendarEvent" } } } } }, "requestBody": { "required": true, "content": { "application/json": { "schema": { "$ref": "#/components/schemas/synckhub_mailcal.types.CalendarEvent" } } } } }, "get": { "operationId": "platform_get__v1_integrations_mailcal_accounts__account_id__calendar_events", "summary": "list events", "tags": [ "calendar · events" ], "parameters": [ { "name": "account_id", "in": "path", "required": true, "schema": { "type": "string" } }, { "name": "calendar_id", "in": "query", "required": false, "schema": { "anyOf": [ { "type": "string" }, { "type": "null" } ] } }, { "name": "start", "in": "query", "required": true, "schema": { "type": "string" } }, { "name": "end", "in": "query", "required": true, "schema": { "type": "string" } }, { "name": "q", "in": "query", "required": false, "schema": { "anyOf": [ { "type": "string" }, { "type": "null" } ] } }, { "name": "q_mode", "in": "query", "required": false, "schema": { "anyOf": [ { "type": "string" }, { "type": "null" } ] } }, { "name": "page_size", "in": "query", "required": false, "schema": { "anyOf": [ { "type": "integer", "minimum": 0 }, { "type": "null" } ] } }, { "name": "page_token", "in": "query", "required": false, "schema": { "anyOf": [ { "type": "string" }, { "type": "null" } ] } } ], "description": "Authorization and validation are enforced by the owning service.", "x-handler": "list_events", "x-source-file": "crates/synckhub-server/src/routes/calendar/events.rs", "x-source-line": 42, "responses": { "default": { "description": "Service response. Error status and envelope depend on the operation." } } }, "head": { "operationId": "platform_head__v1_integrations_mailcal_accounts__account_id__calendar_events", "summary": "list events", "tags": [ "calendar · events" ], "parameters": [ { "name": "account_id", "in": "path", "required": true, "schema": { "type": "string" } }, { "name": "calendar_id", "in": "query", "required": false, "schema": { "anyOf": [ { "type": "string" }, { "type": "null" } ] } }, { "name": "start", "in": "query", "required": true, "schema": { "type": "string" } }, { "name": "end", "in": "query", "required": true, "schema": { "type": "string" } }, { "name": "q", "in": "query", "required": false, "schema": { "anyOf": [ { "type": "string" }, { "type": "null" } ] } }, { "name": "q_mode", "in": "query", "required": false, "schema": { "anyOf": [ { "type": "string" }, { "type": "null" } ] } }, { "name": "page_size", "in": "query", "required": false, "schema": { "anyOf": [ { "type": "integer", "minimum": 0 }, { "type": "null" } ] } }, { "name": "page_token", "in": "query", "required": false, "schema": { "anyOf": [ { "type": "string" }, { "type": "null" } ] } } ], "description": "Authorization and validation are enforced by the owning service.\n\nHEAD uses the GET handler and headers without a response body.", "x-handler": "list_events", "x-source-file": "crates/synckhub-server/src/routes/calendar/events.rs", "x-source-line": 42, "x-implicit-head": true, "responses": { "default": { "description": "Service response. Error status and envelope depend on the operation." } } } }, "/v1/integrations/mailcal/accounts/{account_id}/calendar/events/{event_id}": { "delete": { "operationId": "platform_delete__v1_integrations_mailcal_accounts__account_id__calendar_events__event_id_", "summary": "delete event", "tags": [ "calendar · events" ], "parameters": [ { "name": "account_id", "in": "path", "required": true, "schema": { "type": "string" } }, { "name": "event_id", "in": "path", "required": true, "schema": { "type": "string" } }, { "name": "calendar_id", "in": "query", "required": false, "schema": { "anyOf": [ { "type": "string" }, { "type": "null" } ] } }, { "name": "edit_scope", "in": "query", "required": false, "schema": { "anyOf": [ { "type": "string" }, { "type": "null" } ] } }, { "name": "notify_attendees", "in": "query", "required": false, "schema": { "anyOf": [ { "type": "boolean" }, { "type": "null" } ] } } ], "description": "Authorization and validation are enforced by the owning service.", "x-handler": "delete_event", "x-source-file": "crates/synckhub-server/src/routes/calendar/events.rs", "x-source-line": 42, "responses": { "default": { "description": "Service response. Error status and envelope depend on the operation." } } }, "patch": { "operationId": "platform_patch__v1_integrations_mailcal_accounts__account_id__calendar_events__event_id_", "summary": "update event", "tags": [ "calendar · events" ], "parameters": [ { "name": "account_id", "in": "path", "required": true, "schema": { "type": "string" } }, { "name": "event_id", "in": "path", "required": true, "schema": { "type": "string" } }, { "name": "calendar_id", "in": "query", "required": false, "schema": { "anyOf": [ { "type": "string" }, { "type": "null" } ] } }, { "name": "edit_scope", "in": "query", "required": false, "schema": { "anyOf": [ { "type": "string" }, { "type": "null" } ] } }, { "name": "provider_version", "in": "query", "required": false, "schema": { "anyOf": [ { "type": "string" }, { "type": "null" } ] } } ], "description": "Authorization and validation are enforced by the owning service.", "x-handler": "update_event", "x-source-file": "crates/synckhub-server/src/routes/calendar/events.rs", "x-source-line": 42, "responses": { "default": { "description": "Service response. Error status and envelope depend on the operation." }, "2XX": { "description": "Successful JSON response", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/synckhub_mailcal.types.CalendarEvent" } } } } }, "requestBody": { "required": true, "content": { "application/json": { "schema": { "$ref": "#/components/schemas/synckhub_mailcal.types.CalendarEvent" } } } } }, "get": { "operationId": "platform_get__v1_integrations_mailcal_accounts__account_id__calendar_events__event_id_", "summary": "get event", "tags": [ "calendar · events" ], "parameters": [ { "name": "account_id", "in": "path", "required": true, "schema": { "type": "string" } }, { "name": "event_id", "in": "path", "required": true, "schema": { "type": "string" } }, { "name": "calendar_id", "in": "query", "required": false, "schema": { "anyOf": [ { "type": "string" }, { "type": "null" } ] } }, { "name": "edit_scope", "in": "query", "required": false, "schema": { "anyOf": [ { "type": "string" }, { "type": "null" } ] } }, { "name": "provider_version", "in": "query", "required": false, "schema": { "anyOf": [ { "type": "string" }, { "type": "null" } ] } } ], "description": "Authorization and validation are enforced by the owning service.", "x-handler": "get_event", "x-source-file": "crates/synckhub-server/src/routes/calendar/events.rs", "x-source-line": 42, "responses": { "default": { "description": "Service response. Error status and envelope depend on the operation." }, "2XX": { "description": "Successful JSON response", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/synckhub_mailcal.types.CalendarEvent" } } } } } }, "head": { "operationId": "platform_head__v1_integrations_mailcal_accounts__account_id__calendar_events__event_id_", "summary": "get event", "tags": [ "calendar · events" ], "parameters": [ { "name": "account_id", "in": "path", "required": true, "schema": { "type": "string" } }, { "name": "event_id", "in": "path", "required": true, "schema": { "type": "string" } }, { "name": "calendar_id", "in": "query", "required": false, "schema": { "anyOf": [ { "type": "string" }, { "type": "null" } ] } }, { "name": "edit_scope", "in": "query", "required": false, "schema": { "anyOf": [ { "type": "string" }, { "type": "null" } ] } }, { "name": "provider_version", "in": "query", "required": false, "schema": { "anyOf": [ { "type": "string" }, { "type": "null" } ] } } ], "description": "Authorization and validation are enforced by the owning service.\n\nHEAD uses the GET handler and headers without a response body.", "x-handler": "get_event", "x-source-file": "crates/synckhub-server/src/routes/calendar/events.rs", "x-source-line": 42, "x-implicit-head": true, "responses": { "default": { "description": "Service response. Error status and envelope depend on the operation." } } } }, "/v1/integrations/mailcal/accounts/{account_id}/calendar/events/{event_id}/move": { "post": { "operationId": "platform_post__v1_integrations_mailcal_accounts__account_id__calendar_events__event_id__move", "summary": "move event", "tags": [ "calendar · events" ], "parameters": [ { "name": "account_id", "in": "path", "required": true, "schema": { "type": "string" } }, { "name": "event_id", "in": "path", "required": true, "schema": { "type": "string" } }, { "name": "calendar_id", "in": "query", "required": false, "schema": { "anyOf": [ { "type": "string" }, { "type": "null" } ] } }, { "name": "edit_scope", "in": "query", "required": false, "schema": { "anyOf": [ { "type": "string" }, { "type": "null" } ] } }, { "name": "provider_version", "in": "query", "required": false, "schema": { "anyOf": [ { "type": "string" }, { "type": "null" } ] } } ], "description": "Authorization and validation are enforced by the owning service.", "x-handler": "move_event", "x-source-file": "crates/synckhub-server/src/routes/calendar/events.rs", "x-source-line": 42, "responses": { "default": { "description": "Service response. Error status and envelope depend on the operation." }, "2XX": { "description": "Successful JSON response", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/synckhub_server.routes.calendar.events.MoveEventResponse" } } } } }, "requestBody": { "required": true, "content": { "application/json": { "schema": { "$ref": "#/components/schemas/synckhub_server.routes.calendar.events.MoveEventRequest" } } } } } }, "/v1/integrations/mailcal/accounts/{account_id}/calendar/events/{event_id}/rsvp": { "post": { "operationId": "platform_post__v1_integrations_mailcal_accounts__account_id__calendar_events__event_id__rsvp", "summary": "rsvp event", "tags": [ "calendar · events" ], "parameters": [ { "name": "account_id", "in": "path", "required": true, "schema": { "type": "string" } }, { "name": "event_id", "in": "path", "required": true, "schema": { "type": "string" } } ], "description": "Authorization and validation are enforced by the owning service.", "x-handler": "rsvp_event", "x-source-file": "crates/synckhub-server/src/routes/calendar/events.rs", "x-source-line": 42, "responses": { "default": { "description": "Service response. Error status and envelope depend on the operation." } }, "requestBody": { "required": true, "content": { "application/json": { "schema": { "$ref": "#/components/schemas/synckhub_server.routes.calendar.events.RsvpRequest" } } } } } }, "/v1/integrations/mailcal/accounts/{account_id}/calendar/events/search": { "get": { "operationId": "platform_get__v1_integrations_mailcal_accounts__account_id__calendar_events_search", "summary": "search events", "tags": [ "calendar · events" ], "parameters": [ { "name": "account_id", "in": "path", "required": true, "schema": { "type": "string" } }, { "name": "calendar_id", "in": "query", "required": false, "schema": { "anyOf": [ { "type": "string" }, { "type": "null" } ] } }, { "name": "q", "in": "query", "required": true, "schema": { "type": "string" } }, { "name": "page_size", "in": "query", "required": false, "schema": { "anyOf": [ { "type": "integer", "minimum": 0 }, { "type": "null" } ] } }, { "name": "page_token", "in": "query", "required": false, "schema": { "anyOf": [ { "type": "string" }, { "type": "null" } ] } }, { "name": "start", "in": "query", "required": false, "schema": { "anyOf": [ { "type": "string" }, { "type": "null" } ] } }, { "name": "end", "in": "query", "required": false, "schema": { "anyOf": [ { "type": "string" }, { "type": "null" } ] } }, { "name": "q_mode", "in": "query", "required": false, "schema": { "anyOf": [ { "type": "string" }, { "type": "null" } ] } } ], "description": "Authorization and validation are enforced by the owning service.", "x-handler": "search_events", "x-source-file": "crates/synckhub-server/src/routes/calendar/events.rs", "x-source-line": 42, "responses": { "default": { "description": "Service response. Error status and envelope depend on the operation." } } }, "head": { "operationId": "platform_head__v1_integrations_mailcal_accounts__account_id__calendar_events_search", "summary": "search events", "tags": [ "calendar · events" ], "parameters": [ { "name": "account_id", "in": "path", "required": true, "schema": { "type": "string" } }, { "name": "calendar_id", "in": "query", "required": false, "schema": { "anyOf": [ { "type": "string" }, { "type": "null" } ] } }, { "name": "q", "in": "query", "required": true, "schema": { "type": "string" } }, { "name": "page_size", "in": "query", "required": false, "schema": { "anyOf": [ { "type": "integer", "minimum": 0 }, { "type": "null" } ] } }, { "name": "page_token", "in": "query", "required": false, "schema": { "anyOf": [ { "type": "string" }, { "type": "null" } ] } }, { "name": "start", "in": "query", "required": false, "schema": { "anyOf": [ { "type": "string" }, { "type": "null" } ] } }, { "name": "end", "in": "query", "required": false, "schema": { "anyOf": [ { "type": "string" }, { "type": "null" } ] } }, { "name": "q_mode", "in": "query", "required": false, "schema": { "anyOf": [ { "type": "string" }, { "type": "null" } ] } } ], "description": "Authorization and validation are enforced by the owning service.\n\nHEAD uses the GET handler and headers without a response body.", "x-handler": "search_events", "x-source-file": "crates/synckhub-server/src/routes/calendar/events.rs", "x-source-line": 42, "x-implicit-head": true, "responses": { "default": { "description": "Service response. Error status and envelope depend on the operation." } } } }, "/v1/integrations/mailcal/accounts/{account_id}/calendar/meeting-times/suggest": { "post": { "operationId": "platform_post__v1_integrations_mailcal_accounts__account_id__calendar_meeting_times_suggest", "summary": "suggest meeting times", "tags": [ "calendar · scheduling" ], "parameters": [ { "name": "account_id", "in": "path", "required": true, "schema": { "type": "string" } } ], "description": "Authorization and validation are enforced by the owning service.", "x-handler": "suggest_meeting_times", "x-source-file": "crates/synckhub-server/src/routes/calendar/scheduling.rs", "x-source-line": 25, "responses": { "default": { "description": "Service response. Error status and envelope depend on the operation." }, "2XX": { "description": "Successful JSON response", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/synckhub_server.routes.calendar.scheduling.CalendarMeetingSuggestionsResponse" } } } } }, "requestBody": { "required": true, "content": { "application/json": { "schema": { "$ref": "#/components/schemas/synckhub_mailcal.types.CalendarMeetingSuggestionQuery" } } } } } }, "/v1/integrations/mailcal/accounts/{account_id}/calendar/resource-lists": { "get": { "operationId": "platform_get__v1_integrations_mailcal_accounts__account_id__calendar_resource_lists", "summary": "list calendar resource lists", "tags": [ "calendar · scheduling" ], "parameters": [ { "name": "account_id", "in": "path", "required": true, "schema": { "type": "string" } } ], "description": "Authorization and validation are enforced by the owning service.", "x-handler": "list_calendar_resource_lists", "x-source-file": "crates/synckhub-server/src/routes/calendar/scheduling.rs", "x-source-line": 25, "responses": { "default": { "description": "Service response. Error status and envelope depend on the operation." }, "2XX": { "description": "Successful JSON response", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/synckhub_server.routes.calendar.scheduling.CalendarResourceListsResponse" } } } } } }, "head": { "operationId": "platform_head__v1_integrations_mailcal_accounts__account_id__calendar_resource_lists", "summary": "list calendar resource lists", "tags": [ "calendar · scheduling" ], "parameters": [ { "name": "account_id", "in": "path", "required": true, "schema": { "type": "string" } } ], "description": "Authorization and validation are enforced by the owning service.\n\nHEAD uses the GET handler and headers without a response body.", "x-handler": "list_calendar_resource_lists", "x-source-file": "crates/synckhub-server/src/routes/calendar/scheduling.rs", "x-source-line": 25, "x-implicit-head": true, "responses": { "default": { "description": "Service response. Error status and envelope depend on the operation." } } } }, "/v1/integrations/mailcal/accounts/{account_id}/calendar/resources": { "get": { "operationId": "platform_get__v1_integrations_mailcal_accounts__account_id__calendar_resources", "summary": "list calendar resources", "tags": [ "calendar · scheduling" ], "parameters": [ { "name": "account_id", "in": "path", "required": true, "schema": { "type": "string" } } ], "description": "Authorization and validation are enforced by the owning service.", "x-handler": "list_calendar_resources", "x-source-file": "crates/synckhub-server/src/routes/calendar/scheduling.rs", "x-source-line": 25, "responses": { "default": { "description": "Service response. Error status and envelope depend on the operation." }, "2XX": { "description": "Successful JSON response", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/synckhub_server.routes.calendar.scheduling.CalendarResourcesResponse" } } } } } }, "head": { "operationId": "platform_head__v1_integrations_mailcal_accounts__account_id__calendar_resources", "summary": "list calendar resources", "tags": [ "calendar · scheduling" ], "parameters": [ { "name": "account_id", "in": "path", "required": true, "schema": { "type": "string" } } ], "description": "Authorization and validation are enforced by the owning service.\n\nHEAD uses the GET handler and headers without a response body.", "x-handler": "list_calendar_resources", "x-source-file": "crates/synckhub-server/src/routes/calendar/scheduling.rs", "x-source-line": 25, "x-implicit-head": true, "responses": { "default": { "description": "Service response. Error status and envelope depend on the operation." } } } }, "/v1/integrations/mailcal/accounts/{account_id}/calendar/sync": { "post": { "operationId": "platform_post__v1_integrations_mailcal_accounts__account_id__calendar_sync", "summary": "sync calendar", "tags": [ "calendar · sync" ], "parameters": [ { "name": "account_id", "in": "path", "required": true, "schema": { "type": "string" } } ], "description": "Authorization and validation are enforced by the owning service.", "x-handler": "sync_calendar", "x-source-file": "crates/synckhub-server/src/routes/calendar/sync.rs", "x-source-line": 30, "responses": { "default": { "description": "Service response. Error status and envelope depend on the operation." } }, "requestBody": { "required": true, "content": { "application/json": { "schema": { "$ref": "#/components/schemas/synckhub_server.routes.calendar.sync.SyncCalendarRequest" } } } } } }, "/v1/integrations/mailcal/accounts/{account_id}/calendar/sync-jobs/{job_id}": { "get": { "operationId": "platform_get__v1_integrations_mailcal_accounts__account_id__calendar_sync_jobs__job_id_", "summary": "get calendar sync job", "tags": [ "calendar · sync" ], "parameters": [ { "name": "account_id", "in": "path", "required": true, "schema": { "type": "string" } }, { "name": "job_id", "in": "path", "required": true, "schema": { "type": "string" } } ], "description": "Authorization and validation are enforced by the owning service.", "x-handler": "get_calendar_sync_job", "x-source-file": "crates/synckhub-server/src/routes/calendar/sync.rs", "x-source-line": 30, "responses": { "default": { "description": "Service response. Error status and envelope depend on the operation." }, "2XX": { "description": "Successful JSON response", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/synckhub_server.routes.calendar.sync.CalendarSyncJobResponse" } } } } } }, "head": { "operationId": "platform_head__v1_integrations_mailcal_accounts__account_id__calendar_sync_jobs__job_id_", "summary": "get calendar sync job", "tags": [ "calendar · sync" ], "parameters": [ { "name": "account_id", "in": "path", "required": true, "schema": { "type": "string" } }, { "name": "job_id", "in": "path", "required": true, "schema": { "type": "string" } } ], "description": "Authorization and validation are enforced by the owning service.\n\nHEAD uses the GET handler and headers without a response body.", "x-handler": "get_calendar_sync_job", "x-source-file": "crates/synckhub-server/src/routes/calendar/sync.rs", "x-source-line": 30, "x-implicit-head": true, "responses": { "default": { "description": "Service response. Error status and envelope depend on the operation." } } } }, "/v1/integrations/mailcal/accounts/{account_id}/contacts": { "post": { "operationId": "platform_post__v1_integrations_mailcal_accounts__account_id__contacts", "summary": "create contact", "tags": [ "connected_accounts · provider_people" ], "parameters": [ { "name": "account_id", "in": "path", "required": true, "schema": { "type": "string" } } ], "description": "Authorization and validation are enforced by the owning service.", "x-handler": "create_contact", "x-source-file": "crates/synckhub-server/src/routes/connected_accounts/provider_people.rs", "x-source-line": 916, "responses": { "default": { "description": "Service response. Error status and envelope depend on the operation." }, "2XX": { "description": "Successful JSON response", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/synckhub_mailcal.types.Contact" } } } } }, "requestBody": { "required": true, "content": { "application/json": { "schema": { "$ref": "#/components/schemas/synckhub_mailcal.types.ContactInput" } } } } }, "get": { "operationId": "platform_get__v1_integrations_mailcal_accounts__account_id__contacts", "summary": "list contacts", "tags": [ "connected_accounts · provider_people" ], "parameters": [ { "name": "account_id", "in": "path", "required": true, "schema": { "type": "string" } }, { "name": "q", "in": "query", "required": false, "schema": { "anyOf": [ { "type": "string" }, { "type": "null" } ] } }, { "name": "page_size", "in": "query", "required": false, "schema": { "anyOf": [ { "type": "integer", "minimum": 0 }, { "type": "null" } ] } }, { "name": "page_token", "in": "query", "required": false, "schema": { "anyOf": [ { "type": "string" }, { "type": "null" } ] } }, { "name": "filters", "in": "query", "required": false, "schema": { "anyOf": [ { "type": "string" }, { "type": "null" } ] } }, { "name": "sort", "in": "query", "required": false, "schema": { "anyOf": [ { "$ref": "#/components/schemas/synckhub_server.routes.connected_accounts.provider_people.ContactListField" }, { "type": "null" } ] } }, { "name": "order", "in": "query", "required": false, "schema": { "anyOf": [ { "$ref": "#/components/schemas/synckhub_server.routes.connected_accounts.provider_people.ContactListOrder" }, { "type": "null" } ] } }, { "name": "state", "in": "query", "required": false, "schema": { "$ref": "#/components/schemas/synckhub_server.routes.connected_accounts.provider_people.ContactListState" } } ], "description": "Authorization and validation are enforced by the owning service.", "x-handler": "list_contacts", "x-source-file": "crates/synckhub-server/src/routes/connected_accounts/provider_people.rs", "x-source-line": 916, "responses": { "default": { "description": "Service response. Error status and envelope depend on the operation." }, "2XX": { "description": "Successful JSON response", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/synckhub_server.routes.connected_accounts.provider_people.ListContactsResponse" } } } } } }, "head": { "operationId": "platform_head__v1_integrations_mailcal_accounts__account_id__contacts", "summary": "list contacts", "tags": [ "connected_accounts · provider_people" ], "parameters": [ { "name": "account_id", "in": "path", "required": true, "schema": { "type": "string" } }, { "name": "q", "in": "query", "required": false, "schema": { "anyOf": [ { "type": "string" }, { "type": "null" } ] } }, { "name": "page_size", "in": "query", "required": false, "schema": { "anyOf": [ { "type": "integer", "minimum": 0 }, { "type": "null" } ] } }, { "name": "page_token", "in": "query", "required": false, "schema": { "anyOf": [ { "type": "string" }, { "type": "null" } ] } }, { "name": "filters", "in": "query", "required": false, "schema": { "anyOf": [ { "type": "string" }, { "type": "null" } ] } }, { "name": "sort", "in": "query", "required": false, "schema": { "anyOf": [ { "$ref": "#/components/schemas/synckhub_server.routes.connected_accounts.provider_people.ContactListField" }, { "type": "null" } ] } }, { "name": "order", "in": "query", "required": false, "schema": { "anyOf": [ { "$ref": "#/components/schemas/synckhub_server.routes.connected_accounts.provider_people.ContactListOrder" }, { "type": "null" } ] } }, { "name": "state", "in": "query", "required": false, "schema": { "$ref": "#/components/schemas/synckhub_server.routes.connected_accounts.provider_people.ContactListState" } } ], "description": "Authorization and validation are enforced by the owning service.\n\nHEAD uses the GET handler and headers without a response body.", "x-handler": "list_contacts", "x-source-file": "crates/synckhub-server/src/routes/connected_accounts/provider_people.rs", "x-source-line": 916, "x-implicit-head": true, "responses": { "default": { "description": "Service response. Error status and envelope depend on the operation." } } } }, "/v1/integrations/mailcal/accounts/{account_id}/contacts/{contact_id}": { "delete": { "operationId": "platform_delete__v1_integrations_mailcal_accounts__account_id__contacts__contact_id_", "summary": "delete contact", "tags": [ "connected_accounts · provider_people" ], "parameters": [ { "name": "account_id", "in": "path", "required": true, "schema": { "type": "string" } }, { "name": "contact_id", "in": "path", "required": true, "schema": { "type": "string" } } ], "description": "Authorization and validation are enforced by the owning service.", "x-handler": "delete_contact", "x-source-file": "crates/synckhub-server/src/routes/connected_accounts/provider_people.rs", "x-source-line": 916, "responses": { "default": { "description": "Service response. Error status and envelope depend on the operation." } } }, "patch": { "operationId": "platform_patch__v1_integrations_mailcal_accounts__account_id__contacts__contact_id_", "summary": "update contact", "tags": [ "connected_accounts · provider_people" ], "parameters": [ { "name": "account_id", "in": "path", "required": true, "schema": { "type": "string" } }, { "name": "contact_id", "in": "path", "required": true, "schema": { "type": "string" } } ], "description": "Authorization and validation are enforced by the owning service.", "x-handler": "update_contact", "x-source-file": "crates/synckhub-server/src/routes/connected_accounts/provider_people.rs", "x-source-line": 916, "responses": { "default": { "description": "Service response. Error status and envelope depend on the operation." }, "2XX": { "description": "Successful JSON response", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/synckhub_mailcal.types.Contact" } } } } }, "requestBody": { "required": true, "content": { "application/json": { "schema": { "$ref": "#/components/schemas/synckhub_mailcal.types.ContactInput" } } } } }, "get": { "operationId": "platform_get__v1_integrations_mailcal_accounts__account_id__contacts__contact_id_", "summary": "get contact", "tags": [ "connected_accounts · provider_people" ], "parameters": [ { "name": "account_id", "in": "path", "required": true, "schema": { "type": "string" } }, { "name": "contact_id", "in": "path", "required": true, "schema": { "type": "string" } } ], "description": "Authorization and validation are enforced by the owning service.", "x-handler": "get_contact", "x-source-file": "crates/synckhub-server/src/routes/connected_accounts/provider_people.rs", "x-source-line": 916, "responses": { "default": { "description": "Service response. Error status and envelope depend on the operation." }, "2XX": { "description": "Successful JSON response", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/synckhub_mailcal.types.Contact" } } } } } }, "head": { "operationId": "platform_head__v1_integrations_mailcal_accounts__account_id__contacts__contact_id_", "summary": "get contact", "tags": [ "connected_accounts · provider_people" ], "parameters": [ { "name": "account_id", "in": "path", "required": true, "schema": { "type": "string" } }, { "name": "contact_id", "in": "path", "required": true, "schema": { "type": "string" } } ], "description": "Authorization and validation are enforced by the owning service.\n\nHEAD uses the GET handler and headers without a response body.", "x-handler": "get_contact", "x-source-file": "crates/synckhub-server/src/routes/connected_accounts/provider_people.rs", "x-source-line": 916, "x-implicit-head": true, "responses": { "default": { "description": "Service response. Error status and envelope depend on the operation." } } } }, "/v1/integrations/mailcal/accounts/{account_id}/mail/archive-jobs/{job_id}": { "get": { "operationId": "platform_get__v1_integrations_mailcal_accounts__account_id__mail_archive_jobs__job_id_", "summary": "get archive job", "tags": [ "mail · archive" ], "parameters": [ { "name": "account_id", "in": "path", "required": true, "schema": { "type": "string" } }, { "name": "job_id", "in": "path", "required": true, "schema": { "type": "string" } } ], "description": "Authorization and validation are enforced by the owning service.", "x-handler": "get_archive_job", "x-source-file": "crates/synckhub-server/src/routes/mail/archive.rs", "x-source-line": 100, "responses": { "default": { "description": "Service response. Error status and envelope depend on the operation." }, "2XX": { "description": "Successful JSON response", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/synckhub_server.routes.mail.archive.ArchiveResponse" } } } } } }, "head": { "operationId": "platform_head__v1_integrations_mailcal_accounts__account_id__mail_archive_jobs__job_id_", "summary": "get archive job", "tags": [ "mail · archive" ], "parameters": [ { "name": "account_id", "in": "path", "required": true, "schema": { "type": "string" } }, { "name": "job_id", "in": "path", "required": true, "schema": { "type": "string" } } ], "description": "Authorization and validation are enforced by the owning service.\n\nHEAD uses the GET handler and headers without a response body.", "x-handler": "get_archive_job", "x-source-file": "crates/synckhub-server/src/routes/mail/archive.rs", "x-source-line": 100, "x-implicit-head": true, "responses": { "default": { "description": "Service response. Error status and envelope depend on the operation." } } } }, "/v1/integrations/mailcal/accounts/{account_id}/mail/archive-jobs/{job_id}/resolve-name-conflict": { "post": { "operationId": "platform_post__v1_integrations_mailcal_accounts__account_id__mail_archive_jobs__job_id__resolve_name_conflict", "summary": "resolve archive name conflict", "tags": [ "mail · archive" ], "parameters": [ { "name": "account_id", "in": "path", "required": true, "schema": { "type": "string" } }, { "name": "job_id", "in": "path", "required": true, "schema": { "type": "string" } } ], "description": "Authorization and validation are enforced by the owning service.", "x-handler": "resolve_archive_name_conflict", "x-source-file": "crates/synckhub-server/src/routes/mail/archive.rs", "x-source-line": 100, "responses": { "default": { "description": "Service response. Error status and envelope depend on the operation." }, "2XX": { "description": "Successful JSON response", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/synckhub_server.routes.mail.archive.ArchiveResponse" } } } } }, "requestBody": { "required": true, "content": { "application/json": { "schema": { "$ref": "#/components/schemas/synckhub_server.routes.mail.archive.ResolveArchiveNameConflictRequest" } } } } } }, "/v1/integrations/mailcal/accounts/{account_id}/mail/attachment-save-jobs/{job_id}/resolve-name-conflict": { "post": { "operationId": "platform_post__v1_integrations_mailcal_accounts__account_id__mail_attachment_save_jobs__job_id__resolve_name_conflict", "summary": "resolve attachment save name conflict", "tags": [ "mail · attachments" ], "parameters": [ { "name": "account_id", "in": "path", "required": true, "schema": { "type": "string" } }, { "name": "job_id", "in": "path", "required": true, "schema": { "type": "string" } } ], "description": "Authorization and validation are enforced by the owning service.", "x-handler": "resolve_attachment_save_name_conflict", "x-source-file": "crates/synckhub-server/src/routes/mail/attachments.rs", "x-source-line": 66, "responses": { "default": { "description": "Service response. Error status and envelope depend on the operation." }, "2XX": { "description": "Successful JSON response", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/synckhub_server.routes.mail.attachments.AttachmentSaveJobResponse" } } } } }, "requestBody": { "required": true, "content": { "application/json": { "schema": { "$ref": "#/components/schemas/synckhub_server.routes.mail.attachments.ResolveAttachmentSaveNameConflictRequest" } } } } } }, "/v1/integrations/mailcal/accounts/{account_id}/mail/automatic-replies": { "put": { "operationId": "platform_put__v1_integrations_mailcal_accounts__account_id__mail_automatic_replies", "summary": "auto reply update", "tags": [ "mail · native_compose" ], "parameters": [ { "name": "account_id", "in": "path", "required": true, "schema": { "type": "string", "format": "uuid" } } ], "description": "Authorization and validation are enforced by the owning service.", "x-handler": "auto_reply_update", "x-source-file": "crates/synckhub-server/src/routes/mail/native_compose.rs", "x-source-line": 63, "responses": { "default": { "description": "Service response. Error status and envelope depend on the operation." }, "2XX": { "description": "Successful JSON response", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/synckhub_server.native_mail.automatic_replies.AutoReplySettings" } } } } }, "requestBody": { "required": true, "content": { "application/json": { "schema": { "$ref": "#/components/schemas/synckhub_server.routes.mail.native_compose.AutoReplyUpdate" } } } } }, "get": { "operationId": "platform_get__v1_integrations_mailcal_accounts__account_id__mail_automatic_replies", "summary": "auto reply read", "tags": [ "mail · native_compose" ], "parameters": [ { "name": "account_id", "in": "path", "required": true, "schema": { "type": "string", "format": "uuid" } } ], "description": "Authorization and validation are enforced by the owning service.", "x-handler": "auto_reply_read", "x-source-file": "crates/synckhub-server/src/routes/mail/native_compose.rs", "x-source-line": 63, "responses": { "default": { "description": "Service response. Error status and envelope depend on the operation." }, "2XX": { "description": "Successful JSON response", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/synckhub_server.native_mail.automatic_replies.AutoReplySettings" } } } } } }, "head": { "operationId": "platform_head__v1_integrations_mailcal_accounts__account_id__mail_automatic_replies", "summary": "auto reply read", "tags": [ "mail · native_compose" ], "parameters": [ { "name": "account_id", "in": "path", "required": true, "schema": { "type": "string", "format": "uuid" } } ], "description": "Authorization and validation are enforced by the owning service.\n\nHEAD uses the GET handler and headers without a response body.", "x-handler": "auto_reply_read", "x-source-file": "crates/synckhub-server/src/routes/mail/native_compose.rs", "x-source-line": 63, "x-implicit-head": true, "responses": { "default": { "description": "Service response. Error status and envelope depend on the operation." } } } }, "/v1/integrations/mailcal/accounts/{account_id}/mail/bulk-action-jobs": { "get": { "operationId": "platform_get__v1_integrations_mailcal_accounts__account_id__mail_bulk_action_jobs", "summary": "list bulk action jobs", "tags": [ "mail · mailboxes" ], "parameters": [ { "name": "account_id", "in": "path", "required": true, "schema": { "type": "string" } }, { "name": "status", "in": "query", "required": false, "schema": { "anyOf": [ { "type": "string" }, { "type": "null" } ] } } ], "description": "Authorization and validation are enforced by the owning service.", "x-handler": "list_bulk_action_jobs", "x-source-file": "crates/synckhub-server/src/routes/mail/mailboxes.rs", "x-source-line": 149, "responses": { "default": { "description": "Service response. Error status and envelope depend on the operation." }, "2XX": { "description": "Successful JSON response", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/synckhub_server.routes.mail.mailboxes.BulkActionJobsResponse" } } } } } }, "head": { "operationId": "platform_head__v1_integrations_mailcal_accounts__account_id__mail_bulk_action_jobs", "summary": "list bulk action jobs", "tags": [ "mail · mailboxes" ], "parameters": [ { "name": "account_id", "in": "path", "required": true, "schema": { "type": "string" } }, { "name": "status", "in": "query", "required": false, "schema": { "anyOf": [ { "type": "string" }, { "type": "null" } ] } } ], "description": "Authorization and validation are enforced by the owning service.\n\nHEAD uses the GET handler and headers without a response body.", "x-handler": "list_bulk_action_jobs", "x-source-file": "crates/synckhub-server/src/routes/mail/mailboxes.rs", "x-source-line": 149, "x-implicit-head": true, "responses": { "default": { "description": "Service response. Error status and envelope depend on the operation." } } } }, "/v1/integrations/mailcal/accounts/{account_id}/mail/bulk-action-jobs/{job_id}": { "get": { "operationId": "platform_get__v1_integrations_mailcal_accounts__account_id__mail_bulk_action_jobs__job_id_", "summary": "get bulk action job", "tags": [ "mail · mailboxes" ], "parameters": [ { "name": "account_id", "in": "path", "required": true, "schema": { "type": "string" } }, { "name": "job_id", "in": "path", "required": true, "schema": { "type": "string" } } ], "description": "Authorization and validation are enforced by the owning service.", "x-handler": "get_bulk_action_job", "x-source-file": "crates/synckhub-server/src/routes/mail/mailboxes.rs", "x-source-line": 149, "responses": { "default": { "description": "Service response. Error status and envelope depend on the operation." }, "2XX": { "description": "Successful JSON response", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/synckhub_server.routes.mail.mailboxes.BulkActionJobResponse" } } } } } }, "head": { "operationId": "platform_head__v1_integrations_mailcal_accounts__account_id__mail_bulk_action_jobs__job_id_", "summary": "get bulk action job", "tags": [ "mail · mailboxes" ], "parameters": [ { "name": "account_id", "in": "path", "required": true, "schema": { "type": "string" } }, { "name": "job_id", "in": "path", "required": true, "schema": { "type": "string" } } ], "description": "Authorization and validation are enforced by the owning service.\n\nHEAD uses the GET handler and headers without a response body.", "x-handler": "get_bulk_action_job", "x-source-file": "crates/synckhub-server/src/routes/mail/mailboxes.rs", "x-source-line": 149, "x-implicit-head": true, "responses": { "default": { "description": "Service response. Error status and envelope depend on the operation." } } } }, "/v1/integrations/mailcal/accounts/{account_id}/mail/bulk-action-jobs/{job_id}/cancel": { "post": { "operationId": "platform_post__v1_integrations_mailcal_accounts__account_id__mail_bulk_action_jobs__job_id__cancel", "summary": "cancel bulk action job", "tags": [ "mail · mailboxes" ], "parameters": [ { "name": "account_id", "in": "path", "required": true, "schema": { "type": "string" } }, { "name": "job_id", "in": "path", "required": true, "schema": { "type": "string" } } ], "description": "Authorization and validation are enforced by the owning service.", "x-handler": "cancel_bulk_action_job", "x-source-file": "crates/synckhub-server/src/routes/mail/mailboxes.rs", "x-source-line": 149, "responses": { "default": { "description": "Service response. Error status and envelope depend on the operation." }, "2XX": { "description": "Successful JSON response", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/synckhub_server.routes.mail.mailboxes.BulkActionJobResponse" } } } } } } }, "/v1/integrations/mailcal/accounts/{account_id}/mail/bulk-action-jobs/{job_id}/confirm": { "post": { "operationId": "platform_post__v1_integrations_mailcal_accounts__account_id__mail_bulk_action_jobs__job_id__confirm", "summary": "confirm safe empty job", "tags": [ "mail · mailboxes" ], "parameters": [ { "name": "account_id", "in": "path", "required": true, "schema": { "type": "string" } }, { "name": "job_id", "in": "path", "required": true, "schema": { "type": "string" } } ], "description": "Authorization and validation are enforced by the owning service.", "x-handler": "confirm_safe_empty_job", "x-source-file": "crates/synckhub-server/src/routes/mail/mailboxes.rs", "x-source-line": 149, "responses": { "default": { "description": "Service response. Error status and envelope depend on the operation." }, "2XX": { "description": "Successful JSON response", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/synckhub_server.routes.mail.mailboxes.BulkActionJobResponse" } } } } }, "requestBody": { "required": true, "content": { "application/json": { "schema": { "$ref": "#/components/schemas/synckhub_server.routes.mail.mailboxes.ConfirmSafeEmptyRequest" } } } } } }, "/v1/integrations/mailcal/accounts/{account_id}/mail/draft-attachments/from-synck-item": { "post": { "operationId": "platform_post__v1_integrations_mailcal_accounts__account_id__mail_draft_attachments_from_synck_item", "summary": "resolve draft attachment from synck item", "tags": [ "mail · drafts" ], "parameters": [ { "name": "account_id", "in": "path", "required": true, "schema": { "type": "string" } } ], "description": "Authorization and validation are enforced by the owning service.", "x-handler": "resolve_draft_attachment_from_synck_item", "x-source-file": "crates/synckhub-server/src/routes/mail/drafts.rs", "x-source-line": 39, "responses": { "default": { "description": "Service response. Error status and envelope depend on the operation." }, "2XX": { "description": "Successful JSON response", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/synckhub_server.routes.mail.drafts.ResolveDraftAttachmentFromSynckItemResponseBody" } } } } }, "requestBody": { "required": true, "content": { "application/json": { "schema": { "$ref": "#/components/schemas/synckhub_server.routes.mail.drafts.ResolveDraftAttachmentFromSynckItemRequestBody" } } } } } }, "/v1/integrations/mailcal/accounts/{account_id}/mail/draft-save-suggestions": { "post": { "operationId": "platform_post__v1_integrations_mailcal_accounts__account_id__mail_draft_save_suggestions", "summary": "get draft save suggestions", "tags": [ "mail · routing" ], "parameters": [ { "name": "account_id", "in": "path", "required": true, "schema": { "type": "string" } }, { "name": "repo_id", "in": "query", "required": true, "schema": { "type": "string" } }, { "name": "limit", "in": "query", "required": false, "schema": { "anyOf": [ { "type": "integer", "minimum": 0 }, { "type": "null" } ] } }, { "name": "original_message_id", "in": "query", "required": false, "schema": { "anyOf": [ { "type": "string" }, { "type": "null" } ] } } ], "description": "Authorization and validation are enforced by the owning service.", "x-handler": "get_draft_save_suggestions", "x-source-file": "crates/synckhub-server/src/routes/mail/routing.rs", "x-source-line": 51, "responses": { "default": { "description": "Service response. Error status and envelope depend on the operation." }, "2XX": { "description": "Successful JSON response", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/synckhub_server.routes.mail.routing.SaveSuggestionsResponse" } } } } }, "requestBody": { "required": true, "content": { "application/json": { "schema": { "$ref": "#/components/schemas/synckhub_server.routes.mail.routing.DraftSaveSuggestionsRequestBody" } } } } } }, "/v1/integrations/mailcal/accounts/{account_id}/mail/drafts": { "post": { "operationId": "platform_post__v1_integrations_mailcal_accounts__account_id__mail_drafts", "summary": "create draft", "tags": [ "mail · drafts" ], "parameters": [ { "name": "account_id", "in": "path", "required": true, "schema": { "type": "string" } } ], "description": "Authorization and validation are enforced by the owning service.", "x-handler": "create_draft", "x-source-file": "crates/synckhub-server/src/routes/mail/drafts.rs", "x-source-line": 39, "responses": { "default": { "description": "Service response. Error status and envelope depend on the operation." }, "2XX": { "description": "Successful JSON response", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/synckhub_server.routes.mail.drafts.DraftRouteResponse" } } } } }, "requestBody": { "required": true, "content": { "application/json": { "schema": { "$ref": "#/components/schemas/synckhub_server.routes.mail.drafts.DraftRequestBody" } } } } } }, "/v1/integrations/mailcal/accounts/{account_id}/mail/drafts/{draft_id}": { "delete": { "operationId": "platform_delete__v1_integrations_mailcal_accounts__account_id__mail_drafts__draft_id_", "summary": "delete draft", "tags": [ "mail · drafts" ], "parameters": [ { "name": "account_id", "in": "path", "required": true, "schema": { "type": "string" } }, { "name": "draft_id", "in": "path", "required": true, "schema": { "type": "string" } } ], "description": "Authorization and validation are enforced by the owning service.", "x-handler": "delete_draft", "x-source-file": "crates/synckhub-server/src/routes/mail/drafts.rs", "x-source-line": 39, "responses": { "default": { "description": "Service response. Error status and envelope depend on the operation." } } }, "patch": { "operationId": "platform_patch__v1_integrations_mailcal_accounts__account_id__mail_drafts__draft_id_", "summary": "update draft", "tags": [ "mail · drafts" ], "parameters": [ { "name": "account_id", "in": "path", "required": true, "schema": { "type": "string" } }, { "name": "draft_id", "in": "path", "required": true, "schema": { "type": "string" } } ], "description": "Authorization and validation are enforced by the owning service.", "x-handler": "update_draft", "x-source-file": "crates/synckhub-server/src/routes/mail/drafts.rs", "x-source-line": 39, "responses": { "default": { "description": "Service response. Error status and envelope depend on the operation." }, "2XX": { "description": "Successful JSON response", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/synckhub_server.routes.mail.drafts.DraftUpdateRouteResponse" } } } } }, "requestBody": { "required": true, "content": { "application/json": { "schema": { "$ref": "#/components/schemas/synckhub_server.routes.mail.drafts.DraftUpdateRequestBody" } } } } }, "get": { "operationId": "platform_get__v1_integrations_mailcal_accounts__account_id__mail_drafts__draft_id_", "summary": "get draft", "tags": [ "mail · drafts" ], "parameters": [ { "name": "account_id", "in": "path", "required": true, "schema": { "type": "string" } }, { "name": "draft_id", "in": "path", "required": true, "schema": { "type": "string" } } ], "description": "Authorization and validation are enforced by the owning service.", "x-handler": "get_draft", "x-source-file": "crates/synckhub-server/src/routes/mail/drafts.rs", "x-source-line": 39, "responses": { "default": { "description": "Service response. Error status and envelope depend on the operation." } } }, "head": { "operationId": "platform_head__v1_integrations_mailcal_accounts__account_id__mail_drafts__draft_id_", "summary": "get draft", "tags": [ "mail · drafts" ], "parameters": [ { "name": "account_id", "in": "path", "required": true, "schema": { "type": "string" } }, { "name": "draft_id", "in": "path", "required": true, "schema": { "type": "string" } } ], "description": "Authorization and validation are enforced by the owning service.\n\nHEAD uses the GET handler and headers without a response body.", "x-handler": "get_draft", "x-source-file": "crates/synckhub-server/src/routes/mail/drafts.rs", "x-source-line": 39, "x-implicit-head": true, "responses": { "default": { "description": "Service response. Error status and envelope depend on the operation." } } } }, "/v1/integrations/mailcal/accounts/{account_id}/mail/drafts/{draft_id}/send": { "post": { "operationId": "platform_post__v1_integrations_mailcal_accounts__account_id__mail_drafts__draft_id__send", "summary": "send draft", "tags": [ "mail · drafts" ], "parameters": [ { "name": "account_id", "in": "path", "required": true, "schema": { "type": "string" } }, { "name": "draft_id", "in": "path", "required": true, "schema": { "type": "string" } } ], "description": "Authorization and validation are enforced by the owning service.", "x-handler": "send_draft", "x-source-file": "crates/synckhub-server/src/routes/mail/drafts.rs", "x-source-line": 39, "responses": { "default": { "description": "Service response. Error status and envelope depend on the operation." }, "2XX": { "description": "Successful JSON response", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/synckhub_server.routes.mail.drafts.SendDraftRouteResponse" } } } } }, "requestBody": { "required": false, "content": { "application/json": { "schema": { "$ref": "#/components/schemas/synckhub_server.routes.mail.drafts.SendDraftRequestBody" } } } } } }, "/v1/integrations/mailcal/accounts/{account_id}/mail/filing-jobs": { "post": { "operationId": "platform_post__v1_integrations_mailcal_accounts__account_id__mail_filing_jobs", "summary": "enqueue", "tags": [ "mail · native_filing" ], "parameters": [ { "name": "account_id", "in": "path", "required": true, "schema": { "type": "string" } } ], "description": "Authorization and validation are enforced by the owning service.", "x-handler": "enqueue", "x-source-file": "crates/synckhub-server/src/routes/mail/native_filing.rs", "x-source-line": 50, "responses": { "default": { "description": "Service response. Error status and envelope depend on the operation." }, "2XX": { "description": "Successful JSON response", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/synckhub_server.native_mail.filing.FilingJob" } } } } }, "requestBody": { "required": true, "content": { "application/json": { "schema": { "$ref": "#/components/schemas/synckhub_server.native_mail.filing.FilingRequest" } } } } } }, "/v1/integrations/mailcal/accounts/{account_id}/mail/filing-jobs/{command_id}": { "get": { "operationId": "platform_get__v1_integrations_mailcal_accounts__account_id__mail_filing_jobs__command_id_", "summary": "read", "tags": [ "mail · native_filing" ], "parameters": [ { "name": "account_id", "in": "path", "required": true, "schema": { "type": "string" } }, { "name": "command_id", "in": "path", "required": true, "schema": { "type": "string", "format": "uuid" } } ], "description": "Authorization and validation are enforced by the owning service.", "x-handler": "read", "x-source-file": "crates/synckhub-server/src/routes/mail/native_filing.rs", "x-source-line": 50, "responses": { "default": { "description": "Service response. Error status and envelope depend on the operation." }, "2XX": { "description": "Successful JSON response", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/synckhub_server.native_mail.filing.FilingJob" } } } } } }, "head": { "operationId": "platform_head__v1_integrations_mailcal_accounts__account_id__mail_filing_jobs__command_id_", "summary": "read", "tags": [ "mail · native_filing" ], "parameters": [ { "name": "account_id", "in": "path", "required": true, "schema": { "type": "string" } }, { "name": "command_id", "in": "path", "required": true, "schema": { "type": "string", "format": "uuid" } } ], "description": "Authorization and validation are enforced by the owning service.\n\nHEAD uses the GET handler and headers without a response body.", "x-handler": "read", "x-source-file": "crates/synckhub-server/src/routes/mail/native_filing.rs", "x-source-line": 50, "x-implicit-head": true, "responses": { "default": { "description": "Service response. Error status and envelope depend on the operation." } } } }, "/v1/integrations/mailcal/accounts/{account_id}/mail/inbox-rules": { "put": { "operationId": "platform_put__v1_integrations_mailcal_accounts__account_id__mail_inbox_rules", "summary": "inbox rules update", "tags": [ "mail · native_compose" ], "parameters": [ { "name": "account_id", "in": "path", "required": true, "schema": { "type": "string", "format": "uuid" } } ], "description": "Authorization and validation are enforced by the owning service.", "x-handler": "inbox_rules_update", "x-source-file": "crates/synckhub-server/src/routes/mail/native_compose.rs", "x-source-line": 63, "responses": { "default": { "description": "Service response. Error status and envelope depend on the operation." }, "2XX": { "description": "Successful JSON response", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/synckhub_server.native_mail.inbox_rules.InboxRules" } } } } }, "requestBody": { "required": true, "content": { "application/json": { "schema": { "$ref": "#/components/schemas/synckhub_server.routes.mail.native_compose.InboxRulesUpdate" } } } } }, "get": { "operationId": "platform_get__v1_integrations_mailcal_accounts__account_id__mail_inbox_rules", "summary": "inbox rules read", "tags": [ "mail · native_compose" ], "parameters": [ { "name": "account_id", "in": "path", "required": true, "schema": { "type": "string", "format": "uuid" } } ], "description": "Authorization and validation are enforced by the owning service.", "x-handler": "inbox_rules_read", "x-source-file": "crates/synckhub-server/src/routes/mail/native_compose.rs", "x-source-line": 63, "responses": { "default": { "description": "Service response. Error status and envelope depend on the operation." }, "2XX": { "description": "Successful JSON response", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/synckhub_server.native_mail.inbox_rules.InboxRules" } } } } } }, "head": { "operationId": "platform_head__v1_integrations_mailcal_accounts__account_id__mail_inbox_rules", "summary": "inbox rules read", "tags": [ "mail · native_compose" ], "parameters": [ { "name": "account_id", "in": "path", "required": true, "schema": { "type": "string", "format": "uuid" } } ], "description": "Authorization and validation are enforced by the owning service.\n\nHEAD uses the GET handler and headers without a response body.", "x-handler": "inbox_rules_read", "x-source-file": "crates/synckhub-server/src/routes/mail/native_compose.rs", "x-source-line": 63, "x-implicit-head": true, "responses": { "default": { "description": "Service response. Error status and envelope depend on the operation." } } } }, "/v1/integrations/mailcal/accounts/{account_id}/mail/incoming-status": { "get": { "operationId": "platform_get__v1_integrations_mailcal_accounts__account_id__mail_incoming_status", "summary": "incoming owner", "tags": [ "mail · native_status" ], "parameters": [ { "name": "account_id", "in": "path", "required": true, "schema": { "type": "string", "format": "uuid" } }, { "name": "before", "in": "query", "required": false, "schema": { "anyOf": [ { "type": "string" }, { "type": "null" } ] } }, { "name": "limit", "in": "query", "required": false, "schema": { "anyOf": [ { "type": "integer", "minimum": 0 }, { "type": "null" } ] } } ], "description": "Authorization and validation are enforced by the owning service.", "x-handler": "incoming_owner", "x-source-file": "crates/synckhub-server/src/routes/mail/native_status.rs", "x-source-line": 28, "responses": { "default": { "description": "Service response. Error status and envelope depend on the operation." } } }, "head": { "operationId": "platform_head__v1_integrations_mailcal_accounts__account_id__mail_incoming_status", "summary": "incoming owner", "tags": [ "mail · native_status" ], "parameters": [ { "name": "account_id", "in": "path", "required": true, "schema": { "type": "string", "format": "uuid" } }, { "name": "before", "in": "query", "required": false, "schema": { "anyOf": [ { "type": "string" }, { "type": "null" } ] } }, { "name": "limit", "in": "query", "required": false, "schema": { "anyOf": [ { "type": "integer", "minimum": 0 }, { "type": "null" } ] } } ], "description": "Authorization and validation are enforced by the owning service.\n\nHEAD uses the GET handler and headers without a response body.", "x-handler": "incoming_owner", "x-source-file": "crates/synckhub-server/src/routes/mail/native_status.rs", "x-source-line": 28, "x-implicit-head": true, "responses": { "default": { "description": "Service response. Error status and envelope depend on the operation." } } } }, "/v1/integrations/mailcal/accounts/{account_id}/mail/mailboxes": { "post": { "operationId": "platform_post__v1_integrations_mailcal_accounts__account_id__mail_mailboxes", "summary": "create mailbox", "tags": [ "mail · mailboxes" ], "parameters": [ { "name": "account_id", "in": "path", "required": true, "schema": { "type": "string" } } ], "description": "Authorization and validation are enforced by the owning service.", "x-handler": "create_mailbox", "x-source-file": "crates/synckhub-server/src/routes/mail/mailboxes.rs", "x-source-line": 149, "responses": { "default": { "description": "Service response. Error status and envelope depend on the operation." }, "2XX": { "description": "Successful JSON response", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/synckhub_mailcal.types.Mailbox" } } } } }, "requestBody": { "required": true, "content": { "application/json": { "schema": { "$ref": "#/components/schemas/synckhub_server.routes.mail.mailboxes.CreateMailboxRequest" } } } } }, "get": { "operationId": "platform_get__v1_integrations_mailcal_accounts__account_id__mail_mailboxes", "summary": "list mailboxes", "tags": [ "mail · mailboxes" ], "parameters": [ { "name": "account_id", "in": "path", "required": true, "schema": { "type": "string" } }, { "name": "parent_mailbox_id", "in": "query", "required": false, "schema": { "anyOf": [ { "type": "string" }, { "type": "null" } ] } }, { "name": "recursive", "in": "query", "required": false, "schema": { "anyOf": [ { "type": "boolean" }, { "type": "null" } ] } } ], "description": "Authorization and validation are enforced by the owning service.", "x-handler": "list_mailboxes", "x-source-file": "crates/synckhub-server/src/routes/mail/mailboxes.rs", "x-source-line": 149, "responses": { "default": { "description": "Service response. Error status and envelope depend on the operation." }, "2XX": { "description": "Successful JSON response", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/synckhub_server.routes.mail.mailboxes.MailboxesResponse" } } } } } }, "head": { "operationId": "platform_head__v1_integrations_mailcal_accounts__account_id__mail_mailboxes", "summary": "list mailboxes", "tags": [ "mail · mailboxes" ], "parameters": [ { "name": "account_id", "in": "path", "required": true, "schema": { "type": "string" } }, { "name": "parent_mailbox_id", "in": "query", "required": false, "schema": { "anyOf": [ { "type": "string" }, { "type": "null" } ] } }, { "name": "recursive", "in": "query", "required": false, "schema": { "anyOf": [ { "type": "boolean" }, { "type": "null" } ] } } ], "description": "Authorization and validation are enforced by the owning service.\n\nHEAD uses the GET handler and headers without a response body.", "x-handler": "list_mailboxes", "x-source-file": "crates/synckhub-server/src/routes/mail/mailboxes.rs", "x-source-line": 149, "x-implicit-head": true, "responses": { "default": { "description": "Service response. Error status and envelope depend on the operation." } } } }, "/v1/integrations/mailcal/accounts/{account_id}/mail/mailboxes/{mailbox_id}": { "delete": { "operationId": "platform_delete__v1_integrations_mailcal_accounts__account_id__mail_mailboxes__mailbox_id_", "summary": "delete mailbox", "tags": [ "mail · mailboxes" ], "parameters": [ { "name": "account_id", "in": "path", "required": true, "schema": { "type": "string" } }, { "name": "mailbox_id", "in": "path", "required": true, "schema": { "type": "string" } } ], "description": "Authorization and validation are enforced by the owning service.", "x-handler": "delete_mailbox", "x-source-file": "crates/synckhub-server/src/routes/mail/mailboxes.rs", "x-source-line": 149, "responses": { "default": { "description": "Service response. Error status and envelope depend on the operation." } } }, "patch": { "operationId": "platform_patch__v1_integrations_mailcal_accounts__account_id__mail_mailboxes__mailbox_id_", "summary": "rename mailbox", "tags": [ "mail · mailboxes" ], "parameters": [ { "name": "account_id", "in": "path", "required": true, "schema": { "type": "string" } }, { "name": "mailbox_id", "in": "path", "required": true, "schema": { "type": "string" } } ], "description": "Authorization and validation are enforced by the owning service.", "x-handler": "rename_mailbox", "x-source-file": "crates/synckhub-server/src/routes/mail/mailboxes.rs", "x-source-line": 149, "responses": { "default": { "description": "Service response. Error status and envelope depend on the operation." }, "2XX": { "description": "Successful JSON response", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/synckhub_mailcal.types.Mailbox" } } } } }, "requestBody": { "required": true, "content": { "application/json": { "schema": { "$ref": "#/components/schemas/synckhub_server.routes.mail.mailboxes.RenameMailboxRequest" } } } } } }, "/v1/integrations/mailcal/accounts/{account_id}/mail/mailboxes/{mailbox_id}/actions": { "post": { "operationId": "platform_post__v1_integrations_mailcal_accounts__account_id__mail_mailboxes__mailbox_id__actions", "summary": "mailbox action", "tags": [ "mail · mailboxes" ], "parameters": [ { "name": "account_id", "in": "path", "required": true, "schema": { "type": "string" } }, { "name": "mailbox_id", "in": "path", "required": true, "schema": { "type": "string" } } ], "description": "Authorization and validation are enforced by the owning service.", "x-handler": "mailbox_action", "x-source-file": "crates/synckhub-server/src/routes/mail/mailboxes.rs", "x-source-line": 149, "responses": { "default": { "description": "Service response. Error status and envelope depend on the operation." } }, "requestBody": { "required": true, "content": { "application/json": { "schema": { "$ref": "#/components/schemas/synckhub_server.routes.mail.mailboxes.MailboxActionRequest" } } } } } }, "/v1/integrations/mailcal/accounts/{account_id}/mail/mailboxes/{mailbox_id}/move": { "post": { "operationId": "platform_post__v1_integrations_mailcal_accounts__account_id__mail_mailboxes__mailbox_id__move", "summary": "move mailbox", "tags": [ "mail · mailboxes" ], "parameters": [ { "name": "account_id", "in": "path", "required": true, "schema": { "type": "string" } }, { "name": "mailbox_id", "in": "path", "required": true, "schema": { "type": "string" } } ], "description": "Authorization and validation are enforced by the owning service.", "x-handler": "move_mailbox", "x-source-file": "crates/synckhub-server/src/routes/mail/mailboxes.rs", "x-source-line": 149, "responses": { "default": { "description": "Service response. Error status and envelope depend on the operation." }, "2XX": { "description": "Successful JSON response", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/synckhub_mailcal.types.Mailbox" } } } } }, "requestBody": { "required": true, "content": { "application/json": { "schema": { "$ref": "#/components/schemas/synckhub_server.routes.mail.mailboxes.MoveMailboxRequest" } } } } } }, "/v1/integrations/mailcal/accounts/{account_id}/mail/message-action-jobs": { "post": { "operationId": "platform_post__v1_integrations_mailcal_accounts__account_id__mail_message_action_jobs", "summary": "create message action job", "tags": [ "mail · messages" ], "parameters": [ { "name": "account_id", "in": "path", "required": true, "schema": { "type": "string" } } ], "description": "Authorization and validation are enforced by the owning service.", "x-handler": "create_message_action_job", "x-source-file": "crates/synckhub-server/src/routes/mail/messages.rs", "x-source-line": 63, "responses": { "default": { "description": "Service response. Error status and envelope depend on the operation." }, "2XX": { "description": "Successful JSON response", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/synckhub_server.routes.mail.messages.MessageActionJobResponse" } } } } }, "requestBody": { "required": true, "content": { "application/json": { "schema": { "$ref": "#/components/schemas/synckhub_server.routes.mail.messages.MessageActionJobRequest" } } } } } }, "/v1/integrations/mailcal/accounts/{account_id}/mail/message-action-jobs/{job_id}": { "get": { "operationId": "platform_get__v1_integrations_mailcal_accounts__account_id__mail_message_action_jobs__job_id_", "summary": "get message action job", "tags": [ "mail · messages" ], "parameters": [ { "name": "account_id", "in": "path", "required": true, "schema": { "type": "string" } }, { "name": "job_id", "in": "path", "required": true, "schema": { "type": "string" } } ], "description": "Authorization and validation are enforced by the owning service.", "x-handler": "get_message_action_job", "x-source-file": "crates/synckhub-server/src/routes/mail/messages.rs", "x-source-line": 63, "responses": { "default": { "description": "Service response. Error status and envelope depend on the operation." }, "2XX": { "description": "Successful JSON response", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/synckhub_server.routes.mail.messages.MessageActionJobResponse" } } } } } }, "head": { "operationId": "platform_head__v1_integrations_mailcal_accounts__account_id__mail_message_action_jobs__job_id_", "summary": "get message action job", "tags": [ "mail · messages" ], "parameters": [ { "name": "account_id", "in": "path", "required": true, "schema": { "type": "string" } }, { "name": "job_id", "in": "path", "required": true, "schema": { "type": "string" } } ], "description": "Authorization and validation are enforced by the owning service.\n\nHEAD uses the GET handler and headers without a response body.", "x-handler": "get_message_action_job", "x-source-file": "crates/synckhub-server/src/routes/mail/messages.rs", "x-source-line": 63, "x-implicit-head": true, "responses": { "default": { "description": "Service response. Error status and envelope depend on the operation." } } } }, "/v1/integrations/mailcal/accounts/{account_id}/mail/message-action-jobs/{job_id}/acknowledge-unknown": { "post": { "operationId": "platform_post__v1_integrations_mailcal_accounts__account_id__mail_message_action_jobs__job_id__acknowledge_unknown", "summary": "acknowledge message action unknown", "tags": [ "mail · messages" ], "parameters": [ { "name": "account_id", "in": "path", "required": true, "schema": { "type": "string" } }, { "name": "job_id", "in": "path", "required": true, "schema": { "type": "string" } } ], "description": "Authorization and validation are enforced by the owning service.", "x-handler": "acknowledge_message_action_unknown", "x-source-file": "crates/synckhub-server/src/routes/mail/messages.rs", "x-source-line": 63, "responses": { "default": { "description": "Service response. Error status and envelope depend on the operation." }, "2XX": { "description": "Successful JSON response", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/synckhub_server.routes.mail.messages.MessageActionUnknownAcknowledgementResponse" } } } } } } }, "/v1/integrations/mailcal/accounts/{account_id}/mail/messages": { "get": { "operationId": "platform_get__v1_integrations_mailcal_accounts__account_id__mail_messages", "summary": "list messages", "tags": [ "mail · messages" ], "parameters": [ { "name": "account_id", "in": "path", "required": true, "schema": { "type": "string" } }, { "name": "mailbox_id", "in": "query", "required": false, "schema": { "anyOf": [ { "type": "string" }, { "type": "null" } ] } }, { "name": "q", "in": "query", "required": false, "schema": { "anyOf": [ { "type": "string" }, { "type": "null" } ] } }, { "name": "search_text", "in": "query", "required": false, "schema": { "anyOf": [ { "type": "string" }, { "type": "null" } ] } }, { "name": "search_field", "in": "query", "required": false, "schema": { "anyOf": [ { "type": "string" }, { "type": "null" } ] } }, { "name": "search_all", "in": "query", "required": false, "schema": { "anyOf": [ { "type": "string" }, { "type": "null" } ] } }, { "name": "search_subject", "in": "query", "required": false, "schema": { "anyOf": [ { "type": "string" }, { "type": "null" } ] } }, { "name": "search_from", "in": "query", "required": false, "schema": { "anyOf": [ { "type": "string" }, { "type": "null" } ] } }, { "name": "search_to", "in": "query", "required": false, "schema": { "anyOf": [ { "type": "string" }, { "type": "null" } ] } }, { "name": "search_participant", "in": "query", "required": false, "schema": { "anyOf": [ { "type": "string" }, { "type": "null" } ] } }, { "name": "search_body", "in": "query", "required": false, "schema": { "anyOf": [ { "type": "string" }, { "type": "null" } ] } }, { "name": "search_attachment_name", "in": "query", "required": false, "schema": { "anyOf": [ { "type": "string" }, { "type": "null" } ] } }, { "name": "has_attachments", "in": "query", "required": false, "schema": { "anyOf": [ { "type": "string" }, { "type": "null" } ] } }, { "name": "unread", "in": "query", "required": false, "schema": { "anyOf": [ { "type": "boolean" }, { "type": "null" } ], "description": "Inbox quick filter served from the projection (`is_read = FALSE`),\nnever from provider search." } }, { "name": "page_size", "in": "query", "required": false, "schema": { "anyOf": [ { "type": "integer", "minimum": 0 }, { "type": "null" } ] } }, { "name": "page_token", "in": "query", "required": false, "schema": { "anyOf": [ { "type": "string" }, { "type": "null" } ] } }, { "name": "search_mode", "in": "query", "required": false, "schema": { "anyOf": [ { "type": "string" }, { "type": "null" } ], "description": "Mirror v1 (spec 6.2): `q` over a mirrored mailbox is served from the\naccount's own search index by default; `search_mode=provider` forces\nthe provider search explicitly." } } ], "description": "Authorization and validation are enforced by the owning service.", "x-handler": "list_messages", "x-source-file": "crates/synckhub-server/src/routes/mail/messages.rs", "x-source-line": 63, "responses": { "default": { "description": "Service response. Error status and envelope depend on the operation." } } }, "head": { "operationId": "platform_head__v1_integrations_mailcal_accounts__account_id__mail_messages", "summary": "list messages", "tags": [ "mail · messages" ], "parameters": [ { "name": "account_id", "in": "path", "required": true, "schema": { "type": "string" } }, { "name": "mailbox_id", "in": "query", "required": false, "schema": { "anyOf": [ { "type": "string" }, { "type": "null" } ] } }, { "name": "q", "in": "query", "required": false, "schema": { "anyOf": [ { "type": "string" }, { "type": "null" } ] } }, { "name": "search_text", "in": "query", "required": false, "schema": { "anyOf": [ { "type": "string" }, { "type": "null" } ] } }, { "name": "search_field", "in": "query", "required": false, "schema": { "anyOf": [ { "type": "string" }, { "type": "null" } ] } }, { "name": "search_all", "in": "query", "required": false, "schema": { "anyOf": [ { "type": "string" }, { "type": "null" } ] } }, { "name": "search_subject", "in": "query", "required": false, "schema": { "anyOf": [ { "type": "string" }, { "type": "null" } ] } }, { "name": "search_from", "in": "query", "required": false, "schema": { "anyOf": [ { "type": "string" }, { "type": "null" } ] } }, { "name": "search_to", "in": "query", "required": false, "schema": { "anyOf": [ { "type": "string" }, { "type": "null" } ] } }, { "name": "search_participant", "in": "query", "required": false, "schema": { "anyOf": [ { "type": "string" }, { "type": "null" } ] } }, { "name": "search_body", "in": "query", "required": false, "schema": { "anyOf": [ { "type": "string" }, { "type": "null" } ] } }, { "name": "search_attachment_name", "in": "query", "required": false, "schema": { "anyOf": [ { "type": "string" }, { "type": "null" } ] } }, { "name": "has_attachments", "in": "query", "required": false, "schema": { "anyOf": [ { "type": "string" }, { "type": "null" } ] } }, { "name": "unread", "in": "query", "required": false, "schema": { "anyOf": [ { "type": "boolean" }, { "type": "null" } ], "description": "Inbox quick filter served from the projection (`is_read = FALSE`),\nnever from provider search." } }, { "name": "page_size", "in": "query", "required": false, "schema": { "anyOf": [ { "type": "integer", "minimum": 0 }, { "type": "null" } ] } }, { "name": "page_token", "in": "query", "required": false, "schema": { "anyOf": [ { "type": "string" }, { "type": "null" } ] } }, { "name": "search_mode", "in": "query", "required": false, "schema": { "anyOf": [ { "type": "string" }, { "type": "null" } ], "description": "Mirror v1 (spec 6.2): `q` over a mirrored mailbox is served from the\naccount's own search index by default; `search_mode=provider` forces\nthe provider search explicitly." } } ], "description": "Authorization and validation are enforced by the owning service.\n\nHEAD uses the GET handler and headers without a response body.", "x-handler": "list_messages", "x-source-file": "crates/synckhub-server/src/routes/mail/messages.rs", "x-source-line": 63, "x-implicit-head": true, "responses": { "default": { "description": "Service response. Error status and envelope depend on the operation." } } } }, "/v1/integrations/mailcal/accounts/{account_id}/mail/messages/{message_id}": { "delete": { "operationId": "platform_delete__v1_integrations_mailcal_accounts__account_id__mail_messages__message_id_", "summary": "delete message", "tags": [ "mail · messages" ], "parameters": [ { "name": "account_id", "in": "path", "required": true, "schema": { "type": "string" } }, { "name": "message_id", "in": "path", "required": true, "schema": { "type": "string" } }, { "name": "revision", "in": "query", "required": true, "schema": { "type": "integer" } } ], "description": "Authorization and validation are enforced by the owning service.", "x-handler": "super::native::delete_message", "x-source-file": "crates/synckhub-server/src/routes/mail/messages.rs", "x-source-line": 63, "responses": { "default": { "description": "Service response. Error status and envelope depend on the operation." } } }, "get": { "operationId": "platform_get__v1_integrations_mailcal_accounts__account_id__mail_messages__message_id_", "summary": "get message", "tags": [ "mail · messages" ], "parameters": [ { "name": "account_id", "in": "path", "required": true, "schema": { "type": "string" } }, { "name": "message_id", "in": "path", "required": true, "schema": { "type": "string" } } ], "description": "Authorization and validation are enforced by the owning service.", "x-handler": "get_message", "x-source-file": "crates/synckhub-server/src/routes/mail/messages.rs", "x-source-line": 63, "responses": { "default": { "description": "Service response. Error status and envelope depend on the operation." } } }, "head": { "operationId": "platform_head__v1_integrations_mailcal_accounts__account_id__mail_messages__message_id_", "summary": "get message", "tags": [ "mail · messages" ], "parameters": [ { "name": "account_id", "in": "path", "required": true, "schema": { "type": "string" } }, { "name": "message_id", "in": "path", "required": true, "schema": { "type": "string" } } ], "description": "Authorization and validation are enforced by the owning service.\n\nHEAD uses the GET handler and headers without a response body.", "x-handler": "get_message", "x-source-file": "crates/synckhub-server/src/routes/mail/messages.rs", "x-source-line": 63, "x-implicit-head": true, "responses": { "default": { "description": "Service response. Error status and envelope depend on the operation." } } } }, "/v1/integrations/mailcal/accounts/{account_id}/mail/messages/{message_id}/actions": { "post": { "operationId": "platform_post__v1_integrations_mailcal_accounts__account_id__mail_messages__message_id__actions", "summary": "message action", "tags": [ "mail · messages" ], "parameters": [ { "name": "account_id", "in": "path", "required": true, "schema": { "type": "string" } }, { "name": "message_id", "in": "path", "required": true, "schema": { "type": "string" } } ], "description": "Authorization and validation are enforced by the owning service.", "x-handler": "message_action", "x-source-file": "crates/synckhub-server/src/routes/mail/messages.rs", "x-source-line": 63, "responses": { "default": { "description": "Service response. Error status and envelope depend on the operation." } }, "requestBody": { "required": true, "content": { "application/json": { "schema": { "$ref": "#/components/schemas/synckhub_server.routes.mail.messages.MessageActionRequest" } } } } } }, "/v1/integrations/mailcal/accounts/{account_id}/mail/messages/{message_id}/archive-to-synck": { "post": { "operationId": "platform_post__v1_integrations_mailcal_accounts__account_id__mail_messages__message_id__archive_to_synck", "summary": "archive message", "tags": [ "mail · archive" ], "parameters": [ { "name": "account_id", "in": "path", "required": true, "schema": { "type": "string" } }, { "name": "message_id", "in": "path", "required": true, "schema": { "type": "string" } } ], "description": "Authorization and validation are enforced by the owning service.", "x-handler": "archive_message", "x-source-file": "crates/synckhub-server/src/routes/mail/archive.rs", "x-source-line": 100, "responses": { "default": { "description": "Service response. Error status and envelope depend on the operation." } }, "requestBody": { "required": true, "content": { "application/json": { "schema": { "$ref": "#/components/schemas/synckhub_server.routes.mail.archive.ArchiveRequest" } } } } } }, "/v1/integrations/mailcal/accounts/{account_id}/mail/messages/{message_id}/attachment-save-jobs": { "post": { "operationId": "platform_post__v1_integrations_mailcal_accounts__account_id__mail_messages__message_id__attachment_save_jobs", "summary": "enqueue attachment save job", "tags": [ "mail · attachments" ], "parameters": [ { "name": "account_id", "in": "path", "required": true, "schema": { "type": "string" } }, { "name": "message_id", "in": "path", "required": true, "schema": { "type": "string" } } ], "description": "Authorization and validation are enforced by the owning service.", "x-handler": "enqueue_attachment_save_job", "x-source-file": "crates/synckhub-server/src/routes/mail/attachments.rs", "x-source-line": 66, "responses": { "default": { "description": "Service response. Error status and envelope depend on the operation." }, "2XX": { "description": "Successful JSON response", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/synckhub_server.routes.mail.attachments.AttachmentSaveJobResponse" } } } } }, "requestBody": { "required": true, "content": { "application/json": { "schema": { "$ref": "#/components/schemas/synckhub_server.routes.mail.attachments.EnqueueAttachmentSaveJobRequest" } } } } } }, "/v1/integrations/mailcal/accounts/{account_id}/mail/messages/{message_id}/attachments/{attachment_id}": { "get": { "operationId": "platform_get__v1_integrations_mailcal_accounts__account_id__mail_messages__message_id__attachments__attachment_id_", "summary": "download attachment", "tags": [ "mail · attachments" ], "parameters": [ { "name": "account_id", "in": "path", "required": true, "schema": { "type": "string" } }, { "name": "message_id", "in": "path", "required": true, "schema": { "type": "string" } }, { "name": "attachment_id", "in": "path", "required": true, "schema": { "type": "string" } } ], "description": "Authorization and validation are enforced by the owning service.", "x-handler": "download_attachment", "x-source-file": "crates/synckhub-server/src/routes/mail/attachments.rs", "x-source-line": 66, "responses": { "default": { "description": "Service response. Error status and envelope depend on the operation." } } }, "head": { "operationId": "platform_head__v1_integrations_mailcal_accounts__account_id__mail_messages__message_id__attachments__attachment_id_", "summary": "download attachment", "tags": [ "mail · attachments" ], "parameters": [ { "name": "account_id", "in": "path", "required": true, "schema": { "type": "string" } }, { "name": "message_id", "in": "path", "required": true, "schema": { "type": "string" } }, { "name": "attachment_id", "in": "path", "required": true, "schema": { "type": "string" } } ], "description": "Authorization and validation are enforced by the owning service.\n\nHEAD uses the GET handler and headers without a response body.", "x-handler": "download_attachment", "x-source-file": "crates/synckhub-server/src/routes/mail/attachments.rs", "x-source-line": 66, "x-implicit-head": true, "responses": { "default": { "description": "Service response. Error status and envelope depend on the operation." } } } }, "/v1/integrations/mailcal/accounts/{account_id}/mail/messages/{message_id}/attachments/save-suggestions-batch": { "post": { "operationId": "platform_post__v1_integrations_mailcal_accounts__account_id__mail_messages__message_id__attachments_save_suggestions_batch", "summary": "get attachment save suggestions batch", "tags": [ "mail · routing" ], "parameters": [ { "name": "account_id", "in": "path", "required": true, "schema": { "type": "string" } }, { "name": "message_id", "in": "path", "required": true, "schema": { "type": "string" } } ], "description": "Authorization and validation are enforced by the owning service.", "x-handler": "get_attachment_save_suggestions_batch", "x-source-file": "crates/synckhub-server/src/routes/mail/routing.rs", "x-source-line": 51, "responses": { "default": { "description": "Service response. Error status and envelope depend on the operation." }, "2XX": { "description": "Successful JSON response", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/synckhub_server.routes.mail.routing.AttachmentBatchSaveSuggestionsResponse" } } } } }, "requestBody": { "required": true, "content": { "application/json": { "schema": { "$ref": "#/components/schemas/synckhub_server.routes.mail.routing.AttachmentBatchSaveSuggestionsRequest" } } } } } }, "/v1/integrations/mailcal/accounts/{account_id}/mail/messages/{message_id}/attachments/save-to-existing-file": { "post": { "operationId": "platform_post__v1_integrations_mailcal_accounts__account_id__mail_messages__message_id__attachments_save_to_existing_file", "summary": "save attachment to existing file", "tags": [ "mail · attachments" ], "parameters": [ { "name": "account_id", "in": "path", "required": true, "schema": { "type": "string" } }, { "name": "message_id", "in": "path", "required": true, "schema": { "type": "string" } } ], "description": "Authorization and validation are enforced by the owning service.", "x-handler": "save_attachment_to_existing_file", "x-source-file": "crates/synckhub-server/src/routes/mail/attachments.rs", "x-source-line": 66, "responses": { "default": { "description": "Service response. Error status and envelope depend on the operation." }, "2XX": { "description": "Successful JSON response", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/synckhub_server.routes.mail.attachments.SaveAttachmentToExistingFileResponse" } } } } }, "requestBody": { "required": true, "content": { "application/json": { "schema": { "$ref": "#/components/schemas/synckhub_server.routes.mail.attachments.SaveAttachmentToExistingFileRequest" } } } } } }, "/v1/integrations/mailcal/accounts/{account_id}/mail/messages/{message_id}/attachments/save-to-synck": { "post": { "operationId": "platform_post__v1_integrations_mailcal_accounts__account_id__mail_messages__message_id__attachments_save_to_synck", "summary": "save attachments to synck", "tags": [ "mail · attachments" ], "parameters": [ { "name": "account_id", "in": "path", "required": true, "schema": { "type": "string" } }, { "name": "message_id", "in": "path", "required": true, "schema": { "type": "string" } } ], "description": "Authorization and validation are enforced by the owning service.", "x-handler": "save_attachments_to_synck", "x-source-file": "crates/synckhub-server/src/routes/mail/attachments.rs", "x-source-line": 66, "responses": { "default": { "description": "Service response. Error status and envelope depend on the operation." }, "2XX": { "description": "Successful JSON response", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/synckhub_server.routes.mail.attachments.SaveAttachmentsResponse" } } } } }, "requestBody": { "required": true, "content": { "application/json": { "schema": { "$ref": "#/components/schemas/synckhub_server.routes.mail.attachments.SaveAttachmentsRequest" } } } } } }, "/v1/integrations/mailcal/accounts/{account_id}/mail/messages/{message_id}/inline-images/{inline_image_id}": { "get": { "operationId": "platform_get__v1_integrations_mailcal_accounts__account_id__mail_messages__message_id__inline_images__inline_image_id_", "summary": "download inline image", "tags": [ "mail · attachments" ], "parameters": [ { "name": "account_id", "in": "path", "required": true, "schema": { "type": "string" } }, { "name": "message_id", "in": "path", "required": true, "schema": { "type": "string" } }, { "name": "inline_image_id", "in": "path", "required": true, "schema": { "type": "string" } } ], "description": "Authorization and validation are enforced by the owning service.", "x-handler": "download_inline_image", "x-source-file": "crates/synckhub-server/src/routes/mail/attachments.rs", "x-source-line": 66, "responses": { "default": { "description": "Service response. Error status and envelope depend on the operation." } } }, "head": { "operationId": "platform_head__v1_integrations_mailcal_accounts__account_id__mail_messages__message_id__inline_images__inline_image_id_", "summary": "download inline image", "tags": [ "mail · attachments" ], "parameters": [ { "name": "account_id", "in": "path", "required": true, "schema": { "type": "string" } }, { "name": "message_id", "in": "path", "required": true, "schema": { "type": "string" } }, { "name": "inline_image_id", "in": "path", "required": true, "schema": { "type": "string" } } ], "description": "Authorization and validation are enforced by the owning service.\n\nHEAD uses the GET handler and headers without a response body.", "x-handler": "download_inline_image", "x-source-file": "crates/synckhub-server/src/routes/mail/attachments.rs", "x-source-line": 66, "x-implicit-head": true, "responses": { "default": { "description": "Service response. Error status and envelope depend on the operation." } } } }, "/v1/integrations/mailcal/accounts/{account_id}/mail/messages/{message_id}/raw-rfc822": { "get": { "operationId": "platform_get__v1_integrations_mailcal_accounts__account_id__mail_messages__message_id__raw_rfc822", "summary": "download message raw rfc822", "tags": [ "mail · messages" ], "parameters": [ { "name": "account_id", "in": "path", "required": true, "schema": { "type": "string" } }, { "name": "message_id", "in": "path", "required": true, "schema": { "type": "string" } } ], "description": "Authorization and validation are enforced by the owning service.", "x-handler": "download_message_raw_rfc822", "x-source-file": "crates/synckhub-server/src/routes/mail/messages.rs", "x-source-line": 63, "responses": { "default": { "description": "Service response. Error status and envelope depend on the operation." } } }, "head": { "operationId": "platform_head__v1_integrations_mailcal_accounts__account_id__mail_messages__message_id__raw_rfc822", "summary": "download message raw rfc822", "tags": [ "mail · messages" ], "parameters": [ { "name": "account_id", "in": "path", "required": true, "schema": { "type": "string" } }, { "name": "message_id", "in": "path", "required": true, "schema": { "type": "string" } } ], "description": "Authorization and validation are enforced by the owning service.\n\nHEAD uses the GET handler and headers without a response body.", "x-handler": "download_message_raw_rfc822", "x-source-file": "crates/synckhub-server/src/routes/mail/messages.rs", "x-source-line": 63, "x-implicit-head": true, "responses": { "default": { "description": "Service response. Error status and envelope depend on the operation." } } } }, "/v1/integrations/mailcal/accounts/{account_id}/mail/messages/{message_id}/routing-rules": { "delete": { "operationId": "platform_delete__v1_integrations_mailcal_accounts__account_id__mail_messages__message_id__routing_rules", "summary": "delete routing rule", "tags": [ "mail · routing" ], "parameters": [ { "name": "account_id", "in": "path", "required": true, "schema": { "type": "string" } }, { "name": "message_id", "in": "path", "required": true, "schema": { "type": "string" } } ], "description": "Authorization and validation are enforced by the owning service.", "x-handler": "delete_routing_rule", "x-source-file": "crates/synckhub-server/src/routes/mail/routing.rs", "x-source-line": 51, "responses": { "default": { "description": "Service response. Error status and envelope depend on the operation." } }, "requestBody": { "required": true, "content": { "application/json": { "schema": { "$ref": "#/components/schemas/synckhub_server.routes.mail.routing.DeleteRoutingRuleRequest" } } } } }, "post": { "operationId": "platform_post__v1_integrations_mailcal_accounts__account_id__mail_messages__message_id__routing_rules", "summary": "upsert routing rule", "tags": [ "mail · routing" ], "parameters": [ { "name": "account_id", "in": "path", "required": true, "schema": { "type": "string" } }, { "name": "message_id", "in": "path", "required": true, "schema": { "type": "string" } } ], "description": "Authorization and validation are enforced by the owning service.", "x-handler": "upsert_routing_rule", "x-source-file": "crates/synckhub-server/src/routes/mail/routing.rs", "x-source-line": 51, "responses": { "default": { "description": "Service response. Error status and envelope depend on the operation." } }, "requestBody": { "required": true, "content": { "application/json": { "schema": { "$ref": "#/components/schemas/synckhub_server.routes.mail.routing.UpsertRoutingRuleRequest" } } } } } }, "/v1/integrations/mailcal/accounts/{account_id}/mail/messages/{message_id}/save-suggestions": { "get": { "operationId": "platform_get__v1_integrations_mailcal_accounts__account_id__mail_messages__message_id__save_suggestions", "summary": "get save suggestions", "tags": [ "mail · routing" ], "parameters": [ { "name": "account_id", "in": "path", "required": true, "schema": { "type": "string" } }, { "name": "message_id", "in": "path", "required": true, "schema": { "type": "string" } }, { "name": "repo_id", "in": "query", "required": true, "schema": { "type": "string" } }, { "name": "limit", "in": "query", "required": false, "schema": { "anyOf": [ { "type": "integer", "minimum": 0 }, { "type": "null" } ] } } ], "description": "Authorization and validation are enforced by the owning service.", "x-handler": "get_save_suggestions", "x-source-file": "crates/synckhub-server/src/routes/mail/routing.rs", "x-source-line": 51, "responses": { "default": { "description": "Service response. Error status and envelope depend on the operation." }, "2XX": { "description": "Successful JSON response", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/synckhub_server.routes.mail.routing.SaveSuggestionsResponse" } } } } } }, "head": { "operationId": "platform_head__v1_integrations_mailcal_accounts__account_id__mail_messages__message_id__save_suggestions", "summary": "get save suggestions", "tags": [ "mail · routing" ], "parameters": [ { "name": "account_id", "in": "path", "required": true, "schema": { "type": "string" } }, { "name": "message_id", "in": "path", "required": true, "schema": { "type": "string" } }, { "name": "repo_id", "in": "query", "required": true, "schema": { "type": "string" } }, { "name": "limit", "in": "query", "required": false, "schema": { "anyOf": [ { "type": "integer", "minimum": 0 }, { "type": "null" } ] } } ], "description": "Authorization and validation are enforced by the owning service.\n\nHEAD uses the GET handler and headers without a response body.", "x-handler": "get_save_suggestions", "x-source-file": "crates/synckhub-server/src/routes/mail/routing.rs", "x-source-line": 51, "x-implicit-head": true, "responses": { "default": { "description": "Service response. Error status and envelope depend on the operation." } } } }, "/v1/integrations/mailcal/accounts/{account_id}/mail/messages/{message_id}/unsubscribe-capability": { "get": { "operationId": "platform_get__v1_integrations_mailcal_accounts__account_id__mail_messages__message_id__unsubscribe_capability", "summary": "capability", "tags": [ "mail · native_unsubscribe" ], "parameters": [ { "name": "account_id", "in": "path", "required": true, "schema": { "type": "string", "format": "uuid" } }, { "name": "message_id", "in": "path", "required": true, "schema": { "type": "string", "format": "uuid" } } ], "description": "Authorization and validation are enforced by the owning service.", "x-handler": "capability", "x-source-file": "crates/synckhub-server/src/routes/mail/native_unsubscribe.rs", "x-source-line": 28, "responses": { "default": { "description": "Service response. Error status and envelope depend on the operation." }, "2XX": { "description": "Successful JSON response", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/synckhub_server.native_mail.unsubscribe.UnsubscribeCapability" } } } } } }, "head": { "operationId": "platform_head__v1_integrations_mailcal_accounts__account_id__mail_messages__message_id__unsubscribe_capability", "summary": "capability", "tags": [ "mail · native_unsubscribe" ], "parameters": [ { "name": "account_id", "in": "path", "required": true, "schema": { "type": "string", "format": "uuid" } }, { "name": "message_id", "in": "path", "required": true, "schema": { "type": "string", "format": "uuid" } } ], "description": "Authorization and validation are enforced by the owning service.\n\nHEAD uses the GET handler and headers without a response body.", "x-handler": "capability", "x-source-file": "crates/synckhub-server/src/routes/mail/native_unsubscribe.rs", "x-source-line": 28, "x-implicit-head": true, "responses": { "default": { "description": "Service response. Error status and envelope depend on the operation." } } } }, "/v1/integrations/mailcal/accounts/{account_id}/mail/messages/{message_id}/unsubscribe-commands": { "post": { "operationId": "platform_post__v1_integrations_mailcal_accounts__account_id__mail_messages__message_id__unsubscribe_commands", "summary": "command", "tags": [ "mail · native_unsubscribe" ], "parameters": [ { "name": "account_id", "in": "path", "required": true, "schema": { "type": "string", "format": "uuid" } }, { "name": "message_id", "in": "path", "required": true, "schema": { "type": "string", "format": "uuid" } } ], "description": "Authorization and validation are enforced by the owning service.", "x-handler": "command", "x-source-file": "crates/synckhub-server/src/routes/mail/native_unsubscribe.rs", "x-source-line": 28, "responses": { "default": { "description": "Service response. Error status and envelope depend on the operation." }, "2XX": { "description": "Successful JSON response", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/synckhub_server.native_mail.unsubscribe.UnsubscribeReceipt" } } } } }, "requestBody": { "required": true, "content": { "application/json": { "schema": { "$ref": "#/components/schemas/synckhub_server.routes.mail.native_unsubscribe.UnsubscribeCommandRequest" } } } } } }, "/v1/integrations/mailcal/accounts/{account_id}/mail/messages/actions": { "post": { "operationId": "platform_post__v1_integrations_mailcal_accounts__account_id__mail_messages_actions", "summary": "message actions", "tags": [ "mail · messages" ], "parameters": [ { "name": "account_id", "in": "path", "required": true, "schema": { "type": "string" } } ], "description": "Authorization and validation are enforced by the owning service.", "x-handler": "message_actions", "x-source-file": "crates/synckhub-server/src/routes/mail/messages.rs", "x-source-line": 63, "responses": { "default": { "description": "Service response. Error status and envelope depend on the operation." } }, "requestBody": { "required": true, "content": { "application/json": { "schema": { "$ref": "#/components/schemas/synckhub_server.routes.mail.messages.MessageActionsRequest" } } } } } }, "/v1/integrations/mailcal/accounts/{account_id}/mail/messages/read": { "post": { "operationId": "platform_post__v1_integrations_mailcal_accounts__account_id__mail_messages_read", "summary": "read message", "tags": [ "mail · messages" ], "parameters": [ { "name": "account_id", "in": "path", "required": true, "schema": { "type": "string" } } ], "description": "Authorization and validation are enforced by the owning service.", "x-handler": "read_message", "x-source-file": "crates/synckhub-server/src/routes/mail/messages.rs", "x-source-line": 63, "responses": { "default": { "description": "Service response. Error status and envelope depend on the operation." } }, "requestBody": { "required": true, "content": { "application/json": { "schema": { "$ref": "#/components/schemas/synckhub_server.routes.mail.messages.ReadMessageRequest" } } } } } }, "/v1/integrations/mailcal/accounts/{account_id}/mail/native-clear-spam-commands": { "post": { "operationId": "platform_post__v1_integrations_mailcal_accounts__account_id__mail_native_clear_spam_commands", "summary": "command", "tags": [ "mail · native_clear_spam" ], "parameters": [ { "name": "account_id", "in": "path", "required": true, "schema": { "type": "string", "format": "uuid" } } ], "description": "Authorization and validation are enforced by the owning service.", "x-handler": "command", "x-source-file": "crates/synckhub-server/src/routes/mail/native_clear_spam.rs", "x-source-line": 41, "responses": { "default": { "description": "Service response. Error status and envelope depend on the operation." }, "2XX": { "description": "Successful JSON response", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/synckhub_server.routes.mail.native_clear_spam.ClearSpamCommandResponse" } } } } }, "requestBody": { "required": true, "content": { "application/json": { "schema": { "$ref": "#/components/schemas/synckhub_server.routes.mail.native_clear_spam.ClearSpamCommandRequest" } } } } } }, "/v1/integrations/mailcal/accounts/{account_id}/mail/native-drafts": { "post": { "operationId": "platform_post__v1_integrations_mailcal_accounts__account_id__mail_native_drafts", "summary": "create", "tags": [ "mail · native_compose" ], "parameters": [ { "name": "account_id", "in": "path", "required": true, "schema": { "type": "string", "format": "uuid" } } ], "description": "Authorization and validation are enforced by the owning service.", "x-handler": "create", "x-source-file": "crates/synckhub-server/src/routes/mail/native_compose.rs", "x-source-line": 63, "responses": { "default": { "description": "Service response. Error status and envelope depend on the operation." }, "2XX": { "description": "Successful JSON response", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/synckhub_server.native_mail.drafts.Draft" } } } } }, "requestBody": { "required": true, "content": { "application/json": { "schema": { "$ref": "#/components/schemas/synckhub_server.routes.mail.native_compose.Create" } } } } } }, "/v1/integrations/mailcal/accounts/{account_id}/mail/native-drafts/{draft_id}": { "delete": { "operationId": "platform_delete__v1_integrations_mailcal_accounts__account_id__mail_native_drafts__draft_id_", "summary": "delete", "tags": [ "mail · native_compose" ], "parameters": [ { "name": "account_id", "in": "path", "required": true, "schema": { "type": "string", "format": "uuid" } }, { "name": "draft_id", "in": "path", "required": true, "schema": { "type": "string", "format": "uuid" } }, { "name": "revision", "in": "query", "required": true, "schema": { "type": "integer" } } ], "description": "Authorization and validation are enforced by the owning service.", "x-handler": "delete", "x-source-file": "crates/synckhub-server/src/routes/mail/native_compose.rs", "x-source-line": 63, "responses": { "default": { "description": "Service response. Error status and envelope depend on the operation." } } }, "put": { "operationId": "platform_put__v1_integrations_mailcal_accounts__account_id__mail_native_drafts__draft_id_", "summary": "update", "tags": [ "mail · native_compose" ], "parameters": [ { "name": "account_id", "in": "path", "required": true, "schema": { "type": "string", "format": "uuid" } }, { "name": "draft_id", "in": "path", "required": true, "schema": { "type": "string", "format": "uuid" } } ], "description": "Authorization and validation are enforced by the owning service.", "x-handler": "update", "x-source-file": "crates/synckhub-server/src/routes/mail/native_compose.rs", "x-source-line": 63, "responses": { "default": { "description": "Service response. Error status and envelope depend on the operation." }, "2XX": { "description": "Successful JSON response", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/synckhub_server.routes.mail.native_compose.DraftWriteReceipt" } } } } }, "requestBody": { "required": true, "content": { "application/json": { "schema": { "$ref": "#/components/schemas/synckhub_server.routes.mail.native_compose.Update" } } } } }, "get": { "operationId": "platform_get__v1_integrations_mailcal_accounts__account_id__mail_native_drafts__draft_id_", "summary": "read", "tags": [ "mail · native_compose" ], "parameters": [ { "name": "account_id", "in": "path", "required": true, "schema": { "type": "string", "format": "uuid" } }, { "name": "draft_id", "in": "path", "required": true, "schema": { "type": "string", "format": "uuid" } } ], "description": "Authorization and validation are enforced by the owning service.", "x-handler": "read", "x-source-file": "crates/synckhub-server/src/routes/mail/native_compose.rs", "x-source-line": 63, "responses": { "default": { "description": "Service response. Error status and envelope depend on the operation." }, "2XX": { "description": "Successful JSON response", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/synckhub_server.native_mail.drafts.Draft" } } } } } }, "head": { "operationId": "platform_head__v1_integrations_mailcal_accounts__account_id__mail_native_drafts__draft_id_", "summary": "read", "tags": [ "mail · native_compose" ], "parameters": [ { "name": "account_id", "in": "path", "required": true, "schema": { "type": "string", "format": "uuid" } }, { "name": "draft_id", "in": "path", "required": true, "schema": { "type": "string", "format": "uuid" } } ], "description": "Authorization and validation are enforced by the owning service.\n\nHEAD uses the GET handler and headers without a response body.", "x-handler": "read", "x-source-file": "crates/synckhub-server/src/routes/mail/native_compose.rs", "x-source-line": 63, "x-implicit-head": true, "responses": { "default": { "description": "Service response. Error status and envelope depend on the operation." } } } }, "/v1/integrations/mailcal/accounts/{account_id}/mail/native-mark-all-read-commands": { "post": { "operationId": "platform_post__v1_integrations_mailcal_accounts__account_id__mail_native_mark_all_read_commands", "summary": "command", "tags": [ "mail · native_mark_all_read" ], "parameters": [ { "name": "account_id", "in": "path", "required": true, "schema": { "type": "string", "format": "uuid" } } ], "description": "Authorization and validation are enforced by the owning service.", "x-handler": "command", "x-source-file": "crates/synckhub-server/src/routes/mail/native_mark_all_read.rs", "x-source-line": 52, "responses": { "default": { "description": "Service response. Error status and envelope depend on the operation." }, "2XX": { "description": "Successful JSON response", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/synckhub_server.routes.mail.native_mark_all_read.MarkAllReadCommandResponse" } } } } }, "requestBody": { "required": true, "content": { "application/json": { "schema": { "$ref": "#/components/schemas/synckhub_server.routes.mail.native_mark_all_read.MarkAllReadCommandRequest" } } } } } }, "/v1/integrations/mailcal/accounts/{account_id}/mail/native-pin-commands": { "post": { "operationId": "platform_post__v1_integrations_mailcal_accounts__account_id__mail_native_pin_commands", "summary": "command", "tags": [ "mail · native_pin" ], "parameters": [ { "name": "account_id", "in": "path", "required": true, "schema": { "type": "string", "format": "uuid" } } ], "description": "Authorization and validation are enforced by the owning service.", "x-handler": "command", "x-source-file": "crates/synckhub-server/src/routes/mail/native_pin.rs", "x-source-line": 89, "responses": { "default": { "description": "Service response. Error status and envelope depend on the operation." }, "2XX": { "description": "Successful JSON response", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/synckhub_server.routes.mail.native_pin.PinCommandResponse" } } } } }, "requestBody": { "required": true, "content": { "application/json": { "schema": { "$ref": "#/components/schemas/synckhub_server.routes.mail.native_pin.PinCommandRequest" } } } } } }, "/v1/integrations/mailcal/accounts/{account_id}/mail/native-snooze-commands": { "post": { "operationId": "platform_post__v1_integrations_mailcal_accounts__account_id__mail_native_snooze_commands", "summary": "command", "tags": [ "mail · native_snooze" ], "parameters": [ { "name": "account_id", "in": "path", "required": true, "schema": { "type": "string", "format": "uuid" } } ], "description": "Authorization and validation are enforced by the owning service.", "x-handler": "command", "x-source-file": "crates/synckhub-server/src/routes/mail/native_snooze.rs", "x-source-line": 103, "responses": { "default": { "description": "Service response. Error status and envelope depend on the operation." }, "2XX": { "description": "Successful JSON response", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/synckhub_server.routes.mail.native_snooze.SnoozeCommandResponse" } } } } }, "requestBody": { "required": true, "content": { "application/json": { "schema": { "$ref": "#/components/schemas/synckhub_server.routes.mail.native_snooze.SnoozeCommandRequest" } } } } } }, "/v1/integrations/mailcal/accounts/{account_id}/mail/personal-sender-policy": { "get": { "operationId": "platform_get__v1_integrations_mailcal_accounts__account_id__mail_personal_sender_policy", "summary": "read", "tags": [ "mail · native_sender_policy" ], "parameters": [ { "name": "account_id", "in": "path", "required": true, "schema": { "type": "string", "format": "uuid" } } ], "description": "Authorization and validation are enforced by the owning service.", "x-handler": "read", "x-source-file": "crates/synckhub-server/src/routes/mail/native_sender_policy.rs", "x-source-line": 29, "responses": { "default": { "description": "Service response. Error status and envelope depend on the operation." }, "2XX": { "description": "Successful JSON response", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/synckhub_server.native_mail.sender_policy.PersonalSenderPolicy" } } } } } }, "head": { "operationId": "platform_head__v1_integrations_mailcal_accounts__account_id__mail_personal_sender_policy", "summary": "read", "tags": [ "mail · native_sender_policy" ], "parameters": [ { "name": "account_id", "in": "path", "required": true, "schema": { "type": "string", "format": "uuid" } } ], "description": "Authorization and validation are enforced by the owning service.\n\nHEAD uses the GET handler and headers without a response body.", "x-handler": "read", "x-source-file": "crates/synckhub-server/src/routes/mail/native_sender_policy.rs", "x-source-line": 29, "x-implicit-head": true, "responses": { "default": { "description": "Service response. Error status and envelope depend on the operation." } } } }, "/v1/integrations/mailcal/accounts/{account_id}/mail/personal-sender-policy-commands": { "post": { "operationId": "platform_post__v1_integrations_mailcal_accounts__account_id__mail_personal_sender_policy_commands", "summary": "command", "tags": [ "mail · native_sender_policy" ], "parameters": [ { "name": "account_id", "in": "path", "required": true, "schema": { "type": "string", "format": "uuid" } } ], "description": "Authorization and validation are enforced by the owning service.", "x-handler": "command", "x-source-file": "crates/synckhub-server/src/routes/mail/native_sender_policy.rs", "x-source-line": 29, "responses": { "default": { "description": "Service response. Error status and envelope depend on the operation." }, "2XX": { "description": "Successful JSON response", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/synckhub_server.native_mail.sender_policy.PersonalSenderPolicyReceipt" } } } } }, "requestBody": { "required": true, "content": { "application/json": { "schema": { "$ref": "#/components/schemas/synckhub_server.routes.mail.native_sender_policy.PersonalSenderPolicyCommandRequest" } } } } } }, "/v1/integrations/mailcal/accounts/{account_id}/mail/personal-sender-policy-commands/{command_id}": { "get": { "operationId": "platform_get__v1_integrations_mailcal_accounts__account_id__mail_personal_sender_policy_commands__command_id_", "summary": "command receipt", "tags": [ "mail · native_sender_policy" ], "parameters": [ { "name": "account_id", "in": "path", "required": true, "schema": { "type": "string", "format": "uuid" } }, { "name": "command_id", "in": "path", "required": true, "schema": { "type": "string", "format": "uuid" } } ], "description": "Authorization and validation are enforced by the owning service.", "x-handler": "command_receipt", "x-source-file": "crates/synckhub-server/src/routes/mail/native_sender_policy.rs", "x-source-line": 29, "responses": { "default": { "description": "Service response. Error status and envelope depend on the operation." }, "2XX": { "description": "Successful JSON response", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/synckhub_server.native_mail.sender_policy.PersonalSenderPolicyReceipt" } } } } } }, "head": { "operationId": "platform_head__v1_integrations_mailcal_accounts__account_id__mail_personal_sender_policy_commands__command_id_", "summary": "command receipt", "tags": [ "mail · native_sender_policy" ], "parameters": [ { "name": "account_id", "in": "path", "required": true, "schema": { "type": "string", "format": "uuid" } }, { "name": "command_id", "in": "path", "required": true, "schema": { "type": "string", "format": "uuid" } } ], "description": "Authorization and validation are enforced by the owning service.\n\nHEAD uses the GET handler and headers without a response body.", "x-handler": "command_receipt", "x-source-file": "crates/synckhub-server/src/routes/mail/native_sender_policy.rs", "x-source-line": 29, "x-implicit-head": true, "responses": { "default": { "description": "Service response. Error status and envelope depend on the operation." } } } }, "/v1/integrations/mailcal/accounts/{account_id}/mail/quarantine": { "get": { "operationId": "platform_get__v1_integrations_mailcal_accounts__account_id__mail_quarantine", "summary": "list", "tags": [ "mail · native_quarantine" ], "parameters": [ { "name": "account_id", "in": "path", "required": true, "schema": { "type": "string" } }, { "name": "cursor", "in": "query", "required": false, "schema": { "anyOf": [ { "type": "string", "format": "uuid" }, { "type": "null" } ] } }, { "name": "limit", "in": "query", "required": false, "schema": { "type": "integer", "minimum": 0 } } ], "description": "Authorization and validation are enforced by the owning service.", "x-handler": "list", "x-source-file": "crates/synckhub-server/src/routes/mail/native_quarantine.rs", "x-source-line": 22, "responses": { "default": { "description": "Service response. Error status and envelope depend on the operation." } } }, "head": { "operationId": "platform_head__v1_integrations_mailcal_accounts__account_id__mail_quarantine", "summary": "list", "tags": [ "mail · native_quarantine" ], "parameters": [ { "name": "account_id", "in": "path", "required": true, "schema": { "type": "string" } }, { "name": "cursor", "in": "query", "required": false, "schema": { "anyOf": [ { "type": "string", "format": "uuid" }, { "type": "null" } ] } }, { "name": "limit", "in": "query", "required": false, "schema": { "type": "integer", "minimum": 0 } } ], "description": "Authorization and validation are enforced by the owning service.\n\nHEAD uses the GET handler and headers without a response body.", "x-handler": "list", "x-source-file": "crates/synckhub-server/src/routes/mail/native_quarantine.rs", "x-source-line": 22, "x-implicit-head": true, "responses": { "default": { "description": "Service response. Error status and envelope depend on the operation." } } } }, "/v1/integrations/mailcal/accounts/{account_id}/mail/quarantine/{quarantine_id}": { "get": { "operationId": "platform_get__v1_integrations_mailcal_accounts__account_id__mail_quarantine__quarantine_id_", "summary": "detail", "tags": [ "mail · native_quarantine" ], "parameters": [ { "name": "account_id", "in": "path", "required": true, "schema": { "type": "string" } }, { "name": "quarantine_id", "in": "path", "required": true, "schema": { "type": "string", "format": "uuid" } } ], "description": "Authorization and validation are enforced by the owning service.", "x-handler": "detail", "x-source-file": "crates/synckhub-server/src/routes/mail/native_quarantine.rs", "x-source-line": 22, "responses": { "default": { "description": "Service response. Error status and envelope depend on the operation." } } }, "head": { "operationId": "platform_head__v1_integrations_mailcal_accounts__account_id__mail_quarantine__quarantine_id_", "summary": "detail", "tags": [ "mail · native_quarantine" ], "parameters": [ { "name": "account_id", "in": "path", "required": true, "schema": { "type": "string" } }, { "name": "quarantine_id", "in": "path", "required": true, "schema": { "type": "string", "format": "uuid" } } ], "description": "Authorization and validation are enforced by the owning service.\n\nHEAD uses the GET handler and headers without a response body.", "x-handler": "detail", "x-source-file": "crates/synckhub-server/src/routes/mail/native_quarantine.rs", "x-source-line": 22, "x-implicit-head": true, "responses": { "default": { "description": "Service response. Error status and envelope depend on the operation." } } } }, "/v1/integrations/mailcal/accounts/{account_id}/mail/quarantine/{quarantine_id}/delete": { "post": { "operationId": "platform_post__v1_integrations_mailcal_accounts__account_id__mail_quarantine__quarantine_id__delete", "summary": "delete", "tags": [ "mail · native_quarantine" ], "parameters": [ { "name": "account_id", "in": "path", "required": true, "schema": { "type": "string" } }, { "name": "quarantine_id", "in": "path", "required": true, "schema": { "type": "string", "format": "uuid" } } ], "description": "Authorization and validation are enforced by the owning service.", "x-handler": "delete", "x-source-file": "crates/synckhub-server/src/routes/mail/native_quarantine.rs", "x-source-line": 22, "responses": { "default": { "description": "Service response. Error status and envelope depend on the operation." } }, "requestBody": { "required": true, "content": { "application/json": { "schema": { "$ref": "#/components/schemas/synckhub_server.routes.mail.native_quarantine.CommandRequest" } } } } } }, "/v1/integrations/mailcal/accounts/{account_id}/mail/quarantine/{quarantine_id}/release": { "post": { "operationId": "platform_post__v1_integrations_mailcal_accounts__account_id__mail_quarantine__quarantine_id__release", "summary": "release", "tags": [ "mail · native_quarantine" ], "parameters": [ { "name": "account_id", "in": "path", "required": true, "schema": { "type": "string" } }, { "name": "quarantine_id", "in": "path", "required": true, "schema": { "type": "string", "format": "uuid" } } ], "description": "Authorization and validation are enforced by the owning service.", "x-handler": "release", "x-source-file": "crates/synckhub-server/src/routes/mail/native_quarantine.rs", "x-source-line": 22, "responses": { "default": { "description": "Service response. Error status and envelope depend on the operation." } }, "requestBody": { "required": true, "content": { "application/json": { "schema": { "$ref": "#/components/schemas/synckhub_server.routes.mail.native_quarantine.CommandRequest" } } } } } }, "/v1/integrations/mailcal/accounts/{account_id}/mail/quarantine/releases/{command_id}": { "get": { "operationId": "platform_get__v1_integrations_mailcal_accounts__account_id__mail_quarantine_releases__command_id_", "summary": "release status", "tags": [ "mail · native_quarantine" ], "parameters": [ { "name": "account_id", "in": "path", "required": true, "schema": { "type": "string" } }, { "name": "command_id", "in": "path", "required": true, "schema": { "type": "string", "format": "uuid" } } ], "description": "Authorization and validation are enforced by the owning service.", "x-handler": "release_status", "x-source-file": "crates/synckhub-server/src/routes/mail/native_quarantine.rs", "x-source-line": 22, "responses": { "default": { "description": "Service response. Error status and envelope depend on the operation." } } }, "head": { "operationId": "platform_head__v1_integrations_mailcal_accounts__account_id__mail_quarantine_releases__command_id_", "summary": "release status", "tags": [ "mail · native_quarantine" ], "parameters": [ { "name": "account_id", "in": "path", "required": true, "schema": { "type": "string" } }, { "name": "command_id", "in": "path", "required": true, "schema": { "type": "string", "format": "uuid" } } ], "description": "Authorization and validation are enforced by the owning service.\n\nHEAD uses the GET handler and headers without a response body.", "x-handler": "release_status", "x-source-file": "crates/synckhub-server/src/routes/mail/native_quarantine.rs", "x-source-line": 22, "x-implicit-head": true, "responses": { "default": { "description": "Service response. Error status and envelope depend on the operation." } } } }, "/v1/integrations/mailcal/accounts/{account_id}/mail/quarantine/summary": { "get": { "operationId": "platform_get__v1_integrations_mailcal_accounts__account_id__mail_quarantine_summary", "summary": "summary", "tags": [ "mail · native_quarantine" ], "parameters": [ { "name": "account_id", "in": "path", "required": true, "schema": { "type": "string" } } ], "description": "Authorization and validation are enforced by the owning service.", "x-handler": "summary", "x-source-file": "crates/synckhub-server/src/routes/mail/native_quarantine.rs", "x-source-line": 22, "responses": { "default": { "description": "Service response. Error status and envelope depend on the operation." } } }, "head": { "operationId": "platform_head__v1_integrations_mailcal_accounts__account_id__mail_quarantine_summary", "summary": "summary", "tags": [ "mail · native_quarantine" ], "parameters": [ { "name": "account_id", "in": "path", "required": true, "schema": { "type": "string" } } ], "description": "Authorization and validation are enforced by the owning service.\n\nHEAD uses the GET handler and headers without a response body.", "x-handler": "summary", "x-source-file": "crates/synckhub-server/src/routes/mail/native_quarantine.rs", "x-source-line": 22, "x-implicit-head": true, "responses": { "default": { "description": "Service response. Error status and envelope depend on the operation." } } } }, "/v1/integrations/mailcal/accounts/{account_id}/mail/send-jobs/{job_id}": { "get": { "operationId": "platform_get__v1_integrations_mailcal_accounts__account_id__mail_send_jobs__job_id_", "summary": "get send job", "tags": [ "mail · drafts" ], "parameters": [ { "name": "account_id", "in": "path", "required": true, "schema": { "type": "string" } }, { "name": "job_id", "in": "path", "required": true, "schema": { "type": "string" } } ], "description": "Authorization and validation are enforced by the owning service.", "x-handler": "get_send_job", "x-source-file": "crates/synckhub-server/src/routes/mail/drafts.rs", "x-source-line": 39, "responses": { "default": { "description": "Service response. Error status and envelope depend on the operation." }, "2XX": { "description": "Successful JSON response", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/synckhub_server.routes.mail.drafts.SendDraftRouteResponse" } } } } } }, "head": { "operationId": "platform_head__v1_integrations_mailcal_accounts__account_id__mail_send_jobs__job_id_", "summary": "get send job", "tags": [ "mail · drafts" ], "parameters": [ { "name": "account_id", "in": "path", "required": true, "schema": { "type": "string" } }, { "name": "job_id", "in": "path", "required": true, "schema": { "type": "string" } } ], "description": "Authorization and validation are enforced by the owning service.\n\nHEAD uses the GET handler and headers without a response body.", "x-handler": "get_send_job", "x-source-file": "crates/synckhub-server/src/routes/mail/drafts.rs", "x-source-line": 39, "x-implicit-head": true, "responses": { "default": { "description": "Service response. Error status and envelope depend on the operation." } } } }, "/v1/integrations/mailcal/accounts/{account_id}/mail/send-jobs/{job_id}/cancel": { "post": { "operationId": "platform_post__v1_integrations_mailcal_accounts__account_id__mail_send_jobs__job_id__cancel", "summary": "cancel send job", "tags": [ "mail · drafts" ], "parameters": [ { "name": "account_id", "in": "path", "required": true, "schema": { "type": "string" } }, { "name": "job_id", "in": "path", "required": true, "schema": { "type": "string" } } ], "description": "Authorization and validation are enforced by the owning service.", "x-handler": "cancel_send_job", "x-source-file": "crates/synckhub-server/src/routes/mail/drafts.rs", "x-source-line": 39, "responses": { "default": { "description": "Service response. Error status and envelope depend on the operation." }, "2XX": { "description": "Successful JSON response", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/synckhub_server.routes.mail.drafts.SendDraftRouteResponse" } } } } } } }, "/v1/integrations/mailcal/accounts/{account_id}/mail/status": { "get": { "operationId": "platform_get__v1_integrations_mailcal_accounts__account_id__mail_status", "summary": "owner", "tags": [ "mail · native_status" ], "parameters": [ { "name": "account_id", "in": "path", "required": true, "schema": { "type": "string", "format": "uuid" } }, { "name": "before", "in": "query", "required": false, "schema": { "anyOf": [ { "type": "string", "format": "uuid" }, { "type": "null" } ] } }, { "name": "limit", "in": "query", "required": false, "schema": { "anyOf": [ { "type": "integer", "minimum": 0 }, { "type": "null" } ] } } ], "description": "Authorization and validation are enforced by the owning service.", "x-handler": "owner", "x-source-file": "crates/synckhub-server/src/routes/mail/native_status.rs", "x-source-line": 28, "responses": { "default": { "description": "Service response. Error status and envelope depend on the operation." } } }, "head": { "operationId": "platform_head__v1_integrations_mailcal_accounts__account_id__mail_status", "summary": "owner", "tags": [ "mail · native_status" ], "parameters": [ { "name": "account_id", "in": "path", "required": true, "schema": { "type": "string", "format": "uuid" } }, { "name": "before", "in": "query", "required": false, "schema": { "anyOf": [ { "type": "string", "format": "uuid" }, { "type": "null" } ] } }, { "name": "limit", "in": "query", "required": false, "schema": { "anyOf": [ { "type": "integer", "minimum": 0 }, { "type": "null" } ] } } ], "description": "Authorization and validation are enforced by the owning service.\n\nHEAD uses the GET handler and headers without a response body.", "x-handler": "owner", "x-source-file": "crates/synckhub-server/src/routes/mail/native_status.rs", "x-source-line": 28, "x-implicit-head": true, "responses": { "default": { "description": "Service response. Error status and envelope depend on the operation." } } } }, "/v1/integrations/mailcal/accounts/{account_id}/mail/submissions": { "post": { "operationId": "platform_post__v1_integrations_mailcal_accounts__account_id__mail_submissions", "summary": "send", "tags": [ "mail · native_compose" ], "parameters": [ { "name": "account_id", "in": "path", "required": true, "schema": { "type": "string", "format": "uuid" } } ], "description": "Authorization and validation are enforced by the owning service.", "x-handler": "send", "x-source-file": "crates/synckhub-server/src/routes/mail/native_compose.rs", "x-source-line": 63, "responses": { "default": { "description": "Service response. Error status and envelope depend on the operation." }, "2XX": { "description": "Successful JSON response", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/synckhub_server.native_mail.drafts.Submission" } } } } }, "requestBody": { "required": true, "content": { "application/json": { "schema": { "$ref": "#/components/schemas/synckhub_server.routes.mail.native_compose.Send" } } } } } }, "/v1/integrations/mailcal/accounts/{account_id}/mail/submissions/{command_id}": { "get": { "operationId": "platform_get__v1_integrations_mailcal_accounts__account_id__mail_submissions__command_id_", "summary": "status", "tags": [ "mail · native_compose" ], "parameters": [ { "name": "account_id", "in": "path", "required": true, "schema": { "type": "string", "format": "uuid" } }, { "name": "command_id", "in": "path", "required": true, "schema": { "type": "string", "format": "uuid" } } ], "description": "Authorization and validation are enforced by the owning service.", "x-handler": "status", "x-source-file": "crates/synckhub-server/src/routes/mail/native_compose.rs", "x-source-line": 63, "responses": { "default": { "description": "Service response. Error status and envelope depend on the operation." }, "2XX": { "description": "Successful JSON response", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/synckhub_server.native_mail.drafts.Submission" } } } } } }, "head": { "operationId": "platform_head__v1_integrations_mailcal_accounts__account_id__mail_submissions__command_id_", "summary": "status", "tags": [ "mail · native_compose" ], "parameters": [ { "name": "account_id", "in": "path", "required": true, "schema": { "type": "string", "format": "uuid" } }, { "name": "command_id", "in": "path", "required": true, "schema": { "type": "string", "format": "uuid" } } ], "description": "Authorization and validation are enforced by the owning service.\n\nHEAD uses the GET handler and headers without a response body.", "x-handler": "status", "x-source-file": "crates/synckhub-server/src/routes/mail/native_compose.rs", "x-source-line": 63, "x-implicit-head": true, "responses": { "default": { "description": "Service response. Error status and envelope depend on the operation." } } } }, "/v1/integrations/mailcal/accounts/{account_id}/mail/submissions/{command_id}/cancel": { "post": { "operationId": "platform_post__v1_integrations_mailcal_accounts__account_id__mail_submissions__command_id__cancel", "summary": "cancel", "tags": [ "mail · native_compose" ], "parameters": [ { "name": "account_id", "in": "path", "required": true, "schema": { "type": "string", "format": "uuid" } }, { "name": "command_id", "in": "path", "required": true, "schema": { "type": "string", "format": "uuid" } } ], "description": "Authorization and validation are enforced by the owning service.", "x-handler": "cancel", "x-source-file": "crates/synckhub-server/src/routes/mail/native_compose.rs", "x-source-line": 63, "responses": { "default": { "description": "Service response. Error status and envelope depend on the operation." }, "2XX": { "description": "Successful JSON response", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/synckhub_server.native_mail.drafts.Submission" } } } } } } }, "/v1/integrations/mailcal/accounts/{account_id}/mail/submissions/{command_id}/raw-rfc822": { "delete": { "operationId": "platform_delete__v1_integrations_mailcal_accounts__account_id__mail_submissions__command_id__raw_rfc822", "summary": "delete raw", "tags": [ "mail · native_compose" ], "parameters": [ { "name": "account_id", "in": "path", "required": true, "schema": { "type": "string", "format": "uuid" } }, { "name": "command_id", "in": "path", "required": true, "schema": { "type": "string", "format": "uuid" } } ], "description": "Authorization and validation are enforced by the owning service.", "x-handler": "delete_raw", "x-source-file": "crates/synckhub-server/src/routes/mail/native_compose.rs", "x-source-line": 63, "responses": { "default": { "description": "Service response. Error status and envelope depend on the operation." } } }, "get": { "operationId": "platform_get__v1_integrations_mailcal_accounts__account_id__mail_submissions__command_id__raw_rfc822", "summary": "raw", "tags": [ "mail · native_compose" ], "parameters": [ { "name": "account_id", "in": "path", "required": true, "schema": { "type": "string", "format": "uuid" } }, { "name": "command_id", "in": "path", "required": true, "schema": { "type": "string", "format": "uuid" } } ], "description": "Authorization and validation are enforced by the owning service.", "x-handler": "raw", "x-source-file": "crates/synckhub-server/src/routes/mail/native_compose.rs", "x-source-line": 63, "responses": { "default": { "description": "Service response. Error status and envelope depend on the operation." } } }, "head": { "operationId": "platform_head__v1_integrations_mailcal_accounts__account_id__mail_submissions__command_id__raw_rfc822", "summary": "raw", "tags": [ "mail · native_compose" ], "parameters": [ { "name": "account_id", "in": "path", "required": true, "schema": { "type": "string", "format": "uuid" } }, { "name": "command_id", "in": "path", "required": true, "schema": { "type": "string", "format": "uuid" } } ], "description": "Authorization and validation are enforced by the owning service.\n\nHEAD uses the GET handler and headers without a response body.", "x-handler": "raw", "x-source-file": "crates/synckhub-server/src/routes/mail/native_compose.rs", "x-source-line": 63, "x-implicit-head": true, "responses": { "default": { "description": "Service response. Error status and envelope depend on the operation." } } } }, "/v1/integrations/mailcal/accounts/{account_id}/mail/submissions/{command_id}/transport-status": { "get": { "operationId": "platform_get__v1_integrations_mailcal_accounts__account_id__mail_submissions__command_id__transport_status", "summary": "transport owner", "tags": [ "mail · native_status" ], "parameters": [ { "name": "account_id", "in": "path", "required": true, "schema": { "type": "string", "format": "uuid" } }, { "name": "command_id", "in": "path", "required": true, "schema": { "type": "string", "format": "uuid" } } ], "description": "Authorization and validation are enforced by the owning service.", "x-handler": "transport_owner", "x-source-file": "crates/synckhub-server/src/routes/mail/native_status.rs", "x-source-line": 28, "responses": { "default": { "description": "Service response. Error status and envelope depend on the operation." } } }, "head": { "operationId": "platform_head__v1_integrations_mailcal_accounts__account_id__mail_submissions__command_id__transport_status", "summary": "transport owner", "tags": [ "mail · native_status" ], "parameters": [ { "name": "account_id", "in": "path", "required": true, "schema": { "type": "string", "format": "uuid" } }, { "name": "command_id", "in": "path", "required": true, "schema": { "type": "string", "format": "uuid" } } ], "description": "Authorization and validation are enforced by the owning service.\n\nHEAD uses the GET handler and headers without a response body.", "x-handler": "transport_owner", "x-source-file": "crates/synckhub-server/src/routes/mail/native_status.rs", "x-source-line": 28, "x-implicit-head": true, "responses": { "default": { "description": "Service response. Error status and envelope depend on the operation." } } } }, "/v1/integrations/mailcal/accounts/{account_id}/mail/sync": { "post": { "operationId": "platform_post__v1_integrations_mailcal_accounts__account_id__mail_sync", "summary": "sync mailbox", "tags": [ "mail · sync" ], "parameters": [ { "name": "account_id", "in": "path", "required": true, "schema": { "type": "string" } } ], "description": "Authorization and validation are enforced by the owning service.", "x-handler": "sync_mailbox", "x-source-file": "crates/synckhub-server/src/routes/mail/sync.rs", "x-source-line": 34, "responses": { "default": { "description": "Service response. Error status and envelope depend on the operation." }, "2XX": { "description": "Successful JSON response", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/synckhub_server.routes.mail.sync.SyncMailboxResponse" } } } } }, "requestBody": { "required": true, "content": { "application/json": { "schema": { "$ref": "#/components/schemas/synckhub_server.routes.mail.sync.SyncMailboxRequest" } } } } } }, "/v1/integrations/mailcal/accounts/{account_id}/mail/threads/{thread_id}": { "get": { "operationId": "platform_get__v1_integrations_mailcal_accounts__account_id__mail_threads__thread_id_", "summary": "get thread", "tags": [ "mail · messages" ], "parameters": [ { "name": "account_id", "in": "path", "required": true, "schema": { "type": "string" } }, { "name": "thread_id", "in": "path", "required": true, "schema": { "type": "string" } }, { "name": "view", "in": "query", "required": false, "schema": { "anyOf": [ { "type": "string" }, { "type": "null" } ] } }, { "name": "limit", "in": "query", "required": false, "schema": { "anyOf": [ { "type": "integer", "minimum": 0 }, { "type": "null" } ] } }, { "name": "page_token", "in": "query", "required": false, "schema": { "anyOf": [ { "type": "string" }, { "type": "null" } ] } } ], "description": "Authorization and validation are enforced by the owning service.", "x-handler": "get_thread", "x-source-file": "crates/synckhub-server/src/routes/mail/messages.rs", "x-source-line": 63, "responses": { "default": { "description": "Service response. Error status and envelope depend on the operation." }, "2XX": { "description": "Successful JSON response", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/synckhub_mailcal.types.ThreadView" } } } } } }, "head": { "operationId": "platform_head__v1_integrations_mailcal_accounts__account_id__mail_threads__thread_id_", "summary": "get thread", "tags": [ "mail · messages" ], "parameters": [ { "name": "account_id", "in": "path", "required": true, "schema": { "type": "string" } }, { "name": "thread_id", "in": "path", "required": true, "schema": { "type": "string" } }, { "name": "view", "in": "query", "required": false, "schema": { "anyOf": [ { "type": "string" }, { "type": "null" } ] } }, { "name": "limit", "in": "query", "required": false, "schema": { "anyOf": [ { "type": "integer", "minimum": 0 }, { "type": "null" } ] } }, { "name": "page_token", "in": "query", "required": false, "schema": { "anyOf": [ { "type": "string" }, { "type": "null" } ] } } ], "description": "Authorization and validation are enforced by the owning service.\n\nHEAD uses the GET handler and headers without a response body.", "x-handler": "get_thread", "x-source-file": "crates/synckhub-server/src/routes/mail/messages.rs", "x-source-line": 63, "x-implicit-head": true, "responses": { "default": { "description": "Service response. Error status and envelope depend on the operation." } } } }, "/v1/integrations/mailcal/accounts/{account_id}/mail/unsubscribe-commands/{command_id}": { "get": { "operationId": "platform_get__v1_integrations_mailcal_accounts__account_id__mail_unsubscribe_commands__command_id_", "summary": "command receipt", "tags": [ "mail · native_unsubscribe" ], "parameters": [ { "name": "account_id", "in": "path", "required": true, "schema": { "type": "string", "format": "uuid" } }, { "name": "command_id", "in": "path", "required": true, "schema": { "type": "string", "format": "uuid" } } ], "description": "Authorization and validation are enforced by the owning service.", "x-handler": "command_receipt", "x-source-file": "crates/synckhub-server/src/routes/mail/native_unsubscribe.rs", "x-source-line": 28, "responses": { "default": { "description": "Service response. Error status and envelope depend on the operation." }, "2XX": { "description": "Successful JSON response", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/synckhub_server.native_mail.unsubscribe.UnsubscribeReceipt" } } } } } }, "head": { "operationId": "platform_head__v1_integrations_mailcal_accounts__account_id__mail_unsubscribe_commands__command_id_", "summary": "command receipt", "tags": [ "mail · native_unsubscribe" ], "parameters": [ { "name": "account_id", "in": "path", "required": true, "schema": { "type": "string", "format": "uuid" } }, { "name": "command_id", "in": "path", "required": true, "schema": { "type": "string", "format": "uuid" } } ], "description": "Authorization and validation are enforced by the owning service.\n\nHEAD uses the GET handler and headers without a response body.", "x-handler": "command_receipt", "x-source-file": "crates/synckhub-server/src/routes/mail/native_unsubscribe.rs", "x-source-line": 28, "x-implicit-head": true, "responses": { "default": { "description": "Service response. Error status and envelope depend on the operation." } } } }, "/v1/integrations/mailcal/accounts/{account_id}/mail/vcs-reclassifications": { "post": { "operationId": "platform_post__v1_integrations_mailcal_accounts__account_id__mail_vcs_reclassifications", "summary": "enqueue vcs reclassification", "tags": [ "mail · native_filing" ], "parameters": [ { "name": "account_id", "in": "path", "required": true, "schema": { "type": "string" } } ], "description": "Authorization and validation are enforced by the owning service.", "x-handler": "enqueue_vcs_reclassification", "x-source-file": "crates/synckhub-server/src/routes/mail/native_filing.rs", "x-source-line": 50, "responses": { "default": { "description": "Service response. Error status and envelope depend on the operation." }, "2XX": { "description": "Successful JSON response", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/synckhub_server.native_mail.vcs_reclassification.VcsReclassification" } } } } }, "requestBody": { "required": true, "content": { "application/json": { "schema": { "$ref": "#/components/schemas/synckhub_server.routes.mail.native_filing.VcsReclassificationRequest" } } } } } }, "/v1/integrations/mailcal/accounts/{account_id}/mail/vcs-reclassifications/{command_id}": { "get": { "operationId": "platform_get__v1_integrations_mailcal_accounts__account_id__mail_vcs_reclassifications__command_id_", "summary": "read vcs reclassification", "tags": [ "mail · native_filing" ], "parameters": [ { "name": "account_id", "in": "path", "required": true, "schema": { "type": "string" } }, { "name": "command_id", "in": "path", "required": true, "schema": { "type": "string", "format": "uuid" } } ], "description": "Authorization and validation are enforced by the owning service.", "x-handler": "read_vcs_reclassification", "x-source-file": "crates/synckhub-server/src/routes/mail/native_filing.rs", "x-source-line": 50, "responses": { "default": { "description": "Service response. Error status and envelope depend on the operation." }, "2XX": { "description": "Successful JSON response", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/synckhub_server.native_mail.vcs_reclassification.VcsReclassification" } } } } } }, "head": { "operationId": "platform_head__v1_integrations_mailcal_accounts__account_id__mail_vcs_reclassifications__command_id_", "summary": "read vcs reclassification", "tags": [ "mail · native_filing" ], "parameters": [ { "name": "account_id", "in": "path", "required": true, "schema": { "type": "string" } }, { "name": "command_id", "in": "path", "required": true, "schema": { "type": "string", "format": "uuid" } } ], "description": "Authorization and validation are enforced by the owning service.\n\nHEAD uses the GET handler and headers without a response body.", "x-handler": "read_vcs_reclassification", "x-source-file": "crates/synckhub-server/src/routes/mail/native_filing.rs", "x-source-line": 50, "x-implicit-head": true, "responses": { "default": { "description": "Service response. Error status and envelope depend on the operation." } } } }, "/v1/integrations/mailcal/accounts/{account_id}/online-meetings": { "post": { "operationId": "platform_post__v1_integrations_mailcal_accounts__account_id__online_meetings", "summary": "create or get online meeting", "tags": [ "calendar · scheduling" ], "parameters": [ { "name": "account_id", "in": "path", "required": true, "schema": { "type": "string" } } ], "description": "Authorization and validation are enforced by the owning service.", "x-handler": "create_or_get_online_meeting", "x-source-file": "crates/synckhub-server/src/routes/calendar/scheduling.rs", "x-source-line": 25, "responses": { "default": { "description": "Service response. Error status and envelope depend on the operation." }, "2XX": { "description": "Successful JSON response", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/synckhub_mailcal.types.OnlineMeeting" } } } } }, "requestBody": { "required": true, "content": { "application/json": { "schema": { "$ref": "#/components/schemas/synckhub_server.routes.calendar.scheduling.CreateOnlineMeetingRequest" } } } } } }, "/v1/integrations/mailcal/accounts/{account_id}/people": { "get": { "operationId": "platform_get__v1_integrations_mailcal_accounts__account_id__people", "summary": "list provider people", "tags": [ "connected_accounts · provider_people" ], "parameters": [ { "name": "account_id", "in": "path", "required": true, "schema": { "type": "string" } }, { "name": "source", "in": "query", "required": true, "schema": { "$ref": "#/components/schemas/synckhub_mailcal.types.ProviderPeopleSource" } }, { "name": "q", "in": "query", "required": false, "schema": { "anyOf": [ { "type": "string" }, { "type": "null" } ] } }, { "name": "page_size", "in": "query", "required": false, "schema": { "anyOf": [ { "type": "integer", "minimum": 0 }, { "type": "null" } ] } }, { "name": "page_token", "in": "query", "required": false, "schema": { "anyOf": [ { "type": "string" }, { "type": "null" } ] } } ], "description": "Authorization and validation are enforced by the owning service.", "x-handler": "list_provider_people", "x-source-file": "crates/synckhub-server/src/routes/connected_accounts/provider_people.rs", "x-source-line": 916, "responses": { "default": { "description": "Service response. Error status and envelope depend on the operation." }, "2XX": { "description": "Successful JSON response", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/synckhub_server.routes.connected_accounts.provider_people.ListProviderPeopleResponse" } } } } } }, "head": { "operationId": "platform_head__v1_integrations_mailcal_accounts__account_id__people", "summary": "list provider people", "tags": [ "connected_accounts · provider_people" ], "parameters": [ { "name": "account_id", "in": "path", "required": true, "schema": { "type": "string" } }, { "name": "source", "in": "query", "required": true, "schema": { "$ref": "#/components/schemas/synckhub_mailcal.types.ProviderPeopleSource" } }, { "name": "q", "in": "query", "required": false, "schema": { "anyOf": [ { "type": "string" }, { "type": "null" } ] } }, { "name": "page_size", "in": "query", "required": false, "schema": { "anyOf": [ { "type": "integer", "minimum": 0 }, { "type": "null" } ] } }, { "name": "page_token", "in": "query", "required": false, "schema": { "anyOf": [ { "type": "string" }, { "type": "null" } ] } } ], "description": "Authorization and validation are enforced by the owning service.\n\nHEAD uses the GET handler and headers without a response body.", "x-handler": "list_provider_people", "x-source-file": "crates/synckhub-server/src/routes/connected_accounts/provider_people.rs", "x-source-line": 916, "x-implicit-head": true, "responses": { "default": { "description": "Service response. Error status and envelope depend on the operation." } } } }, "/v1/integrations/mailcal/accounts/order": { "put": { "operationId": "platform_put__v1_integrations_mailcal_accounts_order", "summary": "update account order", "tags": [ "connected_accounts · accounts" ], "parameters": [], "description": "Authorization and validation are enforced by the owning service.", "x-handler": "update_account_order", "x-source-file": "crates/synckhub-server/src/routes/connected_accounts/accounts.rs", "x-source-line": 51, "responses": { "default": { "description": "Service response. Error status and envelope depend on the operation." }, "2XX": { "description": "Successful JSON response", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/synckhub_server.routes.connected_accounts.accounts.AccountsResponse" } } } } }, "requestBody": { "required": true, "content": { "application/json": { "schema": { "$ref": "#/components/schemas/synckhub_server.routes.connected_accounts.accounts.AccountOrderRequest" } } } } } }, "/v1/integrations/mailcal/mail/sync": { "post": { "operationId": "platform_post__v1_integrations_mailcal_mail_sync", "summary": "sync unified mail", "tags": [ "mail · sync" ], "parameters": [], "description": "Authorization and validation are enforced by the owning service.", "x-handler": "sync_unified_mail", "x-source-file": "crates/synckhub-server/src/routes/mail/sync.rs", "x-source-line": 34, "responses": { "default": { "description": "Service response. Error status and envelope depend on the operation." }, "2XX": { "description": "Successful JSON response", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/synckhub_server.routes.mail.sync.SyncUnifiedMailResponse" } } } } }, "requestBody": { "required": true, "content": { "application/json": { "schema": { "$ref": "#/components/schemas/synckhub_server.routes.mail.sync.SyncUnifiedMailRequest" } } } } } }, "/v1/integrations/mailcal/mail/unified-inbox": { "get": { "operationId": "platform_get__v1_integrations_mailcal_mail_unified_inbox", "summary": "list unified inbox", "tags": [ "mail · messages" ], "parameters": [ { "name": "account_id", "in": "query", "required": false, "schema": { "type": "array", "items": { "type": "string" } }, "style": "form", "explode": true }, { "name": "q", "in": "query", "required": false, "schema": { "anyOf": [ { "type": "string" }, { "type": "null" } ] } }, { "name": "search_text", "in": "query", "required": false, "schema": { "anyOf": [ { "type": "string" }, { "type": "null" } ] } }, { "name": "search_field", "in": "query", "required": false, "schema": { "anyOf": [ { "type": "string" }, { "type": "null" } ] } }, { "name": "search_from", "in": "query", "required": false, "schema": { "anyOf": [ { "type": "string" }, { "type": "null" } ] } }, { "name": "search_to", "in": "query", "required": false, "schema": { "anyOf": [ { "type": "string" }, { "type": "null" } ] } }, { "name": "search_participant", "in": "query", "required": false, "schema": { "anyOf": [ { "type": "string" }, { "type": "null" } ] } }, { "name": "has_attachments", "in": "query", "required": false, "schema": { "anyOf": [ { "type": "string" }, { "type": "null" } ] } }, { "name": "page_size", "in": "query", "required": false, "schema": { "anyOf": [ { "type": "integer", "minimum": 0 }, { "type": "null" } ] } }, { "name": "page_token", "in": "query", "required": false, "schema": { "anyOf": [ { "type": "string" }, { "type": "null" } ] } } ], "description": "Authorization and validation are enforced by the owning service.", "x-handler": "list_unified_inbox", "x-source-file": "crates/synckhub-server/src/routes/mail/messages.rs", "x-source-line": 63, "responses": { "default": { "description": "Service response. Error status and envelope depend on the operation." } } }, "head": { "operationId": "platform_head__v1_integrations_mailcal_mail_unified_inbox", "summary": "list unified inbox", "tags": [ "mail · messages" ], "parameters": [ { "name": "account_id", "in": "query", "required": false, "schema": { "type": "array", "items": { "type": "string" } }, "style": "form", "explode": true }, { "name": "q", "in": "query", "required": false, "schema": { "anyOf": [ { "type": "string" }, { "type": "null" } ] } }, { "name": "search_text", "in": "query", "required": false, "schema": { "anyOf": [ { "type": "string" }, { "type": "null" } ] } }, { "name": "search_field", "in": "query", "required": false, "schema": { "anyOf": [ { "type": "string" }, { "type": "null" } ] } }, { "name": "search_from", "in": "query", "required": false, "schema": { "anyOf": [ { "type": "string" }, { "type": "null" } ] } }, { "name": "search_to", "in": "query", "required": false, "schema": { "anyOf": [ { "type": "string" }, { "type": "null" } ] } }, { "name": "search_participant", "in": "query", "required": false, "schema": { "anyOf": [ { "type": "string" }, { "type": "null" } ] } }, { "name": "has_attachments", "in": "query", "required": false, "schema": { "anyOf": [ { "type": "string" }, { "type": "null" } ] } }, { "name": "page_size", "in": "query", "required": false, "schema": { "anyOf": [ { "type": "integer", "minimum": 0 }, { "type": "null" } ] } }, { "name": "page_token", "in": "query", "required": false, "schema": { "anyOf": [ { "type": "string" }, { "type": "null" } ] } } ], "description": "Authorization and validation are enforced by the owning service.\n\nHEAD uses the GET handler and headers without a response body.", "x-handler": "list_unified_inbox", "x-source-file": "crates/synckhub-server/src/routes/mail/messages.rs", "x-source-line": 63, "x-implicit-head": true, "responses": { "default": { "description": "Service response. Error status and envelope depend on the operation." } } } }, "/v1/integrations/mailcal/native-mail/template-commands": { "post": { "operationId": "platform_post__v1_integrations_mailcal_native_mail_template_commands", "summary": "command", "tags": [ "mail · native_templates" ], "parameters": [], "description": "Authorization and validation are enforced by the owning service.", "x-handler": "command", "x-source-file": "crates/synckhub-server/src/routes/mail/native_templates.rs", "x-source-line": 262, "responses": { "default": { "description": "Service response. Error status and envelope depend on the operation." }, "2XX": { "description": "Successful JSON response", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/synckhub_server.routes.mail.native_templates.TemplateReceipt" } } } } }, "requestBody": { "required": true, "content": { "application/json": { "schema": { "$ref": "#/components/schemas/synckhub_server.routes.mail.native_templates.TemplateCommand" } } } } } }, "/v1/integrations/mailcal/native-mail/template-commands/{command_id}": { "get": { "operationId": "platform_get__v1_integrations_mailcal_native_mail_template_commands__command_id_", "summary": "receipt", "tags": [ "mail · native_templates" ], "parameters": [ { "name": "command_id", "in": "path", "required": true, "schema": { "type": "string", "format": "uuid" } } ], "description": "Authorization and validation are enforced by the owning service.", "x-handler": "receipt", "x-source-file": "crates/synckhub-server/src/routes/mail/native_templates.rs", "x-source-line": 262, "responses": { "default": { "description": "Service response. Error status and envelope depend on the operation." }, "2XX": { "description": "Successful JSON response", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/synckhub_server.routes.mail.native_templates.TemplateReceipt" } } } } } }, "head": { "operationId": "platform_head__v1_integrations_mailcal_native_mail_template_commands__command_id_", "summary": "receipt", "tags": [ "mail · native_templates" ], "parameters": [ { "name": "command_id", "in": "path", "required": true, "schema": { "type": "string", "format": "uuid" } } ], "description": "Authorization and validation are enforced by the owning service.\n\nHEAD uses the GET handler and headers without a response body.", "x-handler": "receipt", "x-source-file": "crates/synckhub-server/src/routes/mail/native_templates.rs", "x-source-line": 262, "x-implicit-head": true, "responses": { "default": { "description": "Service response. Error status and envelope depend on the operation." } } } }, "/v1/integrations/mailcal/native-mail/templates": { "get": { "operationId": "platform_get__v1_integrations_mailcal_native_mail_templates", "summary": "list", "tags": [ "mail · native_templates" ], "parameters": [], "description": "Authorization and validation are enforced by the owning service.", "x-handler": "list", "x-source-file": "crates/synckhub-server/src/routes/mail/native_templates.rs", "x-source-line": 262, "responses": { "default": { "description": "Service response. Error status and envelope depend on the operation." }, "2XX": { "description": "Successful JSON response", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/synckhub_server.routes.mail.native_templates.TemplateList" } } } } } }, "head": { "operationId": "platform_head__v1_integrations_mailcal_native_mail_templates", "summary": "list", "tags": [ "mail · native_templates" ], "parameters": [], "description": "Authorization and validation are enforced by the owning service.\n\nHEAD uses the GET handler and headers without a response body.", "x-handler": "list", "x-source-file": "crates/synckhub-server/src/routes/mail/native_templates.rs", "x-source-line": 262, "x-implicit-head": true, "responses": { "default": { "description": "Service response. Error status and envelope depend on the operation." } } } }, "/v1/integrations/mailcal/native-mail/templates/{template_id}": { "get": { "operationId": "platform_get__v1_integrations_mailcal_native_mail_templates__template_id_", "summary": "detail", "tags": [ "mail · native_templates" ], "parameters": [ { "name": "template_id", "in": "path", "required": true, "schema": { "type": "string", "format": "uuid" } } ], "description": "Authorization and validation are enforced by the owning service.", "x-handler": "detail", "x-source-file": "crates/synckhub-server/src/routes/mail/native_templates.rs", "x-source-line": 262, "responses": { "default": { "description": "Service response. Error status and envelope depend on the operation." }, "2XX": { "description": "Successful JSON response", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/synckhub_server.routes.mail.native_templates.NativeTemplate" } } } } } }, "head": { "operationId": "platform_head__v1_integrations_mailcal_native_mail_templates__template_id_", "summary": "detail", "tags": [ "mail · native_templates" ], "parameters": [ { "name": "template_id", "in": "path", "required": true, "schema": { "type": "string", "format": "uuid" } } ], "description": "Authorization and validation are enforced by the owning service.\n\nHEAD uses the GET handler and headers without a response body.", "x-handler": "detail", "x-source-file": "crates/synckhub-server/src/routes/mail/native_templates.rs", "x-source-line": 262, "x-implicit-head": true, "responses": { "default": { "description": "Service response. Error status and envelope depend on the operation." } } } }, "/v1/integrations/mailcal/oauth/{provider}/callback": { "get": { "operationId": "platform_get__v1_integrations_mailcal_oauth__provider__callback", "summary": "oauth callback", "tags": [ "connected_accounts · oauth" ], "parameters": [ { "name": "provider", "in": "path", "required": true, "schema": { "type": "string" } }, { "name": "code", "in": "query", "required": false, "schema": { "anyOf": [ { "type": "string" }, { "type": "null" } ] } }, { "name": "state", "in": "query", "required": false, "schema": { "anyOf": [ { "type": "string" }, { "type": "null" } ] } }, { "name": "error", "in": "query", "required": false, "schema": { "anyOf": [ { "type": "string" }, { "type": "null" } ] } }, { "name": "error_description", "in": "query", "required": false, "schema": { "anyOf": [ { "type": "string" }, { "type": "null" } ] } } ], "description": "Authorization and validation are enforced by the owning service.\n\nThis route does not require the normal user bearer session. Link/download tokens, OAuth state, or webhook verification are validated by its handler where applicable.", "x-handler": "oauth_callback", "x-source-file": "crates/synckhub-server/src/routes/connected_accounts/oauth.rs", "x-source-line": 77, "responses": { "default": { "description": "Service response. Error status and envelope depend on the operation." } }, "security": [] }, "head": { "operationId": "platform_head__v1_integrations_mailcal_oauth__provider__callback", "summary": "oauth callback", "tags": [ "connected_accounts · oauth" ], "parameters": [ { "name": "provider", "in": "path", "required": true, "schema": { "type": "string" } }, { "name": "code", "in": "query", "required": false, "schema": { "anyOf": [ { "type": "string" }, { "type": "null" } ] } }, { "name": "state", "in": "query", "required": false, "schema": { "anyOf": [ { "type": "string" }, { "type": "null" } ] } }, { "name": "error", "in": "query", "required": false, "schema": { "anyOf": [ { "type": "string" }, { "type": "null" } ] } }, { "name": "error_description", "in": "query", "required": false, "schema": { "anyOf": [ { "type": "string" }, { "type": "null" } ] } } ], "description": "Authorization and validation are enforced by the owning service.\n\nHEAD uses the GET handler and headers without a response body.", "x-handler": "oauth_callback", "x-source-file": "crates/synckhub-server/src/routes/connected_accounts/oauth.rs", "x-source-line": 77, "x-implicit-head": true, "responses": { "default": { "description": "Service response. Error status and envelope depend on the operation." } } } }, "/v1/integrations/mailcal/oauth/{provider}/exchange": { "post": { "operationId": "platform_post__v1_integrations_mailcal_oauth__provider__exchange", "summary": "oauth exchange", "tags": [ "connected_accounts · oauth" ], "parameters": [ { "name": "provider", "in": "path", "required": true, "schema": { "type": "string" } } ], "description": "Authorization and validation are enforced by the owning service.", "x-handler": "oauth_exchange", "x-source-file": "crates/synckhub-server/src/routes/connected_accounts/oauth.rs", "x-source-line": 77, "responses": { "default": { "description": "Service response. Error status and envelope depend on the operation." }, "2XX": { "description": "Successful JSON response", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/synckhub_server.routes.connected_accounts.oauth.OAuthExchangeResponse" } } } } }, "requestBody": { "required": true, "content": { "application/json": { "schema": { "$ref": "#/components/schemas/synckhub_server.routes.connected_accounts.oauth.OAuthExchangeRequest" } } } } } }, "/v1/integrations/mailcal/oauth/{provider}/start": { "post": { "operationId": "platform_post__v1_integrations_mailcal_oauth__provider__start", "summary": "oauth start", "tags": [ "connected_accounts · oauth" ], "parameters": [ { "name": "provider", "in": "path", "required": true, "schema": { "type": "string" } } ], "description": "Authorization and validation are enforced by the owning service.", "x-handler": "oauth_start", "x-source-file": "crates/synckhub-server/src/routes/connected_accounts/oauth.rs", "x-source-line": 77, "responses": { "default": { "description": "Service response. Error status and envelope depend on the operation." }, "2XX": { "description": "Successful JSON response", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/synckhub_server.routes.connected_accounts.oauth.OAuthStartResponse" } } } } }, "requestBody": { "required": true, "content": { "application/json": { "schema": { "$ref": "#/components/schemas/synckhub_server.routes.connected_accounts.oauth.OAuthStartRequest" } } } } } }, "/v1/integrations/mailcal/people/suggestions": { "get": { "operationId": "platform_get__v1_integrations_mailcal_people_suggestions", "summary": "list people suggestions", "tags": [ "connected_accounts · provider_people" ], "parameters": [ { "name": "q", "in": "query", "required": true, "schema": { "type": "string" } }, { "name": "repo_id", "in": "query", "required": false, "schema": { "anyOf": [ { "type": "string" }, { "type": "null" } ] } }, { "name": "active_account_id", "in": "query", "required": false, "schema": { "anyOf": [ { "type": "string" }, { "type": "null" } ] } }, { "name": "limit", "in": "query", "required": false, "schema": { "anyOf": [ { "type": "integer", "minimum": 0 }, { "type": "null" } ] } } ], "description": "Authorization and validation are enforced by the owning service.", "x-handler": "list_people_suggestions", "x-source-file": "crates/synckhub-server/src/routes/connected_accounts/provider_people.rs", "x-source-line": 916, "responses": { "default": { "description": "Service response. Error status and envelope depend on the operation." }, "2XX": { "description": "Successful JSON response", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/synckhub_server.routes.connected_accounts.provider_people.PeopleSuggestionsResponse" } } } } } }, "head": { "operationId": "platform_head__v1_integrations_mailcal_people_suggestions", "summary": "list people suggestions", "tags": [ "connected_accounts · provider_people" ], "parameters": [ { "name": "q", "in": "query", "required": true, "schema": { "type": "string" } }, { "name": "repo_id", "in": "query", "required": false, "schema": { "anyOf": [ { "type": "string" }, { "type": "null" } ] } }, { "name": "active_account_id", "in": "query", "required": false, "schema": { "anyOf": [ { "type": "string" }, { "type": "null" } ] } }, { "name": "limit", "in": "query", "required": false, "schema": { "anyOf": [ { "type": "integer", "minimum": 0 }, { "type": "null" } ] } } ], "description": "Authorization and validation are enforced by the owning service.\n\nHEAD uses the GET handler and headers without a response body.", "x-handler": "list_people_suggestions", "x-source-file": "crates/synckhub-server/src/routes/connected_accounts/provider_people.rs", "x-source-line": 916, "x-implicit-head": true, "responses": { "default": { "description": "Service response. Error status and envelope depend on the operation." } } } }, "/v1/integrations/mailcal/webhooks/gmail": { "post": { "operationId": "platform_post__v1_integrations_mailcal_webhooks_gmail", "summary": "gmail webhook", "tags": [ "connected_accounts · webhooks" ], "parameters": [], "description": "Authorization and validation are enforced by the owning service.\n\nThis route does not require the normal user bearer session. Link/download tokens, OAuth state, or webhook verification are validated by its handler where applicable.", "x-handler": "gmail_webhook", "x-source-file": "crates/synckhub-server/src/routes/connected_accounts/webhooks.rs", "x-source-line": 23, "responses": { "default": { "description": "Service response. Error status and envelope depend on the operation." } }, "requestBody": { "required": true, "content": { "application/json": { "schema": { "$ref": "#/components/schemas/synckhub_server.routes.connected_accounts.webhooks.GooglePubSubPush" } } } }, "security": [ { "googlePubSubJwt": [] } ] } }, "/v1/integrations/mailcal/webhooks/microsoft-graph": { "post": { "operationId": "platform_post__v1_integrations_mailcal_webhooks_microsoft_graph", "summary": "graph webhook", "tags": [ "connected_accounts · webhooks" ], "parameters": [ { "name": "validationToken", "in": "query", "schema": { "type": "string" } } ], "description": "Authorization and validation are enforced by the owning service.\n\nGraph validation echoes validationToken. Without that query parameter, a notification JSON body is required and each clientState is verified.\n\nThis route does not require the normal user bearer session. Link/download tokens, OAuth state, or webhook verification are validated by its handler where applicable.", "x-handler": "graph_webhook", "x-source-file": "crates/synckhub-server/src/routes/connected_accounts/webhooks.rs", "x-source-line": 23, "responses": { "default": { "description": "Service response. Error status and envelope depend on the operation." } }, "requestBody": { "required": false, "content": { "application/json": { "schema": { "$ref": "#/components/schemas/synckhub_server.routes.connected_accounts.webhooks.GraphWebhookEnvelope" } } } }, "security": [] } }, "/v1/public/folder-auto-join-links/{folder_auto_join_link_token}": { "get": { "operationId": "platform_get__v1_public_folder_auto_join_links__folder_auto_join_link_token_", "summary": "public get folder auto join link", "tags": [ "sharing" ], "parameters": [ { "name": "folder_auto_join_link_token", "in": "path", "required": true, "schema": { "type": "string" } } ], "description": "Authorization and validation are enforced by the owning service.\n\nThis route does not require the normal user bearer session. Link/download tokens, OAuth state, or webhook verification are validated by its handler where applicable.", "x-handler": "crate::folder_auto_join_links::public_get_folder_auto_join_link", "x-source-file": "crates/synckhub-server/src/routes/sharing.rs", "x-source-line": 7, "responses": { "default": { "description": "Platform error; branch on HTTP status and stable code, not the human-readable message.", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } } }, "2XX": { "description": "Successful JSON response", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/synckhub_server.folder_auto_join_links.PublicFolderAutoJoinLinkMetaResponse" } } } } }, "security": [] }, "head": { "operationId": "platform_head__v1_public_folder_auto_join_links__folder_auto_join_link_token_", "summary": "public get folder auto join link", "tags": [ "sharing" ], "parameters": [ { "name": "folder_auto_join_link_token", "in": "path", "required": true, "schema": { "type": "string" } } ], "description": "Authorization and validation are enforced by the owning service.\n\nHEAD uses the GET handler and headers without a response body.\n\nThis route does not require the normal user bearer session. Link/download tokens, OAuth state, or webhook verification are validated by its handler where applicable.", "x-handler": "crate::folder_auto_join_links::public_get_folder_auto_join_link", "x-source-file": "crates/synckhub-server/src/routes/sharing.rs", "x-source-line": 7, "x-implicit-head": true, "responses": { "default": { "description": "Platform error; branch on HTTP status and stable code, not the human-readable message." } }, "security": [] } }, "/v1/public/folder-auto-join-links/{folder_auto_join_link_token}/claim/resend": { "post": { "operationId": "platform_post__v1_public_folder_auto_join_links__folder_auto_join_link_token__claim_resend", "summary": "public resend folder auto join link claim", "tags": [ "sharing" ], "parameters": [ { "name": "folder_auto_join_link_token", "in": "path", "required": true, "schema": { "type": "string" } } ], "description": "Authorization and validation are enforced by the owning service.\n\nThis route does not require the normal user bearer session. Link/download tokens, OAuth state, or webhook verification are validated by its handler where applicable.", "x-handler": "crate::folder_auto_join_links::public_resend_folder_auto_join_link_claim", "x-source-file": "crates/synckhub-server/src/routes/sharing.rs", "x-source-line": 7, "responses": { "default": { "description": "Platform error; branch on HTTP status and stable code, not the human-readable message.", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } } }, "2XX": { "description": "Successful JSON response", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/synckhub_server.folder_auto_join_links.FolderAutoJoinLinkClaimChallengeResponse" } } } } }, "requestBody": { "required": true, "content": { "application/json": { "schema": { "$ref": "#/components/schemas/synckhub_server.folder_auto_join_links.ResendFolderAutoJoinLinkClaimRequest" } } } }, "security": [] } }, "/v1/public/folder-auto-join-links/{folder_auto_join_link_token}/claim/start": { "post": { "operationId": "platform_post__v1_public_folder_auto_join_links__folder_auto_join_link_token__claim_start", "summary": "public start folder auto join link claim", "tags": [ "sharing" ], "parameters": [ { "name": "folder_auto_join_link_token", "in": "path", "required": true, "schema": { "type": "string" } } ], "description": "Authorization and validation are enforced by the owning service.\n\nThis route does not require the normal user bearer session. Link/download tokens, OAuth state, or webhook verification are validated by its handler where applicable.", "x-handler": "crate::folder_auto_join_links::public_start_folder_auto_join_link_claim", "x-source-file": "crates/synckhub-server/src/routes/sharing.rs", "x-source-line": 7, "responses": { "default": { "description": "Platform error; branch on HTTP status and stable code, not the human-readable message.", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } } }, "2XX": { "description": "Successful JSON response", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/synckhub_server.folder_auto_join_links.FolderAutoJoinLinkClaimChallengeResponse" } } } } }, "requestBody": { "required": true, "content": { "application/json": { "schema": { "$ref": "#/components/schemas/synckhub_server.folder_auto_join_links.StartFolderAutoJoinLinkClaimRequest" } } } }, "security": [] } }, "/v1/public/folder-auto-join-links/{folder_auto_join_link_token}/claim/verify": { "post": { "operationId": "platform_post__v1_public_folder_auto_join_links__folder_auto_join_link_token__claim_verify", "summary": "public verify folder auto join link claim", "tags": [ "sharing" ], "parameters": [ { "name": "folder_auto_join_link_token", "in": "path", "required": true, "schema": { "type": "string" } } ], "description": "Authorization and validation are enforced by the owning service.\n\nThis route does not require the normal user bearer session. Link/download tokens, OAuth state, or webhook verification are validated by its handler where applicable.", "x-handler": "crate::folder_auto_join_links::public_verify_folder_auto_join_link_claim", "x-source-file": "crates/synckhub-server/src/routes/sharing.rs", "x-source-line": 7, "responses": { "default": { "description": "Platform error; branch on HTTP status and stable code, not the human-readable message.", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } } }, "2XX": { "description": "Successful JSON response", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/synckhub_server.folder_auto_join_links.VerifyFolderAutoJoinLinkClaimResponse" } } } } }, "requestBody": { "required": true, "content": { "application/json": { "schema": { "$ref": "#/components/schemas/synckhub_server.folder_auto_join_links.VerifyFolderAutoJoinLinkClaimRequest" } } } }, "security": [] } }, "/v1/public/shared-file-collections/{token}": { "get": { "operationId": "platform_get__v1_public_shared_file_collections__token_", "summary": "public get", "tags": [ "sharing" ], "parameters": [ { "name": "token", "in": "path", "required": true, "schema": { "type": "string" } } ], "description": "Authorization and validation are enforced by the owning service.\n\nThis route does not require the normal user bearer session. Link/download tokens, OAuth state, or webhook verification are validated by its handler where applicable.", "x-handler": "crate::shared_file_collections::public_get", "x-source-file": "crates/synckhub-server/src/routes/sharing.rs", "x-source-line": 7, "responses": { "default": { "description": "Platform error; branch on HTTP status and stable code, not the human-readable message.", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } } } }, "security": [] }, "head": { "operationId": "platform_head__v1_public_shared_file_collections__token_", "summary": "public get", "tags": [ "sharing" ], "parameters": [ { "name": "token", "in": "path", "required": true, "schema": { "type": "string" } } ], "description": "Authorization and validation are enforced by the owning service.\n\nHEAD uses the GET handler and headers without a response body.\n\nThis route does not require the normal user bearer session. Link/download tokens, OAuth state, or webhook verification are validated by its handler where applicable.", "x-handler": "crate::shared_file_collections::public_get", "x-source-file": "crates/synckhub-server/src/routes/sharing.rs", "x-source-line": 7, "x-implicit-head": true, "responses": { "default": { "description": "Platform error; branch on HTTP status and stable code, not the human-readable message." } }, "security": [] } }, "/v1/public/shared-file-collections/{token}/download-url": { "post": { "operationId": "platform_post__v1_public_shared_file_collections__token__download_url", "summary": "public zip url", "tags": [ "sharing" ], "parameters": [ { "name": "token", "in": "path", "required": true, "schema": { "type": "string" } } ], "description": "Authorization and validation are enforced by the owning service.\n\nThis route does not require the normal user bearer session. Link/download tokens, OAuth state, or webhook verification are validated by its handler where applicable.", "x-handler": "crate::shared_file_collections::public_zip_url", "x-source-file": "crates/synckhub-server/src/routes/sharing.rs", "x-source-line": 7, "responses": { "default": { "description": "Platform error; branch on HTTP status and stable code, not the human-readable message.", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } } } }, "security": [] } }, "/v1/public/shared-file-collections/{token}/files/{file_id}/content-url": { "post": { "operationId": "platform_post__v1_public_shared_file_collections__token__files__file_id__content_url", "summary": "public content url", "tags": [ "sharing" ], "parameters": [ { "name": "token", "in": "path", "required": true, "schema": { "type": "string" } }, { "name": "file_id", "in": "path", "required": true, "schema": { "type": "string" } } ], "description": "Authorization and validation are enforced by the owning service.\n\nThis route does not require the normal user bearer session. Link/download tokens, OAuth state, or webhook verification are validated by its handler where applicable.", "x-handler": "crate::shared_file_collections::public_content_url", "x-source-file": "crates/synckhub-server/src/routes/sharing.rs", "x-source-line": 7, "responses": { "default": { "description": "Platform error; branch on HTTP status and stable code, not the human-readable message.", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } } } }, "security": [] } }, "/v1/public/shared-file-collections/{token}/unlock": { "post": { "operationId": "platform_post__v1_public_shared_file_collections__token__unlock", "summary": "public unlock", "tags": [ "sharing" ], "parameters": [ { "name": "token", "in": "path", "required": true, "schema": { "type": "string" } } ], "description": "Authorization and validation are enforced by the owning service.\n\nThis route does not require the normal user bearer session. Link/download tokens, OAuth state, or webhook verification are validated by its handler where applicable.", "x-handler": "crate::shared_file_collections::public_unlock", "x-source-file": "crates/synckhub-server/src/routes/sharing.rs", "x-source-line": 7, "responses": { "default": { "description": "Platform error; branch on HTTP status and stable code, not the human-readable message.", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } } } }, "requestBody": { "required": true, "content": { "application/json": { "schema": { "$ref": "#/components/schemas/synckhub_server.shared_file_collections.UnlockRequest" } } } }, "security": [] } }, "/v1/public/shared-file-collections/content/{content_token}": { "get": { "operationId": "platform_get__v1_public_shared_file_collections_content__content_token_", "summary": "public content", "tags": [ "sharing" ], "parameters": [ { "name": "content_token", "in": "path", "required": true, "schema": { "type": "string" } } ], "description": "Authorization and validation are enforced by the owning service.\n\nThis route does not require the normal user bearer session. Link/download tokens, OAuth state, or webhook verification are validated by its handler where applicable.", "x-handler": "crate::shared_file_collections::public_content", "x-source-file": "crates/synckhub-server/src/routes/sharing.rs", "x-source-line": 7, "responses": { "default": { "description": "Platform error; branch on HTTP status and stable code, not the human-readable message.", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } } } }, "security": [] }, "head": { "operationId": "platform_head__v1_public_shared_file_collections_content__content_token_", "summary": "public content", "tags": [ "sharing" ], "parameters": [ { "name": "content_token", "in": "path", "required": true, "schema": { "type": "string" } } ], "description": "Authorization and validation are enforced by the owning service.\n\nHEAD uses the GET handler and headers without a response body.\n\nThis route does not require the normal user bearer session. Link/download tokens, OAuth state, or webhook verification are validated by its handler where applicable.", "x-handler": "crate::shared_file_collections::public_content", "x-source-file": "crates/synckhub-server/src/routes/sharing.rs", "x-source-line": 7, "x-implicit-head": true, "responses": { "default": { "description": "Platform error; branch on HTTP status and stable code, not the human-readable message." } }, "security": [] } }, "/v1/public/shared-file-collections/downloads/{download_token}": { "get": { "operationId": "platform_get__v1_public_shared_file_collections_downloads__download_token_", "summary": "public zip", "tags": [ "sharing" ], "parameters": [ { "name": "download_token", "in": "path", "required": true, "schema": { "type": "string" } } ], "description": "Authorization and validation are enforced by the owning service.\n\nThis route does not require the normal user bearer session. Link/download tokens, OAuth state, or webhook verification are validated by its handler where applicable.", "x-handler": "crate::shared_file_collections::public_zip", "x-source-file": "crates/synckhub-server/src/routes/sharing.rs", "x-source-line": 7, "responses": { "default": { "description": "Platform error; branch on HTTP status and stable code, not the human-readable message.", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } } } }, "security": [] }, "head": { "operationId": "platform_head__v1_public_shared_file_collections_downloads__download_token_", "summary": "public zip", "tags": [ "sharing" ], "parameters": [ { "name": "download_token", "in": "path", "required": true, "schema": { "type": "string" } } ], "description": "Authorization and validation are enforced by the owning service.\n\nHEAD uses the GET handler and headers without a response body.\n\nThis route does not require the normal user bearer session. Link/download tokens, OAuth state, or webhook verification are validated by its handler where applicable.", "x-handler": "crate::shared_file_collections::public_zip", "x-source-file": "crates/synckhub-server/src/routes/sharing.rs", "x-source-line": 7, "x-implicit-head": true, "responses": { "default": { "description": "Platform error; branch on HTTP status and stable code, not the human-readable message." } }, "security": [] } }, "/v1/public/shared-file-links/{shared_file_link_token}": { "get": { "operationId": "platform_get__v1_public_shared_file_links__shared_file_link_token_", "summary": "public get shared file link", "tags": [ "sharing" ], "parameters": [ { "name": "shared_file_link_token", "in": "path", "required": true, "schema": { "type": "string" } } ], "description": "Authorization and validation are enforced by the owning service.\n\nThis route does not require the normal user bearer session. Link/download tokens, OAuth state, or webhook verification are validated by its handler where applicable.", "x-handler": "crate::shared_file_links::public_get_shared_file_link", "x-source-file": "crates/synckhub-server/src/routes/sharing.rs", "x-source-line": 7, "responses": { "default": { "description": "Platform error; branch on HTTP status and stable code, not the human-readable message.", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } } } }, "security": [] }, "head": { "operationId": "platform_head__v1_public_shared_file_links__shared_file_link_token_", "summary": "public get shared file link", "tags": [ "sharing" ], "parameters": [ { "name": "shared_file_link_token", "in": "path", "required": true, "schema": { "type": "string" } } ], "description": "Authorization and validation are enforced by the owning service.\n\nHEAD uses the GET handler and headers without a response body.\n\nThis route does not require the normal user bearer session. Link/download tokens, OAuth state, or webhook verification are validated by its handler where applicable.", "x-handler": "crate::shared_file_links::public_get_shared_file_link", "x-source-file": "crates/synckhub-server/src/routes/sharing.rs", "x-source-line": 7, "x-implicit-head": true, "responses": { "default": { "description": "Platform error; branch on HTTP status and stable code, not the human-readable message." } }, "security": [] } }, "/v1/public/shared-file-links/{shared_file_link_token}/content-url": { "post": { "operationId": "platform_post__v1_public_shared_file_links__shared_file_link_token__content_url", "summary": "public create shared file content url", "tags": [ "sharing" ], "parameters": [ { "name": "shared_file_link_token", "in": "path", "required": true, "schema": { "type": "string" } } ], "description": "Authorization and validation are enforced by the owning service.\n\nThis route does not require the normal user bearer session. Link/download tokens, OAuth state, or webhook verification are validated by its handler where applicable.", "x-handler": "crate::shared_file_links::public_create_shared_file_content_url", "x-source-file": "crates/synckhub-server/src/routes/sharing.rs", "x-source-line": 7, "responses": { "200": { "description": "Signed content URL and its expiry time.", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/synckhub_server.shared_file_links.PublicFileContentUrlResponse" } } } }, "default": { "description": "Platform error; branch on HTTP status and stable code, not the human-readable message.", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } } } }, "requestBody": { "required": false, "description": "Omit the body or content_token to mint a new content URL. Supply an existing content_token to renew it. Link access checks apply to both operations.", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/synckhub_server.shared_file_links.PublicFileContentUrlRequest" } } } }, "security": [] } }, "/v1/public/shared-file-links/{shared_file_link_token}/unlock": { "post": { "operationId": "platform_post__v1_public_shared_file_links__shared_file_link_token__unlock", "summary": "public unlock shared file link", "tags": [ "sharing" ], "parameters": [ { "name": "shared_file_link_token", "in": "path", "required": true, "schema": { "type": "string" } } ], "description": "Authorization and validation are enforced by the owning service.\n\nThis route does not require the normal user bearer session. Link/download tokens, OAuth state, or webhook verification are validated by its handler where applicable.", "x-handler": "crate::shared_file_links::public_unlock_shared_file_link", "x-source-file": "crates/synckhub-server/src/routes/sharing.rs", "x-source-line": 7, "responses": { "default": { "description": "Platform error; branch on HTTP status and stable code, not the human-readable message.", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } } }, "2XX": { "description": "Successful JSON response", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/synckhub_server.shared_file_links.UnlockSharedFileLinkResponse" } } } } }, "requestBody": { "required": true, "content": { "application/json": { "schema": { "$ref": "#/components/schemas/synckhub_server.shared_file_links.UnlockSharedFileLinkRequest" } } } }, "security": [] } }, "/v1/public/shared-file-links/content/{content_token}": { "get": { "operationId": "platform_get__v1_public_shared_file_links_content__content_token_", "summary": "public get shared file content", "tags": [ "sharing" ], "parameters": [ { "name": "content_token", "in": "path", "required": true, "schema": { "type": "string" } } ], "description": "Authorization and validation are enforced by the owning service.\n\nThis route does not require the normal user bearer session. Link/download tokens, OAuth state, or webhook verification are validated by its handler where applicable.", "x-handler": "crate::shared_file_links::public_get_shared_file_content", "x-source-file": "crates/synckhub-server/src/routes/sharing.rs", "x-source-line": 7, "responses": { "default": { "description": "Platform error; branch on HTTP status and stable code, not the human-readable message.", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } } } }, "security": [] }, "head": { "operationId": "platform_head__v1_public_shared_file_links_content__content_token_", "summary": "public get shared file content", "tags": [ "sharing" ], "parameters": [ { "name": "content_token", "in": "path", "required": true, "schema": { "type": "string" } } ], "description": "Authorization and validation are enforced by the owning service.\n\nHEAD uses the GET handler and headers without a response body.\n\nThis route does not require the normal user bearer session. Link/download tokens, OAuth state, or webhook verification are validated by its handler where applicable.", "x-handler": "crate::shared_file_links::public_get_shared_file_content", "x-source-file": "crates/synckhub-server/src/routes/sharing.rs", "x-source-line": 7, "x-implicit-head": true, "responses": { "default": { "description": "Platform error; branch on HTTP status and stable code, not the human-readable message." } }, "security": [] } }, "/v1/public/shared-folder-links/{shared_folder_link_token}": { "get": { "operationId": "platform_get__v1_public_shared_folder_links__shared_folder_link_token_", "summary": "public get shared folder link", "tags": [ "sharing" ], "parameters": [ { "name": "shared_folder_link_token", "in": "path", "required": true, "schema": { "type": "string" } } ], "description": "Authorization and validation are enforced by the owning service.\n\nThis route does not require the normal user bearer session. Link/download tokens, OAuth state, or webhook verification are validated by its handler where applicable.", "x-handler": "crate::shared_folder_links::public_get_shared_folder_link", "x-source-file": "crates/synckhub-server/src/routes/sharing.rs", "x-source-line": 7, "responses": { "default": { "description": "Platform error; branch on HTTP status and stable code, not the human-readable message.", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } } }, "2XX": { "description": "Successful JSON response", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/synckhub_server.shared_folder_links.PublicSharedFolderLinkMetaResponse" } } } } }, "security": [] }, "head": { "operationId": "platform_head__v1_public_shared_folder_links__shared_folder_link_token_", "summary": "public get shared folder link", "tags": [ "sharing" ], "parameters": [ { "name": "shared_folder_link_token", "in": "path", "required": true, "schema": { "type": "string" } } ], "description": "Authorization and validation are enforced by the owning service.\n\nHEAD uses the GET handler and headers without a response body.\n\nThis route does not require the normal user bearer session. Link/download tokens, OAuth state, or webhook verification are validated by its handler where applicable.", "x-handler": "crate::shared_folder_links::public_get_shared_folder_link", "x-source-file": "crates/synckhub-server/src/routes/sharing.rs", "x-source-line": 7, "x-implicit-head": true, "responses": { "default": { "description": "Platform error; branch on HTTP status and stable code, not the human-readable message." } }, "security": [] } }, "/v1/public/shared-folder-links/{shared_folder_link_token}/download-url": { "post": { "operationId": "platform_post__v1_public_shared_folder_links__shared_folder_link_token__download_url", "summary": "public create shared folder link download url", "tags": [ "sharing" ], "parameters": [ { "name": "shared_folder_link_token", "in": "path", "required": true, "schema": { "type": "string" } } ], "description": "Authorization and validation are enforced by the owning service.\n\nThis route does not require the normal user bearer session. Link/download tokens, OAuth state, or webhook verification are validated by its handler where applicable.", "x-handler": "crate::shared_folder_links::public_create_shared_folder_link_download_url", "x-source-file": "crates/synckhub-server/src/routes/sharing.rs", "x-source-line": 7, "responses": { "default": { "description": "Platform error; branch on HTTP status and stable code, not the human-readable message.", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } } } }, "requestBody": { "required": true, "content": { "application/json": { "schema": { "$ref": "#/components/schemas/synckhub_server.shared_folder_links.PublicCreateDownloadUrlRequest" } } } }, "security": [] } }, "/v1/public/shared-folder-links/{shared_folder_link_token}/download.zip": { "get": { "operationId": "platform_get__v1_public_shared_folder_links__shared_folder_link_token__download_zip", "summary": "public download shared folder zip", "tags": [ "sharing" ], "parameters": [ { "name": "shared_folder_link_token", "in": "path", "required": true, "schema": { "type": "string" } }, { "name": "allow_partial", "in": "query", "required": false, "schema": { "anyOf": [ { "type": "string" }, { "type": "null" } ] } }, { "name": "item_ids", "in": "query", "required": false, "schema": { "anyOf": [ { "type": "string" }, { "type": "null" } ] } } ], "description": "Authorization and validation are enforced by the owning service.\n\nThis route does not require the normal user bearer session. Link/download tokens, OAuth state, or webhook verification are validated by its handler where applicable.", "x-handler": "crate::shared_folder_links::public_download_shared_folder_zip", "x-source-file": "crates/synckhub-server/src/routes/sharing.rs", "x-source-line": 7, "responses": { "default": { "description": "Platform error; branch on HTTP status and stable code, not the human-readable message.", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } } } }, "security": [] }, "head": { "operationId": "platform_head__v1_public_shared_folder_links__shared_folder_link_token__download_zip", "summary": "public download shared folder zip", "tags": [ "sharing" ], "parameters": [ { "name": "shared_folder_link_token", "in": "path", "required": true, "schema": { "type": "string" } }, { "name": "allow_partial", "in": "query", "required": false, "schema": { "anyOf": [ { "type": "string" }, { "type": "null" } ] } }, { "name": "item_ids", "in": "query", "required": false, "schema": { "anyOf": [ { "type": "string" }, { "type": "null" } ] } } ], "description": "Authorization and validation are enforced by the owning service.\n\nHEAD uses the GET handler and headers without a response body.\n\nThis route does not require the normal user bearer session. Link/download tokens, OAuth state, or webhook verification are validated by its handler where applicable.", "x-handler": "crate::shared_folder_links::public_download_shared_folder_zip", "x-source-file": "crates/synckhub-server/src/routes/sharing.rs", "x-source-line": 7, "x-implicit-head": true, "responses": { "default": { "description": "Platform error; branch on HTTP status and stable code, not the human-readable message." } }, "security": [] } }, "/v1/public/shared-folder-links/{shared_folder_link_token}/folders/{folder_id}/ancestors": { "get": { "operationId": "platform_get__v1_public_shared_folder_links__shared_folder_link_token__folders__folder_id__ancestors", "summary": "public get shared folder ancestors", "tags": [ "sharing" ], "parameters": [ { "name": "shared_folder_link_token", "in": "path", "required": true, "schema": { "type": "string" } }, { "name": "folder_id", "in": "path", "required": true, "schema": { "type": "string" } } ], "description": "Authorization and validation are enforced by the owning service.\n\nThis route does not require the normal user bearer session. Link/download tokens, OAuth state, or webhook verification are validated by its handler where applicable.", "x-handler": "crate::shared_folder_links::public_get_shared_folder_ancestors", "x-source-file": "crates/synckhub-server/src/routes/sharing.rs", "x-source-line": 7, "responses": { "default": { "description": "Platform error; branch on HTTP status and stable code, not the human-readable message.", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } } }, "2XX": { "description": "Successful JSON response", "content": { "application/json": { "schema": { "type": "array", "items": { "$ref": "#/components/schemas/synckhub_server.shared_folder_links.PublicSharedFolderAncestorResponse" } } } } } }, "security": [] }, "head": { "operationId": "platform_head__v1_public_shared_folder_links__shared_folder_link_token__folders__folder_id__ancestors", "summary": "public get shared folder ancestors", "tags": [ "sharing" ], "parameters": [ { "name": "shared_folder_link_token", "in": "path", "required": true, "schema": { "type": "string" } }, { "name": "folder_id", "in": "path", "required": true, "schema": { "type": "string" } } ], "description": "Authorization and validation are enforced by the owning service.\n\nHEAD uses the GET handler and headers without a response body.\n\nThis route does not require the normal user bearer session. Link/download tokens, OAuth state, or webhook verification are validated by its handler where applicable.", "x-handler": "crate::shared_folder_links::public_get_shared_folder_ancestors", "x-source-file": "crates/synckhub-server/src/routes/sharing.rs", "x-source-line": 7, "x-implicit-head": true, "responses": { "default": { "description": "Platform error; branch on HTTP status and stable code, not the human-readable message." } }, "security": [] } }, "/v1/public/shared-folder-links/{shared_folder_link_token}/folders/{folder_id}/stats": { "get": { "operationId": "platform_get__v1_public_shared_folder_links__shared_folder_link_token__folders__folder_id__stats", "summary": "public get shared folder stats", "tags": [ "sharing" ], "parameters": [ { "name": "shared_folder_link_token", "in": "path", "required": true, "schema": { "type": "string" } }, { "name": "folder_id", "in": "path", "required": true, "schema": { "type": "string" } } ], "description": "Authorization and validation are enforced by the owning service.\n\nThis route does not require the normal user bearer session. Link/download tokens, OAuth state, or webhook verification are validated by its handler where applicable.", "x-handler": "crate::shared_folder_links::public_get_shared_folder_stats", "x-source-file": "crates/synckhub-server/src/routes/sharing.rs", "x-source-line": 7, "responses": { "default": { "description": "Platform error; branch on HTTP status and stable code, not the human-readable message.", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } } }, "2XX": { "description": "Successful JSON response", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/synckhub_server.shared_folder_links.PublicSharedFolderStatsResponse" } } } } }, "security": [] }, "head": { "operationId": "platform_head__v1_public_shared_folder_links__shared_folder_link_token__folders__folder_id__stats", "summary": "public get shared folder stats", "tags": [ "sharing" ], "parameters": [ { "name": "shared_folder_link_token", "in": "path", "required": true, "schema": { "type": "string" } }, { "name": "folder_id", "in": "path", "required": true, "schema": { "type": "string" } } ], "description": "Authorization and validation are enforced by the owning service.\n\nHEAD uses the GET handler and headers without a response body.\n\nThis route does not require the normal user bearer session. Link/download tokens, OAuth state, or webhook verification are validated by its handler where applicable.", "x-handler": "crate::shared_folder_links::public_get_shared_folder_stats", "x-source-file": "crates/synckhub-server/src/routes/sharing.rs", "x-source-line": 7, "x-implicit-head": true, "responses": { "default": { "description": "Platform error; branch on HTTP status and stable code, not the human-readable message." } }, "security": [] } }, "/v1/public/shared-folder-links/{shared_folder_link_token}/items": { "get": { "operationId": "platform_get__v1_public_shared_folder_links__shared_folder_link_token__items", "summary": "public list shared folder items", "tags": [ "sharing" ], "parameters": [ { "name": "shared_folder_link_token", "in": "path", "required": true, "schema": { "type": "string" } }, { "name": "parent_folder_id", "in": "query", "required": false, "schema": { "anyOf": [ { "type": "string" }, { "type": "null" } ] } }, { "name": "limit", "in": "query", "required": false, "schema": { "anyOf": [ { "type": "integer", "minimum": 0 }, { "type": "null" } ] } }, { "name": "offset", "in": "query", "required": false, "schema": { "anyOf": [ { "type": "integer", "minimum": 0 }, { "type": "null" } ] } } ], "description": "Authorization and validation are enforced by the owning service.\n\nThis route does not require the normal user bearer session. Link/download tokens, OAuth state, or webhook verification are validated by its handler where applicable.", "x-handler": "crate::shared_folder_links::public_list_shared_folder_items", "x-source-file": "crates/synckhub-server/src/routes/sharing.rs", "x-source-line": 7, "responses": { "default": { "description": "Platform error; branch on HTTP status and stable code, not the human-readable message.", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } } }, "2XX": { "description": "Successful JSON response", "content": { "application/json": { "schema": { "type": "array", "items": { "$ref": "#/components/schemas/synckhub_core.types.ItemSummary" } } } } } }, "security": [] }, "head": { "operationId": "platform_head__v1_public_shared_folder_links__shared_folder_link_token__items", "summary": "public list shared folder items", "tags": [ "sharing" ], "parameters": [ { "name": "shared_folder_link_token", "in": "path", "required": true, "schema": { "type": "string" } }, { "name": "parent_folder_id", "in": "query", "required": false, "schema": { "anyOf": [ { "type": "string" }, { "type": "null" } ] } }, { "name": "limit", "in": "query", "required": false, "schema": { "anyOf": [ { "type": "integer", "minimum": 0 }, { "type": "null" } ] } }, { "name": "offset", "in": "query", "required": false, "schema": { "anyOf": [ { "type": "integer", "minimum": 0 }, { "type": "null" } ] } } ], "description": "Authorization and validation are enforced by the owning service.\n\nHEAD uses the GET handler and headers without a response body.\n\nThis route does not require the normal user bearer session. Link/download tokens, OAuth state, or webhook verification are validated by its handler where applicable.", "x-handler": "crate::shared_folder_links::public_list_shared_folder_items", "x-source-file": "crates/synckhub-server/src/routes/sharing.rs", "x-source-line": 7, "x-implicit-head": true, "responses": { "default": { "description": "Platform error; branch on HTTP status and stable code, not the human-readable message." } }, "security": [] } }, "/v1/public/shared-folder-links/{shared_folder_link_token}/items/{item_id}": { "get": { "operationId": "platform_get__v1_public_shared_folder_links__shared_folder_link_token__items__item_id_", "summary": "public get shared item", "tags": [ "sharing" ], "parameters": [ { "name": "shared_folder_link_token", "in": "path", "required": true, "schema": { "type": "string" } }, { "name": "item_id", "in": "path", "required": true, "schema": { "type": "string" } } ], "description": "Authorization and validation are enforced by the owning service.\n\nThis route does not require the normal user bearer session. Link/download tokens, OAuth state, or webhook verification are validated by its handler where applicable.", "x-handler": "crate::shared_folder_links::public_get_shared_item", "x-source-file": "crates/synckhub-server/src/routes/sharing.rs", "x-source-line": 7, "responses": { "default": { "description": "Platform error; branch on HTTP status and stable code, not the human-readable message.", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } } }, "2XX": { "description": "Successful JSON response", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/synckhub_core.types.ItemSummary" } } } } }, "security": [] }, "head": { "operationId": "platform_head__v1_public_shared_folder_links__shared_folder_link_token__items__item_id_", "summary": "public get shared item", "tags": [ "sharing" ], "parameters": [ { "name": "shared_folder_link_token", "in": "path", "required": true, "schema": { "type": "string" } }, { "name": "item_id", "in": "path", "required": true, "schema": { "type": "string" } } ], "description": "Authorization and validation are enforced by the owning service.\n\nHEAD uses the GET handler and headers without a response body.\n\nThis route does not require the normal user bearer session. Link/download tokens, OAuth state, or webhook verification are validated by its handler where applicable.", "x-handler": "crate::shared_folder_links::public_get_shared_item", "x-source-file": "crates/synckhub-server/src/routes/sharing.rs", "x-source-line": 7, "x-implicit-head": true, "responses": { "default": { "description": "Platform error; branch on HTTP status and stable code, not the human-readable message." } }, "security": [] } }, "/v1/public/shared-folder-links/{shared_folder_link_token}/items/{item_id}/content": { "get": { "operationId": "platform_get__v1_public_shared_folder_links__shared_folder_link_token__items__item_id__content", "summary": "public get shared item content", "tags": [ "sharing" ], "parameters": [ { "name": "shared_folder_link_token", "in": "path", "required": true, "schema": { "type": "string" } }, { "name": "item_id", "in": "path", "required": true, "schema": { "type": "string" } } ], "description": "Authorization and validation are enforced by the owning service.\n\nThis route does not require the normal user bearer session. Link/download tokens, OAuth state, or webhook verification are validated by its handler where applicable.", "x-handler": "crate::shared_folder_links::public_get_shared_item_content", "x-source-file": "crates/synckhub-server/src/routes/sharing.rs", "x-source-line": 7, "responses": { "default": { "description": "Platform error; branch on HTTP status and stable code, not the human-readable message.", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } } } }, "security": [] }, "head": { "operationId": "platform_head__v1_public_shared_folder_links__shared_folder_link_token__items__item_id__content", "summary": "public get shared item content", "tags": [ "sharing" ], "parameters": [ { "name": "shared_folder_link_token", "in": "path", "required": true, "schema": { "type": "string" } }, { "name": "item_id", "in": "path", "required": true, "schema": { "type": "string" } } ], "description": "Authorization and validation are enforced by the owning service.\n\nHEAD uses the GET handler and headers without a response body.\n\nThis route does not require the normal user bearer session. Link/download tokens, OAuth state, or webhook verification are validated by its handler where applicable.", "x-handler": "crate::shared_folder_links::public_get_shared_item_content", "x-source-file": "crates/synckhub-server/src/routes/sharing.rs", "x-source-line": 7, "x-implicit-head": true, "responses": { "default": { "description": "Platform error; branch on HTTP status and stable code, not the human-readable message." } }, "security": [] } }, "/v1/public/shared-folder-links/{shared_folder_link_token}/items/{item_id}/file-versions": { "get": { "operationId": "platform_get__v1_public_shared_folder_links__shared_folder_link_token__items__item_id__file_versions", "summary": "public list shared item file versions", "tags": [ "sharing" ], "parameters": [ { "name": "shared_folder_link_token", "in": "path", "required": true, "schema": { "type": "string" } }, { "name": "item_id", "in": "path", "required": true, "schema": { "type": "string" } }, { "name": "limit", "in": "query", "required": false, "schema": { "anyOf": [ { "type": "integer", "minimum": 0 }, { "type": "null" } ] } }, { "name": "offset", "in": "query", "required": false, "schema": { "anyOf": [ { "type": "integer", "minimum": 0 }, { "type": "null" } ] } } ], "description": "Authorization and validation are enforced by the owning service.\n\nThis route does not require the normal user bearer session. Link/download tokens, OAuth state, or webhook verification are validated by its handler where applicable.", "x-handler": "crate::shared_folder_links::public_list_shared_item_file_versions", "x-source-file": "crates/synckhub-server/src/routes/sharing.rs", "x-source-line": 7, "responses": { "default": { "description": "Platform error; branch on HTTP status and stable code, not the human-readable message.", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } } }, "2XX": { "description": "Successful JSON response", "content": { "application/json": { "schema": { "type": "array", "items": { "$ref": "#/components/schemas/synckhub_core.types.FileVersionSummary" } } } } } }, "security": [] }, "head": { "operationId": "platform_head__v1_public_shared_folder_links__shared_folder_link_token__items__item_id__file_versions", "summary": "public list shared item file versions", "tags": [ "sharing" ], "parameters": [ { "name": "shared_folder_link_token", "in": "path", "required": true, "schema": { "type": "string" } }, { "name": "item_id", "in": "path", "required": true, "schema": { "type": "string" } }, { "name": "limit", "in": "query", "required": false, "schema": { "anyOf": [ { "type": "integer", "minimum": 0 }, { "type": "null" } ] } }, { "name": "offset", "in": "query", "required": false, "schema": { "anyOf": [ { "type": "integer", "minimum": 0 }, { "type": "null" } ] } } ], "description": "Authorization and validation are enforced by the owning service.\n\nHEAD uses the GET handler and headers without a response body.\n\nThis route does not require the normal user bearer session. Link/download tokens, OAuth state, or webhook verification are validated by its handler where applicable.", "x-handler": "crate::shared_folder_links::public_list_shared_item_file_versions", "x-source-file": "crates/synckhub-server/src/routes/sharing.rs", "x-source-line": 7, "x-implicit-head": true, "responses": { "default": { "description": "Platform error; branch on HTTP status and stable code, not the human-readable message." } }, "security": [] } }, "/v1/public/shared-folder-links/{shared_folder_link_token}/unlock": { "post": { "operationId": "platform_post__v1_public_shared_folder_links__shared_folder_link_token__unlock", "summary": "public unlock shared folder link", "tags": [ "sharing" ], "parameters": [ { "name": "shared_folder_link_token", "in": "path", "required": true, "schema": { "type": "string" } } ], "description": "Authorization and validation are enforced by the owning service.\n\nThis route does not require the normal user bearer session. Link/download tokens, OAuth state, or webhook verification are validated by its handler where applicable.", "x-handler": "crate::shared_folder_links::public_unlock_shared_folder_link", "x-source-file": "crates/synckhub-server/src/routes/sharing.rs", "x-source-line": 7, "responses": { "default": { "description": "Platform error; branch on HTTP status and stable code, not the human-readable message.", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } } }, "2XX": { "description": "Successful JSON response", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/synckhub_server.shared_folder_links.UnlockSharedFolderLinkResponse" } } } } }, "requestBody": { "required": true, "content": { "application/json": { "schema": { "$ref": "#/components/schemas/synckhub_server.shared_folder_links.UnlockSharedFolderLinkRequest" } } } }, "security": [] } }, "/v1/public/shared-folder-links/{shared_folder_link_token}/visits": { "post": { "operationId": "platform_post__v1_public_shared_folder_links__shared_folder_link_token__visits", "summary": "public record visit", "tags": [ "sharing" ], "parameters": [ { "name": "shared_folder_link_token", "in": "path", "required": true, "schema": { "type": "string" } } ], "description": "Authorization and validation are enforced by the owning service.\n\nThis route does not require the normal user bearer session. Link/download tokens, OAuth state, or webhook verification are validated by its handler where applicable.", "x-handler": "crate::shared_folder_links::public_record_visit", "x-source-file": "crates/synckhub-server/src/routes/sharing.rs", "x-source-line": 7, "responses": { "default": { "description": "Platform error; branch on HTTP status and stable code, not the human-readable message.", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } } } }, "requestBody": { "required": true, "content": { "application/json": { "schema": { "$ref": "#/components/schemas/synckhub_server.shared_folder_links.VisitRequest" } } } }, "security": [] } }, "/v1/public/shared-folder-links/downloads/{download_token}": { "get": { "operationId": "platform_get__v1_public_shared_folder_links_downloads__download_token_", "summary": "public download shared folder link by token", "tags": [ "sharing" ], "parameters": [ { "name": "download_token", "in": "path", "required": true, "schema": { "type": "string" } } ], "description": "Authorization and validation are enforced by the owning service.\n\nThis route does not require the normal user bearer session. Link/download tokens, OAuth state, or webhook verification are validated by its handler where applicable.", "x-handler": "crate::shared_folder_links::public_download_shared_folder_link_by_token", "x-source-file": "crates/synckhub-server/src/routes/sharing.rs", "x-source-line": 7, "responses": { "default": { "description": "Platform error; branch on HTTP status and stable code, not the human-readable message.", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } } } }, "security": [] }, "head": { "operationId": "platform_head__v1_public_shared_folder_links_downloads__download_token_", "summary": "public download shared folder link by token", "tags": [ "sharing" ], "parameters": [ { "name": "download_token", "in": "path", "required": true, "schema": { "type": "string" } } ], "description": "Authorization and validation are enforced by the owning service.\n\nHEAD uses the GET handler and headers without a response body.\n\nThis route does not require the normal user bearer session. Link/download tokens, OAuth state, or webhook verification are validated by its handler where applicable.", "x-handler": "crate::shared_folder_links::public_download_shared_folder_link_by_token", "x-source-file": "crates/synckhub-server/src/routes/sharing.rs", "x-source-line": 7, "x-implicit-head": true, "responses": { "default": { "description": "Platform error; branch on HTTP status and stable code, not the human-readable message." } }, "security": [] } }, "/v1/repos/{repo_id}/folders/{folder_id}/mail-rules": { "delete": { "operationId": "platform_delete__v1_repos__repo_id__folders__folder_id__mail_rules", "summary": "delete folder routing rule", "tags": [ "mail · routing" ], "parameters": [ { "name": "repo_id", "in": "path", "required": true, "schema": { "type": "string" } }, { "name": "folder_id", "in": "path", "required": true, "schema": { "type": "string" } } ], "description": "Authorization and validation are enforced by the owning service.", "x-handler": "delete_folder_routing_rule", "x-source-file": "crates/synckhub-server/src/routes/mail/routing.rs", "x-source-line": 51, "responses": { "default": { "description": "Service response. Error status and envelope depend on the operation." } }, "requestBody": { "required": true, "content": { "application/json": { "schema": { "$ref": "#/components/schemas/synckhub_server.routes.mail.routing.DeleteFolderRoutingRuleRequest" } } } } }, "get": { "operationId": "platform_get__v1_repos__repo_id__folders__folder_id__mail_rules", "summary": "get folder mail rules", "tags": [ "mail · routing" ], "parameters": [ { "name": "repo_id", "in": "path", "required": true, "schema": { "type": "string" } }, { "name": "folder_id", "in": "path", "required": true, "schema": { "type": "string" } } ], "description": "Authorization and validation are enforced by the owning service.", "x-handler": "get_folder_mail_rules", "x-source-file": "crates/synckhub-server/src/routes/mail/routing.rs", "x-source-line": 51, "responses": { "default": { "description": "Service response. Error status and envelope depend on the operation." }, "2XX": { "description": "Successful JSON response", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/synckhub_server.routes.mail.routing.FolderMailRulesResponse" } } } } } }, "head": { "operationId": "platform_head__v1_repos__repo_id__folders__folder_id__mail_rules", "summary": "get folder mail rules", "tags": [ "mail · routing" ], "parameters": [ { "name": "repo_id", "in": "path", "required": true, "schema": { "type": "string" } }, { "name": "folder_id", "in": "path", "required": true, "schema": { "type": "string" } } ], "description": "Authorization and validation are enforced by the owning service.\n\nHEAD uses the GET handler and headers without a response body.", "x-handler": "get_folder_mail_rules", "x-source-file": "crates/synckhub-server/src/routes/mail/routing.rs", "x-source-line": 51, "x-implicit-head": true, "responses": { "default": { "description": "Service response. Error status and envelope depend on the operation." } } } }, "/v1/repos/{repo_id}/mail-rule-folders": { "get": { "operationId": "platform_get__v1_repos__repo_id__mail_rule_folders", "summary": "get repo mail rule folders", "tags": [ "mail · routing" ], "parameters": [ { "name": "repo_id", "in": "path", "required": true, "schema": { "type": "string" } } ], "description": "Authorization and validation are enforced by the owning service.", "x-handler": "get_repo_mail_rule_folders", "x-source-file": "crates/synckhub-server/src/routes/mail/routing.rs", "x-source-line": 51, "responses": { "default": { "description": "Service response. Error status and envelope depend on the operation." }, "2XX": { "description": "Successful JSON response", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/synckhub_server.routes.mail.routing.RepoMailRuleFoldersResponse" } } } } } }, "head": { "operationId": "platform_head__v1_repos__repo_id__mail_rule_folders", "summary": "get repo mail rule folders", "tags": [ "mail · routing" ], "parameters": [ { "name": "repo_id", "in": "path", "required": true, "schema": { "type": "string" } } ], "description": "Authorization and validation are enforced by the owning service.\n\nHEAD uses the GET handler and headers without a response body.", "x-handler": "get_repo_mail_rule_folders", "x-source-file": "crates/synckhub-server/src/routes/mail/routing.rs", "x-source-line": 51, "x-implicit-head": true, "responses": { "default": { "description": "Service response. Error status and envelope depend on the operation." } } } }, "/v1/repos/{repo_id}/mail/archived-emails": { "get": { "operationId": "platform_get__v1_repos__repo_id__mail_archived_emails", "summary": "list archived emails", "tags": [ "mail · archive" ], "parameters": [ { "name": "repo_id", "in": "path", "required": true, "schema": { "type": "string" } }, { "name": "parent_folder_id", "in": "query", "required": false, "schema": { "anyOf": [ { "type": "string" }, { "type": "null" } ] } }, { "name": "name_q", "in": "query", "required": false, "schema": { "anyOf": [ { "type": "string" }, { "type": "null" } ] } }, { "name": "limit", "in": "query", "required": false, "schema": { "anyOf": [ { "type": "integer", "minimum": 0 }, { "type": "null" } ] } }, { "name": "offset", "in": "query", "required": false, "schema": { "anyOf": [ { "type": "integer", "minimum": 0 }, { "type": "null" } ] } } ], "description": "Authorization and validation are enforced by the owning service.", "x-handler": "list_archived_emails", "x-source-file": "crates/synckhub-server/src/routes/mail/archive.rs", "x-source-line": 100, "responses": { "default": { "description": "Service response. Error status and envelope depend on the operation." }, "2XX": { "description": "Successful JSON response", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/synckhub_server.routes.mail.archive.ListArchivedEmailsResponse" } } } } } }, "head": { "operationId": "platform_head__v1_repos__repo_id__mail_archived_emails", "summary": "list archived emails", "tags": [ "mail · archive" ], "parameters": [ { "name": "repo_id", "in": "path", "required": true, "schema": { "type": "string" } }, { "name": "parent_folder_id", "in": "query", "required": false, "schema": { "anyOf": [ { "type": "string" }, { "type": "null" } ] } }, { "name": "name_q", "in": "query", "required": false, "schema": { "anyOf": [ { "type": "string" }, { "type": "null" } ] } }, { "name": "limit", "in": "query", "required": false, "schema": { "anyOf": [ { "type": "integer", "minimum": 0 }, { "type": "null" } ] } }, { "name": "offset", "in": "query", "required": false, "schema": { "anyOf": [ { "type": "integer", "minimum": 0 }, { "type": "null" } ] } } ], "description": "Authorization and validation are enforced by the owning service.\n\nHEAD uses the GET handler and headers without a response body.", "x-handler": "list_archived_emails", "x-source-file": "crates/synckhub-server/src/routes/mail/archive.rs", "x-source-line": 100, "x-implicit-head": true, "responses": { "default": { "description": "Service response. Error status and envelope depend on the operation." } } } }, "/v1/repos/{repo_id}/mail/archived-emails/{email_item_id}": { "get": { "operationId": "platform_get__v1_repos__repo_id__mail_archived_emails__email_item_id_", "summary": "get archived email", "tags": [ "mail · archive" ], "parameters": [ { "name": "repo_id", "in": "path", "required": true, "schema": { "type": "string" } }, { "name": "email_item_id", "in": "path", "required": true, "schema": { "type": "string" } } ], "description": "Authorization and validation are enforced by the owning service.", "x-handler": "get_archived_email", "x-source-file": "crates/synckhub-server/src/routes/mail/archive.rs", "x-source-line": 100, "responses": { "default": { "description": "Service response. Error status and envelope depend on the operation." }, "2XX": { "description": "Successful JSON response", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/synckhub_server.routes.mail.archive.ArchivedEmailDetailResponse" } } } } } }, "head": { "operationId": "platform_head__v1_repos__repo_id__mail_archived_emails__email_item_id_", "summary": "get archived email", "tags": [ "mail · archive" ], "parameters": [ { "name": "repo_id", "in": "path", "required": true, "schema": { "type": "string" } }, { "name": "email_item_id", "in": "path", "required": true, "schema": { "type": "string" } } ], "description": "Authorization and validation are enforced by the owning service.\n\nHEAD uses the GET handler and headers without a response body.", "x-handler": "get_archived_email", "x-source-file": "crates/synckhub-server/src/routes/mail/archive.rs", "x-source-line": 100, "x-implicit-head": true, "responses": { "default": { "description": "Service response. Error status and envelope depend on the operation." } } } }, "/v1/repos/{repo_id}/mail/archived-emails/{email_item_id}/attachments": { "get": { "operationId": "platform_get__v1_repos__repo_id__mail_archived_emails__email_item_id__attachments", "summary": "list archived email attachments", "tags": [ "mail · archive" ], "parameters": [ { "name": "repo_id", "in": "path", "required": true, "schema": { "type": "string" } }, { "name": "email_item_id", "in": "path", "required": true, "schema": { "type": "string" } }, { "name": "limit", "in": "query", "required": false, "schema": { "anyOf": [ { "type": "integer", "minimum": 0 }, { "type": "null" } ] } }, { "name": "after_item_seq", "in": "query", "required": false, "schema": { "anyOf": [ { "type": "integer" }, { "type": "null" } ] } } ], "description": "Authorization and validation are enforced by the owning service.", "x-handler": "list_archived_email_attachments", "x-source-file": "crates/synckhub-server/src/routes/mail/archive.rs", "x-source-line": 100, "responses": { "default": { "description": "Service response. Error status and envelope depend on the operation." }, "2XX": { "description": "Successful JSON response", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/synckhub_server.routes.mail.archive.ListArchivedEmailAttachmentsResponse" } } } } } }, "head": { "operationId": "platform_head__v1_repos__repo_id__mail_archived_emails__email_item_id__attachments", "summary": "list archived email attachments", "tags": [ "mail · archive" ], "parameters": [ { "name": "repo_id", "in": "path", "required": true, "schema": { "type": "string" } }, { "name": "email_item_id", "in": "path", "required": true, "schema": { "type": "string" } }, { "name": "limit", "in": "query", "required": false, "schema": { "anyOf": [ { "type": "integer", "minimum": 0 }, { "type": "null" } ] } }, { "name": "after_item_seq", "in": "query", "required": false, "schema": { "anyOf": [ { "type": "integer" }, { "type": "null" } ] } } ], "description": "Authorization and validation are enforced by the owning service.\n\nHEAD uses the GET handler and headers without a response body.", "x-handler": "list_archived_email_attachments", "x-source-file": "crates/synckhub-server/src/routes/mail/archive.rs", "x-source-line": 100, "x-implicit-head": true, "responses": { "default": { "description": "Service response. Error status and envelope depend on the operation." } } } }, "/v1/repos/{repo_id}/mail/archived-emails/{email_item_id}/attachments/{attachment_id}": { "get": { "operationId": "platform_get__v1_repos__repo_id__mail_archived_emails__email_item_id__attachments__attachment_id_", "summary": "download archived email attachment", "tags": [ "mail · archive" ], "parameters": [ { "name": "repo_id", "in": "path", "required": true, "schema": { "type": "string" } }, { "name": "email_item_id", "in": "path", "required": true, "schema": { "type": "string" } }, { "name": "attachment_id", "in": "path", "required": true, "schema": { "type": "string" } } ], "description": "Authorization and validation are enforced by the owning service.", "x-handler": "download_archived_email_attachment", "x-source-file": "crates/synckhub-server/src/routes/mail/archive.rs", "x-source-line": 100, "responses": { "default": { "description": "Service response. Error status and envelope depend on the operation." } } }, "head": { "operationId": "platform_head__v1_repos__repo_id__mail_archived_emails__email_item_id__attachments__attachment_id_", "summary": "download archived email attachment", "tags": [ "mail · archive" ], "parameters": [ { "name": "repo_id", "in": "path", "required": true, "schema": { "type": "string" } }, { "name": "email_item_id", "in": "path", "required": true, "schema": { "type": "string" } }, { "name": "attachment_id", "in": "path", "required": true, "schema": { "type": "string" } } ], "description": "Authorization and validation are enforced by the owning service.\n\nHEAD uses the GET handler and headers without a response body.", "x-handler": "download_archived_email_attachment", "x-source-file": "crates/synckhub-server/src/routes/mail/archive.rs", "x-source-line": 100, "x-implicit-head": true, "responses": { "default": { "description": "Service response. Error status and envelope depend on the operation." } } } }, "/v1/repos/{repo_id}/mail/archived-emails/{email_item_id}/attachments/save-to-existing-file": { "post": { "operationId": "platform_post__v1_repos__repo_id__mail_archived_emails__email_item_id__attachments_save_to_existing_file", "summary": "save archived attachment to existing file", "tags": [ "mail · archive" ], "parameters": [ { "name": "repo_id", "in": "path", "required": true, "schema": { "type": "string" } }, { "name": "email_item_id", "in": "path", "required": true, "schema": { "type": "string" } } ], "description": "Authorization and validation are enforced by the owning service.", "x-handler": "save_archived_attachment_to_existing_file", "x-source-file": "crates/synckhub-server/src/routes/mail/archive.rs", "x-source-line": 100, "responses": { "default": { "description": "Service response. Error status and envelope depend on the operation." }, "2XX": { "description": "Successful JSON response", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/synckhub_server.routes.mail.archive.SaveArchivedAttachmentToExistingFileResponse" } } } } }, "requestBody": { "required": true, "content": { "application/json": { "schema": { "$ref": "#/components/schemas/synckhub_server.routes.mail.archive.SaveArchivedAttachmentToExistingFileRequest" } } } } } }, "/v1/repos/{repo_id}/mail/archived-emails/{email_item_id}/attachments/save-to-synck": { "post": { "operationId": "platform_post__v1_repos__repo_id__mail_archived_emails__email_item_id__attachments_save_to_synck", "summary": "save archived attachments to synck", "tags": [ "mail · archive" ], "parameters": [ { "name": "repo_id", "in": "path", "required": true, "schema": { "type": "string" } }, { "name": "email_item_id", "in": "path", "required": true, "schema": { "type": "string" } } ], "description": "Authorization and validation are enforced by the owning service.", "x-handler": "save_archived_attachments_to_synck", "x-source-file": "crates/synckhub-server/src/routes/mail/archive.rs", "x-source-line": 100, "responses": { "default": { "description": "Service response. Error status and envelope depend on the operation." }, "2XX": { "description": "Successful JSON response", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/synckhub_server.routes.mail.archive.SaveArchivedAttachmentsResponse" } } } } }, "requestBody": { "required": true, "content": { "application/json": { "schema": { "$ref": "#/components/schemas/synckhub_server.routes.mail.archive.SaveArchivedAttachmentsRequest" } } } } } }, "/v1/repos/{repo_id}/mail/archived-emails/{email_item_id}/inline-images/{inline_image_id}": { "get": { "operationId": "platform_get__v1_repos__repo_id__mail_archived_emails__email_item_id__inline_images__inline_image_id_", "summary": "download archived inline image", "tags": [ "mail · archive" ], "parameters": [ { "name": "repo_id", "in": "path", "required": true, "schema": { "type": "string" } }, { "name": "email_item_id", "in": "path", "required": true, "schema": { "type": "string" } }, { "name": "inline_image_id", "in": "path", "required": true, "schema": { "type": "string" } } ], "description": "Authorization and validation are enforced by the owning service.", "x-handler": "download_archived_inline_image", "x-source-file": "crates/synckhub-server/src/routes/mail/archive.rs", "x-source-line": 100, "responses": { "default": { "description": "Service response. Error status and envelope depend on the operation." } } }, "head": { "operationId": "platform_head__v1_repos__repo_id__mail_archived_emails__email_item_id__inline_images__inline_image_id_", "summary": "download archived inline image", "tags": [ "mail · archive" ], "parameters": [ { "name": "repo_id", "in": "path", "required": true, "schema": { "type": "string" } }, { "name": "email_item_id", "in": "path", "required": true, "schema": { "type": "string" } }, { "name": "inline_image_id", "in": "path", "required": true, "schema": { "type": "string" } } ], "description": "Authorization and validation are enforced by the owning service.\n\nHEAD uses the GET handler and headers without a response body.", "x-handler": "download_archived_inline_image", "x-source-file": "crates/synckhub-server/src/routes/mail/archive.rs", "x-source-line": 100, "x-implicit-head": true, "responses": { "default": { "description": "Service response. Error status and envelope depend on the operation." } } } }, "/v1/repos/{repo_id}/mail/archived-emails/{email_item_id}/raw-rfc822": { "get": { "operationId": "platform_get__v1_repos__repo_id__mail_archived_emails__email_item_id__raw_rfc822", "summary": "download archived email raw rfc822", "tags": [ "mail · archive" ], "parameters": [ { "name": "repo_id", "in": "path", "required": true, "schema": { "type": "string" } }, { "name": "email_item_id", "in": "path", "required": true, "schema": { "type": "string" } } ], "description": "Authorization and validation are enforced by the owning service.", "x-handler": "download_archived_email_raw_rfc822", "x-source-file": "crates/synckhub-server/src/routes/mail/archive.rs", "x-source-line": 100, "responses": { "default": { "description": "Service response. Error status and envelope depend on the operation." } } }, "head": { "operationId": "platform_head__v1_repos__repo_id__mail_archived_emails__email_item_id__raw_rfc822", "summary": "download archived email raw rfc822", "tags": [ "mail · archive" ], "parameters": [ { "name": "repo_id", "in": "path", "required": true, "schema": { "type": "string" } }, { "name": "email_item_id", "in": "path", "required": true, "schema": { "type": "string" } } ], "description": "Authorization and validation are enforced by the owning service.\n\nHEAD uses the GET handler and headers without a response body.", "x-handler": "download_archived_email_raw_rfc822", "x-source-file": "crates/synckhub-server/src/routes/mail/archive.rs", "x-source-line": 100, "x-implicit-head": true, "responses": { "default": { "description": "Service response. Error status and envelope depend on the operation." } } } }, "/v1/repos/{repo_id}/mail/archived-emails/{email_item_id}/read-state": { "put": { "operationId": "platform_put__v1_repos__repo_id__mail_archived_emails__email_item_id__read_state", "summary": "set archived email read state", "tags": [ "mail · archive" ], "parameters": [ { "name": "repo_id", "in": "path", "required": true, "schema": { "type": "string" } }, { "name": "email_item_id", "in": "path", "required": true, "schema": { "type": "string" } } ], "description": "Authorization and validation are enforced by the owning service.", "x-handler": "set_archived_email_read_state", "x-source-file": "crates/synckhub-server/src/routes/mail/archive.rs", "x-source-line": 100, "responses": { "default": { "description": "Service response. Error status and envelope depend on the operation." } }, "requestBody": { "required": true, "content": { "application/json": { "schema": { "$ref": "#/components/schemas/synckhub_server.routes.mail.archive.EmailReadState" } } } } } }, "/v1/repos/{repo_id}/mail/archived-emails/{email_item_id}/source": { "get": { "operationId": "platform_get__v1_repos__repo_id__mail_archived_emails__email_item_id__source", "summary": "download archived email source", "tags": [ "mail · archive" ], "parameters": [ { "name": "repo_id", "in": "path", "required": true, "schema": { "type": "string" } }, { "name": "email_item_id", "in": "path", "required": true, "schema": { "type": "string" } } ], "description": "Authorization and validation are enforced by the owning service.", "x-handler": "download_archived_email_source", "x-source-file": "crates/synckhub-server/src/routes/mail/archive.rs", "x-source-line": 100, "responses": { "default": { "description": "Service response. Error status and envelope depend on the operation." } } }, "head": { "operationId": "platform_head__v1_repos__repo_id__mail_archived_emails__email_item_id__source", "summary": "download archived email source", "tags": [ "mail · archive" ], "parameters": [ { "name": "repo_id", "in": "path", "required": true, "schema": { "type": "string" } }, { "name": "email_item_id", "in": "path", "required": true, "schema": { "type": "string" } } ], "description": "Authorization and validation are enforced by the owning service.\n\nHEAD uses the GET handler and headers without a response body.", "x-handler": "download_archived_email_source", "x-source-file": "crates/synckhub-server/src/routes/mail/archive.rs", "x-source-line": 100, "x-implicit-head": true, "responses": { "default": { "description": "Service response. Error status and envelope depend on the operation." } } } }, "/v1/repos/{repo_id}/mail/archived-emails/detail": { "post": { "operationId": "platform_post__v1_repos__repo_id__mail_archived_emails_detail", "summary": "post archived email detail", "tags": [ "mail · archive" ], "parameters": [ { "name": "repo_id", "in": "path", "required": true, "schema": { "type": "string" } } ], "description": "Authorization and validation are enforced by the owning service.", "x-handler": "post_archived_email_detail", "x-source-file": "crates/synckhub-server/src/routes/mail/archive.rs", "x-source-line": 100, "responses": { "default": { "description": "Service response. Error status and envelope depend on the operation." }, "2XX": { "description": "Successful JSON response", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/synckhub_server.routes.mail.archive.ArchivedEmailDetailResponse" } } } } }, "requestBody": { "required": true, "content": { "application/json": { "schema": { "$ref": "#/components/schemas/synckhub_server.routes.mail.archive.ArchivedEmailDetailRequest" } } } } } }, "/v1/repos/{repo_id}/mail/threads/{thread_id}": { "get": { "operationId": "platform_get__v1_repos__repo_id__mail_threads__thread_id_", "summary": "get archived email thread", "tags": [ "mail · archive" ], "parameters": [ { "name": "repo_id", "in": "path", "required": true, "schema": { "type": "string" } }, { "name": "thread_id", "in": "path", "required": true, "schema": { "type": "string" } }, { "name": "account_id", "in": "query", "required": true, "schema": { "type": "string", "format": "uuid" } }, { "name": "limit", "in": "query", "required": false, "schema": { "type": "integer", "minimum": 0 } }, { "name": "page_token", "in": "query", "required": false, "schema": { "anyOf": [ { "type": "string" }, { "type": "null" } ] } } ], "description": "Authorization and validation are enforced by the owning service.", "x-handler": "get_archived_email_thread", "x-source-file": "crates/synckhub-server/src/routes/mail/archive.rs", "x-source-line": 100, "responses": { "default": { "description": "Service response. Error status and envelope depend on the operation." }, "2XX": { "description": "Successful JSON response", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/synckhub_mailcal.types.ThreadView" } } } } } }, "head": { "operationId": "platform_head__v1_repos__repo_id__mail_threads__thread_id_", "summary": "get archived email thread", "tags": [ "mail · archive" ], "parameters": [ { "name": "repo_id", "in": "path", "required": true, "schema": { "type": "string" } }, { "name": "thread_id", "in": "path", "required": true, "schema": { "type": "string" } }, { "name": "account_id", "in": "query", "required": true, "schema": { "type": "string", "format": "uuid" } }, { "name": "limit", "in": "query", "required": false, "schema": { "type": "integer", "minimum": 0 } }, { "name": "page_token", "in": "query", "required": false, "schema": { "anyOf": [ { "type": "string" }, { "type": "null" } ] } } ], "description": "Authorization and validation are enforced by the owning service.\n\nHEAD uses the GET handler and headers without a response body.", "x-handler": "get_archived_email_thread", "x-source-file": "crates/synckhub-server/src/routes/mail/archive.rs", "x-source-line": 100, "x-implicit-head": true, "responses": { "default": { "description": "Service response. Error status and envelope depend on the operation." } } } }, "/v1/rtc/livekit/decline/{call_link_token}": { "post": { "operationId": "platform_post__v1_rtc_livekit_decline__call_link_token_", "summary": "decline livekit call", "tags": [ "livekit" ], "parameters": [ { "name": "call_link_token", "in": "path", "required": true, "schema": { "type": "string" } } ], "description": "Authorization and validation are enforced by the owning service.", "x-handler": "decline_livekit_call", "x-source-file": "crates/synckhub-server/src/routes/livekit.rs", "x-source-line": 29, "responses": { "default": { "description": "Platform error; branch on HTTP status and stable code, not the human-readable message.", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } } }, "2XX": { "description": "Successful JSON response", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/synckhub_server.routes.livekit.LivekitCallStatusResponse" } } } } } } }, "/v1/rtc/livekit/end/{call_link_token}": { "post": { "operationId": "platform_post__v1_rtc_livekit_end__call_link_token_", "summary": "end livekit call", "tags": [ "livekit" ], "parameters": [ { "name": "call_link_token", "in": "path", "required": true, "schema": { "type": "string" } } ], "description": "Authorization and validation are enforced by the owning service.", "x-handler": "end_livekit_call", "x-source-file": "crates/synckhub-server/src/routes/livekit.rs", "x-source-line": 29, "responses": { "default": { "description": "Platform error; branch on HTTP status and stable code, not the human-readable message.", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } } }, "2XX": { "description": "Successful JSON response", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/synckhub_server.routes.livekit.LivekitCallStatusResponse" } } } } } } }, "/v1/rtc/livekit/join/{call_link_token}": { "post": { "operationId": "platform_post__v1_rtc_livekit_join__call_link_token_", "summary": "join livekit call", "tags": [ "livekit" ], "parameters": [ { "name": "call_link_token", "in": "path", "required": true, "schema": { "type": "string" } } ], "description": "Authorization and validation are enforced by the owning service.", "x-handler": "join_livekit_call", "x-source-file": "crates/synckhub-server/src/routes/livekit.rs", "x-source-line": 29, "responses": { "default": { "description": "Platform error; branch on HTTP status and stable code, not the human-readable message.", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } } }, "2XX": { "description": "Successful JSON response", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/synckhub_server.rtc_livekit.LivekitJoinTokenResponse" } } } } }, "requestBody": { "required": true, "content": { "application/json": { "schema": { "$ref": "#/components/schemas/synckhub_server.routes.livekit.JoinLivekitCallRequest" } } } } } }, "/v1/rtc/livekit/leave/{call_link_token}": { "post": { "operationId": "platform_post__v1_rtc_livekit_leave__call_link_token_", "summary": "leave livekit call", "tags": [ "livekit" ], "parameters": [ { "name": "call_link_token", "in": "path", "required": true, "schema": { "type": "string" } } ], "description": "Authorization and validation are enforced by the owning service.", "x-handler": "leave_livekit_call", "x-source-file": "crates/synckhub-server/src/routes/livekit.rs", "x-source-line": 29, "responses": { "default": { "description": "Platform error; branch on HTTP status and stable code, not the human-readable message.", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } } }, "2XX": { "description": "Successful JSON response", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/synckhub_server.routes.livekit.LivekitCallStatusResponse" } } } } } } }, "/v1/rtc/livekit/native-lifecycle": { "get": { "operationId": "platform_get__v1_rtc_livekit_native_lifecycle", "summary": "native livekit call lifecycle", "tags": [ "livekit" ], "parameters": [], "description": "Authorization and validation are enforced by the owning service.\n\nThis route does not require the normal user bearer session. Link/download tokens, OAuth state, or webhook verification are validated by its handler where applicable.", "x-handler": "native_livekit_call_lifecycle", "x-source-file": "crates/synckhub-server/src/routes/livekit.rs", "x-source-line": 29, "responses": { "default": { "description": "Platform error; branch on HTTP status and stable code, not the human-readable message.", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } } } }, "security": [] }, "head": { "operationId": "platform_head__v1_rtc_livekit_native_lifecycle", "summary": "native livekit call lifecycle", "tags": [ "livekit" ], "parameters": [], "description": "Authorization and validation are enforced by the owning service.\n\nHEAD uses the GET handler and headers without a response body.", "x-handler": "native_livekit_call_lifecycle", "x-source-file": "crates/synckhub-server/src/routes/livekit.rs", "x-source-line": 29, "x-implicit-head": true, "responses": { "default": { "description": "Platform error; branch on HTTP status and stable code, not the human-readable message." } } } }, "/v1/rtc/livekit/status/{call_link_token}": { "post": { "operationId": "platform_post__v1_rtc_livekit_status__call_link_token_", "summary": "get livekit call status", "tags": [ "livekit" ], "parameters": [ { "name": "call_link_token", "in": "path", "required": true, "schema": { "type": "string" } } ], "description": "Authorization and validation are enforced by the owning service.", "x-handler": "get_livekit_call_status", "x-source-file": "crates/synckhub-server/src/routes/livekit.rs", "x-source-line": 29, "responses": { "default": { "description": "Platform error; branch on HTTP status and stable code, not the human-readable message.", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } } }, "2XX": { "description": "Successful JSON response", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/synckhub_server.routes.livekit.LivekitCallStatusResponse" } } } } } } }, "/v1/rtc/native-lifecycle": { "get": { "operationId": "platform_get__v1_rtc_native_lifecycle", "summary": "native canonical call lifecycle", "tags": [ "rtc" ], "parameters": [], "description": "Authorization and validation are enforced by the owning service.\n\nThis route does not require the normal user bearer session. Link/download tokens, OAuth state, or webhook verification are validated by its handler where applicable.", "x-handler": "super::livekit::native_canonical_call_lifecycle", "x-source-file": "crates/synckhub-server/src/routes/rtc.rs", "x-source-line": 15, "responses": { "default": { "description": "Platform error; branch on HTTP status and stable code, not the human-readable message.", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } } } }, "security": [] }, "head": { "operationId": "platform_head__v1_rtc_native_lifecycle", "summary": "native canonical call lifecycle", "tags": [ "rtc" ], "parameters": [], "description": "Authorization and validation are enforced by the owning service.\n\nHEAD uses the GET handler and headers without a response body.", "x-handler": "super::livekit::native_canonical_call_lifecycle", "x-source-file": "crates/synckhub-server/src/routes/rtc.rs", "x-source-line": 15, "x-implicit-head": true, "responses": { "default": { "description": "Platform error; branch on HTTP status and stable code, not the human-readable message." } } } }, "/v1/self-hosted/auth/bootstrap": { "post": { "operationId": "platform_post__v1_self_hosted_auth_bootstrap", "summary": "password bootstrap", "tags": [ "self_hosted_auth" ], "parameters": [], "description": "Authorization and validation are enforced by the owning service.", "x-handler": "password_bootstrap", "x-source-file": "crates/synckhub-server/src/self_hosted_auth.rs", "x-source-line": 2784, "responses": { "default": { "description": "Service response. Error status and envelope depend on the operation." } }, "requestBody": { "required": true, "content": { "application/json": { "schema": { "$ref": "#/components/schemas/synckhub_server.self_hosted_auth.CapabilityPasswordBody" } } } }, "security": [] } }, "/v1/self-hosted/auth/login": { "post": { "operationId": "platform_post__v1_self_hosted_auth_login", "summary": "password login", "tags": [ "self_hosted_auth" ], "parameters": [], "description": "Authorization and validation are enforced by the owning service.", "x-handler": "password_login", "x-source-file": "crates/synckhub-server/src/self_hosted_auth.rs", "x-source-line": 2784, "responses": { "default": { "description": "Service response. Error status and envelope depend on the operation." } }, "requestBody": { "required": true, "content": { "application/json": { "schema": { "$ref": "#/components/schemas/synckhub_server.self_hosted_auth.LoginBody" } } } }, "security": [] } }, "/v1/self-hosted/auth/logout": { "post": { "operationId": "platform_post__v1_self_hosted_auth_logout", "summary": "logout", "tags": [ "self_hosted_auth" ], "parameters": [], "description": "Authorization and validation are enforced by the owning service.", "x-handler": "logout", "x-source-file": "crates/synckhub-server/src/self_hosted_auth.rs", "x-source-line": 2784, "responses": { "default": { "description": "Service response. Error status and envelope depend on the operation." } }, "security": [] } }, "/v1/self-hosted/auth/password": { "post": { "operationId": "platform_post__v1_self_hosted_auth_password", "summary": "change password", "tags": [ "self_hosted_auth" ], "parameters": [], "description": "Authorization and validation are enforced by the owning service.", "x-handler": "change_password", "x-source-file": "crates/synckhub-server/src/self_hosted_auth.rs", "x-source-line": 2813, "responses": { "default": { "description": "Service response. Error status and envelope depend on the operation." } }, "requestBody": { "required": true, "content": { "application/json": { "schema": { "$ref": "#/components/schemas/synckhub_server.self_hosted_auth.ChangePasswordBody" } } } } } }, "/v1/self-hosted/auth/password-reset": { "post": { "operationId": "platform_post__v1_self_hosted_auth_password_reset", "summary": "password reset", "tags": [ "self_hosted_auth" ], "parameters": [], "description": "Authorization and validation are enforced by the owning service.", "x-handler": "password_reset", "x-source-file": "crates/synckhub-server/src/self_hosted_auth.rs", "x-source-line": 2784, "responses": { "default": { "description": "Service response. Error status and envelope depend on the operation." } }, "requestBody": { "required": true, "content": { "application/json": { "schema": { "$ref": "#/components/schemas/synckhub_server.self_hosted_auth.CapabilityPasswordBody" } } } }, "security": [] } }, "/v1/self-hosted/auth/refresh": { "post": { "operationId": "platform_post__v1_self_hosted_auth_refresh", "summary": "refresh", "tags": [ "self_hosted_auth" ], "parameters": [], "description": "Authorization and validation are enforced by the owning service.", "x-handler": "refresh", "x-source-file": "crates/synckhub-server/src/self_hosted_auth.rs", "x-source-line": 2784, "responses": { "default": { "description": "Service response. Error status and envelope depend on the operation." } }, "security": [] } }, "/v1/self-hosted/entitlement/refresh": { "post": { "operationId": "platform_post__v1_self_hosted_entitlement_refresh", "summary": "refresh entitlement", "tags": [ "self_hosted_auth" ], "parameters": [], "description": "Authorization and validation are enforced by the owning service.", "x-handler": "refresh_entitlement", "x-source-file": "crates/synckhub-server/src/self_hosted_auth.rs", "x-source-line": 2813, "responses": { "default": { "description": "Service response. Error status and envelope depend on the operation." } } } }, "/v1/self-hosted/invitations": { "post": { "operationId": "platform_post__v1_self_hosted_invitations", "summary": "create invitation", "tags": [ "self_hosted_auth" ], "parameters": [], "description": "Authorization and validation are enforced by the owning service.", "x-handler": "create_invitation", "x-source-file": "crates/synckhub-server/src/self_hosted_auth.rs", "x-source-line": 2813, "responses": { "default": { "description": "Service response. Error status and envelope depend on the operation." } }, "requestBody": { "required": true, "content": { "application/json": { "schema": { "$ref": "#/components/schemas/synckhub_server.self_hosted_auth.CreateInvitationBody" } } } } }, "get": { "operationId": "platform_get__v1_self_hosted_invitations", "summary": "list invitations", "tags": [ "self_hosted_auth" ], "parameters": [], "description": "Authorization and validation are enforced by the owning service.", "x-handler": "list_invitations", "x-source-file": "crates/synckhub-server/src/self_hosted_auth.rs", "x-source-line": 2813, "responses": { "default": { "description": "Service response. Error status and envelope depend on the operation." } } }, "head": { "operationId": "platform_head__v1_self_hosted_invitations", "summary": "list invitations", "tags": [ "self_hosted_auth" ], "parameters": [], "description": "Authorization and validation are enforced by the owning service.\n\nHEAD uses the GET handler and headers without a response body.", "x-handler": "list_invitations", "x-source-file": "crates/synckhub-server/src/self_hosted_auth.rs", "x-source-line": 2813, "x-implicit-head": true, "responses": { "default": { "description": "Service response. Error status and envelope depend on the operation." } } } }, "/v1/self-hosted/invitations/{invitation_id}/revoke": { "post": { "operationId": "platform_post__v1_self_hosted_invitations__invitation_id__revoke", "summary": "revoke invitation", "tags": [ "self_hosted_auth" ], "parameters": [ { "name": "invitation_id", "in": "path", "required": true, "schema": { "type": "string", "format": "uuid" } } ], "description": "Authorization and validation are enforced by the owning service.", "x-handler": "revoke_invitation", "x-source-file": "crates/synckhub-server/src/self_hosted_auth.rs", "x-source-line": 2813, "responses": { "default": { "description": "Service response. Error status and envelope depend on the operation." } } } }, "/v1/self-hosted/invitations/verification/finish": { "post": { "operationId": "platform_post__v1_self_hosted_invitations_verification_finish", "summary": "password invite finish", "tags": [ "self_hosted_auth" ], "parameters": [], "description": "Authorization and validation are enforced by the owning service.", "x-handler": "password_invite_finish", "x-source-file": "crates/synckhub-server/src/self_hosted_auth.rs", "x-source-line": 2784, "responses": { "default": { "description": "Service response. Error status and envelope depend on the operation." } }, "requestBody": { "required": true, "content": { "application/json": { "schema": { "$ref": "#/components/schemas/synckhub_server.self_hosted_auth.InviteVerificationFinishBody" } } } }, "security": [] } }, "/v1/self-hosted/invitations/verification/start": { "post": { "operationId": "platform_post__v1_self_hosted_invitations_verification_start", "summary": "invite verification start", "tags": [ "self_hosted_auth" ], "parameters": [], "description": "Authorization and validation are enforced by the owning service.", "x-handler": "invite_verification_start", "x-source-file": "crates/synckhub-server/src/self_hosted_auth.rs", "x-source-line": 2784, "responses": { "default": { "description": "Service response. Error status and envelope depend on the operation." } }, "requestBody": { "required": true, "content": { "application/json": { "schema": { "$ref": "#/components/schemas/synckhub_server.self_hosted_auth.InviteVerificationBody" } } } }, "security": [] } }, "/v1/self-hosted/members": { "get": { "operationId": "platform_get__v1_self_hosted_members", "summary": "list members", "tags": [ "self_hosted_auth" ], "parameters": [], "description": "Authorization and validation are enforced by the owning service.", "x-handler": "list_members", "x-source-file": "crates/synckhub-server/src/self_hosted_auth.rs", "x-source-line": 2813, "responses": { "default": { "description": "Service response. Error status and envelope depend on the operation." } } }, "head": { "operationId": "platform_head__v1_self_hosted_members", "summary": "list members", "tags": [ "self_hosted_auth" ], "parameters": [], "description": "Authorization and validation are enforced by the owning service.\n\nHEAD uses the GET handler and headers without a response body.", "x-handler": "list_members", "x-source-file": "crates/synckhub-server/src/self_hosted_auth.rs", "x-source-line": 2813, "x-implicit-head": true, "responses": { "default": { "description": "Service response. Error status and envelope depend on the operation." } } } }, "/v1/self-hosted/members/{user_id}": { "post": { "operationId": "platform_post__v1_self_hosted_members__user_id_", "summary": "update member", "tags": [ "self_hosted_auth" ], "parameters": [ { "name": "user_id", "in": "path", "required": true, "schema": { "type": "string", "format": "uuid" } } ], "description": "Authorization and validation are enforced by the owning service.", "x-handler": "update_member", "x-source-file": "crates/synckhub-server/src/self_hosted_auth.rs", "x-source-line": 2813, "responses": { "default": { "description": "Service response. Error status and envelope depend on the operation." } }, "requestBody": { "required": true, "content": { "application/json": { "schema": { "$ref": "#/components/schemas/synckhub_server.self_hosted_auth.MemberStateBody" } } } } } }, "/v1/self-hosted/members/{user_id}/password-reset": { "post": { "operationId": "platform_post__v1_self_hosted_members__user_id__password_reset", "summary": "issue password reset", "tags": [ "self_hosted_auth" ], "parameters": [ { "name": "user_id", "in": "path", "required": true, "schema": { "type": "string", "format": "uuid" } } ], "description": "Authorization and validation are enforced by the owning service.", "x-handler": "issue_password_reset", "x-source-file": "crates/synckhub-server/src/self_hosted_auth.rs", "x-source-line": 2813, "responses": { "default": { "description": "Service response. Error status and envelope depend on the operation." } } } }, "/v1/self-hosted/members/{user_id}/retry-common-sync": { "post": { "operationId": "platform_post__v1_self_hosted_members__user_id__retry_common_sync", "summary": "retry member sync", "tags": [ "self_hosted_auth" ], "parameters": [ { "name": "user_id", "in": "path", "required": true, "schema": { "type": "string", "format": "uuid" } } ], "description": "Authorization and validation are enforced by the owning service.", "x-handler": "retry_member_sync", "x-source-file": "crates/synckhub-server/src/self_hosted_auth.rs", "x-source-line": 2813, "responses": { "default": { "description": "Service response. Error status and envelope depend on the operation." } } } }, "/v1/self-hosted/members/free-baseline": { "post": { "operationId": "platform_post__v1_self_hosted_members_free_baseline", "summary": "replace free baseline", "tags": [ "self_hosted_auth" ], "parameters": [], "description": "Authorization and validation are enforced by the owning service.", "x-handler": "replace_free_baseline", "x-source-file": "crates/synckhub-server/src/self_hosted_auth.rs", "x-source-line": 2813, "responses": { "default": { "description": "Service response. Error status and envelope depend on the operation." } }, "requestBody": { "required": true, "content": { "application/json": { "schema": { "$ref": "#/components/schemas/synckhub_server.self_hosted_auth.FreeBaselineBody" } } } } } }, "/v1/self-hosted/profile": { "get": { "operationId": "platform_get__v1_self_hosted_profile", "summary": "local profile", "tags": [ "self_hosted_auth" ], "parameters": [], "description": "Authorization and validation are enforced by the owning service.", "x-handler": "local_profile", "x-source-file": "crates/synckhub-server/src/self_hosted_auth.rs", "x-source-line": 2813, "responses": { "default": { "description": "Service response. Error status and envelope depend on the operation." } } }, "head": { "operationId": "platform_head__v1_self_hosted_profile", "summary": "local profile", "tags": [ "self_hosted_auth" ], "parameters": [], "description": "Authorization and validation are enforced by the owning service.\n\nHEAD uses the GET handler and headers without a response body.", "x-handler": "local_profile", "x-source-file": "crates/synckhub-server/src/self_hosted_auth.rs", "x-source-line": 2813, "x-implicit-head": true, "responses": { "default": { "description": "Service response. Error status and envelope depend on the operation." } } } }, "/v1/sessions": { "post": { "operationId": "platform_post__v1_sessions", "summary": "create session handler", "tags": [ "command_runner" ], "parameters": [], "description": "Authorization and validation are enforced by the owning service.", "x-handler": "crate::command_runner::create_session_handler", "x-source-file": "crates/synckhub-server/src/routes/command_runner.rs", "x-source-line": 11, "responses": { "default": { "description": "Service response. Error status and envelope depend on the operation." } }, "requestBody": { "required": true, "content": { "application/json": { "schema": { "$ref": "#/components/schemas/synckhub_server.command_runner.CreateSessionRequest" } } } } } }, "/v1/sessions/{session_id}/cancel": { "post": { "operationId": "platform_post__v1_sessions__session_id__cancel", "summary": "cancel handler", "tags": [ "command_runner" ], "parameters": [ { "name": "session_id", "in": "path", "required": true, "schema": { "type": "string" } } ], "description": "Authorization and validation are enforced by the owning service.", "x-handler": "crate::command_runner::cancel_handler", "x-source-file": "crates/synckhub-server/src/routes/command_runner.rs", "x-source-line": 11, "responses": { "default": { "description": "Service response. Error status and envelope depend on the operation." } } } }, "/v1/sessions/{session_id}/events": { "get": { "operationId": "platform_get__v1_sessions__session_id__events", "summary": "sse events handler", "tags": [ "command_runner" ], "parameters": [ { "name": "session_id", "in": "path", "required": true, "schema": { "type": "string" } } ], "description": "Authorization and validation are enforced by the owning service.", "x-handler": "crate::command_runner::sse_events_handler", "x-source-file": "crates/synckhub-server/src/routes/command_runner.rs", "x-source-line": 11, "responses": { "default": { "description": "Service response. Error status and envelope depend on the operation." } } }, "head": { "operationId": "platform_head__v1_sessions__session_id__events", "summary": "sse events handler", "tags": [ "command_runner" ], "parameters": [ { "name": "session_id", "in": "path", "required": true, "schema": { "type": "string" } } ], "description": "Authorization and validation are enforced by the owning service.\n\nHEAD uses the GET handler and headers without a response body.", "x-handler": "crate::command_runner::sse_events_handler", "x-source-file": "crates/synckhub-server/src/routes/command_runner.rs", "x-source-line": 11, "x-implicit-head": true, "responses": { "default": { "description": "Service response. Error status and envelope depend on the operation." } } } }, "/v1/sessions/{session_id}/line": { "post": { "operationId": "platform_post__v1_sessions__session_id__line", "summary": "line handler", "tags": [ "command_runner" ], "parameters": [ { "name": "session_id", "in": "path", "required": true, "schema": { "type": "string" } } ], "description": "Authorization and validation are enforced by the owning service.", "x-handler": "crate::command_runner::line_handler", "x-source-file": "crates/synckhub-server/src/routes/command_runner.rs", "x-source-line": 11, "responses": { "default": { "description": "Service response. Error status and envelope depend on the operation." } }, "requestBody": { "required": true, "content": { "application/json": { "schema": { "$ref": "#/components/schemas/synckhub_server.command_runner.LineRequest" } } } } } }, "/v1/tenants/{tenant_id}/ai/openai-models": { "put": { "operationId": "platform_put__v1_tenants__tenant_id__ai_openai_models", "summary": "Configure company OpenAI models and reasoning", "tags": [ "ai · assistants" ], "parameters": [ { "name": "tenant_id", "in": "path", "required": true, "schema": { "type": "string" } } ], "description": "Requires tenant OWNER, SECURITY_ADMIN, or platform administrator. Replaces the complete company policy after a fresh authenticated catalog read.", "x-handler": "openai_models::put_company_models", "x-source-file": "crates/synckhub-server/src/routes/ai/assistants.rs", "x-source-line": 12, "responses": { "200": { "description": "Company OpenAI configuration", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/AiOpenAiModels" } } } } }, "requestBody": { "required": true, "content": { "application/json": { "schema": { "$ref": "#/components/schemas/AiOpenAiModels" } } } } }, "get": { "operationId": "platform_get__v1_tenants__tenant_id__ai_openai_models", "summary": "Discover company OpenAI models and reasoning policy", "tags": [ "ai · assistants" ], "parameters": [ { "name": "tenant_id", "in": "path", "required": true, "schema": { "type": "string" } } ], "description": "Requires tenant OWNER, SECURITY_ADMIN, or platform administrator. Uses the active company key and returns only models within the operator-reviewed ceiling.", "x-handler": "openai_models::get_company_models", "x-source-file": "crates/synckhub-server/src/routes/ai/assistants.rs", "x-source-line": 12, "responses": { "200": { "description": "Company OpenAI catalog and configuration", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/AiOpenAiCatalog" } } } } } }, "head": { "operationId": "platform_head__v1_tenants__tenant_id__ai_openai_models", "summary": "get company models", "tags": [ "ai · assistants" ], "parameters": [ { "name": "tenant_id", "in": "path", "required": true, "schema": { "type": "string" } } ], "description": "Authorization and validation are enforced by the owning service.\n\nHEAD uses the GET handler and headers without a response body.", "x-handler": "openai_models::get_company_models", "x-source-file": "crates/synckhub-server/src/routes/ai/assistants.rs", "x-source-line": 12, "x-implicit-head": true, "responses": { "default": { "description": "Platform error; branch on HTTP status and stable code, not the human-readable message." } } } }, "/v1/tenants/{tenant_id}/ai/openrouter-models": { "put": { "operationId": "platform_put__v1_tenants__tenant_id__ai_openrouter_models", "summary": "Configure company OpenRouter models", "tags": [ "ai · assistants" ], "parameters": [ { "name": "tenant_id", "in": "path", "required": true, "schema": { "type": "string" } } ], "description": "Requires tenant OWNER, SECURITY_ADMIN, or platform administrator. Company key and model selection are independent.", "x-handler": "model_catalog::put_company_models", "x-source-file": "crates/synckhub-server/src/routes/ai/assistants.rs", "x-source-line": 12, "responses": { "200": { "description": "Company model configuration", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/AiOpenRouterModels" } } } } }, "requestBody": { "required": true, "content": { "application/json": { "schema": { "$ref": "#/components/schemas/AiOpenRouterModels" } } } } }, "get": { "operationId": "platform_get__v1_tenants__tenant_id__ai_openrouter_models", "summary": "Discover company OpenRouter models", "tags": [ "ai · assistants" ], "parameters": [ { "name": "tenant_id", "in": "path", "required": true, "schema": { "type": "string" } } ], "description": "Requires tenant OWNER, SECURITY_ADMIN, or platform administrator. Company key and model selection are independent.", "x-handler": "model_catalog::get_company_models", "x-source-file": "crates/synckhub-server/src/routes/ai/assistants.rs", "x-source-line": 12, "responses": { "200": { "description": "Company model catalog and configuration", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/AiOpenRouterCatalog" } } } } } }, "head": { "operationId": "platform_head__v1_tenants__tenant_id__ai_openrouter_models", "summary": "get company models", "tags": [ "ai · assistants" ], "parameters": [ { "name": "tenant_id", "in": "path", "required": true, "schema": { "type": "string" } } ], "description": "Authorization and validation are enforced by the owning service.\n\nHEAD uses the GET handler and headers without a response body.", "x-handler": "model_catalog::get_company_models", "x-source-file": "crates/synckhub-server/src/routes/ai/assistants.rs", "x-source-line": 12, "x-implicit-head": true, "responses": { "default": { "description": "Platform error; branch on HTTP status and stable code, not the human-readable message." } } } }, "/v1/tenants/{tenant_id}/ai/provider-credentials": { "get": { "operationId": "platform_get__v1_tenants__tenant_id__ai_provider_credentials", "summary": "List tenant AI provider credential metadata", "tags": [ "ai · assistants" ], "parameters": [ { "name": "tenant_id", "in": "path", "required": true, "schema": { "type": "string" } } ], "description": "Authorization and validation are enforced by the owning service.", "x-handler": "ai_list_provider_credentials", "x-source-file": "crates/synckhub-server/src/routes/ai/assistants.rs", "x-source-line": 12, "responses": { "200": { "description": "Credential metadata list", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/AiProviderCredentialsListResponse" } } } } } }, "head": { "operationId": "platform_head__v1_tenants__tenant_id__ai_provider_credentials", "summary": "ai list provider credentials", "tags": [ "ai · assistants" ], "parameters": [ { "name": "tenant_id", "in": "path", "required": true, "schema": { "type": "string" } } ], "description": "Authorization and validation are enforced by the owning service.\n\nHEAD uses the GET handler and headers without a response body.", "x-handler": "ai_list_provider_credentials", "x-source-file": "crates/synckhub-server/src/routes/ai/assistants.rs", "x-source-line": 12, "x-implicit-head": true, "responses": { "default": { "description": "Platform error; branch on HTTP status and stable code, not the human-readable message." } } } }, "/v1/tenants/{tenant_id}/ai/provider-credentials/openai": { "delete": { "operationId": "platform_delete__v1_tenants__tenant_id__ai_provider_credentials_openai", "summary": "Revoke the active tenant OpenAI provider credential", "tags": [ "ai · assistants" ], "parameters": [ { "name": "tenant_id", "in": "path", "required": true, "schema": { "type": "string" } } ], "description": "Authorization and validation are enforced by the owning service.", "x-handler": "ai_delete_openai_provider_credential", "x-source-file": "crates/synckhub-server/src/routes/ai/assistants.rs", "x-source-line": 12, "responses": { "204": { "description": "Credential revoked or already absent" } } }, "patch": { "operationId": "platform_patch__v1_tenants__tenant_id__ai_provider_credentials_openai", "summary": "Enable or disable the active tenant OpenAI provider credential", "tags": [ "ai · assistants" ], "parameters": [ { "name": "tenant_id", "in": "path", "required": true, "schema": { "type": "string" } } ], "description": "Authorization and validation are enforced by the owning service.", "x-handler": "ai_patch_openai_provider_credential", "x-source-file": "crates/synckhub-server/src/routes/ai/assistants.rs", "x-source-line": 12, "responses": { "200": { "description": "Updated credential metadata", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/AiProviderCredentialSummary" } } } } }, "requestBody": { "required": true, "content": { "application/json": { "schema": { "$ref": "#/components/schemas/AiProviderCredentialPatchRequest" } } } } }, "put": { "operationId": "platform_put__v1_tenants__tenant_id__ai_provider_credentials_openai", "summary": "Replace the tenant OpenAI provider credential", "tags": [ "ai · assistants" ], "parameters": [ { "name": "tenant_id", "in": "path", "required": true, "schema": { "type": "string" } } ], "description": "Authorization and validation are enforced by the owning service.", "x-handler": "ai_put_openai_provider_credential", "x-source-file": "crates/synckhub-server/src/routes/ai/assistants.rs", "x-source-line": 12, "responses": { "200": { "description": "Active credential metadata", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/AiProviderCredentialSummary" } } } } }, "requestBody": { "required": true, "content": { "application/json": { "schema": { "$ref": "#/components/schemas/AiProviderCredentialPutRequest" } } } } } }, "/v1/tenants/{tenant_id}/ai/provider-credentials/openrouter": { "delete": { "operationId": "platform_delete__v1_tenants__tenant_id__ai_provider_credentials_openrouter", "summary": "Revoke the active tenant OpenRouter provider credential", "tags": [ "ai · assistants" ], "parameters": [ { "name": "tenant_id", "in": "path", "required": true, "schema": { "type": "string" } } ], "description": "Authorization and validation are enforced by the owning service.", "x-handler": "ai_delete_openrouter_provider_credential", "x-source-file": "crates/synckhub-server/src/routes/ai/assistants.rs", "x-source-line": 12, "responses": { "204": { "description": "Credential revoked or already absent" } } }, "patch": { "operationId": "platform_patch__v1_tenants__tenant_id__ai_provider_credentials_openrouter", "summary": "Enable or disable the active tenant OpenRouter provider credential", "tags": [ "ai · assistants" ], "parameters": [ { "name": "tenant_id", "in": "path", "required": true, "schema": { "type": "string" } } ], "description": "Authorization and validation are enforced by the owning service.", "x-handler": "ai_patch_openrouter_provider_credential", "x-source-file": "crates/synckhub-server/src/routes/ai/assistants.rs", "x-source-line": 12, "responses": { "200": { "description": "Updated credential metadata", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/AiProviderCredentialSummary" } } } } }, "requestBody": { "required": true, "content": { "application/json": { "schema": { "$ref": "#/components/schemas/AiProviderCredentialPatchRequest" } } } } }, "put": { "operationId": "platform_put__v1_tenants__tenant_id__ai_provider_credentials_openrouter", "summary": "Replace the tenant OpenRouter provider credential", "tags": [ "ai · assistants" ], "parameters": [ { "name": "tenant_id", "in": "path", "required": true, "schema": { "type": "string" } } ], "description": "Authorization and validation are enforced by the owning service.", "x-handler": "ai_put_openrouter_provider_credential", "x-source-file": "crates/synckhub-server/src/routes/ai/assistants.rs", "x-source-line": 12, "responses": { "200": { "description": "Active credential metadata", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/AiProviderCredentialSummary" } } } } }, "requestBody": { "required": true, "content": { "application/json": { "schema": { "$ref": "#/components/schemas/AiProviderCredentialPutRequest" } } } } } }, "/v1/uploads/bulk-file-batches": { "post": { "operationId": "platform_post__v1_uploads_bulk_file_batches", "summary": "upload bulk file batch", "tags": [ "uploads" ], "parameters": [ { "name": "Synck-Bulk-Manifest-Length", "in": "header", "required": true, "schema": { "type": "integer", "minimum": 1, "maximum": 8388608 } } ], "description": "Authorization and validation are enforced by the owning service.\n\nBinary framed batch: the first Synck-Bulk-Manifest-Length bytes contain the UTF-8 JSON BulkFileBatchManifest. The remaining bytes contain each file in manifest.files order, with exactly its declared size. This is not multipart/form-data.", "x-handler": "upload_bulk_file_batch", "x-source-file": "crates/synckhub-server/src/routes/uploads.rs", "x-source-line": 980, "responses": { "default": { "description": "Platform error; branch on HTTP status and stable code, not the human-readable message.", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } } }, "2XX": { "description": "Successful JSON response", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/synckhub_server.routes.uploads.BulkFileBatchResponse" } } } } }, "requestBody": { "required": true, "content": { "application/octet-stream": { "schema": { "type": "string", "format": "binary" } } } }, "x-bulk-manifest-schema": { "$ref": "#/components/schemas/synckhub_server.routes.uploads.BulkFileBatchManifest" } } }, "/v1/uploads/bulk-file-batches/adopt-existing": { "post": { "operationId": "platform_post__v1_uploads_bulk_file_batches_adopt_existing", "summary": "adopt existing bulk file batch", "tags": [ "uploads" ], "parameters": [], "description": "Authorization and validation are enforced by the owning service.", "x-handler": "adopt_existing_bulk_file_batch", "x-source-file": "crates/synckhub-server/src/routes/uploads.rs", "x-source-line": 980, "responses": { "default": { "description": "Platform error; branch on HTTP status and stable code, not the human-readable message.", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } } }, "2XX": { "description": "Successful JSON response", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/synckhub_server.routes.uploads.BulkFileBatchResponse" } } } } }, "requestBody": { "required": true, "content": { "application/json": { "schema": { "$ref": "#/components/schemas/synckhub_server.routes.uploads.AdoptExistingBulkFileBatchRequest" } } } } } }, "/v1/uploads/chat-attachment-intents": { "post": { "operationId": "platform_post__v1_uploads_chat_attachment_intents", "summary": "create chat attachment upload intent", "tags": [ "uploads" ], "parameters": [], "description": "Authorization and validation are enforced by the owning service.", "x-handler": "create_chat_attachment_upload_intent", "x-source-file": "crates/synckhub-server/src/routes/uploads.rs", "x-source-line": 980, "responses": { "default": { "description": "Platform error; branch on HTTP status and stable code, not the human-readable message.", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } } }, "2XX": { "description": "Successful JSON response", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/synckhub_server.routes.uploads.CreateChatAttachmentUploadIntentResponse" } } } } }, "requestBody": { "required": true, "content": { "application/json": { "schema": { "$ref": "#/components/schemas/synckhub_server.routes.uploads.CreateChatAttachmentUploadIntentRequest" } } } } } }, "/v1/uploads/chat-attachment-intents/finished": { "post": { "operationId": "platform_post__v1_uploads_chat_attachment_intents_finished", "summary": "finish chat attachment uploads", "tags": [ "uploads" ], "parameters": [], "description": "Authorization and validation are enforced by the owning service.", "x-handler": "finish_chat_attachment_uploads", "x-source-file": "crates/synckhub-server/src/routes/uploads.rs", "x-source-line": 980, "responses": { "default": { "description": "Platform error; branch on HTTP status and stable code, not the human-readable message.", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } } }, "2XX": { "description": "Successful JSON response", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/synckhub_server.routes.uploads.FinishChatAttachmentUploadsResponse" } } } } }, "requestBody": { "required": true, "content": { "application/json": { "schema": { "$ref": "#/components/schemas/synckhub_server.routes.uploads.FinishChatAttachmentUploadsRequest" } } } } } }, "/v1/uploads/chat-attachment-intents/stored/batch": { "post": { "operationId": "platform_post__v1_uploads_chat_attachment_intents_stored_batch", "summary": "store chat attachment upload intents", "tags": [ "uploads" ], "parameters": [], "description": "Authorization and validation are enforced by the owning service.", "x-handler": "store_chat_attachment_upload_intents", "x-source-file": "crates/synckhub-server/src/routes/uploads.rs", "x-source-line": 980, "responses": { "default": { "description": "Platform error; branch on HTTP status and stable code, not the human-readable message.", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } } }, "2XX": { "description": "Successful JSON response", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/synckhub_server.routes.uploads.StoreChatAttachmentUploadIntentsResponse" } } } } }, "requestBody": { "required": true, "content": { "application/json": { "schema": { "$ref": "#/components/schemas/synckhub_server.routes.uploads.StoreChatAttachmentUploadIntentsRequest" } } } } } }, "/v1/uploads/commit-sessions": { "post": { "operationId": "platform_post__v1_uploads_commit_sessions", "summary": "start upload commit session", "tags": [ "uploads" ], "parameters": [], "description": "Authorization and validation are enforced by the owning service.", "x-handler": "start_upload_commit_session", "x-source-file": "crates/synckhub-server/src/routes/uploads.rs", "x-source-line": 980, "responses": { "default": { "description": "Platform error; branch on HTTP status and stable code, not the human-readable message.", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } } }, "2XX": { "description": "Successful JSON response", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/synckhub_server.routes.uploads.StartUploadCommitSessionResponse" } } } } }, "requestBody": { "required": true, "content": { "application/json": { "schema": { "$ref": "#/components/schemas/synckhub_server.routes.uploads.StartUploadCommitSessionRequest" } } } } } }, "/v1/uploads/commit-sessions/{id}/abort": { "post": { "operationId": "platform_post__v1_uploads_commit_sessions__id__abort", "summary": "abort upload commit session", "tags": [ "uploads" ], "parameters": [ { "name": "id", "in": "path", "required": true, "schema": { "type": "string" } } ], "description": "Authorization and validation are enforced by the owning service.", "x-handler": "abort_upload_commit_session", "x-source-file": "crates/synckhub-server/src/routes/uploads.rs", "x-source-line": 980, "responses": { "default": { "description": "Platform error; branch on HTTP status and stable code, not the human-readable message.", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } } }, "2XX": { "description": "Successful JSON response", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/synckhub_server.routes.uploads.AbortUploadCommitSessionResponse" } } } } } } }, "/v1/uploads/commit-sessions/{id}/files/stored/batch": { "post": { "operationId": "platform_post__v1_uploads_commit_sessions__id__files_stored_batch", "summary": "store upload commit session files", "tags": [ "uploads" ], "parameters": [ { "name": "id", "in": "path", "required": true, "schema": { "type": "string" } } ], "description": "Authorization and validation are enforced by the owning service.", "x-handler": "store_upload_commit_session_files", "x-source-file": "crates/synckhub-server/src/routes/uploads.rs", "x-source-line": 980, "responses": { "default": { "description": "Platform error; branch on HTTP status and stable code, not the human-readable message.", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } } }, "2XX": { "description": "Successful JSON response", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/synckhub_server.routes.uploads.StoreUploadCommitSessionFilesResponse" } } } } }, "requestBody": { "required": true, "content": { "application/json": { "schema": { "$ref": "#/components/schemas/synckhub_server.routes.uploads.FinishUploadCommitSessionRequest" } } } } } }, "/v1/uploads/commit-sessions/{id}/finished": { "post": { "operationId": "platform_post__v1_uploads_commit_sessions__id__finished", "summary": "finish upload commit session", "tags": [ "uploads" ], "parameters": [ { "name": "id", "in": "path", "required": true, "schema": { "type": "string" } } ], "description": "Authorization and validation are enforced by the owning service.", "x-handler": "finish_upload_commit_session", "x-source-file": "crates/synckhub-server/src/routes/uploads.rs", "x-source-line": 980, "responses": { "default": { "description": "Platform error; branch on HTTP status and stable code, not the human-readable message.", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } } }, "2XX": { "description": "Successful JSON response", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/synckhub_server.routes.uploads.FinishUploadCommitSessionResponse" } } } } }, "requestBody": { "required": true, "content": { "application/json": { "schema": { "$ref": "#/components/schemas/synckhub_server.routes.uploads.FinishUploadCommitSessionRequest" } } } } } }, "/v1/uploads/commit-sessions/{id}/recovery/abort": { "post": { "operationId": "platform_post__v1_uploads_commit_sessions__id__recovery_abort", "summary": "abort recoverable upload commit session", "tags": [ "uploads" ], "parameters": [ { "name": "id", "in": "path", "required": true, "schema": { "type": "string" } } ], "description": "Authorization and validation are enforced by the owning service.", "x-handler": "abort_recoverable_upload_commit_session", "x-source-file": "crates/synckhub-server/src/routes/uploads.rs", "x-source-line": 980, "responses": { "default": { "description": "Platform error; branch on HTTP status and stable code, not the human-readable message.", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } } }, "2XX": { "description": "Successful JSON response", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/synckhub_server.routes.uploads.RecoverableUploadCommitSessionAbortResponse" } } } } }, "requestBody": { "required": true, "content": { "application/json": { "schema": { "$ref": "#/components/schemas/synckhub_server.routes.uploads.RecoverableUploadCommitSessionAbortRequest" } } } } } }, "/v1/uploads/commit-sessions/{id}/recovery/finished": { "post": { "operationId": "platform_post__v1_uploads_commit_sessions__id__recovery_finished", "summary": "finish recoverable upload commit session", "tags": [ "uploads" ], "parameters": [ { "name": "id", "in": "path", "required": true, "schema": { "type": "string" } } ], "description": "Authorization and validation are enforced by the owning service.", "x-handler": "finish_recoverable_upload_commit_session", "x-source-file": "crates/synckhub-server/src/routes/uploads.rs", "x-source-line": 980, "responses": { "default": { "description": "Platform error; branch on HTTP status and stable code, not the human-readable message.", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } } }, "2XX": { "description": "Successful JSON response", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/synckhub_server.routes.uploads.FinishUploadCommitSessionResponse" } } } } }, "requestBody": { "required": true, "content": { "application/json": { "schema": { "$ref": "#/components/schemas/synckhub_server.routes.uploads.FinishUploadCommitSessionRequest" } } } } } }, "/v1/uploads/commit-sessions/recovery/start": { "post": { "operationId": "platform_post__v1_uploads_commit_sessions_recovery_start", "summary": "start recoverable upload commit session", "tags": [ "uploads" ], "parameters": [], "description": "Authorization and validation are enforced by the owning service.", "x-handler": "start_recoverable_upload_commit_session", "x-source-file": "crates/synckhub-server/src/routes/uploads.rs", "x-source-line": 980, "responses": { "default": { "description": "Platform error; branch on HTTP status and stable code, not the human-readable message.", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } } }, "2XX": { "description": "Successful JSON response", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/synckhub_server.routes.uploads.StartUploadCommitSessionResponse" } } } } }, "requestBody": { "required": true, "content": { "application/json": { "schema": { "$ref": "#/components/schemas/synckhub_server.routes.uploads.StartUploadCommitSessionRequest" } } } } } }, "/v1/uploads/file-content-intents": { "post": { "operationId": "platform_post__v1_uploads_file_content_intents", "summary": "create file content upload intent", "tags": [ "uploads" ], "parameters": [ { "name": "Idempotency-Key", "in": "header", "required": false, "schema": { "type": "string", "format": "uuid" }, "description": "UUIDv7 upload intent identity. Required for bound write requests unless upload_intent_id supplies it in the body. Supply a stable UUIDv4 upload_token; retain both on retry. Different request context conflicts." } ], "description": "Authorization and validation are enforced by the owning service.\n\nSee the [file upload and revision workflows](https://synckhub.com/documentation/developers/api/file-write-workflows). Use an authorized user HTTP access JWT for the same acting principal throughout intent creation, tus transfer and finish. Community upload handlers currently require stored membership; a repo-bound API-token ADMIN claim alone does not satisfy that check. There is no universal Idempotency-Key header. This flow preserves item_id. With write metadata, admission binds expected_head_blob_id and expected_head_item_seq; completion uses atomic conditional-write and rejects stale heads or conflicting locks. Without write metadata, legacy local finalization requires an exclusive lock owned by the acting user. Optional write metadata binds SHA-256 and size; revisions also require the expected blob and sequence. Bound writes require exact retry identity and support local standalone FILEs only.", "x-handler": "create_file_content_upload_intent", "x-source-file": "crates/synckhub-server/src/routes/uploads.rs", "x-source-line": 980, "responses": { "200": { "description": "Successful JSON response", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/synckhub_server.routes.uploads.CreateFileContentUploadIntentResponse" } } } }, "400": { "description": "Invalid request or intent identifier.", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } } }, "401": { "description": "Missing or invalid HTTP access JWT.", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } } }, "403": { "description": "The principal lacks permission or does not own the intent.", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } } }, "404": { "description": "The target or intent is absent or not visible.", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } } }, "409": { "description": "Name, lifecycle, lock, or upload-state conflict; inspect the response before retrying.", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } } }, "default": { "description": "Platform error; branch on HTTP status and stable code, not the human-readable message.", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } } } }, "requestBody": { "required": true, "content": { "application/json": { "schema": { "$ref": "#/components/schemas/synckhub_server.routes.uploads.CreateFileContentUploadIntentRequest" } } } } } }, "/v1/uploads/file-content-intents/{id}/finished": { "post": { "operationId": "platform_post__v1_uploads_file_content_intents__id__finished", "summary": "finish file content upload intent", "tags": [ "uploads" ], "parameters": [ { "name": "id", "in": "path", "required": true, "schema": { "type": "string" } } ], "description": "Authorization and validation are enforced by the owning service.\n\nSee the [file upload and revision workflows](https://synckhub.com/documentation/developers/api/file-write-workflows). Use an authorized user HTTP access JWT for the same acting principal throughout intent creation, tus transfer and finish. Community upload handlers currently require stored membership; a repo-bound API-token ADMIN claim alone does not satisfy that check. There is no universal Idempotency-Key header. This flow preserves item_id. With write metadata, admission binds expected_head_blob_id and expected_head_item_seq; completion uses atomic conditional-write and rejects stale heads or conflicting locks. Without write metadata, legacy local finalization requires an exclusive lock owned by the acting user. Transfer all bytes before finishing. Retry the same intent after an uncertain response; a completed intent returns its recorded result.", "x-handler": "finish_file_content_upload_intent", "x-source-file": "crates/synckhub-server/src/routes/uploads.rs", "x-source-line": 980, "responses": { "200": { "description": "Successful JSON response", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/synckhub_server.routes.uploads.FinishFileContentUploadIntentResponse" } } } }, "400": { "description": "Invalid request or intent identifier.", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } } }, "401": { "description": "Missing or invalid HTTP access JWT.", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } } }, "403": { "description": "The principal lacks permission or does not own the intent.", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } } }, "404": { "description": "The target or intent is absent or not visible.", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } } }, "409": { "description": "Name, lifecycle, lock, or upload-state conflict; inspect the response before retrying.", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } } }, "default": { "description": "Platform error; branch on HTTP status and stable code, not the human-readable message.", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } } } } } }, "/v1/uploads/file-content-intents/{id}/finished/converted-office": { "post": { "operationId": "platform_post__v1_uploads_file_content_intents__id__finished_converted_office", "summary": "finish converted office file content upload intent", "tags": [ "uploads" ], "parameters": [ { "name": "id", "in": "path", "required": true, "schema": { "type": "string" } } ], "description": "Authorization and validation are enforced by the owning service.", "x-handler": "finish_converted_office_file_content_upload_intent", "x-source-file": "crates/synckhub-server/src/routes/uploads.rs", "x-source-line": 980, "responses": { "default": { "description": "Platform error; branch on HTTP status and stable code, not the human-readable message.", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } } }, "2XX": { "description": "Successful JSON response", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/synckhub_server.routes.uploads.FinishConvertedOfficeUploadIntentResponse" } } } } }, "requestBody": { "required": true, "content": { "application/json": { "schema": { "$ref": "#/components/schemas/synckhub_server.routes.uploads.FinishConvertedOfficeUploadIntentRequest" } } } } } }, "/v1/uploads/file-content-intents/{id}/import-finished": { "post": { "operationId": "platform_post__v1_uploads_file_content_intents__id__import_finished", "summary": "finish import file content upload intent", "tags": [ "uploads" ], "parameters": [ { "name": "id", "in": "path", "required": true, "schema": { "type": "string" } } ], "description": "Authorization and validation are enforced by the owning service.", "x-handler": "finish_import_file_content_upload_intent", "x-source-file": "crates/synckhub-server/src/routes/uploads.rs", "x-source-line": 980, "responses": { "default": { "description": "Platform error; branch on HTTP status and stable code, not the human-readable message.", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } } }, "2XX": { "description": "Successful JSON response", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/synckhub_server.routes.uploads.FinishFileContentUploadIntentResponse" } } } } }, "requestBody": { "required": true, "content": { "application/json": { "schema": { "$ref": "#/components/schemas/synckhub_server.routes.uploads.FinishImportFileContentUploadIntentRequest" } } } } } }, "/v1/uploads/file-intents": { "post": { "operationId": "platform_post__v1_uploads_file_intents", "summary": "create file upload intent", "tags": [ "uploads" ], "parameters": [ { "name": "Idempotency-Key", "in": "header", "required": false, "schema": { "type": "string", "format": "uuid" }, "description": "UUIDv7 upload intent identity. Required for bound write requests unless upload_intent_id supplies it in the body. Supply a stable UUIDv4 upload_token; retain both on retry. Different request context conflicts." } ], "description": "Authorization and validation are enforced by the owning service.\n\nSee the [file upload and revision workflows](https://synckhub.com/documentation/developers/api/file-write-workflows). Use an authorized user HTTP access JWT for the same acting principal throughout intent creation, tus transfer and finish. Community upload handlers currently require stored membership; a repo-bound API-token ADMIN claim alone does not satisfy that check. There is no universal Idempotency-Key header. Optional write metadata binds SHA-256 and size; revisions also require the expected blob and sequence. Bound writes require exact retry identity and support local standalone FILEs only.", "x-handler": "create_file_upload_intent", "x-source-file": "crates/synckhub-server/src/routes/uploads.rs", "x-source-line": 980, "responses": { "200": { "description": "Successful JSON response", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/synckhub_server.routes.uploads.CreateFileUploadIntentResponse" } } } }, "400": { "description": "Invalid request or intent identifier.", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } } }, "401": { "description": "Missing or invalid HTTP access JWT.", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } } }, "403": { "description": "The principal lacks permission or does not own the intent.", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } } }, "404": { "description": "The target or intent is absent or not visible.", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } } }, "409": { "description": "Name, lifecycle, lock, or upload-state conflict; inspect the response before retrying.", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } } }, "default": { "description": "Platform error; branch on HTTP status and stable code, not the human-readable message.", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } } } }, "requestBody": { "required": true, "content": { "application/json": { "schema": { "$ref": "#/components/schemas/synckhub_server.routes.uploads.CreateFileUploadIntentRequest" } } } } } }, "/v1/uploads/file-intents/{id}/finished": { "post": { "operationId": "platform_post__v1_uploads_file_intents__id__finished", "summary": "finish file upload intent", "tags": [ "uploads" ], "parameters": [ { "name": "id", "in": "path", "required": true, "schema": { "type": "string" } } ], "description": "Authorization and validation are enforced by the owning service.\n\nSee the [file upload and revision workflows](https://synckhub.com/documentation/developers/api/file-write-workflows). Use an authorized user HTTP access JWT for the same acting principal throughout intent creation, tus transfer and finish. Community upload handlers currently require stored membership; a repo-bound API-token ADMIN claim alone does not satisfy that check. There is no universal Idempotency-Key header. Transfer all bytes before finishing. Retry the same intent after an uncertain response; a completed intent returns its recorded result.", "x-handler": "finish_file_upload_intent", "x-source-file": "crates/synckhub-server/src/routes/uploads.rs", "x-source-line": 980, "responses": { "200": { "description": "Successful JSON response", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/synckhub_server.routes.uploads.FinishFileUploadIntentResponse" } } } }, "400": { "description": "Invalid request or intent identifier.", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } } }, "401": { "description": "Missing or invalid HTTP access JWT.", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } } }, "403": { "description": "The principal lacks permission or does not own the intent.", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } } }, "404": { "description": "The target or intent is absent or not visible.", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } } }, "409": { "description": "Name, lifecycle, lock, or upload-state conflict; inspect the response before retrying.", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } } }, "default": { "description": "Platform error; branch on HTTP status and stable code, not the human-readable message.", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } } } } } }, "/v1/uploads/file-intents/abandon/batch": { "post": { "operationId": "platform_post__v1_uploads_file_intents_abandon_batch", "summary": "abandon file upload intents", "tags": [ "uploads" ], "parameters": [], "description": "Authorization and validation are enforced by the owning service.", "x-handler": "abandon_file_upload_intents", "x-source-file": "crates/synckhub-server/src/routes/uploads.rs", "x-source-line": 980, "responses": { "default": { "description": "Platform error; branch on HTTP status and stable code, not the human-readable message.", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } } }, "2XX": { "description": "Successful JSON response", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/synckhub_server.routes.uploads.AbandonFileUploadIntentsResponse" } } } } }, "requestBody": { "required": true, "content": { "application/json": { "schema": { "$ref": "#/components/schemas/synckhub_server.routes.uploads.AbandonFileUploadIntentsRequest" } } } } } }, "/v1/uploads/file-intents/batch": { "post": { "operationId": "platform_post__v1_uploads_file_intents_batch", "summary": "batch create file upload intent", "tags": [ "uploads" ], "parameters": [], "description": "Authorization and validation are enforced by the owning service.", "x-handler": "batch_create_file_upload_intent", "x-source-file": "crates/synckhub-server/src/routes/uploads.rs", "x-source-line": 980, "responses": { "default": { "description": "Platform error; branch on HTTP status and stable code, not the human-readable message.", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } } }, "2XX": { "description": "Successful JSON response", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/synckhub_server.routes.uploads.BatchCreateFileUploadIntentResponse" } } } } }, "requestBody": { "required": true, "content": { "application/json": { "schema": { "$ref": "#/components/schemas/synckhub_server.routes.uploads.BatchCreateFileUploadIntentRequest" } } } } } }, "/v1/uploads/file-intents/finished/batch": { "post": { "operationId": "platform_post__v1_uploads_file_intents_finished_batch", "summary": "batch finish file upload intent", "tags": [ "uploads" ], "parameters": [], "description": "Authorization and validation are enforced by the owning service.", "x-handler": "batch_finish_file_upload_intent", "x-source-file": "crates/synckhub-server/src/routes/uploads.rs", "x-source-line": 980, "responses": { "default": { "description": "Platform error; branch on HTTP status and stable code, not the human-readable message.", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } } }, "2XX": { "description": "Successful JSON response", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/synckhub_server.routes.uploads.BatchFinishFileUploadIntentResponse" } } } } }, "requestBody": { "required": true, "content": { "application/json": { "schema": { "$ref": "#/components/schemas/synckhub_server.routes.uploads.BatchFinishFileUploadIntentRequest" } } } } } }, "/v1/uploads/intents/progress/batch": { "post": { "operationId": "platform_post__v1_uploads_intents_progress_batch", "summary": "batch upload intent progress", "tags": [ "uploads" ], "parameters": [], "description": "Authorization and validation are enforced by the owning service.", "x-handler": "batch_upload_intent_progress", "x-source-file": "crates/synckhub-server/src/routes/uploads.rs", "x-source-line": 980, "responses": { "default": { "description": "Platform error; branch on HTTP status and stable code, not the human-readable message.", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } } }, "2XX": { "description": "Successful JSON response", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/synckhub_server.routes.uploads.BatchUploadIntentProgressResponse" } } } } }, "requestBody": { "required": true, "content": { "application/json": { "schema": { "$ref": "#/components/schemas/synckhub_server.routes.uploads.BatchUploadIntentProgressRequest" } } } } } }, "/v1/uploads/tree-sessions": { "post": { "operationId": "platform_post__v1_uploads_tree_sessions", "summary": "start upload tree session", "tags": [ "uploads" ], "parameters": [], "description": "Authorization and validation are enforced by the owning service.", "x-handler": "start_upload_tree_session", "x-source-file": "crates/synckhub-server/src/routes/uploads.rs", "x-source-line": 980, "responses": { "default": { "description": "Platform error; branch on HTTP status and stable code, not the human-readable message.", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } } }, "2XX": { "description": "Successful JSON response", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/synckhub_uploads.tree_sessions.UploadTreeSessionStartResult" } } } } }, "requestBody": { "required": true, "content": { "application/json": { "schema": { "$ref": "#/components/schemas/synckhub_server.routes.uploads.StartUploadTreeSessionRequest" } } } } } }, "/v1/uploads/tree-sessions/{id}/files/stored/batch": { "post": { "operationId": "platform_post__v1_uploads_tree_sessions__id__files_stored_batch", "summary": "store upload tree session files", "tags": [ "uploads" ], "parameters": [ { "name": "id", "in": "path", "required": true, "schema": { "type": "string" } } ], "description": "Authorization and validation are enforced by the owning service.", "x-handler": "store_upload_tree_session_files", "x-source-file": "crates/synckhub-server/src/routes/uploads.rs", "x-source-line": 980, "responses": { "default": { "description": "Platform error; branch on HTTP status and stable code, not the human-readable message.", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } } }, "2XX": { "description": "Successful JSON response", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/synckhub_server.routes.uploads.StoreUploadTreeSessionFilesResponse" } } } } }, "requestBody": { "required": true, "content": { "application/json": { "schema": { "$ref": "#/components/schemas/synckhub_server.routes.uploads.FinishUploadTreeSessionRequest" } } } } } }, "/v1/uploads/tree-sessions/{id}/finished": { "post": { "operationId": "platform_post__v1_uploads_tree_sessions__id__finished", "summary": "finish upload tree session", "tags": [ "uploads" ], "parameters": [ { "name": "id", "in": "path", "required": true, "schema": { "type": "string" } } ], "description": "Authorization and validation are enforced by the owning service.", "x-handler": "finish_upload_tree_session", "x-source-file": "crates/synckhub-server/src/routes/uploads.rs", "x-source-line": 980, "responses": { "default": { "description": "Platform error; branch on HTTP status and stable code, not the human-readable message.", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } } }, "2XX": { "description": "Successful JSON response", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/synckhub_server.routes.uploads.FinishUploadTreeSessionResponse" } } } } }, "requestBody": { "required": true, "content": { "application/json": { "schema": { "$ref": "#/components/schemas/synckhub_server.routes.uploads.FinishUploadTreeSessionRequest" } } } } } }, "/v1/user/background-jobs/dismissal": { "put": { "operationId": "platform_put__v1_user_background_jobs_dismissal", "summary": "dismiss user background job", "tags": [ "user_runtime" ], "parameters": [], "description": "Authorization and validation are enforced by the owning service.", "x-handler": "dismiss_user_background_job", "x-source-file": "crates/synckhub-server/src/routes/user_runtime.rs", "x-source-line": 19, "responses": { "default": { "description": "Platform error; branch on HTTP status and stable code, not the human-readable message.", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } } } }, "requestBody": { "required": true, "content": { "application/json": { "schema": { "$ref": "#/components/schemas/synckhub_server.routes.maintenance.DismissUserBackgroundJobRequest" } } } } } }, "/v1/user/background-jobs/status": { "get": { "operationId": "platform_get__v1_user_background_jobs_status", "summary": "get user background jobs status", "tags": [ "user_runtime" ], "parameters": [ { "name": "kind", "in": "query", "required": false, "schema": { "anyOf": [ { "type": "string" }, { "type": "null" } ] } }, { "name": "state", "in": "query", "required": false, "schema": { "anyOf": [ { "type": "string" }, { "type": "null" } ] } }, { "name": "limit", "in": "query", "required": false, "schema": { "anyOf": [ { "type": "integer" }, { "type": "null" } ] } }, { "name": "offset", "in": "query", "required": false, "schema": { "anyOf": [ { "type": "integer" }, { "type": "null" } ] } } ], "description": "Body for batch SET_NAME operations.\n\nAuthorization and validation are enforced by the owning service.", "x-handler": "get_user_background_jobs_status", "x-source-file": "crates/synckhub-server/src/routes/user_runtime.rs", "x-source-line": 19, "responses": { "default": { "description": "Platform error; branch on HTTP status and stable code, not the human-readable message.", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } } }, "2XX": { "description": "Successful JSON response", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/synckhub_server.routes.maintenance.BackgroundJobsStatusResponse" } } } } } }, "head": { "operationId": "platform_head__v1_user_background_jobs_status", "summary": "get user background jobs status", "tags": [ "user_runtime" ], "parameters": [ { "name": "kind", "in": "query", "required": false, "schema": { "anyOf": [ { "type": "string" }, { "type": "null" } ] } }, { "name": "state", "in": "query", "required": false, "schema": { "anyOf": [ { "type": "string" }, { "type": "null" } ] } }, { "name": "limit", "in": "query", "required": false, "schema": { "anyOf": [ { "type": "integer" }, { "type": "null" } ] } }, { "name": "offset", "in": "query", "required": false, "schema": { "anyOf": [ { "type": "integer" }, { "type": "null" } ] } } ], "description": "Body for batch SET_NAME operations.\n\nAuthorization and validation are enforced by the owning service.\n\nHEAD uses the GET handler and headers without a response body.", "x-handler": "get_user_background_jobs_status", "x-source-file": "crates/synckhub-server/src/routes/user_runtime.rs", "x-source-line": 19, "x-implicit-head": true, "responses": { "default": { "description": "Platform error; branch on HTTP status and stable code, not the human-readable message." } } } }, "/v1/user/calendar-reminders/snooze": { "post": { "operationId": "platform_post__v1_user_calendar_reminders_snooze", "summary": "snooze calendar reminder", "tags": [ "user_runtime" ], "parameters": [], "description": "Authorization and validation are enforced by the owning service.", "x-handler": "snooze_calendar_reminder", "x-source-file": "crates/synckhub-server/src/routes/user_runtime.rs", "x-source-line": 19, "responses": { "default": { "description": "Platform error; branch on HTTP status and stable code, not the human-readable message.", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } } }, "2XX": { "description": "Successful JSON response", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/synckhub_server.reminder_delivery_job.CalendarSnoozeResponse" } } } } }, "requestBody": { "required": true, "content": { "application/json": { "schema": { "$ref": "#/components/schemas/synckhub_server.routes.user_runtime.CalendarSnoozeRequest" } } } } } }, "/v1/user/notifications/events": { "get": { "operationId": "platform_get__v1_user_notifications_events", "summary": "user notifications events", "tags": [ "user_runtime" ], "parameters": [ { "name": "presentation_time_zone", "in": "query", "required": false, "schema": { "anyOf": [ { "type": "string" }, { "type": "null" } ] } }, { "name": "presentation_time_format", "in": "query", "required": false, "schema": { "anyOf": [ { "type": "string" }, { "type": "null" } ] } } ], "description": "Authorization and validation are enforced by the owning service.", "x-handler": "user_notifications_events", "x-source-file": "crates/synckhub-server/src/routes/user_runtime.rs", "x-source-line": 19, "responses": { "default": { "description": "Platform error; branch on HTTP status and stable code, not the human-readable message.", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } } } } }, "head": { "operationId": "platform_head__v1_user_notifications_events", "summary": "user notifications events", "tags": [ "user_runtime" ], "parameters": [ { "name": "presentation_time_zone", "in": "query", "required": false, "schema": { "anyOf": [ { "type": "string" }, { "type": "null" } ] } }, { "name": "presentation_time_format", "in": "query", "required": false, "schema": { "anyOf": [ { "type": "string" }, { "type": "null" } ] } } ], "description": "Authorization and validation are enforced by the owning service.\n\nHEAD uses the GET handler and headers without a response body.", "x-handler": "user_notifications_events", "x-source-file": "crates/synckhub-server/src/routes/user_runtime.rs", "x-source-line": 19, "x-implicit-head": true, "responses": { "default": { "description": "Platform error; branch on HTTP status and stable code, not the human-readable message." } } } }, "/v1/user/presence/heartbeat": { "post": { "operationId": "platform_post__v1_user_presence_heartbeat", "summary": "user presence heartbeat", "tags": [ "user_runtime" ], "parameters": [], "description": "Authorization and validation are enforced by the owning service.", "x-handler": "user_presence_heartbeat", "x-source-file": "crates/synckhub-server/src/routes/user_runtime.rs", "x-source-line": 19, "responses": { "default": { "description": "Platform error; branch on HTTP status and stable code, not the human-readable message.", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } } } }, "requestBody": { "required": true, "content": { "application/json": { "schema": { "$ref": "#/components/schemas/synckhub_server.routes.user_runtime.PresenceHeartbeatRequest" } } } } } }, "/v1/user/push-delivery/ack": { "post": { "operationId": "platform_post__v1_user_push_delivery_ack", "summary": "ack push delivery", "tags": [ "user_runtime" ], "parameters": [], "description": "Authorization and validation are enforced by the owning service.", "x-handler": "ack_push_delivery", "x-source-file": "crates/synckhub-server/src/routes/user_runtime.rs", "x-source-line": 19, "responses": { "default": { "description": "Platform error; branch on HTTP status and stable code, not the human-readable message.", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } } } }, "requestBody": { "required": true, "content": { "application/json": { "schema": { "$ref": "#/components/schemas/synckhub_server.routes.user_runtime.PushDeliveryAckRequest" } } } } } }, "/v1/user/push-devices/{device_id}/notification-preferences": { "patch": { "operationId": "platform_patch__v1_user_push_devices__device_id__notification_preferences", "summary": "patch push device notification preferences", "tags": [ "user_runtime" ], "parameters": [ { "name": "device_id", "in": "path", "required": true, "schema": { "type": "string" } } ], "description": "Authorization and validation are enforced by the owning service.", "x-handler": "patch_push_device_notification_preferences", "x-source-file": "crates/synckhub-server/src/routes/user_runtime.rs", "x-source-line": 19, "responses": { "default": { "description": "Platform error; branch on HTTP status and stable code, not the human-readable message.", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } } }, "2XX": { "description": "Successful JSON response", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/synckhub_server.push_notifications.PushDevicePreferenceView" } } } } }, "requestBody": { "required": true, "content": { "application/json": { "schema": { "$ref": "#/components/schemas/synckhub_server.push_notifications.PushPreferenceMutation" } } } } } }, "/v1/user/push-devices/register": { "post": { "operationId": "platform_post__v1_user_push_devices_register", "summary": "register push device", "tags": [ "user_runtime" ], "parameters": [], "description": "Authorization and validation are enforced by the owning service.", "x-handler": "register_push_device", "x-source-file": "crates/synckhub-server/src/routes/user_runtime.rs", "x-source-line": 19, "responses": { "default": { "description": "Platform error; branch on HTTP status and stable code, not the human-readable message.", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } } } }, "requestBody": { "required": true, "content": { "application/json": { "schema": { "$ref": "#/components/schemas/synckhub_server.routes.user_runtime.RegisterPushDeviceRequest" } } } } } }, "/v1/user/push-devices/unregister": { "post": { "operationId": "platform_post__v1_user_push_devices_unregister", "summary": "unregister push device", "tags": [ "user_runtime" ], "parameters": [], "description": "Authorization and validation are enforced by the owning service.", "x-handler": "unregister_push_device", "x-source-file": "crates/synckhub-server/src/routes/user_runtime.rs", "x-source-line": 19, "responses": { "default": { "description": "Platform error; branch on HTTP status and stable code, not the human-readable message.", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } } } }, "requestBody": { "required": true, "content": { "application/json": { "schema": { "$ref": "#/components/schemas/synckhub_server.routes.user_runtime.UnregisterPushDeviceRequest" } } } } } }, "/v1/user/push-notification-preferences": { "patch": { "operationId": "platform_patch__v1_user_push_notification_preferences", "summary": "patch push notification preferences", "tags": [ "user_runtime" ], "parameters": [], "description": "Authorization and validation are enforced by the owning service.", "x-handler": "patch_push_notification_preferences", "x-source-file": "crates/synckhub-server/src/routes/user_runtime.rs", "x-source-line": 19, "responses": { "default": { "description": "Platform error; branch on HTTP status and stable code, not the human-readable message.", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } } }, "2XX": { "description": "Successful JSON response", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/synckhub_server.push_notifications.PushPreferencesView" } } } } }, "requestBody": { "required": true, "content": { "application/json": { "schema": { "$ref": "#/components/schemas/synckhub_server.push_notifications.UserPushPreferenceMutation" } } } } }, "get": { "operationId": "platform_get__v1_user_push_notification_preferences", "summary": "get push notification preferences", "tags": [ "user_runtime" ], "parameters": [], "description": "Authorization and validation are enforced by the owning service.", "x-handler": "get_push_notification_preferences", "x-source-file": "crates/synckhub-server/src/routes/user_runtime.rs", "x-source-line": 19, "responses": { "default": { "description": "Platform error; branch on HTTP status and stable code, not the human-readable message.", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } } }, "2XX": { "description": "Successful JSON response", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/synckhub_server.push_notifications.PushPreferencesView" } } } } } }, "head": { "operationId": "platform_head__v1_user_push_notification_preferences", "summary": "get push notification preferences", "tags": [ "user_runtime" ], "parameters": [], "description": "Authorization and validation are enforced by the owning service.\n\nHEAD uses the GET handler and headers without a response body.", "x-handler": "get_push_notification_preferences", "x-source-file": "crates/synckhub-server/src/routes/user_runtime.rs", "x-source-line": 19, "x-implicit-head": true, "responses": { "default": { "description": "Platform error; branch on HTTP status and stable code, not the human-readable message." } } } }, "/wopi/files/{file_id}": { "post": { "operationId": "platform_post__wopi_files__file_id_", "summary": "wopi files post", "tags": [ "wopi" ], "parameters": [ { "name": "file_id", "in": "path", "required": true, "schema": { "type": "string" } }, { "name": "X-WOPI-Override", "in": "header", "schema": { "type": "string" } } ], "description": "Authorization and validation are enforced by the owning service.\n\nOffice WOPI endpoint. POST operations dispatch on X-WOPI-Override (for example LOCK, REFRESH_LOCK, UNLOCK, PUT_RELATIVE). Requires the minted access_token and Office proof headers. This route is mounted only when WOPI is configured.", "x-handler": "wopi_files_post", "x-source-file": "crates/synckhub-server/src/routes/wopi.rs", "x-source-line": 268, "responses": { "default": { "description": "Service response. Error status and envelope depend on the operation." } }, "security": [ { "wopiAccessToken": [] } ], "requestBody": { "required": false, "content": { "application/octet-stream": { "schema": { "type": "string", "format": "binary" } } }, "description": "Raw file bytes for content writes and PUT_RELATIVE; lock operations do not require a body." } }, "get": { "operationId": "platform_get__wopi_files__file_id_", "summary": "check file info", "tags": [ "wopi" ], "parameters": [ { "name": "file_id", "in": "path", "required": true, "schema": { "type": "string" } } ], "description": "Authorization and validation are enforced by the owning service.\n\nOffice WOPI endpoint. POST operations dispatch on X-WOPI-Override (for example LOCK, REFRESH_LOCK, UNLOCK, PUT_RELATIVE). Requires the minted access_token and Office proof headers. This route is mounted only when WOPI is configured.", "x-handler": "check_file_info", "x-source-file": "crates/synckhub-server/src/routes/wopi.rs", "x-source-line": 268, "responses": { "default": { "description": "Service response. Error status and envelope depend on the operation." }, "2XX": { "description": "Successful JSON response", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/synckhub_server.routes.wopi.CheckFileInfoResponse" } } } } }, "security": [ { "wopiAccessToken": [] } ] }, "head": { "operationId": "platform_head__wopi_files__file_id_", "summary": "check file info", "tags": [ "wopi" ], "parameters": [ { "name": "file_id", "in": "path", "required": true, "schema": { "type": "string" } } ], "description": "Authorization and validation are enforced by the owning service.\n\nHEAD uses the GET handler and headers without a response body.\n\nOffice WOPI endpoint. POST operations dispatch on X-WOPI-Override (for example LOCK, REFRESH_LOCK, UNLOCK, PUT_RELATIVE). Requires the minted access_token and Office proof headers. This route is mounted only when WOPI is configured.", "x-handler": "check_file_info", "x-source-file": "crates/synckhub-server/src/routes/wopi.rs", "x-source-line": 268, "x-implicit-head": true, "responses": { "default": { "description": "Service response. Error status and envelope depend on the operation." } }, "security": [ { "wopiAccessToken": [] } ] } }, "/wopi/files/{file_id}/contents": { "post": { "operationId": "platform_post__wopi_files__file_id__contents", "summary": "wopi contents post", "tags": [ "wopi" ], "parameters": [ { "name": "file_id", "in": "path", "required": true, "schema": { "type": "string" } }, { "name": "X-WOPI-Override", "in": "header", "schema": { "type": "string" } } ], "description": "Authorization and validation are enforced by the owning service.\n\nOffice WOPI endpoint. POST operations dispatch on X-WOPI-Override (for example LOCK, REFRESH_LOCK, UNLOCK, PUT_RELATIVE). Requires the minted access_token and Office proof headers. This route is mounted only when WOPI is configured.", "x-handler": "wopi_contents_post", "x-source-file": "crates/synckhub-server/src/routes/wopi.rs", "x-source-line": 268, "responses": { "default": { "description": "Service response. Error status and envelope depend on the operation." } }, "security": [ { "wopiAccessToken": [] } ], "requestBody": { "required": true, "content": { "application/octet-stream": { "schema": { "type": "string", "format": "binary" } } }, "description": "Raw file bytes for content writes and PUT_RELATIVE; lock operations do not require a body." } }, "get": { "operationId": "platform_get__wopi_files__file_id__contents", "summary": "get file", "tags": [ "wopi" ], "parameters": [ { "name": "file_id", "in": "path", "required": true, "schema": { "type": "string" } } ], "description": "Authorization and validation are enforced by the owning service.\n\nOffice WOPI endpoint. POST operations dispatch on X-WOPI-Override (for example LOCK, REFRESH_LOCK, UNLOCK, PUT_RELATIVE). Requires the minted access_token and Office proof headers. This route is mounted only when WOPI is configured.", "x-handler": "get_file", "x-source-file": "crates/synckhub-server/src/routes/wopi.rs", "x-source-line": 268, "responses": { "default": { "description": "Service response. Error status and envelope depend on the operation." } }, "security": [ { "wopiAccessToken": [] } ] }, "head": { "operationId": "platform_head__wopi_files__file_id__contents", "summary": "get file", "tags": [ "wopi" ], "parameters": [ { "name": "file_id", "in": "path", "required": true, "schema": { "type": "string" } } ], "description": "Authorization and validation are enforced by the owning service.\n\nHEAD uses the GET handler and headers without a response body.\n\nOffice WOPI endpoint. POST operations dispatch on X-WOPI-Override (for example LOCK, REFRESH_LOCK, UNLOCK, PUT_RELATIVE). Requires the minted access_token and Office proof headers. This route is mounted only when WOPI is configured.", "x-handler": "get_file", "x-source-file": "crates/synckhub-server/src/routes/wopi.rs", "x-source-line": 268, "x-implicit-head": true, "responses": { "default": { "description": "Service response. Error status and envelope depend on the operation." } }, "security": [ { "wopiAccessToken": [] } ] } } }, "security": [ { "bearerAuth": [] } ], "components": { "securitySchemes": { "bearerAuth": { "type": "http", "scheme": "bearer", "description": "Use the credential required by the selected service and operation. Human sessions, repository integration tokens, service credentials, and protocol credentials are distinct contracts." }, "carddavPassword": { "type": "http", "scheme": "basic", "description": "Scoped CardDAV app credentials created through the credentials-management API." }, "googlePubSubJwt": { "type": "http", "scheme": "bearer", "bearerFormat": "JWT", "description": "Google Pub/Sub push JWT verified against Google's signing keys, configured audience, issuer, and service identity." }, "uploadCapability": { "type": "apiKey", "in": "header", "name": "Authorization", "description": "Upload for an active bound file-write intent only. Stages bytes; cannot finalize or access other APIs." }, "calendarPeerProof": { "type": "http", "scheme": "bearer", "bearerFormat": "JWT", "description": "Managed-infrastructure calendar peer proof bound to the destination and exact payload; a user session token is not accepted." }, "wopiAccessToken": { "type": "apiKey", "in": "query", "name": "access_token", "description": "Short-lived token minted by SynckHub's WOPI action-url endpoint. Office proof validation also applies. Requires WOPI to be configured." }, "yjsWopiSecret": { "type": "apiKey", "in": "header", "name": "x-synckhub-yjs-wopi-secret", "description": "Configured Yjs-WOPI callback service secret. User session tokens do not authorize this callback." } }, "schemas": { "synckhub_server.shared_link_statistics.AuditWithContext": { "title": "AuditEventSummary", "type": "object", "properties": { "network_context": { "anyOf": [ { "$ref": "#/components/schemas/synckhub_server.shared_link_statistics.RequestContext" }, { "type": "null" } ] }, "event_id": { "type": "string" }, "repo_id": { "type": "string", "description": "`repo_id` is the repo context for attribution (the `repo_id` from the HTTP path)." }, "mount_id": { "anyOf": [ { "type": "string" }, { "type": "null" } ] }, "actor_id": { "type": "string" }, "action_kind": { "type": "string" }, "action_json": {}, "created_at": { "type": "string" } }, "required": [ "event_id", "repo_id", "actor_id", "action_kind", "action_json", "created_at" ] }, "synckhub_server.shared_link_statistics.RequestContext": { "title": "RequestContext", "type": "object", "properties": { "client_ip": { "anyOf": [ { "type": "string" }, { "type": "null" } ] }, "user_agent": { "anyOf": [ { "type": "string" }, { "type": "null" } ] } } }, "synckhub_server.routes.activity.ActivityWithContext": { "title": "UnifiedActivityEntry", "type": "object", "properties": { "network_context": { "anyOf": [ { "$ref": "#/components/schemas/synckhub_server.shared_link_statistics.RequestContext" }, { "type": "null" } ] }, "network_context_status": { "type": "string" }, "repo_id": { "type": "string" }, "source_repo_id": { "anyOf": [ { "type": "string" }, { "type": "null" } ] }, "mount_id": { "anyOf": [ { "type": "string" }, { "type": "null" } ] }, "item_id": { "type": "string" }, "item_type": { "type": "string", "description": "Normalized type of the presentation target identified by `item_id`." }, "item_name": { "anyOf": [ { "type": "string" }, { "type": "null" } ] }, "activity_id": { "type": "string" }, "activity_source": { "type": "string" }, "event_type": { "type": "string" }, "payload": {}, "created_at": { "type": "string" }, "occurred_at": { "anyOf": [ { "type": "string" }, { "type": "null" } ] }, "actor_id": { "type": "string" }, "committer_id": { "anyOf": [ { "type": "string" }, { "type": "null" } ] }, "parent_folder_id": { "anyOf": [ { "type": "string" }, { "type": "null" } ] }, "parent_folder_id_before": { "anyOf": [ { "type": "string" }, { "type": "null" } ] } }, "required": [ "network_context_status", "repo_id", "item_id", "item_type", "activity_id", "activity_source", "event_type", "payload", "created_at", "actor_id" ] }, "synckhub_server.shared_link_statistics.UsageReport": { "title": "UsageReport", "type": "object", "properties": { "year": { "type": "integer" }, "coverage": { "type": "string" }, "collection_started_at": { "type": "string" }, "as_of": { "type": "string" }, "periods": { "type": "array", "items": { "$ref": "#/components/schemas/synckhub_server.shared_link_statistics.UsagePeriod" } }, "next_link_id": { "anyOf": [ { "type": "string" }, { "type": "null" } ] }, "totals": {}, "repository": { "$ref": "#/components/schemas/synckhub_server.shared_link_statistics.RepositoryCounts" } }, "required": [ "year", "coverage", "collection_started_at", "as_of", "periods", "totals", "repository" ] }, "synckhub_server.shared_link_statistics.UsagePeriod": { "title": "UsagePeriod", "type": "object", "properties": { "link_id": { "type": "string" }, "month": { "type": "integer" }, "opens": { "type": "integer" }, "file_downloads": { "type": "integer" }, "zip_downloads": { "type": "integer" }, "identified_opens": { "type": "integer" }, "identified_downloads": { "type": "integer" }, "unique_openers": { "type": "integer" }, "unique_downloaders": { "type": "integer" }, "finalized": { "type": "boolean" } }, "required": [ "link_id", "month", "opens", "file_downloads", "zip_downloads", "identified_opens", "identified_downloads", "unique_openers", "unique_downloaders", "finalized" ] }, "synckhub_server.shared_link_statistics.RepositoryCounts": { "title": "RepositoryCounts", "type": "object", "properties": { "links_count": { "type": "integer" }, "unique_visitors": { "anyOf": [ { "type": "integer" }, { "type": "null" } ] } }, "required": [ "links_count" ] }, "synckhub_server.routes.admin_onboarding.DomainCompanyPersonalDataMigrateRequest": { "title": "DomainCompanyPersonalDataMigrateRequest", "type": "object", "properties": { "users": { "type": "array", "items": { "$ref": "#/components/schemas/synckhub_server.routes.admin_onboarding.DomainCompanyPersonalDataMigrateUserRequest" } } }, "required": [ "users" ], "additionalProperties": false }, "synckhub_server.routes.admin_onboarding.DomainCompanyPersonalDataMigrateUserRequest": { "title": "DomainCompanyPersonalDataMigrateUserRequest", "type": "object", "properties": { "user_id": { "type": "string" }, "personal_repo_id": { "type": "string" }, "company_repo_id": { "type": "string" } }, "required": [ "user_id", "personal_repo_id", "company_repo_id" ], "additionalProperties": false }, "synckhub_server.routes.admin_onboarding.DomainCompanyPersonalDataMigrateResponse": { "title": "DomainCompanyPersonalDataMigrateResponse", "type": "object", "properties": { "users": { "type": "array", "items": { "$ref": "#/components/schemas/synckhub_server.routes.admin_onboarding.DomainCompanyPersonalDataMigrateUserResponse" } } }, "required": [ "users" ] }, "synckhub_server.routes.admin_onboarding.DomainCompanyPersonalDataMigrateUserResponse": { "title": "DomainCompanyPersonalDataMigrateUserResponse", "type": "object", "properties": { "user_id": { "type": "string" }, "personal_repo_id": { "type": "string" }, "company_repo_id": { "type": "string" }, "status": { "type": "string" }, "blocks_conversion": { "type": "boolean" }, "source_fingerprint": { "anyOf": [ { "type": "string" }, { "type": "null" } ] }, "migrated_item_count": { "type": "integer" }, "file_count": { "type": "integer" }, "folder_count": { "type": "integer" }, "commit_id": { "anyOf": [ { "type": "string" }, { "type": "null" } ] }, "target_user_files_folder_id": { "anyOf": [ { "type": "string" }, { "type": "null" } ] }, "import_folder_id": { "anyOf": [ { "type": "string" }, { "type": "null" } ] }, "reason": { "anyOf": [ { "type": "string" }, { "type": "null" } ] } }, "required": [ "user_id", "personal_repo_id", "company_repo_id", "status", "blocks_conversion", "migrated_item_count", "file_count", "folder_count" ] }, "synckhub_server.routes.admin_onboarding.DomainCompanyPersonalDataPreflightRequest": { "title": "DomainCompanyPersonalDataPreflightRequest", "type": "object", "properties": { "users": { "type": "array", "items": { "$ref": "#/components/schemas/synckhub_server.routes.admin_onboarding.DomainCompanyPersonalDataPreflightUserRequest" } } }, "required": [ "users" ], "additionalProperties": false }, "synckhub_server.routes.admin_onboarding.DomainCompanyPersonalDataPreflightUserRequest": { "title": "DomainCompanyPersonalDataPreflightUserRequest", "type": "object", "properties": { "user_id": { "type": "string" }, "personal_repo_id": { "type": "string" } }, "required": [ "user_id", "personal_repo_id" ], "additionalProperties": false }, "synckhub_server.routes.admin_onboarding.DomainCompanyPersonalDataPreflightResponse": { "title": "DomainCompanyPersonalDataPreflightResponse", "type": "object", "properties": { "all_empty": { "type": "boolean" }, "users": { "type": "array", "items": { "$ref": "#/components/schemas/synckhub_server.routes.admin_onboarding.DomainCompanyPersonalDataPreflightUserResponse" } } }, "required": [ "all_empty", "users" ] }, "synckhub_server.routes.admin_onboarding.DomainCompanyPersonalDataPreflightUserResponse": { "title": "DomainCompanyPersonalDataPreflightUserResponse", "type": "object", "properties": { "user_id": { "type": "string" }, "personal_repo_id": { "type": "string" }, "status": { "type": "string" }, "blocks_conversion": { "type": "boolean" }, "source_fingerprint": { "anyOf": [ { "type": "string" }, { "type": "null" } ] }, "item_count": { "type": "integer" }, "file_count": { "type": "integer" }, "folder_count": { "type": "integer" }, "other_item_count": { "type": "integer" }, "reason": { "anyOf": [ { "type": "string" }, { "type": "null" } ] } }, "required": [ "user_id", "personal_repo_id", "status", "blocks_conversion", "item_count", "file_count", "folder_count", "other_item_count" ] }, "synckhub_server.routes.ai.assistants.AiAssistantsListResponse": { "title": "AiAssistantsListResponse", "type": "object", "properties": { "assistants": { "type": "array", "items": { "$ref": "#/components/schemas/synckhub_server.routes.ai.assistants.AiAssistantSummary" } } }, "required": [ "assistants" ], "additionalProperties": false }, "synckhub_server.routes.ai.assistants.AiAssistantSummary": { "title": "AiAssistantSummary", "type": "object", "properties": { "assistant_id": { "type": "string" }, "display_name": { "type": "string" }, "description": { "anyOf": [ { "type": "string" }, { "type": "null" } ] }, "system_prompt": { "type": "string" }, "provider": { "type": "string" }, "allowed_models": { "type": "array", "items": { "type": "string" } }, "default_provider": { "type": "string" }, "default_model": { "type": "string" }, "provider_options": { "type": "array", "items": { "$ref": "#/components/schemas/synckhub_server.routes.ai.assistants.AiAssistantProviderOptionSummary" } }, "managed_option": { "anyOf": [ { "$ref": "#/components/schemas/synckhub_server.routes.ai.assistants.AiManagedOptionSummary" }, { "type": "null" } ] }, "reasoning_policy": {}, "tool_profile": { "type": "string" }, "scope_kind": { "type": "string" }, "is_builtin": { "type": "boolean" } }, "required": [ "assistant_id", "display_name", "system_prompt", "provider", "allowed_models", "default_provider", "default_model", "provider_options", "reasoning_policy", "tool_profile", "scope_kind", "is_builtin" ], "additionalProperties": false }, "synckhub_server.routes.ai.assistants.AiAssistantProviderOptionSummary": { "title": "AiAssistantProviderOptionSummary", "type": "object", "properties": { "provider": { "type": "string" }, "default_model": { "type": "string" }, "allowed_models": { "type": "array", "items": { "type": "string" } }, "supports_reasoning_effort": { "type": "boolean" }, "available": { "type": "boolean" }, "unavailable_reason": { "anyOf": [ { "type": "string" }, { "type": "null" } ] }, "unavailable_models": { "type": "array", "items": { "type": "string" } } }, "required": [ "provider", "default_model", "allowed_models", "supports_reasoning_effort", "available", "unavailable_models" ], "additionalProperties": false }, "synckhub_server.routes.ai.assistants.AiManagedOptionSummary": { "title": "AiManagedOptionSummary", "type": "object", "properties": { "credential_source": { "type": "string" }, "provider": { "type": "string" }, "default_model": { "type": "string" }, "allowed_models": { "type": "array", "items": { "type": "string" } }, "supports_reasoning_effort": { "type": "boolean" }, "available": { "type": "boolean" }, "unavailable_reason": { "anyOf": [ { "type": "string" }, { "type": "null" } ] }, "unavailable_models": { "type": "array", "items": { "type": "string" } } }, "required": [ "credential_source", "provider", "default_model", "allowed_models", "supports_reasoning_effort", "available", "unavailable_models" ], "additionalProperties": false }, "synckhub_server.routes.ai.runs.AiRunEventResponse": { "title": "AiRunEventResponse", "type": "object", "properties": { "seq": { "type": "integer" }, "event_type": { "type": "string" }, "payload": {}, "created_at": { "type": "string" } }, "required": [ "seq", "event_type", "payload", "created_at" ], "additionalProperties": false }, "synckhub_server.routes.ai.indexing.AiSearchContentSourcesPageResponse": { "title": "AiSearchContentSourcesPageResponse", "type": "object", "properties": { "items": { "type": "array", "items": { "$ref": "#/components/schemas/synckhub_server.routes.ai.indexing.AiSearchContentSourceResponse" } }, "next_cursor": { "anyOf": [ { "type": "string" }, { "type": "null" } ] } }, "required": [ "items" ] }, "synckhub_server.routes.ai.indexing.AiSearchContentSourceResponse": { "title": "AiSearchContentSourceResponse", "type": "object", "properties": { "source_id": { "type": "string" }, "kind": { "type": "string" }, "item_seq": { "anyOf": [ { "type": "integer" }, { "type": "null" } ] }, "blob_id": { "anyOf": [ { "type": "string" }, { "type": "null" } ] }, "filename": { "anyOf": [ { "type": "string" }, { "type": "null" } ] }, "size": { "anyOf": [ { "type": "integer" }, { "type": "null" } ] }, "mime_type": { "anyOf": [ { "type": "string" }, { "type": "null" } ] } }, "required": [ "source_id", "kind" ] }, "synckhub_server.routes.ai.indexing.AiSearchCompleteTasksRequest": { "title": "AiSearchCompleteTasksRequest", "type": "object", "properties": { "worker_id": { "anyOf": [ { "type": "string" }, { "type": "null" } ] }, "generation_id": { "type": "string" }, "results": { "type": "array", "items": { "$ref": "#/components/schemas/synckhub_server.routes.ai.indexing.AiSearchCompleteTaskEntry" } } }, "required": [ "generation_id", "results" ], "additionalProperties": false }, "synckhub_server.routes.ai.indexing.AiSearchCompleteTaskEntry": { "title": "AiSearchCompleteTaskEntry", "type": "object", "properties": { "item_id": { "type": "string" }, "claimed_desired_repo_seq": { "type": "integer" }, "status": { "type": "string" }, "last_indexed_hash": { "anyOf": [ { "type": "string" }, { "type": "null" } ] }, "output_count": { "anyOf": [ { "type": "integer" }, { "type": "null" } ] }, "external_index_ref": { "anyOf": [ { "type": "string" }, { "type": "null" } ] }, "reason": { "anyOf": [ { "type": "string" }, { "type": "null" } ] } }, "required": [ "item_id", "claimed_desired_repo_seq", "status" ], "additionalProperties": false }, "synckhub_server.routes.ai.indexing.AiSearchCompleteTasksResponse": { "title": "AiSearchCompleteTasksResponse", "type": "object", "properties": { "results": { "type": "array", "items": { "$ref": "#/components/schemas/synckhub_server.routes.ai.indexing.AiSearchCompleteTaskResultResponse" } } }, "required": [ "results" ] }, "synckhub_server.routes.ai.indexing.AiSearchCompleteTaskResultResponse": { "title": "AiSearchCompleteTaskResultResponse", "type": "object", "properties": { "item_id": { "type": "string" }, "accepted": { "type": "boolean" }, "status": { "type": "string" }, "current": { "type": "boolean" }, "reason": { "anyOf": [ { "type": "string" }, { "type": "null" } ] } }, "required": [ "item_id", "accepted", "status", "current" ] }, "synckhub_server.routes.ai.indexing.AiSearchClaimTasksRequest": { "title": "AiSearchClaimTasksRequest", "type": "object", "properties": { "worker_id": { "type": "string" }, "limit": { "type": "integer" }, "lease_seconds": { "type": "integer" } }, "required": [ "worker_id", "limit", "lease_seconds" ], "additionalProperties": false }, "synckhub_server.routes.ai.indexing.AiSearchClaimTasksResponse": { "title": "AiSearchClaimTasksResponse", "type": "object", "properties": { "generation_id": { "type": "string" }, "tasks": { "type": "array", "items": { "$ref": "#/components/schemas/synckhub_server.routes.ai.indexing.AiSearchClaimTaskResponse" } } }, "required": [ "generation_id", "tasks" ] }, "synckhub_server.routes.ai.indexing.AiSearchClaimTaskResponse": { "title": "AiSearchClaimTaskResponse", "type": "object", "properties": { "item_id": { "type": "string" }, "desired_repo_seq": { "type": "integer" }, "item": { "anyOf": [ { "$ref": "#/components/schemas/synckhub_core.types.ItemSummary" }, { "type": "null" } ] }, "content_head": { "anyOf": [ { "$ref": "#/components/schemas/synckhub_server.routes.ai.indexing.AiSearchClaimContentHeadResponse" }, { "type": "null" } ] }, "content_sources": { "$ref": "#/components/schemas/synckhub_server.routes.ai.indexing.AiSearchContentSourcesPageResponse" } }, "required": [ "item_id", "desired_repo_seq", "content_sources" ] }, "synckhub_core.types.ItemSummary": { "title": "ItemSummary", "type": "object", "properties": { "repo_id": { "type": "string" }, "mount_id": { "anyOf": [ { "type": "string" }, { "type": "null" } ], "description": "Optional mount attribution for items stored in federated-folder mirror repos.\n\nWhen present, this item should be treated as belonging to the mount (`mount_id`) within\nthe calling actor's `repo_id` context." }, "quick_access": { "type": "boolean", "description": "Per-user quick access flag (\"pinned\") in the *request repo* context.\n\nThis is a platform overlay (not Synck VCS history). When no authenticated\nprincipal is present, servers should return `false`." }, "item_id": { "type": "string", "description": "Item identifier in string form (`ItemId`)." }, "item_type": { "type": "string" }, "item_subtype": { "type": "string", "description": "Repo-scoped subtype classification key (`STANDARD` by default)." }, "name": { "type": "string" }, "file_extension": { "anyOf": [ { "type": "string" }, { "type": "null" } ], "description": "Lowercased file extension without leading dot for `FILE` items, if any.\n\nDerived from `name` by the platform; non-FILE items return `null`." }, "file_stem": { "anyOf": [ { "type": "string" }, { "type": "null" } ], "description": "Convenience \"stem\" for `FILE` items (the name without the `.` suffix).\n\nThis exists so UIs can display a file list with separate \"Name\" and \"Extension\" columns\nwithout re-implementing suffix stripping logic in every client.\n\nFor `FILE` items, this is set when `file_extension` is present and `name` ends with\n`.` (ASCII case-insensitive); the suffix is stripped.\nNon-FILE items return `null`." }, "parent_folder_id": { "anyOf": [ { "type": "string" }, { "type": "null" } ], "description": "Parent folder identifier, if any, as an `ItemId` string." }, "path": { "type": "string", "description": "Raw `platform_items.path` `ltree` string (`.`-separated chain of ancestor folder ids,\nfollowed by the item's own id)." }, "breadcrumbs": { "anyOf": [ { "type": "array", "items": { "$ref": "#/components/schemas/synckhub_core.types.BreadcrumbEntry" } }, { "type": "null" } ], "description": "Optional human-friendly breadcrumb chain (ancestor folders + this item).\n\nThis is not included by default; HTTP surfaces can populate it behind an\nexplicit `include=breadcrumbs`/`fields=` knob." }, "lifecycle_state": { "type": "string", "description": "Lifecycle state for this item: `LIVE`, `TRASH`, or `TOMBSTONED`." }, "item_acl_mode": { "anyOf": [ { "type": "string" }, { "type": "null" } ], "description": "Effective item access mode. Omitted only on legacy/internal surfaces that do not project it." }, "size": { "anyOf": [ { "type": "integer" }, { "type": "null" } ], "description": "Optional aggregate size in bytes (primarily for FILE items)." }, "latest_revision_item_seq": { "anyOf": [ { "type": "integer" }, { "type": "null" } ], "description": "Latest per-item event sequence (`vcs_items.head_seq`).\n\nThis is the user-visible item revision number. For FILE rows it can be\nnewer than `head_revision_item_seq` when metadata, name, parent, trash,\nor other non-content events happened after the latest content write." }, "head_revision_item_seq": { "anyOf": [ { "type": "integer" }, { "type": "null" } ], "description": "Current FILE content-head revision sequence (`platform_items.content_item_seq`).\n\nThis is a cheap materialized scalar on the item row. Non-FILE items, and\nFILE rows with no content head yet, return `null`." }, "head_named_version": { "anyOf": [ { "$ref": "#/components/schemas/synckhub_core.types.FileHeadNamedVersionSummary" }, { "type": "null" } ], "description": "LIVE named-version label that currently points at the FILE content head.\n\nThis is not included by default on list responses. HTTP list surfaces may\npopulate it behind `include=head_named_version`." }, "latest_named_version": { "anyOf": [ { "$ref": "#/components/schemas/synckhub_core.types.FileHeadNamedVersionSummary" }, { "type": "null" } ], "description": "Latest LIVE named-version label for the FILE, regardless of whether it points\nat the current FILE content head.\n\nThis is not included by default on list responses. HTTP list surfaces may\npopulate it behind `include=latest_named_version`." }, "color_metadata": { "anyOf": [ { "type": "string" }, { "type": "null" } ], "description": "Durable item color tag derived from top-level `metadata_json.color_metadata`.\n\nValid values are `yellow`, `orange`, `red`, `purple`, `blue`, `green`, or `null`." }, "metadata_json": { "anyOf": [ {}, { "type": "null" } ], "description": "Raw item metadata, returned only on surfaces that explicitly request it." }, "last_updated_at": { "anyOf": [ { "type": "string" }, { "type": "null" } ], "description": "RFC3339 UTC timestamp when this item was last updated." }, "item_date_at": { "anyOf": [ { "type": "string" }, { "type": "null" } ], "description": "RFC3339 UTC timestamp used by Explorer Date ordering.\n\nThis is a rebuildable projection. Rolling-compatible clients fall back to\n`last_updated_at` when an older or synthetic response omits it." }, "item_date_kind": { "anyOf": [ { "type": "string" }, { "type": "null" } ], "description": "Source selected by the item-Date projection." }, "last_updated_by": { "anyOf": [ { "type": "string" }, { "type": "null" } ], "description": "Actor id who last updated the item." }, "core_workflow": { "anyOf": [ { "$ref": "#/components/schemas/synckhub_core.types.ItemSummaryCoreWorkflow" }, { "type": "null" } ], "description": "Canonical workflow projection for folder dashboards/editing." }, "me": { "anyOf": [ { "$ref": "#/components/schemas/synckhub_core.types.ItemSummaryChatMe" }, { "type": "null" } ], "description": "Per-user chat read state for `CHAT` items (present only for authenticated callers)." }, "email_summary": { "anyOf": [ { "$ref": "#/components/schemas/synckhub_core.types.ItemSummaryEmail" }, { "type": "null" } ], "description": "Mail-shaped summary for archived `EMAIL` rows on explicit email-only list surfaces." }, "unread_count": { "anyOf": [ { "type": "integer" }, { "type": "null" } ], "description": "Per-user unread count for `CHAT` items (present only for authenticated callers)." }, "locks": { "type": "array", "items": { "$ref": "#/components/schemas/synckhub_core.types.ItemLockHint" }, "description": "Unexpired locks for this item (for folder browse listings)." }, "federation_stream_id": { "anyOf": [ { "type": "string" }, { "type": "null" } ], "description": "Authority-owned federated stream id for this item, when present." }, "federation_sync": { "anyOf": [ { "$ref": "#/components/schemas/synckhub_core.types.FederationSyncSummary" }, { "type": "null" } ], "description": "Derived federation sync progress for this local replica." }, "federated_placement_failure": { "anyOf": [ { "$ref": "#/components/schemas/synckhub_core.types.FederatedPlacementFailure" }, { "type": "null" } ], "description": "Local-only federated placement failure marker (repo-scoped moves/renames)." } }, "required": [ "repo_id", "item_id", "item_type", "name", "path", "lifecycle_state" ], "description": "Minimal summary of an item as exposed by the platform.\n\nThis mirrors the platform `items` projection but is intentionally small\nand can be extended without breaking existing consumers." }, "synckhub_core.types.BreadcrumbEntry": { "title": "BreadcrumbEntry", "type": "object", "properties": { "item_id": { "type": "string" }, "name": { "type": "string" }, "redacted_ancestors": { "type": "boolean", "description": "At least one protected ancestor was omitted before this real entry.\n\nClients must render the omitted prefix as non-navigable presentation;\nthis entry's `item_id` always remains the id of the named real item." } }, "required": [ "item_id", "name" ], "description": "Single breadcrumb segment (id + display name)." }, "synckhub_core.types.FileHeadNamedVersionSummary": { "title": "FileHeadNamedVersionSummary", "type": "object", "properties": { "version_id": { "type": "string" }, "source_item_seq": { "type": "integer" }, "kind": { "type": "string" }, "label_source": { "type": "string" }, "version_major": { "anyOf": [ { "type": "integer" }, { "type": "null" } ] }, "version_minor": { "anyOf": [ { "type": "integer" }, { "type": "null" } ] } }, "required": [ "version_id", "source_item_seq", "kind", "label_source" ], "description": "Named-version label summary derived from a LIVE `platform_file_versions` row." }, "synckhub_core.types.ItemSummaryCoreWorkflow": { "title": "ItemSummaryCoreWorkflow", "type": "object", "properties": { "lifecycle_mode": { "anyOf": [ { "$ref": "#/components/schemas/synckhub_core.types.CaseLifecycleMode" }, { "type": "null" } ] }, "pipeline_key": { "anyOf": [ { "type": "string" }, { "type": "null" } ] }, "stage_key": { "anyOf": [ { "type": "string" }, { "type": "null" } ] }, "status": { "anyOf": [ { "type": "string" }, { "type": "null" } ] } } }, "synckhub_core.types.CaseLifecycleMode": { "title": "CaseLifecycleMode", "type": "string", "enum": [ "workflow", "status_only" ], "description": "Atomically change canonical case lifecycle state and append its derived\nprojection and audit history in the same checked VCS commit." }, "synckhub_core.types.ItemSummaryChatMe": { "title": "ItemSummaryChatMe", "type": "object", "properties": { "last_read_item_seq": { "type": "integer" }, "hidden": { "type": "boolean" } }, "required": [ "last_read_item_seq" ], "description": "Per-user chat state embedded in `ItemSummary` for `CHAT` items." }, "synckhub_core.types.ItemSummaryEmail": { "title": "ItemSummaryEmail", "type": "object", "properties": { "is_read": { "anyOf": [ { "type": "boolean" }, { "type": "null" } ] }, "to": { "type": "array", "items": { "$ref": "#/components/schemas/synckhub_core.types.ItemSummaryEmailAddress" } }, "is_outgoing": { "anyOf": [ { "type": "boolean" }, { "type": "null" } ] }, "subject": { "anyOf": [ { "type": "string" }, { "type": "null" } ] }, "from": { "anyOf": [ { "$ref": "#/components/schemas/synckhub_core.types.ItemSummaryEmailAddress" }, { "type": "null" } ] }, "received_at": { "anyOf": [ { "type": "string" }, { "type": "null" } ] }, "snippet": { "anyOf": [ { "type": "string" }, { "type": "null" } ] } }, "description": "Bounded mail-shaped projection for archived `EMAIL` item rows." }, "synckhub_core.types.ItemSummaryEmailAddress": { "title": "ItemSummaryEmailAddress", "type": "object", "properties": { "email": { "anyOf": [ { "type": "string" }, { "type": "null" } ] }, "name": { "anyOf": [ { "type": "string" }, { "type": "null" } ] } }, "description": "Sender/recipient identity embedded in item-level email summaries." }, "synckhub_core.types.ItemLockHint": { "title": "ItemLockHint", "type": "object", "properties": { "lock_type": { "type": "string" }, "owner_id": { "type": "string" }, "expires_at": { "type": "string" } }, "required": [ "lock_type", "owner_id", "expires_at" ], "description": "Minimal lock hint embedded in `ItemSummary` for folder browse listings.\n\nThis intentionally excludes `lock_token` (never leak it to non-owners)." }, "synckhub_core.types.FederationSyncSummary": { "title": "FederationSyncSummary", "type": "object", "properties": { "status": { "type": "string" }, "session_state": { "anyOf": [ { "type": "string" }, { "type": "null" } ] }, "replica_completeness": { "anyOf": [ { "type": "string" }, { "type": "null" } ] }, "member_auth_state": { "anyOf": [ { "type": "string" }, { "type": "null" } ] }, "local_repo_head_seq": { "anyOf": [ { "type": "integer" }, { "type": "null" } ] }, "last_applied_domain_seq": { "anyOf": [ { "type": "integer" }, { "type": "null" } ] }, "last_seen_head_domain_seq": { "anyOf": [ { "type": "integer" }, { "type": "null" } ] }, "last_membership_seq": { "anyOf": [ { "type": "integer" }, { "type": "null" } ] }, "membership_lease_expires_at": { "anyOf": [ { "type": "string" }, { "type": "null" } ] }, "last_sync_at": { "anyOf": [ { "type": "string" }, { "type": "null" } ] }, "last_blob_closure_sync_at": { "anyOf": [ { "type": "string" }, { "type": "null" } ] }, "last_quarantine_reason": { "anyOf": [ { "type": "string" }, { "type": "null" } ] }, "blob_closure_computed_domain_seq": { "anyOf": [ { "type": "integer" }, { "type": "null" } ] }, "blob_closure_complete_domain_seq": { "anyOf": [ { "type": "integer" }, { "type": "null" } ] }, "updated_at": { "anyOf": [ { "type": "string" }, { "type": "null" } ] } }, "required": [ "status" ] }, "synckhub_core.types.FederatedPlacementFailure": { "title": "FederatedPlacementFailure", "type": "object", "properties": { "reason": { "type": "string" }, "failed_at": { "type": "string" } }, "required": [ "reason", "failed_at" ], "description": "Local-only marker for repo-scoped federated placement failures." }, "synckhub_server.routes.ai.indexing.AiSearchClaimContentHeadResponse": { "title": "AiSearchClaimContentHeadResponse", "type": "object", "properties": { "item_seq": { "type": "integer" }, "blob_id": { "type": "string" }, "size": { "anyOf": [ { "type": "integer" }, { "type": "null" } ] }, "mime_type": { "anyOf": [ { "type": "string" }, { "type": "null" } ] } }, "required": [ "item_seq", "blob_id" ] }, "synckhub_server.routes.ai.indexing.AiSearchStopGenerationRequest": { "title": "AiSearchStopGenerationRequest", "type": "object", "properties": { "generation_id": { "anyOf": [ { "type": "string" }, { "type": "null" } ] }, "reason": { "anyOf": [ { "type": "string" }, { "type": "null" } ] } }, "additionalProperties": false }, "synckhub_server.routes.ai.indexing.AiSearchStopGenerationResponse": { "title": "AiSearchGenerationStatusResponse", "type": "object", "properties": { "stopped": { "type": "boolean" }, "active_generation_id": { "anyOf": [ { "type": "string" }, { "type": "null" } ] }, "state": { "anyOf": [ { "type": "string" }, { "type": "null" } ] }, "target_repo_seq": { "anyOf": [ { "type": "integer" }, { "type": "null" } ] }, "enqueued_repo_seq": { "anyOf": [ { "type": "integer" }, { "type": "null" } ] }, "applied_repo_seq": { "anyOf": [ { "type": "integer" }, { "type": "null" } ] }, "queue": { "$ref": "#/components/schemas/synckhub_server.routes.ai.indexing.AiSearchGenerationQueueResponse" } }, "required": [ "stopped", "queue" ] }, "synckhub_server.routes.ai.indexing.AiSearchGenerationStatusResponse": { "title": "AiSearchGenerationStatusResponse", "type": "object", "properties": { "active_generation_id": { "anyOf": [ { "type": "string" }, { "type": "null" } ] }, "state": { "anyOf": [ { "type": "string" }, { "type": "null" } ] }, "target_repo_seq": { "anyOf": [ { "type": "integer" }, { "type": "null" } ] }, "enqueued_repo_seq": { "anyOf": [ { "type": "integer" }, { "type": "null" } ] }, "applied_repo_seq": { "anyOf": [ { "type": "integer" }, { "type": "null" } ] }, "queue": { "$ref": "#/components/schemas/synckhub_server.routes.ai.indexing.AiSearchGenerationQueueResponse" } }, "required": [ "queue" ] }, "synckhub_server.routes.ai.indexing.AiSearchGenerationQueueResponse": { "title": "AiSearchGenerationQueueResponse", "type": "object", "properties": { "pending": { "type": "integer" }, "in_progress": { "type": "integer" }, "ok": { "type": "integer" }, "skipped": { "type": "integer" }, "failed": { "type": "integer" }, "quarantined": { "type": "integer" } }, "required": [ "pending", "in_progress", "ok", "skipped", "failed", "quarantined" ] }, "synckhub_server.routes.ai.indexing.AiSearchStartGenerationRequest": { "title": "AiSearchStartGenerationRequest", "type": "object", "properties": { "mode": { "type": "string" } }, "required": [ "mode" ], "additionalProperties": false }, "synckhub_server.routes.ai.indexing.AiSearchStartGenerationResponse": { "title": "AiSearchGenerationStatusResponse", "type": "object", "properties": { "created": { "type": "boolean" }, "active_generation_id": { "anyOf": [ { "type": "string" }, { "type": "null" } ] }, "state": { "anyOf": [ { "type": "string" }, { "type": "null" } ] }, "target_repo_seq": { "anyOf": [ { "type": "integer" }, { "type": "null" } ] }, "enqueued_repo_seq": { "anyOf": [ { "type": "integer" }, { "type": "null" } ] }, "applied_repo_seq": { "anyOf": [ { "type": "integer" }, { "type": "null" } ] }, "queue": { "$ref": "#/components/schemas/synckhub_server.routes.ai.indexing.AiSearchGenerationQueueResponse" } }, "required": [ "created", "queue" ] }, "synckhub_server.routes.ai.indexing.RevokeRepoServiceTokenResponse": { "title": "RevokeRepoServiceTokenResponse", "type": "object", "properties": { "token_id": { "type": "string" }, "revoked": { "type": "boolean" } }, "required": [ "token_id", "revoked" ] }, "synckhub_server.routes.ai.indexing.CreateRepoServiceTokenRequest": { "title": "CreateRepoServiceTokenRequest", "type": "object", "properties": { "name": { "type": "string" }, "scopes": { "type": "array", "items": { "type": "string" } }, "expires": { "type": "string" } }, "required": [ "name", "scopes", "expires" ], "additionalProperties": false }, "synckhub_server.routes.ai.indexing.CreateRepoServiceTokenResponse": { "title": "CreateRepoServiceTokenResponse", "type": "object", "properties": { "token": { "type": "string" }, "token_info": { "$ref": "#/components/schemas/synckhub_server.routes.ai.indexing.RepoServiceTokenInfoResponse" } }, "required": [ "token", "token_info" ] }, "synckhub_server.routes.ai.indexing.RepoServiceTokenInfoResponse": { "title": "RepoServiceTokenInfoResponse", "type": "object", "properties": { "token_id": { "type": "string" }, "repo_id": { "type": "string" }, "token_prefix": { "type": "string" }, "name": { "type": "string" }, "scopes": { "type": "array", "items": { "type": "string" } }, "status": { "type": "string" }, "created_at": { "type": "string" }, "created_by": { "type": "string" }, "last_used_at": { "anyOf": [ { "type": "string" }, { "type": "null" } ] }, "expires_at": { "anyOf": [ { "type": "string" }, { "type": "null" } ] }, "revoked_at": { "anyOf": [ { "type": "string" }, { "type": "null" } ] }, "revoked_by": { "anyOf": [ { "type": "string" }, { "type": "null" } ] } }, "required": [ "token_id", "repo_id", "token_prefix", "name", "scopes", "status", "created_at", "created_by" ] }, "synckhub_server.routes.ai.runs.AiRunStateResponse": { "title": "AiRunQueueState", "type": "object", "properties": { "input_message": { "anyOf": [ {}, { "type": "null" } ] }, "retry_of_run_id": { "anyOf": [ { "type": "string" }, { "type": "null" } ] }, "run_id": { "type": "string" }, "repo_id": { "type": "string" }, "chat_item_id": { "type": "string" }, "status": { "type": "string" }, "assistant_id": { "type": "string" }, "credential_source": { "type": "string" }, "provider": { "type": "string" }, "model": { "type": "string" }, "reasoning_effort": { "anyOf": [ { "type": "string" }, { "type": "null" } ] }, "started_at": { "anyOf": [ { "type": "string" }, { "type": "null" } ] }, "completed_at": { "anyOf": [ { "type": "string" }, { "type": "null" } ] }, "last_seq": { "type": "integer" }, "error_code": { "anyOf": [ { "type": "string" }, { "type": "null" } ] }, "error_message": { "anyOf": [ { "type": "string" }, { "type": "null" } ] }, "prompt_tokens": { "type": "integer" }, "completion_tokens": { "type": "integer" }, "cached_tokens": { "type": "integer" }, "reasoning_tokens": { "type": "integer" }, "total_tokens": { "type": "integer" }, "request_message_item_seq": { "anyOf": [ { "type": "integer" }, { "type": "null" } ] }, "response_message_item_seq": { "anyOf": [ { "type": "integer" }, { "type": "null" } ] }, "created_at": { "type": "string" }, "updated_at": { "type": "string" }, "request_id": { "anyOf": [ { "type": "string" }, { "type": "null" } ] }, "queue_sequence": { "type": "string" }, "predecessor_run_id": { "anyOf": [ { "type": "string" }, { "type": "null" } ] }, "cancel_requested_at": { "anyOf": [ { "type": "string" }, { "type": "null" } ] }, "response_publication_state": { "type": "string" } }, "required": [ "run_id", "repo_id", "chat_item_id", "status", "assistant_id", "credential_source", "provider", "model", "last_seq", "prompt_tokens", "completion_tokens", "cached_tokens", "reasoning_tokens", "total_tokens", "created_at", "updated_at", "queue_sequence", "response_publication_state" ], "additionalProperties": false }, "synckhub_server.routes.ai.runtime.AiRuntimeTitleCallbackRequest": { "title": "AiRuntimeTitleCallbackRequest", "type": "object", "properties": { "repo_id": { "type": "string" }, "chat_item_id": { "type": "string" }, "status": { "type": "string" }, "title": { "anyOf": [ { "type": "string" }, { "type": "null" } ] }, "error_code": { "anyOf": [ { "type": "string" }, { "type": "null" } ] }, "error_message": { "anyOf": [ { "type": "string" }, { "type": "null" } ] }, "usage": { "anyOf": [ {}, { "type": "null" } ] } }, "required": [ "repo_id", "chat_item_id", "status" ], "additionalProperties": false }, "synckhub_server.routes.ai.runtime.AiRuntimeTitleCallbackResponse": { "title": "AiRuntimeTitleCallbackResponse", "type": "object", "properties": { "status": { "type": "string" } }, "required": [ "status" ], "additionalProperties": false }, "synckhub_server.routes.ai.workflows.AiApplyWorkflowRequest": { "title": "AiApplyWorkflowRequest", "type": "object", "properties": { "goal": { "anyOf": [ { "type": "string" }, { "type": "null" } ] }, "actions": { "type": "array", "items": { "$ref": "#/components/schemas/synckhub_server.routes.ai.workflows.AiRuntimeWorkflowAction" } }, "plan_actions": { "anyOf": [ { "type": "array", "items": { "$ref": "#/components/schemas/synckhub_server.routes.ai.workflows.AiRuntimeWorkflowAction" } }, { "type": "null" } ] } }, "required": [ "actions" ], "additionalProperties": false }, "synckhub_server.routes.ai.workflows.AiRuntimeWorkflowAction": { "title": "AiRuntimeWorkflowAction", "oneOf": [ { "type": "object", "properties": { "kind": { "const": "create_folder" }, "action_id": { "type": "string" }, "name": { "type": "string" }, "parent_folder_id": { "anyOf": [ { "type": "string" }, { "type": "null" } ] }, "meta": { "anyOf": [ {}, { "type": "null" } ] } }, "required": [ "kind", "action_id", "name" ], "title": "AiRuntimeWorkflowCreateFolderAction", "additionalProperties": false }, { "type": "object", "properties": { "kind": { "const": "create_markdown_note" }, "action_id": { "type": "string" }, "name": { "type": "string" }, "content": { "type": "string" }, "parent_folder_id": { "anyOf": [ { "type": "string" }, { "type": "null" } ] }, "parent_action_id": { "anyOf": [ { "type": "string" }, { "type": "null" } ] } }, "required": [ "kind", "action_id", "name", "content" ], "title": "AiRuntimeWorkflowCreateMarkdownNoteAction", "additionalProperties": false }, { "type": "object", "properties": { "kind": { "const": "create_mail_draft" }, "action_id": { "type": "string" }, "account_id": { "type": "string" }, "to": { "type": "array", "items": { "$ref": "#/components/schemas/synckhub_mailcal.types.EmailAddress" } }, "cc": { "type": "array", "items": { "$ref": "#/components/schemas/synckhub_mailcal.types.EmailAddress" } }, "bcc": { "type": "array", "items": { "$ref": "#/components/schemas/synckhub_mailcal.types.EmailAddress" } }, "subject": { "anyOf": [ { "type": "string" }, { "type": "null" } ] }, "body": { "$ref": "#/components/schemas/synckhub_mailcal.types.Body" }, "attachments": { "type": "array", "items": { "$ref": "#/components/schemas/synckhub_mailcal.types.AttachmentUpload" } } }, "required": [ "kind", "action_id", "account_id", "body" ], "title": "AiRuntimeWorkflowCreateDraftAction", "additionalProperties": false }, { "type": "object", "properties": { "kind": { "const": "create_calendar_event" }, "action_id": { "type": "string" }, "account_id": { "type": "string" }, "calendar_id": { "anyOf": [ { "type": "string" }, { "type": "null" } ] }, "event": { "$ref": "#/components/schemas/synckhub_mailcal.types.CalendarEvent" } }, "required": [ "kind", "action_id", "account_id", "event" ], "title": "AiRuntimeWorkflowCreateCalendarEventAction", "additionalProperties": false }, { "type": "object", "properties": { "kind": { "const": "create_task" }, "action_id": { "type": "string" }, "task_list_item_id": { "anyOf": [ { "type": "string" }, { "type": "null" } ] }, "task_list_name": { "anyOf": [ { "type": "string" }, { "type": "null" } ] }, "task_list_parent_folder_id": { "anyOf": [ { "type": "string" }, { "type": "null" } ] }, "subject": { "type": "string" }, "assigned_users": { "type": "array", "items": { "type": "string" } }, "priority": { "anyOf": [ { "type": "string" }, { "type": "null" } ] }, "status": { "anyOf": [ { "type": "string" }, { "type": "null" } ] }, "due_at": { "anyOf": [ { "type": "string" }, { "type": "null" } ] }, "column_values": { "anyOf": [ {}, { "type": "null" } ] } }, "required": [ "kind", "action_id", "subject" ], "title": "AiRuntimeWorkflowCreateTaskAction", "additionalProperties": false } ] }, "synckhub_mailcal.types.EmailAddress": { "title": "EmailAddress", "type": "object", "properties": { "email": { "type": "string" }, "name": { "anyOf": [ { "type": "string" }, { "type": "null" } ] } }, "required": [ "email" ] }, "synckhub_mailcal.types.Body": { "title": "Body", "type": "object", "properties": { "kind": { "$ref": "#/components/schemas/synckhub_mailcal.types.BodyKind" }, "content": { "type": "string" } }, "required": [ "kind", "content" ] }, "synckhub_mailcal.types.BodyKind": { "title": "BodyKind", "type": "string", "enum": [ "TEXT", "HTML" ] }, "synckhub_mailcal.types.AttachmentUpload": { "title": "AttachmentUpload", "type": "object", "properties": { "filename": { "type": "string" }, "mime_type": { "anyOf": [ { "type": "string" }, { "type": "null" } ] }, "content_base64": { "type": "string" }, "is_inline": { "type": "boolean" }, "content_id": { "anyOf": [ { "type": "string" }, { "type": "null" } ] } }, "required": [ "filename", "content_base64" ] }, "synckhub_mailcal.types.CalendarEvent": { "title": "CalendarEvent", "type": "object", "properties": { "event_id": { "type": "string" }, "subject": { "type": "string" }, "start": { "type": "string" }, "end": { "type": "string" }, "timezone": { "anyOf": [ { "type": "string" }, { "type": "null" } ] }, "is_all_day": { "anyOf": [ { "type": "boolean" }, { "type": "null" } ] }, "location": { "anyOf": [ { "type": "string" }, { "type": "null" } ] }, "ical_uid": { "anyOf": [ { "type": "string" }, { "type": "null" } ] }, "recurrence_id": { "anyOf": [ { "type": "string" }, { "type": "null" } ] }, "organizer": { "anyOf": [ { "$ref": "#/components/schemas/synckhub_mailcal.types.EmailAddress" }, { "type": "null" } ] }, "is_organizer": { "anyOf": [ { "type": "boolean" }, { "type": "null" } ] }, "attendees": { "type": "array", "items": { "$ref": "#/components/schemas/synckhub_mailcal.types.EventAttendee" } }, "notify_attendees": { "anyOf": [ { "type": "boolean" }, { "type": "null" } ] }, "body_preview": { "anyOf": [ { "type": "string" }, { "type": "null" } ] }, "body_html": { "anyOf": [ { "type": "string" }, { "type": "null" } ] }, "show_as": { "anyOf": [ { "type": "string" }, { "type": "null" } ] }, "sensitivity": { "anyOf": [ { "type": "string" }, { "type": "null" } ] }, "importance": { "anyOf": [ { "type": "string" }, { "type": "null" } ] }, "categories": { "type": "array", "items": { "type": "string" } }, "locations": { "type": "array", "items": { "$ref": "#/components/schemas/synckhub_mailcal.types.CalendarEventLocation" } }, "is_online_meeting": { "anyOf": [ { "type": "boolean" }, { "type": "null" } ] }, "online_meeting_provider": { "anyOf": [ { "type": "string" }, { "type": "null" } ] }, "online_meeting_url": { "anyOf": [ { "type": "string" }, { "type": "null" } ] }, "reminder_minutes_before_start": { "anyOf": [ { "type": "integer" }, { "type": "null" } ] }, "is_reminder_on": { "anyOf": [ { "type": "boolean" }, { "type": "null" } ] }, "recurrence": { "anyOf": [ {}, { "type": "null" } ] }, "series_master_id": { "anyOf": [ { "type": "string" }, { "type": "null" } ] }, "event_type": { "anyOf": [ { "type": "string" }, { "type": "null" } ] }, "provider_version": { "anyOf": [ { "type": "string" }, { "type": "null" } ] } }, "required": [ "event_id", "subject", "start", "end" ] }, "synckhub_mailcal.types.EventAttendee": { "title": "EventAttendee", "type": "object", "properties": { "email": { "type": "string" }, "name": { "anyOf": [ { "type": "string" }, { "type": "null" } ] }, "response": { "anyOf": [ { "$ref": "#/components/schemas/synckhub_mailcal.types.AttendeeResponse" }, { "type": "null" } ] }, "type": { "anyOf": [ { "$ref": "#/components/schemas/synckhub_mailcal.types.EventAttendeeType" }, { "type": "null" } ] }, "is_self": { "anyOf": [ { "type": "boolean" }, { "type": "null" } ] } }, "required": [ "email" ] }, "synckhub_mailcal.types.AttendeeResponse": { "title": "AttendeeResponse", "type": "string", "enum": [ "ACCEPTED", "TENTATIVE", "DECLINED", "NONE" ] }, "synckhub_mailcal.types.EventAttendeeType": { "title": "EventAttendeeType", "type": "string", "enum": [ "required", "optional", "resource" ] }, "synckhub_mailcal.types.CalendarEventLocation": { "title": "CalendarEventLocation", "type": "object", "properties": { "display_name": { "anyOf": [ { "type": "string" }, { "type": "null" } ] }, "email": { "anyOf": [ { "type": "string" }, { "type": "null" } ] }, "location_type": { "anyOf": [ { "type": "string" }, { "type": "null" } ] } } }, "synckhub_server.routes.ai.workflows.AiWorkflowSessionResponse": { "title": "AiWorkflowSessionResponse", "type": "object", "properties": { "workflow_id": { "type": "string" }, "repo_id": { "type": "string" }, "chat_item_id": { "type": "string" }, "status": { "type": "string" }, "source_run_id": { "anyOf": [ { "type": "string" }, { "type": "null" } ] }, "source_tool_call_id": { "anyOf": [ { "type": "string" }, { "type": "null" } ] }, "goal": { "anyOf": [ { "type": "string" }, { "type": "null" } ] }, "plan": {}, "selected_actions": { "anyOf": [ {}, { "type": "null" } ] }, "results": { "anyOf": [ {}, { "type": "null" } ] }, "last_error_code": { "anyOf": [ { "type": "string" }, { "type": "null" } ] }, "last_error_message": { "anyOf": [ { "type": "string" }, { "type": "null" } ] }, "created_by_user_id": { "type": "string" }, "updated_by_user_id": { "type": "string" }, "created_at": { "type": "string" }, "updated_at": { "type": "string" }, "applied_at": { "anyOf": [ { "type": "string" }, { "type": "null" } ] } }, "required": [ "workflow_id", "repo_id", "chat_item_id", "status", "plan", "created_by_user_id", "updated_by_user_id", "created_at", "updated_at" ], "additionalProperties": false }, "synckhub_server.routes.ai.workflows.AiCreateWorkflowRequest": { "title": "AiCreateWorkflowRequest", "type": "object", "properties": { "goal": { "anyOf": [ { "type": "string" }, { "type": "null" } ] }, "actions": { "type": "array", "items": { "$ref": "#/components/schemas/synckhub_server.routes.ai.workflows.AiRuntimeWorkflowAction" } } }, "required": [ "actions" ], "additionalProperties": false }, "synckhub_server.routes.ai.workflows.AiWorkflowSessionsListResponse": { "title": "AiWorkflowSessionsListResponse", "type": "object", "properties": { "workflows": { "type": "array", "items": { "$ref": "#/components/schemas/synckhub_server.routes.ai.workflows.AiWorkflowSessionResponse" } } }, "required": [ "workflows" ], "additionalProperties": false }, "synckhub_server.exports.ExportRequest": { "title": "ExportRequest", "type": "object", "properties": { "allow_partial": { "anyOf": [ { "type": "boolean" }, { "type": "null" } ] } }, "additionalProperties": false }, "synckhub_server.exports.ExportPreflightResponse": { "title": "ExportPreflightResponse", "type": "object", "properties": { "full_export": { "type": "boolean" }, "total_items_count": { "type": "integer", "minimum": 0 }, "blocked_items_count": { "type": "integer", "minimum": 0 }, "blocked_samples": { "type": "array", "items": { "$ref": "#/components/schemas/synckhub_server.exports.ExportBlockedSample" } } }, "required": [ "full_export", "total_items_count", "blocked_items_count", "blocked_samples" ], "additionalProperties": false }, "synckhub_server.exports.ExportBlockedSample": { "title": "ExportBlockedSample", "type": "object", "properties": { "item_id": { "type": "string" }, "name": { "type": "string" }, "reason_code": { "type": "string" } }, "required": [ "item_id", "name", "reason_code" ], "additionalProperties": false }, "synckhub_server.routes.authz.AuthzEventsResponse": { "title": "AuthzEventsResponse", "type": "object", "properties": { "events": { "type": "array", "items": { "$ref": "#/components/schemas/synckhub_server.routes.authz.AuthzEventResponse" } } }, "required": [ "events" ], "additionalProperties": false }, "synckhub_server.routes.authz.AuthzEventResponse": { "title": "AuthzEventResponse", "type": "object", "properties": { "authz_seq": { "type": "integer" }, "event_uuid": { "type": "string" }, "created_at": { "type": "string" }, "created_by": { "type": "string" }, "event_kind": { "type": "string" }, "payload": {} }, "required": [ "authz_seq", "event_uuid", "created_at", "created_by", "event_kind", "payload" ], "additionalProperties": false }, "synckhub_server.routes.authz.AuthzStackResponse": { "title": "AuthzStackResponse", "type": "object", "properties": { "resource_kind": { "type": "string" }, "resource_id": { "type": "string" }, "folder_id": { "anyOf": [ { "type": "string" }, { "type": "null" } ] }, "item_id": { "anyOf": [ { "type": "string" }, { "type": "null" } ] }, "item_acl_mode": { "anyOf": [ { "type": "string" }, { "type": "null" } ], "description": "Present only when `resource_kind=ITEM`." }, "sources": { "type": "array", "items": { "$ref": "#/components/schemas/synckhub_server.routes.authz.AuthzStackSourceResponse" } } }, "required": [ "resource_kind", "resource_id", "sources" ], "additionalProperties": false }, "synckhub_server.routes.authz.AuthzStackSourceResponse": { "title": "AuthzStackSourceResponse", "type": "object", "properties": { "resource_kind": { "type": "string" }, "resource_id": { "type": "string" }, "resource_name": { "anyOf": [ { "type": "string" }, { "type": "null" } ], "description": "Display name for folders, when available." }, "applies_to_target": { "type": "boolean", "description": "Whether this source can contribute to authorization for the target resource.\n\nFor example, when the target is an item with `item_acl_mode=ITEM_ONLY`,\nfolder/repo sources do not apply to item actions." }, "non_applicability_reason": { "anyOf": [ { "type": "string" }, { "type": "null" } ] }, "included_scopes": { "type": "array", "items": { "type": "string" }, "description": "Scopes included in `rules` for this source." }, "can_manage": { "type": "boolean", "description": "Whether the caller can manage permissions on this source." }, "rules_redacted": { "type": "boolean", "description": "Whether `rules` were omitted because the caller lacks access." }, "rules": { "type": "array", "items": { "$ref": "#/components/schemas/synckhub_server.routes.authz.AuthzRuleResponse" } } }, "required": [ "resource_kind", "resource_id", "applies_to_target", "included_scopes", "can_manage", "rules_redacted", "rules" ], "additionalProperties": false }, "synckhub_server.routes.authz.AuthzRuleResponse": { "title": "AuthzRuleResponse", "type": "object", "properties": { "rule_id": { "type": "string" }, "resource_kind": { "type": "string" }, "resource_id": { "type": "string" }, "subject_kind": { "type": "string" }, "subject_id": { "anyOf": [ { "type": "string" }, { "type": "null" } ] }, "effect": { "type": "string" }, "scope": { "type": "string" }, "target_kind": { "anyOf": [ { "type": "string" }, { "type": "null" } ] }, "actions": { "type": "array", "items": { "type": "string" } } }, "required": [ "rule_id", "resource_kind", "resource_id", "subject_kind", "effect", "scope", "actions" ], "additionalProperties": false }, "synckhub_server.routes.authz.EffectiveResponse": { "title": "EffectiveResponse", "type": "object", "properties": { "principal_id": { "type": "string" }, "resource_kind": { "type": "string" }, "resource_id": { "type": "string" }, "allowed_actions": { "type": "array", "items": { "type": "string" } } }, "required": [ "principal_id", "resource_kind", "resource_id", "allowed_actions" ], "additionalProperties": false }, "synckhub_server.routes.authz.SetItemAclModeRequest": { "title": "SetItemAclModeRequest", "type": "object", "properties": { "item_acl_mode": { "type": "string" }, "request_uuid": { "anyOf": [ { "type": "string" }, { "type": "null" } ], "description": "Optional idempotency key for safe retries." } }, "required": [ "item_acl_mode" ], "additionalProperties": false }, "synckhub_server.routes.authz.GroupMembersRemoveRequest": { "title": "GroupMembersRemoveRequest", "type": "object", "properties": { "principal_ids": { "type": "array", "items": { "type": "string" } }, "request_uuid": { "anyOf": [ { "type": "string" }, { "type": "null" } ], "description": "Optional idempotency key for safe retries." } }, "required": [ "principal_ids" ], "additionalProperties": false }, "synckhub_server.routes.authz.GroupMembersAddRequest": { "title": "GroupMembersAddRequest", "type": "object", "properties": { "principal_ids": { "type": "array", "items": { "type": "string" } }, "request_uuid": { "anyOf": [ { "type": "string" }, { "type": "null" } ], "description": "Optional idempotency key for safe retries." } }, "required": [ "principal_ids" ], "additionalProperties": false }, "synckhub_server.routes.authz.GroupMembersResponse": { "title": "GroupMembersResponse", "type": "object", "properties": { "group_id": { "type": "string" }, "principal_ids": { "type": "array", "items": { "type": "string" } } }, "required": [ "group_id", "principal_ids" ], "additionalProperties": false }, "synckhub_server.routes.authz.AuthzRulesDeleteRequest": { "title": "AuthzRulesDeleteRequest", "type": "object", "properties": { "rule_ids": { "type": "array", "items": { "type": "string" } }, "force": { "type": "boolean" }, "request_uuid": { "anyOf": [ { "type": "string" }, { "type": "null" } ], "description": "Optional idempotency key for safe retries." } }, "required": [ "rule_ids" ], "additionalProperties": false }, "synckhub_server.routes.authz.AuthzRulesPreflightResponse": { "title": "AuthzRulesPreflightResponse", "type": "object", "properties": { "effective_repo_subject_updates": { "type": "integer", "minimum": 0 }, "effective_item_subject_updates": { "type": "integer", "minimum": 0 }, "effective_folder_subject_updates": { "type": "integer", "minimum": 0 }, "effective_folder_child_folders_subject_updates": { "type": "integer", "minimum": 0 }, "effective_folder_child_items_subject_updates": { "type": "integer", "minimum": 0 }, "effective_folder_descendant_folders_subject_updates": { "type": "integer", "minimum": 0 }, "effective_folder_descendant_items_subject_updates": { "type": "integer", "minimum": 0 }, "effective_folder_updates_total": { "type": "integer", "minimum": 0 }, "requires_force": { "type": "boolean" }, "effective_rebuild_async": { "type": "boolean", "description": "If true, forcing the write will enqueue an async effective rebuild." } }, "required": [ "effective_repo_subject_updates", "effective_item_subject_updates", "effective_folder_subject_updates", "effective_folder_child_folders_subject_updates", "effective_folder_child_items_subject_updates", "effective_folder_descendant_folders_subject_updates", "effective_folder_descendant_items_subject_updates", "effective_folder_updates_total", "requires_force", "effective_rebuild_async" ], "additionalProperties": false }, "synckhub_server.routes.authz.AuthzRulesUpsertRequest": { "title": "AuthzRulesUpsertRequest", "type": "object", "properties": { "rules": { "type": "array", "items": { "$ref": "#/components/schemas/synckhub_server.routes.authz.AuthzRuleUpsert" } }, "force": { "type": "boolean" }, "request_uuid": { "anyOf": [ { "type": "string" }, { "type": "null" } ], "description": "Optional idempotency key for safe retries.\n\nIf provided, the server deterministically derives per-event UUIDs from\n(repo_id, request_uuid, op_idx) to dedupe `authz_events` appends." } }, "required": [ "rules" ], "additionalProperties": false }, "synckhub_server.routes.authz.AuthzRuleUpsert": { "title": "AuthzRuleUpsert", "type": "object", "properties": { "rule_id": { "anyOf": [ { "type": "string" }, { "type": "null" } ] }, "resource_kind": { "type": "string" }, "resource_id": { "type": "string" }, "subject_kind": { "type": "string" }, "subject_id": { "anyOf": [ { "type": "string" }, { "type": "null" } ] }, "effect": { "type": "string" }, "scope": { "type": "string" }, "target_kind": { "anyOf": [ { "type": "string" }, { "type": "null" } ] }, "actions": { "anyOf": [ { "type": "array", "items": { "type": "string" } }, { "type": "null" } ], "description": "Advanced: explicit action names (see §11.0.2 in the spec).\n\nPrefer `knobs` for UI clients." }, "knobs": { "anyOf": [ { "type": "array", "items": { "type": "string" } }, { "type": "null" } ], "description": "UI-friendly permission knobs that the server expands to action bits.\n\nThis is the recommended field for UI clients." } }, "required": [ "resource_kind", "resource_id", "subject_kind", "effect", "scope" ], "additionalProperties": false }, "synckhub_server.routes.authz.FolderUpdateUnsubscribeResponse": { "title": "FolderUpdateUnsubscribeResponse", "type": "object", "properties": { "ok": { "type": "boolean" } }, "required": [ "ok" ], "additionalProperties": false }, "synckhub_server.routes.authz.FolderUpdateSubscriptionSelfRequest": { "title": "FolderUpdateSubscriptionSelfRequest", "type": "object", "properties": { "root_folder_id": { "type": "string" }, "subscription_id": { "anyOf": [ { "type": "string" }, { "type": "null" } ] } }, "required": [ "root_folder_id" ], "additionalProperties": false }, "synckhub_server.routes.authz.FolderUpdateSubscriptionResponse": { "title": "FolderUpdateSubscriptionResponse", "type": "object", "properties": { "subscription_id": { "type": "string" }, "repo_id": { "type": "string" }, "root_folder_id": { "type": "string" }, "recipient_kind": { "type": "string" }, "recipient_id": { "type": "string" }, "recipient_user_id": { "anyOf": [ { "type": "string" }, { "type": "null" } ] }, "group_id": { "anyOf": [ { "type": "string" }, { "type": "null" } ] }, "schedule_kind": { "type": "string" }, "send_time_local": { "type": "string" }, "timezone": { "type": "string" }, "status": { "type": "string" }, "next_delivery_at": { "type": "string" } }, "required": [ "subscription_id", "repo_id", "root_folder_id", "recipient_kind", "recipient_id", "schedule_kind", "send_time_local", "timezone", "status", "next_delivery_at" ], "additionalProperties": false }, "synckhub_server.routes.authz.FolderUpdateSubscriptionManagerUnsubscribeRequest": { "title": "FolderUpdateSubscriptionManagerUnsubscribeRequest", "type": "object", "properties": { "root_folder_id": { "type": "string" }, "recipient": { "$ref": "#/components/schemas/synckhub_server.routes.authz.FolderUpdateSubscriptionRecipient" } }, "required": [ "root_folder_id", "recipient" ], "additionalProperties": false }, "synckhub_server.routes.authz.FolderUpdateSubscriptionRecipient": { "title": "FolderUpdateSubscriptionRecipient", "type": "object", "properties": { "kind": { "type": "string" }, "user_id": { "anyOf": [ { "type": "string" }, { "type": "null" } ] }, "group_id": { "anyOf": [ { "type": "string" }, { "type": "null" } ] } }, "required": [ "kind" ], "additionalProperties": false }, "synckhub_server.routes.authz.FolderUpdateSubscriptionUpsertRequest": { "title": "FolderUpdateSubscriptionUpsertRequest", "type": "object", "properties": { "root_folder_id": { "type": "string" }, "recipients": { "type": "array", "items": { "$ref": "#/components/schemas/synckhub_server.routes.authz.FolderUpdateSubscriptionRecipient" } }, "schedule_kind": { "type": "string" }, "send_time_local": { "type": "string" }, "timezone": { "type": "string" } }, "required": [ "root_folder_id", "recipients" ], "additionalProperties": false }, "synckhub_server.routes.authz.PermissionNotificationRequest": { "title": "PermissionNotificationRequest", "type": "object", "properties": { "resource_kind": { "type": "string" }, "resource_id": { "type": "string" }, "recipients": { "type": "array", "items": { "$ref": "#/components/schemas/synckhub_server.routes.authz.PermissionNotificationRecipient" } }, "subscribe_daily_digest": { "type": "boolean" }, "message": { "anyOf": [ { "type": "string" }, { "type": "null" } ] }, "folder_url": { "anyOf": [ { "type": "string" }, { "type": "null" } ] }, "organization_name": { "anyOf": [ { "type": "string" }, { "type": "null" } ] } }, "required": [ "resource_kind", "resource_id", "recipients" ], "additionalProperties": false }, "synckhub_server.routes.authz.PermissionNotificationRecipient": { "title": "PermissionNotificationRecipient", "type": "object", "properties": { "kind": { "type": "string" }, "user_id": { "anyOf": [ { "type": "string" }, { "type": "null" } ] }, "guest_intent_id": { "anyOf": [ { "type": "string" }, { "type": "null" } ] } }, "required": [ "kind" ], "additionalProperties": false }, "synckhub_server.routes.authz.PermissionNotificationResponse": { "title": "PermissionNotificationResponse", "type": "object", "properties": { "sent": { "type": "integer", "minimum": 0 }, "skipped": { "type": "integer", "minimum": 0 } }, "required": [ "sent", "skipped" ], "additionalProperties": false }, "synckhub_server.routes.authz.GuestPermissionIntentUpsertRequest": { "title": "GuestPermissionIntentUpsertRequest", "type": "object", "properties": { "intents": { "type": "array", "items": { "$ref": "#/components/schemas/synckhub_server.routes.authz.GuestPermissionIntentUpsert" } } }, "required": [ "intents" ], "additionalProperties": false }, "synckhub_server.routes.authz.GuestPermissionIntentUpsert": { "title": "GuestPermissionIntentUpsert", "type": "object", "properties": { "guest_intent_id": { "type": "string" }, "folder_id": { "type": "string" }, "effect": { "type": "string" }, "scope": { "type": "string" }, "target_kind": { "anyOf": [ { "type": "string" }, { "type": "null" } ] }, "actions": { "anyOf": [ { "type": "array", "items": { "type": "string" } }, { "type": "null" } ] }, "knobs": { "anyOf": [ { "type": "array", "items": { "type": "string" } }, { "type": "null" } ] }, "subscribe_daily_digest": { "type": "boolean" } }, "required": [ "guest_intent_id", "folder_id", "effect", "scope" ], "additionalProperties": false }, "synckhub_server.routes.authz.GuestPermissionIntentResponse": { "title": "GuestPermissionIntentResponse", "type": "object", "properties": { "permission_intent_id": { "type": "string" }, "guest_intent_id": { "type": "string" }, "repo_id": { "type": "string" }, "folder_id": { "type": "string" }, "effect": { "type": "string" }, "scope": { "type": "string" }, "target_kind": { "type": "string" }, "actions": { "type": "array", "items": { "type": "string" } }, "status": { "type": "string" }, "applied_rule_id": { "anyOf": [ { "type": "string" }, { "type": "null" } ] }, "target_user_id": { "anyOf": [ { "type": "string" }, { "type": "null" } ] }, "created_at": { "type": "string" }, "updated_at": { "type": "string" } }, "required": [ "permission_intent_id", "guest_intent_id", "repo_id", "folder_id", "effect", "scope", "target_kind", "actions", "status", "created_at", "updated_at" ], "additionalProperties": false }, "synckhub_server.routes.authz.SubjectFolderPermissionRootsResponse": { "title": "SubjectFolderPermissionRootsResponse", "type": "object", "properties": { "repo_id": { "type": "string" }, "subject_kind": { "type": "string" }, "subject_id": { "type": "string" }, "roots": { "type": "array", "items": { "$ref": "#/components/schemas/synckhub_server.routes.authz.SubjectFolderPermissionRootResponse" } } }, "required": [ "repo_id", "subject_kind", "subject_id", "roots" ], "additionalProperties": false }, "synckhub_server.routes.authz.SubjectFolderPermissionRootResponse": { "title": "SubjectFolderPermissionRootResponse", "type": "object", "properties": { "rule_id": { "type": "string" }, "folder_id": { "type": "string" }, "folder_name": { "type": "string" }, "folder_path": { "anyOf": [ { "type": "string" }, { "type": "null" } ] }, "effect": { "type": "string" }, "scope": { "type": "string" }, "target_kind": { "anyOf": [ { "type": "string" }, { "type": "null" } ] }, "actions": { "type": "array", "items": { "type": "string" } }, "source": { "$ref": "#/components/schemas/synckhub_server.routes.authz.SubjectFolderPermissionRootSourceResponse" } }, "required": [ "rule_id", "folder_id", "folder_name", "effect", "scope", "actions", "source" ], "additionalProperties": false }, "synckhub_server.routes.authz.SubjectFolderPermissionRootSourceResponse": { "title": "SubjectFolderPermissionRootSourceResponse", "type": "object", "properties": { "source_kind": { "type": "string" }, "source_id": { "anyOf": [ { "type": "string" }, { "type": "null" } ] }, "source_label": { "anyOf": [ { "type": "string" }, { "type": "null" } ] } }, "required": [ "source_kind" ], "additionalProperties": false }, "synckhub_server.routes.authz.ItemAdminRecoveryRequest": { "title": "ItemAdminRecoveryRequest", "type": "object", "properties": { "request_uuid": { "type": "string" } }, "required": [ "request_uuid" ], "additionalProperties": false }, "synckhub_server.routes.authz.ItemShareDeleteRequest": { "title": "ItemShareDeleteRequest", "type": "object", "properties": { "subject_kind": { "type": "string" }, "subject_id": { "type": "string" }, "request_uuid": { "type": "string" } }, "required": [ "subject_kind", "subject_id", "request_uuid" ], "additionalProperties": false }, "synckhub_server.routes.authz.ItemShareUpsertRequest": { "title": "ItemShareUpsertRequest", "type": "object", "properties": { "subject_kind": { "type": "string" }, "subject_id": { "type": "string" }, "role": { "type": "string" }, "request_uuid": { "type": "string" } }, "required": [ "subject_kind", "subject_id", "role", "request_uuid" ], "additionalProperties": false }, "synckhub_server.routes.authz.ItemSharesResponse": { "title": "ItemSharesResponse", "type": "object", "properties": { "item_acl_mode": { "type": "string" }, "can_recover_admin": { "type": "boolean" }, "shares": { "type": "array", "items": { "$ref": "#/components/schemas/synckhub_server.routes.authz.ItemShareResponse" } } }, "required": [ "item_acl_mode", "can_recover_admin", "shares" ], "additionalProperties": false }, "synckhub_server.routes.authz.ItemShareResponse": { "title": "ItemShareResponse", "type": "object", "properties": { "subject_kind": { "type": "string" }, "subject_id": { "type": "string" }, "role": { "type": "string" } }, "required": [ "subject_kind", "subject_id", "role" ], "additionalProperties": false }, "synckhub_server.routes.authz.AuthzRulesResponse": { "title": "AuthzRulesResponse", "type": "object", "properties": { "rules": { "type": "array", "items": { "$ref": "#/components/schemas/synckhub_server.routes.authz.AuthzRuleResponse" } }, "effective_rebuild_pending": { "anyOf": [ { "type": "boolean" }, { "type": "null" } ] }, "message": { "anyOf": [ { "type": "string" }, { "type": "null" } ] } }, "required": [ "rules" ], "additionalProperties": false }, "synckhub_server.routes.authz.LeaveRepoResponse": { "title": "LeaveRepoResponse", "type": "object", "properties": { "repo_id": { "type": "string" }, "membership_kind": { "type": "string" }, "left": { "type": "boolean" }, "leave_event_id": { "type": "string" }, "local_cleanup": { "$ref": "#/components/schemas/synckhub_server.routes.authz.RepoUserOffboardingCleanupResponse" } }, "required": [ "repo_id", "membership_kind", "left", "leave_event_id", "local_cleanup" ], "additionalProperties": false }, "synckhub_server.routes.authz.RepoUserOffboardingCleanupResponse": { "title": "RepoUserOffboardingCleanupResponse", "type": "object", "properties": { "repo_id": { "type": "string" }, "user_id": { "type": "string" }, "direct_user_rules_removed": { "type": "integer", "minimum": 0 }, "group_memberships_removed": { "type": "integer", "minimum": 0 }, "guest_permission_intents_revoked": { "type": "integer", "minimum": 0 }, "guest_intents_revoked": { "type": "integer", "minimum": 0 }, "chat_participant_intents_revoked": { "type": "integer", "minimum": 0 }, "calendar_delegations_revoked": { "type": "integer", "minimum": 0 }, "calendar_events_transferred": { "type": "integer", "minimum": 0 }, "calendar_events_canceled": { "type": "integer", "minimum": 0 }, "calendar_events_remaining": { "type": "boolean" }, "effective_rebuild_queued": { "type": "boolean" } }, "required": [ "repo_id", "user_id", "direct_user_rules_removed", "group_memberships_removed", "guest_permission_intents_revoked", "guest_intents_revoked", "chat_participant_intents_revoked", "calendar_delegations_revoked", "calendar_events_transferred", "calendar_events_canceled", "calendar_events_remaining", "effective_rebuild_queued" ], "additionalProperties": false }, "synckhub_server.routes.authz.GuestIntentResponse": { "title": "GuestIntentResponse", "type": "object", "properties": { "intent_id": { "type": "string" }, "repo_id": { "type": "string" }, "email": { "type": "string" }, "first_name": { "anyOf": [ { "type": "string" }, { "type": "null" } ] }, "last_name": { "anyOf": [ { "type": "string" }, { "type": "null" } ] }, "status": { "type": "string" }, "user_id": { "anyOf": [ { "type": "string" }, { "type": "null" } ] }, "common_invite_id": { "anyOf": [ { "type": "string" }, { "type": "null" } ] }, "invite_token": { "anyOf": [ { "type": "string" }, { "type": "null" } ] }, "created_at": { "type": "string" }, "updated_at": { "type": "string" } }, "required": [ "intent_id", "repo_id", "email", "status", "created_at", "updated_at" ], "additionalProperties": false }, "synckhub_server.routes.authz.GuestIntentCreateRequest": { "title": "GuestIntentCreateRequest", "type": "object", "properties": { "email": { "type": "string" }, "first_name": { "anyOf": [ { "type": "string" }, { "type": "null" } ] }, "last_name": { "anyOf": [ { "type": "string" }, { "type": "null" } ] }, "folder_id": { "anyOf": [ { "type": "string" }, { "type": "null" } ] } }, "required": [ "email" ], "additionalProperties": false }, "synckhub_server.routes.authz.RepoUserSummary": { "title": "RepoUserSummary", "type": "object", "properties": { "user_id": { "type": "string" }, "email": { "type": "string" }, "first_name": { "anyOf": [ { "type": "string" }, { "type": "null" } ] }, "last_name": { "anyOf": [ { "type": "string" }, { "type": "null" } ] }, "role": { "type": "string" }, "kind": { "type": "string" }, "disabled_at": { "anyOf": [ { "type": "string", "format": "date-time" }, { "type": "null" } ] } }, "required": [ "user_id", "email", "role", "kind" ], "additionalProperties": false }, "synckhub_federation_protocol.types.MemberV1": { "title": "MemberV1", "type": "object", "properties": { "authority_id": { "type": "string" }, "authority_domain": { "type": "string" }, "tenant_id": { "type": "string" }, "email": { "anyOf": [ { "type": "string" }, { "type": "null" } ] }, "user_id": { "anyOf": [ { "type": "string" }, { "type": "null" } ] }, "user_email": { "anyOf": [ { "type": "string" }, { "type": "null" } ] }, "status": { "type": "string" }, "role": { "$ref": "#/components/schemas/synckhub_federation_protocol.types.MemberRoleV1" }, "key_client_invite_id": { "anyOf": [ { "type": "string" }, { "type": "null" } ] } }, "required": [ "authority_id", "authority_domain", "tenant_id", "status", "role" ] }, "synckhub_federation_protocol.types.MemberRoleV1": { "title": "MemberRoleV1", "type": "string", "enum": [ "ADMIN", "MEMBER", "READONLY" ] }, "synckhub_federation.clearinghouse.SyncStreamResult": { "title": "SyncStreamResult", "type": "object", "properties": { "federation_stream_id": { "type": "string" }, "synced_events": { "type": "integer" }, "last_applied_domain_seq": { "type": "integer" }, "changed_items": { "type": "array", "items": { "$ref": "#/components/schemas/synckhub_federation.clearinghouse.SyncedItemChangeSummary" } } }, "required": [ "federation_stream_id", "synced_events", "last_applied_domain_seq" ] }, "synckhub_federation.clearinghouse.SyncedItemChangeSummary": { "title": "SyncedItemChangeSummary", "type": "object", "properties": { "item_id": { "type": "string" }, "item_type": { "type": "string" }, "change": { "$ref": "#/components/schemas/synckhub_federation.clearinghouse.SyncedItemChangeKind" }, "parent_folder_id": { "anyOf": [ { "type": "string" }, { "type": "null" } ] }, "old_parent_folder_id": { "anyOf": [ { "type": "string" }, { "type": "null" } ] }, "repo_subitem_realtime": { "anyOf": [ { "$ref": "#/components/schemas/synckhub_federation.clearinghouse.SyncedRepoSubitemRealtimeSummary" }, { "type": "null" } ] }, "chat_realtime": { "anyOf": [ { "$ref": "#/components/schemas/synckhub_federation.clearinghouse.SyncedChatRealtimeSummary" }, { "type": "null" } ] } }, "required": [ "item_id", "item_type", "change" ] }, "synckhub_federation.clearinghouse.SyncedItemChangeKind": { "title": "SyncedItemChangeKind", "type": "string", "enum": [ "created", "renamed", "moved", "trashed", "restored", "updated" ] }, "synckhub_federation.clearinghouse.SyncedRepoSubitemRealtimeSummary": { "title": "SyncedRepoSubitemRealtimeSummary", "type": "object", "properties": { "subitem_type": { "type": "string" }, "item_seq": { "type": "integer" }, "change": { "$ref": "#/components/schemas/synckhub_federation.clearinghouse.SyncedRepoSubitemChange" } }, "required": [ "subitem_type", "item_seq", "change" ] }, "synckhub_federation.clearinghouse.SyncedRepoSubitemChange": { "title": "SyncedRepoSubitemChange", "type": "string", "enum": [ "added", "edited", "trashed", "restored" ] }, "synckhub_federation.clearinghouse.SyncedChatRealtimeSummary": { "title": "SyncedChatRealtimeSummary", "type": "object", "properties": { "subitem_type": { "type": "string" }, "item_seq": { "type": "integer" }, "actor_id": { "anyOf": [ { "type": "string" }, { "type": "null" } ] }, "parent_item_seq": { "anyOf": [ { "type": "integer" }, { "type": "null" } ] }, "reactor_id": { "anyOf": [ { "type": "string" }, { "type": "null" } ] }, "emoji": { "anyOf": [ { "type": "string" }, { "type": "null" } ] }, "change": { "$ref": "#/components/schemas/synckhub_federation.clearinghouse.SyncedChatSubitemChange" } }, "required": [ "subitem_type", "item_seq", "change" ] }, "synckhub_federation.clearinghouse.SyncedChatSubitemChange": { "title": "SyncedChatSubitemChange", "type": "string", "enum": [ "added", "edited", "trashed", "restored" ] }, "synckhub_server.routes.FederationCreateInviteRequest": { "title": "FederationCreateInviteRequest", "type": "object", "properties": { "invitees": { "type": "array", "items": { "$ref": "#/components/schemas/synckhub_server.routes.FederationInviteeInput" } }, "client_invite_id": { "anyOf": [ { "type": "string" }, { "type": "null" } ] }, "invitee_role": { "anyOf": [ { "$ref": "#/components/schemas/synckhub_federation_protocol.types.MemberRoleV1" }, { "type": "null" } ] }, "expires_in_seconds": { "anyOf": [ { "type": "integer" }, { "type": "null" } ] }, "bootstrap_proposal": { "anyOf": [ { "$ref": "#/components/schemas/synckhub_federation_protocol.types.ProposalPayloadEnvelopeV1" }, { "type": "null" } ] }, "tenant_id": { "anyOf": [ { "type": "string" }, { "type": "null" } ], "description": "Optional override when auth is disabled." } }, "additionalProperties": false }, "synckhub_server.routes.FederationInviteeInput": { "title": "FederationInviteeInput", "type": "object", "properties": { "address": { "type": "string" } }, "required": [ "address" ], "additionalProperties": false }, "synckhub_federation_protocol.types.ProposalPayloadEnvelopeV1": { "title": "ProposalPayloadEnvelopeV1", "type": "object", "properties": { "format_version": { "type": "integer" }, "domain_kind": { "$ref": "#/components/schemas/synckhub_federation_protocol.types.DomainKindV1" }, "body": { "$ref": "#/components/schemas/synckhub_federation_protocol.types.ProposalPayloadBodyV1" } }, "required": [ "format_version", "domain_kind", "body" ], "additionalProperties": false }, "synckhub_federation_protocol.types.DomainKindV1": { "title": "DomainKindV1", "type": "string", "enum": [ "ITEM", "FOLDER" ] }, "synckhub_federation_protocol.types.ProposalPayloadBodyV1": { "title": "ProposalPayloadBodyV1", "type": "object", "properties": { "author_authority_id": { "type": "string" }, "author_authority_domain": { "type": "string" }, "author_tenant_id": { "type": "string" }, "author_user_id": { "anyOf": [ { "type": "string" }, { "type": "null" } ] }, "author_user_email": { "anyOf": [ { "type": "string" }, { "type": "null" } ] }, "message": { "anyOf": [ { "type": "string" }, { "type": "null" } ] }, "historical": { "anyOf": [ { "$ref": "#/components/schemas/synckhub_federation_protocol.types.HistoricalTaskAttributionV1" }, { "type": "null" } ], "description": "Original commit identity and time for source-authenticated task history.\nOrdinary proposal endpoints require this field to be absent." }, "item_seq": { "anyOf": [ { "type": "integer" }, { "type": "null" } ], "description": "Authority-materialized starting item sequence for ITEM proposals.\n\nSubmitters must omit this field. It is part of the accepted payload so\nparticipants can authenticate item sequencing independently from the\nstream's combined event cursor after attached ref events are admitted." }, "events": { "type": "array", "items": {} }, "ref_events": { "type": "array", "items": {}, "description": "Attached FILE ref-ledger events authenticated by the proposal digest." } }, "required": [ "author_authority_id", "author_authority_domain", "author_tenant_id", "events" ], "additionalProperties": false }, "synckhub_federation_protocol.types.HistoricalTaskAttributionV1": { "title": "HistoricalTaskAttributionV1", "type": "object", "properties": { "source_commit_id": { "type": "string" }, "occurred_at": { "type": "string", "format": "date-time" } }, "required": [ "source_commit_id", "occurred_at" ], "additionalProperties": false }, "synckhub_server.routes.FederationCreateInvitesResponse": { "title": "FederationCreateInvitesResponse", "type": "object", "properties": { "invites": { "type": "array", "items": { "$ref": "#/components/schemas/synckhub_federation_protocol.types.CreateInviteResponseV1" } } }, "required": [ "invites" ], "additionalProperties": false }, "synckhub_federation_protocol.types.CreateInviteResponseV1": { "title": "CreateInviteResponseV1", "type": "object", "properties": { "invite_secret": { "type": "string" }, "invite": { "$ref": "#/components/schemas/synckhub_federation_protocol.types.SignedEnvelopeV1_FederationInviteV1" } }, "required": [ "invite" ] }, "synckhub_federation_protocol.types.SignedEnvelopeV1_FederationInviteV1": { "title": "SignedEnvelopeV1", "type": "object", "properties": { "object_type": { "type": "string" }, "format_version": { "type": "integer" }, "kid": { "type": "string" }, "payload": { "$ref": "#/components/schemas/synckhub_federation_protocol.types.FederationInviteV1" }, "signature_b64": { "type": "string" } }, "required": [ "object_type", "format_version", "kid", "payload", "signature_b64" ] }, "synckhub_federation_protocol.types.FederationInviteV1": { "title": "FederationInviteV1", "type": "object", "properties": { "invite_id": { "type": "string" }, "federation_stream_id": { "type": "string" }, "domain_kind": { "$ref": "#/components/schemas/synckhub_federation_protocol.types.DomainKindV1" }, "federated_id": { "$ref": "#/components/schemas/synckhub_federation_protocol.types.FederatedId" }, "inviter_authority_id": { "type": "string" }, "inviter_authority_domain": { "type": "string" }, "inviter_tenant_id": { "type": "string" }, "inviter_email": { "anyOf": [ { "type": "string" }, { "type": "null" } ] }, "invitee_tenant_domain": { "anyOf": [ { "type": "string" }, { "type": "null" } ] }, "invitee_tenant_id": { "anyOf": [ { "type": "string" }, { "type": "null" } ] }, "recipients": { "type": "array", "items": { "$ref": "#/components/schemas/synckhub_federation_protocol.types.FederationInviteRecipientV1" } }, "created_at": { "type": "string", "format": "date-time" }, "expires_at": { "type": "string", "format": "date-time" }, "content_mode": { "$ref": "#/components/schemas/synckhub_federation_protocol.types.ContentModeV1" }, "stream_key_envelopes": { "type": "array", "items": { "$ref": "#/components/schemas/synckhub_federation_protocol.types.StreamKeyEnvelopeV1" } }, "recipient_secret_envelopes": { "type": "array", "items": { "$ref": "#/components/schemas/synckhub_federation_protocol.types.RecipientSecretEnvelopeV1" } }, "bootstrap_proposal": { "anyOf": [ { "$ref": "#/components/schemas/synckhub_federation_protocol.types.ProposalPayloadEnvelopeV1" }, { "type": "null" } ] } }, "required": [ "invite_id", "federation_stream_id", "domain_kind", "federated_id", "inviter_authority_id", "inviter_authority_domain", "inviter_tenant_id", "created_at", "expires_at" ] }, "synckhub_federation_protocol.types.FederatedId": { "title": "FederatedId", "type": "string" }, "synckhub_federation_protocol.types.FederationInviteRecipientV1": { "title": "FederationInviteRecipientV1", "type": "object", "properties": { "tenant_id": { "type": "string" }, "user_id": { "type": "string" }, "email": { "anyOf": [ { "type": "string" }, { "type": "null" } ] } }, "required": [ "tenant_id", "user_id" ] }, "synckhub_federation_protocol.types.ContentModeV1": { "title": "ContentModeV1", "type": "string", "enum": [ "PLAINTEXT_V1", "E2EE_V1" ] }, "synckhub_federation_protocol.types.StreamKeyEnvelopeV1": { "title": "StreamKeyEnvelopeV1", "type": "object", "properties": { "format_version": { "type": "integer" }, "key_generation": { "type": "integer", "minimum": 0 }, "client_invite_id": { "type": "string" }, "ciphertext_b64": { "type": "string" } }, "required": [ "format_version", "key_generation", "client_invite_id", "ciphertext_b64" ], "additionalProperties": false }, "synckhub_federation_protocol.types.RecipientSecretEnvelopeV1": { "title": "RecipientSecretEnvelopeV1", "type": "object", "properties": { "format_version": { "type": "integer" }, "recipient_infrastructure_id": { "type": "string" }, "recipient_key_id": { "type": "string" }, "enc_b64": { "type": "string" }, "ciphertext_b64": { "type": "string" } }, "required": [ "format_version", "recipient_infrastructure_id", "recipient_key_id", "enc_b64", "ciphertext_b64" ], "additionalProperties": false }, "synckhub_server.routes.FederationCreateStreamRequest": { "title": "FederationCreateStreamRequest", "type": "object", "properties": { "domain_kind": { "$ref": "#/components/schemas/synckhub_federation_protocol.types.DomainKindV1" }, "federated_id": { "anyOf": [ { "type": "string" }, { "type": "null" } ] } }, "required": [ "domain_kind" ], "additionalProperties": false }, "synckhub_federation_protocol.types.CreateStreamResponseV1": { "title": "CreateStreamResponseV1", "type": "object", "properties": { "federation_stream_id": { "type": "string" }, "domain_kind": { "$ref": "#/components/schemas/synckhub_federation_protocol.types.DomainKindV1" }, "federated_id": { "$ref": "#/components/schemas/synckhub_federation_protocol.types.FederatedId" }, "membership_seq": { "type": "integer" }, "content_mode": { "$ref": "#/components/schemas/synckhub_federation_protocol.types.ContentModeV1" }, "key_generation": { "type": "integer", "minimum": 0 } }, "required": [ "federation_stream_id", "domain_kind", "federated_id", "membership_seq" ] }, "synckhub_server.routes.FederationAcceptInviteRequest": { "title": "FederationAcceptInviteRequest", "type": "object", "properties": { "invite": { "$ref": "#/components/schemas/synckhub_federation_protocol.types.SignedEnvelopeV1_FederationInviteV1" }, "secret": { "anyOf": [ { "type": "string" }, { "type": "null" } ] }, "parent_folder_id": { "anyOf": [ { "type": "string" }, { "type": "null" } ] }, "tenant_id": { "anyOf": [ { "type": "string" }, { "type": "null" } ], "description": "Optional override when auth is disabled." } }, "required": [ "invite" ], "additionalProperties": false }, "synckhub_federation.clearinghouse.AcceptInviteResult": { "title": "AcceptInviteResult", "type": "object", "properties": { "federation_stream_id": { "type": "string" }, "domain_kind": { "$ref": "#/components/schemas/synckhub_federation_protocol.types.DomainKindV1" }, "federated_id": { "type": "string" }, "membership_seq": { "type": "integer" }, "synced_events": { "type": "integer" }, "last_applied_domain_seq": { "type": "integer" } }, "required": [ "federation_stream_id", "domain_kind", "federated_id", "membership_seq", "synced_events", "last_applied_domain_seq" ] }, "synckhub_federation_protocol.types.RevokeInviteResponseV1": { "title": "RevokeInviteResponseV1", "type": "object", "properties": { "invite_id": { "type": "string" }, "status": { "type": "string" }, "membership_seq": { "type": "integer" } }, "required": [ "invite_id", "status", "membership_seq" ] }, "synckhub_federation_protocol.types.RejectInviteResponseV1": { "title": "RejectInviteResponseV1", "type": "object", "properties": { "invite_id": { "type": "string" }, "status": { "type": "string" }, "membership_seq": { "type": "integer" } }, "required": [ "invite_id", "status", "membership_seq" ] }, "synckhub_server.routes.FederationPostDecisionThreadMessageRequest": { "title": "FederationPostDecisionThreadMessageRequest", "type": "object", "properties": { "body": { "type": "string" } }, "required": [ "body" ], "additionalProperties": false }, "synckhub_federation_protocol.types.DecisionThreadMessageV1": { "title": "DecisionThreadMessageV1", "type": "object", "properties": { "message_seq": { "type": "integer" }, "author_authority_id": { "type": "string" }, "author_authority_domain": { "type": "string" }, "author_tenant_id": { "type": "string" }, "author_user_id": { "anyOf": [ { "type": "string" }, { "type": "null" } ] }, "author_user_email": { "anyOf": [ { "type": "string" }, { "type": "null" } ] }, "body": { "type": "string" }, "created_at": { "type": "string", "format": "date-time" } }, "required": [ "message_seq", "author_authority_id", "author_authority_domain", "author_tenant_id", "body", "created_at" ] }, "synckhub_server.routes.FederationDecisionThreadResponse": { "title": "FederationDecisionThreadResponse", "type": "object", "properties": { "thread_id": { "type": "string" }, "thread_kind": { "$ref": "#/components/schemas/synckhub_federation_protocol.types.DecisionThreadKindV1" }, "direction": { "$ref": "#/components/schemas/synckhub_federation_protocol.types.InviteDirectionV1" }, "state": { "$ref": "#/components/schemas/synckhub_federation_protocol.types.DecisionThreadStateV1" }, "created_at": { "type": "string", "format": "date-time" }, "updated_at": { "type": "string", "format": "date-time" }, "closed_at": { "anyOf": [ { "type": "string", "format": "date-time" }, { "type": "null" } ] }, "message_count": { "type": "integer" }, "invite": { "$ref": "#/components/schemas/synckhub_federation_protocol.types.SignedEnvelopeV1_FederationInviteV1" }, "entries": { "type": "array", "items": { "$ref": "#/components/schemas/synckhub_federation_protocol.types.DecisionThreadEntryV1" } }, "inviter_email": { "anyOf": [ { "type": "string" }, { "type": "null" } ] }, "invitee_email": { "anyOf": [ { "type": "string" }, { "type": "null" } ] } }, "required": [ "thread_id", "thread_kind", "direction", "state", "created_at", "updated_at", "message_count", "invite", "entries" ], "additionalProperties": false }, "synckhub_federation_protocol.types.DecisionThreadKindV1": { "title": "DecisionThreadKindV1", "type": "string", "enum": [ "invite", "approval" ] }, "synckhub_federation_protocol.types.InviteDirectionV1": { "title": "InviteDirectionV1", "type": "string", "enum": [ "RECEIVED", "SENT" ] }, "synckhub_federation_protocol.types.DecisionThreadStateV1": { "title": "DecisionThreadStateV1", "type": "string", "enum": [ "PENDING", "ACCEPTED", "REJECTED", "REVOKED", "EXPIRED" ] }, "synckhub_federation_protocol.types.DecisionThreadEntryV1": { "title": "DecisionThreadEntryV1", "oneOf": [ { "type": "object", "properties": { "entry_kind": { "const": "MESSAGE" }, "message_seq": { "type": "integer" }, "author_authority_id": { "type": "string" }, "author_authority_domain": { "type": "string" }, "author_tenant_id": { "type": "string" }, "author_user_id": { "anyOf": [ { "type": "string" }, { "type": "null" } ] }, "author_user_email": { "anyOf": [ { "type": "string" }, { "type": "null" } ] }, "body": { "type": "string" }, "created_at": { "type": "string", "format": "date-time" } }, "required": [ "entry_kind", "message_seq", "author_authority_id", "author_authority_domain", "author_tenant_id", "body", "created_at" ], "title": "DecisionThreadMessageV1" }, { "type": "object", "properties": { "entry_kind": { "const": "SYSTEM" }, "event_type": { "$ref": "#/components/schemas/synckhub_federation_protocol.types.DecisionThreadSystemEventTypeV1" }, "actor_authority_id": { "anyOf": [ { "type": "string" }, { "type": "null" } ] }, "actor_authority_domain": { "anyOf": [ { "type": "string" }, { "type": "null" } ] }, "actor_tenant_id": { "anyOf": [ { "type": "string" }, { "type": "null" } ] }, "user_id": { "anyOf": [ { "type": "string" }, { "type": "null" } ] }, "user_email": { "anyOf": [ { "type": "string" }, { "type": "null" } ] }, "created_at": { "type": "string", "format": "date-time" } }, "required": [ "entry_kind", "event_type", "created_at" ], "title": "DecisionThreadSystemEventV1" } ] }, "synckhub_federation_protocol.types.DecisionThreadSystemEventV1": { "title": "DecisionThreadSystemEventV1", "type": "object", "properties": { "event_type": { "$ref": "#/components/schemas/synckhub_federation_protocol.types.DecisionThreadSystemEventTypeV1" }, "actor_authority_id": { "anyOf": [ { "type": "string" }, { "type": "null" } ] }, "actor_authority_domain": { "anyOf": [ { "type": "string" }, { "type": "null" } ] }, "actor_tenant_id": { "anyOf": [ { "type": "string" }, { "type": "null" } ] }, "user_id": { "anyOf": [ { "type": "string" }, { "type": "null" } ] }, "user_email": { "anyOf": [ { "type": "string" }, { "type": "null" } ] }, "created_at": { "type": "string", "format": "date-time" } }, "required": [ "event_type", "created_at" ] }, "synckhub_federation_protocol.types.DecisionThreadSystemEventTypeV1": { "title": "DecisionThreadSystemEventTypeV1", "type": "string", "enum": [ "CREATED", "ACCEPTED", "REJECTED", "REVOKED", "EXPIRED" ] }, "synckhub_federation_protocol.types.InviteListViewV1": { "title": "InviteListViewV1", "type": "string", "enum": [ "received", "sent", "all" ] }, "synckhub_federation_protocol.types.InviteListStatusFilterV1": { "title": "InviteListStatusFilterV1", "type": "string", "enum": [ "pending", "all" ] }, "synckhub_server.routes.FederationDecisionThreadSummaryResponse": { "title": "FederationDecisionThreadSummaryResponse", "type": "object", "properties": { "thread_id": { "type": "string" }, "thread_kind": { "$ref": "#/components/schemas/synckhub_federation_protocol.types.DecisionThreadKindV1" }, "direction": { "$ref": "#/components/schemas/synckhub_federation_protocol.types.InviteDirectionV1" }, "state": { "$ref": "#/components/schemas/synckhub_federation_protocol.types.DecisionThreadStateV1" }, "created_at": { "type": "string", "format": "date-time" }, "updated_at": { "type": "string", "format": "date-time" }, "closed_at": { "anyOf": [ { "type": "string", "format": "date-time" }, { "type": "null" } ] }, "message_count": { "type": "integer" }, "preview_text": { "anyOf": [ { "type": "string" }, { "type": "null" } ] }, "terminal_event": { "anyOf": [ { "$ref": "#/components/schemas/synckhub_federation_protocol.types.DecisionThreadSystemEventV1" }, { "type": "null" } ] }, "invite": { "$ref": "#/components/schemas/synckhub_federation_protocol.types.SignedEnvelopeV1_FederationInviteV1" }, "inviter_email": { "anyOf": [ { "type": "string" }, { "type": "null" } ] }, "invitee_email": { "anyOf": [ { "type": "string" }, { "type": "null" } ] } }, "required": [ "thread_id", "thread_kind", "direction", "state", "created_at", "updated_at", "message_count", "invite" ], "additionalProperties": false }, "synckhub_server.routes.FederationInviteSummaryResponse": { "title": "FederationInviteSummaryResponse", "type": "object", "properties": { "direction": { "$ref": "#/components/schemas/synckhub_federation_protocol.types.InviteDirectionV1" }, "status": { "$ref": "#/components/schemas/synckhub_federation_protocol.types.InviteStatusV1" }, "created_at": { "type": "string", "format": "date-time" }, "updated_at": { "type": "string", "format": "date-time" }, "invite": { "$ref": "#/components/schemas/synckhub_federation_protocol.types.SignedEnvelopeV1_FederationInviteV1" }, "inviter_email": { "anyOf": [ { "type": "string" }, { "type": "null" } ] }, "invitee_email": { "anyOf": [ { "type": "string" }, { "type": "null" } ] } }, "required": [ "direction", "status", "created_at", "updated_at", "invite" ], "additionalProperties": false }, "synckhub_federation_protocol.types.InviteStatusV1": { "title": "InviteStatusV1", "type": "string", "enum": [ "PENDING", "ACCEPTED", "REJECTED", "REVOKED", "EXPIRED" ] }, "synckhub_server.routes.authz.RepoUserOffboardingCleanupRequest": { "title": "RepoUserOffboardingCleanupRequest", "type": "object", "properties": { "request_uuid": { "anyOf": [ { "type": "string" }, { "type": "null" } ] }, "reason": { "anyOf": [ { "type": "string" }, { "type": "null" } ] }, "calendar_disposition": { "$ref": "#/components/schemas/synckhub_server.routes.native_calendars.offboarding.Disposition", "description": "Calendar events are preserved unless the administrator explicitly\nchooses a future-event disposition." }, "calendar_successor_user_id": { "anyOf": [ { "type": "string" }, { "type": "null" } ], "description": "Active local user who becomes organizer for TRANSFER_FUTURE." } }, "additionalProperties": false }, "synckhub_server.routes.native_calendars.offboarding.Disposition": { "title": "Disposition", "type": "string", "enum": [ "KEEP", "TRANSFER_FUTURE", "CANCEL_FUTURE" ] }, "synckhub_server.routes.CreateRepoRequest": { "title": "CreateRepoRequest", "type": "object", "properties": { "repo_id": { "type": "string" }, "owner_tenant_id": { "anyOf": [ { "type": "string" }, { "type": "null" } ] }, "display_name": { "type": "string" }, "handle": { "type": "string" } }, "required": [ "repo_id", "display_name", "handle" ], "additionalProperties": false }, "synckhub_server.routes.CreateRepoResponse": { "title": "CreateRepoResponse", "type": "object", "properties": { "repo_id": { "type": "string" }, "owner_tenant_id": { "type": "string" }, "display_name": { "type": "string" }, "name_key": { "type": "string" }, "handle": { "type": "string" }, "handle_key": { "type": "string" }, "initial_role": { "type": "string" } }, "required": [ "repo_id", "owner_tenant_id", "display_name", "name_key", "handle", "handle_key", "initial_role" ], "additionalProperties": false }, "synckhub_server.routes.authz.CommonSyncStatusResponse": { "title": "CommonSyncStatusResponse", "type": "object", "properties": { "authz_mode": { "type": "string" }, "now": { "type": "string" }, "cursors": { "type": "array", "items": { "$ref": "#/components/schemas/synckhub_server.routes.authz.CommonSyncCursorStatusRow" } } }, "required": [ "authz_mode", "now", "cursors" ], "additionalProperties": false }, "synckhub_server.routes.authz.CommonSyncCursorStatusRow": { "title": "CommonSyncCursorStatusRow", "type": "object", "properties": { "kind": { "type": "string" }, "scope_id": { "type": "string" }, "freshness_state": { "type": "string" }, "etag": { "anyOf": [ { "type": "string" }, { "type": "null" } ] }, "version": { "anyOf": [ { "type": "integer" }, { "type": "null" } ] }, "local_materializer_version": { "type": "integer" }, "local_materialized_snapshot_version": { "anyOf": [ { "type": "integer" }, { "type": "null" } ] }, "local_materialized_at": { "anyOf": [ { "type": "string" }, { "type": "null" } ] }, "local_materialization_state": { "type": "string" }, "local_materialization_error": { "anyOf": [ { "type": "string" }, { "type": "null" } ] }, "last_success_at": { "anyOf": [ { "type": "string" }, { "type": "null" } ] }, "last_error_at": { "anyOf": [ { "type": "string" }, { "type": "null" } ] }, "last_error": { "anyOf": [ { "type": "string" }, { "type": "null" } ] }, "consecutive_failures": { "type": "integer" }, "updated_at": { "type": "string" } }, "required": [ "kind", "scope_id", "freshness_state", "local_materializer_version", "local_materialization_state", "consecutive_failures", "updated_at" ], "additionalProperties": false }, "synckhub_server.routes.authz.CommonAuthzSnapshotMaterializerProgressResponse": { "title": "CommonAuthzSnapshotMaterializerProgressResponse", "type": "object", "properties": { "authz_mode": { "type": "string" }, "materializer_version": { "type": "integer" }, "required_tenants": { "type": "integer" }, "current_tenants": { "type": "integer" }, "not_current_tenants": { "type": "integer" }, "error_tenants": { "type": "integer" }, "repair_complete": { "type": "boolean" } }, "required": [ "authz_mode", "materializer_version", "required_tenants", "current_tenants", "not_current_tenants", "error_tenants", "repair_complete" ], "additionalProperties": false }, "synckhub_server.routes.authz.CommonAuthzSnapshotRepairLocalMaterializersRequest": { "title": "CommonAuthzSnapshotRepairLocalMaterializersRequest", "type": "object", "properties": { "tenant_id": { "anyOf": [ { "type": "string" }, { "type": "null" } ] }, "wait_timeout_ms": { "anyOf": [ { "type": "integer", "minimum": 0 }, { "type": "null" } ] } }, "additionalProperties": false }, "synckhub_server.routes.authz.CommonAuthzSnapshotNotifyRequest": { "title": "CommonAuthzSnapshotNotifyRequest", "type": "object", "properties": { "tenant_id": { "anyOf": [ { "type": "string" }, { "type": "null" } ] }, "expected_version": { "anyOf": [ { "type": "integer" }, { "type": "null" } ] }, "wait_timeout_ms": { "anyOf": [ { "type": "integer", "minimum": 0 }, { "type": "null" } ] } }, "additionalProperties": false }, "synckhub_federation_protocol.types.FederationWakeupWebhookV1": { "title": "FederationWakeupWebhookV1", "type": "object", "properties": { "authority_id": { "type": "string" }, "authority_domain": { "type": "string" }, "tenant_id": { "type": "string" }, "recipient_user_ids": { "anyOf": [ { "type": "array", "items": { "type": "string" } }, { "type": "null" } ] }, "stream_ids": { "type": "array", "items": { "type": "string" } }, "reason": { "$ref": "#/components/schemas/synckhub_federation_protocol.types.FederationWakeupReasonV1" } }, "required": [ "authority_id", "authority_domain", "tenant_id", "stream_ids", "reason" ] }, "synckhub_federation_protocol.types.FederationWakeupReasonV1": { "title": "FederationWakeupReasonV1", "type": "string", "enum": [ "HEAD_ADVANCED", "MEMBERSHIP_ADVANCED", "DECISION_THREAD_ADVANCED", "LOCK_ADVANCED", "BOOTSTRAP", "TYPING", "RECEIPT_ADVANCED" ] }, "synckhub_server.routes.authz.CommonRepoProvisioningNotifyRequest": { "title": "CommonRepoProvisioningNotifyRequest", "type": "object", "properties": { "tenant_id": { "anyOf": [ { "type": "string" }, { "type": "null" } ] }, "repo_id": { "anyOf": [ { "type": "string" }, { "type": "null" } ] }, "wait_timeout_ms": { "anyOf": [ { "type": "integer", "minimum": 0 }, { "type": "null" } ] } }, "additionalProperties": false }, "synckhub_server.routes.authz.DrainResponse": { "title": "DrainResponse", "type": "object", "properties": { "status": { "type": "string" }, "already_draining": { "type": "boolean" }, "build": { "$ref": "#/components/schemas/synckhub_server.routes.authz.BuildInfo" } }, "required": [ "status", "already_draining", "build" ], "additionalProperties": false }, "synckhub_server.routes.authz.BuildInfo": { "title": "BuildInfo", "type": "object", "properties": { "package_version": { "type": "string" }, "git_commit": { "anyOf": [ { "type": "string" }, { "type": "null" } ] }, "git_ref": { "anyOf": [ { "type": "string" }, { "type": "null" } ] }, "channel": { "anyOf": [ { "type": "string" }, { "type": "null" } ] } }, "required": [ "package_version" ], "additionalProperties": false }, "synckhub_mailcal.types.CalendarCapabilities": { "title": "CalendarCapabilities", "type": "object", "properties": { "provider": { "type": "string" }, "availability": { "$ref": "#/components/schemas/synckhub_mailcal.types.CalendarCapability" }, "meeting_suggestions": { "$ref": "#/components/schemas/synckhub_mailcal.types.CalendarCapability" }, "rooms": { "$ref": "#/components/schemas/synckhub_mailcal.types.CalendarCapability" }, "resources": { "$ref": "#/components/schemas/synckhub_mailcal.types.CalendarCapability" }, "reminders": { "$ref": "#/components/schemas/synckhub_mailcal.types.CalendarCapability" }, "recurrence_editing": { "$ref": "#/components/schemas/synckhub_mailcal.types.CalendarCapability" }, "invitation_forwarding": { "$ref": "#/components/schemas/synckhub_mailcal.types.CalendarCapability" }, "online_meetings": { "$ref": "#/components/schemas/synckhub_mailcal.types.CalendarCapability" }, "categories": { "$ref": "#/components/schemas/synckhub_mailcal.types.CalendarCapability" }, "shared_calendars": { "$ref": "#/components/schemas/synckhub_mailcal.types.CalendarCapability" }, "server_search": { "$ref": "#/components/schemas/synckhub_mailcal.types.CalendarCapability" } }, "required": [ "provider", "availability", "meeting_suggestions", "rooms", "resources", "reminders", "recurrence_editing", "invitation_forwarding", "online_meetings", "categories", "shared_calendars", "server_search" ] }, "synckhub_mailcal.types.CalendarCapability": { "title": "CalendarCapability", "type": "object", "properties": { "supported": { "type": "boolean" }, "reason": { "anyOf": [ { "type": "string" }, { "type": "null" } ] }, "required_scopes": { "type": "array", "items": { "type": "string" } } }, "required": [ "supported" ] }, "synckhub_server.routes.calendar.commands.CalendarCommandResponse": { "title": "CalendarCommandResponse", "type": "object", "properties": { "job_id": { "type": "string", "format": "uuid" }, "command_id": { "type": "string", "format": "uuid" }, "kind": { "type": "string" }, "status": { "type": "string" }, "attempts": { "type": "integer" }, "attempt_available": { "type": "boolean" }, "attempt": { "anyOf": [ {}, { "type": "null" } ] }, "result_event_id": { "anyOf": [ { "type": "string" }, { "type": "null" } ] }, "result_calendar_id": { "anyOf": [ { "type": "string" }, { "type": "null" } ] }, "result_provider_version": { "anyOf": [ { "type": "string" }, { "type": "null" } ] }, "last_error_code": { "anyOf": [ { "type": "string" }, { "type": "null" } ] }, "last_error": { "anyOf": [ { "type": "string" }, { "type": "null" } ] }, "created_at": { "type": "string" }, "updated_at": { "type": "string" }, "completed_at": { "anyOf": [ { "type": "string" }, { "type": "null" } ] } }, "required": [ "job_id", "command_id", "kind", "status", "attempts", "attempt_available", "created_at", "updated_at" ], "additionalProperties": false }, "synckhub_server.mailcal.calendar_command.CalendarCommandEnvelope": { "title": "CalendarCommandEnvelope", "type": "object", "properties": { "version": { "type": "integer", "minimum": 0 }, "command_id": { "type": "string", "format": "uuid" }, "command": { "$ref": "#/components/schemas/synckhub_server.mailcal.calendar_command.CalendarCommand" } }, "required": [ "version", "command_id", "command" ], "additionalProperties": false }, "synckhub_server.mailcal.calendar_command.CalendarCommand": { "title": "CalendarCommand", "oneOf": [ { "type": "object", "properties": { "kind": { "const": "CALENDAR_EVENT_CREATE" }, "calendar_id": { "type": "string" }, "event": { "$ref": "#/components/schemas/synckhub_server.mailcal.calendar_command.CalendarCreateEvent" } }, "required": [ "kind", "calendar_id", "event" ], "additionalProperties": false }, { "type": "object", "properties": { "kind": { "const": "CALENDAR_EVENT_UPDATE" }, "calendar_id": { "type": "string" }, "event_id": { "type": "string" }, "edit_scope": { "anyOf": [ { "type": "string" }, { "type": "null" } ] }, "notify_attendees": { "type": "boolean" }, "base": { "type": "object", "additionalProperties": {} }, "desired": { "type": "object", "additionalProperties": {} } }, "required": [ "kind", "calendar_id", "event_id", "base", "desired" ], "additionalProperties": false }, { "type": "object", "properties": { "kind": { "const": "CALENDAR_EVENT_DELETE" }, "calendar_id": { "type": "string" }, "event_id": { "type": "string" }, "edit_scope": { "anyOf": [ { "type": "string" }, { "type": "null" } ] }, "notify_attendees": { "type": "boolean" } }, "required": [ "kind", "calendar_id", "event_id" ], "additionalProperties": false }, { "type": "object", "properties": { "kind": { "const": "CALENDAR_EVENT_FORWARD" }, "calendar_id": { "type": "string" }, "event_id": { "type": "string" }, "edit_scope": { "anyOf": [ { "type": "string" }, { "type": "null" } ] }, "to": { "type": "array", "items": { "$ref": "#/components/schemas/synckhub_mailcal.types.EmailAddress" } }, "comment": { "type": "string" } }, "required": [ "kind", "calendar_id", "event_id", "to" ], "additionalProperties": false }, { "type": "object", "properties": { "kind": { "const": "CALENDAR_EVENT_RSVP" }, "calendar_id": { "type": "string" }, "event_id": { "type": "string" }, "response": { "type": "string" }, "comment": { "anyOf": [ { "type": "string" }, { "type": "null" } ] }, "send_response": { "type": "boolean" } }, "required": [ "kind", "calendar_id", "event_id", "response" ], "additionalProperties": false } ] }, "synckhub_server.mailcal.calendar_command.CalendarCreateEvent": { "title": "CalendarCreateEvent", "type": "object", "properties": { "subject": { "type": "string" }, "start": { "type": "string" }, "end": { "type": "string" }, "timezone": { "anyOf": [ { "type": "string" }, { "type": "null" } ] }, "is_all_day": { "anyOf": [ { "type": "boolean" }, { "type": "null" } ] }, "location": { "anyOf": [ { "type": "string" }, { "type": "null" } ] }, "attendees": { "type": "array", "items": { "$ref": "#/components/schemas/synckhub_mailcal.types.EventAttendee" } }, "notify_attendees": { "anyOf": [ { "type": "boolean" }, { "type": "null" } ] }, "body_html": { "anyOf": [ { "type": "string" }, { "type": "null" } ] }, "show_as": { "anyOf": [ { "type": "string" }, { "type": "null" } ] }, "sensitivity": { "anyOf": [ { "type": "string" }, { "type": "null" } ] }, "is_online_meeting": { "anyOf": [ { "type": "boolean" }, { "type": "null" } ] }, "reminder_minutes_before_start": { "anyOf": [ { "type": "integer" }, { "type": "null" } ] }, "is_reminder_on": { "anyOf": [ { "type": "boolean" }, { "type": "null" } ] }, "recurrence": { "anyOf": [ {}, { "type": "null" } ] } }, "required": [ "subject", "start", "end" ], "additionalProperties": false }, "synckhub_server.routes.calendar.events.MoveEventRequest": { "title": "MoveEventRequest", "type": "object", "properties": { "target_calendar_id": { "type": "string" } }, "required": [ "target_calendar_id" ], "additionalProperties": false }, "synckhub_server.routes.calendar.events.MoveEventResponse": { "title": "MoveEventResponse", "type": "object", "properties": { "event": { "$ref": "#/components/schemas/synckhub_mailcal.types.CalendarEvent" }, "moved_from_event_id": { "type": "string" }, "moved_to_event_id": { "type": "string" } }, "required": [ "event", "moved_from_event_id", "moved_to_event_id" ], "additionalProperties": false }, "synckhub_server.routes.calendar.events.RsvpRequest": { "title": "RsvpRequest", "type": "object", "properties": { "response": { "type": "string" }, "comment": { "anyOf": [ { "type": "string" }, { "type": "null" } ] }, "send_response": { "anyOf": [ { "type": "boolean" }, { "type": "null" } ] } }, "required": [ "response" ], "additionalProperties": false }, "synckhub_server.routes.calendar.scheduling.CalendarResourceListsResponse": { "title": "CalendarResourceListsResponse", "type": "object", "properties": { "resource_lists": { "type": "array", "items": { "$ref": "#/components/schemas/synckhub_mailcal.types.CalendarResourceList" } }, "read_status": { "$ref": "#/components/schemas/synckhub_server.routes.connected_accounts.read_status.MailcalReadStatus" } }, "required": [ "resource_lists", "read_status" ], "additionalProperties": false }, "synckhub_mailcal.types.CalendarResourceList": { "title": "CalendarResourceList", "type": "object", "properties": { "resource_list_id": { "type": "string" }, "display_name": { "type": "string" }, "email": { "anyOf": [ { "type": "string" }, { "type": "null" } ] } }, "required": [ "resource_list_id", "display_name" ] }, "synckhub_server.routes.connected_accounts.read_status.MailcalReadStatus": { "title": "MailcalReadStatus", "type": "object", "properties": { "source": { "type": "string" }, "projection": { "type": "string" }, "partial": { "type": "boolean" }, "snapshot_id": { "anyOf": [ { "type": "string" }, { "type": "null" } ] }, "generation_id": { "anyOf": [ { "type": "string" }, { "type": "null" } ] }, "stale": { "anyOf": [ { "type": "boolean" }, { "type": "null" } ] }, "syncing": { "anyOf": [ { "type": "boolean" }, { "type": "null" } ] }, "sync": { "anyOf": [ { "$ref": "#/components/schemas/synckhub_server.routes.connected_accounts.read_status.MailcalReadSyncStatus" }, { "type": "null" } ] } }, "required": [ "source", "projection", "partial" ], "additionalProperties": false }, "synckhub_server.routes.connected_accounts.read_status.MailcalReadSyncStatus": { "title": "MailcalReadSyncStatus", "type": "object", "properties": { "scope": { "type": "string" }, "scope_key": { "anyOf": [ {}, { "type": "null" } ] }, "snapshot_id": { "anyOf": [ { "type": "string" }, { "type": "null" } ] }, "generation_id": { "anyOf": [ { "type": "string" }, { "type": "null" } ] }, "status": { "type": "string" }, "active_job_id": { "anyOf": [ { "type": "string" }, { "type": "null" } ] }, "account_count": { "type": "integer", "minimum": 0 }, "synced_account_count": { "type": "integer", "minimum": 0 }, "syncing_account_count": { "type": "integer", "minimum": 0 }, "backoff_account_count": { "type": "integer", "minimum": 0 }, "stale_account_count": { "type": "integer", "minimum": 0 }, "backfill_account_count": { "type": "integer", "minimum": 0 }, "backfill_pending": { "type": "boolean" }, "last_attempt_at": { "anyOf": [ { "type": "string", "format": "date-time" }, { "type": "null" } ] }, "last_success_at": { "anyOf": [ { "type": "string", "format": "date-time" }, { "type": "null" } ] }, "next_retry_at": { "anyOf": [ { "type": "string", "format": "date-time" }, { "type": "null" } ] }, "accounts": { "type": "array", "items": { "$ref": "#/components/schemas/synckhub_server.routes.connected_accounts.read_status.MailcalReadSyncAccountStatus" } } }, "required": [ "scope", "status", "account_count", "synced_account_count", "syncing_account_count", "backoff_account_count", "stale_account_count", "backfill_account_count", "backfill_pending", "accounts" ], "additionalProperties": false }, "synckhub_server.routes.connected_accounts.read_status.MailcalReadSyncAccountStatus": { "title": "MailcalReadSyncAccountStatus", "type": "object", "properties": { "account_id": { "type": "string" }, "status": { "type": "string" }, "stale": { "type": "boolean" }, "syncing": { "type": "boolean" }, "backfill_pending": { "type": "boolean" }, "attempts": { "type": "integer" }, "has_error": { "type": "boolean" }, "last_attempt_at": { "anyOf": [ { "type": "string", "format": "date-time" }, { "type": "null" } ] }, "last_success_at": { "anyOf": [ { "type": "string", "format": "date-time" }, { "type": "null" } ] }, "next_retry_at": { "anyOf": [ { "type": "string", "format": "date-time" }, { "type": "null" } ] } }, "required": [ "account_id", "status", "stale", "syncing", "backfill_pending", "attempts", "has_error" ], "additionalProperties": false }, "synckhub_server.routes.calendar.scheduling.CalendarResourcesResponse": { "title": "CalendarResourcesResponse", "type": "object", "properties": { "resources": { "type": "array", "items": { "$ref": "#/components/schemas/synckhub_mailcal.types.CalendarResource" } }, "read_status": { "$ref": "#/components/schemas/synckhub_server.routes.connected_accounts.read_status.MailcalReadStatus" } }, "required": [ "resources", "read_status" ], "additionalProperties": false }, "synckhub_mailcal.types.CalendarResource": { "title": "CalendarResource", "type": "object", "properties": { "resource_id": { "type": "string" }, "email": { "type": "string" }, "display_name": { "type": "string" }, "type": { "anyOf": [ { "type": "string" }, { "type": "null" } ] }, "capacity": { "anyOf": [ { "type": "integer" }, { "type": "null" } ] }, "location": { "anyOf": [ { "type": "string" }, { "type": "null" } ] } }, "required": [ "resource_id", "email", "display_name" ] }, "synckhub_mailcal.types.CalendarMeetingSuggestionQuery": { "title": "CalendarMeetingSuggestionQuery", "type": "object", "properties": { "start": { "type": "string" }, "end": { "type": "string" }, "duration_minutes": { "type": "integer" }, "time_zone": { "anyOf": [ { "type": "string" }, { "type": "null" } ] }, "required_attendees": { "type": "array", "items": { "$ref": "#/components/schemas/synckhub_mailcal.types.CalendarAvailabilityParticipant" } }, "optional_attendees": { "type": "array", "items": { "$ref": "#/components/schemas/synckhub_mailcal.types.CalendarAvailabilityParticipant" } }, "resources": { "type": "array", "items": { "$ref": "#/components/schemas/synckhub_mailcal.types.CalendarAvailabilityParticipant" } }, "work_hours_mode": { "anyOf": [ { "type": "string" }, { "type": "null" } ] }, "minimum_attendee_percentage": { "anyOf": [ { "type": "integer" }, { "type": "null" } ] } }, "required": [ "start", "end", "duration_minutes" ] }, "synckhub_mailcal.types.CalendarAvailabilityParticipant": { "title": "CalendarAvailabilityParticipant", "type": "object", "properties": { "email": { "type": "string" }, "name": { "anyOf": [ { "type": "string" }, { "type": "null" } ] }, "type": { "anyOf": [ { "$ref": "#/components/schemas/synckhub_mailcal.types.EventAttendeeType" }, { "type": "null" } ] } }, "required": [ "email" ] }, "synckhub_server.routes.calendar.scheduling.CalendarMeetingSuggestionsResponse": { "title": "CalendarMeetingSuggestionsResponse", "type": "object", "properties": { "suggestions": { "$ref": "#/components/schemas/synckhub_mailcal.types.CalendarMeetingSuggestionsResult" }, "read_status": { "$ref": "#/components/schemas/synckhub_server.routes.connected_accounts.read_status.MailcalReadStatus" } }, "required": [ "suggestions", "read_status" ], "additionalProperties": false }, "synckhub_mailcal.types.CalendarMeetingSuggestionsResult": { "title": "CalendarMeetingSuggestionsResult", "type": "object", "properties": { "suggestions": { "type": "array", "items": { "$ref": "#/components/schemas/synckhub_mailcal.types.CalendarMeetingSuggestion" } }, "empty_reason": { "anyOf": [ { "type": "string" }, { "type": "null" } ] } }, "required": [ "suggestions" ] }, "synckhub_mailcal.types.CalendarMeetingSuggestion": { "title": "CalendarMeetingSuggestion", "type": "object", "properties": { "start": { "type": "string" }, "end": { "type": "string" }, "confidence": { "type": "number" }, "available": { "type": "array", "items": { "type": "string" } }, "unavailable": { "type": "array", "items": { "type": "string" } }, "resources": { "type": "array", "items": { "$ref": "#/components/schemas/synckhub_mailcal.types.CalendarResource" } }, "explanation": { "type": "string" } }, "required": [ "start", "end", "confidence", "explanation" ] }, "synckhub_mailcal.types.CalendarAvailabilityQuery": { "title": "CalendarAvailabilityQuery", "type": "object", "properties": { "start": { "type": "string" }, "end": { "type": "string" }, "time_zone": { "anyOf": [ { "type": "string" }, { "type": "null" } ] }, "interval_minutes": { "anyOf": [ { "type": "integer" }, { "type": "null" } ] }, "participants": { "type": "array", "items": { "$ref": "#/components/schemas/synckhub_mailcal.types.CalendarAvailabilityParticipant" } } }, "required": [ "start", "end" ] }, "synckhub_server.routes.calendar.scheduling.CalendarAvailabilityResponse": { "title": "CalendarAvailabilityResponse", "type": "object", "properties": { "availability": { "$ref": "#/components/schemas/synckhub_mailcal.types.CalendarAvailabilityResult" }, "read_status": { "$ref": "#/components/schemas/synckhub_server.routes.connected_accounts.read_status.MailcalReadStatus" } }, "required": [ "availability", "read_status" ], "additionalProperties": false }, "synckhub_mailcal.types.CalendarAvailabilityResult": { "title": "CalendarAvailabilityResult", "type": "object", "properties": { "schedules": { "type": "array", "items": { "$ref": "#/components/schemas/synckhub_mailcal.types.CalendarAvailabilitySchedule" } } }, "required": [ "schedules" ] }, "synckhub_mailcal.types.CalendarAvailabilitySchedule": { "title": "CalendarAvailabilitySchedule", "type": "object", "properties": { "email": { "type": "string" }, "name": { "anyOf": [ { "type": "string" }, { "type": "null" } ] }, "availability": { "type": "array", "items": { "$ref": "#/components/schemas/synckhub_mailcal.types.CalendarAvailabilityBlock" } }, "working_hours": { "anyOf": [ {}, { "type": "null" } ] }, "error": { "anyOf": [ { "type": "string" }, { "type": "null" } ] } }, "required": [ "email" ] }, "synckhub_mailcal.types.CalendarAvailabilityBlock": { "title": "CalendarAvailabilityBlock", "type": "object", "properties": { "start": { "type": "string" }, "end": { "type": "string" }, "status": { "type": "string" }, "subject": { "anyOf": [ { "type": "string" }, { "type": "null" } ] }, "location": { "anyOf": [ { "type": "string" }, { "type": "null" } ] }, "is_private": { "anyOf": [ { "type": "boolean" }, { "type": "null" } ] } }, "required": [ "start", "end", "status" ] }, "synckhub_server.routes.calendar.scheduling.CreateOnlineMeetingRequest": { "title": "CreateOnlineMeetingRequest", "type": "object", "properties": { "external_id": { "type": "string" }, "subject": { "type": "string" } }, "required": [ "external_id", "subject" ], "additionalProperties": false }, "synckhub_mailcal.types.OnlineMeeting": { "title": "OnlineMeeting", "type": "object", "properties": { "meeting_id": { "type": "string" }, "join_url": { "type": "string" }, "subject": { "anyOf": [ { "type": "string" }, { "type": "null" } ] } }, "required": [ "meeting_id", "join_url" ], "additionalProperties": false }, "synckhub_server.routes.calendar.sync.CalendarSyncJobResponse": { "title": "CalendarSyncJobResponse", "type": "object", "properties": { "account_id": { "type": "string" }, "job_id": { "type": "string" }, "status": { "type": "string" }, "terminal": { "type": "boolean", "description": "Rolling-compatibility projection of `status`. New clients use the\nstatus enum directly; remove only after every old client is gone." } }, "required": [ "account_id", "job_id", "status", "terminal" ], "additionalProperties": false }, "synckhub_server.routes.calendar.sync.SyncCalendarRequest": { "title": "SyncCalendarRequest", "type": "object", "properties": { "calendar_id": { "anyOf": [ { "type": "string" }, { "type": "null" } ] }, "calendar_ids": { "type": "array", "items": { "type": "string" } }, "start": { "type": "string" }, "end": { "type": "string" }, "page_size": { "anyOf": [ { "type": "integer", "minimum": 0 }, { "type": "null" } ] } }, "required": [ "start", "end" ], "additionalProperties": false }, "synckhub_server.routes.carddav.CreateCredentialRequest": { "title": "CreateCredentialRequest", "type": "object", "properties": { "label": { "anyOf": [ { "type": "string" }, { "type": "null" } ] } }, "additionalProperties": false }, "synckhub_server.routes.carddav.CardDavCredentialSummary": { "title": "CardDavCredentialSummary", "type": "object", "properties": { "credential_id": { "type": "string" }, "label": { "type": "string" }, "username": { "type": "string" }, "created_at": { "type": "string" }, "last_used_at": { "anyOf": [ { "type": "string" }, { "type": "null" } ] }, "revoked_at": { "anyOf": [ { "type": "string" }, { "type": "null" } ] } }, "required": [ "credential_id", "label", "username", "created_at" ] }, "synckhub_server.routes.cases.workflow.FolderWorkflowRunLogResponse": { "title": "FolderWorkflowRunLogResponse", "type": "object", "properties": { "entries": { "type": "array", "items": { "$ref": "#/components/schemas/synckhub_server.routes.cases.workflow.FolderWorkflowRunLogEntry" } } }, "required": [ "entries" ], "additionalProperties": false }, "synckhub_server.routes.cases.workflow.FolderWorkflowRunLogEntry": { "title": "FolderWorkflowRunLogEntry", "type": "object", "properties": { "log_id": { "type": "string" }, "created_at": { "type": "string" }, "actor_id": { "type": "string" }, "event_kind": { "type": "string" }, "from_pipeline_key": { "anyOf": [ { "type": "string" }, { "type": "null" } ] }, "from_stage_key": { "anyOf": [ { "type": "string" }, { "type": "null" } ] }, "to_pipeline_key": { "anyOf": [ { "type": "string" }, { "type": "null" } ] }, "to_stage_key": { "anyOf": [ { "type": "string" }, { "type": "null" } ] }, "status": { "type": "string" }, "details": {} }, "required": [ "log_id", "created_at", "actor_id", "event_kind", "status", "details" ], "additionalProperties": false }, "synckhub_server.routes.cases.workflow.CaseWorkflowVersionResponse": { "title": "CaseWorkflowVersionResponse", "type": "object", "properties": { "case_item_id": { "type": "string" }, "lifecycle_version_id": { "type": "string" }, "version_seq": { "type": "integer" }, "pinned_at": { "type": "string" }, "pinned_by": { "type": "string" }, "active_version_id": { "anyOf": [ { "type": "string" }, { "type": "null" } ] } }, "required": [ "case_item_id", "lifecycle_version_id", "version_seq", "pinned_at", "pinned_by" ], "additionalProperties": false }, "synckhub_server.routes.cases.workflow.AssignFolderWorkflowStateRequest": { "title": "AssignFolderWorkflowStateRequest", "type": "object", "properties": { "pipeline_key": { "type": "string" }, "stage_key": { "type": "string" } }, "required": [ "pipeline_key", "stage_key" ], "additionalProperties": false }, "synckhub_server.routes.cases.workflow.ApplyFolderWorkflowTransitionRequest": { "title": "ApplyFolderWorkflowTransitionRequest", "type": "object", "properties": { "pipeline_key": { "anyOf": [ { "type": "string" }, { "type": "null" } ] }, "to_stage_key": { "type": "string" }, "override_blockers": { "type": "boolean" }, "override_reason": { "anyOf": [ { "type": "string" }, { "type": "null" } ] } }, "required": [ "to_stage_key" ], "additionalProperties": false }, "synckhub_server.routes.cases.workflow.ValidateFolderWorkflowTransitionRequest": { "title": "ValidateFolderWorkflowTransitionRequest", "type": "object", "properties": { "pipeline_key": { "anyOf": [ { "type": "string" }, { "type": "null" } ] }, "to_stage_key": { "type": "string" } }, "required": [ "to_stage_key" ], "additionalProperties": false }, "synckhub_server.routes.cases.workflow.FolderWorkflowTransitionValidationResponse": { "title": "FolderWorkflowTransitionValidationResponse", "type": "object", "properties": { "allowed": { "type": "boolean" }, "from_pipeline_key": { "type": "string" }, "from_stage_key": { "type": "string" }, "to_pipeline_key": { "type": "string" }, "to_stage_key": { "type": "string" }, "to_status": { "type": "string" }, "blockers": { "type": "array", "items": { "$ref": "#/components/schemas/synckhub_server.routes.cases.workflow.FolderWorkflowTransitionBlocker" } } }, "required": [ "allowed", "from_pipeline_key", "from_stage_key", "to_pipeline_key", "to_stage_key", "to_status", "blockers" ], "additionalProperties": false }, "synckhub_server.routes.cases.workflow.FolderWorkflowTransitionBlocker": { "title": "FolderWorkflowTransitionBlocker", "type": "object", "properties": { "code": { "type": "string" }, "message": { "type": "string" }, "details": {} }, "required": [ "code", "message", "details" ], "additionalProperties": false }, "synckhub_server.routes.cases.lifecycle.SetCasesStatusRequest": { "title": "SetCasesStatusRequest", "type": "object", "properties": { "cases": { "type": "array", "items": { "$ref": "#/components/schemas/synckhub_server.routes.cases.lifecycle.CaseLifecycleTargetRequest" } } }, "required": [ "cases" ], "additionalProperties": false }, "synckhub_server.routes.cases.lifecycle.CaseLifecycleTargetRequest": { "title": "CaseLifecycleTargetRequest", "type": "object", "properties": { "item_id": { "type": "string" }, "expected_latest_revision_item_seq": { "anyOf": [ { "type": "integer" }, { "type": "null" } ] }, "status": { "anyOf": [ { "type": "string" }, { "type": "null" } ] }, "pipeline_key": { "anyOf": [ { "type": "string" }, { "type": "null" } ] }, "stage_key": { "anyOf": [ { "type": "string" }, { "type": "null" } ] } }, "required": [ "item_id" ], "additionalProperties": false }, "synckhub_server.routes.cases.lifecycle.CaseLifecycleBatchMutationResponse": { "title": "CaseLifecycleBatchMutationResponse", "type": "object", "properties": { "commit_id": { "anyOf": [ { "type": "string" }, { "type": "null" } ] }, "changed": { "type": "integer", "minimum": 0 }, "skipped": { "type": "integer", "minimum": 0 } }, "required": [ "changed", "skipped" ], "additionalProperties": false }, "synckhub_server.routes.cases.lifecycle.SetCasesLifecycleModeRequest": { "title": "SetCasesLifecycleModeRequest", "type": "object", "properties": { "lifecycle_mode": { "$ref": "#/components/schemas/synckhub_core.types.CaseLifecycleMode" }, "cases": { "type": "array", "items": { "$ref": "#/components/schemas/synckhub_server.routes.cases.lifecycle.CaseLifecycleTargetRequest" } }, "remove_matching_subtype_field": { "anyOf": [ { "type": "string" }, { "type": "null" } ] } }, "required": [ "lifecycle_mode", "cases" ], "additionalProperties": false }, "synckhub_server.routes.cases.lifecycle.InspectCanonicalCasesRequest": { "title": "InspectCanonicalCasesRequest", "type": "object", "properties": { "item_ids": { "type": "array", "items": { "type": "string" } }, "metadata_fields": { "type": "array", "items": { "type": "string" } } }, "required": [ "item_ids" ], "additionalProperties": false }, "synckhub_server.routes.cases.lifecycle.InspectCanonicalCasesResponse": { "title": "InspectCanonicalCasesResponse", "type": "object", "properties": { "cases": { "type": "array", "items": { "$ref": "#/components/schemas/synckhub_server.routes.cases.lifecycle.CanonicalCaseStateResponse" } } }, "required": [ "cases" ], "additionalProperties": false }, "synckhub_server.routes.cases.lifecycle.CanonicalCaseStateResponse": { "title": "CanonicalCaseStateResponse", "type": "object", "properties": { "item_id": { "type": "string" }, "latest_revision_item_seq": { "type": "integer" }, "item_subtype": { "type": "string" }, "lifecycle_mode": { "$ref": "#/components/schemas/synckhub_core.types.CaseLifecycleMode" }, "lifecycle_version_id": { "anyOf": [ { "type": "string" }, { "type": "null" } ] }, "pipeline_key": { "anyOf": [ { "type": "string" }, { "type": "null" } ] }, "stage_key": { "anyOf": [ { "type": "string" }, { "type": "null" } ] }, "status": { "type": "string" }, "subtype_fields": {} }, "required": [ "item_id", "latest_revision_item_seq", "item_subtype", "lifecycle_mode", "status", "subtype_fields" ], "additionalProperties": false }, "synckhub_server.routes.cases.lifecycle.BulkTransitionCasesRequest": { "title": "BulkTransitionCasesRequest", "type": "object", "properties": { "item_ids": { "type": "array", "items": { "type": "string" } }, "pipeline_key": { "anyOf": [ { "type": "string" }, { "type": "null" } ] }, "to_stage_key": { "type": "string" }, "override_blockers": { "type": "boolean" }, "override_reason": { "anyOf": [ { "type": "string" }, { "type": "null" } ] } }, "required": [ "item_ids", "to_stage_key" ], "additionalProperties": false }, "synckhub_server.routes.cases.lifecycle.CaseBulkResultResponse": { "title": "CaseBulkResultResponse", "type": "object", "properties": { "results": { "type": "array", "items": { "$ref": "#/components/schemas/synckhub_server.routes.cases.lifecycle.CaseBulkResultEntry" } } }, "required": [ "results" ], "additionalProperties": false }, "synckhub_server.routes.cases.lifecycle.CaseBulkResultEntry": { "title": "CaseBulkResultEntry", "type": "object", "properties": { "item_id": { "type": "string" }, "ok": { "type": "boolean" }, "error": { "anyOf": [ { "type": "string" }, { "type": "null" } ] }, "blocker_details": { "anyOf": [ {}, { "type": "null" } ] } }, "required": [ "item_id", "ok" ], "additionalProperties": false }, "synckhub_server.routes.cases.lifecycle.BulkAdoptCaseFoldersRequest": { "title": "BulkAdoptCaseFoldersRequest", "type": "object", "properties": { "folders": { "type": "array", "items": { "$ref": "#/components/schemas/synckhub_server.routes.cases.lifecycle.AdoptCaseFolderRequest" } } }, "required": [ "folders" ], "additionalProperties": false }, "synckhub_server.routes.cases.lifecycle.AdoptCaseFolderRequest": { "title": "AdoptCaseFolderRequest", "type": "object", "properties": { "folder_item_id": { "type": "string" }, "item_subtype": { "type": "string" }, "fields": {}, "pipeline_key": { "anyOf": [ { "type": "string" }, { "type": "null" } ] }, "stage_key": { "anyOf": [ { "type": "string" }, { "type": "null" } ] }, "status": { "anyOf": [ { "type": "string" }, { "type": "null" } ] } }, "required": [ "folder_item_id" ], "additionalProperties": false }, "synckhub_server.routes.cases.lifecycle.CaseAdoptBulkResponse": { "title": "CaseAdoptBulkResponse", "type": "object", "properties": { "results": { "type": "array", "items": { "$ref": "#/components/schemas/synckhub_server.routes.cases.lifecycle.CaseAdoptResultEntry" } } }, "required": [ "results" ], "additionalProperties": false }, "synckhub_server.routes.cases.lifecycle.CaseAdoptResultEntry": { "title": "CaseAdoptResultEntry", "type": "object", "properties": { "index": { "type": "integer", "minimum": 0 }, "ok": { "type": "boolean" }, "case": { "anyOf": [ { "$ref": "#/components/schemas/synckhub_core.types.ItemSummary" }, { "type": "null" } ] }, "error": { "anyOf": [ { "type": "string" }, { "type": "null" } ] } }, "required": [ "index", "ok" ], "additionalProperties": false }, "synckhub_server.routes.cases.lifecycle.BulkCreateCasesRequest": { "title": "BulkCreateCasesRequest", "type": "object", "properties": { "atomic_by_parent": { "type": "boolean" }, "cases": { "type": "array", "items": { "$ref": "#/components/schemas/synckhub_server.routes.cases.lifecycle.CreateCaseRequest" } } }, "required": [ "cases" ], "additionalProperties": false }, "synckhub_server.routes.cases.lifecycle.CreateCaseRequest": { "title": "CreateCaseRequest", "type": "object", "properties": { "name": { "type": "string" }, "parent_folder_id": { "anyOf": [ { "type": "string" }, { "type": "null" } ] }, "item_subtype": { "type": "string" }, "fields": {}, "pipeline_key": { "anyOf": [ { "type": "string" }, { "type": "null" } ] }, "stage_key": { "anyOf": [ { "type": "string" }, { "type": "null" } ] }, "status": { "anyOf": [ { "type": "string" }, { "type": "null" } ] } }, "required": [ "name" ], "additionalProperties": false }, "synckhub_server.routes.cases.lifecycle.CaseCreateBulkResponse": { "title": "CaseCreateBulkResponse", "type": "object", "properties": { "results": { "type": "array", "items": { "$ref": "#/components/schemas/synckhub_server.routes.cases.lifecycle.CaseCreateResultEntry" } } }, "required": [ "results" ], "additionalProperties": false }, "synckhub_server.routes.cases.lifecycle.CaseCreateResultEntry": { "title": "CaseCreateResultEntry", "type": "object", "properties": { "index": { "type": "integer", "minimum": 0 }, "ok": { "type": "boolean" }, "case": { "anyOf": [ { "$ref": "#/components/schemas/synckhub_core.types.ItemSummary" }, { "type": "null" } ] }, "commit_id": { "anyOf": [ { "type": "string" }, { "type": "null" } ] }, "error": { "anyOf": [ { "type": "string" }, { "type": "null" } ] } }, "required": [ "index", "ok" ], "additionalProperties": false }, "synckhub_server.routes.cases.views.ListCasesQuery": { "title": "ListCasesQuery", "type": "object", "properties": { "stage_key": { "anyOf": [ { "type": "string" }, { "type": "null" } ] }, "status": { "anyOf": [ { "type": "string" }, { "type": "null" } ] }, "q": { "anyOf": [ { "type": "string" }, { "type": "null" } ] }, "filters": { "anyOf": [ { "type": "string" }, { "type": "null" } ] }, "filter_clauses": { "anyOf": [ { "type": "array", "items": { "$ref": "#/components/schemas/synckhub_server.routes.cases.views.CaseFilterClause" } }, { "type": "null" } ] }, "order_by": { "anyOf": [ { "$ref": "#/components/schemas/synckhub_server.list_name_search_sql.CaseListOrderBy" }, { "type": "null" } ] }, "order_dir": { "anyOf": [ { "$ref": "#/components/schemas/synckhub_server.list_name_search_sql.CaseListOrderDir" }, { "type": "null" } ] }, "limit": { "anyOf": [ { "type": "integer" }, { "type": "null" } ] }, "cursor": { "anyOf": [ { "type": "string" }, { "type": "null" } ] }, "metadata_fields": { "anyOf": [ { "type": "array", "items": { "type": "string" } }, { "type": "null" } ] } }, "additionalProperties": false }, "synckhub_server.routes.cases.views.CaseFilterClause": { "title": "CaseFilterClause", "type": "object", "properties": { "field": { "type": "string" }, "operator": { "$ref": "#/components/schemas/synckhub_server.routes.cases.views.CaseFilterOperator" }, "values": { "type": "array", "items": { "type": "string" } } }, "required": [ "field", "operator", "values" ], "additionalProperties": false }, "synckhub_server.routes.cases.views.CaseFilterOperator": { "title": "CaseFilterOperator", "type": "string", "enum": [ "contains", "contains_any", "exact", "in" ] }, "synckhub_server.list_name_search_sql.CaseListOrderBy": { "title": "CaseListOrderBy", "type": "string", "anyOf": [ { "enum": [ "name", "case", "item_subtype", "stage", "stage_key", "status", "parent_folder_name", "updated_at" ] }, { "pattern": "^metadata:[^\\u0000]+$", "maxLength": 137 } ], "description": "Sort by a built-in field or metadata:. The metadata key must contain 1–128 UTF-8 bytes and no NUL character; the server enforces the byte limit." }, "synckhub_server.list_name_search_sql.CaseListOrderDir": { "title": "CaseListOrderDir", "type": "string", "enum": [ "asc", "desc" ] }, "synckhub_server.routes.cases.lifecycle.CaseListResponse": { "title": "CaseListResponse", "type": "object", "properties": { "cases": { "type": "array", "items": { "$ref": "#/components/schemas/synckhub_server.routes.cases.lifecycle.CaseListEntry" } }, "next_cursor": { "anyOf": [ { "type": "string" }, { "type": "null" } ] }, "page": { "anyOf": [ { "$ref": "#/components/schemas/synckhub_server.routes.CursorPaginationMeta" }, { "type": "null" } ] } }, "required": [ "cases" ], "additionalProperties": false }, "synckhub_server.routes.cases.lifecycle.CaseListEntry": { "title": "CaseListEntry", "type": "object", "properties": { "item_id": { "type": "string" }, "name": { "type": "string" }, "item_subtype": { "type": "string" }, "color_metadata": { "anyOf": [ { "type": "string" }, { "type": "null" } ] }, "lifecycle_mode": { "anyOf": [ { "$ref": "#/components/schemas/synckhub_core.types.CaseLifecycleMode" }, { "type": "null" } ] }, "pipeline_key": { "anyOf": [ { "type": "string" }, { "type": "null" } ] }, "stage_key": { "anyOf": [ { "type": "string" }, { "type": "null" } ] }, "status": { "anyOf": [ { "type": "string" }, { "type": "null" } ] }, "lifecycle_version_id": { "anyOf": [ { "type": "string" }, { "type": "null" } ] }, "last_updated_at": { "type": "string" }, "parent_folder_name": { "anyOf": [ { "type": "string" }, { "type": "null" } ] }, "metadata_json": {} }, "required": [ "item_id", "name", "item_subtype", "last_updated_at", "metadata_json" ], "additionalProperties": false }, "synckhub_server.routes.CursorPaginationMeta": { "title": "CursorPaginationMeta", "type": "object", "properties": { "limit": { "type": "integer", "minimum": 0 }, "returned": { "type": "integer", "minimum": 0 }, "offset": { "anyOf": [ { "type": "integer", "minimum": 0 }, { "type": "null" } ] }, "has_prev": { "type": "boolean" }, "has_next": { "type": "boolean" }, "next_cursor": { "anyOf": [ { "type": "string" }, { "type": "null" } ] }, "total_items": { "anyOf": [ { "type": "integer", "minimum": 0 }, { "type": "null" } ] }, "estimated_total_items": { "anyOf": [ { "type": "integer", "minimum": 0 }, { "type": "null" } ] } }, "required": [ "limit", "returned", "has_prev", "has_next" ] }, "synckhub_server.routes.cases.views.SetCaseViewDefaultRequest": { "title": "SetCaseViewDefaultRequest", "type": "object", "properties": { "view_id": { "type": "string" } }, "required": [ "view_id" ], "additionalProperties": false }, "synckhub_server.routes.cases.views.CaseViewsResponse": { "title": "CaseViewsResponse", "type": "object", "properties": { "views": { "type": "array", "items": { "$ref": "#/components/schemas/synckhub_server.routes.cases.views.CaseViewEntry" } }, "user_default_view_id": { "anyOf": [ { "type": "string" }, { "type": "null" } ] }, "repository_default_view_id": { "anyOf": [ { "type": "string" }, { "type": "null" } ] }, "can_manage_shared_views": { "type": "boolean" } }, "required": [ "views", "can_manage_shared_views" ], "additionalProperties": false }, "synckhub_server.routes.cases.views.CaseViewEntry": { "title": "CaseViewEntry", "type": "object", "properties": { "view_id": { "type": "string" }, "scope": { "$ref": "#/components/schemas/synckhub_server.routes.cases.views.CaseViewScope" }, "owner_actor_id": { "type": "string" }, "name": { "type": "string" }, "description": { "anyOf": [ { "type": "string" }, { "type": "null" } ] }, "position": { "type": "integer" }, "definition": { "$ref": "#/components/schemas/synckhub_server.routes.cases.views.CaseViewDefinition" }, "revision": { "type": "integer" }, "created_at": { "type": "string" }, "created_by": { "type": "string" }, "updated_at": { "type": "string" }, "updated_by": { "type": "string" } }, "required": [ "view_id", "scope", "owner_actor_id", "name", "position", "definition", "revision", "created_at", "created_by", "updated_at", "updated_by" ], "additionalProperties": false }, "synckhub_server.routes.cases.views.CaseViewScope": { "title": "CaseViewScope", "type": "string", "enum": [ "PERSONAL", "SHARED" ] }, "synckhub_server.routes.cases.views.CaseViewDefinition": { "title": "CaseViewDefinition", "type": "object", "properties": { "version": { "type": "integer", "minimum": 0 }, "query": { "anyOf": [ { "type": "string" }, { "type": "null" } ] }, "filters": { "type": "array", "items": { "$ref": "#/components/schemas/synckhub_server.routes.cases.views.CaseFilterClause" } }, "sort": { "anyOf": [ { "$ref": "#/components/schemas/synckhub_server.routes.cases.views.CaseViewSort" }, { "type": "null" } ] } }, "required": [ "version" ], "additionalProperties": false }, "synckhub_server.routes.cases.views.CaseViewSort": { "title": "CaseViewSort", "type": "object", "properties": { "field": { "$ref": "#/components/schemas/synckhub_server.routes.cases.views.CaseViewSortField" }, "direction": { "$ref": "#/components/schemas/synckhub_server.routes.cases.views.CaseViewSortDirection" } }, "required": [ "field", "direction" ], "additionalProperties": false }, "synckhub_server.routes.cases.views.CaseViewSortField": { "title": "CaseViewSortField", "$ref": "#/components/schemas/synckhub_server.list_name_search_sql.CaseListOrderBy" }, "synckhub_server.routes.cases.views.CaseViewSortDirection": { "title": "CaseViewSortDirection", "type": "string", "enum": [ "asc", "desc" ] }, "synckhub_server.routes.cases.views.DeleteCaseViewRequest": { "title": "DeleteCaseViewRequest", "type": "object", "properties": { "expected_revision": { "type": "integer" } }, "required": [ "expected_revision" ], "additionalProperties": false }, "synckhub_server.routes.cases.views.UpdateCaseViewRequest": { "title": "UpdateCaseViewRequest", "type": "object", "properties": { "expected_revision": { "type": "integer" }, "name": { "type": "string" }, "description": { "anyOf": [ { "type": "string" }, { "type": "null" } ] }, "definition": { "$ref": "#/components/schemas/synckhub_server.routes.cases.views.CaseViewDefinition" } }, "required": [ "expected_revision", "name", "definition" ], "additionalProperties": false }, "synckhub_server.routes.cases.views.ReorderCaseViewsRequest": { "title": "ReorderCaseViewsRequest", "type": "object", "properties": { "scope": { "$ref": "#/components/schemas/synckhub_server.routes.cases.views.CaseViewScope" }, "views": { "type": "array", "items": { "$ref": "#/components/schemas/synckhub_server.routes.cases.views.ReorderCaseViewEntry" } } }, "required": [ "scope", "views" ], "additionalProperties": false }, "synckhub_server.routes.cases.views.ReorderCaseViewEntry": { "title": "ReorderCaseViewEntry", "type": "object", "properties": { "view_id": { "type": "string" }, "expected_revision": { "type": "integer" } }, "required": [ "view_id", "expected_revision" ], "additionalProperties": false }, "synckhub_server.routes.cases.views.CreateCaseViewRequest": { "title": "CreateCaseViewRequest", "type": "object", "properties": { "scope": { "$ref": "#/components/schemas/synckhub_server.routes.cases.views.CaseViewScope" }, "name": { "type": "string" }, "description": { "anyOf": [ { "type": "string" }, { "type": "null" } ] }, "definition": { "$ref": "#/components/schemas/synckhub_server.routes.cases.views.CaseViewDefinition" } }, "required": [ "scope", "name", "definition" ], "additionalProperties": false }, "synckhub_server.routes.cases.workflow.CaseLifecycleVersionsResponse": { "title": "CaseLifecycleVersionsResponse", "type": "object", "properties": { "active_version_id": { "anyOf": [ { "type": "string" }, { "type": "null" } ] }, "versions": { "type": "array", "items": { "$ref": "#/components/schemas/synckhub_server.routes.cases.workflow.CaseLifecycleVersionEntry" } } }, "required": [ "versions" ], "additionalProperties": false }, "synckhub_server.routes.cases.workflow.CaseLifecycleVersionEntry": { "title": "CaseLifecycleVersionEntry", "type": "object", "properties": { "version_id": { "type": "string" }, "version_seq": { "type": "integer" }, "created_at": { "type": "string" }, "created_by": { "type": "string" } }, "required": [ "version_id", "version_seq", "created_at", "created_by" ], "additionalProperties": false }, "synckhub_server.routes.cases.workflow.FolderWorkflowRegistryDocument": { "title": "FolderWorkflowRegistryDocument", "type": "object", "properties": { "default_pipeline_key": { "type": "string" }, "pipelines": { "type": "array", "items": { "$ref": "#/components/schemas/synckhub_server.routes.cases.workflow.FolderWorkflowRegistryPipeline" } } }, "required": [ "default_pipeline_key", "pipelines" ], "additionalProperties": false }, "synckhub_server.routes.cases.workflow.FolderWorkflowRegistryPipeline": { "title": "FolderWorkflowRegistryPipeline", "type": "object", "properties": { "pipeline_key": { "type": "string" }, "display_name": { "type": "string" }, "stages": { "type": "array", "items": { "$ref": "#/components/schemas/synckhub_server.routes.cases.workflow.FolderWorkflowRegistryStage" } }, "transitions": { "type": "array", "items": { "$ref": "#/components/schemas/synckhub_server.routes.cases.workflow.FolderWorkflowTransitionPolicy" } } }, "required": [ "pipeline_key", "display_name", "stages" ], "additionalProperties": false }, "synckhub_server.routes.cases.workflow.FolderWorkflowRegistryStage": { "title": "FolderWorkflowRegistryStage", "type": "object", "properties": { "stage_key": { "type": "string" }, "display_name": { "type": "string" }, "is_closed_stage": { "type": "boolean" } }, "required": [ "stage_key", "display_name", "is_closed_stage" ], "additionalProperties": false }, "synckhub_server.routes.cases.workflow.FolderWorkflowTransitionPolicy": { "title": "FolderWorkflowTransitionPolicy", "type": "object", "properties": { "from_stage_key": { "type": "string" }, "to_stage_key": { "type": "string" }, "validators": { "type": "array", "items": { "$ref": "#/components/schemas/synckhub_server.routes.cases.workflow.FolderWorkflowTransitionValidator" } } }, "required": [ "from_stage_key", "to_stage_key" ], "additionalProperties": false }, "synckhub_server.routes.cases.workflow.FolderWorkflowTransitionValidator": { "title": "FolderWorkflowTransitionValidator", "oneOf": [ { "type": "object", "properties": { "kind": { "const": "REQUIRED_SUBTYPE_FIELDS" }, "field_keys": { "type": "array", "items": { "type": "string" } } }, "required": [ "kind", "field_keys" ], "additionalProperties": false } ] }, "synckhub_server.routes.cases.workflow.FolderWorkflowRegistryResponse": { "title": "FolderWorkflowRegistryResponse", "type": "object", "properties": { "configured": { "type": "boolean" }, "default_pipeline_key": { "type": "string" }, "pipelines": { "type": "array", "items": { "$ref": "#/components/schemas/synckhub_server.routes.cases.workflow.FolderWorkflowRegistryPipeline" } }, "updated_at": { "anyOf": [ { "type": "string" }, { "type": "null" } ] }, "updated_by": { "anyOf": [ { "type": "string" }, { "type": "null" } ] } }, "required": [ "configured", "default_pipeline_key", "pipelines" ], "additionalProperties": false }, "synckhub_server.routes.cases.recents.RecentCasesResponse": { "title": "RecentCasesResponse", "type": "object", "properties": { "cases": { "type": "array", "items": { "$ref": "#/components/schemas/synckhub_server.routes.cases.lifecycle.CaseListEntry" } }, "next_cursor": { "anyOf": [ { "type": "string" }, { "type": "null" } ] } }, "required": [ "cases" ] }, "synckhub_server.routes.chat.connections.ConnectedChatAdmissionBody": { "title": "ConnectedChatAdmissionBody", "type": "object", "properties": { "invite": { "$ref": "#/components/schemas/synckhub_federation_protocol.types.SignedEnvelopeV1_FederationInviteV1" }, "secret": { "anyOf": [ { "type": "string" }, { "type": "null" } ] } }, "required": [ "invite" ], "additionalProperties": false }, "synckhub_server.routes.chat.connections.RequestConnectionBody": { "title": "RequestConnectionBody", "type": "object", "properties": { "target_address": { "type": "string" } }, "required": [ "target_address" ], "additionalProperties": false }, "synckhub_server.routes.chat.files.ChatAttachmentPublishRevisionRequest": { "title": "ChatAttachmentPublishRevisionRequest", "type": "object", "properties": { "blob_id": { "type": "string" }, "size": { "anyOf": [ { "type": "integer" }, { "type": "null" } ] } }, "required": [ "blob_id" ], "additionalProperties": false }, "synckhub_core.types.SubitemSummary": { "title": "SubitemSummary", "type": "object", "properties": { "repo_id": { "type": "string", "description": "Owning repository id." }, "item_id": { "type": "string", "description": "Owning item id." }, "item_seq": { "type": "integer", "description": "Creation event sequence that identifies the subitem." }, "parent_item_seq": { "anyOf": [ { "type": "integer" }, { "type": "null" } ], "description": "Optional parent subitem sequence for nested subitems." }, "subitem_type": { "type": "string", "description": "Logical subitem type path, e.g. `VERSION`, `MESSAGE.ATTACHMENT`." }, "metadata_json": { "anyOf": [ {}, { "type": "null" } ], "description": "Optional per-subitem metadata payload when available." } }, "required": [ "repo_id", "item_id", "item_seq", "subitem_type" ], "description": "Placeholder type for subitem summaries.\n\nFuture phases will introduce concrete variants per item type\n(file versions, chat messages, attachments, etc.). For v1 scaffolding we\nonly define the container type so HTTP surfaces can depend on it." }, "synckhub_core.types.ChatAttachmentRevisionSummary": { "title": "ChatAttachmentRevisionSummary", "type": "object", "properties": { "repo_id": { "type": "string" }, "item_id": { "type": "string" }, "item_seq": { "type": "integer" }, "commit_id": { "type": "string" }, "commit_event_idx": { "type": "integer" }, "updated_at": { "type": "string" }, "updated_by": { "type": "string" } }, "required": [ "repo_id", "item_id", "item_seq", "commit_id", "commit_event_idx", "updated_at", "updated_by" ], "description": "Durable revision summary for a chat attachment (event-log backed)." }, "synckhub_server.routes.chat.files.ChatAttachmentOrganizeRequest": { "title": "ChatAttachmentOrganizeRequest", "type": "object", "properties": { "chat_file_folder_id": { "anyOf": [ { "type": "string" }, { "type": "null" } ] } }, "additionalProperties": false }, "synckhub_server.routes.chat.files.ChatAttachmentOrganizeResponse": { "title": "ChatAttachmentOrganizeResponse", "type": "object", "properties": { "attachment_item_seq": { "type": "integer" }, "chat_file_folder_id": { "anyOf": [ { "type": "string" }, { "type": "null" } ] } }, "required": [ "attachment_item_seq" ], "additionalProperties": false }, "synckhub_server.routes.chat.files.ChatFileRefResolveResponse": { "title": "ChatFileRefResolveResponse", "type": "object", "properties": { "r#ref": { "$ref": "#/components/schemas/synckhub_server.routes.chat.files.ChatMessageFileRefSummary" }, "file": { "anyOf": [ { "$ref": "#/components/schemas/synckhub_server.routes.chat.files.ChatFileEntrySummary" }, { "type": "null" } ] } }, "required": [ "r#ref" ], "additionalProperties": false }, "synckhub_server.routes.chat.files.ChatMessageFileRefSummary": { "title": "ChatMessageFileRefSummary", "type": "object", "properties": { "ref_item_seq": { "type": "integer" }, "parent_message_item_seq": { "type": "integer" }, "file_id": { "type": "string" }, "snapshot_name": { "type": "string" }, "snapshot_head_item_seq": { "anyOf": [ { "type": "integer" }, { "type": "null" } ] }, "lifecycle_state": { "type": "string" } }, "required": [ "ref_item_seq", "parent_message_item_seq", "file_id", "snapshot_name", "lifecycle_state" ], "additionalProperties": false }, "synckhub_server.routes.chat.files.ChatFileEntrySummary": { "title": "ChatFileEntrySummary", "type": "object", "properties": { "entry_id": { "type": "string" }, "entry_type": { "type": "string" }, "file_kind": { "anyOf": [ { "type": "string" }, { "type": "null" } ] }, "parent_folder_id": { "anyOf": [ { "type": "string" }, { "type": "null" } ] }, "name": { "type": "string" }, "name_key": { "type": "string" }, "lifecycle_state": { "type": "string" }, "origin_message_item_seq": { "anyOf": [ { "type": "integer" }, { "type": "null" } ] }, "linked_file_item_id": { "anyOf": [ { "type": "string" }, { "type": "null" } ] }, "create_item_seq": { "type": "integer" }, "current_head_item_seq": { "anyOf": [ { "type": "integer" }, { "type": "null" } ] }, "blob_id": { "anyOf": [ { "type": "string" }, { "type": "null" } ] }, "size": { "anyOf": [ { "type": "integer" }, { "type": "null" } ] }, "mime_type": { "anyOf": [ { "type": "string" }, { "type": "null" } ] }, "content_availability": { "anyOf": [ { "type": "string" }, { "type": "null" } ] }, "audio_duration_ms": { "anyOf": [ { "type": "integer" }, { "type": "null" } ] }, "audio_waveform": { "anyOf": [ { "type": "array", "items": { "type": "integer", "minimum": 0 } }, { "type": "null" } ] }, "lock": { "anyOf": [ { "$ref": "#/components/schemas/synckhub_server.routes.chat.files.ChatFileLockHintSummary" }, { "type": "null" } ] }, "updated_at": { "type": "string" } }, "required": [ "entry_id", "entry_type", "name", "name_key", "lifecycle_state", "create_item_seq", "updated_at" ], "additionalProperties": false }, "synckhub_server.routes.chat.files.ChatFileLockHintSummary": { "title": "ChatFileLockHintSummary", "type": "object", "properties": { "lock_type": { "type": "string" }, "owner_id": { "type": "string" }, "expires_at": { "type": "string" } }, "required": [ "lock_type", "owner_id", "expires_at" ], "additionalProperties": false }, "synckhub_server.routes.chat.files.ChatFileSpaceRestoreRevisionRequest": { "title": "ChatFileSpaceRestoreRevisionRequest", "type": "object", "properties": { "expected_head_item_seq": { "anyOf": [ { "type": "integer" }, { "type": "null" } ] }, "lock_token": { "anyOf": [ { "type": "string" }, { "type": "null" } ] }, "request_id": { "type": "string" } }, "required": [ "request_id" ], "additionalProperties": false }, "synckhub_server.routes.chat.files.ChatFileRevisionsResponse": { "title": "ChatFileRevisionsResponse", "type": "object", "properties": { "revisions": { "type": "array", "items": { "$ref": "#/components/schemas/synckhub_server.routes.chat.files.ChatFileRevisionSummary" } }, "next_offset": { "anyOf": [ { "type": "integer", "minimum": 0 }, { "type": "null" } ] } }, "required": [ "revisions" ], "additionalProperties": false }, "synckhub_server.routes.chat.files.ChatFileRevisionSummary": { "title": "ChatFileRevisionSummary", "type": "object", "properties": { "file_id": { "type": "string" }, "revision_item_seq": { "type": "integer" }, "previous_head_item_seq": { "anyOf": [ { "type": "integer" }, { "type": "null" } ] }, "blob_id": { "type": "string" }, "size": { "type": "integer" }, "mime_type": { "anyOf": [ { "type": "string" }, { "type": "null" } ] }, "upload_intent_id": { "anyOf": [ { "type": "string" }, { "type": "null" } ] }, "created_at": { "type": "string" } }, "required": [ "file_id", "revision_item_seq", "blob_id", "size", "created_at" ], "additionalProperties": false }, "synckhub_server.routes.chat.files.ChatFileSpaceReleaseLockRequest": { "title": "ChatFileSpaceReleaseLockRequest", "type": "object", "properties": { "lock_token": { "anyOf": [ { "type": "string" }, { "type": "null" } ] } }, "additionalProperties": false }, "synckhub_server.routes.chat.files.ChatFileReleaseLockResponse": { "title": "ChatFileReleaseLockResponse", "type": "object", "properties": { "released": { "type": "boolean" } }, "required": [ "released" ], "additionalProperties": false }, "synckhub_server.routes.chat.files.ChatFileSpaceAcquireLockRequest": { "title": "ChatFileSpaceAcquireLockRequest", "type": "object", "properties": { "ttl_seconds": { "anyOf": [ { "type": "integer" }, { "type": "null" } ] }, "lock_token": { "anyOf": [ { "type": "string" }, { "type": "null" } ] } }, "additionalProperties": false }, "synckhub_server.routes.chat.files.ChatFileExclusiveLockResponse": { "title": "ChatFileExclusiveLockResponse", "type": "object", "properties": { "lock_type": { "type": "string" }, "owner_id": { "type": "string" }, "lock_token": { "anyOf": [ { "type": "string" }, { "type": "null" } ] }, "created_at": { "type": "string" }, "expires_at": { "type": "string" } }, "required": [ "lock_type", "owner_id", "created_at", "expires_at" ], "additionalProperties": false }, "synckhub_server.routes.chat.files.ChatFileSpacePublishContentRequest": { "title": "ChatFileSpacePublishContentRequest", "type": "object", "properties": { "blob_id": { "type": "string" }, "size": { "type": "integer" }, "mime_type": { "anyOf": [ { "type": "string" }, { "type": "null" } ] }, "expected_head_item_seq": { "anyOf": [ { "type": "integer" }, { "type": "null" } ] }, "lock_token": { "anyOf": [ { "type": "string" }, { "type": "null" } ] }, "request_id": { "type": "string" } }, "required": [ "blob_id", "size", "request_id" ], "additionalProperties": false }, "synckhub_server.routes.chat.files.ChatFileBreadcrumbsResponse": { "title": "ChatFileBreadcrumbsResponse", "type": "object", "properties": { "breadcrumbs": { "type": "array", "items": { "$ref": "#/components/schemas/synckhub_server.routes.chat.files.ChatFileBreadcrumbSummary" } } }, "required": [ "breadcrumbs" ], "additionalProperties": false }, "synckhub_server.routes.chat.files.ChatFileBreadcrumbSummary": { "title": "ChatFileBreadcrumbSummary", "type": "object", "properties": { "entry_id": { "anyOf": [ { "type": "string" }, { "type": "null" } ] }, "name": { "type": "string" } }, "required": [ "name" ], "additionalProperties": false }, "synckhub_server.routes.chat.files.ChatFileSpaceRestoreEntryRequest": { "title": "ChatFileSpaceRestoreEntryRequest", "type": "object", "properties": { "target_parent_folder_id": { "anyOf": [ {}, { "type": "null" } ] }, "recursive": { "type": "boolean" }, "request_id": { "type": "string" } }, "required": [ "request_id" ], "additionalProperties": false }, "synckhub_server.routes.chat.files.ChatFileSpaceRestoreResponse": { "title": "ChatFileSpaceRestoreResponse", "type": "object", "properties": { "restored": { "type": "array", "items": { "$ref": "#/components/schemas/synckhub_server.routes.chat.files.ChatFileEntrySummary" } } }, "required": [ "restored" ], "additionalProperties": false }, "synckhub_server.routes.chat.files.ChatFileSpaceTrashEntryRequest": { "title": "ChatFileSpaceTrashEntryRequest", "type": "object", "properties": { "recursive": { "type": "boolean" }, "request_id": { "type": "string" } }, "required": [ "request_id" ], "additionalProperties": false }, "synckhub_server.routes.chat.files.ChatFileSpaceTrashResponse": { "title": "ChatFileSpaceTrashResponse", "type": "object", "properties": { "trashed": { "type": "array", "items": { "$ref": "#/components/schemas/synckhub_server.routes.chat.files.ChatFileEntrySummary" } } }, "required": [ "trashed" ], "additionalProperties": false }, "synckhub_server.routes.chat.files.ChatFileSpaceUpdateEntryRequest": { "title": "ChatFileSpaceUpdateEntryRequest", "type": "object", "properties": { "name": { "anyOf": [ { "type": "string" }, { "type": "null" } ] }, "parent_folder_id": { "anyOf": [ {}, { "type": "null" } ] }, "request_id": { "type": "string" } }, "required": [ "request_id" ], "additionalProperties": false }, "synckhub_server.routes.chat.files.ChatFileSearchResponse": { "title": "ChatFileSearchResponse", "type": "object", "properties": { "hits": { "type": "array", "items": { "$ref": "#/components/schemas/synckhub_server.routes.chat.files.ChatFileEntrySummary" } }, "next_offset": { "anyOf": [ { "type": "integer", "minimum": 0 }, { "type": "null" } ] } }, "required": [ "hits" ], "additionalProperties": false }, "synckhub_server.routes.chat.files.ChatFileSpaceCreateFileLinkRequest": { "title": "ChatFileSpaceCreateFileLinkRequest", "type": "object", "properties": { "name": { "type": "string" }, "parent_folder_id": { "anyOf": [ { "type": "string" }, { "type": "null" } ] }, "linked_file_item_id": { "type": "string" }, "request_id": { "type": "string" } }, "required": [ "name", "linked_file_item_id", "request_id" ], "additionalProperties": false }, "synckhub_server.routes.chat.files.ChatFileSpaceFolderManifestRequest": { "title": "ChatFileSpaceFolderManifestRequest", "type": "object", "properties": { "request_id": { "type": "string" }, "parent_folder_id": { "anyOf": [ { "type": "string" }, { "type": "null" } ] }, "folders": { "type": "array", "items": { "$ref": "#/components/schemas/synckhub_server.routes.chat.files.ChatFileSpaceFolderManifestFolder" } }, "files": { "type": "array", "items": { "$ref": "#/components/schemas/synckhub_server.routes.chat.files.ChatFileSpaceFolderManifestFile" } } }, "required": [ "request_id" ], "additionalProperties": false }, "synckhub_server.routes.chat.files.ChatFileSpaceFolderManifestFolder": { "title": "ChatFileSpaceFolderManifestFolder", "type": "object", "properties": { "folder_id": { "type": "string" }, "parent_folder_id": { "anyOf": [ { "type": "string" }, { "type": "null" } ] }, "name": { "type": "string" } }, "required": [ "folder_id", "name" ], "additionalProperties": false }, "synckhub_server.routes.chat.files.ChatFileSpaceFolderManifestFile": { "title": "ChatFileSpaceFolderManifestFile", "type": "object", "properties": { "file_id": { "type": "string" }, "parent_folder_id": { "anyOf": [ { "type": "string" }, { "type": "null" } ] }, "name": { "type": "string" }, "blob_id": { "type": "string" }, "size": { "type": "integer" }, "mime_type": { "anyOf": [ { "type": "string" }, { "type": "null" } ] } }, "required": [ "file_id", "name", "blob_id", "size" ], "additionalProperties": false }, "synckhub_server.routes.chat.files.ChatFileSpaceFolderManifestResponse": { "title": "ChatFileSpaceFolderManifestResponse", "type": "object", "properties": { "entries": { "type": "array", "items": { "$ref": "#/components/schemas/synckhub_server.routes.chat.files.ChatFileEntrySummary" } } }, "required": [ "entries" ], "additionalProperties": false }, "synckhub_server.routes.chat.files.ChatFileSpaceCreateFileRequest": { "title": "ChatFileSpaceCreateFileRequest", "type": "object", "properties": { "name": { "type": "string" }, "parent_folder_id": { "anyOf": [ { "type": "string" }, { "type": "null" } ] }, "blob_id": { "type": "string" }, "size": { "type": "integer" }, "mime_type": { "anyOf": [ { "type": "string" }, { "type": "null" } ] }, "request_id": { "type": "string" } }, "required": [ "name", "blob_id", "size", "request_id" ], "additionalProperties": false }, "synckhub_server.routes.chat.files.ChatFileSpaceCreateFolderRequest": { "title": "ChatFileSpaceCreateFolderRequest", "type": "object", "properties": { "name": { "type": "string" }, "parent_folder_id": { "anyOf": [ { "type": "string" }, { "type": "null" } ] }, "request_id": { "type": "string" } }, "required": [ "name", "request_id" ], "additionalProperties": false }, "synckhub_server.routes.chat.files.ChatFileChildrenResponse": { "title": "ChatFileChildrenResponse", "type": "object", "properties": { "entries": { "type": "array", "items": { "$ref": "#/components/schemas/synckhub_server.routes.chat.files.ChatFileEntrySummary" } }, "next_offset": { "anyOf": [ { "type": "integer", "minimum": 0 }, { "type": "null" } ] } }, "required": [ "entries" ], "additionalProperties": false }, "synckhub_server.routes.files.content.CreateDownloadUrlResponse": { "title": "CreateDownloadUrlResponse", "type": "object", "properties": { "url": { "type": "string", "description": "Absolute URL suitable for browser navigation/download." }, "path": { "type": "string", "description": "Relative path (handy for in-process tests or callers that already know the base URL)." }, "expires_at": { "type": "string" }, "download_name": { "type": "string" }, "blob_id": { "anyOf": [ { "type": "string" }, { "type": "null" } ] }, "size_bytes": { "anyOf": [ { "type": "integer", "minimum": 0 }, { "type": "null" } ] } }, "required": [ "url", "path", "expires_at", "download_name" ] }, "synckhub_server.routes.chat.files.ChatAudioPreviewResponse": { "title": "ChatAudioPreviewResponse", "type": "object", "properties": { "duration_ms": { "type": "integer" }, "waveform": { "type": "array", "items": { "type": "integer", "minimum": 0 } } }, "required": [ "duration_ms", "waveform" ], "additionalProperties": false }, "synckhub_server.routes.chat.files.ChatFilesResponse": { "title": "ChatFilesResponse", "type": "object", "properties": { "files": { "type": "array", "items": { "$ref": "#/components/schemas/synckhub_server.routes.chat.files.ChatFileSummary" } } }, "required": [ "files" ], "additionalProperties": false }, "synckhub_server.routes.chat.files.ChatFileSummary": { "title": "ChatFileSummary", "type": "object", "properties": { "attachment_item_seq": { "type": "integer" }, "message_item_seq": { "type": "integer" }, "kind": { "type": "string" }, "chat_file_folder_id": { "anyOf": [ { "type": "string" }, { "type": "null" } ] }, "display_name": { "type": "string" }, "blob_id": { "anyOf": [ { "type": "string" }, { "type": "null" } ] }, "file_item_id": { "anyOf": [ { "type": "string" }, { "type": "null" } ] }, "size": { "anyOf": [ { "type": "integer" }, { "type": "null" } ] }, "meta": {}, "sender_id": { "type": "string" }, "sender_label": { "anyOf": [ { "type": "string" }, { "type": "null" } ] }, "message_created_at": { "type": "string" } }, "required": [ "attachment_item_seq", "message_item_seq", "kind", "display_name", "meta", "sender_id", "message_created_at" ], "additionalProperties": false }, "synckhub_server.routes.chat.files.ChatFileFolderSummary": { "title": "ChatFileFolderSummary", "type": "object", "properties": { "folder_id": { "type": "string" }, "item_seq": { "type": "integer" }, "name": { "type": "string" }, "name_key": { "type": "string" }, "lifecycle_state": { "type": "string" }, "created_at": { "type": "string" }, "updated_at": { "type": "string" } }, "required": [ "folder_id", "item_seq", "name", "name_key", "lifecycle_state", "created_at", "updated_at" ], "additionalProperties": false }, "synckhub_server.routes.chat.files.ChatFileFolderWriteRequest": { "title": "ChatFileFolderWriteRequest", "type": "object", "properties": { "name": { "type": "string" } }, "required": [ "name" ], "additionalProperties": false }, "synckhub_server.routes.chat.files.ChatFileFoldersResponse": { "title": "ChatFileFoldersResponse", "type": "object", "properties": { "folders": { "type": "array", "items": { "$ref": "#/components/schemas/synckhub_server.routes.chat.files.ChatFileFolderSummary" } } }, "required": [ "folders" ], "additionalProperties": false }, "synckhub_server.routes.chat.messages.ChatSearchResponse": { "title": "ChatSearchResponse", "type": "object", "properties": { "hits": { "type": "array", "items": { "$ref": "#/components/schemas/synckhub_server.routes.chat.messages.ChatSearchHit" } }, "meta": { "$ref": "#/components/schemas/synckhub_server.routes.chat.messages.ChatSearchMeta" } }, "required": [ "hits", "meta" ], "additionalProperties": false }, "synckhub_server.routes.chat.messages.ChatSearchHit": { "title": "ChatSearchHit", "type": "object", "properties": { "item_seq": { "type": "integer" }, "doc_id": { "type": "string" }, "score": { "anyOf": [ { "type": "number" }, { "type": "null" } ] }, "snippet": { "anyOf": [ { "type": "string" }, { "type": "null" } ] }, "sender_id": { "anyOf": [ { "type": "string" }, { "type": "null" } ] }, "sender_label": { "anyOf": [ { "type": "string" }, { "type": "null" } ] }, "created_at": { "anyOf": [ { "type": "string" }, { "type": "null" } ] } }, "required": [ "item_seq", "doc_id" ], "additionalProperties": false }, "synckhub_server.routes.chat.messages.ChatSearchMeta": { "title": "ChatSearchMeta", "type": "object", "properties": { "estimated_total_hits": { "anyOf": [ { "type": "integer" }, { "type": "null" } ] }, "processing_time_ms": { "anyOf": [ { "type": "integer" }, { "type": "null" } ] } }, "additionalProperties": false }, "synckhub_server.routes.chat.messages.ChatMessageFilter": { "title": "ChatMessageFilter", "type": "string", "enum": [ "all", "unread", "sent", "received" ] }, "synckhub_server.routes.ai.tools.ChatReadResponse": { "title": "ChatReadResponse", "type": "object", "properties": { "messages": { "type": "array", "items": { "$ref": "#/components/schemas/synckhub_server.routes.chat.messages.ChatMessageSummary" } }, "ai_runs": { "type": "array", "items": { "$ref": "#/components/schemas/synckhub_server.routes.ai.tools.ChatAiRunReadBundle" } } }, "required": [ "messages", "ai_runs" ], "additionalProperties": false }, "synckhub_server.routes.chat.messages.ChatMessageSummary": { "title": "ChatMessageSummary", "type": "object", "properties": { "item_seq": { "type": "integer" }, "marked_for_later": { "type": "boolean" }, "sender_id": { "type": "string" }, "sender_label": { "anyOf": [ { "type": "string" }, { "type": "null" } ] }, "body": { "type": "string" }, "metadata_json": {}, "reply_to_item_seq": { "anyOf": [ { "type": "integer" }, { "type": "null" } ] }, "mentions": { "type": "array", "items": { "$ref": "#/components/schemas/synckhub_server.routes.chat.messages.ChatMessageMentionSummary" } }, "created_at": { "type": "string" }, "edited_at": { "anyOf": [ { "type": "string" }, { "type": "null" } ] }, "lifecycle_state": { "type": "string" }, "reactions": { "type": "array", "items": { "$ref": "#/components/schemas/synckhub_server.routes.chat.messages.ChatMessageReactionSummary" } }, "attachments": { "type": "array", "items": { "$ref": "#/components/schemas/synckhub_server.routes.chat.files.ChatMessageAttachmentSummary" } }, "reply_preview": { "anyOf": [ { "$ref": "#/components/schemas/synckhub_server.routes.chat.messages.ChatReplyPreviewSummary" }, { "type": "null" } ] } }, "required": [ "item_seq", "marked_for_later", "sender_id", "body", "metadata_json", "mentions", "created_at", "lifecycle_state", "reactions", "attachments" ], "additionalProperties": false }, "synckhub_server.routes.chat.messages.ChatMessageMentionSummary": { "title": "ChatMessageMentionSummary", "type": "object", "properties": { "user_id": { "type": "string" }, "label": { "type": "string" }, "start": { "type": "integer" }, "end": { "type": "integer" } }, "required": [ "user_id", "label", "start", "end" ], "additionalProperties": false }, "synckhub_server.routes.chat.messages.ChatMessageReactionSummary": { "title": "ChatMessageReactionSummary", "type": "object", "properties": { "item_seq": { "type": "integer" }, "reactor_id": { "type": "string" }, "emoji": { "type": "string" }, "created_at": { "type": "string" } }, "required": [ "item_seq", "reactor_id", "emoji", "created_at" ], "additionalProperties": false }, "synckhub_server.routes.chat.files.ChatMessageAttachmentSummary": { "title": "ChatMessageAttachmentSummary", "type": "object", "properties": { "item_seq": { "type": "integer" }, "kind": { "type": "string" }, "blob_id": { "anyOf": [ { "type": "string" }, { "type": "null" } ] }, "file_item_id": { "anyOf": [ { "type": "string" }, { "type": "null" } ] }, "chat_file_folder_id": { "anyOf": [ { "type": "string" }, { "type": "null" } ] }, "chat_file_id": { "anyOf": [ { "type": "string" }, { "type": "null" } ] }, "current_head_item_seq": { "anyOf": [ { "type": "integer" }, { "type": "null" } ] }, "thumbnail_width_px": { "anyOf": [ { "type": "integer" }, { "type": "null" } ] }, "thumbnail_height_px": { "anyOf": [ { "type": "integer" }, { "type": "null" } ] }, "audio_duration_ms": { "anyOf": [ { "type": "integer" }, { "type": "null" } ] }, "audio_waveform": { "anyOf": [ { "type": "array", "items": { "type": "integer", "minimum": 0 } }, { "type": "null" } ] }, "size": { "anyOf": [ { "type": "integer" }, { "type": "null" } ] }, "meta": {} }, "required": [ "item_seq", "kind", "meta" ], "additionalProperties": false }, "synckhub_server.routes.chat.messages.ChatReplyPreviewSummary": { "title": "ChatReplyPreviewSummary", "type": "object", "properties": { "item_seq": { "type": "integer" }, "sender_id": { "type": "string" }, "sender_label": { "anyOf": [ { "type": "string" }, { "type": "null" } ] }, "body": { "type": "string" }, "lifecycle_state": { "type": "string" }, "attachments": { "type": "array", "items": { "$ref": "#/components/schemas/synckhub_server.routes.chat.files.ChatMessageAttachmentSummary" } } }, "required": [ "item_seq", "sender_id", "body", "lifecycle_state", "attachments" ], "additionalProperties": false }, "synckhub_server.routes.ai.tools.ChatAiRunReadBundle": { "title": "ChatAiRunReadBundle", "type": "object", "properties": { "run": { "$ref": "#/components/schemas/synckhub_server.routes.ai.runs.AiRunStateResponse" }, "events": { "type": "array", "items": { "$ref": "#/components/schemas/synckhub_server.routes.ai.runs.AiRunEventResponse" } } }, "required": [ "run", "events" ], "additionalProperties": false }, "synckhub_server.routes.chat.messages.ChatMessageMarkerResponse": { "title": "ChatMessageMarkerResponse", "type": "object", "properties": { "message_item_seq": { "type": "integer" }, "marked_for_later": { "type": "boolean" } }, "required": [ "message_item_seq", "marked_for_later" ], "additionalProperties": false }, "synckhub_server.routes.chat.participants.ChatParticipantsResponse": { "title": "ChatParticipantsResponse", "type": "object", "properties": { "participants": { "type": "array", "items": { "$ref": "#/components/schemas/synckhub_server.routes.chat.participants.ChatParticipantSummary" } }, "intents": { "type": "array", "items": { "$ref": "#/components/schemas/synckhub_server.routes.chat.participants.ChatParticipantIntentSummary" } }, "chat_kind": { "type": "string" }, "item_acl_mode": { "type": "string" }, "self_join_role": { "anyOf": [ { "type": "string" }, { "type": "null" } ] }, "can_leave": { "type": "boolean" } }, "required": [ "participants", "chat_kind", "item_acl_mode", "can_leave" ], "additionalProperties": false }, "synckhub_server.routes.chat.participants.ChatParticipantSummary": { "title": "ChatParticipantSummary", "type": "object", "properties": { "kind": { "type": "string" }, "intent_id": { "anyOf": [ { "type": "string" }, { "type": "null" } ] }, "user_id": { "anyOf": [ { "type": "string" }, { "type": "null" } ] }, "tenant_id": { "anyOf": [ { "type": "string" }, { "type": "null" } ] }, "assistant_id": { "anyOf": [ { "type": "string" }, { "type": "null" } ] }, "group_id": { "anyOf": [ { "type": "string" }, { "type": "null" } ] }, "system_group_kind": { "anyOf": [ { "type": "string" }, { "type": "null" } ] }, "display_name": { "anyOf": [ { "type": "string" }, { "type": "null" } ] }, "role": { "anyOf": [ { "type": "string" }, { "type": "null" } ] }, "status": { "anyOf": [ { "type": "string" }, { "type": "null" } ] }, "address": { "anyOf": [ { "type": "string" }, { "type": "null" } ] }, "removable": { "anyOf": [ { "type": "boolean" }, { "type": "null" } ] } }, "required": [ "kind" ], "additionalProperties": false }, "synckhub_server.routes.chat.participants.ChatParticipantIntentSummary": { "title": "ChatParticipantIntentSummary", "type": "object", "properties": { "intent_id": { "type": "string" }, "address": { "type": "string" }, "address_key": { "type": "string" }, "role": { "type": "string" }, "status": { "type": "string" }, "user_id": { "anyOf": [ { "type": "string" }, { "type": "null" } ] }, "tenant_id": { "anyOf": [ { "type": "string" }, { "type": "null" } ] }, "canonical_address": { "anyOf": [ { "type": "string" }, { "type": "null" } ] }, "common_invite_id": { "anyOf": [ { "type": "string" }, { "type": "null" } ] }, "federation_stream_id": { "anyOf": [ { "type": "string" }, { "type": "null" } ] }, "clearinghouse_invite_id": { "anyOf": [ { "type": "string" }, { "type": "null" } ] }, "last_error_code": { "anyOf": [ { "type": "string" }, { "type": "null" } ] }, "last_error_message": { "anyOf": [ { "type": "string" }, { "type": "null" } ] }, "created_at": { "type": "string" }, "updated_at": { "type": "string" } }, "required": [ "intent_id", "address", "address_key", "role", "status", "created_at", "updated_at" ], "additionalProperties": false }, "synckhub_server.routes.chat.participants.ChatAssistantParticipantRequest": { "title": "ChatAssistantParticipantRequest", "type": "object", "properties": { "assistant_id": { "type": "string" } }, "required": [ "assistant_id" ], "additionalProperties": false }, "synckhub_server.routes.chat.participants.ChatMembershipCommand": { "title": "ChatMembershipCommand", "type": "object", "properties": { "request_uuid": { "type": "string" } }, "required": [ "request_uuid" ], "additionalProperties": false }, "synckhub_server.routes.chat.participants.ChatJoinResponse": { "title": "ChatJoinResponse", "type": "object", "properties": { "role": { "type": "string" } }, "required": [ "role" ], "additionalProperties": false }, "synckhub_server.routes.chat.participants.ChatParticipantAddRequest": { "title": "ChatParticipantAddRequest", "type": "object", "properties": { "participants": { "type": "array", "items": { "$ref": "#/components/schemas/synckhub_server.routes.chat.participants.ChatParticipantAddEntry" } }, "request_id": { "anyOf": [ { "type": "string" }, { "type": "null" } ] } }, "required": [ "participants" ], "additionalProperties": false }, "synckhub_server.routes.chat.participants.ChatParticipantAddEntry": { "title": "ChatParticipantAddEntry", "type": "object", "properties": { "address": { "type": "string" }, "role": { "anyOf": [ { "type": "string" }, { "type": "null" } ] } }, "required": [ "address" ], "additionalProperties": false }, "synckhub_server.routes.chat.rooms.ChatStateResponse": { "title": "ChatStateResponse", "type": "object", "properties": { "repo_id": { "type": "string" }, "chat_item_id": { "type": "string" }, "chat_kind": { "type": "string" }, "display": { "$ref": "#/components/schemas/synckhub_server.routes.chat.rooms.ChatDisplaySummary" }, "me": { "$ref": "#/components/schemas/synckhub_server.routes.chat.rooms.ChatReadStateSummary" }, "unread_count": { "type": "integer" }, "thread": { "$ref": "#/components/schemas/synckhub_server.routes.chat.rooms.ChatThreadAggregates" } }, "required": [ "repo_id", "chat_item_id", "chat_kind", "display", "me", "unread_count", "thread" ], "additionalProperties": false }, "synckhub_server.routes.chat.rooms.ChatDisplaySummary": { "title": "ChatDisplaySummary", "type": "object", "properties": { "title": { "type": "string" }, "subtitle": { "anyOf": [ { "type": "string" }, { "type": "null" } ] }, "avatar": { "anyOf": [ {}, { "type": "null" } ] }, "metadata_item_seq": { "anyOf": [ { "type": "integer" }, { "type": "null" } ] }, "subject_kind": { "type": "string" }, "subject_user_id": { "anyOf": [ { "type": "string" }, { "type": "null" } ] }, "participant_scope": { "anyOf": [ { "type": "string" }, { "type": "null" } ] } }, "required": [ "title", "subject_kind" ], "additionalProperties": false }, "synckhub_server.routes.chat.rooms.ChatReadStateSummary": { "title": "ChatReadStateSummary", "type": "object", "properties": { "repo_id": { "type": "string" }, "chat_item_id": { "type": "string" }, "user_id": { "type": "string" }, "last_read_item_seq": { "type": "integer" }, "marked_unread": { "type": "boolean" }, "hidden": { "type": "boolean" }, "updated_at": { "type": "string" } }, "required": [ "repo_id", "chat_item_id", "user_id", "last_read_item_seq", "marked_unread", "hidden", "updated_at" ], "additionalProperties": false }, "synckhub_server.routes.chat.rooms.ChatThreadAggregates": { "title": "ChatThreadAggregates", "type": "object", "properties": { "message_count": { "type": "integer" }, "last_message_item_seq": { "anyOf": [ { "type": "integer" }, { "type": "null" } ] }, "last_message_at": { "anyOf": [ { "type": "string" }, { "type": "null" } ] }, "last_message_preview": { "anyOf": [ { "type": "string" }, { "type": "null" } ] }, "last_sender_id": { "anyOf": [ { "type": "string" }, { "type": "null" } ] }, "last_sender_label": { "anyOf": [ { "type": "string" }, { "type": "null" } ] } }, "required": [ "message_count" ], "additionalProperties": false }, "synckhub_server.routes.chat.rooms.ChatReadStateEntry": { "title": "ChatReadStateEntry", "type": "object", "properties": { "user_id": { "type": "string" }, "last_read_item_seq": { "type": "integer" }, "received_item_seq": { "anyOf": [ { "type": "integer" }, { "type": "null" } ] }, "updated_at": { "type": "string" } }, "required": [ "user_id", "last_read_item_seq", "updated_at" ], "additionalProperties": false }, "synckhub_server.routes.chat.rooms.ChatSetReadStateRequest": { "title": "ChatSetReadStateRequest", "type": "object", "properties": { "last_read_item_seq": { "type": "integer" }, "marked_unread": { "type": "boolean" } }, "required": [ "last_read_item_seq" ], "additionalProperties": false }, "synckhub_server.routes.chat.rooms.ChatSetReadStateResponse": { "title": "ChatSetReadStateResponse", "type": "object", "properties": { "repo_id": { "type": "string" }, "chat_item_id": { "type": "string" }, "user_id": { "type": "string" }, "last_read_item_seq": { "type": "integer" }, "marked_unread": { "type": "boolean" }, "hidden": { "type": "boolean" }, "updated_at": { "type": "string" }, "unread_count": { "type": "integer" } }, "required": [ "repo_id", "chat_item_id", "user_id", "last_read_item_seq", "marked_unread", "hidden", "updated_at", "unread_count" ], "additionalProperties": false }, "synckhub_server.routes.chat.rooms.ChatTypingRequest": { "title": "ChatTypingRequest", "type": "object", "properties": { "is_typing": { "type": "boolean", "description": "When omitted, the server treats this as `true`." } }, "additionalProperties": false }, "synckhub_server.routes.chat.rooms.CreateChatIdentityInviteRequest": { "title": "CreateChatIdentityInviteRequest", "type": "object", "properties": { "address": { "type": "string" } }, "required": [ "address" ], "additionalProperties": false }, "synckhub_server.routes.chat.rooms.CreateChatIdentityInviteResponse": { "title": "CreateChatIdentityInviteResponse", "type": "object", "properties": { "status": { "type": "string" }, "address": { "type": "string" } }, "required": [ "status", "address" ], "additionalProperties": false }, "synckhub_server.routes.chat.rooms.ChatUnreadSummary": { "title": "ChatUnreadSummary", "type": "object", "properties": { "total_chats": { "type": "integer" }, "unread_chats": { "type": "integer" }, "unread_messages": { "type": "integer" } }, "required": [ "total_chats", "unread_chats", "unread_messages" ], "additionalProperties": false }, "synckhub_server.routes.chat.rooms.CreateChatRequest": { "title": "CreateChatRequest", "type": "object", "properties": { "chat_kind": { "type": "string" }, "name": { "anyOf": [ { "type": "string" }, { "type": "null" } ] }, "parent_folder_id": { "anyOf": [ { "type": "string" }, { "type": "null" } ] }, "participants": { "type": "array", "items": { "$ref": "#/components/schemas/synckhub_server.routes.chat.participants.ChatParticipantAddEntry" } }, "assistant_id": { "anyOf": [ { "type": "string" }, { "type": "null" } ] }, "request_id": { "anyOf": [ { "type": "string" }, { "type": "null" } ] } }, "required": [ "chat_kind" ], "additionalProperties": false }, "synckhub_server.routes.chat.rooms.ChatListEntry": { "title": "ItemSummary", "type": "object", "properties": { "chat_item_id": { "type": "string" }, "chat_kind": { "type": "string" }, "display": { "$ref": "#/components/schemas/synckhub_server.routes.chat.rooms.ChatDisplaySummary" }, "thread": { "$ref": "#/components/schemas/synckhub_server.routes.chat.rooms.ChatThreadAggregates" }, "repo_id": { "type": "string" }, "mount_id": { "anyOf": [ { "type": "string" }, { "type": "null" } ], "description": "Optional mount attribution for items stored in federated-folder mirror repos.\n\nWhen present, this item should be treated as belonging to the mount (`mount_id`) within\nthe calling actor's `repo_id` context." }, "quick_access": { "type": "boolean", "description": "Per-user quick access flag (\"pinned\") in the *request repo* context.\n\nThis is a platform overlay (not Synck VCS history). When no authenticated\nprincipal is present, servers should return `false`." }, "item_id": { "type": "string", "description": "Item identifier in string form (`ItemId`)." }, "item_type": { "type": "string" }, "item_subtype": { "type": "string", "description": "Repo-scoped subtype classification key (`STANDARD` by default)." }, "name": { "type": "string" }, "file_extension": { "anyOf": [ { "type": "string" }, { "type": "null" } ], "description": "Lowercased file extension without leading dot for `FILE` items, if any.\n\nDerived from `name` by the platform; non-FILE items return `null`." }, "file_stem": { "anyOf": [ { "type": "string" }, { "type": "null" } ], "description": "Convenience \"stem\" for `FILE` items (the name without the `.` suffix).\n\nThis exists so UIs can display a file list with separate \"Name\" and \"Extension\" columns\nwithout re-implementing suffix stripping logic in every client.\n\nFor `FILE` items, this is set when `file_extension` is present and `name` ends with\n`.` (ASCII case-insensitive); the suffix is stripped.\nNon-FILE items return `null`." }, "parent_folder_id": { "anyOf": [ { "type": "string" }, { "type": "null" } ], "description": "Parent folder identifier, if any, as an `ItemId` string." }, "path": { "type": "string", "description": "Raw `platform_items.path` `ltree` string (`.`-separated chain of ancestor folder ids,\nfollowed by the item's own id)." }, "breadcrumbs": { "anyOf": [ { "type": "array", "items": { "$ref": "#/components/schemas/synckhub_core.types.BreadcrumbEntry" } }, { "type": "null" } ], "description": "Optional human-friendly breadcrumb chain (ancestor folders + this item).\n\nThis is not included by default; HTTP surfaces can populate it behind an\nexplicit `include=breadcrumbs`/`fields=` knob." }, "lifecycle_state": { "type": "string", "description": "Lifecycle state for this item: `LIVE`, `TRASH`, or `TOMBSTONED`." }, "item_acl_mode": { "anyOf": [ { "type": "string" }, { "type": "null" } ], "description": "Effective item access mode. Omitted only on legacy/internal surfaces that do not project it." }, "size": { "anyOf": [ { "type": "integer" }, { "type": "null" } ], "description": "Optional aggregate size in bytes (primarily for FILE items)." }, "latest_revision_item_seq": { "anyOf": [ { "type": "integer" }, { "type": "null" } ], "description": "Latest per-item event sequence (`vcs_items.head_seq`).\n\nThis is the user-visible item revision number. For FILE rows it can be\nnewer than `head_revision_item_seq` when metadata, name, parent, trash,\nor other non-content events happened after the latest content write." }, "head_revision_item_seq": { "anyOf": [ { "type": "integer" }, { "type": "null" } ], "description": "Current FILE content-head revision sequence (`platform_items.content_item_seq`).\n\nThis is a cheap materialized scalar on the item row. Non-FILE items, and\nFILE rows with no content head yet, return `null`." }, "head_named_version": { "anyOf": [ { "$ref": "#/components/schemas/synckhub_core.types.FileHeadNamedVersionSummary" }, { "type": "null" } ], "description": "LIVE named-version label that currently points at the FILE content head.\n\nThis is not included by default on list responses. HTTP list surfaces may\npopulate it behind `include=head_named_version`." }, "latest_named_version": { "anyOf": [ { "$ref": "#/components/schemas/synckhub_core.types.FileHeadNamedVersionSummary" }, { "type": "null" } ], "description": "Latest LIVE named-version label for the FILE, regardless of whether it points\nat the current FILE content head.\n\nThis is not included by default on list responses. HTTP list surfaces may\npopulate it behind `include=latest_named_version`." }, "color_metadata": { "anyOf": [ { "type": "string" }, { "type": "null" } ], "description": "Durable item color tag derived from top-level `metadata_json.color_metadata`.\n\nValid values are `yellow`, `orange`, `red`, `purple`, `blue`, `green`, or `null`." }, "metadata_json": { "anyOf": [ {}, { "type": "null" } ], "description": "Raw item metadata, returned only on surfaces that explicitly request it." }, "last_updated_at": { "anyOf": [ { "type": "string" }, { "type": "null" } ], "description": "RFC3339 UTC timestamp when this item was last updated." }, "item_date_at": { "anyOf": [ { "type": "string" }, { "type": "null" } ], "description": "RFC3339 UTC timestamp used by Explorer Date ordering.\n\nThis is a rebuildable projection. Rolling-compatible clients fall back to\n`last_updated_at` when an older or synthetic response omits it." }, "item_date_kind": { "anyOf": [ { "type": "string" }, { "type": "null" } ], "description": "Source selected by the item-Date projection." }, "last_updated_by": { "anyOf": [ { "type": "string" }, { "type": "null" } ], "description": "Actor id who last updated the item." }, "core_workflow": { "anyOf": [ { "$ref": "#/components/schemas/synckhub_core.types.ItemSummaryCoreWorkflow" }, { "type": "null" } ], "description": "Canonical workflow projection for folder dashboards/editing." }, "me": { "anyOf": [ { "$ref": "#/components/schemas/synckhub_core.types.ItemSummaryChatMe" }, { "type": "null" } ], "description": "Per-user chat read state for `CHAT` items (present only for authenticated callers)." }, "email_summary": { "anyOf": [ { "$ref": "#/components/schemas/synckhub_core.types.ItemSummaryEmail" }, { "type": "null" } ], "description": "Mail-shaped summary for archived `EMAIL` rows on explicit email-only list surfaces." }, "unread_count": { "anyOf": [ { "type": "integer" }, { "type": "null" } ], "description": "Per-user unread count for `CHAT` items (present only for authenticated callers)." }, "locks": { "type": "array", "items": { "$ref": "#/components/schemas/synckhub_core.types.ItemLockHint" }, "description": "Unexpired locks for this item (for folder browse listings)." }, "federation_stream_id": { "anyOf": [ { "type": "string" }, { "type": "null" } ], "description": "Authority-owned federated stream id for this item, when present." }, "federation_sync": { "anyOf": [ { "$ref": "#/components/schemas/synckhub_core.types.FederationSyncSummary" }, { "type": "null" } ], "description": "Derived federation sync progress for this local replica." }, "federated_placement_failure": { "anyOf": [ { "$ref": "#/components/schemas/synckhub_core.types.FederatedPlacementFailure" }, { "type": "null" } ], "description": "Local-only federated placement failure marker (repo-scoped moves/renames)." } }, "required": [ "chat_item_id", "chat_kind", "display", "thread", "repo_id", "item_id", "item_type", "name", "path", "lifecycle_state" ], "additionalProperties": false, "description": "Minimal summary of an item as exposed by the platform.\n\nThis mirrors the platform `items` projection but is intentionally small\nand can be extended without breaking existing consumers." }, "synckhub_server.routes.coauthoring.AbandonSessionResponse": { "title": "AbandonSessionResponse", "type": "object", "properties": { "status": { "type": "string" } }, "required": [ "status" ] }, "synckhub_server.routes.coauthoring.CoauthoringDownloadUrlResponse": { "title": "CoauthoringDownloadUrlResponse", "type": "object", "properties": { "url": { "type": "string" }, "download_name": { "type": "string" }, "size_bytes": { "anyOf": [ { "type": "integer", "minimum": 0 }, { "type": "null" } ] }, "source": { "type": "string" } }, "required": [ "url", "download_name", "source" ] }, "synckhub_server.routes.coauthoring.CommitSessionResponse": { "title": "CommitSessionResponse", "type": "object", "properties": { "commit_id": { "anyOf": [ { "type": "string" }, { "type": "null" } ] }, "blob_id": { "anyOf": [ { "type": "string" }, { "type": "null" } ] }, "size_bytes": { "type": "integer", "minimum": 0 }, "status": { "type": "string" }, "cleanup_pending": { "type": "boolean" }, "cleanup_error": { "anyOf": [ { "type": "string" }, { "type": "null" } ] } }, "required": [ "size_bytes", "status", "cleanup_pending" ] }, "synckhub_server.routes.coauthoring.StartSessionRequest": { "title": "StartSessionRequest", "type": "object", "properties": {}, "additionalProperties": false }, "synckhub_server.routes.coauthoring.StartSessionResponse": { "title": "StartSessionResponse", "type": "object", "properties": { "session_id": { "type": "string" }, "edit_url": { "type": "string" }, "expires_at": { "type": "string" }, "status": { "type": "string" } }, "required": [ "session_id", "edit_url", "expires_at", "status" ] }, "synckhub_server.command_runner.LineRequest": { "title": "LineRequest", "type": "object", "properties": { "id": { "type": "string" }, "line": { "type": "string" } }, "required": [ "id", "line" ], "additionalProperties": false }, "synckhub_server.command_runner.CreateSessionRequest": { "title": "CreateSessionRequest", "type": "object", "properties": { "repo": { "type": "string" }, "cwd": { "anyOf": [ { "type": "string" }, { "type": "null" } ] } }, "required": [ "repo" ], "additionalProperties": false }, "synckhub_server.routes.connected_accounts.accounts.AccountOrderRequest": { "title": "AccountOrderRequest", "type": "object", "properties": { "account_ids": { "type": "array", "items": { "type": "string" } } }, "required": [ "account_ids" ], "additionalProperties": false }, "synckhub_server.routes.connected_accounts.accounts.AccountsResponse": { "title": "AccountsResponse", "type": "object", "properties": { "accounts": { "type": "array", "items": { "$ref": "#/components/schemas/synckhub_server.routes.connected_accounts.accounts.AccountSummary" } } }, "required": [ "accounts" ], "additionalProperties": false }, "synckhub_server.routes.connected_accounts.accounts.AccountSummary": { "title": "AccountSummary", "type": "object", "properties": { "owned_by_current_user": { "type": "boolean" }, "account_id": { "type": "string" }, "provider": { "type": "string" }, "email_address": { "type": "string" }, "display_name": { "anyOf": [ { "type": "string" }, { "type": "null" } ] }, "scopes": { "type": "array", "items": { "type": "string" } }, "connection_status": { "type": "string" }, "connection_revision": { "type": "integer" }, "sort_order": { "type": "integer" }, "connected_at": { "type": "string" }, "binding_updated_at": { "type": "string" } }, "required": [ "owned_by_current_user", "account_id", "provider", "email_address", "scopes", "connection_status", "connection_revision", "sort_order", "connected_at", "binding_updated_at" ], "additionalProperties": false }, "synckhub_server.routes.connected_accounts.oauth.OAuthExchangeRequest": { "title": "OAuthExchangeRequest", "type": "object", "properties": { "oauth_state_id": { "type": "string" }, "redirect_uri": { "type": "string" }, "code": { "type": "string" } }, "required": [ "oauth_state_id", "redirect_uri", "code" ], "additionalProperties": false }, "synckhub_server.routes.connected_accounts.oauth.OAuthExchangeResponse": { "title": "OAuthExchangeResponse", "type": "object", "properties": { "account_id": { "type": "string" }, "provider": { "type": "string" }, "email_address": { "type": "string" }, "display_name": { "anyOf": [ { "type": "string" }, { "type": "null" } ] }, "scopes": { "type": "array", "items": { "type": "string" } }, "connection_status": { "type": "string" }, "connection_revision": { "type": "integer" } }, "required": [ "account_id", "provider", "email_address", "scopes", "connection_status", "connection_revision" ], "additionalProperties": false }, "synckhub_server.routes.connected_accounts.oauth.OAuthStartRequest": { "title": "OAuthStartRequest", "type": "object", "properties": { "redirect_uri": { "anyOf": [ { "type": "string" }, { "type": "null" } ] }, "callback_mode": { "anyOf": [ { "type": "string" }, { "type": "null" } ] }, "scopes": { "anyOf": [ { "type": "array", "items": { "type": "string" } }, { "type": "null" } ] }, "reconnect_account_id": { "anyOf": [ { "type": "string" }, { "type": "null" } ] } }, "additionalProperties": false }, "synckhub_server.routes.connected_accounts.oauth.OAuthStartResponse": { "title": "OAuthStartResponse", "type": "object", "properties": { "provider": { "type": "string" }, "oauth_state_id": { "type": "string" }, "authorize_url": { "type": "string" }, "expires_at": { "type": "string" } }, "required": [ "provider", "oauth_state_id", "authorize_url", "expires_at" ], "additionalProperties": false }, "synckhub_mailcal.types.ContactInput": { "title": "ContactInput", "type": "object", "properties": { "display_name": { "anyOf": [ { "type": "string" }, { "type": "null" } ] }, "first_name": { "anyOf": [ { "type": "string" }, { "type": "null" } ] }, "last_name": { "anyOf": [ { "type": "string" }, { "type": "null" } ] }, "company": { "anyOf": [ { "type": "string" }, { "type": "null" } ] }, "job_title": { "anyOf": [ { "type": "string" }, { "type": "null" } ] }, "emails": { "anyOf": [ { "type": "array", "items": { "$ref": "#/components/schemas/synckhub_mailcal.types.ContactEmail" } }, { "type": "null" } ] }, "phones": { "anyOf": [ { "type": "array", "items": { "$ref": "#/components/schemas/synckhub_mailcal.types.ContactPhone" } }, { "type": "null" } ] }, "addresses": { "anyOf": [ { "type": "array", "items": { "$ref": "#/components/schemas/synckhub_mailcal.types.ContactAddress" } }, { "type": "null" } ] }, "notes": { "anyOf": [ { "type": "string" }, { "type": "null" } ] } } }, "synckhub_mailcal.types.ContactEmail": { "title": "ContactEmail", "type": "object", "properties": { "value": { "type": "string" }, "primary": { "anyOf": [ { "type": "boolean" }, { "type": "null" } ] }, "type": { "anyOf": [ { "type": "string" }, { "type": "null" } ] } }, "required": [ "value" ] }, "synckhub_mailcal.types.ContactPhone": { "title": "ContactPhone", "type": "object", "properties": { "value": { "type": "string" }, "primary": { "anyOf": [ { "type": "boolean" }, { "type": "null" } ] }, "type": { "anyOf": [ { "type": "string" }, { "type": "null" } ] } }, "required": [ "value" ] }, "synckhub_mailcal.types.ContactAddress": { "title": "ContactAddress", "type": "object", "properties": { "label": { "anyOf": [ { "type": "string" }, { "type": "null" } ] }, "street": { "anyOf": [ { "type": "string" }, { "type": "null" } ] }, "city": { "anyOf": [ { "type": "string" }, { "type": "null" } ] }, "region": { "anyOf": [ { "type": "string" }, { "type": "null" } ] }, "postal_code": { "anyOf": [ { "type": "string" }, { "type": "null" } ] }, "country": { "anyOf": [ { "type": "string" }, { "type": "null" } ] }, "country_code": { "anyOf": [ { "type": "string" }, { "type": "null" } ] }, "formatted": { "anyOf": [ { "type": "string" }, { "type": "null" } ] } } }, "synckhub_mailcal.types.Contact": { "title": "Contact", "type": "object", "properties": { "contact_id": { "type": "string" }, "display_name": { "anyOf": [ { "type": "string" }, { "type": "null" } ] }, "first_name": { "anyOf": [ { "type": "string" }, { "type": "null" } ] }, "last_name": { "anyOf": [ { "type": "string" }, { "type": "null" } ] }, "company": { "anyOf": [ { "type": "string" }, { "type": "null" } ] }, "job_title": { "anyOf": [ { "type": "string" }, { "type": "null" } ] }, "emails": { "type": "array", "items": { "$ref": "#/components/schemas/synckhub_mailcal.types.ContactEmail" } }, "phones": { "type": "array", "items": { "$ref": "#/components/schemas/synckhub_mailcal.types.ContactPhone" } }, "addresses": { "type": "array", "items": { "$ref": "#/components/schemas/synckhub_mailcal.types.ContactAddress" } }, "notes": { "anyOf": [ { "type": "string" }, { "type": "null" } ] } }, "required": [ "contact_id" ] }, "synckhub_mailcal.types.ProviderPeopleSource": { "title": "ProviderPeopleSource", "type": "string", "enum": [ "suggested", "directory" ] }, "synckhub_server.routes.connected_accounts.provider_people.ListProviderPeopleResponse": { "title": "ListProviderPeopleResponse", "type": "object", "properties": { "people": { "type": "array", "items": { "$ref": "#/components/schemas/synckhub_mailcal.types.ProviderPerson" } }, "next_page_token": { "anyOf": [ { "type": "string" }, { "type": "null" } ] } }, "required": [ "people" ], "additionalProperties": false }, "synckhub_mailcal.types.ProviderPerson": { "title": "ProviderPerson", "type": "object", "properties": { "person_id": { "type": "string" }, "display_name": { "anyOf": [ { "type": "string" }, { "type": "null" } ] }, "first_name": { "anyOf": [ { "type": "string" }, { "type": "null" } ] }, "last_name": { "anyOf": [ { "type": "string" }, { "type": "null" } ] }, "company": { "anyOf": [ { "type": "string" }, { "type": "null" } ] }, "job_title": { "anyOf": [ { "type": "string" }, { "type": "null" } ] }, "department": { "anyOf": [ { "type": "string" }, { "type": "null" } ] }, "office_location": { "anyOf": [ { "type": "string" }, { "type": "null" } ] }, "user_principal_name": { "anyOf": [ { "type": "string" }, { "type": "null" } ] }, "emails": { "type": "array", "items": { "$ref": "#/components/schemas/synckhub_mailcal.types.ContactEmail" } }, "phones": { "type": "array", "items": { "$ref": "#/components/schemas/synckhub_mailcal.types.ContactPhone" } }, "person_type": { "anyOf": [ { "$ref": "#/components/schemas/synckhub_mailcal.types.ProviderPersonType" }, { "type": "null" } ] } }, "required": [ "person_id" ] }, "synckhub_mailcal.types.ProviderPersonType": { "title": "ProviderPersonType", "type": "object", "properties": { "class": { "anyOf": [ { "type": "string" }, { "type": "null" } ] }, "subclass": { "anyOf": [ { "type": "string" }, { "type": "null" } ] } } }, "synckhub_server.routes.connected_accounts.provider_people.ContactListField": { "title": "ContactListField", "type": "string", "enum": [ "display_name", "first_name", "last_name", "company", "job_title", "mobile_phone", "home_phone", "business_phone", "email", "email2", "email3" ] }, "synckhub_server.routes.connected_accounts.provider_people.ContactListOrder": { "title": "ContactListOrder", "type": "string", "enum": [ "asc", "desc" ] }, "synckhub_server.routes.connected_accounts.provider_people.ContactListState": { "title": "ContactListState", "type": "string", "enum": [ "all", "saved", "suggested" ] }, "synckhub_server.routes.connected_accounts.provider_people.ListContactsResponse": { "title": "ListContactsResponse", "type": "object", "properties": { "contacts": { "type": "array", "items": { "$ref": "#/components/schemas/synckhub_server.routes.connected_accounts.provider_people.ListedContact" } }, "next_page_token": { "anyOf": [ { "type": "string" }, { "type": "null" } ] } }, "required": [ "contacts" ], "additionalProperties": false }, "synckhub_server.routes.connected_accounts.provider_people.ListedContact": { "title": "Contact", "type": "object", "properties": { "contact_state": { "$ref": "#/components/schemas/synckhub_server.routes.connected_accounts.provider_people.ListedContactState" }, "contact_id": { "type": "string" }, "display_name": { "anyOf": [ { "type": "string" }, { "type": "null" } ] }, "first_name": { "anyOf": [ { "type": "string" }, { "type": "null" } ] }, "last_name": { "anyOf": [ { "type": "string" }, { "type": "null" } ] }, "company": { "anyOf": [ { "type": "string" }, { "type": "null" } ] }, "job_title": { "anyOf": [ { "type": "string" }, { "type": "null" } ] }, "emails": { "type": "array", "items": { "$ref": "#/components/schemas/synckhub_mailcal.types.ContactEmail" } }, "phones": { "type": "array", "items": { "$ref": "#/components/schemas/synckhub_mailcal.types.ContactPhone" } }, "addresses": { "type": "array", "items": { "$ref": "#/components/schemas/synckhub_mailcal.types.ContactAddress" } }, "notes": { "anyOf": [ { "type": "string" }, { "type": "null" } ] } }, "required": [ "contact_state", "contact_id" ] }, "synckhub_server.routes.connected_accounts.provider_people.ListedContactState": { "title": "ListedContactState", "type": "string", "enum": [ "SAVED", "SUGGESTED" ] }, "synckhub_server.routes.connected_accounts.provider_people.MergeSuggestedPersonRequest": { "title": "MergeSuggestedPersonRequest", "type": "object", "properties": { "command_id": { "type": "string" }, "email": { "type": "string" }, "contact_id": { "type": "string" } }, "required": [ "command_id", "email", "contact_id" ], "additionalProperties": false }, "synckhub_server.routes.connected_accounts.provider_people.SuggestedPeopleMutationResponse": { "title": "SuggestedPeopleMutationResponse", "type": "object", "properties": { "outcomes": { "type": "array", "items": { "$ref": "#/components/schemas/synckhub_server.routes.connected_accounts.provider_people.SuggestedPersonMutationOutcome" } } }, "required": [ "outcomes" ] }, "synckhub_server.routes.connected_accounts.provider_people.SuggestedPersonMutationOutcome": { "title": "SuggestedPersonMutationOutcome", "type": "object", "properties": { "email": { "type": "string" }, "status": { "type": "string" }, "contact_id": { "anyOf": [ { "type": "string" }, { "type": "null" } ] } }, "required": [ "email", "status" ] }, "synckhub_server.routes.connected_accounts.provider_people.MergeCandidatesResponse": { "title": "MergeCandidatesResponse", "type": "object", "properties": { "candidates": { "type": "array", "items": { "$ref": "#/components/schemas/synckhub_server.routes.connected_accounts.provider_people.MergeCandidateItem" } } }, "required": [ "candidates" ] }, "synckhub_server.routes.connected_accounts.provider_people.MergeCandidateItem": { "title": "MergeCandidateItem", "type": "object", "properties": { "contact_id": { "type": "string" }, "display_name": { "type": "string" }, "scope": { "type": "string" } }, "required": [ "contact_id", "display_name", "scope" ] }, "synckhub_server.routes.connected_accounts.provider_people.PromoteSuggestedPeopleRequest": { "title": "PromoteSuggestedPeopleRequest", "type": "object", "properties": { "target_scope": { "type": "string" }, "rows": { "type": "array", "items": { "$ref": "#/components/schemas/synckhub_server.routes.connected_accounts.provider_people.PromoteSuggestedPersonRow" } } }, "required": [ "target_scope", "rows" ], "additionalProperties": false }, "synckhub_server.routes.connected_accounts.provider_people.PromoteSuggestedPersonRow": { "title": "PromoteSuggestedPersonRow", "type": "object", "properties": { "command_id": { "type": "string" }, "suggestion_ids": { "type": "array", "items": { "type": "string" } }, "email": { "type": "string" }, "display_name": { "anyOf": [ { "type": "string" }, { "type": "null" } ] } }, "required": [ "command_id", "suggestion_ids", "email" ], "additionalProperties": false }, "synckhub_server.routes.connected_accounts.provider_people.DeleteSuggestedPeopleRequest": { "title": "DeleteSuggestedPeopleRequest", "type": "object", "properties": { "suggestion_ids": { "type": "array", "items": { "type": "string" } } }, "required": [ "suggestion_ids" ], "additionalProperties": false }, "synckhub_server.routes.connected_accounts.provider_people.DeleteSuggestedPeopleResponse": { "title": "DeleteSuggestedPeopleResponse", "type": "object", "properties": { "outcomes": { "type": "array", "items": { "$ref": "#/components/schemas/synckhub_server.routes.connected_accounts.provider_people.DeleteSuggestedPersonOutcome" } } }, "required": [ "outcomes" ] }, "synckhub_server.routes.connected_accounts.provider_people.DeleteSuggestedPersonOutcome": { "title": "DeleteSuggestedPersonOutcome", "type": "object", "properties": { "suggestion_id": { "type": "string" }, "status": { "type": "string" } }, "required": [ "suggestion_id", "status" ] }, "synckhub_server.routes.connected_accounts.provider_people.ImportProviderContactsRequest": { "title": "ImportProviderContactsRequest", "type": "object", "properties": { "account_id": { "type": "string" }, "rows": { "type": "array", "items": { "$ref": "#/components/schemas/synckhub_server.routes.connected_accounts.provider_people.ImportProviderContactRow" } } }, "required": [ "account_id", "rows" ], "additionalProperties": false }, "synckhub_server.routes.connected_accounts.provider_people.ImportProviderContactRow": { "title": "ImportProviderContactRow", "type": "object", "properties": { "command_id": { "type": "string" }, "contact_id": { "type": "string" } }, "required": [ "command_id", "contact_id" ], "additionalProperties": false }, "synckhub_server.routes.connected_accounts.provider_people.ImportProviderContactsResponse": { "title": "ImportProviderContactsResponse", "type": "object", "properties": { "outcomes": { "type": "array", "items": { "$ref": "#/components/schemas/synckhub_server.routes.connected_accounts.provider_people.ImportProviderContactOutcome" } } }, "required": [ "outcomes" ] }, "synckhub_server.routes.connected_accounts.provider_people.ImportProviderContactOutcome": { "title": "ImportProviderContactOutcome", "type": "object", "properties": { "provider_contact_id": { "type": "string" }, "status": { "type": "string" }, "contact_id": { "anyOf": [ { "type": "string" }, { "type": "null" } ] } }, "required": [ "provider_contact_id", "status" ] }, "synckhub_server.routes.connected_accounts.provider_people.AggregateContactsResponse": { "title": "AggregateContactsResponse", "type": "object", "properties": { "contacts": { "type": "array", "items": { "$ref": "#/components/schemas/synckhub_server.routes.connected_accounts.provider_people.AggregateContactItem" } }, "next_cursor": { "anyOf": [ { "type": "string" }, { "type": "null" } ] }, "sources": { "type": "array", "items": { "$ref": "#/components/schemas/synckhub_server.routes.connected_accounts.provider_people.PeopleSuggestionSource" } }, "partial": { "type": "boolean" } }, "required": [ "contacts", "sources", "partial" ] }, "synckhub_server.routes.connected_accounts.provider_people.AggregateContactItem": { "title": "AggregateContactItem", "type": "object", "properties": { "row_id": { "type": "string" }, "source_kind": { "type": "string" }, "source_account_id": { "anyOf": [ { "type": "string" }, { "type": "null" } ] }, "source_label": { "type": "string" }, "contact_state": { "type": "string" }, "contact_id": { "type": "string" }, "display_name": { "type": "string" }, "organization_title": { "anyOf": [ { "type": "string" }, { "type": "null" } ] }, "primary_email": { "anyOf": [ { "type": "string" }, { "type": "null" } ] }, "scope": { "anyOf": [ { "type": "string" }, { "type": "null" } ] }, "updated_at": { "anyOf": [ { "type": "string", "format": "date-time" }, { "type": "null" } ] } }, "required": [ "row_id", "source_kind", "source_label", "contact_state", "contact_id", "display_name" ] }, "synckhub_server.routes.connected_accounts.provider_people.PeopleSuggestionSource": { "title": "PeopleSuggestionSource", "type": "object", "properties": { "account_id": { "type": "string" }, "account_label": { "type": "string" }, "health": { "type": "string" }, "last_success_at": { "anyOf": [ { "type": "string", "format": "date-time" }, { "type": "null" } ] }, "error_code": { "anyOf": [ { "type": "string" }, { "type": "null" } ] } }, "required": [ "account_id", "account_label", "health" ] }, "synckhub_server.routes.connected_accounts.provider_people.SuggestedPeopleResponse": { "title": "SuggestedPeopleResponse", "type": "object", "properties": { "items": { "type": "array", "items": { "$ref": "#/components/schemas/synckhub_server.routes.connected_accounts.provider_people.SuggestedPersonItem" } }, "next_cursor": { "anyOf": [ { "type": "string" }, { "type": "null" } ] }, "sources": { "type": "array", "items": { "$ref": "#/components/schemas/synckhub_server.routes.connected_accounts.provider_people.PeopleSuggestionSource" } }, "partial": { "type": "boolean" } }, "required": [ "items", "sources", "partial" ] }, "synckhub_server.routes.connected_accounts.provider_people.SuggestedPersonItem": { "title": "SuggestedPersonItem", "type": "object", "properties": { "suggestion_ids": { "type": "array", "items": { "type": "string" } }, "email": { "type": "string" }, "name": { "anyOf": [ { "type": "string" }, { "type": "null" } ] }, "organization": { "anyOf": [ { "type": "string" }, { "type": "null" } ] }, "provenance_labels": { "type": "array", "items": { "type": "string" } }, "reason": { "$ref": "#/components/schemas/synckhub_server.routes.connected_accounts.provider_people.PeopleSuggestionReason" }, "evidence_at": { "type": "string", "format": "date-time" } }, "required": [ "suggestion_ids", "email", "provenance_labels", "reason", "evidence_at" ] }, "synckhub_server.routes.connected_accounts.provider_people.PeopleSuggestionReason": { "title": "PeopleSuggestionReason", "type": "object", "properties": { "kind": { "type": "string" }, "interaction_count": { "anyOf": [ { "type": "integer" }, { "type": "null" } ] }, "last_interaction_at": { "anyOf": [ { "type": "string", "format": "date-time" }, { "type": "null" } ] } }, "required": [ "kind" ] }, "synckhub_server.routes.connected_accounts.provider_people.PeopleSuggestionsResponse": { "title": "PeopleSuggestionsResponse", "type": "object", "properties": { "items": { "type": "array", "items": { "$ref": "#/components/schemas/synckhub_server.routes.connected_accounts.provider_people.PeopleSuggestionItem" } }, "sources": { "type": "array", "items": { "$ref": "#/components/schemas/synckhub_server.routes.connected_accounts.provider_people.PeopleSuggestionSource" } }, "partial": { "type": "boolean" } }, "required": [ "items", "sources", "partial" ] }, "synckhub_server.routes.connected_accounts.provider_people.PeopleSuggestionItem": { "title": "PeopleSuggestionItem", "type": "object", "properties": { "email": { "type": "string" }, "principal_id": { "anyOf": [ { "type": "string" }, { "type": "null" } ] }, "contact_id": { "anyOf": [ { "type": "string" }, { "type": "null" } ] }, "name": { "anyOf": [ { "type": "string" }, { "type": "null" } ] }, "label": { "type": "string" }, "source_kind": { "type": "string" }, "source_label": { "type": "string" }, "source_account_id": { "anyOf": [ { "type": "string" }, { "type": "null" } ] }, "provenance_labels": { "type": "array", "items": { "type": "string" } }, "display_initials": { "type": "string" }, "match_kind": { "type": "string" }, "reason": { "$ref": "#/components/schemas/synckhub_server.routes.connected_accounts.provider_people.PeopleSuggestionReason" }, "contact_state": { "type": "string" }, "suggestion_ids": { "type": "array", "items": { "type": "string" } }, "rank": { "type": "integer", "minimum": 0 } }, "required": [ "email", "label", "source_kind", "source_label", "provenance_labels", "display_initials", "match_kind", "reason", "contact_state", "suggestion_ids", "rank" ] }, "synckhub_server.routes.connected_accounts.webhooks.GooglePubSubPush": { "title": "GooglePubSubPush", "type": "object", "properties": { "message": { "$ref": "#/components/schemas/synckhub_server.routes.connected_accounts.webhooks.GooglePubSubMessage" }, "subscription": { "type": "string" } }, "required": [ "message", "subscription" ] }, "synckhub_server.routes.connected_accounts.webhooks.GooglePubSubMessage": { "title": "GooglePubSubMessage", "type": "object", "properties": { "data": { "type": "string" } }, "required": [ "data" ] }, "synckhub_server.routes.connected_accounts.webhooks.GraphWebhookEnvelope": { "title": "GraphWebhookEnvelope", "type": "object", "properties": { "value": { "type": "array", "items": { "$ref": "#/components/schemas/synckhub_server.routes.connected_accounts.webhooks.GraphWebhookNotification" } } }, "required": [ "value" ] }, "synckhub_server.routes.connected_accounts.webhooks.GraphWebhookNotification": { "title": "GraphWebhookNotification", "type": "object", "properties": { "subscriptionId": { "type": "string" }, "clientState": { "anyOf": [ { "type": "string" }, { "type": "null" } ] }, "lifecycleEvent": { "anyOf": [ { "type": "string" }, { "type": "null" } ] } }, "required": [ "subscriptionId" ] }, "synckhub_server.routes.desktop_sync.FeedResponse": { "title": "FeedResponse", "type": "object", "properties": { "applied_repo_seq": { "type": "integer" }, "current_authz_seq": { "type": "integer" }, "scanned_through_authz_seq": { "type": "integer" }, "authority_scan_pending": { "type": "boolean" }, "scanned_through": { "$ref": "#/components/schemas/synckhub_server.routes.desktop_sync.EventCursor" }, "has_more": { "type": "boolean" }, "visible_commits": { "type": "array", "items": { "$ref": "#/components/schemas/synckhub_server.routes.desktop_sync.VisibleCommit" } }, "upserts": { "type": "array", "items": { "$ref": "#/components/schemas/synckhub_server.routes.desktop_sync.SnapshotChild" } }, "changed_folders": { "type": "array", "items": { "anyOf": [ { "type": "string", "format": "uuid" }, { "type": "null" } ] } }, "refresh_roots": { "type": "boolean" }, "refresh_personal_roots": { "type": "boolean" } }, "required": [ "applied_repo_seq", "current_authz_seq", "scanned_through_authz_seq", "authority_scan_pending", "scanned_through", "has_more", "visible_commits", "upserts", "changed_folders", "refresh_roots", "refresh_personal_roots" ] }, "synckhub_server.routes.desktop_sync.EventCursor": { "title": "EventCursor", "type": "object", "properties": { "repo_seq": { "type": "integer" }, "event_idx": { "type": "integer" } }, "required": [ "repo_seq", "event_idx" ] }, "synckhub_server.routes.desktop_sync.VisibleCommit": { "title": "VisibleCommit", "type": "object", "properties": { "repo_seq": { "type": "integer" }, "commit_id": { "type": "string" }, "changes": { "type": "array", "items": { "$ref": "#/components/schemas/synckhub_server.routes.desktop_sync.VisibleChange" } }, "details_redacted": { "type": "boolean" } }, "required": [ "repo_seq", "commit_id", "changes", "details_redacted" ] }, "synckhub_server.routes.desktop_sync.VisibleChange": { "title": "VisibleChange", "type": "object", "properties": { "event_idx": { "type": "integer" }, "item_id": { "type": "string", "format": "uuid" }, "event_type": { "type": "string" }, "name": { "type": "string" }, "parent_item_id": { "anyOf": [ { "type": "string", "format": "uuid" }, { "type": "null" } ] } }, "required": [ "event_idx", "item_id", "event_type", "name" ] }, "synckhub_server.routes.desktop_sync.SnapshotChild": { "title": "SnapshotChild", "type": "object", "properties": { "item_id": { "type": "string", "format": "uuid" }, "parent_item_id": { "anyOf": [ { "type": "string", "format": "uuid" }, { "type": "null" } ] }, "name": { "type": "string" }, "personal_root_name": { "anyOf": [ { "type": "string" }, { "type": "null" } ] }, "personal_folder_index": { "type": "boolean" }, "item_type": { "type": "string" }, "item_seq": { "type": "integer" }, "content_item_seq": { "anyOf": [ { "type": "integer" }, { "type": "null" } ] }, "content_sha256": { "anyOf": [ { "type": "string" }, { "type": "null" } ] }, "item_commit_id": { "type": "string" }, "content_commit_id": { "anyOf": [ { "type": "string" }, { "type": "null" } ] }, "size": { "anyOf": [ { "type": "integer" }, { "type": "null" } ] }, "can_read": { "type": "boolean" }, "can_write": { "type": "boolean" }, "can_rename": { "type": "boolean" }, "can_move": { "type": "boolean" }, "can_delete": { "type": "boolean" }, "can_create_file": { "type": "boolean" }, "can_create_folder": { "type": "boolean" } }, "required": [ "item_id", "name", "personal_folder_index", "item_type", "item_seq", "item_commit_id", "can_read", "can_write", "can_rename", "can_move", "can_delete", "can_create_file", "can_create_folder" ] }, "synckhub_server.routes.desktop_sync.RootsResponse": { "title": "RootsResponse", "type": "object", "properties": { "applied_repo_seq": { "type": "integer" }, "current_authz_seq": { "type": "integer" }, "scanned_through_authz_seq": { "type": "integer" }, "authority_scan_pending": { "type": "boolean" }, "include_virtual_root": { "type": "boolean" }, "root_can_create_file": { "type": "boolean" }, "root_can_create_folder": { "type": "boolean" }, "items": { "type": "array", "items": { "$ref": "#/components/schemas/synckhub_server.routes.desktop_sync.SnapshotChild" } }, "next_offset": { "anyOf": [ { "type": "integer", "minimum": 0 }, { "type": "null" } ] } }, "required": [ "applied_repo_seq", "current_authz_seq", "scanned_through_authz_seq", "authority_scan_pending", "include_virtual_root", "root_can_create_file", "root_can_create_folder", "items" ] }, "synckhub_server.routes.desktop_sync.ChildrenBatchRequest": { "title": "ChildrenBatchRequest", "type": "object", "properties": { "parent_item_ids": { "type": "array", "items": { "type": "string", "format": "uuid" } } }, "required": [ "parent_item_ids" ] }, "synckhub_server.routes.desktop_sync.ChildrenBatchResponse": { "title": "ChildrenBatchResponse", "type": "object", "properties": { "applied_repo_seq": { "type": "integer" }, "current_authz_seq": { "type": "integer" }, "scanned_through_authz_seq": { "type": "integer" }, "authority_scan_pending": { "type": "boolean" }, "directories": { "type": "array", "items": { "$ref": "#/components/schemas/synckhub_server.routes.desktop_sync.ChildrenBatchDirectory" } } }, "required": [ "applied_repo_seq", "current_authz_seq", "scanned_through_authz_seq", "authority_scan_pending", "directories" ] }, "synckhub_server.routes.desktop_sync.ChildrenBatchDirectory": { "title": "ChildrenBatchDirectory", "type": "object", "properties": { "parent_item_id": { "type": "string", "format": "uuid" }, "items": { "type": "array", "items": { "$ref": "#/components/schemas/synckhub_server.routes.desktop_sync.SnapshotChild" } }, "next": { "anyOf": [ { "$ref": "#/components/schemas/synckhub_server.routes.desktop_sync.ChildCursor" }, { "type": "null" } ] } }, "required": [ "parent_item_id", "items" ] }, "synckhub_server.routes.desktop_sync.ChildCursor": { "title": "ChildCursor", "type": "object", "properties": { "name_key": { "type": "string" }, "item_id": { "type": "string", "format": "uuid" } }, "required": [ "name_key", "item_id" ] }, "synckhub_server.routes.desktop_sync.ChildrenResponse": { "title": "ChildrenResponse", "type": "object", "properties": { "applied_repo_seq": { "type": "integer" }, "current_authz_seq": { "type": "integer" }, "scanned_through_authz_seq": { "type": "integer" }, "authority_scan_pending": { "type": "boolean" }, "items": { "type": "array", "items": { "$ref": "#/components/schemas/synckhub_server.routes.desktop_sync.SnapshotChild" } }, "next": { "anyOf": [ { "$ref": "#/components/schemas/synckhub_server.routes.desktop_sync.ChildCursor" }, { "type": "null" } ] } }, "required": [ "applied_repo_seq", "current_authz_seq", "scanned_through_authz_seq", "authority_scan_pending", "items" ] }, "synckhub_server.routes.desktop_sync.CheckpointResponse": { "title": "CheckpointResponse", "type": "object", "properties": { "applied_repo_seq": { "type": "integer" }, "applied_common_version": { "type": "integer" }, "common_materializer_version": { "type": "integer" }, "mutation_source_commits": { "type": "boolean" }, "personal_roots": { "type": "boolean" }, "current_authz_seq": { "type": "integer" }, "scanned_through_authz_seq": { "type": "integer" }, "authority_changed": { "type": "boolean" }, "refresh_folder_ids": { "type": "array", "items": { "type": "string", "format": "uuid" } }, "refresh_parent_ids": { "type": "array", "items": { "anyOf": [ { "type": "string", "format": "uuid" }, { "type": "null" } ] } }, "has_more_authority_events": { "type": "boolean" } }, "required": [ "applied_repo_seq", "applied_common_version", "common_materializer_version", "mutation_source_commits", "personal_roots", "current_authz_seq", "scanned_through_authz_seq", "authority_changed", "refresh_folder_ids", "refresh_parent_ids", "has_more_authority_events" ] }, "synckhub_server.routes.directory.companies.UpdateDirectoryFolderRequest": { "title": "UpdateDirectoryFolderRequest", "type": "object", "properties": { "display_name": { "anyOf": [ { "type": "string" }, { "type": "null" } ] }, "fields": { "anyOf": [ {}, { "type": "null" } ] } }, "additionalProperties": false }, "synckhub_core.types.DirectoryFolderSummary": { "title": "DirectoryFolderSummary", "type": "object", "properties": { "repo_id": { "type": "string" }, "folder_item_id": { "type": "string" }, "kind": { "type": "string" }, "scope": { "type": "string" }, "owner_principal_id": { "anyOf": [ { "type": "string" }, { "type": "null" } ] }, "role_keys": { "type": "array", "items": { "type": "string" } }, "display_name": { "type": "string" }, "primary_email": { "anyOf": [ { "type": "string" }, { "type": "null" } ] }, "primary_url": { "anyOf": [ { "type": "string" }, { "type": "null" } ] }, "primary_phone": { "anyOf": [ { "type": "string" }, { "type": "null" } ] }, "legal_name": { "anyOf": [ { "type": "string" }, { "type": "null" } ] }, "company_id": { "anyOf": [ { "type": "string" }, { "type": "null" } ] }, "company_code": { "anyOf": [ { "type": "string" }, { "type": "null" } ] }, "external_company_id": { "anyOf": [ { "type": "string" }, { "type": "null" } ] }, "external_source": { "anyOf": [ { "type": "string" }, { "type": "null" } ] }, "company_domain": { "anyOf": [ { "type": "string" }, { "type": "null" } ] }, "tax_id": { "anyOf": [ { "type": "string" }, { "type": "null" } ] }, "country": { "anyOf": [ { "type": "string" }, { "type": "null" } ] }, "industry": { "anyOf": [ { "type": "string" }, { "type": "null" } ] }, "item_subtype": { "anyOf": [ { "type": "string" }, { "type": "null" } ] }, "metadata_json": {}, "source_json": {}, "created_at": { "type": "string" }, "created_by": { "type": "string" }, "updated_at": { "type": "string" }, "updated_by": { "type": "string" } }, "required": [ "repo_id", "folder_item_id", "kind", "scope", "display_name", "created_at", "created_by", "updated_at", "updated_by" ] }, "synckhub_server.routes.directory.companies.ReleaseDirectoryFolderRequest": { "title": "ReleaseDirectoryFolderRequest", "type": "object", "properties": { "folder_item_id": { "type": "string" }, "parent_folder_id": { "anyOf": [ { "type": "string" }, { "type": "null" } ] } }, "required": [ "folder_item_id" ], "additionalProperties": false }, "synckhub_server.routes.directory.companies.AdoptDirectoryFolderRequest": { "title": "AdoptDirectoryFolderRequest", "type": "object", "properties": { "folder_item_id": { "type": "string" }, "display_name": { "anyOf": [ { "type": "string" }, { "type": "null" } ] }, "scope": { "anyOf": [ { "type": "string" }, { "type": "null" } ] }, "fields": { "anyOf": [ {}, { "type": "null" } ] } }, "required": [ "folder_item_id" ], "additionalProperties": false }, "synckhub_server.routes.directory.companies.BulkReleaseDirectoryFoldersRequest": { "title": "BulkReleaseDirectoryFoldersRequest", "type": "object", "properties": { "folders": { "type": "array", "items": { "$ref": "#/components/schemas/synckhub_server.routes.directory.companies.ReleaseDirectoryFolderRequest" } } }, "required": [ "folders" ], "additionalProperties": false }, "synckhub_server.routes.directory.companies.DirectoryFolderReleaseBulkResponse": { "title": "DirectoryFolderReleaseBulkResponse", "type": "object", "properties": { "results": { "type": "array", "items": { "$ref": "#/components/schemas/synckhub_server.routes.directory.companies.DirectoryFolderReleaseResultEntry" } } }, "required": [ "results" ], "additionalProperties": false }, "synckhub_server.routes.directory.companies.DirectoryFolderReleaseResultEntry": { "title": "DirectoryFolderReleaseResultEntry", "type": "object", "properties": { "index": { "type": "integer", "minimum": 0 }, "ok": { "type": "boolean" }, "folder": { "anyOf": [ { "$ref": "#/components/schemas/synckhub_core.types.ItemSummary" }, { "type": "null" } ] }, "error": { "anyOf": [ { "type": "string" }, { "type": "null" } ] } }, "required": [ "index", "ok" ], "additionalProperties": false }, "synckhub_server.routes.directory.companies.BulkAdoptDirectoryFoldersRequest": { "title": "BulkAdoptDirectoryFoldersRequest", "type": "object", "properties": { "folders": { "type": "array", "items": { "$ref": "#/components/schemas/synckhub_server.routes.directory.companies.AdoptDirectoryFolderRequest" } } }, "required": [ "folders" ], "additionalProperties": false }, "synckhub_server.routes.directory.companies.DirectoryFolderAdoptBulkResponse": { "title": "DirectoryFolderAdoptBulkResponse", "type": "object", "properties": { "results": { "type": "array", "items": { "$ref": "#/components/schemas/synckhub_server.routes.directory.companies.DirectoryFolderAdoptResultEntry" } } }, "required": [ "results" ], "additionalProperties": false }, "synckhub_server.routes.directory.companies.DirectoryFolderAdoptResultEntry": { "title": "DirectoryFolderAdoptResultEntry", "type": "object", "properties": { "index": { "type": "integer", "minimum": 0 }, "ok": { "type": "boolean" }, "folder": { "anyOf": [ { "$ref": "#/components/schemas/synckhub_core.types.DirectoryFolderSummary" }, { "type": "null" } ] }, "error": { "anyOf": [ { "type": "string" }, { "type": "null" } ] } }, "required": [ "index", "ok" ], "additionalProperties": false }, "synckhub_server.routes.directory.companies.BulkCreateCompaniesRequest": { "title": "BulkCreateCompaniesRequest", "type": "object", "properties": { "companies": { "type": "array", "items": { "$ref": "#/components/schemas/synckhub_server.routes.directory.companies.CreateCompanyRequest" } } }, "required": [ "companies" ], "additionalProperties": false }, "synckhub_server.routes.directory.companies.CreateCompanyRequest": { "title": "CreateCompanyRequest", "type": "object", "properties": { "display_name": { "type": "string" }, "fields": { "anyOf": [ {}, { "type": "null" } ] } }, "required": [ "display_name" ], "additionalProperties": false }, "synckhub_server.routes.directory.companies.CompanyCreateBulkResponse": { "title": "CompanyCreateBulkResponse", "type": "object", "properties": { "results": { "type": "array", "items": { "$ref": "#/components/schemas/synckhub_server.routes.directory.companies.CompanyCreateResultEntry" } } }, "required": [ "results" ], "additionalProperties": false }, "synckhub_server.routes.directory.companies.CompanyCreateResultEntry": { "title": "CompanyCreateResultEntry", "type": "object", "properties": { "index": { "type": "integer", "minimum": 0 }, "ok": { "type": "boolean" }, "company": { "anyOf": [ { "$ref": "#/components/schemas/synckhub_core.types.DirectoryFolderSummary" }, { "type": "null" } ] }, "error": { "anyOf": [ { "type": "string" }, { "type": "null" } ] } }, "required": [ "index", "ok" ], "additionalProperties": false }, "synckhub_server.routes.directory.companies.ListCompaniesResponse": { "title": "ListCompaniesResponse", "type": "object", "properties": { "companies": { "type": "array", "items": { "$ref": "#/components/schemas/synckhub_core.types.DirectoryFolderSummary" } }, "page": { "anyOf": [ { "$ref": "#/components/schemas/synckhub_server.routes.CursorPaginationMeta" }, { "type": "null" } ] } }, "required": [ "companies" ], "additionalProperties": false }, "synckhub_server.routes.directory.companies.ListDirectoryFoldersQuery": { "title": "ListDirectoryFoldersQuery", "type": "object", "properties": { "q": { "anyOf": [ { "type": "string" }, { "type": "null" } ] }, "scope": { "anyOf": [ { "type": "string" }, { "type": "null" } ] }, "role": { "anyOf": [ { "type": "string" }, { "type": "null" } ] }, "limit": { "anyOf": [ { "type": "integer", "minimum": 0 }, { "type": "null" } ] }, "offset": { "anyOf": [ { "type": "integer", "minimum": 0 }, { "type": "null" } ] }, "cursor": { "anyOf": [ { "type": "string" }, { "type": "null" } ] }, "order_dir": { "anyOf": [ { "$ref": "#/components/schemas/synckhub_server.list_name_search_sql.DirectoryListOrderDir" }, { "type": "null" } ] } }, "additionalProperties": false }, "synckhub_server.list_name_search_sql.DirectoryListOrderDir": { "title": "DirectoryListOrderDir", "type": "string", "enum": [ "asc", "desc" ] }, "synckhub_server.routes.directory.companies.PutCompanyMetadataDefinitionRequest": { "title": "PutCompanyMetadataDefinitionRequest", "type": "object", "properties": { "fields": {} }, "required": [ "fields" ], "additionalProperties": false }, "synckhub_server.routes.directory.companies.CompanyMetadataDefinitionResponse": { "title": "CompanyMetadataDefinitionResponse", "type": "object", "properties": { "repo_id": { "type": "string" }, "item_type": { "type": "string" }, "subtype_key": { "type": "string" }, "display_name": { "type": "string" }, "fields": {}, "updated_at": { "anyOf": [ { "type": "string" }, { "type": "null" } ] }, "updated_by": { "anyOf": [ { "type": "string" }, { "type": "null" } ] } }, "required": [ "repo_id", "item_type", "subtype_key", "display_name", "fields" ], "additionalProperties": false }, "synckhub_core.types.PrivateContactsFolderResult": { "title": "PrivateContactsFolderResult", "type": "object", "properties": { "repo_id": { "type": "string" }, "principal_id": { "type": "string" }, "personal_folder_id": { "type": "string" }, "folder_id": { "type": "string" } }, "required": [ "repo_id", "principal_id", "personal_folder_id", "folder_id" ] }, "synckhub_server.routes.directory.contacts.ContactsFoldersResponse": { "title": "ContactsFoldersResponse", "type": "object", "properties": { "company_contacts_folder_id": { "anyOf": [ { "type": "string" }, { "type": "null" } ] }, "personal_root_folder_id": { "anyOf": [ { "type": "string" }, { "type": "null" } ] }, "companies_folder_id": { "anyOf": [ { "type": "string" }, { "type": "null" } ] }, "contacts_folder_id": { "anyOf": [ { "type": "string" }, { "type": "null" } ] }, "my_personal_folder_id": { "anyOf": [ { "type": "string" }, { "type": "null" } ] }, "my_private_contacts_folder_id": { "anyOf": [ { "type": "string" }, { "type": "null" } ] } }, "additionalProperties": false }, "synckhub_server.routes.directory.contacts.UpdateContactRequest": { "title": "UpdateContactRequest", "type": "object", "properties": { "expected_last_repo_seq": { "type": "integer" }, "operation_id": { "anyOf": [ { "type": "string" }, { "type": "null" } ] }, "curation_state": { "anyOf": [ { "type": "string" }, { "type": "null" } ] }, "display_name": { "anyOf": [ { "type": "string" }, { "type": "null" } ] }, "fields": { "anyOf": [ {}, { "type": "null" } ] }, "metadata_json": { "anyOf": [ {}, { "type": "null" } ] }, "given_name": { "anyOf": [ { "anyOf": [ { "type": "string" }, { "type": "null" } ] }, { "type": "null" } ] }, "family_name": { "anyOf": [ { "anyOf": [ { "type": "string" }, { "type": "null" } ] }, { "type": "null" } ] }, "organization_title": { "anyOf": [ { "anyOf": [ { "type": "string" }, { "type": "null" } ] }, { "type": "null" } ] }, "emails": { "anyOf": [ { "type": "array", "items": { "$ref": "#/components/schemas/synckhub_core.types.ContactEmailInput" } }, { "type": "null" } ] }, "phones": { "anyOf": [ { "type": "array", "items": { "$ref": "#/components/schemas/synckhub_core.types.ContactPhoneInput" } }, { "type": "null" } ] }, "urls": { "anyOf": [ { "type": "array", "items": { "$ref": "#/components/schemas/synckhub_core.types.ContactUrlInput" } }, { "type": "null" } ] }, "company_links": { "anyOf": [ { "type": "array", "items": { "$ref": "#/components/schemas/synckhub_core.types.ContactCompanyLinkInput" } }, { "type": "null" } ] }, "notes": { "anyOf": [ { "anyOf": [ { "type": "string" }, { "type": "null" } ] }, { "type": "null" } ] }, "external_source": { "anyOf": [ { "anyOf": [ { "type": "string" }, { "type": "null" } ] }, { "type": "null" } ] }, "external_contact_id": { "anyOf": [ { "anyOf": [ { "type": "string" }, { "type": "null" } ] }, { "type": "null" } ] } }, "required": [ "expected_last_repo_seq" ], "additionalProperties": false }, "synckhub_core.types.ContactEmailInput": { "title": "ContactEmailInput", "type": "object", "properties": { "label": { "anyOf": [ { "type": "string" }, { "type": "null" } ] }, "email": { "type": "string" }, "is_primary": { "anyOf": [ { "type": "boolean" }, { "type": "null" } ] }, "sort_order": { "anyOf": [ { "type": "integer" }, { "type": "null" } ] } }, "required": [ "email" ] }, "synckhub_core.types.ContactPhoneInput": { "title": "ContactPhoneInput", "type": "object", "properties": { "label": { "anyOf": [ { "type": "string" }, { "type": "null" } ] }, "phone": { "type": "string" }, "is_primary": { "anyOf": [ { "type": "boolean" }, { "type": "null" } ] }, "sort_order": { "anyOf": [ { "type": "integer" }, { "type": "null" } ] } }, "required": [ "phone" ] }, "synckhub_core.types.ContactUrlInput": { "title": "ContactUrlInput", "type": "object", "properties": { "label": { "anyOf": [ { "type": "string" }, { "type": "null" } ] }, "url": { "type": "string" }, "is_primary": { "anyOf": [ { "type": "boolean" }, { "type": "null" } ] }, "sort_order": { "anyOf": [ { "type": "integer" }, { "type": "null" } ] } }, "required": [ "url" ] }, "synckhub_core.types.ContactCompanyLinkInput": { "title": "ContactCompanyLinkInput", "type": "object", "properties": { "company_folder_item_id": { "type": "string" }, "role_key": { "anyOf": [ { "type": "string" }, { "type": "null" } ] }, "title": { "anyOf": [ { "type": "string" }, { "type": "null" } ] }, "is_primary": { "anyOf": [ { "type": "boolean" }, { "type": "null" } ] } }, "required": [ "company_folder_item_id" ] }, "synckhub_core.types.ContactDetail": { "title": "ContactSummary", "type": "object", "properties": { "emails": { "type": "array", "items": { "$ref": "#/components/schemas/synckhub_core.types.ContactEmailSummary" } }, "phones": { "type": "array", "items": { "$ref": "#/components/schemas/synckhub_core.types.ContactPhoneSummary" } }, "urls": { "type": "array", "items": { "$ref": "#/components/schemas/synckhub_core.types.ContactUrlSummary" } }, "workspaces": { "type": "array", "items": { "$ref": "#/components/schemas/synckhub_core.types.ContactWorkspaceSummary" } }, "notes": { "anyOf": [ { "type": "string" }, { "type": "null" } ] }, "external_source": { "anyOf": [ { "type": "string" }, { "type": "null" } ] }, "external_contact_id": { "anyOf": [ { "type": "string" }, { "type": "null" } ] }, "provenance_json": {}, "repo_id": { "type": "string" }, "contact_id": { "type": "string" }, "scope": { "type": "string" }, "curation_state": { "type": "string" }, "owner_principal_id": { "anyOf": [ { "type": "string" }, { "type": "null" } ] }, "display_name": { "type": "string" }, "sort_name": { "type": "string" }, "given_name": { "anyOf": [ { "type": "string" }, { "type": "null" } ] }, "family_name": { "anyOf": [ { "type": "string" }, { "type": "null" } ] }, "organization_title": { "anyOf": [ { "type": "string" }, { "type": "null" } ] }, "primary_email": { "anyOf": [ { "type": "string" }, { "type": "null" } ] }, "primary_phone": { "anyOf": [ { "type": "string" }, { "type": "null" } ] }, "primary_url": { "anyOf": [ { "type": "string" }, { "type": "null" } ] }, "company_links": { "type": "array", "items": { "$ref": "#/components/schemas/synckhub_core.types.ContactCompanyLinkSummary" } }, "metadata_json": {}, "workspace_count": { "type": "integer" }, "lifecycle_state": { "type": "string" }, "legacy_contact_folder_item_id": { "anyOf": [ { "type": "string" }, { "type": "null" } ] }, "created_at": { "type": "string" }, "created_by": { "type": "string" }, "updated_at": { "type": "string" }, "updated_by": { "type": "string" }, "last_repo_seq": { "type": "integer", "description": "Repository sequence of the canonical contact revision." } }, "required": [ "repo_id", "contact_id", "scope", "display_name", "sort_name", "workspace_count", "lifecycle_state", "created_at", "created_by", "updated_at", "updated_by", "last_repo_seq" ] }, "synckhub_core.types.ContactSummary": { "title": "ContactSummary", "type": "object", "properties": { "repo_id": { "type": "string" }, "contact_id": { "type": "string" }, "scope": { "type": "string" }, "curation_state": { "type": "string" }, "owner_principal_id": { "anyOf": [ { "type": "string" }, { "type": "null" } ] }, "display_name": { "type": "string" }, "sort_name": { "type": "string" }, "given_name": { "anyOf": [ { "type": "string" }, { "type": "null" } ] }, "family_name": { "anyOf": [ { "type": "string" }, { "type": "null" } ] }, "organization_title": { "anyOf": [ { "type": "string" }, { "type": "null" } ] }, "primary_email": { "anyOf": [ { "type": "string" }, { "type": "null" } ] }, "primary_phone": { "anyOf": [ { "type": "string" }, { "type": "null" } ] }, "primary_url": { "anyOf": [ { "type": "string" }, { "type": "null" } ] }, "company_links": { "type": "array", "items": { "$ref": "#/components/schemas/synckhub_core.types.ContactCompanyLinkSummary" } }, "metadata_json": {}, "workspace_count": { "type": "integer" }, "lifecycle_state": { "type": "string" }, "legacy_contact_folder_item_id": { "anyOf": [ { "type": "string" }, { "type": "null" } ] }, "created_at": { "type": "string" }, "created_by": { "type": "string" }, "updated_at": { "type": "string" }, "updated_by": { "type": "string" }, "last_repo_seq": { "type": "integer", "description": "Repository sequence of the canonical contact revision." } }, "required": [ "repo_id", "contact_id", "scope", "display_name", "sort_name", "workspace_count", "lifecycle_state", "created_at", "created_by", "updated_at", "updated_by", "last_repo_seq" ] }, "synckhub_core.types.ContactCompanyLinkSummary": { "title": "ContactCompanyLinkSummary", "type": "object", "properties": { "link_id": { "type": "string" }, "company_folder_item_id": { "type": "string" }, "company_display_name": { "anyOf": [ { "type": "string" }, { "type": "null" } ] }, "role_key": { "anyOf": [ { "type": "string" }, { "type": "null" } ] }, "title": { "anyOf": [ { "type": "string" }, { "type": "null" } ] }, "is_primary": { "type": "boolean" } }, "required": [ "link_id", "company_folder_item_id", "is_primary" ] }, "synckhub_core.types.ContactEmailSummary": { "title": "ContactEmailSummary", "type": "object", "properties": { "email_id": { "type": "string" }, "label": { "anyOf": [ { "type": "string" }, { "type": "null" } ] }, "email": { "type": "string" }, "is_primary": { "type": "boolean" }, "sort_order": { "type": "integer" } }, "required": [ "email_id", "email", "is_primary", "sort_order" ] }, "synckhub_core.types.ContactPhoneSummary": { "title": "ContactPhoneSummary", "type": "object", "properties": { "phone_id": { "type": "string" }, "label": { "anyOf": [ { "type": "string" }, { "type": "null" } ] }, "phone": { "type": "string" }, "is_primary": { "type": "boolean" }, "sort_order": { "type": "integer" } }, "required": [ "phone_id", "phone", "is_primary", "sort_order" ] }, "synckhub_core.types.ContactUrlSummary": { "title": "ContactUrlSummary", "type": "object", "properties": { "url_id": { "type": "string" }, "label": { "anyOf": [ { "type": "string" }, { "type": "null" } ] }, "url": { "type": "string" }, "is_primary": { "type": "boolean" }, "sort_order": { "type": "integer" } }, "required": [ "url_id", "url", "is_primary", "sort_order" ] }, "synckhub_core.types.ContactWorkspaceSummary": { "title": "ContactWorkspaceSummary", "type": "object", "properties": { "link_id": { "type": "string" }, "folder_item_id": { "type": "string" }, "folder_display_name": { "anyOf": [ { "type": "string" }, { "type": "null" } ] }, "company_folder_item_id": { "anyOf": [ { "type": "string" }, { "type": "null" } ] }, "label": { "anyOf": [ { "type": "string" }, { "type": "null" } ] } }, "required": [ "link_id", "folder_item_id" ] }, "synckhub_server.routes.directory.contacts.MergeContactsRequest": { "title": "MergeContactsRequest", "type": "object", "properties": { "operation_id": { "type": "string" }, "merged_contact_ids": { "type": "array", "items": { "type": "string" } } }, "required": [ "operation_id", "merged_contact_ids" ], "additionalProperties": false }, "synckhub_server.routes.directory.contacts.ListNativePrivateContactsRequest": { "title": "ListNativePrivateContactsRequest", "type": "object", "properties": { "contact_ids": { "type": "array", "items": { "type": "string" } } }, "required": [ "contact_ids" ], "additionalProperties": false }, "synckhub_core.types.NativePrivateContact": { "title": "NativePrivateContact", "type": "object", "properties": { "contact_id": { "type": "string" }, "display_name": { "type": "string" }, "given_name": { "anyOf": [ { "type": "string" }, { "type": "null" } ] }, "family_name": { "anyOf": [ { "type": "string" }, { "type": "null" } ] }, "organization_title": { "anyOf": [ { "type": "string" }, { "type": "null" } ] }, "emails": { "type": "array", "items": { "$ref": "#/components/schemas/synckhub_core.types.ContactEmailInput" } }, "phones": { "type": "array", "items": { "$ref": "#/components/schemas/synckhub_core.types.ContactPhoneInput" } }, "urls": { "type": "array", "items": { "$ref": "#/components/schemas/synckhub_core.types.ContactUrlInput" } }, "notes": { "anyOf": [ { "type": "string" }, { "type": "null" } ] } }, "required": [ "contact_id", "display_name" ] }, "synckhub_server.routes.directory.contacts.ListContactsQuery": { "title": "ListContactsQuery", "type": "object", "properties": { "q": { "anyOf": [ { "type": "string" }, { "type": "null" } ] }, "scope": { "anyOf": [ { "type": "string" }, { "type": "null" } ] }, "include_suggested": { "type": "boolean" }, "curation_state": { "anyOf": [ { "type": "string" }, { "type": "null" } ] }, "company_folder_item_id": { "anyOf": [ { "type": "string" }, { "type": "null" } ] }, "limit": { "anyOf": [ { "type": "integer", "minimum": 0 }, { "type": "null" } ] }, "offset": { "anyOf": [ { "type": "integer", "minimum": 0 }, { "type": "null" } ] }, "cursor": { "anyOf": [ { "type": "string" }, { "type": "null" } ] } }, "additionalProperties": false }, "synckhub_server.routes.directory.contacts.ListContactsResponse": { "title": "ListContactsResponse", "type": "object", "properties": { "contacts": { "type": "array", "items": { "$ref": "#/components/schemas/synckhub_core.types.ContactSummary" } }, "page": { "anyOf": [ { "$ref": "#/components/schemas/synckhub_server.routes.CursorPaginationMeta" }, { "type": "null" } ] } }, "required": [ "contacts" ], "additionalProperties": false }, "synckhub_server.routes.directory.contacts.CreateContactRequest": { "title": "CreateContactRequest", "type": "object", "properties": { "operation_id": { "anyOf": [ { "type": "string" }, { "type": "null" } ] }, "display_name": { "type": "string" }, "scope": { "anyOf": [ { "type": "string" }, { "type": "null" } ] }, "fields": { "anyOf": [ {}, { "type": "null" } ] }, "metadata_json": { "anyOf": [ {}, { "type": "null" } ] }, "given_name": { "anyOf": [ { "type": "string" }, { "type": "null" } ] }, "family_name": { "anyOf": [ { "type": "string" }, { "type": "null" } ] }, "organization_title": { "anyOf": [ { "type": "string" }, { "type": "null" } ] }, "emails": { "type": "array", "items": { "$ref": "#/components/schemas/synckhub_core.types.ContactEmailInput" } }, "phones": { "type": "array", "items": { "$ref": "#/components/schemas/synckhub_core.types.ContactPhoneInput" } }, "urls": { "type": "array", "items": { "$ref": "#/components/schemas/synckhub_core.types.ContactUrlInput" } }, "company_links": { "type": "array", "items": { "$ref": "#/components/schemas/synckhub_core.types.ContactCompanyLinkInput" } }, "notes": { "anyOf": [ { "type": "string" }, { "type": "null" } ] }, "external_source": { "anyOf": [ { "type": "string" }, { "type": "null" } ] }, "external_contact_id": { "anyOf": [ { "type": "string" }, { "type": "null" } ] } }, "required": [ "display_name" ], "additionalProperties": false }, "synckhub_server.routes.directory.contacts.ContactMetadataProjectionRebuildResponse": { "title": "ContactMetadataProjectionRebuildResponse", "type": "object", "properties": { "contacts_rebuilt": { "type": "integer" } }, "required": [ "contacts_rebuilt" ], "additionalProperties": false }, "synckhub_server.routes.directory.contacts.PutContactMetadataDefinitionRequest": { "title": "PutContactMetadataDefinitionRequest", "type": "object", "properties": { "fields": {} }, "required": [ "fields" ], "additionalProperties": false }, "synckhub_server.routes.directory.contacts.ContactMetadataDefinitionResponse": { "title": "ContactMetadataDefinitionResponse", "type": "object", "properties": { "repo_id": { "type": "string" }, "fields": {}, "updated_at": { "anyOf": [ { "type": "string" }, { "type": "null" } ] }, "updated_by": { "anyOf": [ { "type": "string" }, { "type": "null" } ] } }, "required": [ "repo_id", "fields" ], "additionalProperties": false }, "synckhub_core.types.ContactsInitResult": { "title": "ContactsInitResult", "type": "object", "properties": { "repo_id": { "type": "string" }, "company_contacts_folder_id": { "anyOf": [ { "type": "string" }, { "type": "null" } ] }, "personal_root_folder_id": { "anyOf": [ { "type": "string" }, { "type": "null" } ] } }, "required": [ "repo_id" ] }, "synckhub_server.routes.directory.party_links.CasePartyLinkSummary": { "title": "CasePartyLinkSummary", "type": "object", "properties": { "link_id": { "type": "string" }, "repo_id": { "type": "string" }, "case_item_id": { "type": "string" }, "party_item_id": { "type": "string" }, "role_key": { "type": "string" }, "status": { "type": "string" }, "metadata": {}, "created_at": { "type": "string" }, "created_by": { "type": "string" }, "updated_at": { "type": "string" }, "updated_by": { "type": "string" } }, "required": [ "link_id", "repo_id", "case_item_id", "party_item_id", "role_key", "status", "metadata", "created_at", "created_by", "updated_at", "updated_by" ], "additionalProperties": false }, "synckhub_server.routes.directory.party_links.BulkCasePartyLinksRequest": { "title": "BulkCasePartyLinksRequest", "type": "object", "properties": { "operations": { "type": "array", "items": { "$ref": "#/components/schemas/synckhub_server.routes.directory.party_links.BulkCasePartyLinkOperation" } } }, "required": [ "operations" ], "additionalProperties": false }, "synckhub_server.routes.directory.party_links.BulkCasePartyLinkOperation": { "title": "BulkCasePartyLinkOperation", "oneOf": [ { "type": "object", "properties": { "verb": { "const": "CREATE" }, "case_item_id": { "type": "string" }, "party_item_id": { "type": "string" }, "role_key": { "type": "string" }, "metadata": { "anyOf": [ {}, { "type": "null" } ] } }, "required": [ "verb", "case_item_id", "party_item_id", "role_key" ], "additionalProperties": false }, { "type": "object", "properties": { "verb": { "const": "ARCHIVE" }, "link_id": { "type": "string" } }, "required": [ "verb", "link_id" ], "additionalProperties": false } ] }, "synckhub_server.routes.directory.party_links.BulkCasePartyLinksResponse": { "title": "BulkCasePartyLinksResponse", "type": "object", "properties": { "results": { "type": "array", "items": { "$ref": "#/components/schemas/synckhub_server.routes.directory.party_links.BulkCasePartyLinkResultEntry" } } }, "required": [ "results" ], "additionalProperties": false }, "synckhub_server.routes.directory.party_links.BulkCasePartyLinkResultEntry": { "title": "BulkCasePartyLinkResultEntry", "type": "object", "properties": { "index": { "type": "integer", "minimum": 0 }, "verb": { "type": "string" }, "ok": { "type": "boolean" }, "link": { "anyOf": [ { "$ref": "#/components/schemas/synckhub_server.routes.directory.party_links.CasePartyLinkSummary" }, { "type": "null" } ] }, "error": { "anyOf": [ { "type": "string" }, { "type": "null" } ] } }, "required": [ "index", "verb", "ok" ], "additionalProperties": false }, "synckhub_server.routes.directory.party_links.CreateCasePartyLinkRequest": { "title": "CreateCasePartyLinkRequest", "type": "object", "properties": { "case_item_id": { "type": "string" }, "party_item_id": { "type": "string" }, "role_key": { "type": "string" }, "metadata": { "anyOf": [ {}, { "type": "null" } ] } }, "required": [ "case_item_id", "party_item_id", "role_key" ], "additionalProperties": false }, "synckhub_server.routes.directory.party_links.CasePartyLinksResponse": { "title": "CasePartyLinksResponse", "type": "object", "properties": { "links": { "type": "array", "items": { "$ref": "#/components/schemas/synckhub_server.routes.directory.party_links.CasePartyLinkSummary" } } }, "required": [ "links" ], "additionalProperties": false }, "synckhub_server.routes.directory.party_links.PartyRoleLinkSummary": { "title": "PartyRoleLinkSummary", "type": "object", "properties": { "link_id": { "type": "string" }, "repo_id": { "type": "string" }, "from_party_item_id": { "type": "string" }, "to_party_item_id": { "type": "string" }, "role_key": { "type": "string" }, "status": { "type": "string" }, "metadata": {}, "created_at": { "type": "string" }, "created_by": { "type": "string" }, "updated_at": { "type": "string" }, "updated_by": { "type": "string" } }, "required": [ "link_id", "repo_id", "from_party_item_id", "to_party_item_id", "role_key", "status", "metadata", "created_at", "created_by", "updated_at", "updated_by" ], "additionalProperties": false }, "synckhub_server.routes.directory.party_links.BulkPartyRoleLinksRequest": { "title": "BulkPartyRoleLinksRequest", "type": "object", "properties": { "operations": { "type": "array", "items": { "$ref": "#/components/schemas/synckhub_server.routes.directory.party_links.BulkPartyRoleLinkOperation" } } }, "required": [ "operations" ], "additionalProperties": false }, "synckhub_server.routes.directory.party_links.BulkPartyRoleLinkOperation": { "title": "BulkPartyRoleLinkOperation", "oneOf": [ { "type": "object", "properties": { "verb": { "const": "CREATE" }, "from_party_item_id": { "type": "string" }, "to_party_item_id": { "type": "string" }, "role_key": { "type": "string" }, "metadata": { "anyOf": [ {}, { "type": "null" } ] } }, "required": [ "verb", "from_party_item_id", "to_party_item_id", "role_key" ], "additionalProperties": false }, { "type": "object", "properties": { "verb": { "const": "ARCHIVE" }, "link_id": { "type": "string" } }, "required": [ "verb", "link_id" ], "additionalProperties": false } ] }, "synckhub_server.routes.directory.party_links.BulkPartyRoleLinksResponse": { "title": "BulkPartyRoleLinksResponse", "type": "object", "properties": { "results": { "type": "array", "items": { "$ref": "#/components/schemas/synckhub_server.routes.directory.party_links.BulkPartyRoleLinkResultEntry" } } }, "required": [ "results" ], "additionalProperties": false }, "synckhub_server.routes.directory.party_links.BulkPartyRoleLinkResultEntry": { "title": "BulkPartyRoleLinkResultEntry", "type": "object", "properties": { "index": { "type": "integer", "minimum": 0 }, "verb": { "type": "string" }, "ok": { "type": "boolean" }, "link": { "anyOf": [ { "$ref": "#/components/schemas/synckhub_server.routes.directory.party_links.PartyRoleLinkSummary" }, { "type": "null" } ] }, "error": { "anyOf": [ { "type": "string" }, { "type": "null" } ] } }, "required": [ "index", "verb", "ok" ], "additionalProperties": false }, "synckhub_server.routes.directory.party_links.CreatePartyRoleLinkRequest": { "title": "CreatePartyRoleLinkRequest", "type": "object", "properties": { "from_party_item_id": { "type": "string" }, "to_party_item_id": { "type": "string" }, "role_key": { "type": "string" }, "metadata": { "anyOf": [ {}, { "type": "null" } ] } }, "required": [ "from_party_item_id", "to_party_item_id", "role_key" ], "additionalProperties": false }, "synckhub_server.routes.directory.party_links.PartyRoleLinksResponse": { "title": "PartyRoleLinksResponse", "type": "object", "properties": { "links": { "type": "array", "items": { "$ref": "#/components/schemas/synckhub_server.routes.directory.party_links.PartyRoleLinkSummary" } } }, "required": [ "links" ], "additionalProperties": false }, "synckhub_server.routes.docs.PatchRepoDocsNavigationRequest": { "title": "PatchRepoDocsNavigationRequest", "type": "object", "properties": { "expected_latest_revision_item_seq": { "type": "integer" }, "enabled": { "anyOf": [ { "anyOf": [ { "type": "boolean" }, { "type": "null" } ] }, { "type": "null" } ] }, "sort_order": { "anyOf": [ { "anyOf": [ { "type": "integer" }, { "type": "null" } ] }, { "type": "null" } ] }, "nav_title": { "anyOf": [ { "anyOf": [ { "type": "string" }, { "type": "null" } ] }, { "type": "null" } ] }, "hidden": { "anyOf": [ { "anyOf": [ { "type": "boolean" }, { "type": "null" } ] }, { "type": "null" } ] } }, "required": [ "expected_latest_revision_item_seq" ], "additionalProperties": false }, "synckhub_core.types.ItemWriteReceipt": { "title": "ItemWriteReceipt", "type": "object", "properties": { "repo_id": { "type": "string" }, "item_id": { "type": "string" }, "item_type": { "type": "string" }, "lifecycle_state": { "type": "string" }, "size": { "anyOf": [ { "type": "integer" }, { "type": "null" } ] }, "commit_id": { "anyOf": [ { "type": "string" }, { "type": "null" } ], "description": "Local Synck VCS commit id when the write has already materialized as a\nlocal commit. Authority-accept federated responses may omit this." }, "commit_event_idx": { "anyOf": [ { "type": "integer" }, { "type": "null" } ], "description": "Event index within `commit_id` when locally materialized." } }, "required": [ "repo_id", "item_id", "item_type", "lifecycle_state" ], "description": "Narrow write-time receipt for existing-item mutations.\n\nThis intentionally excludes broad read-model overlays (`breadcrumbs`, chat read\nstate, locks, federation sync, workflow projections, etc.) so hot write routes\ndo not have to wait for local materialization just to answer success." }, "synckhub_server.routes.federated_folders.FederatedFolderMountReconnectRequest": { "title": "FederatedFolderMountReconnectRequest", "type": "object", "properties": { "tenant_id": { "anyOf": [ { "type": "string" }, { "type": "null" } ], "description": "Optional override when auth is disabled." } }, "additionalProperties": false }, "synckhub_federation.clearinghouse.FederatedFolderMountSyncResult": { "title": "FederatedFolderMountSyncResult", "type": "object", "properties": { "mount_id": { "type": "string" }, "federation_stream_id": { "type": "string" }, "synced_events": { "type": "integer" }, "last_applied_domain_seq": { "type": "integer" } }, "required": [ "mount_id", "federation_stream_id", "synced_events", "last_applied_domain_seq" ] }, "synckhub_server.routes.federated_folders.FederatedFolderMountDetachRequest": { "title": "FederatedFolderMountDetachRequest", "type": "object", "properties": { "tenant_id": { "anyOf": [ { "type": "string" }, { "type": "null" } ], "description": "Optional override when auth is disabled." } }, "additionalProperties": false }, "synckhub_federation.clearinghouse.FederatedFolderMountDetachResult": { "title": "FederatedFolderMountDetachResult", "type": "object", "properties": { "mount_id": { "type": "string" }, "status": { "type": "string" }, "detached_at": { "anyOf": [ { "type": "string" }, { "type": "null" } ] } }, "required": [ "mount_id", "status" ] }, "synckhub_federation.service.FederatedTaskCutoverAdvanceResult": { "title": "FederatedTaskCutoverAdvanceResult", "type": "object", "properties": { "state": { "$ref": "#/components/schemas/synckhub_federation_protocol.task_cutover.StateV1" }, "step": { "type": "string" }, "detail": { "anyOf": [ {}, { "type": "null" } ] } }, "required": [ "state", "step" ] }, "synckhub_federation_protocol.task_cutover.StateV1": { "title": "StateV1", "type": "object", "properties": { "federation_stream_id": { "type": "string" }, "migration_id": { "type": "string", "format": "uuid" }, "membership_seq": { "type": "integer" }, "source_authority_id": { "type": "string" }, "source_authority_domain": { "type": "string" }, "source_tenant_id": { "type": "string" }, "phase": { "$ref": "#/components/schemas/synckhub_federation_protocol.task_cutover.PhaseV1" }, "members": { "type": "array", "items": { "$ref": "#/components/schemas/synckhub_federation_protocol.types.MemberV1" } }, "reports": { "type": "array", "items": { "$ref": "#/components/schemas/synckhub_federation_protocol.task_cutover.ReportV1" } } }, "required": [ "federation_stream_id", "migration_id", "membership_seq", "source_authority_id", "source_authority_domain", "source_tenant_id", "phase", "members", "reports" ], "additionalProperties": false }, "synckhub_federation_protocol.task_cutover.PhaseV1": { "title": "PhaseV1", "oneOf": [ { "type": "object", "properties": { "phase": { "const": "DRAINING" } }, "required": [ "phase" ], "additionalProperties": false }, { "type": "object", "properties": { "phase": { "const": "LEGACY_FROZEN" }, "legacy": { "$ref": "#/components/schemas/synckhub_federation_protocol.task_cutover.PositionV1" } }, "required": [ "phase", "legacy" ], "additionalProperties": false }, { "type": "object", "properties": { "phase": { "const": "IMPORTING" }, "legacy": { "$ref": "#/components/schemas/synckhub_federation_protocol.task_cutover.PositionV1" } }, "required": [ "phase", "legacy" ], "additionalProperties": false }, { "type": "object", "properties": { "phase": { "const": "VERIFYING" }, "legacy": { "$ref": "#/components/schemas/synckhub_federation_protocol.task_cutover.PositionV1" }, "migration": { "$ref": "#/components/schemas/synckhub_federation_protocol.task_cutover.PositionV1" } }, "required": [ "phase", "legacy", "migration" ], "additionalProperties": false }, { "type": "object", "properties": { "phase": { "const": "READY" }, "legacy": { "$ref": "#/components/schemas/synckhub_federation_protocol.task_cutover.PositionV1" }, "migration": { "$ref": "#/components/schemas/synckhub_federation_protocol.task_cutover.PositionV1" } }, "required": [ "phase", "legacy", "migration" ], "additionalProperties": false } ] }, "synckhub_federation_protocol.task_cutover.PositionV1": { "title": "PositionV1", "type": "object", "properties": { "domain_seq": { "type": "integer" }, "head_digest": { "type": "string" } }, "required": [ "domain_seq", "head_digest" ], "additionalProperties": false }, "synckhub_federation_protocol.task_cutover.ReportV1": { "title": "ReportV1", "type": "object", "properties": { "member": { "$ref": "#/components/schemas/synckhub_federation_protocol.types.MemberV1" }, "progress": { "$ref": "#/components/schemas/synckhub_federation_protocol.task_cutover.ReplicaProgressV1" } }, "required": [ "member", "progress" ], "additionalProperties": false }, "synckhub_federation_protocol.task_cutover.ReplicaProgressV1": { "title": "ReplicaProgressV1", "oneOf": [ { "type": "object", "properties": { "phase": { "const": "DRAINED" }, "repo_id": { "type": "string" } }, "required": [ "phase", "repo_id" ], "additionalProperties": false }, { "type": "object", "properties": { "phase": { "const": "LEGACY_APPLIED" }, "repo_id": { "type": "string" }, "position": { "$ref": "#/components/schemas/synckhub_federation_protocol.task_cutover.PositionV1" } }, "required": [ "phase", "repo_id", "position" ], "additionalProperties": false }, { "type": "object", "properties": { "phase": { "const": "IMPORTS_SUBMITTED" }, "repo_id": { "type": "string" }, "position": { "$ref": "#/components/schemas/synckhub_federation_protocol.task_cutover.PositionV1" } }, "required": [ "phase", "repo_id", "position" ], "additionalProperties": false }, { "type": "object", "properties": { "phase": { "const": "VERIFIED" }, "repo_id": { "type": "string" }, "position": { "$ref": "#/components/schemas/synckhub_federation_protocol.task_cutover.PositionV1" } }, "required": [ "phase", "repo_id", "position" ], "additionalProperties": false } ] }, "synckhub_federation_protocol.task_cutover.RequestV1": { "title": "RequestV1", "oneOf": [ { "type": "object", "properties": { "action": { "const": "BEGIN" }, "migration_id": { "type": "string", "format": "uuid" }, "expected_membership_seq": { "type": "integer" } }, "required": [ "action", "migration_id", "expected_membership_seq" ], "additionalProperties": false }, { "type": "object", "properties": { "action": { "const": "REFRESH_MEMBERSHIP" }, "migration_id": { "type": "string", "format": "uuid" }, "expected_membership_seq": { "type": "integer" } }, "required": [ "action", "migration_id", "expected_membership_seq" ], "additionalProperties": false }, { "type": "object", "properties": { "action": { "const": "ADVANCE" }, "migration_id": { "type": "string", "format": "uuid" }, "expected_membership_seq": { "type": "integer" }, "expected_phase": { "$ref": "#/components/schemas/synckhub_federation_protocol.task_cutover.PhaseV1", "description": "Compare-and-set the complete phase, including its bound prefixes.\nA lost response must never advance a second phase on blind retry." } }, "required": [ "action", "migration_id", "expected_membership_seq", "expected_phase" ], "additionalProperties": false }, { "type": "object", "properties": { "action": { "const": "REPORT" }, "migration_id": { "type": "string", "format": "uuid" }, "expected_membership_seq": { "type": "integer" }, "progress": { "$ref": "#/components/schemas/synckhub_federation_protocol.task_cutover.ReplicaProgressV1" } }, "required": [ "action", "migration_id", "expected_membership_seq", "progress" ], "additionalProperties": false } ] }, "synckhub_server.routes.federated_folders.FederatedFolderSubmitProposalRequest": { "title": "FederatedFolderSubmitProposalRequest", "type": "object", "properties": { "client_proposal_id": { "type": "string" }, "message": { "anyOf": [ { "type": "string" }, { "type": "null" } ] }, "events": { "type": "array", "items": { "$ref": "#/components/schemas/synck_vcs.types.EventProposal" } }, "tenant_id": { "anyOf": [ { "type": "string" }, { "type": "null" } ], "description": "Optional override when auth is disabled." } }, "required": [ "client_proposal_id", "events" ], "additionalProperties": false }, "synck_vcs.types.EventProposal": { "title": "EventProposal", "type": "object", "properties": { "item_id": { "anyOf": [ { "type": "string" }, { "type": "null" } ], "description": "Target item id; required unless `create_item` is present." }, "event_type": { "$ref": "#/components/schemas/synck_vcs.types.EventType" }, "set_metadata": { "anyOf": [ {}, { "type": "null" } ], "description": "Non‑structural metadata associated with this event (tags, labels, etc.)." }, "set_content": { "anyOf": [ { "$ref": "#/components/schemas/synck_vcs.types.EventContent" }, { "type": "null" } ], "description": "Structured content for this event (text/JSON/blob ids)." }, "create_item": { "anyOf": [ { "$ref": "#/components/schemas/synck_vcs.types.CreateItem" }, { "type": "null" } ], "description": "Create a new item." }, "set_parent": { "anyOf": [ { "anyOf": [ { "type": "string" }, { "type": "null" } ] }, { "type": "null" } ], "description": "Set parent.\n\nEncoding is tri-state:\n- `None` => no change\n- `Some(None)` => move to root\n- `Some(Some(id))` => move under `id`" }, "set_name": { "anyOf": [ { "type": "string" }, { "type": "null" } ], "description": "Rename item." }, "set_tombstoned": { "anyOf": [ { "type": "boolean" }, { "type": "null" } ], "description": "Mark item tombstoned (permanent delete)." }, "set_in_trash": { "anyOf": [ { "type": "boolean" }, { "type": "null" } ], "description": "Mark item in/out of trash (soft delete)." }, "set_is_federated": { "anyOf": [ { "type": "boolean" }, { "type": "null" } ], "description": "Transition to federated sequencing." }, "set_federation_stream_id": { "anyOf": [ { "$ref": "#/components/schemas/synck_vcs.types.FederationStreamId" }, { "type": "null" } ], "description": "Set federation stream id for item." }, "base_seq": { "anyOf": [ { "type": "integer" }, { "type": "null" } ], "description": "Snapshot of the item's head_seq observed by the caller when this\nevent was constructed.\n\n- For events targeting an existing item, this MUST be `Some(seq)`.\n- For `create_item` events, this MUST be `None` (no prior history).\n\nAll events in a commit that target the same (repo_id, item_id)\nare expected to carry the same `base_seq` value. Core enforces\nonly shape/consistency; mutation policies are platform concerns." } }, "required": [ "event_type" ], "additionalProperties": false, "description": "Event proposal used when building commits." }, "synck_vcs.types.EventType": { "title": "EventType", "type": "string" }, "synck_vcs.types.EventContent": { "title": "EventContent", "anyOf": [ { "type": "object", "properties": { "text": { "type": "string" } }, "required": [ "text" ], "additionalProperties": false }, { "type": "object", "properties": { "json": {} }, "required": [ "json" ], "additionalProperties": false }, { "type": "object", "properties": { "blob_id": { "type": "string" } }, "required": [ "blob_id" ], "additionalProperties": false }, { "type": "object", "properties": { "content_id": { "$ref": "#/components/schemas/synck_vcs.types.ContentId" } }, "required": [ "content_id" ], "additionalProperties": false } ], "description": "Structured content body for an event.\n\nCanonical rule: a `set_content` value is *exactly one* of:\n\n- `{ \"text\": \"...\" }`\n- `{ \"json\": { ... } }`\n- `{ \"blob_id\": \"sha256:\" }`\n- `{ \"content_id\": \"sha256:\" }`\n\nIf an event has no content, `set_content` is `null`." }, "synck_vcs.types.ContentId": { "title": "ContentId", "type": "array", "items": { "type": "integer", "minimum": 0 } }, "synck_vcs.types.CreateItem": { "title": "CreateItem", "type": "object", "properties": { "item_type": { "$ref": "#/components/schemas/synck_vcs.types.ItemType" }, "parent_folder_id": { "anyOf": [ { "type": "string" }, { "type": "null" } ] }, "name": { "type": "string" } }, "required": [ "item_type", "name" ], "additionalProperties": false, "description": "Fields for creating a new item structurally." }, "synck_vcs.types.ItemType": { "title": "ItemType", "type": "string" }, "synck_vcs.types.FederationStreamId": { "title": "FederationStreamId", "type": "string" }, "synckhub_federation.clearinghouse.FederatedFolderSubmitProposalResult": { "title": "FederatedFolderSubmitProposalResult", "type": "object", "properties": { "mount_id": { "type": "string" }, "federation_stream_id": { "type": "string" }, "domain_seq": { "type": "integer" }, "payload_digest_hex": { "type": "string" } }, "required": [ "mount_id", "federation_stream_id", "domain_seq", "payload_digest_hex" ] }, "synckhub_server.routes.federated_folders.FederatedFolderMountCreateRequest": { "title": "FederatedFolderMountCreateRequest", "type": "object", "properties": { "invite": { "$ref": "#/components/schemas/synckhub_federation_protocol.types.SignedEnvelopeV1_FederationInviteV1" }, "secret": { "anyOf": [ { "type": "string" }, { "type": "null" } ] }, "parent_folder_id": { "anyOf": [ { "type": "string" }, { "type": "null" } ] }, "mount_name": { "anyOf": [ { "type": "string" }, { "type": "null" } ] } }, "required": [ "invite" ], "additionalProperties": false }, "synckhub_federation.clearinghouse.FederatedFolderMountSummary": { "title": "FederatedFolderMountSummary", "type": "object", "properties": { "mount_id": { "type": "string" }, "repo_id": { "type": "string" }, "mount_item_id": { "type": "string" }, "federation_stream_id": { "type": "string" }, "federated_folder_id": { "type": "string" }, "mirror_repo_id": { "type": "string" }, "status": { "type": "string" }, "mount_portal_state": { "type": "string" }, "last_applied_domain_seq": { "type": "integer" }, "federation_sync": { "anyOf": [ { "$ref": "#/components/schemas/synckhub_core.types.FederationSyncSummary" }, { "type": "null" } ] }, "total_chats": { "anyOf": [ { "type": "integer" }, { "type": "null" } ] }, "unread_chats": { "anyOf": [ { "type": "integer" }, { "type": "null" } ] }, "unread_messages": { "anyOf": [ { "type": "integer" }, { "type": "null" } ] } }, "required": [ "mount_id", "repo_id", "mount_item_id", "federation_stream_id", "federated_folder_id", "mirror_repo_id", "status", "mount_portal_state", "last_applied_domain_seq" ] }, "synckhub_server.routes.items.lifecycle.SimpleItemActionRequest": { "title": "SimpleItemActionRequest", "type": "object", "properties": {}, "additionalProperties": false }, "synckhub_server.routes.federation.items.FederateItemRequest": { "title": "FederateItemRequest", "type": "object", "properties": { "federated_id": { "anyOf": [ { "type": "string" }, { "type": "null" } ] } }, "additionalProperties": false }, "synckhub_federation.clearinghouse.FederationEnsureItemResult": { "title": "FederationEnsureItemResult", "type": "object", "properties": { "federation_stream_id": { "type": "string" }, "domain_kind": { "$ref": "#/components/schemas/synckhub_federation_protocol.types.DomainKindV1" }, "federated_id": { "type": "string" }, "membership_seq": { "type": "integer" }, "already_federated": { "type": "boolean" }, "mirror_repo_id": { "anyOf": [ { "type": "string" }, { "type": "null" } ] } }, "required": [ "federation_stream_id", "domain_kind", "federated_id", "membership_seq", "already_federated" ] }, "synckhub_server.routes.federation.recipient_keys.DomainBody": { "title": "DomainBody", "type": "object", "properties": { "domain": { "type": "string" } }, "required": [ "domain" ], "additionalProperties": false }, "synckhub_federation.recipient_keys.RecipientKeyDocumentV1": { "title": "RecipientKeyDocumentV1", "type": "object", "properties": { "version": { "type": "integer" }, "domain": { "type": "string" }, "tenant_id": { "type": "string" }, "keys": { "type": "array", "items": { "$ref": "#/components/schemas/synckhub_federation.recipient_keys.RecipientKeyEntryV1" } } }, "required": [ "version", "domain", "tenant_id", "keys" ], "additionalProperties": false }, "synckhub_federation.recipient_keys.RecipientKeyEntryV1": { "title": "RecipientKeyEntryV1", "type": "object", "properties": { "infrastructure_id": { "type": "string" }, "jwk": { "$ref": "#/components/schemas/synckhub_federation.recipient_keys.RecipientPublicJwkV1" } }, "required": [ "infrastructure_id", "jwk" ], "additionalProperties": false }, "synckhub_federation.recipient_keys.RecipientPublicJwkV1": { "title": "RecipientPublicJwkV1", "type": "object", "properties": { "kty": { "type": "string" }, "crv": { "type": "string" }, "use": { "type": "string" }, "kid": { "type": "string" }, "x": { "type": "string" } }, "required": [ "kty", "crv", "use", "kid", "x" ], "additionalProperties": false }, "synckhub_server.routes.federation.recipient_keys.RecipientKeySummary": { "title": "RecipientKeySummary", "type": "object", "properties": { "kid": { "type": "string" }, "public_key_b64": { "type": "string" }, "publication_state": { "type": "string" }, "created_at": { "type": "string", "format": "date-time" }, "retired_at": { "anyOf": [ { "type": "string", "format": "date-time" }, { "type": "null" } ] } }, "required": [ "kid", "public_key_b64", "publication_state", "created_at" ] }, "synckhub_server.routes.federation.status.RepoFederationStatusResponse": { "title": "RepoFederationStatusResponse", "type": "object", "properties": { "repo_id": { "type": "string" }, "healthy": { "type": "boolean" }, "counts": { "$ref": "#/components/schemas/synckhub_server.routes.federation.status.RepoFederationStatusCounts" }, "issues": { "type": "array", "items": { "$ref": "#/components/schemas/synckhub_server.routes.federation.status.RepoFederationStatusIssue" } } }, "required": [ "repo_id", "healthy", "counts", "issues" ] }, "synckhub_server.routes.federation.status.RepoFederationStatusCounts": { "title": "RepoFederationStatusCounts", "type": "object", "properties": { "total_entries": { "type": "integer", "minimum": 0 }, "healthy_entries": { "type": "integer", "minimum": 0 }, "issue_entries": { "type": "integer", "minimum": 0 }, "current_entries": { "type": "integer", "minimum": 0 }, "catching_up_entries": { "type": "integer", "minimum": 0 }, "session_stale_entries": { "type": "integer", "minimum": 0 }, "session_detached_entries": { "type": "integer", "minimum": 0 }, "session_missing_entries": { "type": "integer", "minimum": 0 }, "member_auth_stale_entries": { "type": "integer", "minimum": 0 }, "member_auth_blocked_entries": { "type": "integer", "minimum": 0 }, "replica_hydrating_entries": { "type": "integer", "minimum": 0 }, "replica_incomplete_entries": { "type": "integer", "minimum": 0 }, "replica_blocked_entries": { "type": "integer", "minimum": 0 }, "broken_portal_entries": { "type": "integer", "minimum": 0 }, "detached_portal_entries": { "type": "integer", "minimum": 0 } }, "required": [ "total_entries", "healthy_entries", "issue_entries", "current_entries", "catching_up_entries", "session_stale_entries", "session_detached_entries", "session_missing_entries", "member_auth_stale_entries", "member_auth_blocked_entries", "replica_hydrating_entries", "replica_incomplete_entries", "replica_blocked_entries", "broken_portal_entries", "detached_portal_entries" ] }, "synckhub_server.routes.federation.status.RepoFederationStatusIssue": { "title": "RepoFederationStatusIssue", "type": "object", "properties": { "surface": { "type": "string" }, "federation_stream_id": { "type": "string" }, "item_id": { "anyOf": [ { "type": "string" }, { "type": "null" } ] }, "item_type": { "anyOf": [ { "type": "string" }, { "type": "null" } ] }, "item_name": { "anyOf": [ { "type": "string" }, { "type": "null" } ] }, "mount_id": { "anyOf": [ { "type": "string" }, { "type": "null" } ] }, "mount_root_item_id": { "anyOf": [ { "type": "string" }, { "type": "null" } ] }, "home_repo_id": { "anyOf": [ { "type": "string" }, { "type": "null" } ] }, "mirror_repo_id": { "anyOf": [ { "type": "string" }, { "type": "null" } ] }, "local_status": { "anyOf": [ { "type": "string" }, { "type": "null" } ] }, "mount_portal_state": { "anyOf": [ { "type": "string" }, { "type": "null" } ] }, "federation_sync": { "$ref": "#/components/schemas/synckhub_core.types.FederationSyncSummary" } }, "required": [ "surface", "federation_stream_id", "federation_sync" ] }, "synckhub_server.routes.files.archive.UnzipItemRequest": { "title": "UnzipItemRequest", "type": "object", "properties": { "item_id": { "type": "string", "description": "Zip FILE item id to extract." }, "parent_folder_id": { "anyOf": [ { "type": "string" }, { "type": "null" } ], "description": "Destination parent folder id for the created root folder:\n- `None` means root.\n- `Some(\\\"\\\")` means root." }, "root_folder_name": { "anyOf": [ { "type": "string" }, { "type": "null" } ], "description": "Optional override for the created root folder name." }, "force": { "type": "boolean", "description": "Guardrail: require explicit `force=true` for very large unzips." } }, "required": [ "item_id" ], "additionalProperties": false }, "synckhub_server.routes.files.archive.UnzipItemResponse": { "title": "UnzipItemResponse", "type": "object", "properties": { "repo_id": { "type": "string" }, "root_folder": { "$ref": "#/components/schemas/synckhub_core.types.ItemSummary" }, "created_folders": { "type": "integer", "minimum": 0 }, "created_files": { "type": "integer", "minimum": 0 }, "commit_id": { "type": "string" } }, "required": [ "repo_id", "root_folder", "created_folders", "created_files", "commit_id" ], "additionalProperties": false }, "synckhub_server.routes.files.archive.ZipItemsRequest": { "title": "ZipItemsRequest", "type": "object", "properties": { "name": { "type": "string", "description": "Name for the newly created zip FILE item." }, "parent_folder_id": { "anyOf": [ { "type": "string" }, { "type": "null" } ], "description": "Destination parent folder id:\n- `None` means root.\n- `Some(\\\"\\\")` means root." }, "item_ids": { "type": "array", "items": { "type": "string" }, "description": "Item ids to include. Each id may refer to either a FILE or a FOLDER.\n\nFolder ids include the full LIVE subtree of files under that folder." }, "force": { "type": "boolean", "description": "Guardrail: require explicit `force=true` for very large zips." } }, "required": [ "name", "item_ids" ], "additionalProperties": false }, "synckhub_server.routes.files.archive.ZipItemsResponse": { "title": "ZipItemsResponse", "type": "object", "properties": { "repo_id": { "type": "string" }, "item": { "$ref": "#/components/schemas/synckhub_core.types.ItemSummary" }, "blob_id": { "type": "string" }, "size": { "type": "integer", "minimum": 0 }, "commit_id": { "type": "string" } }, "required": [ "repo_id", "item", "blob_id", "size", "commit_id" ], "additionalProperties": false }, "synckhub_core.types.FileContentHeadSummary": { "title": "FileContentHeadSummary", "type": "object", "properties": { "repo_id": { "type": "string" }, "item_id": { "type": "string" }, "blob_id": { "type": "string" }, "size": { "anyOf": [ { "type": "integer" }, { "type": "null" } ] }, "item_seq": { "anyOf": [ { "type": "integer" }, { "type": "null" } ] }, "commit_id": { "anyOf": [ { "type": "string" }, { "type": "null" } ] }, "commit_event_idx": { "anyOf": [ { "type": "integer" }, { "type": "null" } ] }, "updated_at": { "anyOf": [ { "type": "string" }, { "type": "null" } ] }, "updated_by": { "anyOf": [ { "type": "string" }, { "type": "null" } ] } }, "required": [ "repo_id", "item_id", "blob_id" ], "description": "Current head content reference for a blob-backed item (primarily `FILE`)." }, "synckhub_server.routes.files.content.CreateSelectionDownloadUrlRequest": { "title": "CreateSelectionDownloadUrlRequest", "type": "object", "properties": { "item_ids": { "type": "array", "items": { "type": "string" } }, "download_name": { "anyOf": [ { "type": "string" }, { "type": "null" } ] } }, "required": [ "item_ids" ], "additionalProperties": false }, "synckhub_server.routes.files.drafts.DraftHistoryListResponse": { "title": "DraftHistoryListResponse", "type": "object", "properties": { "repo_id": { "type": "string" }, "item_id": { "type": "string" }, "snapshots": { "type": "array", "items": { "$ref": "#/components/schemas/synckhub_server.routes.files.drafts.DraftHistorySnapshotSummary" } } }, "required": [ "repo_id", "item_id", "snapshots" ] }, "synckhub_server.routes.files.drafts.DraftHistorySnapshotSummary": { "title": "DraftHistorySnapshotSummary", "type": "object", "properties": { "snapshot_id": { "type": "string" }, "owner_id": { "type": "string" }, "sha256": { "type": "string" }, "size": { "type": "integer", "minimum": 0 }, "created_at": { "type": "string" } }, "required": [ "snapshot_id", "owner_id", "sha256", "size", "created_at" ] }, "synckhub_server.routes.files.drafts.MountedWriteFileResponse": { "title": "MountedWriteFileResponse", "type": "object", "properties": { "repo_id": { "type": "string" }, "item_id": { "type": "string" }, "mounted_write_id": { "type": "string" }, "blob_id": { "type": "string" }, "size": { "type": "integer", "minimum": 0 }, "commit_id": { "type": "string" }, "item_seq": { "type": "integer" }, "changed": { "type": "boolean" } }, "required": [ "repo_id", "item_id", "mounted_write_id", "blob_id", "size", "commit_id", "item_seq", "changed" ] }, "synckhub_server.routes.files.drafts.ConditionalPublishFileDraftRequest": { "title": "ConditionalPublishFileDraftRequest", "type": "object", "properties": { "draft_id": { "type": "string" }, "expected_head_blob_id": { "type": "string" }, "expected_head_item_seq": { "type": "integer" } }, "required": [ "draft_id", "expected_head_blob_id", "expected_head_item_seq" ], "additionalProperties": false }, "synckhub_server.routes.files.drafts.ConditionalPublishFileDraftResponse": { "title": "ConditionalPublishFileDraftResponse", "type": "object", "properties": { "repo_id": { "type": "string" }, "item_id": { "type": "string" }, "draft_id": { "type": "string" }, "blob_id": { "type": "string" }, "size": { "type": "integer", "minimum": 0 }, "commit_id": { "type": "string" }, "item_seq": { "type": "integer" }, "changed": { "type": "boolean" } }, "required": [ "repo_id", "item_id", "draft_id", "blob_id", "size", "commit_id", "item_seq", "changed" ] }, "synckhub_server.routes.files.drafts.PublishFileDraftRequest": { "title": "PublishFileDraftRequest", "type": "object", "properties": { "draft_id": { "type": "string" } }, "required": [ "draft_id" ], "additionalProperties": false }, "synckhub_server.routes.files.drafts.PublishFileDraftResponse": { "title": "PublishFileDraftResponse", "type": "object", "properties": { "repo_id": { "type": "string" }, "item_id": { "type": "string" }, "draft_id": { "type": "string" }, "blob_id": { "type": "string" }, "size": { "type": "integer", "minimum": 0 }, "commit_id": { "type": "string" } }, "required": [ "repo_id", "item_id", "draft_id", "blob_id", "size", "commit_id" ] }, "synckhub_server.routes.files.drafts.PutFileDraftResponse": { "title": "PutFileDraftResponse", "type": "object", "properties": { "repo_id": { "type": "string" }, "item_id": { "type": "string" }, "draft_id": { "type": "string" }, "sha256": { "type": "string" }, "size": { "type": "integer", "minimum": 0 }, "expected_head_blob_id": { "anyOf": [ { "type": "string" }, { "type": "null" } ] }, "expected_head_item_seq": { "anyOf": [ { "type": "integer" }, { "type": "null" } ] } }, "required": [ "repo_id", "item_id", "draft_id", "sha256", "size" ] }, "synckhub_server.routes.files.drafts.ForceUnlockRequest": { "title": "ForceUnlockRequest", "type": "object", "properties": { "lock_type": { "type": "string" } }, "required": [ "lock_type" ], "additionalProperties": false }, "synckhub_server.routes.files.drafts.ForceUnlockResponse": { "title": "ForceUnlockResponse", "type": "object", "properties": { "released": { "type": "boolean" }, "lock_type": { "type": "string" }, "previous_owner_id": { "anyOf": [ { "type": "string" }, { "type": "null" } ] }, "saved_outside_state": { "anyOf": [ { "$ref": "#/components/schemas/synckhub_server.routes.files.drafts.SavedOutsideState" }, { "type": "null" } ] } }, "required": [ "released", "lock_type" ] }, "synckhub_server.routes.files.drafts.SavedOutsideState": { "title": "SavedOutsideState", "type": "object", "properties": { "commit_id": { "anyOf": [ { "type": "string" }, { "type": "null" } ] }, "blob_id": { "anyOf": [ { "type": "string" }, { "type": "null" } ] }, "size_bytes": { "anyOf": [ { "type": "integer", "minimum": 0 }, { "type": "null" } ] } } }, "synckhub_server.routes.files.drafts.AcquireExclusiveLockRequest": { "title": "AcquireExclusiveLockRequest", "type": "object", "properties": { "ttl_seconds": { "anyOf": [ { "type": "integer", "minimum": 0 }, { "type": "null" } ] } }, "additionalProperties": false }, "synckhub_core.types.LockSummary": { "title": "LockSummary", "type": "object", "properties": { "repo_id": { "type": "string" }, "item_id": { "type": "string" }, "lock_type": { "type": "string" }, "owner_id": { "type": "string" }, "lock_token": { "type": "string" }, "created_at": { "type": "string" }, "expires_at": { "type": "string" } }, "required": [ "repo_id", "item_id", "lock_type", "owner_id", "lock_token", "created_at", "expires_at" ], "description": "Summary of an item-level platform lock (from `platform_locks`)." }, "synckhub_server.routes.files.drafts.BulkReleaseExclusiveLocksRequest": { "title": "BulkReleaseExclusiveLocksRequest", "type": "object", "properties": { "item_ids": { "anyOf": [ { "type": "array", "items": { "type": "string" } }, { "type": "null" } ] } }, "additionalProperties": false }, "synckhub_server.routes.files.drafts.BulkReleaseExclusiveLocksResponse": { "title": "BulkReleaseExclusiveLocksResponse", "type": "object", "properties": { "released_item_ids": { "type": "array", "items": { "type": "string" } }, "failures": { "type": "array", "items": { "$ref": "#/components/schemas/synckhub_server.routes.files.drafts.BulkLockFailure" } } }, "required": [ "released_item_ids", "failures" ] }, "synckhub_server.routes.files.drafts.BulkLockFailure": { "title": "BulkLockFailure", "type": "object", "properties": { "item_id": { "type": "string" }, "code": { "type": "string" }, "message": { "type": "string" } }, "required": [ "item_id", "code", "message" ] }, "synckhub_server.routes.files.drafts.BulkAcquireExclusiveLocksRequest": { "title": "BulkAcquireExclusiveLocksRequest", "type": "object", "properties": { "item_ids": { "type": "array", "items": { "type": "string" } }, "ttl_seconds": { "anyOf": [ { "type": "integer", "minimum": 0 }, { "type": "null" } ] } }, "required": [ "item_ids" ], "additionalProperties": false }, "synckhub_server.routes.files.drafts.BulkAcquireExclusiveLocksResponse": { "title": "BulkAcquireExclusiveLocksResponse", "type": "object", "properties": { "locks": { "type": "array", "items": { "$ref": "#/components/schemas/synckhub_core.types.LockSummary" } }, "failures": { "type": "array", "items": { "$ref": "#/components/schemas/synckhub_server.routes.files.drafts.BulkLockFailure" } } }, "required": [ "locks", "failures" ] }, "synckhub_server.routes.files.drafts.ListExclusiveLocksResponse": { "title": "ListExclusiveLocksResponse", "type": "object", "properties": { "locks": { "type": "array", "items": { "$ref": "#/components/schemas/synckhub_server.routes.files.drafts.ItemExclusiveLockSummary" } } }, "required": [ "locks" ] }, "synckhub_server.routes.files.drafts.ItemExclusiveLockSummary": { "title": "ItemExclusiveLockSummary", "type": "object", "properties": { "lock": { "$ref": "#/components/schemas/synckhub_core.types.LockSummary" }, "item": { "anyOf": [ { "$ref": "#/components/schemas/synckhub_core.types.ItemSummary" }, { "type": "null" } ] } }, "required": [ "lock" ] }, "synckhub_server.routes.files.exports.NormalExportBlobPackRequest": { "title": "NormalExportBlobPackRequest", "type": "object", "properties": { "ordinals": { "type": "array", "items": { "type": "integer" } } }, "required": [ "ordinals" ], "additionalProperties": false }, "synckhub_core.types.NormalExportManifestRequest": { "title": "NormalExportManifestRequest", "type": "object", "properties": { "folder_item_id": { "anyOf": [ { "type": "string" }, { "type": "null" } ] }, "revision_scope": { "type": "string" }, "target_platform": { "anyOf": [ { "type": "string" }, { "type": "null" } ], "description": "Destination filesystem family for path collision and reserved-name checks.\n\nAccepted values are `portable`, `windows`, `macos`, and `linux`.\nOmitted clients get `portable`, the conservative cross-platform profile." }, "snapshot_repo_seq": { "anyOf": [ { "type": "integer" }, { "type": "null" } ] }, "cursor": { "anyOf": [ { "type": "string" }, { "type": "null" } ] }, "limit": { "anyOf": [ { "type": "integer", "minimum": 0 }, { "type": "null" } ] } }, "required": [ "revision_scope" ], "description": "Request for a point-in-time normal filesystem export manifest.\n\nNormal export is only `FOLDER` and `FILE` materialization. Rich application\ndata export is a separate contract." }, "synckhub_core.types.NormalExportManifestResponse": { "title": "NormalExportManifestResponse", "type": "object", "properties": { "repo_id": { "type": "string" }, "folder_item_id": { "anyOf": [ { "type": "string" }, { "type": "null" } ] }, "export_plan_id": { "anyOf": [ { "type": "string" }, { "type": "null" } ] }, "revision_scope": { "type": "string" }, "snapshot_repo_seq": { "type": "integer" }, "snapshot_captured_at": { "type": "string" }, "entries": { "type": "array", "items": { "$ref": "#/components/schemas/synckhub_core.types.NormalExportManifestEntry" } }, "next_cursor": { "anyOf": [ { "type": "string" }, { "type": "null" } ] }, "planned_directories": { "type": "integer", "minimum": 0 }, "planned_files": { "type": "integer", "minimum": 0 }, "planned_bytes": { "type": "integer", "minimum": 0 }, "skipped_non_files": { "type": "integer", "minimum": 0 } }, "required": [ "repo_id", "revision_scope", "snapshot_repo_seq", "snapshot_captured_at", "entries", "planned_directories", "planned_files", "planned_bytes", "skipped_non_files" ] }, "synckhub_core.types.NormalExportManifestEntry": { "title": "NormalExportManifestEntry", "type": "object", "properties": { "kind": { "type": "string", "description": "`directory` or `file`." }, "relative_path": { "type": "string" }, "source_item_id": { "type": "string" }, "source_item_seq": { "anyOf": [ { "type": "integer" }, { "type": "null" } ] }, "blob_id": { "anyOf": [ { "type": "string" }, { "type": "null" } ] }, "size": { "anyOf": [ { "type": "integer" }, { "type": "null" } ] }, "version_labels": { "type": "array", "items": { "$ref": "#/components/schemas/synckhub_core.types.NormalExportVersionLabel" } } }, "required": [ "kind", "relative_path", "source_item_id" ], "description": "One materialized normal filesystem export output." }, "synckhub_core.types.NormalExportVersionLabel": { "title": "NormalExportVersionLabel", "type": "object", "properties": { "version_id": { "type": "string" }, "version_major": { "type": "integer" }, "version_minor": { "type": "integer" }, "order_key": { "type": "integer" }, "source_item_seq": { "anyOf": [ { "type": "integer" }, { "type": "null" } ] } }, "required": [ "version_id", "version_major", "version_minor", "order_key" ] }, "synckhub_core_postgres.service.file_ocr.FileOcrRequest": { "title": "FileOcrRequest", "type": "object", "properties": { "expected_content_blob_id": { "type": "string" }, "expected_content_item_seq": { "type": "integer" }, "retry_of_revision": { "anyOf": [ { "type": "integer" }, { "type": "null" } ] } }, "required": [ "expected_content_blob_id", "expected_content_item_seq" ], "additionalProperties": false }, "synckhub_core_postgres.service.file_ocr.FileOcrStatus": { "title": "FileOcrStatus", "type": "object", "properties": { "content_blob_id": { "type": "string" }, "content_item_seq": { "type": "integer" }, "request_revision": { "anyOf": [ { "type": "integer" }, { "type": "null" } ] }, "status": { "type": "string" }, "classification": { "anyOf": [ { "type": "string" }, { "type": "null" } ] }, "reason": { "anyOf": [ { "type": "string" }, { "type": "null" } ] }, "available": { "type": "boolean" }, "published_revision": { "anyOf": [ { "type": "integer" }, { "type": "null" } ] }, "published_converter": { "anyOf": [ { "type": "string" }, { "type": "null" } ] }, "can_request": { "type": "boolean" } }, "required": [ "content_blob_id", "content_item_seq", "status", "available", "can_request" ] }, "synckhub_server.routes.files.versions.AppendFileContentFromItemRequest": { "title": "AppendFileContentFromItemRequest", "type": "object", "properties": { "source_item_id": { "type": "string" }, "source_item_seq": { "anyOf": [ { "type": "integer" }, { "type": "null" } ] }, "expected_source_head_item_seq": { "anyOf": [ { "type": "integer" }, { "type": "null" } ] }, "expected_target_head_item_seq": { "anyOf": [ { "type": "integer" }, { "type": "null" } ] }, "request_id": { "anyOf": [ { "type": "string" }, { "type": "null" } ] } }, "required": [ "source_item_id" ], "additionalProperties": false }, "synckhub_server.routes.files.versions.AppendFileContentFromItemResponse": { "title": "AppendFileContentFromItemResponse", "type": "object", "properties": { "repo_id": { "type": "string" }, "item_id": { "type": "string" }, "source_item_id": { "type": "string" }, "source_item_seq": { "type": "integer" }, "blob_id": { "type": "string" }, "commit_id": { "anyOf": [ { "type": "string" }, { "type": "null" } ] }, "item_seq": { "type": "integer" } }, "required": [ "repo_id", "item_id", "source_item_id", "source_item_seq", "blob_id", "item_seq" ], "additionalProperties": false }, "synckhub_server.routes.files.versions.UnsuppressFileContentRevisionRequest": { "title": "UnsuppressFileContentRevisionRequest", "type": "object", "properties": { "reason": { "anyOf": [ { "type": "string" }, { "type": "null" } ] }, "operation_id": { "anyOf": [ { "type": "string" }, { "type": "null" } ] } }, "additionalProperties": false }, "synckhub_core.types.UnsuppressFileRevisionResult": { "title": "UnsuppressFileRevisionResult", "type": "object", "properties": { "repo_id": { "type": "string" }, "item_id": { "type": "string" }, "unsuppressed_item_seq": { "type": "integer" }, "unsuppression_item_seq": { "type": "integer" }, "commit_id": { "type": "string" }, "commit_event_idx": { "type": "integer" } }, "required": [ "repo_id", "item_id", "unsuppressed_item_seq", "unsuppression_item_seq", "commit_id", "commit_event_idx" ] }, "synckhub_server.routes.files.versions.SuppressFileContentRevisionRequest": { "title": "SuppressFileContentRevisionRequest", "type": "object", "properties": { "replacement_source_item_seq": { "anyOf": [ { "type": "integer" }, { "type": "null" } ] }, "reason": { "anyOf": [ { "type": "string" }, { "type": "null" } ] }, "operation_id": { "anyOf": [ { "type": "string" }, { "type": "null" } ] } }, "additionalProperties": false }, "synckhub_core.types.SuppressFileRevisionResult": { "title": "SuppressFileRevisionResult", "type": "object", "properties": { "repo_id": { "type": "string" }, "item_id": { "type": "string" }, "suppressed_item_seq": { "type": "integer" }, "suppression_item_seq": { "type": "integer" }, "commit_id": { "type": "string" }, "commit_event_idx": { "type": "integer" }, "replacement_head": { "anyOf": [ { "$ref": "#/components/schemas/synckhub_core.types.FileContentHeadSummary" }, { "type": "null" } ] }, "tombstoned_version_ids": { "type": "array", "items": { "type": "string" } } }, "required": [ "repo_id", "item_id", "suppressed_item_seq", "suppression_item_seq", "commit_id", "commit_event_idx" ] }, "synckhub_server.routes.files.versions.RestoreFileContentRevisionRequest": { "title": "RestoreFileContentRevisionRequest", "type": "object", "properties": { "expected_head_item_seq": { "anyOf": [ { "type": "integer" }, { "type": "null" } ] } }, "additionalProperties": false }, "synckhub_server.routes.files.versions.RestoreFileContentRevisionResponse": { "title": "RestoreFileContentRevisionResponse", "type": "object", "properties": { "restored_from_item_seq": { "type": "integer" }, "head": { "$ref": "#/components/schemas/synckhub_core.types.FileContentHeadSummary" } }, "required": [ "restored_from_item_seq", "head" ], "additionalProperties": false }, "synckhub_server.routes.files.versions.RestoreFileVersionRequest": { "title": "RestoreFileVersionRequest", "type": "object", "properties": { "expected_head_item_seq": { "anyOf": [ { "type": "integer" }, { "type": "null" } ] } }, "additionalProperties": false }, "synckhub_server.routes.files.versions.RestoreFileVersionResponse": { "title": "RestoreFileVersionResponse", "type": "object", "properties": { "restored_from_file_version_item_seq": { "type": "integer" }, "head": { "$ref": "#/components/schemas/synckhub_core.types.FileContentHeadSummary" } }, "required": [ "restored_from_file_version_item_seq", "head" ], "additionalProperties": false }, "synckhub_server.routes.files.versions.TombstoneFileVersionRequest": { "title": "TombstoneFileVersionRequest", "type": "object", "properties": { "expected_version_set_seq": { "anyOf": [ { "type": "integer" }, { "type": "null" } ] } }, "additionalProperties": false }, "synckhub_core.types.FileVersionWriteSummary": { "title": "FileVersionWriteSummary", "type": "object", "properties": { "repo_id": { "type": "string" }, "item_id": { "type": "string" }, "version_id": { "type": "string" }, "item_seq": { "anyOf": [ { "type": "integer" }, { "type": "null" } ], "description": "Deprecated API compatibility handle; see `FileVersionSummary::item_seq`." }, "legacy_item_seq": { "anyOf": [ { "type": "integer" }, { "type": "null" } ] }, "lifecycle_state": { "type": "string" }, "kind": { "type": "string" }, "label_source": { "type": "string" }, "order_key": { "type": "integer" }, "description": { "anyOf": [ { "type": "string" }, { "type": "null" } ] }, "comment": { "anyOf": [ { "type": "string" }, { "type": "null" } ] }, "blob_id": { "type": "string" }, "size": { "anyOf": [ { "type": "integer" }, { "type": "null" } ] }, "source_item_seq": { "anyOf": [ { "type": "integer" }, { "type": "null" } ] }, "source_commit_id": { "anyOf": [ { "type": "string" }, { "type": "null" } ] }, "source_commit_event_idx": { "anyOf": [ { "type": "integer" }, { "type": "null" } ] }, "version_set_seq": { "anyOf": [ { "type": "integer" }, { "type": "null" } ] }, "commit_id": { "anyOf": [ { "type": "string" }, { "type": "null" } ], "description": "Local Synck VCS commit id when the write has already materialized as a\nlocal commit. Federated authority-accept responses may omit this." }, "commit_event_idx": { "anyOf": [ { "type": "integer" }, { "type": "null" } ], "description": "Event index within `commit_id` when locally materialized." } }, "required": [ "repo_id", "item_id", "version_id", "lifecycle_state", "kind", "label_source", "order_key", "blob_id" ], "description": "Write-time summary for file-version mutations.\n\nThis is intentionally narrower than `FileVersionSummary`: it includes only\nstable identity and non-derived label metadata, so federated authority-accept\nroutes do not have to wait for local projection catch-up." }, "synckhub_server.routes.files.versions.ReplaceFileVersionFromRevisionRequest": { "title": "ReplaceFileVersionFromRevisionRequest", "type": "object", "properties": { "source_item_seq": { "type": "integer" }, "comment": { "anyOf": [ { "anyOf": [ { "type": "string" }, { "type": "null" } ] }, { "type": "null" } ] }, "expected_version_set_seq": { "anyOf": [ { "type": "integer" }, { "type": "null" } ] } }, "required": [ "source_item_seq" ], "additionalProperties": false }, "synckhub_server.routes.files.versions.ReplaceFileVersionFromHeadRequest": { "title": "ReplaceFileVersionFromHeadRequest", "type": "object", "properties": { "expected_head_item_seq": { "anyOf": [ { "type": "integer" }, { "type": "null" } ] }, "comment": { "anyOf": [ { "anyOf": [ { "type": "string" }, { "type": "null" } ] }, { "type": "null" } ] }, "expected_version_set_seq": { "anyOf": [ { "type": "integer" }, { "type": "null" } ] } }, "additionalProperties": false }, "synckhub_server.routes.files.versions.SetFileVersionRequest": { "title": "SetFileVersionRequest", "type": "object", "properties": { "kind": { "anyOf": [ { "type": "string" }, { "type": "null" } ] }, "label_source": { "anyOf": [ { "type": "string" }, { "type": "null" } ] }, "comment": { "anyOf": [ { "anyOf": [ { "type": "string" }, { "type": "null" } ] }, { "type": "null" } ] }, "expected_version_set_seq": { "anyOf": [ { "type": "integer" }, { "type": "null" } ] }, "insert_after_item_seq": { "anyOf": [ { "type": "integer" }, { "type": "null" } ] }, "insert_before_item_seq": { "anyOf": [ { "type": "integer" }, { "type": "null" } ] } }, "additionalProperties": false }, "synckhub_server.routes.files.versions.CreateFileVersionFromRevisionRequest": { "title": "CreateFileVersionFromRevisionRequest", "type": "object", "properties": { "source_item_seq": { "type": "integer" }, "kind": { "anyOf": [ { "type": "string" }, { "type": "null" } ] }, "label_source": { "anyOf": [ { "type": "string" }, { "type": "null" } ] }, "comment": { "anyOf": [ { "type": "string" }, { "type": "null" } ] }, "expected_version_set_seq": { "anyOf": [ { "type": "integer" }, { "type": "null" } ] }, "insert_after_item_seq": { "anyOf": [ { "type": "integer" }, { "type": "null" } ] }, "insert_before_item_seq": { "anyOf": [ { "type": "integer" }, { "type": "null" } ] } }, "required": [ "source_item_seq" ], "additionalProperties": false }, "synckhub_server.routes.files.versions.CreateFileVersionFromHeadRequest": { "title": "CreateFileVersionFromHeadRequest", "type": "object", "properties": { "kind": { "anyOf": [ { "type": "string" }, { "type": "null" } ] }, "label_source": { "anyOf": [ { "type": "string" }, { "type": "null" } ] }, "comment": { "anyOf": [ { "type": "string" }, { "type": "null" } ] }, "expected_head_item_seq": { "anyOf": [ { "type": "integer" }, { "type": "null" } ] }, "expected_version_set_seq": { "anyOf": [ { "type": "integer" }, { "type": "null" } ] }, "insert_after_item_seq": { "anyOf": [ { "type": "integer" }, { "type": "null" } ] }, "insert_before_item_seq": { "anyOf": [ { "type": "integer" }, { "type": "null" } ] }, "operation_id": { "anyOf": [ { "type": "string" }, { "type": "null" } ] }, "expected_version_major": { "anyOf": [ { "type": "integer" }, { "type": "null" } ] }, "expected_version_minor": { "anyOf": [ { "type": "integer" }, { "type": "null" } ] } }, "additionalProperties": false }, "synckhub_core.types.FileVersionSummary": { "title": "FileVersionSummary", "type": "object", "properties": { "repo_id": { "type": "string" }, "item_id": { "type": "string" }, "version_id": { "type": "string", "description": "Stable named-version identity." }, "item_seq": { "anyOf": [ { "type": "integer" }, { "type": "null" } ], "description": "Deprecated API compatibility handle.\n\nNew clients must use `version_id` as identity and `version_set_seq` for\noptimistic concurrency. Servers may populate this with the legacy\n`FILE::VERSION::*` item sequence or the sidecar `version_set_seq` so old\nclients keep working. It is not a FILE content revision sequence." }, "legacy_item_seq": { "anyOf": [ { "type": "integer" }, { "type": "null" } ], "description": "Explicit legacy FILE item sequence when applicable." }, "lifecycle_state": { "type": "string" }, "kind": { "type": "string", "description": "Label kind (drives computed numbering)." }, "label_source": { "type": "string", "description": "Product/business source of the named label (`INTERNAL` | `EXTERNAL`)." }, "order_key": { "type": "integer", "description": "Explicit user-controlled ordering key (used for computed label scan order)." }, "version_major": { "anyOf": [ { "type": "integer" }, { "type": "null" } ], "description": "Computed label major number when available.\n\nThis is derived state. For unsequenced writes, projections may lag and the label\ncan be temporarily unavailable." }, "version_minor": { "anyOf": [ { "type": "integer" }, { "type": "null" } ], "description": "Computed label minor number when available.\n\nThis is derived state. For unsequenced writes, projections may lag and the label\ncan be temporarily unavailable." }, "description": { "anyOf": [ { "type": "string" }, { "type": "null" } ] }, "comment": { "anyOf": [ { "type": "string" }, { "type": "null" } ] }, "blob_id": { "type": "string" }, "size": { "anyOf": [ { "type": "integer" }, { "type": "null" } ] }, "source_item_seq": { "anyOf": [ { "type": "integer" }, { "type": "null" } ], "description": "Durable FILE revision this VERSION currently points at, when known." }, "source_commit_id": { "anyOf": [ { "type": "string" }, { "type": "null" } ], "description": "Commit id for `source_item_seq`, when known." }, "source_commit_event_idx": { "anyOf": [ { "type": "integer" }, { "type": "null" } ], "description": "Event index within `source_commit_id`, when known." }, "source_revision_origin": { "anyOf": [ { "type": "string" }, { "type": "null" } ], "description": "Origin of the FILE content revision referenced by `source_item_seq`.\n\nThis is sequencing/source authority (`LOCAL` | `FEDERATED`), not the\nnamed-version label source (`INTERNAL` | `EXTERNAL`)." }, "source_revision_suppression_state": { "anyOf": [ { "type": "string" }, { "type": "null" } ], "description": "Policy state of the FILE content revision referenced by `source_item_seq`.\n\nValues are `AVAILABLE` or `SUPPRESSED`. LIVE labels should not point at\nsuppressed revisions; this field is primarily for tombstoned/history views." }, "source_file_name": { "anyOf": [ { "type": "string" }, { "type": "null" } ], "description": "Effective FILE name of the source content revision, when resolved." }, "source_file_stem": { "anyOf": [ { "type": "string" }, { "type": "null" } ], "description": "Effective FILE stem of the source content revision, when resolved." }, "source_file_extension": { "anyOf": [ { "type": "string" }, { "type": "null" } ], "description": "Effective FILE extension of the source content revision, when resolved." }, "version_set_seq": { "anyOf": [ { "type": "integer" }, { "type": "null" } ] }, "created_repo_seq": { "anyOf": [ { "type": "integer" }, { "type": "null" } ], "description": "Global activity sequence when available; unsequenced commits may return `None`." }, "last_repo_seq": { "anyOf": [ { "type": "integer" }, { "type": "null" } ], "description": "Global activity sequence when available; unsequenced commits may return `None`." }, "last_commit_id": { "type": "string" }, "last_commit_event_idx": { "type": "integer" } }, "required": [ "repo_id", "item_id", "version_id", "lifecycle_state", "kind", "label_source", "order_key", "blob_id", "last_commit_id", "last_commit_event_idx" ], "description": "Summary of a file version label (`platform_file_versions` row)." }, "synckhub_server.routes.integrations.IntegrationOutboxEntry": { "title": "IntegrationOutboxEntry", "type": "object", "properties": { "outbox_id": { "type": "string" }, "item_id": { "anyOf": [ { "type": "string" }, { "type": "null" } ] }, "connector_key": { "type": "string" }, "event_type": { "type": "string" }, "payload": {}, "status": { "type": "string" }, "error_message": { "anyOf": [ { "type": "string" }, { "type": "null" } ] }, "created_at": { "type": "string" }, "created_by": { "type": "string" }, "updated_at": { "type": "string" }, "updated_by": { "type": "string" }, "delivered_at": { "anyOf": [ { "type": "string" }, { "type": "null" } ] } }, "required": [ "outbox_id", "connector_key", "event_type", "payload", "status", "created_at", "created_by", "updated_at", "updated_by" ], "additionalProperties": false }, "synckhub_server.routes.integrations.RepoApiTokenRotateResponse": { "title": "RepoApiTokenRotateResponse", "type": "object", "properties": { "token_id": { "type": "string" }, "token": { "type": "string" } }, "required": [ "token_id", "token" ] }, "synckhub_server.routes.integrations.CreateRepoApiTokenRequest": { "title": "CreateRepoApiTokenRequest", "type": "object", "properties": { "label": { "type": "string" } }, "required": [ "label" ], "additionalProperties": false }, "synckhub_server.routes.integrations.RepoApiTokenCreateResponse": { "title": "RepoApiTokenResponse", "type": "object", "properties": { "token": { "type": "string" }, "token_id": { "type": "string" }, "tenant_id": { "type": "string" }, "repo_id": { "type": "string" }, "label": { "type": "string" }, "principal_id": { "type": "string" }, "repo_role": { "type": "string" }, "status": { "type": "string" }, "created_at": { "type": "string" }, "created_by": { "type": "string" }, "last_used_at": { "anyOf": [ { "type": "string" }, { "type": "null" } ] }, "revoked_at": { "anyOf": [ { "type": "string" }, { "type": "null" } ] }, "revoked_by": { "anyOf": [ { "type": "string" }, { "type": "null" } ] } }, "required": [ "token", "token_id", "tenant_id", "repo_id", "label", "principal_id", "repo_role", "status", "created_at", "created_by" ] }, "synckhub_server.routes.integrations.RepoApiTokenResponse": { "title": "RepoApiTokenResponse", "type": "object", "properties": { "token_id": { "type": "string" }, "tenant_id": { "type": "string" }, "repo_id": { "type": "string" }, "label": { "type": "string" }, "principal_id": { "type": "string" }, "repo_role": { "type": "string" }, "status": { "type": "string" }, "created_at": { "type": "string" }, "created_by": { "type": "string" }, "last_used_at": { "anyOf": [ { "type": "string" }, { "type": "null" } ] }, "revoked_at": { "anyOf": [ { "type": "string" }, { "type": "null" } ] }, "revoked_by": { "anyOf": [ { "type": "string" }, { "type": "null" } ] } }, "required": [ "token_id", "tenant_id", "repo_id", "label", "principal_id", "repo_role", "status", "created_at", "created_by" ] }, "synckhub_server.routes.integrations.ListRepoApiTokensResponse": { "title": "ListRepoApiTokensResponse", "type": "object", "properties": { "tokens": { "type": "array", "items": { "$ref": "#/components/schemas/synckhub_server.routes.integrations.RepoApiTokenResponse" } } }, "required": [ "tokens" ], "additionalProperties": false }, "synckhub_server.routes.integrations.ListIntegrationOutboxResponse": { "title": "ListIntegrationOutboxResponse", "type": "object", "properties": { "entries": { "type": "array", "items": { "$ref": "#/components/schemas/synckhub_server.routes.integrations.IntegrationOutboxEntry" } } }, "required": [ "entries" ], "additionalProperties": false }, "synckhub_server.routes.integrations.PutIntegrationProfileRequest": { "title": "PutIntegrationProfileRequest", "type": "object", "properties": { "enabled": { "type": "boolean" }, "settings": {} }, "required": [ "enabled" ], "additionalProperties": false }, "synckhub_server.routes.integrations.IntegrationProfileResponse": { "title": "IntegrationProfileResponse", "type": "object", "properties": { "connector_key": { "type": "string" }, "enabled": { "type": "boolean" }, "settings": {}, "created_at": { "type": "string" }, "created_by": { "type": "string" }, "updated_at": { "type": "string" }, "updated_by": { "type": "string" } }, "required": [ "connector_key", "enabled", "settings", "created_at", "created_by", "updated_at", "updated_by" ], "additionalProperties": false }, "synckhub_server.routes.integrations.ListIntegrationProfilesResponse": { "title": "ListIntegrationProfilesResponse", "type": "object", "properties": { "profiles": { "type": "array", "items": { "$ref": "#/components/schemas/synckhub_server.routes.integrations.IntegrationProfileResponse" } } }, "required": [ "profiles" ], "additionalProperties": false }, "synckhub_server.routes.items.copy.TemplatesInsertRequest": { "title": "TemplatesInsertRequest", "type": "object", "properties": { "template_item_id": { "anyOf": [ { "type": "string" }, { "type": "null" } ] }, "template_item_ids": { "anyOf": [ { "type": "array", "items": { "type": "string" } }, { "type": "null" } ] }, "parent_folder_id": { "anyOf": [ { "type": "string" }, { "type": "null" } ], "description": "Destination parent folder id:\n- `None`/`\"\"` means root." }, "preserve_permissions": { "type": "boolean", "description": "If true, copy ACLs and item_acl_mode from the template subtree." }, "copy_children_only": { "type": "boolean", "description": "If true, every selected folder is treated as a container and only its\ndirect live children are copied into the destination." }, "source_scope": { "anyOf": [ { "type": "string" }, { "type": "null" } ], "description": "Authoritative source root: `repo` (default) or the caller's `private` templates." } }, "additionalProperties": false }, "synckhub_server.routes.items.copy.TemplatesInsertResponse": { "title": "TemplatesInsertResponse", "type": "object", "properties": { "repo_id": { "type": "string" }, "source_scope": { "type": "string" }, "commit_id": { "anyOf": [ { "type": "string" }, { "type": "null" } ] }, "item": { "anyOf": [ { "$ref": "#/components/schemas/synckhub_core.types.ItemSummary" }, { "type": "null" } ] }, "created": { "type": "array", "items": { "$ref": "#/components/schemas/synckhub_server.routes.items.copy.TemplateCreatedItem" } }, "skipped": { "type": "array", "items": { "$ref": "#/components/schemas/synckhub_server.routes.items.copy.TemplateSkippedItem" } } }, "required": [ "repo_id", "source_scope", "created", "skipped" ], "additionalProperties": false }, "synckhub_server.routes.items.copy.TemplateCreatedItem": { "title": "TemplateCreatedItem", "type": "object", "properties": { "template_item_id": { "type": "string" }, "item": { "$ref": "#/components/schemas/synckhub_core.types.ItemSummary" } }, "required": [ "template_item_id", "item" ], "additionalProperties": false }, "synckhub_server.routes.items.copy.TemplateSkippedItem": { "title": "TemplateSkippedItem", "type": "object", "properties": { "template_item_id": { "type": "string" }, "reason": { "type": "string" }, "covered_by_template_item_id": { "anyOf": [ { "type": "string" }, { "type": "null" } ] } }, "required": [ "template_item_id", "reason" ], "additionalProperties": false }, "synckhub_core.types.ListItemsSort": { "title": "ListItemsSort", "type": "string", "enum": [ "name", "date", "modified", "size", "extension" ] }, "synckhub_core.types.ListItemsOrder": { "title": "ListItemsOrder", "type": "string", "enum": [ "asc", "desc" ] }, "synckhub_server.routes.items.copy.TemplatesListResponse": { "title": "TemplatesListResponse", "type": "object", "properties": { "scope": { "type": "string" }, "templates_folder": { "$ref": "#/components/schemas/synckhub_core.types.ItemSummary" }, "children": { "type": "array", "items": { "$ref": "#/components/schemas/synckhub_core.types.ItemSummary" } } }, "required": [ "scope", "templates_folder", "children" ], "additionalProperties": false }, "synckhub_server.routes.items.copy.CopyEmailRequest": { "title": "CopyEmailRequest", "type": "object", "properties": { "parent_folder_id": { "anyOf": [ { "type": "string" }, { "type": "null" } ] } }, "additionalProperties": false }, "synckhub_server.routes.items.copy.DuplicateItemsRequest": { "title": "DuplicateItemsRequest", "type": "object", "properties": { "parent_folder_id": { "anyOf": [ { "type": "string" }, { "type": "null" } ], "description": "Optional default destination for all items:\n- `None` means \"same parent as source\".\n- `Some(\\\"\\\")` means root." }, "operation_kind": { "anyOf": [ { "type": "string" }, { "type": "null" } ] }, "items": { "type": "array", "items": { "$ref": "#/components/schemas/synckhub_server.routes.items.copy.DuplicateItemSpec" } } }, "required": [ "items" ], "additionalProperties": false }, "synckhub_server.routes.items.copy.DuplicateItemSpec": { "title": "DuplicateItemSpec", "type": "object", "properties": { "item_id": { "type": "string" }, "parent_folder_id": { "anyOf": [ { "type": "string" }, { "type": "null" } ], "description": "Optional destination override for this item (same semantics as `parent_folder_id`)." }, "new_name": { "anyOf": [ { "type": "string" }, { "type": "null" } ], "description": "Optional name override.\n\nIf omitted, defaults to the UX copy naming rules (see server docs)." } }, "required": [ "item_id" ], "additionalProperties": false }, "synckhub_server.routes.items.copy.DuplicateItemsResponse": { "title": "DuplicateItemsResponse", "type": "object", "properties": { "repo_id": { "type": "string" }, "commit_id": { "type": "string" }, "created": { "type": "array", "items": { "$ref": "#/components/schemas/synckhub_server.routes.items.copy.DuplicateCreatedItem" } }, "skipped": { "type": "array", "items": { "$ref": "#/components/schemas/synckhub_server.routes.items.copy.DuplicateSkippedItem" } } }, "required": [ "repo_id", "commit_id", "created", "skipped" ], "additionalProperties": false }, "synckhub_server.routes.items.copy.DuplicateCreatedItem": { "title": "DuplicateCreatedItem", "type": "object", "properties": { "source_item_id": { "type": "string" }, "item": { "$ref": "#/components/schemas/synckhub_core.types.ItemSummary" } }, "required": [ "source_item_id", "item" ], "additionalProperties": false }, "synckhub_server.routes.items.copy.DuplicateSkippedItem": { "title": "DuplicateSkippedItem", "type": "object", "properties": { "source_item_id": { "type": "string" }, "reason": { "type": "string", "description": "Machine-readable skip reason.\n\nCurrently:\n- `covered_by_selected_folder`" }, "covered_by_folder_id": { "anyOf": [ { "type": "string" }, { "type": "null" } ], "description": "If `reason == covered_by_selected_folder`, the folder id that covered it." } }, "required": [ "source_item_id", "reason" ], "additionalProperties": false }, "synckhub_server.routes.items.lifecycle.BatchItemActionRequest": { "title": "BatchItemActionRequest", "type": "object", "properties": { "item_ids": { "type": "array", "items": { "type": "string" } } }, "required": [ "item_ids" ], "additionalProperties": false, "description": "Body for batch item lifecycle actions (trash/restore/tombstone)." }, "synckhub_server.routes.items.lifecycle.RestoreToItemRequest": { "title": "RestoreToItemRequest", "type": "object", "properties": { "parent_folder_id": { "anyOf": [ { "type": "string" }, { "type": "null" } ], "description": "Destination parent folder id. `None` or `\"\"` means root." }, "name": { "anyOf": [ { "type": "string" }, { "type": "null" } ], "description": "Optional new name to use at the destination." }, "force": { "type": "boolean", "description": "Force flag for large subtree moves (same semantics as set-parent)." } }, "additionalProperties": false }, "synckhub_server.routes.items.metadata.BatchSetItemSubtypesRequest": { "title": "BatchSetItemSubtypesRequest", "type": "object", "properties": { "items": { "type": "array", "items": { "$ref": "#/components/schemas/synckhub_server.routes.items.metadata.BatchSetItemSubtypeBody" } } }, "required": [ "items" ], "additionalProperties": false }, "synckhub_server.routes.items.metadata.BatchSetItemSubtypeBody": { "title": "BatchSetItemSubtypeBody", "type": "object", "properties": { "item_id": { "type": "string" }, "item_subtype": { "type": "string" }, "fields": {} }, "required": [ "item_id", "item_subtype", "fields" ], "additionalProperties": false }, "synckhub_server.routes.items.metadata.BatchSetItemMetadataRequest": { "title": "BatchSetItemMetadataRequest", "type": "object", "properties": { "items": { "type": "array", "items": { "$ref": "#/components/schemas/synckhub_server.routes.items.metadata.BatchSetItemMetadataItemBody" } } }, "required": [ "items" ], "additionalProperties": false, "description": "Body for batch SET_METADATA operations." }, "synckhub_server.routes.items.metadata.BatchSetItemMetadataItemBody": { "title": "BatchSetItemMetadataItemBody", "type": "object", "properties": { "item_id": { "type": "string" }, "meta_patch": {} }, "required": [ "item_id", "meta_patch" ] }, "synckhub_server.routes.items.metadata.ItemMetadataSupportedItemTypesResponse": { "title": "ItemMetadataSupportedItemTypesResponse", "type": "object", "properties": { "item_types": { "type": "array", "items": { "type": "string" } } }, "required": [ "item_types" ], "additionalProperties": false }, "synckhub_server.routes.items.metadata.ItemMetadataProjectionRebuildResponse": { "title": "ItemMetadataProjectionRebuildResponse", "type": "object", "properties": { "item_type": { "type": "string" }, "subtype_key": { "type": "string" }, "items_rebuilt": { "type": "integer" } }, "required": [ "item_type", "subtype_key", "items_rebuilt" ], "additionalProperties": false }, "synckhub_server.routes.items.metadata.PutItemSubtypeDefinitionRequest": { "title": "PutItemSubtypeDefinitionRequest", "type": "object", "properties": { "display_name": { "type": "string" }, "fields": {}, "expected_fields": { "anyOf": [ {}, { "type": "null" } ] }, "workflow_default_pipeline_key": { "anyOf": [ { "type": "string" }, { "type": "null" } ] }, "workflow_default_stage_key": { "anyOf": [ { "type": "string" }, { "type": "null" } ] } }, "required": [ "display_name", "fields" ], "additionalProperties": false }, "synckhub_server.routes.items.metadata.ItemSubtypeDefinitionResponse": { "title": "ItemSubtypeDefinitionResponse", "type": "object", "properties": { "item_type": { "type": "string" }, "subtype_key": { "type": "string" }, "display_name": { "type": "string" }, "fields": {}, "workflow_default_pipeline_key": { "anyOf": [ { "type": "string" }, { "type": "null" } ] }, "workflow_default_stage_key": { "anyOf": [ { "type": "string" }, { "type": "null" } ] } }, "required": [ "item_type", "subtype_key", "display_name", "fields" ], "additionalProperties": false }, "synckhub_server.routes.items.metadata.ListItemMetadataDefinitionsResponse": { "title": "ListItemMetadataDefinitionsResponse", "type": "object", "properties": { "item_metadata_definitions": { "type": "array", "items": { "$ref": "#/components/schemas/synckhub_server.routes.items.metadata.ItemSubtypeDefinitionResponse" } } }, "required": [ "item_metadata_definitions" ], "additionalProperties": false }, "synckhub_server.routes.items.metadata.ListCaseMetadataDefinitionsResponse": { "title": "ListCaseMetadataDefinitionsResponse", "type": "object", "properties": { "case_metadata_definitions": { "type": "array", "items": { "$ref": "#/components/schemas/synckhub_server.routes.items.metadata.ItemSubtypeDefinitionResponse" } } }, "required": [ "case_metadata_definitions" ], "additionalProperties": false }, "synckhub_server.routes.items.metadata.PutItemSubtypeRequest": { "title": "PutItemSubtypeRequest", "type": "object", "properties": { "item_subtype": { "type": "string" }, "fields": {}, "expected_latest_revision_item_seq": { "anyOf": [ { "type": "integer" }, { "type": "null" } ] }, "status": { "anyOf": [ { "type": "string" }, { "type": "null" } ] } }, "required": [ "item_subtype", "fields" ], "additionalProperties": false }, "synckhub_server.routes.items.metadata.ItemSubtypeResponse": { "title": "ItemSubtypeResponse", "type": "object", "properties": { "repo_id": { "type": "string" }, "item_id": { "type": "string" }, "item_type": { "type": "string" }, "item_subtype": { "type": "string" }, "fields": {}, "is_case": { "type": "boolean" } }, "required": [ "repo_id", "item_id", "item_type", "item_subtype", "fields", "is_case" ], "additionalProperties": false }, "synckhub_server.routes.items.metadata.PutNotePeopleRequest": { "title": "PutNotePeopleRequest", "type": "object", "properties": { "expected_item_seq": { "type": "integer" }, "people": { "type": "array", "items": { "$ref": "#/components/schemas/synckhub_core.note_people.NotePerson" } }, "yjs_open_token": { "anyOf": [ { "type": "string" }, { "type": "null" } ] } }, "required": [ "expected_item_seq", "people" ], "additionalProperties": false }, "synckhub_core.note_people.NotePerson": { "title": "NotePerson", "type": "object", "properties": { "email": { "type": "string" }, "display_name": { "anyOf": [ { "type": "string" }, { "type": "null" } ] }, "principal_id": { "anyOf": [ { "type": "string" }, { "type": "null" } ] }, "contact_id": { "anyOf": [ { "type": "string" }, { "type": "null" } ] } }, "required": [ "email" ], "additionalProperties": false }, "synckhub_server.routes.items.metadata.NotePeopleResponse": { "title": "NotePeopleResponse", "type": "object", "properties": { "item_seq": { "type": "integer" }, "read_only": { "type": "boolean" }, "changed": { "type": "boolean" }, "people": { "type": "array", "items": { "$ref": "#/components/schemas/synckhub_server.routes.items.metadata.NotePersonResponse" } } }, "required": [ "item_seq", "read_only", "changed", "people" ] }, "synckhub_server.routes.items.metadata.NotePersonResponse": { "title": "NotePersonResponse", "type": "object", "properties": { "email": { "type": "string" }, "display_name": { "anyOf": [ { "type": "string" }, { "type": "null" } ] }, "principal_id": { "anyOf": [ { "type": "string" }, { "type": "null" } ] }, "contact_id": { "anyOf": [ { "type": "string" }, { "type": "null" } ] }, "current_display_name": { "anyOf": [ { "type": "string" }, { "type": "null" } ] }, "current_email": { "anyOf": [ { "type": "string" }, { "type": "null" } ] }, "resolved_principal_id": { "anyOf": [ { "type": "string" }, { "type": "null" } ] }, "resolved_contact_id": { "anyOf": [ { "type": "string" }, { "type": "null" } ] } }, "required": [ "email" ] }, "synckhub_server.routes.items.metadata.SetItemColorMetadataRequest": { "title": "SetItemColorMetadataRequest", "type": "object", "properties": { "color_metadata": { "anyOf": [ { "type": "string" }, { "type": "null" } ] } }, "additionalProperties": false }, "synckhub_server.routes.items.metadata.SetItemMetadataRequest": { "title": "SetItemMetadataRequest", "type": "object", "properties": { "meta_patch": {}, "expected_latest_revision_item_seq": { "anyOf": [ { "type": "integer" }, { "type": "null" } ] } }, "required": [ "meta_patch" ], "additionalProperties": false, "description": "Body for a SET_METADATA operation." }, "synckhub_core.types.ItemEventEntry": { "title": "ItemEventEntry", "type": "object", "properties": { "current_breadcrumbs": { "anyOf": [ { "type": "array", "items": { "$ref": "#/components/schemas/synckhub_core.types.BreadcrumbEntry" } }, { "type": "null" } ], "description": "Current live location, root to leaf; independent of the event's placement." }, "repo_id": { "type": "string" }, "item_id": { "type": "string" }, "item_type": { "type": "string", "description": "Normalized type of the presentation target identified by `item_id`." }, "item_name": { "anyOf": [ { "type": "string" }, { "type": "null" } ] }, "item_name_before": { "anyOf": [ { "type": "string" }, { "type": "null" } ] }, "item_seq": { "type": "integer" }, "repo_seq": { "type": "integer" }, "commit_id": { "type": "string" }, "commit_event_idx": { "type": "integer" }, "event_type": { "type": "string" }, "activity_label": { "anyOf": [ { "type": "string" }, { "type": "null" } ], "description": "Optional presentation label for a semantically specific activity event." }, "payload": {}, "created_at": { "type": "string" }, "occurred_at": { "anyOf": [ { "type": "string" }, { "type": "null" } ] }, "author_id": { "type": "string" }, "committer_id": { "type": "string" }, "parent_folder_id": { "anyOf": [ { "type": "string" }, { "type": "null" } ] }, "parent_folder_name": { "anyOf": [ { "type": "string" }, { "type": "null" } ] }, "parent_folder_redacted": { "type": "boolean" }, "parent_folder_id_before": { "anyOf": [ { "type": "string" }, { "type": "null" } ] }, "parent_folder_name_before": { "anyOf": [ { "type": "string" }, { "type": "null" } ] }, "parent_folder_before_redacted": { "type": "boolean" } }, "required": [ "repo_id", "item_id", "item_type", "item_seq", "repo_seq", "commit_id", "commit_event_idx", "event_type", "payload", "created_at", "author_id", "committer_id" ], "description": "Single item event entry for history/debug UIs.\n\nThis surfaces the durable Synck VCS event log for an item. The `payload`\nvalue is the canonical EventProposal JSON stored in `vcs_events.payload`." }, "synckhub_server.routes.items.read.UpsertWorkspaceShortcutRequest": { "title": "UpsertWorkspaceShortcutRequest", "type": "object", "properties": { "label": { "type": "string" }, "target": { "$ref": "#/components/schemas/synckhub_server.routes.items.read.WorkspaceShortcutTarget" }, "sort_order": { "anyOf": [ { "type": "integer" }, { "type": "null" } ] } }, "required": [ "label", "target" ], "additionalProperties": false }, "synckhub_server.routes.items.read.WorkspaceShortcutTarget": { "title": "WorkspaceShortcutTarget", "oneOf": [ { "type": "object", "properties": { "type": { "const": "workspace_view" }, "view": { "type": "string" } }, "required": [ "type", "view" ], "additionalProperties": false }, { "type": "object", "properties": { "type": { "const": "mailbox" }, "account_id": { "type": "string" }, "mailbox_id": { "type": "string" } }, "required": [ "type", "account_id", "mailbox_id" ], "additionalProperties": false }, { "type": "object", "properties": { "type": { "const": "call_recipient" }, "user_id": { "type": "string" } }, "required": [ "type", "user_id" ], "additionalProperties": false } ] }, "synckhub_server.routes.items.read.WorkspaceShortcut": { "title": "WorkspaceShortcut", "type": "object", "properties": { "shortcut_id": { "type": "string" }, "label": { "type": "string" }, "target": { "$ref": "#/components/schemas/synckhub_server.routes.items.read.WorkspaceShortcutTarget" }, "sort_order": { "type": "integer" }, "created_at": { "type": "string" }, "updated_at": { "type": "string" } }, "required": [ "shortcut_id", "label", "target", "sort_order", "created_at", "updated_at" ], "additionalProperties": false }, "synckhub_server.routes.items.read.WorkspaceShortcutsResponse": { "title": "WorkspaceShortcutsResponse", "type": "object", "properties": { "shortcuts": { "type": "array", "items": { "$ref": "#/components/schemas/synckhub_server.routes.items.read.WorkspaceShortcut" } } }, "required": [ "shortcuts" ], "additionalProperties": false }, "synckhub_server.routes.items.read.ItemNeighborsResponse": { "title": "ItemNeighborsResponse", "type": "object", "properties": { "previous": { "anyOf": [ { "$ref": "#/components/schemas/synckhub_server.routes.items.read.ItemNeighborSummary" }, { "type": "null" } ] }, "next": { "anyOf": [ { "$ref": "#/components/schemas/synckhub_server.routes.items.read.ItemNeighborSummary" }, { "type": "null" } ] } }, "additionalProperties": false }, "synckhub_server.routes.items.read.ItemNeighborSummary": { "title": "ItemNeighborSummary", "type": "object", "properties": { "item_id": { "type": "string" }, "name": { "type": "string" }, "file_extension": { "type": "string" } }, "required": [ "item_id", "name", "file_extension" ], "additionalProperties": false }, "synckhub_server.routes.ListItemsResponse": { "title": "ListItemsResponse", "type": "object", "properties": { "items": { "type": "array", "items": { "$ref": "#/components/schemas/synckhub_core.types.ItemSummary" } }, "next_cursor": { "anyOf": [ { "$ref": "#/components/schemas/synckhub_server.routes.ListItemsCursor" }, { "type": "null" } ] }, "folder_breadcrumbs": { "anyOf": [ { "type": "array", "items": { "$ref": "#/components/schemas/synckhub_core.types.BreadcrumbEntry" } }, { "type": "null" } ] }, "fulltext": { "anyOf": [ { "type": "array", "items": { "$ref": "#/components/schemas/synckhub_server.routes.FulltextFormattedHit" } }, { "type": "null" } ] }, "hits": { "anyOf": [ { "type": "array", "items": { "$ref": "#/components/schemas/synckhub_server.routes.FulltextPassageHit" } }, { "type": "null" } ] }, "hit_counts": { "anyOf": [ { "type": "array", "items": { "$ref": "#/components/schemas/synckhub_server.routes.FulltextItemHitCount" } }, { "type": "null" } ] }, "fulltext_meta": { "anyOf": [ { "$ref": "#/components/schemas/synckhub_server.routes.FulltextSearchMeta" }, { "type": "null" } ] }, "page": { "anyOf": [ { "$ref": "#/components/schemas/synckhub_server.routes.OffsetPaginationMeta" }, { "type": "null" } ] } }, "required": [ "items" ] }, "synckhub_server.routes.ListItemsCursor": { "title": "ListItemsCursor", "type": "object", "properties": { "after_name": { "type": "string" }, "after_item_id": { "type": "string" } }, "required": [ "after_name", "after_item_id" ] }, "synckhub_server.routes.FulltextFormattedHit": { "title": "FulltextFormattedHit", "type": "object", "properties": { "item_id": { "type": "string" }, "formatted": { "anyOf": [ {}, { "type": "null" } ] } }, "required": [ "item_id" ] }, "synckhub_server.routes.FulltextPassageHit": { "title": "FulltextPassageHit", "type": "object", "properties": { "repo_id": { "type": "string" }, "mount_id": { "anyOf": [ { "type": "string" }, { "type": "null" } ] }, "item_id": { "type": "string" }, "doc_id": { "type": "string" }, "content_source": { "type": "string" }, "chunk_idx": { "type": "integer" }, "score": { "anyOf": [ { "type": "number" }, { "type": "null" } ] }, "formatted": { "anyOf": [ {}, { "type": "null" } ] }, "match_positions": { "anyOf": [ {}, { "type": "null" } ] }, "match_count": { "anyOf": [ { "type": "integer" }, { "type": "null" } ] }, "extraction_method": { "anyOf": [ { "type": "string" }, { "type": "null" } ] }, "attachment_filename": { "anyOf": [ { "type": "string" }, { "type": "null" } ] }, "attachment_item_seq": { "anyOf": [ { "type": "integer" }, { "type": "null" } ] } }, "required": [ "repo_id", "item_id", "doc_id", "content_source", "chunk_idx" ] }, "synckhub_server.routes.FulltextItemHitCount": { "title": "FulltextItemHitCount", "type": "object", "properties": { "repo_id": { "type": "string" }, "mount_id": { "anyOf": [ { "type": "string" }, { "type": "null" } ] }, "item_id": { "type": "string" }, "hits_total": { "type": "integer" } }, "required": [ "repo_id", "item_id", "hits_total" ] }, "synckhub_server.routes.FulltextSearchMeta": { "title": "FulltextSearchMeta", "type": "object", "properties": { "estimated_total_passage_hits": { "anyOf": [ { "type": "integer" }, { "type": "null" } ] }, "processing_time_ms": { "anyOf": [ { "type": "integer" }, { "type": "null" } ] } } }, "synckhub_server.routes.OffsetPaginationMeta": { "title": "OffsetPaginationMeta", "type": "object", "properties": { "limit": { "type": "integer", "minimum": 0 }, "offset": { "type": "integer", "minimum": 0 }, "returned": { "type": "integer", "minimum": 0 }, "total_items": { "anyOf": [ { "type": "integer", "minimum": 0 }, { "type": "null" } ] }, "estimated_total_items": { "anyOf": [ { "type": "integer", "minimum": 0 }, { "type": "null" } ] }, "has_prev": { "type": "boolean" }, "has_next": { "type": "boolean" } }, "required": [ "limit", "offset", "returned", "has_prev", "has_next" ] }, "synckhub_server.routes.ListRecentFoldersResponse": { "title": "ListRecentFoldersResponse", "type": "object", "properties": { "items": { "type": "array", "items": { "$ref": "#/components/schemas/synckhub_core.types.RecentFolderSummary" } } }, "required": [ "items" ] }, "synckhub_core.types.RecentFolderSummary": { "title": "ItemSummary", "type": "object", "properties": { "last_saved_at_by_me": { "type": "string", "description": "RFC3339 UTC timestamp derived from the caller’s most recent `FILE::SET_CONTENT`\namong direct-child files of this folder." }, "repo_id": { "type": "string" }, "mount_id": { "anyOf": [ { "type": "string" }, { "type": "null" } ], "description": "Optional mount attribution for items stored in federated-folder mirror repos.\n\nWhen present, this item should be treated as belonging to the mount (`mount_id`) within\nthe calling actor's `repo_id` context." }, "quick_access": { "type": "boolean", "description": "Per-user quick access flag (\"pinned\") in the *request repo* context.\n\nThis is a platform overlay (not Synck VCS history). When no authenticated\nprincipal is present, servers should return `false`." }, "item_id": { "type": "string", "description": "Item identifier in string form (`ItemId`)." }, "item_type": { "type": "string" }, "item_subtype": { "type": "string", "description": "Repo-scoped subtype classification key (`STANDARD` by default)." }, "name": { "type": "string" }, "file_extension": { "anyOf": [ { "type": "string" }, { "type": "null" } ], "description": "Lowercased file extension without leading dot for `FILE` items, if any.\n\nDerived from `name` by the platform; non-FILE items return `null`." }, "file_stem": { "anyOf": [ { "type": "string" }, { "type": "null" } ], "description": "Convenience \"stem\" for `FILE` items (the name without the `.` suffix).\n\nThis exists so UIs can display a file list with separate \"Name\" and \"Extension\" columns\nwithout re-implementing suffix stripping logic in every client.\n\nFor `FILE` items, this is set when `file_extension` is present and `name` ends with\n`.` (ASCII case-insensitive); the suffix is stripped.\nNon-FILE items return `null`." }, "parent_folder_id": { "anyOf": [ { "type": "string" }, { "type": "null" } ], "description": "Parent folder identifier, if any, as an `ItemId` string." }, "path": { "type": "string", "description": "Raw `platform_items.path` `ltree` string (`.`-separated chain of ancestor folder ids,\nfollowed by the item's own id)." }, "breadcrumbs": { "anyOf": [ { "type": "array", "items": { "$ref": "#/components/schemas/synckhub_core.types.BreadcrumbEntry" } }, { "type": "null" } ], "description": "Optional human-friendly breadcrumb chain (ancestor folders + this item).\n\nThis is not included by default; HTTP surfaces can populate it behind an\nexplicit `include=breadcrumbs`/`fields=` knob." }, "lifecycle_state": { "type": "string", "description": "Lifecycle state for this item: `LIVE`, `TRASH`, or `TOMBSTONED`." }, "item_acl_mode": { "anyOf": [ { "type": "string" }, { "type": "null" } ], "description": "Effective item access mode. Omitted only on legacy/internal surfaces that do not project it." }, "size": { "anyOf": [ { "type": "integer" }, { "type": "null" } ], "description": "Optional aggregate size in bytes (primarily for FILE items)." }, "latest_revision_item_seq": { "anyOf": [ { "type": "integer" }, { "type": "null" } ], "description": "Latest per-item event sequence (`vcs_items.head_seq`).\n\nThis is the user-visible item revision number. For FILE rows it can be\nnewer than `head_revision_item_seq` when metadata, name, parent, trash,\nor other non-content events happened after the latest content write." }, "head_revision_item_seq": { "anyOf": [ { "type": "integer" }, { "type": "null" } ], "description": "Current FILE content-head revision sequence (`platform_items.content_item_seq`).\n\nThis is a cheap materialized scalar on the item row. Non-FILE items, and\nFILE rows with no content head yet, return `null`." }, "head_named_version": { "anyOf": [ { "$ref": "#/components/schemas/synckhub_core.types.FileHeadNamedVersionSummary" }, { "type": "null" } ], "description": "LIVE named-version label that currently points at the FILE content head.\n\nThis is not included by default on list responses. HTTP list surfaces may\npopulate it behind `include=head_named_version`." }, "latest_named_version": { "anyOf": [ { "$ref": "#/components/schemas/synckhub_core.types.FileHeadNamedVersionSummary" }, { "type": "null" } ], "description": "Latest LIVE named-version label for the FILE, regardless of whether it points\nat the current FILE content head.\n\nThis is not included by default on list responses. HTTP list surfaces may\npopulate it behind `include=latest_named_version`." }, "color_metadata": { "anyOf": [ { "type": "string" }, { "type": "null" } ], "description": "Durable item color tag derived from top-level `metadata_json.color_metadata`.\n\nValid values are `yellow`, `orange`, `red`, `purple`, `blue`, `green`, or `null`." }, "metadata_json": { "anyOf": [ {}, { "type": "null" } ], "description": "Raw item metadata, returned only on surfaces that explicitly request it." }, "last_updated_at": { "anyOf": [ { "type": "string" }, { "type": "null" } ], "description": "RFC3339 UTC timestamp when this item was last updated." }, "item_date_at": { "anyOf": [ { "type": "string" }, { "type": "null" } ], "description": "RFC3339 UTC timestamp used by Explorer Date ordering.\n\nThis is a rebuildable projection. Rolling-compatible clients fall back to\n`last_updated_at` when an older or synthetic response omits it." }, "item_date_kind": { "anyOf": [ { "type": "string" }, { "type": "null" } ], "description": "Source selected by the item-Date projection." }, "last_updated_by": { "anyOf": [ { "type": "string" }, { "type": "null" } ], "description": "Actor id who last updated the item." }, "core_workflow": { "anyOf": [ { "$ref": "#/components/schemas/synckhub_core.types.ItemSummaryCoreWorkflow" }, { "type": "null" } ], "description": "Canonical workflow projection for folder dashboards/editing." }, "me": { "anyOf": [ { "$ref": "#/components/schemas/synckhub_core.types.ItemSummaryChatMe" }, { "type": "null" } ], "description": "Per-user chat read state for `CHAT` items (present only for authenticated callers)." }, "email_summary": { "anyOf": [ { "$ref": "#/components/schemas/synckhub_core.types.ItemSummaryEmail" }, { "type": "null" } ], "description": "Mail-shaped summary for archived `EMAIL` rows on explicit email-only list surfaces." }, "unread_count": { "anyOf": [ { "type": "integer" }, { "type": "null" } ], "description": "Per-user unread count for `CHAT` items (present only for authenticated callers)." }, "locks": { "type": "array", "items": { "$ref": "#/components/schemas/synckhub_core.types.ItemLockHint" }, "description": "Unexpired locks for this item (for folder browse listings)." }, "federation_stream_id": { "anyOf": [ { "type": "string" }, { "type": "null" } ], "description": "Authority-owned federated stream id for this item, when present." }, "federation_sync": { "anyOf": [ { "$ref": "#/components/schemas/synckhub_core.types.FederationSyncSummary" }, { "type": "null" } ], "description": "Derived federation sync progress for this local replica." }, "federated_placement_failure": { "anyOf": [ { "$ref": "#/components/schemas/synckhub_core.types.FederatedPlacementFailure" }, { "type": "null" } ], "description": "Local-only federated placement failure marker (repo-scoped moves/renames)." } }, "required": [ "last_saved_at_by_me", "repo_id", "item_id", "item_type", "name", "path", "lifecycle_state" ], "description": "A per-user “recent folder” entry: the standard `ItemSummary` plus\nthe caller’s last durable save time for a direct-child file in this folder." }, "synckhub_server.routes.ListRecentFilesResponse": { "title": "ListRecentFilesResponse", "type": "object", "properties": { "items": { "type": "array", "items": { "$ref": "#/components/schemas/synckhub_core.types.RecentFileSummary" } } }, "required": [ "items" ] }, "synckhub_core.types.RecentFileSummary": { "title": "ItemSummary", "type": "object", "properties": { "last_saved_at_by_me": { "type": "string", "description": "RFC3339 UTC timestamp derived from the caller’s most recent `FILE::SET_CONTENT`." }, "repo_id": { "type": "string" }, "mount_id": { "anyOf": [ { "type": "string" }, { "type": "null" } ], "description": "Optional mount attribution for items stored in federated-folder mirror repos.\n\nWhen present, this item should be treated as belonging to the mount (`mount_id`) within\nthe calling actor's `repo_id` context." }, "quick_access": { "type": "boolean", "description": "Per-user quick access flag (\"pinned\") in the *request repo* context.\n\nThis is a platform overlay (not Synck VCS history). When no authenticated\nprincipal is present, servers should return `false`." }, "item_id": { "type": "string", "description": "Item identifier in string form (`ItemId`)." }, "item_type": { "type": "string" }, "item_subtype": { "type": "string", "description": "Repo-scoped subtype classification key (`STANDARD` by default)." }, "name": { "type": "string" }, "file_extension": { "anyOf": [ { "type": "string" }, { "type": "null" } ], "description": "Lowercased file extension without leading dot for `FILE` items, if any.\n\nDerived from `name` by the platform; non-FILE items return `null`." }, "file_stem": { "anyOf": [ { "type": "string" }, { "type": "null" } ], "description": "Convenience \"stem\" for `FILE` items (the name without the `.` suffix).\n\nThis exists so UIs can display a file list with separate \"Name\" and \"Extension\" columns\nwithout re-implementing suffix stripping logic in every client.\n\nFor `FILE` items, this is set when `file_extension` is present and `name` ends with\n`.` (ASCII case-insensitive); the suffix is stripped.\nNon-FILE items return `null`." }, "parent_folder_id": { "anyOf": [ { "type": "string" }, { "type": "null" } ], "description": "Parent folder identifier, if any, as an `ItemId` string." }, "path": { "type": "string", "description": "Raw `platform_items.path` `ltree` string (`.`-separated chain of ancestor folder ids,\nfollowed by the item's own id)." }, "breadcrumbs": { "anyOf": [ { "type": "array", "items": { "$ref": "#/components/schemas/synckhub_core.types.BreadcrumbEntry" } }, { "type": "null" } ], "description": "Optional human-friendly breadcrumb chain (ancestor folders + this item).\n\nThis is not included by default; HTTP surfaces can populate it behind an\nexplicit `include=breadcrumbs`/`fields=` knob." }, "lifecycle_state": { "type": "string", "description": "Lifecycle state for this item: `LIVE`, `TRASH`, or `TOMBSTONED`." }, "item_acl_mode": { "anyOf": [ { "type": "string" }, { "type": "null" } ], "description": "Effective item access mode. Omitted only on legacy/internal surfaces that do not project it." }, "size": { "anyOf": [ { "type": "integer" }, { "type": "null" } ], "description": "Optional aggregate size in bytes (primarily for FILE items)." }, "latest_revision_item_seq": { "anyOf": [ { "type": "integer" }, { "type": "null" } ], "description": "Latest per-item event sequence (`vcs_items.head_seq`).\n\nThis is the user-visible item revision number. For FILE rows it can be\nnewer than `head_revision_item_seq` when metadata, name, parent, trash,\nor other non-content events happened after the latest content write." }, "head_revision_item_seq": { "anyOf": [ { "type": "integer" }, { "type": "null" } ], "description": "Current FILE content-head revision sequence (`platform_items.content_item_seq`).\n\nThis is a cheap materialized scalar on the item row. Non-FILE items, and\nFILE rows with no content head yet, return `null`." }, "head_named_version": { "anyOf": [ { "$ref": "#/components/schemas/synckhub_core.types.FileHeadNamedVersionSummary" }, { "type": "null" } ], "description": "LIVE named-version label that currently points at the FILE content head.\n\nThis is not included by default on list responses. HTTP list surfaces may\npopulate it behind `include=head_named_version`." }, "latest_named_version": { "anyOf": [ { "$ref": "#/components/schemas/synckhub_core.types.FileHeadNamedVersionSummary" }, { "type": "null" } ], "description": "Latest LIVE named-version label for the FILE, regardless of whether it points\nat the current FILE content head.\n\nThis is not included by default on list responses. HTTP list surfaces may\npopulate it behind `include=latest_named_version`." }, "color_metadata": { "anyOf": [ { "type": "string" }, { "type": "null" } ], "description": "Durable item color tag derived from top-level `metadata_json.color_metadata`.\n\nValid values are `yellow`, `orange`, `red`, `purple`, `blue`, `green`, or `null`." }, "metadata_json": { "anyOf": [ {}, { "type": "null" } ], "description": "Raw item metadata, returned only on surfaces that explicitly request it." }, "last_updated_at": { "anyOf": [ { "type": "string" }, { "type": "null" } ], "description": "RFC3339 UTC timestamp when this item was last updated." }, "item_date_at": { "anyOf": [ { "type": "string" }, { "type": "null" } ], "description": "RFC3339 UTC timestamp used by Explorer Date ordering.\n\nThis is a rebuildable projection. Rolling-compatible clients fall back to\n`last_updated_at` when an older or synthetic response omits it." }, "item_date_kind": { "anyOf": [ { "type": "string" }, { "type": "null" } ], "description": "Source selected by the item-Date projection." }, "last_updated_by": { "anyOf": [ { "type": "string" }, { "type": "null" } ], "description": "Actor id who last updated the item." }, "core_workflow": { "anyOf": [ { "$ref": "#/components/schemas/synckhub_core.types.ItemSummaryCoreWorkflow" }, { "type": "null" } ], "description": "Canonical workflow projection for folder dashboards/editing." }, "me": { "anyOf": [ { "$ref": "#/components/schemas/synckhub_core.types.ItemSummaryChatMe" }, { "type": "null" } ], "description": "Per-user chat read state for `CHAT` items (present only for authenticated callers)." }, "email_summary": { "anyOf": [ { "$ref": "#/components/schemas/synckhub_core.types.ItemSummaryEmail" }, { "type": "null" } ], "description": "Mail-shaped summary for archived `EMAIL` rows on explicit email-only list surfaces." }, "unread_count": { "anyOf": [ { "type": "integer" }, { "type": "null" } ], "description": "Per-user unread count for `CHAT` items (present only for authenticated callers)." }, "locks": { "type": "array", "items": { "$ref": "#/components/schemas/synckhub_core.types.ItemLockHint" }, "description": "Unexpired locks for this item (for folder browse listings)." }, "federation_stream_id": { "anyOf": [ { "type": "string" }, { "type": "null" } ], "description": "Authority-owned federated stream id for this item, when present." }, "federation_sync": { "anyOf": [ { "$ref": "#/components/schemas/synckhub_core.types.FederationSyncSummary" }, { "type": "null" } ], "description": "Derived federation sync progress for this local replica." }, "federated_placement_failure": { "anyOf": [ { "$ref": "#/components/schemas/synckhub_core.types.FederatedPlacementFailure" }, { "type": "null" } ], "description": "Local-only federated placement failure marker (repo-scoped moves/renames)." } }, "required": [ "last_saved_at_by_me", "repo_id", "item_id", "item_type", "name", "path", "lifecycle_state" ], "description": "A per-user “recent file” entry: the standard `ItemSummary` plus\nthe caller’s last durable save time for this file." }, "synckhub_server.routes.items.read.FolderStatsResponse": { "title": "FolderStatsResponse", "type": "object", "properties": { "folder_id": { "anyOf": [ { "type": "string" }, { "type": "null" } ], "description": "Echoed input for convenience. `None` means the root folder." }, "contains": { "$ref": "#/components/schemas/synckhub_server.folder_stats.FolderStatsSummary" }, "including_subfolders": { "$ref": "#/components/schemas/synckhub_server.folder_stats.FolderStatsSummary" } }, "required": [ "contains", "including_subfolders" ], "additionalProperties": false }, "synckhub_server.folder_stats.FolderStatsSummary": { "title": "FolderStatsSummary", "type": "object", "properties": { "files": { "type": "integer", "minimum": 0, "description": "Compatibility scalar; always equal to the FILE entry in `item_type_counts`." }, "folders": { "type": "integer", "minimum": 0 }, "items": { "type": "integer", "minimum": 0, "description": "LIVE non-folder tree items of kinds shown by the generic Explorer." }, "size_bytes": { "type": "integer", "minimum": 0, "description": "Sum of current LIVE FILE head sizes. This is not repository storage usage." }, "item_type_counts": { "type": "array", "items": { "$ref": "#/components/schemas/synckhub_server.folder_stats.FolderStatsItemTypeCount" } } }, "required": [ "files", "folders", "items", "size_bytes", "item_type_counts" ], "additionalProperties": false }, "synckhub_server.folder_stats.FolderStatsItemTypeCount": { "title": "FolderStatsItemTypeCount", "type": "object", "properties": { "item_type": { "type": "string" }, "count": { "type": "integer", "minimum": 0 } }, "required": [ "item_type", "count" ], "additionalProperties": false }, "synckhub_server.routes.items.read.UserOverviewResponse": { "title": "UserOverviewResponse", "type": "object", "properties": { "repo_id": { "type": "string" }, "generated_at": { "type": "string" }, "tasks": { "$ref": "#/components/schemas/synckhub_server.routes.items.read.UserOverviewTasksSection" }, "chats": { "$ref": "#/components/schemas/synckhub_server.routes.items.read.UserOverviewChatsSection" }, "files": { "type": "array", "items": { "$ref": "#/components/schemas/synckhub_core.types.ItemSummary" } }, "notes": { "type": "array", "items": { "$ref": "#/components/schemas/synckhub_core.types.ItemSummary" } }, "activity": { "type": "array", "items": { "$ref": "#/components/schemas/synckhub_core.types.ItemEventEntry" } }, "commits_7d": { "$ref": "#/components/schemas/synckhub_server.routes.items.read.UserOverviewCommits7d" }, "mailcal": { "$ref": "#/components/schemas/synckhub_server.routes.items.read.UserOverviewMailcalSection" } }, "required": [ "repo_id", "generated_at", "tasks", "chats", "files", "notes", "activity", "commits_7d", "mailcal" ], "additionalProperties": false }, "synckhub_server.routes.items.read.UserOverviewTasksSection": { "title": "UserOverviewTasksSection", "type": "object", "properties": { "counts": { "$ref": "#/components/schemas/synckhub_server.routes.items.read.UserOverviewTaskCounts" }, "items": { "type": "array", "items": { "$ref": "#/components/schemas/synckhub_server.routes.items.read.UserOverviewTaskEntry" } } }, "required": [ "counts", "items" ], "additionalProperties": false }, "synckhub_server.routes.items.read.UserOverviewTaskCounts": { "title": "UserOverviewTaskCounts", "type": "object", "properties": { "total_assigned": { "type": "integer", "minimum": 0 }, "todo": { "type": "integer", "minimum": 0 }, "in_progress": { "type": "integer", "minimum": 0 }, "blocked": { "type": "integer", "minimum": 0 }, "done": { "type": "integer", "minimum": 0 }, "canceled": { "type": "integer", "minimum": 0 }, "overdue_open": { "type": "integer", "minimum": 0 }, "due_soon_open": { "type": "integer", "minimum": 0 } }, "required": [ "total_assigned", "todo", "in_progress", "blocked", "done", "canceled", "overdue_open", "due_soon_open" ], "additionalProperties": false }, "synckhub_server.routes.items.read.UserOverviewTaskEntry": { "title": "UserOverviewTaskEntry", "type": "object", "properties": { "task_list_item_id": { "type": "string" }, "task_list_name": { "type": "string" }, "task_item_seq": { "type": "integer" }, "subject": { "type": "string" }, "priority": { "type": "string" }, "status": { "type": "string" }, "due_at": { "anyOf": [ { "type": "string" }, { "type": "null" } ] }, "assigned_users": { "type": "array", "items": { "type": "string" } }, "assigned_groups": { "type": "array", "items": { "type": "string" } } }, "required": [ "task_list_item_id", "task_list_name", "task_item_seq", "subject", "priority", "status", "assigned_users", "assigned_groups" ], "additionalProperties": false }, "synckhub_server.routes.items.read.UserOverviewChatsSection": { "title": "UserOverviewChatsSection", "type": "object", "properties": { "unread": { "$ref": "#/components/schemas/synckhub_server.routes.chat.rooms.ChatUnreadSummary" }, "recent_messages": { "type": "array", "items": { "$ref": "#/components/schemas/synckhub_server.routes.items.read.UserOverviewChatMessageEntry" } } }, "required": [ "unread", "recent_messages" ], "additionalProperties": false }, "synckhub_server.routes.items.read.UserOverviewChatMessageEntry": { "title": "UserOverviewChatMessageEntry", "type": "object", "properties": { "chat_item_id": { "type": "string" }, "chat_name": { "type": "string" }, "item_seq": { "type": "integer" }, "sender_id": { "type": "string" }, "sender_label": { "anyOf": [ { "type": "string" }, { "type": "null" } ] }, "body": { "type": "string" }, "created_at": { "type": "string" }, "edited_at": { "anyOf": [ { "type": "string" }, { "type": "null" } ] } }, "required": [ "chat_item_id", "chat_name", "item_seq", "sender_id", "body", "created_at" ], "additionalProperties": false }, "synckhub_server.routes.items.read.UserOverviewCommits7d": { "title": "UserOverviewCommits7d", "type": "object", "properties": { "timezone": { "type": "string" }, "total_commits": { "type": "integer", "minimum": 0 }, "bars": { "type": "array", "items": { "$ref": "#/components/schemas/synckhub_server.routes.items.read.UserOverviewCommits7dBar" } } }, "required": [ "timezone", "total_commits", "bars" ], "additionalProperties": false }, "synckhub_server.routes.items.read.UserOverviewCommits7dBar": { "title": "UserOverviewCommits7dBar", "type": "object", "properties": { "local_date": { "type": "string" }, "commit_count": { "type": "integer", "minimum": 0 } }, "required": [ "local_date", "commit_count" ], "additionalProperties": false }, "synckhub_server.routes.items.read.UserOverviewMailcalSection": { "title": "UserOverviewMailcalSection", "type": "object", "properties": { "enabled": { "type": "boolean" }, "accounts": { "type": "array", "items": { "$ref": "#/components/schemas/synckhub_server.routes.items.read.UserOverviewMailcalAccount" } }, "recent_messages": { "type": "array", "items": { "$ref": "#/components/schemas/synckhub_server.routes.items.read.UserOverviewMailMessageEntry" } }, "upcoming_events": { "type": "array", "items": { "$ref": "#/components/schemas/synckhub_server.routes.items.read.UserOverviewCalendarEventEntry" } }, "errors": { "type": "array", "items": { "$ref": "#/components/schemas/synckhub_server.routes.items.read.UserOverviewMailcalError" } } }, "required": [ "enabled", "accounts", "recent_messages", "upcoming_events", "errors" ], "additionalProperties": false }, "synckhub_server.routes.items.read.UserOverviewMailcalAccount": { "title": "UserOverviewMailcalAccount", "type": "object", "properties": { "account_id": { "type": "string" }, "provider": { "type": "string" }, "email_address": { "type": "string" }, "display_name": { "anyOf": [ { "type": "string" }, { "type": "null" } ] }, "scopes": { "type": "array", "items": { "type": "string" } }, "connected_at": { "type": "string" } }, "required": [ "account_id", "provider", "email_address", "scopes", "connected_at" ], "additionalProperties": false }, "synckhub_server.routes.items.read.UserOverviewMailMessageEntry": { "title": "UserOverviewMailMessageEntry", "type": "object", "properties": { "account_id": { "type": "string" }, "provider": { "type": "string" }, "email_address": { "type": "string" }, "message": { "$ref": "#/components/schemas/synckhub_mailcal.types.MessageSummary" } }, "required": [ "account_id", "provider", "email_address", "message" ], "additionalProperties": false }, "synckhub_mailcal.types.MessageSummary": { "title": "MessageSummary", "type": "object", "properties": { "message_id": { "type": "string" }, "native_message_id": { "anyOf": [ { "type": "string" }, { "type": "null" } ] }, "synckhub_draft_id": { "anyOf": [ { "type": "string" }, { "type": "null" } ] }, "active_draft_id": { "anyOf": [ { "type": "string" }, { "type": "null" } ], "description": "Opaque SynckHub draft identity for the newest editable draft created\nfrom this source message for the requesting principal." }, "active_draft_action": { "anyOf": [ { "$ref": "#/components/schemas/synckhub_mailcal.types.DraftSourceAction" }, { "type": "null" } ], "description": "Action that created `active_draft_id`. Absent for legacy drafts whose\naction was not retained." }, "thread_id": { "anyOf": [ { "type": "string" }, { "type": "null" } ] }, "thread_sibling_state": { "$ref": "#/components/schemas/synckhub_mailcal.types.ThreadSiblingState" }, "mailbox_id": { "anyOf": [ { "type": "string" }, { "type": "null" } ] }, "mailbox_ids": { "type": "array", "items": { "type": "string" } }, "subject": { "anyOf": [ { "type": "string" }, { "type": "null" } ] }, "from": { "anyOf": [ { "$ref": "#/components/schemas/synckhub_mailcal.types.EmailAddress" }, { "type": "null" } ] }, "to": { "anyOf": [ { "type": "array", "items": { "$ref": "#/components/schemas/synckhub_mailcal.types.EmailAddress" } }, { "type": "null" } ] }, "received_at": { "anyOf": [ { "type": "string" }, { "type": "null" } ] }, "is_read": { "anyOf": [ { "type": "boolean" }, { "type": "null" } ] }, "has_attachments": { "anyOf": [ { "type": "boolean" }, { "type": "null" } ] }, "is_draft": { "anyOf": [ { "type": "boolean" }, { "type": "null" } ] }, "has_invite": { "anyOf": [ { "type": "boolean" }, { "type": "null" } ] }, "last_user_action": { "anyOf": [ { "$ref": "#/components/schemas/synckhub_mailcal.types.MessageLastUserAction" }, { "type": "null" } ] }, "importance": { "anyOf": [ { "$ref": "#/components/schemas/synckhub_mailcal.types.MessageImportance" }, { "type": "null" } ] }, "native_snooze": { "anyOf": [ { "$ref": "#/components/schemas/synckhub_mailcal.types.NativeSnooze" }, { "type": "null" } ] }, "native_pin": { "anyOf": [ { "$ref": "#/components/schemas/synckhub_mailcal.types.NativePin" }, { "type": "null" } ] }, "snippet": { "anyOf": [ { "type": "string" }, { "type": "null" } ] } }, "required": [ "message_id" ] }, "synckhub_mailcal.types.DraftSourceAction": { "title": "DraftSourceAction", "type": "string", "enum": [ "REPLY", "REPLY_ALL", "FORWARD" ] }, "synckhub_mailcal.types.ThreadSiblingState": { "title": "ThreadSiblingState", "type": "string", "enum": [ "OBSERVED_SIBLINGS", "UNKNOWN", "NONE" ] }, "synckhub_mailcal.types.MessageLastUserAction": { "title": "MessageLastUserAction", "type": "string", "enum": [ "REPLIED", "REPLIED_ALL", "FORWARDED" ] }, "synckhub_mailcal.types.MessageImportance": { "title": "MessageImportance", "type": "string", "enum": [ "low", "normal", "high" ] }, "synckhub_mailcal.types.NativeSnooze": { "title": "NativeSnooze", "type": "object", "properties": { "version": { "type": "integer" }, "wake_at": { "type": "string" } }, "required": [ "version", "wake_at" ] }, "synckhub_mailcal.types.NativePin": { "title": "NativePin", "type": "object", "properties": { "version": { "type": "integer" }, "pinned_at": { "anyOf": [ { "type": "string" }, { "type": "null" } ] } }, "required": [ "version" ] }, "synckhub_server.routes.items.read.UserOverviewCalendarEventEntry": { "title": "UserOverviewCalendarEventEntry", "type": "object", "properties": { "account_id": { "type": "string" }, "provider": { "type": "string" }, "email_address": { "type": "string" }, "event": { "$ref": "#/components/schemas/synckhub_mailcal.types.CalendarEvent" } }, "required": [ "account_id", "provider", "email_address", "event" ], "additionalProperties": false }, "synckhub_server.routes.items.read.UserOverviewMailcalError": { "title": "UserOverviewMailcalError", "type": "object", "properties": { "account_id": { "anyOf": [ { "type": "string" }, { "type": "null" } ] }, "scope": { "type": "string" }, "message": { "type": "string" } }, "required": [ "scope", "message" ], "additionalProperties": false }, "synckhub_server.routes.items.read.FolderDashboardScope": { "title": "FolderDashboardScope", "type": "string", "enum": [ "recursive", "direct" ] }, "synckhub_server.routes.items.read.FolderDashboardResponse": { "title": "FolderDashboardResponse", "type": "object", "properties": { "folder_id": { "anyOf": [ { "type": "string" }, { "type": "null" } ] }, "source_repo_id": { "type": "string" }, "mount_id": { "anyOf": [ { "type": "string" }, { "type": "null" } ] }, "header": { "$ref": "#/components/schemas/synckhub_server.routes.items.read.FolderDashboardHeader" }, "tasks": { "$ref": "#/components/schemas/synckhub_server.routes.items.read.FolderDashboardTasks" }, "chats": { "$ref": "#/components/schemas/synckhub_server.routes.items.read.FolderDashboardChats" }, "files": { "type": "array", "items": { "$ref": "#/components/schemas/synckhub_server.routes.items.read.FolderDashboardEvidenceDocument" } }, "notes": { "type": "array", "items": { "$ref": "#/components/schemas/synckhub_core.types.ItemSummary" } }, "interactions": { "type": "array", "items": { "$ref": "#/components/schemas/synckhub_server.routes.items.read.FolderDashboardInteraction" } }, "commits_7d": { "$ref": "#/components/schemas/synckhub_server.routes.items.read.FolderDashboardCommits7d" }, "activity": { "type": "array", "items": { "$ref": "#/components/schemas/synckhub_core.types.ItemEventEntry" } } }, "required": [ "source_repo_id", "header", "tasks", "chats", "files", "notes", "interactions", "commits_7d", "activity" ], "additionalProperties": false }, "synckhub_server.routes.items.read.FolderDashboardHeader": { "title": "FolderDashboardHeader", "type": "object", "properties": { "folder": { "anyOf": [ { "$ref": "#/components/schemas/synckhub_core.types.ItemSummary" }, { "type": "null" } ] }, "is_case": { "type": "boolean" }, "core_workflow": { "$ref": "#/components/schemas/synckhub_server.routes.items.read.FolderDashboardCoreWorkflow" }, "core_last_edited_at": { "anyOf": [ { "type": "string" }, { "type": "null" } ] }, "core_last_edited_by": { "anyOf": [ { "type": "string" }, { "type": "null" } ] }, "subtype_fields": {}, "status": { "anyOf": [ { "type": "string" }, { "type": "null" } ] }, "owner": { "anyOf": [ { "type": "string" }, { "type": "null" } ] }, "parties": { "type": "array", "items": { "type": "string" } }, "due_date": { "anyOf": [ { "type": "string" }, { "type": "null" } ] }, "count_24h": { "type": "integer", "minimum": 0 }, "count_7d": { "type": "integer", "minimum": 0 }, "last_activity_at": { "anyOf": [ { "type": "string" }, { "type": "null" } ] }, "last_activity_actor_id": { "anyOf": [ { "type": "string" }, { "type": "null" } ] } }, "required": [ "is_case", "core_workflow", "subtype_fields", "parties", "count_24h", "count_7d" ], "additionalProperties": false }, "synckhub_server.routes.items.read.FolderDashboardCoreWorkflow": { "title": "FolderDashboardCoreWorkflow", "type": "object", "properties": { "pipeline_key": { "anyOf": [ { "type": "string" }, { "type": "null" } ] }, "stage_key": { "anyOf": [ { "type": "string" }, { "type": "null" } ] }, "status": { "anyOf": [ { "type": "string" }, { "type": "null" } ] } }, "additionalProperties": false }, "synckhub_server.routes.items.read.FolderDashboardTasks": { "title": "FolderDashboardTasks", "type": "object", "properties": { "total_tasks": { "type": "integer", "minimum": 0 }, "done_tasks": { "type": "integer", "minimum": 0 }, "in_progress_tasks": { "type": "integer", "minimum": 0 }, "blocked_tasks": { "type": "integer", "minimum": 0 }, "todo_tasks": { "type": "integer", "minimum": 0 }, "canceled_tasks": { "type": "integer", "minimum": 0 }, "open_tasks": { "type": "integer", "minimum": 0 }, "due_soon_tasks_7d": { "type": "integer", "minimum": 0 }, "overdue_tasks": { "type": "integer", "minimum": 0 }, "task_lists": { "type": "array", "items": { "$ref": "#/components/schemas/synckhub_server.routes.items.read.FolderDashboardTaskListProgress" } } }, "required": [ "total_tasks", "done_tasks", "in_progress_tasks", "blocked_tasks", "todo_tasks", "canceled_tasks", "open_tasks", "due_soon_tasks_7d", "overdue_tasks", "task_lists" ], "additionalProperties": false }, "synckhub_server.routes.items.read.FolderDashboardTaskListProgress": { "title": "FolderDashboardTaskListProgress", "type": "object", "properties": { "item_id": { "type": "string" }, "name": { "type": "string" }, "parent_folder_id": { "anyOf": [ { "type": "string" }, { "type": "null" } ] }, "subtasks": { "type": "array", "items": { "$ref": "#/components/schemas/synckhub_server.routes.items.read.FolderDashboardTaskListSubtask" } }, "total_tasks": { "type": "integer", "minimum": 0 }, "done_tasks": { "type": "integer", "minimum": 0 }, "open_tasks": { "type": "integer", "minimum": 0 }, "overdue_tasks": { "type": "integer", "minimum": 0 }, "next_due_at": { "anyOf": [ { "type": "string" }, { "type": "null" } ] } }, "required": [ "item_id", "name", "subtasks", "total_tasks", "done_tasks", "open_tasks", "overdue_tasks" ], "additionalProperties": false }, "synckhub_server.routes.items.read.FolderDashboardTaskListSubtask": { "title": "FolderDashboardTaskListSubtask", "type": "object", "properties": { "item_seq": { "type": "integer" }, "subject": { "type": "string" }, "priority": { "type": "string" }, "status": { "type": "string" }, "due_at": { "anyOf": [ { "type": "string" }, { "type": "null" } ] }, "assigned_users": { "type": "array", "items": { "type": "string" } }, "assigned_groups": { "type": "array", "items": { "type": "string" } } }, "required": [ "item_seq", "subject", "priority", "status", "assigned_users", "assigned_groups" ], "additionalProperties": false }, "synckhub_server.routes.items.read.FolderDashboardChats": { "title": "FolderDashboardChats", "type": "object", "properties": { "unread_total": { "type": "integer", "minimum": 0 }, "chats": { "type": "array", "items": { "$ref": "#/components/schemas/synckhub_server.routes.items.read.FolderDashboardChatSummary" } }, "latest_messages": { "type": "array", "items": { "$ref": "#/components/schemas/synckhub_server.routes.items.read.FolderDashboardLatestMessage" } } }, "required": [ "unread_total", "chats", "latest_messages" ], "additionalProperties": false }, "synckhub_server.routes.items.read.FolderDashboardChatSummary": { "title": "FolderDashboardChatSummary", "type": "object", "properties": { "chat_item_id": { "type": "string" }, "item": { "$ref": "#/components/schemas/synckhub_core.types.ItemSummary" }, "thread": { "$ref": "#/components/schemas/synckhub_server.routes.chat.rooms.ChatThreadAggregates" } }, "required": [ "chat_item_id", "item", "thread" ], "additionalProperties": false }, "synckhub_server.routes.items.read.FolderDashboardLatestMessage": { "title": "FolderDashboardLatestMessage", "type": "object", "properties": { "repo_id": { "type": "string" }, "mount_id": { "anyOf": [ { "type": "string" }, { "type": "null" } ] }, "chat_item_id": { "type": "string" }, "chat_name": { "type": "string" }, "parent_folder_id": { "anyOf": [ { "type": "string" }, { "type": "null" } ] }, "item_seq": { "type": "integer" }, "sender_id": { "type": "string" }, "sender_label": { "anyOf": [ { "type": "string" }, { "type": "null" } ] }, "body": { "type": "string" }, "created_at": { "type": "string" }, "edited_at": { "anyOf": [ { "type": "string" }, { "type": "null" } ] }, "lifecycle_state": { "type": "string" } }, "required": [ "repo_id", "chat_item_id", "chat_name", "item_seq", "sender_id", "body", "created_at", "lifecycle_state" ], "additionalProperties": false }, "synckhub_server.routes.items.read.FolderDashboardEvidenceDocument": { "title": "FolderDashboardEvidenceDocument", "type": "object", "properties": { "item": { "$ref": "#/components/schemas/synckhub_core.types.ItemSummary" }, "subtype_fields": {}, "missing_required_fields": { "type": "array", "items": { "type": "string" } }, "expires_at": { "anyOf": [ { "type": "string" }, { "type": "null" } ] }, "is_expired": { "type": "boolean" }, "is_expiring_soon": { "type": "boolean" } }, "required": [ "item", "subtype_fields", "missing_required_fields", "is_expired", "is_expiring_soon" ], "additionalProperties": false }, "synckhub_server.routes.items.read.FolderDashboardInteraction": { "title": "FolderDashboardInteraction", "type": "object", "properties": { "kind": { "type": "string" }, "occurred_at": { "type": "string" }, "item": { "$ref": "#/components/schemas/synckhub_core.types.ItemSummary" }, "people": { "type": "array", "items": { "$ref": "#/components/schemas/synckhub_server.routes.items.read.FolderDashboardInteractionPerson" } }, "people_truncated": { "type": "boolean" } }, "required": [ "kind", "occurred_at", "item", "people", "people_truncated" ], "additionalProperties": false }, "synckhub_server.routes.items.read.FolderDashboardInteractionPerson": { "title": "FolderDashboardInteractionPerson", "type": "object", "properties": { "email": { "type": "string" }, "display_name": { "anyOf": [ { "type": "string" }, { "type": "null" } ] }, "roles": { "type": "array", "items": { "type": "string" } }, "principal_id": { "anyOf": [ { "type": "string" }, { "type": "null" } ] }, "contact_id": { "anyOf": [ { "type": "string" }, { "type": "null" } ] } }, "required": [ "email", "roles" ], "additionalProperties": false }, "synckhub_server.routes.items.read.FolderDashboardCommits7d": { "title": "FolderDashboardCommits7d", "type": "object", "properties": { "total_commits": { "type": "integer", "minimum": 0 }, "unique_committers": { "type": "integer", "minimum": 0 }, "bars": { "type": "array", "items": { "$ref": "#/components/schemas/synckhub_server.routes.items.read.FolderDashboardCommits7dBar" } } }, "required": [ "total_commits", "unique_committers", "bars" ], "additionalProperties": false }, "synckhub_server.routes.items.read.FolderDashboardCommits7dBar": { "title": "FolderDashboardCommits7dBar", "type": "object", "properties": { "committer_id": { "type": "string" }, "commit_count": { "type": "integer", "minimum": 0 } }, "required": [ "committer_id", "commit_count" ], "additionalProperties": false }, "synckhub_core.types.RepoCommitChangesPage": { "title": "RepoCommitChangesPage", "type": "object", "properties": { "items": { "type": "array", "items": { "$ref": "#/components/schemas/synckhub_core.types.RepoCommitChangeEntry" } }, "total_change_count": { "type": "integer", "minimum": 0 }, "next_after_change_event_idx": { "anyOf": [ { "type": "integer" }, { "type": "null" } ] } }, "required": [ "items", "total_change_count" ] }, "synckhub_core.types.RepoCommitChangeEntry": { "title": "RepoCommitChangeEntry", "type": "object", "properties": { "current_breadcrumbs": { "anyOf": [ { "type": "array", "items": { "$ref": "#/components/schemas/synckhub_core.types.BreadcrumbEntry" } }, { "type": "null" } ], "description": "Current live location, root to leaf; independent of the event's placement." }, "first_commit_event_idx": { "type": "integer" }, "item_id": { "type": "string" }, "item_type": { "type": "string" }, "kind": { "type": "string" }, "item_name": { "anyOf": [ { "type": "string" }, { "type": "null" } ] }, "item_name_before": { "anyOf": [ { "type": "string" }, { "type": "null" } ] }, "parent_folder_id": { "anyOf": [ { "type": "string" }, { "type": "null" } ] }, "parent_folder_name": { "anyOf": [ { "type": "string" }, { "type": "null" } ] }, "parent_folder_id_before": { "anyOf": [ { "type": "string" }, { "type": "null" } ] }, "parent_folder_name_before": { "anyOf": [ { "type": "string" }, { "type": "null" } ] }, "content_changed": { "type": "boolean" }, "event_count": { "type": "integer" }, "event_types": { "type": "array", "items": { "type": "string" } } }, "required": [ "first_commit_event_idx", "item_id", "item_type", "kind", "content_changed", "event_count", "event_types" ] }, "synckhub_core.types.RepoCommitEventsPage": { "title": "RepoCommitEventsPage", "type": "object", "properties": { "items": { "type": "array", "items": { "$ref": "#/components/schemas/synckhub_core.types.ItemEventEntry" } }, "next_after_commit_event_idx": { "anyOf": [ { "type": "integer" }, { "type": "null" } ] } }, "required": [ "items" ] }, "synckhub_core.types.RepoCommitEntry": { "title": "RepoCommitEntry", "type": "object", "properties": { "repo_id": { "type": "string" }, "commit_id": { "type": "string" }, "parent_commit_id": { "anyOf": [ { "type": "string" }, { "type": "null" } ] }, "repo_seq": { "type": "integer" }, "format_version": { "type": "integer" }, "author_id": { "type": "string" }, "committer_id": { "type": "string" }, "message": { "anyOf": [ { "type": "string" }, { "type": "null" } ] }, "occurred_at": { "anyOf": [ { "type": "string" }, { "type": "null" } ] }, "created_at": { "type": "string" }, "event_count": { "type": "integer" }, "total_event_count": { "type": "integer" }, "change_count": { "type": "integer" }, "events_digest": { "type": "string" }, "events": { "type": "array", "items": { "$ref": "#/components/schemas/synckhub_core.types.ItemEventEntry" } }, "events_has_more": { "type": "boolean" } }, "required": [ "repo_id", "commit_id", "repo_seq", "format_version", "author_id", "committer_id", "created_at", "event_count", "total_event_count", "change_count", "events_digest", "events" ] }, "synckhub_server.routes.items.read.ListItemsSubtreeQuery": { "title": "ListItemsSubtreeQuery", "type": "object", "properties": { "folder_id": { "anyOf": [ { "type": "string" }, { "type": "null" } ], "description": "Root folder item id. Use `\"\"` (empty) or omit for the root folder." }, "include_root": { "anyOf": [ { "type": "boolean" }, { "type": "null" } ] }, "limit": { "anyOf": [ { "type": "integer", "minimum": 0 }, { "type": "null" } ] }, "offset": { "anyOf": [ { "type": "integer", "minimum": 0 }, { "type": "null" } ] }, "cursor": { "anyOf": [ { "type": "string" }, { "type": "null" } ] }, "sort": { "anyOf": [ { "$ref": "#/components/schemas/synckhub_server.routes.items.read.ListItemsSubtreeSort" }, { "type": "null" } ] }, "order": { "anyOf": [ { "$ref": "#/components/schemas/synckhub_core.types.ListItemsOrder" }, { "type": "null" } ] }, "folders_first": { "anyOf": [ { "type": "boolean" }, { "type": "null" } ] }, "item_type": { "anyOf": [ { "type": "string" }, { "type": "null" } ], "description": "Optional item type, with FILE extension union semantics matching items/list." }, "file_extension": { "anyOf": [ { "type": "string" }, { "type": "null" } ] }, "file_extension_exclude": { "anyOf": [ { "type": "string" }, { "type": "null" } ], "description": "Optional comma-separated FILE extension exclusions." }, "case_status": { "anyOf": [ { "type": "string" }, { "type": "null" } ], "description": "Optional comma-separated canonical case workflow statuses." }, "include": { "anyOf": [ { "type": "string" }, { "type": "null" } ] } } }, "synckhub_server.routes.items.read.ListItemsSubtreeSort": { "title": "ListItemsSubtreeSort", "type": "string", "enum": [ "name", "date", "modified", "size", "extension", "location" ] }, "synckhub_server.routes.items.read.ListItemsSubtreeResponse": { "title": "ListItemsSubtreeResponse", "type": "object", "properties": { "folder_id": { "anyOf": [ { "type": "string" }, { "type": "null" } ], "description": "Echoed input for convenience. `None` means the root folder." }, "total_items": { "anyOf": [ { "type": "integer", "minimum": 0 }, { "type": "null" } ] }, "items": { "type": "array", "items": { "$ref": "#/components/schemas/synckhub_core.types.ItemSummary" } }, "page": { "anyOf": [ { "$ref": "#/components/schemas/synckhub_server.routes.CursorPaginationMeta" }, { "type": "null" } ] } }, "required": [ "items" ], "additionalProperties": false }, "synckhub_server.routes.items.read.DefaultItemParentResponse": { "title": "DefaultItemParentResponse", "type": "object", "properties": { "repo_id": { "type": "string" }, "surface": { "type": "string" }, "scope": { "type": "string" }, "owner_kind": { "type": "string" }, "owner_principal_id": { "anyOf": [ { "type": "string" }, { "type": "null" } ] }, "folder_key": { "type": "string" }, "folder_item_id": { "type": "string" } }, "required": [ "repo_id", "surface", "scope", "owner_kind", "folder_key", "folder_item_id" ], "additionalProperties": false }, "synckhub_server.routes.items.search.BatchItemMetadataRequest": { "title": "BatchItemMetadataRequest", "type": "object", "properties": { "item_ids": { "type": "array", "items": { "type": "string" } }, "include": { "type": "array", "items": { "type": "string" } } }, "required": [ "item_ids" ], "additionalProperties": false }, "synckhub_core.types.BatchItemMetadataResponse": { "title": "BatchItemMetadataResponse", "type": "object", "properties": { "entries": { "type": "array", "items": { "$ref": "#/components/schemas/synckhub_core.types.BatchItemMetadataEntry" } } }, "required": [ "entries" ], "description": "Response envelope for batch item-metadata lookup." }, "synckhub_core.types.BatchItemMetadataEntry": { "title": "BatchItemMetadataEntry", "type": "object", "properties": { "item_id": { "type": "string" }, "item": { "anyOf": [ { "$ref": "#/components/schemas/synckhub_core.types.ItemSummary" }, { "type": "null" } ] }, "content_head": { "anyOf": [ { "$ref": "#/components/schemas/synckhub_core.types.FileContentHeadSummary" }, { "type": "null" } ] }, "head_named_version": { "anyOf": [ { "$ref": "#/components/schemas/synckhub_core.types.FileHeadNamedVersionSummary" }, { "type": "null" } ] }, "latest_named_version": { "anyOf": [ { "$ref": "#/components/schemas/synckhub_core.types.FileHeadNamedVersionSummary" }, { "type": "null" } ] }, "derived_status": { "anyOf": [ { "$ref": "#/components/schemas/synckhub_core.types.ItemDerivedStatusSummary" }, { "type": "null" } ] } }, "required": [ "item_id" ], "description": "One entry in a batch item-metadata response.\n\n`item` is omitted when the target item does not exist or is not visible to\nthe caller in the current repo context. `content_head` is only populated\nwhen explicitly requested and the caller is allowed to read file content.\n`derived_status` is populated only when explicitly requested and is sourced\nfrom the indexing/derivation ledgers, not from backend output stores." }, "synckhub_core.types.ItemDerivedStatusSummary": { "title": "ItemDerivedStatusSummary", "type": "object", "properties": { "fulltext": { "$ref": "#/components/schemas/synckhub_core.types.DerivedPipelineStatusSummary" }, "markdown": { "$ref": "#/components/schemas/synckhub_core.types.DerivedPipelineStatusSummary" }, "thumbnail": { "$ref": "#/components/schemas/synckhub_core.types.DerivedPipelineStatusSummary" }, "ai_search": { "anyOf": [ { "$ref": "#/components/schemas/synckhub_core.types.DerivedPipelineStatusSummary" }, { "type": "null" } ] } }, "required": [ "fulltext", "markdown", "thumbnail" ], "description": "Per-item derived pipeline status, exposed as an opt-in metadata overlay.\n\nThis is diagnostic/read-model state. It is not core item history." }, "synckhub_core.types.DerivedPipelineStatusSummary": { "title": "DerivedPipelineStatusSummary", "type": "object", "properties": { "pipeline": { "type": "string" }, "status": { "type": "string" }, "current": { "type": "boolean" }, "has_output": { "type": "boolean" }, "output_count": { "anyOf": [ { "type": "integer" }, { "type": "null" } ] }, "desired_repo_seq": { "anyOf": [ { "type": "integer" }, { "type": "null" } ] }, "applied_repo_seq": { "anyOf": [ { "type": "integer" }, { "type": "null" } ] }, "attempts": { "type": "integer" }, "reason": { "anyOf": [ { "type": "string" }, { "type": "null" } ] }, "updated_at": { "anyOf": [ { "type": "string" }, { "type": "null" } ] } }, "required": [ "pipeline", "status", "current", "has_output" ], "description": "Status for one asynchronous derived pipeline." }, "synckhub_server.routes.items.read.RevealFolderPathRequest": { "title": "RevealFolderPathRequest", "type": "object", "properties": { "target_folder_id": { "type": "string" }, "page_size": { "anyOf": [ { "type": "integer", "minimum": 0 }, { "type": "null" } ] } }, "required": [ "target_folder_id" ], "additionalProperties": false }, "synckhub_server.routes.items.read.RevealFolderPathResponse": { "title": "RevealFolderPathResponse", "type": "object", "properties": { "chain": { "type": "array", "items": { "type": "string" } }, "paging_hints": { "type": "array", "items": { "$ref": "#/components/schemas/synckhub_server.routes.items.read.RevealFolderPathPagingHint" } }, "page_size": { "type": "integer", "minimum": 0 } }, "required": [ "chain", "paging_hints", "page_size" ], "additionalProperties": false }, "synckhub_server.routes.items.read.RevealFolderPathPagingHint": { "title": "RevealFolderPathPagingHint", "type": "object", "properties": { "parent_folder_id": { "type": "string" }, "child_folder_id": { "type": "string" }, "after_name": { "anyOf": [ { "type": "string" }, { "type": "null" } ] }, "after_item_id": { "anyOf": [ { "type": "string" }, { "type": "null" } ] } }, "required": [ "parent_folder_id", "child_folder_id" ], "additionalProperties": false }, "synckhub_server.routes.items.read.ListItemsQuery": { "title": "ListItemsQuery", "type": "object", "properties": { "item_type": { "type": "array", "items": { "type": "string" } }, "item_type_exclude": { "type": "array", "items": { "type": "string" } }, "item_subtype": { "type": "array", "items": { "type": "string" } }, "case_status": { "type": "array", "items": { "type": "string" }, "description": "Optional canonical case workflow statuses (`open` or `closed`)." }, "file_extension": { "type": "array", "items": { "type": "string" }, "description": "Optional FILE-branch filter (repeatable; ANY match), e.g. `{ \"file_extension\": [\"pdf\"] }`.\n\nValues are normalized to lowercase ASCII and stored without a leading dot." }, "file_extension_exclude": { "type": "array", "items": { "type": "string" }, "description": "Optional FILE-branch exclusion (ANY match), e.g. `{ \"file_extension_exclude\": [\"eml\"] }`." }, "quick_access": { "anyOf": [ { "type": "boolean" }, { "type": "null" } ] }, "parent_folder_id": { "anyOf": [ { "type": "string" }, { "type": "null" } ], "description": "Optional parent folder filter:\n- `None` means no parent filter (all items in the repo).\n- `Some(id)` means direct children of the given folder id.\n- `Some(\"\")` means root items only (no parent folder)." }, "in_trash": { "anyOf": [ { "type": "boolean" }, { "type": "null" } ] }, "tombstoned": { "anyOf": [ { "type": "boolean" }, { "type": "null" } ] }, "limit": { "anyOf": [ { "type": "integer", "minimum": 0 }, { "type": "null" } ] }, "offset": { "anyOf": [ { "type": "integer", "minimum": 0 }, { "type": "null" } ] }, "sort": { "anyOf": [ { "$ref": "#/components/schemas/synckhub_core.types.ListItemsSort" }, { "type": "null" } ] }, "order": { "anyOf": [ { "$ref": "#/components/schemas/synckhub_core.types.ListItemsOrder" }, { "type": "null" } ] }, "folders_first": { "anyOf": [ { "type": "boolean" }, { "type": "null" } ] }, "after_name": { "anyOf": [ { "type": "string" }, { "type": "null" } ] }, "after_item_id": { "anyOf": [ { "type": "string" }, { "type": "null" } ] }, "include": { "anyOf": [ { "type": "string" }, { "type": "null" } ], "description": "Optional expansions (comma-separated), e.g. `{ \"include\": \"breadcrumbs\" }`." } }, "description": "Filters for listing items via JSON body (`POST /repos/{repo_id}/items/list`)." }, "synckhub_server.routes.items.search.SearchItemsProfileRequest": { "title": "SearchItemsProfileRequest", "type": "object", "properties": { "profile": { "type": "string" }, "name_q": { "anyOf": [ { "type": "string" }, { "type": "null" } ] }, "include": { "anyOf": [ { "type": "string" }, { "type": "null" } ] }, "scope": { "anyOf": [ { "$ref": "#/components/schemas/synckhub_server.routes.items.search.SearchItemsProfileScope" }, { "type": "null" } ] }, "email": { "anyOf": [ { "$ref": "#/components/schemas/synckhub_server.routes.items.search.SearchItemsEmailProfile" }, { "type": "null" } ] }, "sort": { "anyOf": [ { "$ref": "#/components/schemas/synckhub_core.types.ListItemsSort" }, { "type": "null" } ] }, "order": { "anyOf": [ { "$ref": "#/components/schemas/synckhub_core.types.ListItemsOrder" }, { "type": "null" } ] }, "limit": { "anyOf": [ { "type": "integer", "minimum": 0 }, { "type": "null" } ] }, "offset": { "anyOf": [ { "type": "integer", "minimum": 0 }, { "type": "null" } ] } }, "required": [ "profile" ], "additionalProperties": false }, "synckhub_server.routes.items.search.SearchItemsProfileScope": { "title": "SearchItemsProfileScope", "type": "object", "properties": { "parent_folder_id": { "anyOf": [ { "type": "string" }, { "type": "null" } ] }, "recursive": { "anyOf": [ { "type": "boolean" }, { "type": "null" } ] } }, "additionalProperties": false }, "synckhub_server.routes.items.search.SearchItemsEmailProfile": { "title": "SearchItemsEmailProfile", "type": "object", "properties": { "unread": { "type": "boolean" }, "direction": { "anyOf": [ { "type": "string" }, { "type": "null" } ] }, "keywords": { "anyOf": [ { "type": "string" }, { "type": "null" } ] }, "from": { "anyOf": [ { "type": "string" }, { "type": "null" } ] }, "to": { "anyOf": [ { "type": "string" }, { "type": "null" } ] }, "subject": { "anyOf": [ { "type": "string" }, { "type": "null" } ] }, "body": { "anyOf": [ { "type": "string" }, { "type": "null" } ] }, "attachment_name": { "anyOf": [ { "type": "string" }, { "type": "null" } ] }, "attachments": { "anyOf": [ { "type": "string" }, { "type": "null" } ] }, "received_at": { "anyOf": [ { "type": "string" }, { "type": "null" } ] }, "received_at_from": { "anyOf": [ { "type": "string" }, { "type": "null" } ] }, "received_at_to": { "anyOf": [ { "type": "string" }, { "type": "null" } ] }, "sent_at": { "anyOf": [ { "type": "string" }, { "type": "null" } ] }, "sent_at_from": { "anyOf": [ { "type": "string" }, { "type": "null" } ] }, "sent_at_to": { "anyOf": [ { "type": "string" }, { "type": "null" } ] } }, "additionalProperties": false }, "synckhub_server.routes.items.search.SearchItemsStructuredRequest": { "title": "SearchItemsStructuredRequest", "type": "object", "properties": { "scope": { "anyOf": [ { "$ref": "#/components/schemas/synckhub_server.routes.items.search.SearchItemsStructuredScope" }, { "type": "null" } ] }, "item_type": { "anyOf": [ { "type": "string" }, { "type": "null" } ] }, "item_subtype": { "anyOf": [ { "type": "string" }, { "type": "null" } ] }, "name_q": { "anyOf": [ { "type": "string" }, { "type": "null" } ] }, "metadata_filters": { "type": "array", "items": { "$ref": "#/components/schemas/synckhub_server.routes.items.search.SearchItemsStructuredMetadataFilter" } }, "sort": { "type": "array", "items": { "$ref": "#/components/schemas/synckhub_server.routes.items.search.SearchItemsStructuredSort" } }, "include": { "anyOf": [ { "type": "string" }, { "type": "null" } ] }, "in_trash": { "anyOf": [ { "type": "boolean" }, { "type": "null" } ] }, "tombstoned": { "anyOf": [ { "type": "boolean" }, { "type": "null" } ] }, "limit": { "anyOf": [ { "type": "integer", "minimum": 0 }, { "type": "null" } ] }, "offset": { "anyOf": [ { "type": "integer", "minimum": 0 }, { "type": "null" } ] } }, "additionalProperties": false }, "synckhub_server.routes.items.search.SearchItemsStructuredScope": { "title": "SearchItemsStructuredScope", "type": "object", "properties": { "parent_folder_id": { "anyOf": [ { "type": "string" }, { "type": "null" } ] }, "recursive": { "anyOf": [ { "type": "boolean" }, { "type": "null" } ] } }, "additionalProperties": false }, "synckhub_server.routes.items.search.SearchItemsStructuredMetadataFilter": { "title": "SearchItemsStructuredMetadataFilter", "type": "object", "properties": { "item_type": { "type": "string" }, "subtype_key": { "type": "string" }, "field": { "type": "string" }, "op": { "type": "string" }, "value": { "anyOf": [ {}, { "type": "null" } ] }, "values": { "anyOf": [ { "type": "array", "items": {} }, { "type": "null" } ] } }, "required": [ "item_type", "subtype_key", "field", "op" ], "additionalProperties": false }, "synckhub_server.routes.items.search.SearchItemsStructuredSort": { "title": "SearchItemsStructuredSort", "type": "object", "properties": { "kind": { "type": "string" }, "item_type": { "type": "string" }, "subtype_key": { "type": "string" }, "field": { "type": "string" }, "direction": { "type": "string" } }, "required": [ "kind", "item_type", "subtype_key", "field", "direction" ], "additionalProperties": false }, "synckhub_server.routes.items.search.SearchItemsSort": { "title": "SearchItemsSort", "type": "string", "enum": [ "name", "date", "modified", "size", "extension", "location" ] }, "synckhub_server.routes.items.subitems.SubitemActionRequest": { "title": "SubitemActionRequest", "type": "object", "properties": { "subitem_type": { "type": "string" } }, "required": [ "subitem_type" ], "additionalProperties": false }, "synckhub_server.routes.items.subitems.EditSubitemRequest": { "title": "EditSubitemRequest", "type": "object", "properties": { "subitem_type": { "type": "string" }, "parent_item_seq": { "anyOf": [ { "anyOf": [ { "type": "integer" }, { "type": "null" } ] }, { "type": "null" } ] }, "meta": { "anyOf": [ {}, { "type": "null" } ] }, "content": { "anyOf": [ {}, { "type": "null" } ] }, "blob_ref": { "anyOf": [ { "type": "string" }, { "type": "null" } ] } }, "required": [ "subitem_type" ], "additionalProperties": false, "description": "Body for editing a subitem's metadata or content." }, "synckhub_server.routes.items.subitems.AddSubitemRequest": { "title": "AddSubitemRequest", "type": "object", "properties": { "subitem_type": { "type": "string" }, "parent_item_seq": { "anyOf": [ { "type": "integer" }, { "type": "null" } ] }, "meta": {}, "content": {}, "upload_intent_id": { "anyOf": [ { "type": "string" }, { "type": "null" } ] }, "blob_ref": { "anyOf": [ { "type": "string" }, { "type": "null" } ] } }, "required": [ "subitem_type" ], "additionalProperties": false, "description": "Body for adding a subitem." }, "synckhub_server.routes.items.write.BatchItemOperationsRequest": { "title": "BatchItemOperationsRequest", "type": "object", "properties": { "ops": { "type": "array", "items": { "$ref": "#/components/schemas/synckhub_core.types.BatchItemOp" } } }, "required": [ "ops" ], "additionalProperties": false }, "synckhub_core.types.BatchItemOp": { "title": "BatchItemOp", "oneOf": [ { "type": "object", "properties": { "verb": { "const": "SET_NAME" }, "item_id": { "type": "string" }, "name": { "type": "string" }, "meta_patch": { "anyOf": [ {}, { "type": "null" } ] } }, "required": [ "verb", "item_id", "name" ] }, { "type": "object", "properties": { "verb": { "const": "SET_PARENT" }, "item_id": { "type": "string" }, "parent_folder_id": { "anyOf": [ { "type": "string" }, { "type": "null" } ] } }, "required": [ "verb", "item_id" ] }, { "type": "object", "properties": { "verb": { "const": "SET_METADATA" }, "item_id": { "type": "string" }, "meta_patch": {} }, "required": [ "verb", "item_id", "meta_patch" ] }, { "type": "object", "properties": { "verb": { "const": "TRASH" }, "item_id": { "type": "string" } }, "required": [ "verb", "item_id" ] }, { "type": "object", "properties": { "verb": { "const": "RESTORE" }, "item_id": { "type": "string" } }, "required": [ "verb", "item_id" ] }, { "type": "object", "properties": { "verb": { "const": "TOMBSTONE" }, "item_id": { "type": "string" } }, "required": [ "verb", "item_id" ] } ], "description": "Single operation in a mixed batch of item mutations. Each variant maps to\none or more concrete platform verbs and core events." }, "synckhub_server.routes.items.write.BatchSetItemParentsRequest": { "title": "BatchSetItemParentsRequest", "type": "object", "properties": { "items": { "type": "array", "items": { "$ref": "#/components/schemas/synckhub_server.routes.items.write.BatchSetItemParentBody" } }, "force": { "type": "boolean", "description": "Set to true to bypass server-side guardrails for large subtree moves." } }, "required": [ "items" ], "additionalProperties": false, "description": "Body for batch SET_PARENT operations." }, "synckhub_server.routes.items.write.BatchSetItemParentBody": { "title": "BatchSetItemParentBody", "type": "object", "properties": { "item_id": { "type": "string" }, "parent_folder_id": { "anyOf": [ { "type": "string" }, { "type": "null" } ] } }, "required": [ "item_id" ] }, "synckhub_server.routes.authz.MovePreflightResponse": { "title": "MovePreflightResponse", "type": "object", "properties": { "subtree_item_count": { "type": "integer", "minimum": 0 }, "subtree_folder_count": { "type": "integer", "minimum": 0 }, "folder_rule_subject_count": { "type": "integer", "minimum": 0 }, "effective_folder_updates_estimate": { "type": "integer", "minimum": 0 }, "folder_rules_repath_count": { "type": "integer", "minimum": 0 }, "requires_force": { "type": "boolean" } }, "required": [ "subtree_item_count", "subtree_folder_count", "folder_rule_subject_count", "effective_folder_updates_estimate", "folder_rules_repath_count", "requires_force" ], "additionalProperties": false }, "synckhub_server.routes.items.write.SetItemParentRequest": { "title": "SetItemParentRequest", "type": "object", "properties": { "parent_folder_id": { "anyOf": [ { "type": "string" }, { "type": "null" } ], "description": "New parent folder id:\n- null → move to root\n- string → move under that folder" }, "force": { "type": "boolean", "description": "Set to true to bypass server-side guardrails for large subtree moves." } }, "additionalProperties": false }, "synckhub_server.routes.items.write.SetItemContentRequest": { "title": "SetItemContentRequest", "type": "object", "properties": { "content": { "$ref": "#/components/schemas/synck_vcs.types.EventContent" }, "size": { "anyOf": [ { "type": "integer" }, { "type": "null" } ] } }, "required": [ "content" ], "additionalProperties": false, "description": "Body for a SET_CONTENT operation." }, "synckhub_server.routes.items.write.BatchSetItemNamesRequest": { "title": "BatchSetItemNamesRequest", "type": "object", "properties": { "items": { "type": "array", "items": { "$ref": "#/components/schemas/synckhub_server.routes.items.write.BatchSetItemNameBody" } } }, "required": [ "items" ], "additionalProperties": false }, "synckhub_server.routes.items.write.BatchSetItemNameBody": { "title": "BatchSetItemNameBody", "type": "object", "properties": { "item_id": { "type": "string" }, "name": { "type": "string" }, "meta_patch": { "anyOf": [ {}, { "type": "null" } ] } }, "required": [ "item_id", "name" ] }, "synckhub_server.routes.items.write.SetItemNameRequest": { "title": "SetItemNameRequest", "type": "object", "properties": { "name": { "type": "string" }, "meta_patch": { "anyOf": [ {}, { "type": "null" } ] } }, "required": [ "name" ], "additionalProperties": false, "description": "Minimal body for a SET_NAME operation." }, "synckhub_server.routes.items.write.BatchCreateItemsRequest": { "title": "BatchCreateItemsRequest", "type": "object", "properties": { "items": { "type": "array", "items": { "$ref": "#/components/schemas/synckhub_server.routes.items.write.platform.BatchCreateItemBody" } } }, "required": [ "items" ], "additionalProperties": false, "description": "Body for batch create: list of item specs (actor derived from JWT)." }, "synckhub_server.routes.items.write.platform.BatchCreateItemBody": { "title": "BatchCreateItemBody", "type": "object", "properties": { "item_type": { "type": "string" }, "name": { "type": "string" }, "parent_folder_id": { "anyOf": [ { "type": "string" }, { "type": "null" } ] }, "meta": {} }, "required": [ "item_type", "name" ] }, "synckhub_server.routes.items.write.CreateFileRequest": { "title": "CreateFileRequest", "type": "object", "properties": { "name": { "type": "string" }, "parent_folder_id": { "anyOf": [ { "type": "string" }, { "type": "null" } ] }, "item_subtype": { "anyOf": [ { "type": "string" }, { "type": "null" } ] }, "fields": { "anyOf": [ {}, { "type": "null" } ] } }, "required": [ "name" ], "additionalProperties": false, "description": "Body for FILE creation with initial bytes (template or empty)." }, "synckhub_server.routes.items.write.CreateItemRequest": { "title": "CreateItemRequest", "type": "object", "properties": { "item_type": { "type": "string" }, "name": { "type": "string" }, "parent_folder_id": { "anyOf": [ { "type": "string" }, { "type": "null" } ] }, "meta": {} }, "required": [ "item_type", "name" ], "additionalProperties": false, "description": "Body for item creation." }, "synckhub_server.routes.livekit.LivekitCallStatusResponse": { "title": "LivekitCallStatusResponse", "type": "object", "properties": { "provider": { "type": "string" }, "repo_id": { "type": "string" }, "chat_item_id": { "type": "string" }, "call_id": { "type": "string" }, "room_name": { "type": "string" }, "state": { "type": "string" }, "my_participant_state": { "type": "string" }, "created_by": { "type": "string" }, "created_at": { "type": "string" }, "expires_at": { "type": "string" }, "accepted_at": { "anyOf": [ { "type": "string" }, { "type": "null" } ] }, "ended_at": { "anyOf": [ { "type": "string" }, { "type": "null" } ] }, "ended_by": { "anyOf": [ { "type": "string" }, { "type": "null" } ] }, "can_join": { "type": "boolean" } }, "required": [ "provider", "repo_id", "chat_item_id", "call_id", "room_name", "state", "my_participant_state", "created_by", "created_at", "expires_at", "can_join" ], "additionalProperties": false }, "synckhub_server.routes.livekit.JoinLivekitCallRequest": { "title": "JoinLivekitCallRequest", "type": "object", "properties": { "ttl_seconds": { "anyOf": [ { "type": "integer", "minimum": 0 }, { "type": "null" } ] }, "native_answer_device_id": { "anyOf": [ { "type": "string" }, { "type": "null" } ] } }, "additionalProperties": false }, "synckhub_server.rtc_livekit.LivekitJoinTokenResponse": { "title": "LivekitJoinTokenResponse", "type": "object", "properties": { "provider": { "type": "string" }, "url": { "type": "string" }, "room_name": { "type": "string" }, "identity": { "type": "string" }, "token": { "type": "string" }, "expires_at": { "type": "string" }, "can_publish": { "type": "boolean" }, "can_subscribe": { "type": "boolean" }, "repo_id": { "type": "string" }, "chat_item_id": { "type": "string" }, "call_id": { "type": "string" }, "call_state": { "type": "string" }, "my_participant_state": { "type": "string" } }, "required": [ "provider", "url", "room_name", "identity", "token", "expires_at", "can_publish", "can_subscribe", "repo_id", "chat_item_id", "call_id", "call_state", "my_participant_state" ] }, "synckhub_server.routes.livekit.CreateLivekitCallLinkRequest": { "title": "CreateLivekitCallLinkRequest", "type": "object", "properties": { "call_ttl_seconds": { "anyOf": [ { "type": "integer", "minimum": 0 }, { "type": "null" } ] }, "token_ttl_seconds": { "anyOf": [ { "type": "integer", "minimum": 0 }, { "type": "null" } ], "description": "Optional default token TTL hint embedded in the call link." } }, "additionalProperties": false }, "synckhub_server.routes.livekit.CreateLivekitCallLinkResponse": { "title": "CreateLivekitCallLinkResponse", "type": "object", "properties": { "provider": { "type": "string" }, "call_id": { "type": "string" }, "room_name": { "type": "string" }, "state": { "type": "string" }, "my_participant_state": { "type": "string" }, "call_link_token": { "type": "string" }, "call_expires_at": { "type": "string" }, "join_path": { "type": "string" }, "join_url": { "type": "string" } }, "required": [ "provider", "call_id", "room_name", "state", "my_participant_state", "call_link_token", "call_expires_at", "join_path", "join_url" ], "additionalProperties": false }, "synckhub_server.routes.livekit.call_items.Detail": { "title": "Detail", "type": "object", "properties": { "provider": { "type": "string" }, "repo_id": { "type": "string" }, "call_id": { "type": "string" }, "chat_item_id": { "anyOf": [ { "type": "string" }, { "type": "null" } ] }, "version": { "type": "integer" }, "state": { "type": "string" }, "my_participant_state": { "anyOf": [ { "type": "string" }, { "type": "null" } ] }, "created_by": { "type": "string" }, "created_at": { "type": "string" }, "expires_at": { "type": "string" }, "accepted_at": { "anyOf": [ { "type": "string" }, { "type": "null" } ] }, "ended_at": { "anyOf": [ { "type": "string" }, { "type": "null" } ] }, "can_join": { "type": "boolean" }, "can_publish": { "type": "boolean" }, "can_end": { "type": "boolean" } }, "required": [ "provider", "repo_id", "call_id", "version", "state", "created_by", "created_at", "expires_at", "can_join", "can_publish", "can_end" ] }, "synckhub_server.routes.livekit.history.Filter": { "title": "Filter", "type": "string", "enum": [ "all", "missed" ] }, "synckhub_server.routes.livekit.history.HistoryResponse": { "title": "HistoryResponse", "type": "object", "properties": { "items": { "type": "array", "items": { "$ref": "#/components/schemas/synckhub_server.routes.livekit.history.HistoryItem" } }, "next_cursor": { "anyOf": [ { "type": "string" }, { "type": "null" } ] }, "as_of": { "type": "string", "format": "date-time" } }, "required": [ "items", "as_of" ] }, "synckhub_server.routes.livekit.history.HistoryItem": { "title": "HistoryItem", "type": "object", "properties": { "repo_id": { "type": "string", "format": "uuid" }, "chat_item_id": { "type": "string", "format": "uuid" }, "metadata_item_seq": { "anyOf": [ { "type": "integer" }, { "type": "null" } ] }, "call_id": { "type": "string", "format": "uuid" }, "chat_kind": { "type": "string" }, "call_created_at": { "type": "string", "format": "date-time" }, "direction": { "type": "string" }, "outcome": { "type": "string" }, "display": { "$ref": "#/components/schemas/synckhub_server.routes.chat.rooms.ChatDisplaySummary" }, "can_start_call": { "type": "boolean" } }, "required": [ "repo_id", "chat_item_id", "call_id", "chat_kind", "call_created_at", "direction", "outcome", "display", "can_start_call" ] }, "synckhub_server.routes.livekit.recipients.Recipients": { "title": "Recipients", "type": "object", "properties": { "items": { "type": "array", "items": { "$ref": "#/components/schemas/synckhub_server.routes.livekit.recipients.Recipient" } }, "next_cursor": { "anyOf": [ { "type": "string" }, { "type": "null" } ] } }, "required": [ "items" ] }, "synckhub_server.routes.livekit.recipients.Recipient": { "title": "Recipient", "type": "object", "properties": { "user_id": { "type": "string" }, "address": { "type": "string" }, "display_name": { "type": "string" } }, "required": [ "user_id", "address", "display_name" ] }, "synckhub_server.routes.mail.archive.ResolveArchiveNameConflictRequest": { "title": "ResolveArchiveNameConflictRequest", "type": "object", "properties": { "resolution": { "type": "string" } }, "required": [ "resolution" ], "additionalProperties": false }, "synckhub_server.routes.mail.archive.ArchiveResponse": { "title": "ArchiveResponse", "type": "object", "properties": { "job_id": { "type": "string" }, "status": { "type": "string" }, "repo_id": { "type": "string" }, "email_item_id": { "anyOf": [ { "type": "string" }, { "type": "null" } ] }, "already_saved": { "type": "boolean" }, "existing_full_email": { "anyOf": [ { "$ref": "#/components/schemas/synckhub_server.routes.mail.routing.ExistingArchivedEmail" }, { "type": "null" } ] }, "provider_action_error": { "anyOf": [ { "type": "string" }, { "type": "null" } ] }, "last_error": { "anyOf": [ { "type": "string" }, { "type": "null" } ] }, "last_error_code": { "anyOf": [ { "type": "string" }, { "type": "null" } ] }, "conflict_name": { "anyOf": [ { "type": "string" }, { "type": "null" } ] } }, "required": [ "job_id", "status", "repo_id", "already_saved" ], "additionalProperties": false }, "synckhub_server.routes.mail.routing.ExistingArchivedEmail": { "title": "ExistingArchivedEmail", "type": "object", "properties": { "email_item_id": { "type": "string" }, "parent_folder_id": { "anyOf": [ { "type": "string" }, { "type": "null" } ] }, "folder_name": { "type": "string" }, "folder_path": { "type": "string" } }, "required": [ "email_item_id", "folder_name", "folder_path" ], "additionalProperties": false }, "synckhub_server.routes.mail.archive.ArchiveRequest": { "title": "ArchiveRequest", "type": "object", "properties": { "repo_id": { "type": "string" }, "parent_folder_id": { "anyOf": [ { "type": "string" }, { "type": "null" } ] }, "name": { "anyOf": [ { "type": "string" }, { "type": "null" } ] }, "command_id": { "anyOf": [ { "type": "string", "format": "uuid" }, { "type": "null" } ] }, "name_conflict_policy": { "anyOf": [ { "$ref": "#/components/schemas/synckhub_uploads.intents.UploadNameConflictPolicy" }, { "type": "null" } ] }, "mark_provider_message_read": { "anyOf": [ { "type": "boolean" }, { "type": "null" } ] }, "archive_provider_message": { "anyOf": [ { "type": "boolean" }, { "type": "null" } ] }, "save_attachments_individually": { "type": "boolean" }, "attachment_ids": { "anyOf": [ { "type": "array", "items": { "type": "string" } }, { "type": "null" } ] }, "name_overrides": { "type": "object", "additionalProperties": { "type": "string" } } }, "required": [ "repo_id" ], "additionalProperties": false }, "synckhub_uploads.intents.UploadNameConflictPolicy": { "title": "UploadNameConflictPolicy", "type": "string", "enum": [ "REJECT", "KEEP_BOTH" ] }, "synckhub_server.routes.mail.archive.SaveArchivedAttachmentToExistingFileRequest": { "title": "SaveArchivedAttachmentToExistingFileRequest", "type": "object", "properties": { "target_file_item_id": { "type": "string" }, "attachment_id": { "type": "string" } }, "required": [ "target_file_item_id", "attachment_id" ], "additionalProperties": false }, "synckhub_server.routes.mail.archive.SaveArchivedAttachmentToExistingFileResponse": { "title": "SaveArchivedAttachmentToExistingFileResponse", "type": "object", "properties": { "repo_id": { "type": "string" }, "attachment_id": { "type": "string" }, "target_file_item_id": { "type": "string" }, "content_item_seq": { "type": "integer" }, "named_version_item_seq": { "anyOf": [ { "type": "integer" }, { "type": "null" } ] } }, "required": [ "repo_id", "attachment_id", "target_file_item_id", "content_item_seq" ], "additionalProperties": false }, "synckhub_server.routes.mail.archive.SaveArchivedAttachmentsRequest": { "title": "SaveArchivedAttachmentsRequest", "type": "object", "properties": { "parent_folder_id": { "anyOf": [ { "type": "string" }, { "type": "null" } ] }, "attachment_ids": { "type": "array", "items": { "type": "string" } }, "name_overrides": { "type": "object", "additionalProperties": { "type": "string" } }, "item_subtype": { "anyOf": [ { "type": "string" }, { "type": "null" } ] }, "fields": { "anyOf": [ {}, { "type": "null" } ] }, "name_conflict_policy": { "anyOf": [ { "$ref": "#/components/schemas/synckhub_uploads.intents.UploadNameConflictPolicy" }, { "type": "null" } ] } }, "required": [ "attachment_ids" ], "additionalProperties": false }, "synckhub_server.routes.mail.archive.SaveArchivedAttachmentsResponse": { "title": "SaveArchivedAttachmentsResponse", "type": "object", "properties": { "repo_id": { "type": "string" }, "parent_folder_id": { "anyOf": [ { "type": "string" }, { "type": "null" } ] }, "files": { "type": "array", "items": { "$ref": "#/components/schemas/synckhub_server.routes.mail.archive.SavedArchivedAttachmentFile" } } }, "required": [ "repo_id", "files" ], "additionalProperties": false }, "synckhub_server.routes.mail.archive.SavedArchivedAttachmentFile": { "title": "SavedArchivedAttachmentFile", "type": "object", "properties": { "attachment_id": { "type": "string" }, "file_item_id": { "type": "string" } }, "required": [ "attachment_id", "file_item_id" ], "additionalProperties": false }, "synckhub_server.routes.mail.archive.ListArchivedEmailAttachmentsResponse": { "title": "ListArchivedEmailAttachmentsResponse", "type": "object", "properties": { "items": { "type": "array", "items": { "$ref": "#/components/schemas/synckhub_mailcal.types.AttachmentSummary" } }, "next_after_item_seq": { "anyOf": [ { "type": "integer" }, { "type": "null" } ] } }, "required": [ "items" ] }, "synckhub_mailcal.types.AttachmentSummary": { "title": "AttachmentSummary", "type": "object", "properties": { "provider_version": { "anyOf": [ { "type": "string" }, { "type": "null" } ], "description": "Provider message revision whose attachment metadata was observed." }, "attachment_id": { "type": "string" }, "filename": { "anyOf": [ { "type": "string" }, { "type": "null" } ] }, "mime_type": { "anyOf": [ { "type": "string" }, { "type": "null" } ] }, "size_bytes": { "anyOf": [ { "type": "integer" }, { "type": "null" } ] }, "content_hash": { "anyOf": [ { "type": "string" }, { "type": "null" } ], "description": "SHA-256 of the exact decoded bytes, when computed by SynckHub." } }, "required": [ "attachment_id" ] }, "synckhub_server.routes.mail.archive.ArchivedEmailDetailResponse": { "title": "ArchivedEmailDetailResponse", "type": "object", "properties": { "email_item_id": { "type": "string" }, "native_message_id": { "anyOf": [ { "type": "string", "format": "uuid" }, { "type": "null" } ] }, "detail": { "$ref": "#/components/schemas/synckhub_server.routes.mail.archive.ArchivedEmailMessageDetail" }, "archived_location": { "$ref": "#/components/schemas/synckhub_server.routes.mail.routing.ExistingArchivedEmail" } }, "required": [ "email_item_id", "detail", "archived_location" ], "additionalProperties": false }, "synckhub_server.routes.mail.archive.ArchivedEmailMessageDetail": { "title": "ArchivedEmailMessageDetail", "type": "object", "properties": { "in_reply_to": { "anyOf": [ { "type": "string" }, { "type": "null" } ] }, "references": { "type": "array", "items": { "type": "string" } }, "message_id": { "type": "string" }, "thread_id": { "anyOf": [ { "type": "string" }, { "type": "null" } ] }, "internet_message_id": { "anyOf": [ { "type": "string" }, { "type": "null" } ] }, "subject": { "anyOf": [ { "type": "string" }, { "type": "null" } ] }, "from": { "anyOf": [ { "$ref": "#/components/schemas/synckhub_server.routes.mail.archive.ArchivedEmailAddress" }, { "type": "null" } ] }, "sender": { "anyOf": [ { "$ref": "#/components/schemas/synckhub_server.routes.mail.archive.ArchivedEmailAddress" }, { "type": "null" } ] }, "to": { "type": "array", "items": { "$ref": "#/components/schemas/synckhub_server.routes.mail.archive.ArchivedEmailAddress" } }, "cc": { "type": "array", "items": { "$ref": "#/components/schemas/synckhub_server.routes.mail.archive.ArchivedEmailAddress" } }, "bcc": { "type": "array", "items": { "$ref": "#/components/schemas/synckhub_server.routes.mail.archive.ArchivedEmailAddress" } }, "reply_to": { "type": "array", "items": { "$ref": "#/components/schemas/synckhub_server.routes.mail.archive.ArchivedEmailAddress" } }, "sent_at": { "anyOf": [ { "type": "string" }, { "type": "null" } ] }, "received_at": { "anyOf": [ { "type": "string" }, { "type": "null" } ] }, "is_read": { "anyOf": [ { "type": "boolean" }, { "type": "null" } ] }, "is_draft": { "anyOf": [ { "type": "boolean" }, { "type": "null" } ] }, "importance": { "anyOf": [ { "$ref": "#/components/schemas/synckhub_mailcal.types.MessageImportance" }, { "type": "null" } ] }, "invite_ical_uid": { "anyOf": [ { "type": "string" }, { "type": "null" } ] }, "invite_recurrence_id": { "anyOf": [ { "type": "string" }, { "type": "null" } ] }, "provider_event_id": { "anyOf": [ { "type": "string" }, { "type": "null" } ] }, "native_calendar_message": { "anyOf": [ { "$ref": "#/components/schemas/synckhub_server.routes.mail.archive.NativeCalendarMessage" }, { "type": "null" } ] }, "body": { "$ref": "#/components/schemas/synckhub_server.routes.mail.archive.ArchivedEmailBody" }, "attachments": { "type": "array", "items": { "$ref": "#/components/schemas/synckhub_mailcal.types.AttachmentSummary" } }, "attachments_next_after_item_seq": { "anyOf": [ { "type": "integer" }, { "type": "null" } ] }, "inline_images": { "type": "array", "items": { "$ref": "#/components/schemas/synckhub_mailcal.types.InlineImageSummary" } }, "source": { "anyOf": [ { "$ref": "#/components/schemas/synckhub_server.routes.mail.archive.ArchivedEmailSourceDetail" }, { "type": "null" } ] } }, "required": [ "references", "message_id", "body" ] }, "synckhub_server.routes.mail.archive.ArchivedEmailAddress": { "title": "ArchivedEmailAddress", "type": "object", "properties": { "email": { "anyOf": [ { "type": "string" }, { "type": "null" } ] }, "name": { "anyOf": [ { "type": "string" }, { "type": "null" } ] } } }, "synckhub_server.routes.mail.archive.NativeCalendarMessage": { "title": "NativeCalendarMessage", "type": "object", "properties": { "repo_id": { "type": "string", "format": "uuid" }, "event_item_id": { "type": "string", "format": "uuid" }, "occurrence_start": { "anyOf": [ { "type": "string", "format": "date-time" }, { "type": "null" } ] }, "kind": { "$ref": "#/components/schemas/synckhub_server.routes.mail.archive.NativeCalendarMessageKind" } }, "required": [ "repo_id", "event_item_id", "kind" ] }, "synckhub_server.routes.mail.archive.NativeCalendarMessageKind": { "title": "NativeCalendarMessageKind", "type": "string", "enum": [ "INVITATION", "UPDATE", "CANCELLATION", "REMOVAL" ] }, "synckhub_server.routes.mail.archive.ArchivedEmailBody": { "title": "ArchivedEmailBody", "type": "object", "properties": { "kind": { "$ref": "#/components/schemas/synckhub_mailcal.types.BodyKind" }, "content": { "type": "string" }, "truncated": { "type": "boolean" } }, "required": [ "kind", "content", "truncated" ] }, "synckhub_mailcal.types.InlineImageSummary": { "title": "InlineImageSummary", "type": "object", "properties": { "inline_image_id": { "type": "string" }, "content_id": { "type": "string" }, "requires_external_resource_consent": { "type": "boolean" }, "filename": { "anyOf": [ { "type": "string" }, { "type": "null" } ] }, "mime_type": { "anyOf": [ { "type": "string" }, { "type": "null" } ] }, "size_bytes": { "anyOf": [ { "type": "integer" }, { "type": "null" } ] }, "content_hash": { "anyOf": [ { "type": "string" }, { "type": "null" } ], "description": "SHA-256 of the exact decoded bytes, when computed by SynckHub." } }, "required": [ "inline_image_id", "content_id" ] }, "synckhub_server.routes.mail.archive.ArchivedEmailSourceDetail": { "title": "ArchivedEmailSourceDetail", "type": "object", "properties": { "origin": { "type": "string" }, "format": { "type": "string" }, "filename": { "type": "string" }, "mime_type": { "type": "string" }, "size_bytes": { "type": "integer" }, "raw_rfc822_provenance": { "type": "string" } }, "required": [ "origin", "format", "filename", "mime_type", "size_bytes", "raw_rfc822_provenance" ] }, "synckhub_server.routes.mail.archive.ArchivedEmailDetailRequest": { "title": "ArchivedEmailDetailRequest", "type": "object", "properties": { "email_item_id": { "type": "string" } }, "required": [ "email_item_id" ], "additionalProperties": false }, "synckhub_server.routes.mail.archive.EmailReadState": { "title": "EmailReadState", "type": "object", "properties": { "is_read": { "type": "boolean" } }, "required": [ "is_read" ], "additionalProperties": false }, "synckhub_mailcal.types.ThreadView": { "title": "ThreadView", "type": "object", "properties": { "thread_id": { "type": "string" }, "truncated": { "type": "boolean" }, "returned_count": { "type": "integer", "minimum": 0 }, "next_page_token": { "anyOf": [ { "type": "string" }, { "type": "null" } ] }, "mailboxes": { "type": "array", "items": { "$ref": "#/components/schemas/synckhub_mailcal.types.Mailbox" }, "description": "Best-effort projected metadata for mailbox ids referenced by this page.\nProviders do not need to fetch their mailbox hierarchy to populate it." }, "messages": { "type": "array", "items": { "$ref": "#/components/schemas/synckhub_mailcal.types.MessageSummary" } } }, "required": [ "thread_id", "messages" ] }, "synckhub_mailcal.types.Mailbox": { "title": "Mailbox", "type": "object", "properties": { "mailbox_id": { "type": "string" }, "kind": { "$ref": "#/components/schemas/synckhub_mailcal.types.MailboxKind" }, "role": { "anyOf": [ { "$ref": "#/components/schemas/synckhub_mailcal.types.MailboxRole" }, { "type": "null" } ] }, "name": { "type": "string" }, "well_known_name": { "anyOf": [ { "type": "string" }, { "type": "null" } ] }, "unread_count": { "anyOf": [ { "type": "integer" }, { "type": "null" } ] }, "child_count": { "anyOf": [ { "type": "integer" }, { "type": "null" } ] }, "parent_mailbox_id": { "anyOf": [ { "type": "string" }, { "type": "null" } ] } }, "required": [ "mailbox_id", "kind", "name" ] }, "synckhub_mailcal.types.MailboxKind": { "title": "MailboxKind", "type": "string", "enum": [ "FOLDER", "LABEL" ] }, "synckhub_mailcal.types.MailboxRole": { "title": "MailboxRole", "type": "string", "enum": [ "INBOX", "SENT", "DRAFTS", "TRASH", "SPAM", "ARCHIVE", "OTHER" ] }, "synckhub_server.routes.mail.archive.ListArchivedEmailsResponse": { "title": "ListArchivedEmailsResponse", "type": "object", "properties": { "items": { "type": "array", "items": { "$ref": "#/components/schemas/synckhub_server.routes.mail.archive.ArchivedEmailSummaryEntry" } }, "next_offset": { "anyOf": [ { "type": "integer", "minimum": 0 }, { "type": "null" } ] } }, "required": [ "items" ], "additionalProperties": false }, "synckhub_server.routes.mail.archive.ArchivedEmailSummaryEntry": { "title": "ArchivedEmailSummaryEntry", "type": "object", "properties": { "email_item_id": { "type": "string" }, "native_message_id": { "anyOf": [ { "type": "string", "format": "uuid" }, { "type": "null" } ] }, "message": { "$ref": "#/components/schemas/synckhub_server.routes.mail.archive.ArchivedEmailMessageSummary" } }, "required": [ "email_item_id", "message" ], "additionalProperties": false }, "synckhub_server.routes.mail.archive.ArchivedEmailMessageSummary": { "title": "ArchivedEmailMessageSummary", "type": "object", "properties": { "message_id": { "type": "string" }, "thread_id": { "anyOf": [ { "type": "string" }, { "type": "null" } ] }, "thread_sibling_state": { "$ref": "#/components/schemas/synckhub_mailcal.types.ThreadSiblingState" }, "subject": { "anyOf": [ { "type": "string" }, { "type": "null" } ] }, "from": { "anyOf": [ { "$ref": "#/components/schemas/synckhub_server.routes.mail.archive.ArchivedEmailAddress" }, { "type": "null" } ] }, "received_at": { "anyOf": [ { "type": "string" }, { "type": "null" } ] }, "is_read": { "anyOf": [ { "type": "boolean" }, { "type": "null" } ] }, "has_attachments": { "anyOf": [ { "type": "boolean" }, { "type": "null" } ] }, "is_draft": { "anyOf": [ { "type": "boolean" }, { "type": "null" } ] }, "has_invite": { "anyOf": [ { "type": "boolean" }, { "type": "null" } ] }, "importance": { "anyOf": [ { "$ref": "#/components/schemas/synckhub_mailcal.types.MessageImportance" }, { "type": "null" } ] }, "native_snooze": { "anyOf": [ { "$ref": "#/components/schemas/synckhub_mailcal.types.NativeSnooze" }, { "type": "null" } ] }, "snippet": { "anyOf": [ { "type": "string" }, { "type": "null" } ] } }, "required": [ "message_id", "thread_sibling_state" ] }, "synckhub_server.routes.mail.archive.SimpleItemActionRequest": { "title": "SimpleItemActionRequest", "type": "object", "properties": {}, "additionalProperties": false }, "synckhub_server.routes.mail.archive.ConvertEmailFileResponse": { "title": "ConvertEmailFileResponse", "type": "object", "properties": { "source_file_item_id": { "type": "string" }, "source_content_item_seq": { "type": "integer" }, "target_email_item_id": { "type": "string" }, "commit_id": { "anyOf": [ { "type": "string" }, { "type": "null" } ] }, "reconciled": { "type": "boolean" }, "item": { "$ref": "#/components/schemas/synckhub_core.types.ItemSummary" } }, "required": [ "source_file_item_id", "source_content_item_seq", "target_email_item_id", "reconciled", "item" ] }, "synckhub_server.routes.mail.attachments.SaveAttachmentToExistingFileRequest": { "title": "SaveAttachmentToExistingFileRequest", "type": "object", "properties": { "repo_id": { "type": "string" }, "target_file_item_id": { "type": "string" }, "attachment_id": { "type": "string" }, "create_named_version": { "type": "boolean" } }, "required": [ "repo_id", "target_file_item_id", "attachment_id" ], "additionalProperties": false }, "synckhub_server.routes.mail.attachments.SaveAttachmentToExistingFileResponse": { "title": "SaveAttachmentToExistingFileResponse", "type": "object", "properties": { "repo_id": { "type": "string" }, "attachment_id": { "type": "string" }, "target_file_item_id": { "type": "string" }, "content_item_seq": { "type": "integer" }, "named_version_item_seq": { "anyOf": [ { "type": "integer" }, { "type": "null" } ] } }, "required": [ "repo_id", "attachment_id", "target_file_item_id", "content_item_seq" ], "additionalProperties": false }, "synckhub_server.routes.mail.attachments.ResolveAttachmentSaveNameConflictRequest": { "title": "ResolveAttachmentSaveNameConflictRequest", "type": "object", "properties": { "resolution": { "type": "string" } }, "required": [ "resolution" ], "additionalProperties": false }, "synckhub_server.routes.mail.attachments.AttachmentSaveJobResponse": { "title": "AttachmentSaveJobResponse", "type": "object", "properties": { "job_id": { "type": "string" }, "command_id": { "type": "string" }, "status": { "type": "string" }, "repo_id": { "type": "string" }, "parent_folder_id": { "anyOf": [ { "type": "string" }, { "type": "null" } ] }, "attachment_count": { "type": "integer", "minimum": 0 }, "name_conflict_policy": { "type": "string" }, "last_error_code": { "anyOf": [ { "type": "string" }, { "type": "null" } ] }, "last_error": { "anyOf": [ { "type": "string" }, { "type": "null" } ] }, "conflict_name": { "anyOf": [ { "type": "string" }, { "type": "null" } ] }, "can_append": { "type": "boolean" } }, "required": [ "job_id", "command_id", "status", "repo_id", "attachment_count", "name_conflict_policy", "can_append" ], "additionalProperties": false }, "synckhub_server.routes.mail.attachments.EnqueueAttachmentSaveJobRequest": { "title": "EnqueueAttachmentSaveJobRequest", "type": "object", "properties": { "command_id": { "type": "string", "format": "uuid" }, "repo_id": { "type": "string" }, "parent_folder_id": { "anyOf": [ { "type": "string" }, { "type": "null" } ] }, "attachment_ids": { "type": "array", "items": { "type": "string" } }, "name_overrides": { "type": "object", "additionalProperties": { "type": "string" } }, "item_subtype": { "anyOf": [ { "type": "string" }, { "type": "null" } ] }, "fields": { "anyOf": [ {}, { "type": "null" } ] } }, "required": [ "command_id", "repo_id", "attachment_ids" ], "additionalProperties": false }, "synckhub_server.routes.mail.attachments.SaveAttachmentsRequest": { "title": "SaveAttachmentsRequest", "type": "object", "properties": { "command_id": { "anyOf": [ { "type": "string" }, { "type": "null" } ] }, "repo_id": { "type": "string" }, "parent_folder_id": { "anyOf": [ { "type": "string" }, { "type": "null" } ] }, "attachment_ids": { "type": "array", "items": { "type": "string" } }, "name_overrides": { "type": "object", "additionalProperties": { "type": "string" } }, "item_subtype": { "anyOf": [ { "type": "string" }, { "type": "null" } ] }, "fields": { "anyOf": [ {}, { "type": "null" } ] }, "name_conflict_policy": { "anyOf": [ { "$ref": "#/components/schemas/synckhub_uploads.intents.UploadNameConflictPolicy" }, { "type": "null" } ] } }, "required": [ "repo_id", "attachment_ids" ], "additionalProperties": false }, "synckhub_server.routes.mail.attachments.SaveAttachmentsResponse": { "title": "SaveAttachmentsResponse", "type": "object", "properties": { "repo_id": { "type": "string" }, "parent_folder_id": { "anyOf": [ { "type": "string" }, { "type": "null" } ] }, "files": { "type": "array", "items": { "$ref": "#/components/schemas/synckhub_server.routes.mail.attachments.SavedAttachmentFile" } } }, "required": [ "repo_id", "files" ], "additionalProperties": false }, "synckhub_server.routes.mail.attachments.SavedAttachmentFile": { "title": "SavedAttachmentFile", "type": "object", "properties": { "attachment_id": { "type": "string" }, "file_item_id": { "type": "string" } }, "required": [ "attachment_id", "file_item_id" ], "additionalProperties": false }, "synckhub_server.routes.mail.drafts.SendDraftRouteResponse": { "title": "SendDraftRouteResponse", "type": "object", "properties": { "job_id": { "type": "string" }, "draft_id": { "type": "string" }, "status": { "type": "string" }, "message_id": { "anyOf": [ { "type": "string" }, { "type": "null" } ] }, "last_error": { "anyOf": [ { "type": "string" }, { "type": "null" } ] }, "scheduled_for": { "type": "string", "format": "date-time" }, "cancelable": { "type": "boolean" }, "synck_save_intent": { "anyOf": [ { "$ref": "#/components/schemas/synckhub_server.routes.mail.save.SentSynckSaveIntentResponse" }, { "type": "null" } ] } }, "required": [ "job_id", "draft_id", "status", "scheduled_for", "cancelable" ], "additionalProperties": false }, "synckhub_server.routes.mail.save.SentSynckSaveIntentResponse": { "title": "SentSynckSaveIntentResponse", "type": "object", "properties": { "intent_id": { "type": "string" }, "status": { "type": "string" }, "email_item_id": { "anyOf": [ { "type": "string" }, { "type": "null" } ] }, "last_error": { "anyOf": [ { "type": "string" }, { "type": "null" } ] } }, "required": [ "intent_id", "status" ], "additionalProperties": false }, "synckhub_server.routes.mail.drafts.SendDraftRequestBody": { "title": "SendDraftRequestBody", "type": "object", "properties": { "draft": { "anyOf": [ { "$ref": "#/components/schemas/synckhub_server.routes.mail.drafts.DraftRequestBody" }, { "type": "null" } ] }, "save_to_synck": { "anyOf": [ { "$ref": "#/components/schemas/synckhub_server.routes.mail.drafts.SentSynckSaveRequest" }, { "type": "null" } ] }, "create_task": { "anyOf": [ { "$ref": "#/components/schemas/synckhub_server.routes.mail.drafts.SentTaskRequest" }, { "type": "null" } ] }, "send_at": { "anyOf": [ { "type": "string", "format": "date-time" }, { "type": "null" } ] } }, "additionalProperties": false }, "synckhub_server.routes.mail.drafts.DraftRequestBody": { "title": "DraftRequestBody", "type": "object", "properties": { "to": { "type": "array", "items": { "$ref": "#/components/schemas/synckhub_mailcal.types.EmailAddress" } }, "cc": { "type": "array", "items": { "$ref": "#/components/schemas/synckhub_mailcal.types.EmailAddress" } }, "bcc": { "type": "array", "items": { "$ref": "#/components/schemas/synckhub_mailcal.types.EmailAddress" } }, "subject": { "anyOf": [ { "type": "string" }, { "type": "null" } ] }, "body": { "$ref": "#/components/schemas/synckhub_mailcal.types.Body" }, "importance": { "$ref": "#/components/schemas/synckhub_mailcal.types.MessageImportance" }, "attachments": { "type": "array", "items": { "$ref": "#/components/schemas/synckhub_mailcal.types.AttachmentUpload" } }, "policy_repo_id": { "anyOf": [ { "type": "string" }, { "type": "null" } ] }, "source": { "anyOf": [ { "$ref": "#/components/schemas/synckhub_server.routes.mail.drafts.DraftSourceRequest" }, { "type": "null" } ] } }, "required": [ "body" ], "additionalProperties": false }, "synckhub_server.routes.mail.drafts.DraftSourceRequest": { "title": "DraftSourceRequest", "type": "object", "properties": { "action": { "$ref": "#/components/schemas/synckhub_mailcal.types.DraftSourceAction" }, "message_id": { "anyOf": [ { "type": "string" }, { "type": "null" } ] }, "archived_email": { "anyOf": [ { "$ref": "#/components/schemas/synckhub_server.routes.mail.drafts.ArchivedDraftSourceRequest" }, { "type": "null" } ] } }, "required": [ "action" ], "additionalProperties": false }, "synckhub_server.routes.mail.drafts.ArchivedDraftSourceRequest": { "title": "ArchivedDraftSourceRequest", "type": "object", "properties": { "repo_id": { "type": "string" }, "email_item_id": { "type": "string" } }, "required": [ "repo_id", "email_item_id" ], "additionalProperties": false }, "synckhub_server.routes.mail.drafts.SentSynckSaveRequest": { "title": "SentSynckSaveRequest", "type": "object", "properties": { "repo_id": { "type": "string" }, "parent_folder_id": { "anyOf": [ { "type": "string" }, { "type": "null" } ] } }, "required": [ "repo_id" ], "additionalProperties": false }, "synckhub_server.routes.mail.drafts.SentTaskRequest": { "title": "SentTaskRequest", "anyOf": [ { "type": "object", "properties": { "repo_id": { "type": "string" }, "status": { "anyOf": [ { "type": "string" }, { "type": "null" } ] }, "priority": { "type": "string" }, "due": { "anyOf": [ { "$ref": "#/components/schemas/synckhub_core.types.TaskDue" }, { "type": "null" } ] } }, "required": [ "repo_id", "priority" ], "additionalProperties": false }, { "type": "object", "properties": { "repo_id": { "type": "string" }, "priority": { "type": "string" }, "due_at": { "anyOf": [ { "type": "string" }, { "type": "null" } ] } }, "required": [ "repo_id", "priority" ], "additionalProperties": false } ] }, "synckhub_core.types.TaskDue": { "title": "TaskDue", "oneOf": [ { "type": "object", "properties": { "kind": { "const": "DATE" }, "date": { "type": "string" } }, "required": [ "kind", "date" ] }, { "type": "object", "properties": { "kind": { "const": "DATETIME" }, "at": { "type": "string" }, "timezone": { "type": "string" } }, "required": [ "kind", "at", "timezone" ] } ], "description": "Canonical due value for one task row.\n\n`DATE` is a timezone-independent calendar date. `DATETIME` is an exact\ninstant plus the timezone used when editing it." }, "synckhub_server.routes.mail.drafts.DraftUpdateRequestBody": { "title": "DraftUpdateRequestBody", "type": "object", "properties": { "to": { "type": "array", "items": { "$ref": "#/components/schemas/synckhub_mailcal.types.EmailAddress" } }, "cc": { "type": "array", "items": { "$ref": "#/components/schemas/synckhub_mailcal.types.EmailAddress" } }, "bcc": { "type": "array", "items": { "$ref": "#/components/schemas/synckhub_mailcal.types.EmailAddress" } }, "subject": { "anyOf": [ { "type": "string" }, { "type": "null" } ] }, "body": { "$ref": "#/components/schemas/synckhub_mailcal.types.Body" }, "importance": { "$ref": "#/components/schemas/synckhub_mailcal.types.MessageImportance" }, "attachments": { "anyOf": [ { "type": "array", "items": { "$ref": "#/components/schemas/synckhub_mailcal.types.AttachmentUpload" } }, { "type": "null" } ] }, "attachment_revision": { "anyOf": [ { "type": "string" }, { "type": "null" } ] }, "policy_repo_id": { "anyOf": [ { "type": "string" }, { "type": "null" } ] } }, "required": [ "body" ], "additionalProperties": false }, "synckhub_server.routes.mail.drafts.DraftUpdateRouteResponse": { "title": "DraftUpdateRouteResponse", "type": "object", "properties": { "attachment_revision": { "type": "string" } }, "required": [ "attachment_revision" ] }, "synckhub_server.routes.mail.drafts.ResolveDraftAttachmentFromSynckItemRequestBody": { "title": "ResolveDraftAttachmentFromSynckItemRequestBody", "type": "object", "properties": { "repo_id": { "type": "string" }, "item_id": { "type": "string" }, "policy_repo_id": { "anyOf": [ { "type": "string" }, { "type": "null" } ] }, "filename": { "anyOf": [ { "type": "string" }, { "type": "null" } ] }, "mime_type": { "anyOf": [ { "type": "string" }, { "type": "null" } ] } }, "required": [ "repo_id", "item_id" ], "additionalProperties": false }, "synckhub_server.routes.mail.drafts.ResolveDraftAttachmentFromSynckItemResponseBody": { "title": "ResolveDraftAttachmentFromSynckItemResponseBody", "type": "object", "properties": { "repo_id": { "type": "string" }, "item_id": { "type": "string" }, "filename": { "type": "string" }, "mime_type": { "anyOf": [ { "type": "string" }, { "type": "null" } ] }, "content_base64": { "type": "string" }, "size_bytes": { "type": "integer", "minimum": 0 } }, "required": [ "repo_id", "item_id", "filename", "content_base64", "size_bytes" ], "additionalProperties": false }, "synckhub_server.routes.mail.drafts.DraftRouteResponse": { "title": "DraftRouteResponse", "type": "object", "properties": { "draft_id": { "type": "string" }, "message_id": { "anyOf": [ { "type": "string" }, { "type": "null" } ] }, "attachment_revision": { "type": "string" } }, "required": [ "draft_id", "attachment_revision" ] }, "synckhub_server.routes.mail.mailboxes.ConfirmSafeEmptyRequest": { "title": "ConfirmSafeEmptyRequest", "type": "object", "properties": { "captured_count": { "type": "integer" } }, "required": [ "captured_count" ], "additionalProperties": false }, "synckhub_server.routes.mail.mailboxes.BulkActionJobResponse": { "title": "BulkActionJobResponse", "type": "object", "properties": { "job_id": { "type": "string" }, "account_id": { "type": "string" }, "mailbox_id": { "type": "string" }, "action": { "type": "string" }, "recursive": { "type": "boolean" }, "status": { "type": "string" }, "processed_count": { "type": "integer" }, "failed_count": { "type": "integer" }, "total_estimate": { "anyOf": [ { "type": "integer" }, { "type": "null" } ] }, "attempts": { "type": "integer" }, "next_retry_at": { "anyOf": [ { "type": "string", "format": "date-time" }, { "type": "null" } ] }, "last_error": { "anyOf": [ { "type": "string" }, { "type": "null" } ] }, "created_at": { "type": "string", "format": "date-time" }, "updated_at": { "type": "string", "format": "date-time" }, "started_at": { "anyOf": [ { "type": "string", "format": "date-time" }, { "type": "null" } ] }, "completed_at": { "anyOf": [ { "type": "string", "format": "date-time" }, { "type": "null" } ] }, "protocol_version": { "anyOf": [ { "type": "integer" }, { "type": "null" } ] }, "phase": { "anyOf": [ { "type": "string" }, { "type": "null" } ] }, "captured_count": { "anyOf": [ { "type": "integer" }, { "type": "null" } ] }, "skipped_count": { "anyOf": [ { "type": "integer" }, { "type": "null" } ] }, "unknown_count": { "anyOf": [ { "type": "integer" }, { "type": "null" } ] }, "confirmation_expires_at": { "anyOf": [ { "type": "string", "format": "date-time" }, { "type": "null" } ] }, "confirmed_at": { "anyOf": [ { "type": "string", "format": "date-time" }, { "type": "null" } ] }, "last_error_code": { "anyOf": [ { "type": "string" }, { "type": "null" } ] } }, "required": [ "job_id", "account_id", "mailbox_id", "action", "recursive", "status", "processed_count", "failed_count", "attempts", "created_at", "updated_at" ], "additionalProperties": false }, "synckhub_server.routes.mail.mailboxes.BulkActionJobsResponse": { "title": "BulkActionJobsResponse", "type": "object", "properties": { "jobs": { "type": "array", "items": { "$ref": "#/components/schemas/synckhub_server.routes.mail.mailboxes.BulkActionJobResponse" } } }, "required": [ "jobs" ], "additionalProperties": false }, "synckhub_server.routes.mail.mailboxes.MailboxActionRequest": { "title": "MailboxActionRequest", "type": "object", "properties": { "action": { "type": "string" }, "confirmed": { "type": "boolean" }, "recursive": { "anyOf": [ { "type": "boolean" }, { "type": "null" } ] }, "max_messages": { "anyOf": [ { "type": "integer", "minimum": 0 }, { "type": "null" } ] } }, "required": [ "action" ], "additionalProperties": false }, "synckhub_server.routes.mail.mailboxes.MoveMailboxRequest": { "title": "MoveMailboxRequest", "type": "object", "properties": { "parent_mailbox_id": { "anyOf": [ { "type": "string" }, { "type": "null" } ] } }, "additionalProperties": false }, "synckhub_server.routes.mail.mailboxes.RenameMailboxRequest": { "title": "RenameMailboxRequest", "type": "object", "properties": { "name": { "type": "string" } }, "required": [ "name" ], "additionalProperties": false }, "synckhub_server.routes.mail.mailboxes.CreateMailboxRequest": { "title": "CreateMailboxRequest", "type": "object", "properties": { "name": { "type": "string" }, "parent_mailbox_id": { "anyOf": [ { "type": "string" }, { "type": "null" } ] } }, "required": [ "name" ], "additionalProperties": false }, "synckhub_server.routes.mail.mailboxes.MailboxesResponse": { "title": "MailboxesResponse", "type": "object", "properties": { "mailboxes": { "type": "array", "items": { "$ref": "#/components/schemas/synckhub_mailcal.types.Mailbox" } }, "native_folders": { "anyOf": [ { "$ref": "#/components/schemas/synckhub_server.routes.mail.mailboxes.NativeFolderLinks" }, { "type": "null" } ] } }, "required": [ "mailboxes" ], "additionalProperties": false }, "synckhub_server.routes.mail.mailboxes.NativeFolderLinks": { "title": "NativeFolderLinks", "type": "object", "properties": { "repo_id": { "type": "string", "format": "uuid" }, "emails_folder_id": { "type": "string", "format": "uuid" }, "inbox_folder_id": { "anyOf": [ { "type": "string", "format": "uuid" }, { "type": "null" } ] }, "inbox_total_count": { "type": "integer" }, "inbox_unread_count": { "type": "integer" }, "archive_folder_id": { "anyOf": [ { "type": "string", "format": "uuid" }, { "type": "null" } ] }, "sent_vcs_ready": { "type": "boolean" } }, "required": [ "repo_id", "emails_folder_id", "inbox_total_count", "inbox_unread_count", "sent_vcs_ready" ] }, "synckhub_server.routes.mail.messages.MessageActionUnknownAcknowledgementResponse": { "title": "MessageActionUnknownAcknowledgementResponse", "type": "object", "properties": { "job_id": { "type": "string", "format": "uuid" }, "status": { "type": "string" }, "acknowledged_at": { "type": "string", "format": "date-time" }, "acknowledged_by": { "type": "string" } }, "required": [ "job_id", "status", "acknowledged_at", "acknowledged_by" ] }, "synckhub_server.routes.mail.messages.MessageActionJobResponse": { "title": "MessageActionJobResponse", "type": "object", "properties": { "job_id": { "type": "string", "format": "uuid" }, "command_id": { "type": "string", "format": "uuid" }, "account_id": { "type": "string", "format": "uuid" }, "action": { "type": "string" }, "message_count": { "type": "integer", "minimum": 0 }, "processed_count": { "type": "integer" }, "status": { "type": "string" }, "mailbox_id": { "anyOf": [ { "type": "string" }, { "type": "null" } ] }, "next_retry_at": { "anyOf": [ { "type": "string", "format": "date-time" }, { "type": "null" } ] }, "last_error_code": { "anyOf": [ { "type": "string" }, { "type": "null" } ] }, "created_at": { "type": "string", "format": "date-time" }, "updated_at": { "type": "string", "format": "date-time" }, "completed_at": { "anyOf": [ { "type": "string", "format": "date-time" }, { "type": "null" } ] } }, "required": [ "job_id", "command_id", "account_id", "action", "message_count", "processed_count", "status", "created_at", "updated_at" ] }, "synckhub_server.routes.mail.messages.MessageActionJobRequest": { "title": "MessageActionJobRequest", "type": "object", "properties": { "command_id": { "type": "string", "format": "uuid" }, "action": { "type": "string" }, "message_ids": { "type": "array", "items": { "type": "string" } }, "mailbox_id": { "anyOf": [ { "type": "string" }, { "type": "null" } ] }, "message_revisions": { "anyOf": [ { "type": "object", "additionalProperties": { "type": "integer" } }, { "type": "null" } ] } }, "required": [ "command_id", "action", "message_ids" ], "additionalProperties": false }, "synckhub_server.routes.mail.messages.MessageActionsRequest": { "title": "MessageActionsRequest", "type": "object", "properties": { "action": { "type": "string" }, "message_ids": { "type": "array", "items": { "type": "string" } }, "mailbox_id": { "anyOf": [ { "type": "string" }, { "type": "null" } ] } }, "required": [ "action", "message_ids" ], "additionalProperties": false }, "synckhub_server.routes.mail.messages.MessageActionRequest": { "title": "MessageActionRequest", "type": "object", "properties": { "action": { "type": "string" }, "mailbox_id": { "anyOf": [ { "type": "string" }, { "type": "null" } ] } }, "required": [ "action" ], "additionalProperties": false }, "synckhub_server.routes.mail.messages.ReadMessageRequest": { "title": "ReadMessageRequest", "type": "object", "properties": { "message_id": { "type": "string" } }, "required": [ "message_id" ] }, "synckhub_core.external_scheduling.state.RespondIncomingInvitation": { "title": "RespondIncomingInvitation", "type": "object", "properties": { "command_id": { "type": "string", "format": "uuid" }, "response": { "$ref": "#/components/schemas/synckhub_core.native_calendars.Response" }, "time_zone": { "type": "string" }, "private_if_created": { "anyOf": [ { "type": "boolean" }, { "type": "null" } ] } }, "required": [ "command_id", "response", "time_zone" ], "additionalProperties": false }, "synckhub_core.native_calendars.Response": { "title": "Response", "type": "string", "enum": [ "NEEDS_ACTION", "ACCEPTED", "TENTATIVE", "DECLINED" ] }, "synckhub_server.routes.mail.native_clear_spam.ClearSpamCommandRequest": { "title": "ClearSpamCommandRequest", "type": "object", "properties": { "command_id": { "type": "string", "format": "uuid" }, "scope": { "$ref": "#/components/schemas/synckhub_server.routes.mail.native_clear_spam.ClearSpamScope" } }, "required": [ "command_id", "scope" ], "additionalProperties": false }, "synckhub_server.routes.mail.native_clear_spam.ClearSpamScope": { "title": "ClearSpamScope", "type": "string", "enum": [ "SPAM" ] }, "synckhub_server.routes.mail.native_clear_spam.ClearSpamCommandResponse": { "title": "ClearSpamCommandResponse", "type": "object", "properties": { "command_id": { "type": "string", "format": "uuid" }, "account_id": { "type": "string", "format": "uuid" }, "scope": { "$ref": "#/components/schemas/synckhub_server.routes.mail.native_clear_spam.ClearSpamScope" }, "affected_count": { "type": "integer" }, "completed_at": { "type": "string", "format": "date-time" } }, "required": [ "command_id", "account_id", "scope", "affected_count", "completed_at" ] }, "synckhub_server.native_mail.drafts.Submission": { "title": "Submission", "type": "object", "properties": { "command_id": { "type": "string", "format": "uuid" }, "draft_id": { "type": "string", "format": "uuid" }, "draft_revision": { "type": "integer" }, "status": { "type": "string" }, "last_error": { "anyOf": [ { "type": "string" }, { "type": "null" } ] }, "envelope_sender": { "type": "string" }, "envelope_recipients": { "type": "array", "items": { "type": "string" } }, "save_to_synck": { "anyOf": [ { "$ref": "#/components/schemas/synckhub_server.native_mail.drafts.SentSaveTarget" }, { "type": "null" } ] }, "filing_command_id": { "anyOf": [ { "type": "string", "format": "uuid" }, { "type": "null" } ] }, "default_sent_command_id": { "anyOf": [ { "type": "string", "format": "uuid" }, { "type": "null" } ] }, "create_task": { "anyOf": [ { "$ref": "#/components/schemas/synckhub_server.native_mail.sent_tasks.SentTaskTarget" }, { "type": "null" } ] }, "delivery_reports": { "type": "object", "additionalProperties": { "$ref": "#/components/schemas/synckhub_server.native_mail.reports.RecipientReport" } }, "action": { "anyOf": [ { "$ref": "#/components/schemas/synckhub_server.native_mail.drafts.SubmissionAction" }, { "type": "null" } ], "description": "`None` identifies a submission admitted before action provenance existed." }, "source": { "anyOf": [ { "$ref": "#/components/schemas/synckhub_server.native_mail.drafts.SubmissionSource" }, { "type": "null" } ] }, "scheduled_for": { "type": "string", "format": "date-time" }, "cancelable": { "type": "boolean" } }, "required": [ "command_id", "draft_id", "draft_revision", "status", "envelope_sender", "envelope_recipients", "delivery_reports", "scheduled_for", "cancelable" ] }, "synckhub_server.native_mail.drafts.SentSaveTarget": { "title": "SentSaveTarget", "type": "object", "properties": { "repo_id": { "type": "string", "format": "uuid" }, "parent_folder_id": { "anyOf": [ { "type": "string", "format": "uuid" }, { "type": "null" } ] } }, "required": [ "repo_id" ], "additionalProperties": false }, "synckhub_server.native_mail.sent_tasks.SentTaskTarget": { "title": "SentTaskTarget", "type": "object", "properties": { "repo_id": { "type": "string", "format": "uuid" }, "status": { "anyOf": [ { "type": "string" }, { "type": "null" } ] }, "priority": { "type": "string" }, "due_at": { "anyOf": [ { "type": "string" }, { "type": "null" } ] }, "due": { "anyOf": [ { "$ref": "#/components/schemas/synckhub_core.types.TaskDue" }, { "type": "null" } ] } }, "required": [ "repo_id", "priority" ], "additionalProperties": false }, "synckhub_server.native_mail.reports.RecipientReport": { "title": "RecipientReport", "type": "object", "properties": { "action": { "type": "string" }, "status": { "type": "string" }, "diagnostic": { "anyOf": [ { "type": "string" }, { "type": "null" } ] }, "report_message_id": { "type": "string", "format": "uuid" } }, "required": [ "action", "status", "report_message_id" ] }, "synckhub_server.native_mail.drafts.SubmissionAction": { "title": "SubmissionAction", "type": "string", "enum": [ "NEW", "REPLY", "REPLY_ALL", "FORWARD" ] }, "synckhub_server.native_mail.drafts.SubmissionSource": { "title": "SubmissionSource", "type": "object", "properties": { "action": { "$ref": "#/components/schemas/synckhub_server.native_mail.drafts.SubmissionAction" }, "repo_id": { "type": "string", "format": "uuid" }, "item_id": { "type": "string", "format": "uuid" } }, "required": [ "action", "repo_id", "item_id" ], "additionalProperties": false }, "synckhub_server.routes.mail.native_compose.Send": { "title": "Send", "type": "object", "properties": { "command_id": { "type": "string", "format": "uuid" }, "draft_id": { "type": "string", "format": "uuid" }, "revision": { "type": "integer" }, "save_to_synck": { "anyOf": [ { "$ref": "#/components/schemas/synckhub_server.native_mail.drafts.SentSaveTarget" }, { "type": "null" } ] }, "create_task": { "anyOf": [ { "$ref": "#/components/schemas/synckhub_server.native_mail.sent_tasks.SentTaskTarget" }, { "type": "null" } ] }, "source": { "anyOf": [ { "$ref": "#/components/schemas/synckhub_server.native_mail.drafts.SubmissionSource" }, { "type": "null" } ] }, "send_at": { "anyOf": [ { "type": "string", "format": "date-time" }, { "type": "null" } ] } }, "required": [ "command_id", "draft_id", "revision" ], "additionalProperties": false }, "synckhub_server.routes.mail.native_compose.Update": { "title": "Update", "type": "object", "properties": { "revision": { "type": "integer" }, "content": { "$ref": "#/components/schemas/synckhub_server.native_mail.compose.DraftContent" }, "reuse_attachments": { "type": "boolean" } }, "required": [ "revision", "content" ], "additionalProperties": false }, "synckhub_server.native_mail.compose.DraftContent": { "title": "DraftContent", "type": "object", "properties": { "source": { "anyOf": [ { "$ref": "#/components/schemas/synckhub_server.native_mail.drafts.SubmissionSource" }, { "type": "null" } ] }, "from": { "$ref": "#/components/schemas/synckhub_mailcal.types.EmailAddress" }, "to": { "type": "array", "items": { "$ref": "#/components/schemas/synckhub_mailcal.types.EmailAddress" } }, "cc": { "type": "array", "items": { "$ref": "#/components/schemas/synckhub_mailcal.types.EmailAddress" } }, "bcc": { "type": "array", "items": { "$ref": "#/components/schemas/synckhub_mailcal.types.EmailAddress" } }, "subject": { "type": "string" }, "body": { "$ref": "#/components/schemas/synckhub_mailcal.types.Body" }, "importance": { "anyOf": [ { "$ref": "#/components/schemas/synckhub_mailcal.types.MessageImportance" }, { "type": "null" } ] }, "attachments": { "type": "array", "items": { "$ref": "#/components/schemas/synckhub_mailcal.types.AttachmentUpload" } }, "in_reply_to": { "anyOf": [ { "type": "string" }, { "type": "null" } ] }, "references": { "type": "array", "items": { "type": "string" } } }, "required": [ "from", "subject", "body" ], "additionalProperties": false }, "synckhub_server.routes.mail.native_compose.DraftWriteReceipt": { "title": "DraftWriteReceipt", "type": "object", "properties": { "draft_id": { "type": "string", "format": "uuid" }, "revision": { "type": "integer" }, "status": { "type": "string" } }, "required": [ "draft_id", "revision", "status" ] }, "synckhub_server.native_mail.drafts.Draft": { "title": "Draft", "type": "object", "properties": { "draft_id": { "type": "string", "format": "uuid" }, "revision": { "type": "integer" }, "status": { "type": "string" }, "content": { "anyOf": [ { "$ref": "#/components/schemas/synckhub_server.native_mail.compose.DraftContent" }, { "type": "null" } ] } }, "required": [ "draft_id", "revision", "status" ] }, "synckhub_server.routes.mail.native_compose.Create": { "title": "Create", "type": "object", "properties": { "command_id": { "type": "string", "format": "uuid" }, "content": { "$ref": "#/components/schemas/synckhub_server.native_mail.compose.DraftContent" } }, "required": [ "command_id", "content" ], "additionalProperties": false }, "synckhub_server.routes.mail.native_compose.AutoReplyUpdate": { "title": "AutoReplyUpdate", "type": "object", "properties": { "command_id": { "type": "string", "format": "uuid" }, "revision": { "type": "integer" }, "config": { "$ref": "#/components/schemas/synckhub_server.native_mail.automatic_replies.AutoReplyConfig" } }, "required": [ "command_id", "revision", "config" ], "additionalProperties": false }, "synckhub_server.native_mail.automatic_replies.AutoReplyConfig": { "title": "AutoReplyConfig", "type": "object", "properties": { "enabled": { "type": "boolean" }, "starts_at": { "type": "string", "format": "date-time" }, "ends_at": { "type": "string", "format": "date-time" }, "sender": { "type": "string" }, "subject": { "type": "string" }, "body": { "type": "string" } }, "required": [ "enabled", "starts_at", "ends_at", "sender", "subject", "body" ], "additionalProperties": false }, "synckhub_server.native_mail.automatic_replies.AutoReplySettings": { "title": "AutoReplySettings", "type": "object", "properties": { "revision": { "type": "integer" }, "config": { "anyOf": [ { "$ref": "#/components/schemas/synckhub_server.native_mail.automatic_replies.AutoReplyConfig" }, { "type": "null" } ] }, "last_error": { "anyOf": [ { "type": "string" }, { "type": "null" } ] } }, "required": [ "revision" ] }, "synckhub_server.routes.mail.native_compose.InboxRulesUpdate": { "title": "InboxRulesUpdate", "type": "object", "properties": { "command_id": { "type": "string", "format": "uuid" }, "revision": { "type": "integer" }, "rules": { "type": "array", "items": { "$ref": "#/components/schemas/synckhub_server.native_mail.inbox_rules.InboxRule" } } }, "required": [ "command_id", "revision", "rules" ], "additionalProperties": false }, "synckhub_server.native_mail.inbox_rules.InboxRule": { "title": "InboxRule", "type": "object", "properties": { "id": { "type": "string", "format": "uuid" }, "enabled": { "type": "boolean" }, "sender": { "anyOf": [ { "type": "string" }, { "type": "null" } ] }, "sender_domain": { "anyOf": [ { "type": "string" }, { "type": "null" } ] }, "recipient": { "anyOf": [ { "type": "string" }, { "type": "null" } ] }, "subject_contains": { "anyOf": [ { "type": "string" }, { "type": "null" } ] }, "action": { "$ref": "#/components/schemas/synckhub_server.native_mail.inbox_rules.InboxRuleAction" }, "mark_read": { "type": "boolean" }, "forward_to": { "anyOf": [ { "type": "string" }, { "type": "null" } ] } }, "required": [ "id", "enabled", "action", "mark_read" ], "additionalProperties": false }, "synckhub_server.native_mail.inbox_rules.InboxRuleAction": { "title": "InboxRuleAction", "oneOf": [ { "type": "object", "properties": { "kind": { "const": "inbox" } }, "required": [ "kind" ], "additionalProperties": false }, { "type": "object", "properties": { "kind": { "const": "trash" } }, "required": [ "kind" ], "additionalProperties": false }, { "type": "object", "properties": { "kind": { "const": "file" }, "repo_id": { "type": "string", "format": "uuid" }, "folder_id": { "type": "string", "format": "uuid" } }, "required": [ "kind", "repo_id", "folder_id" ], "additionalProperties": false } ] }, "synckhub_server.native_mail.inbox_rules.InboxRules": { "title": "InboxRules", "type": "object", "properties": { "revision": { "type": "integer" }, "rules": { "type": "array", "items": { "$ref": "#/components/schemas/synckhub_server.native_mail.inbox_rules.InboxRule" } }, "last_error": { "anyOf": [ { "type": "string" }, { "type": "null" } ] } }, "required": [ "revision", "rules" ] }, "synckhub_server.native_mail.vcs_reclassification.VcsReclassification": { "title": "VcsReclassification", "type": "object", "properties": { "mailbox_id": { "type": "string", "format": "uuid" }, "command_id": { "type": "string", "format": "uuid" }, "message_id": { "type": "string", "format": "uuid" }, "repo_id": { "type": "string", "format": "uuid" }, "item_id": { "type": "string", "format": "uuid" }, "source_item_seq": { "type": "integer" }, "is_read": { "type": "boolean" }, "classification": { "type": "string" }, "actor_principal_id": { "type": "string" }, "status": { "type": "string" }, "last_error": { "anyOf": [ { "type": "string" }, { "type": "null" } ] }, "updated_at": { "type": "string", "format": "date-time" }, "lease_token": { "anyOf": [ { "type": "string", "format": "uuid" }, { "type": "null" } ] } }, "required": [ "mailbox_id", "command_id", "message_id", "repo_id", "item_id", "source_item_seq", "is_read", "classification", "actor_principal_id", "status", "updated_at" ] }, "synckhub_server.routes.mail.native_filing.VcsReclassificationRequest": { "title": "VcsReclassificationRequest", "type": "object", "properties": { "command_id": { "type": "string", "format": "uuid" }, "message_id": { "type": "string", "format": "uuid" }, "repo_id": { "type": "string", "format": "uuid" }, "item_id": { "type": "string", "format": "uuid" }, "classification": { "type": "string" } }, "required": [ "command_id", "message_id", "repo_id", "item_id", "classification" ], "additionalProperties": false }, "synckhub_server.native_mail.filing.FilingJob": { "title": "FilingJob", "type": "object", "properties": { "mailbox_id": { "type": "string", "format": "uuid" }, "request": { "$ref": "#/components/schemas/synckhub_server.native_mail.filing.FilingRequest" }, "output_item_id": { "type": "string", "format": "uuid" }, "status": { "type": "string" }, "source_deleted": { "type": "boolean" }, "last_error": { "anyOf": [ { "type": "string" }, { "type": "null" } ] } }, "required": [ "mailbox_id", "request", "output_item_id", "status", "source_deleted" ] }, "synckhub_server.native_mail.filing.FilingRequest": { "title": "FilingRequest", "type": "object", "properties": { "command_id": { "type": "string", "format": "uuid" }, "message_id": { "type": "string", "format": "uuid" }, "source_revision": { "type": "integer" }, "repo_id": { "type": "string", "format": "uuid" }, "parent_folder_id": { "anyOf": [ { "type": "string", "format": "uuid" }, { "type": "null" } ] }, "name": { "type": "string" }, "name_conflict_policy": { "type": "string" }, "move_source": { "type": "boolean" }, "mark_source_read": { "type": "boolean" }, "attachment_index": { "anyOf": [ { "type": "integer" }, { "type": "null" } ] }, "item_subtype": { "anyOf": [ { "type": "string" }, { "type": "null" } ] }, "fields": { "anyOf": [ {}, { "type": "null" } ] } }, "required": [ "command_id", "message_id", "source_revision", "repo_id", "name", "name_conflict_policy", "move_source" ], "additionalProperties": false }, "synckhub_server.routes.mail.native_mark_all_read.MarkAllReadCommandRequest": { "title": "MarkAllReadCommandRequest", "type": "object", "properties": { "command_id": { "type": "string", "format": "uuid" }, "scope": { "$ref": "#/components/schemas/synckhub_server.routes.mail.native_mark_all_read.MarkAllReadScope" } }, "required": [ "command_id", "scope" ], "additionalProperties": false }, "synckhub_server.routes.mail.native_mark_all_read.MarkAllReadScope": { "title": "MarkAllReadScope", "type": "string", "enum": [ "INBOX" ] }, "synckhub_server.routes.mail.native_mark_all_read.MarkAllReadCommandResponse": { "title": "MarkAllReadCommandResponse", "type": "object", "properties": { "command_id": { "type": "string", "format": "uuid" }, "account_id": { "type": "string", "format": "uuid" }, "scope": { "$ref": "#/components/schemas/synckhub_server.routes.mail.native_mark_all_read.MarkAllReadScope" }, "affected_count": { "type": "integer" }, "completed_at": { "type": "string", "format": "date-time" } }, "required": [ "command_id", "account_id", "scope", "affected_count", "completed_at" ] }, "synckhub_server.routes.mail.native_pin.PinCommandRequest": { "title": "PinCommandRequest", "type": "object", "properties": { "command_id": { "type": "string", "format": "uuid" }, "action": { "$ref": "#/components/schemas/synckhub_server.routes.mail.native_pin.PinAction" }, "items": { "type": "array", "items": { "$ref": "#/components/schemas/synckhub_server.routes.mail.native_pin.PinItemRequest" } } }, "required": [ "command_id", "action", "items" ], "additionalProperties": false }, "synckhub_server.routes.mail.native_pin.PinAction": { "title": "PinAction", "type": "string", "enum": [ "PIN", "UNPIN" ] }, "synckhub_server.routes.mail.native_pin.PinItemRequest": { "title": "PinItemRequest", "type": "object", "properties": { "message_id": { "type": "string", "format": "uuid" }, "repo_id": { "type": "string", "format": "uuid" }, "item_id": { "type": "string", "format": "uuid" }, "expected_pin_version": { "type": "integer" } }, "required": [ "message_id", "repo_id", "item_id", "expected_pin_version" ], "additionalProperties": false }, "synckhub_server.routes.mail.native_pin.PinCommandResponse": { "title": "PinCommandResponse", "type": "object", "properties": { "command_id": { "type": "string", "format": "uuid" }, "account_id": { "type": "string", "format": "uuid" }, "action": { "$ref": "#/components/schemas/synckhub_server.routes.mail.native_pin.PinAction" }, "completed_at": { "type": "string", "format": "date-time" }, "items": { "type": "array", "items": { "$ref": "#/components/schemas/synckhub_server.routes.mail.native_pin.PinItemResponse" } } }, "required": [ "command_id", "account_id", "action", "completed_at", "items" ] }, "synckhub_server.routes.mail.native_pin.PinItemResponse": { "title": "PinItemResponse", "type": "object", "properties": { "message_id": { "type": "string", "format": "uuid" }, "repo_id": { "type": "string", "format": "uuid" }, "item_id": { "type": "string", "format": "uuid" }, "pin_version": { "type": "integer" }, "pinned_at": { "anyOf": [ { "type": "string", "format": "date-time" }, { "type": "null" } ] }, "changed": { "type": "boolean" } }, "required": [ "message_id", "repo_id", "item_id", "pin_version", "changed" ] }, "synckhub_server.routes.mail.native_quarantine.CommandRequest": { "title": "CommandRequest", "type": "object", "properties": { "command_id": { "type": "string", "format": "uuid" } }, "required": [ "command_id" ], "additionalProperties": false }, "synckhub_server.native_mail.sender_policy.PersonalSenderPolicyReceipt": { "title": "PersonalSenderPolicyReceipt", "type": "object", "properties": { "command_id": { "type": "string", "format": "uuid" }, "operation": { "$ref": "#/components/schemas/synckhub_server.native_mail.sender_policy.PersonalSenderPolicyOperation" }, "address": { "type": "string" }, "accepted_revision": { "type": "integer" }, "changed": { "type": "boolean" }, "completed_at": { "type": "string", "format": "date-time" } }, "required": [ "command_id", "operation", "address", "accepted_revision", "changed", "completed_at" ] }, "synckhub_server.native_mail.sender_policy.PersonalSenderPolicyOperation": { "title": "PersonalSenderPolicyOperation", "type": "string", "enum": [ "BLOCK", "SAFE", "REMOVE" ] }, "synckhub_server.routes.mail.native_sender_policy.PersonalSenderPolicyCommandRequest": { "title": "PersonalSenderPolicyCommandRequest", "type": "object", "properties": { "command_id": { "type": "string", "format": "uuid" }, "expected_revision": { "type": "integer" }, "operation": { "$ref": "#/components/schemas/synckhub_server.native_mail.sender_policy.PersonalSenderPolicyOperation" }, "address": { "type": "string" } }, "required": [ "command_id", "expected_revision", "operation", "address" ], "additionalProperties": false }, "synckhub_server.native_mail.sender_policy.PersonalSenderPolicy": { "title": "PersonalSenderPolicy", "type": "object", "properties": { "revision": { "type": "integer" }, "blocked_senders": { "type": "array", "items": { "type": "string" } }, "safe_senders": { "type": "array", "items": { "type": "string" } } }, "required": [ "revision", "blocked_senders", "safe_senders" ] }, "synckhub_server.native_mail.shared.Configure": { "title": "Configure", "type": "object", "properties": { "command_id": { "type": "string", "format": "uuid" }, "expected_revision": { "type": "integer" }, "root_folder_id": { "type": "string", "format": "uuid" }, "members": { "type": "array", "items": { "$ref": "#/components/schemas/synckhub_server.native_mail.shared.Member" } } }, "required": [ "command_id", "expected_revision", "root_folder_id", "members" ], "additionalProperties": false }, "synckhub_server.native_mail.shared.Member": { "title": "Member", "type": "object", "properties": { "principal_id": { "type": "string" }, "send_mode": { "$ref": "#/components/schemas/synckhub_server.native_mail.shared.SendMode" } }, "required": [ "principal_id", "send_mode" ], "additionalProperties": false }, "synckhub_server.native_mail.shared.SendMode": { "title": "SendMode", "type": "string", "enum": [ "NONE", "AS", "ON_BEHALF" ] }, "synckhub_server.native_mail.groups.ConfigureGroup": { "title": "ConfigureGroup", "type": "object", "properties": { "command_id": { "type": "string", "format": "uuid" }, "expected_revision": { "type": "integer" }, "members": { "type": "array", "items": { "type": "string", "format": "uuid" } } }, "required": [ "command_id", "expected_revision", "members" ], "additionalProperties": false }, "synckhub_server.routes.mail.native_snooze.SnoozeCommandRequest": { "title": "SnoozeCommandRequest", "type": "object", "properties": { "command_id": { "type": "string", "format": "uuid" }, "action": { "$ref": "#/components/schemas/synckhub_server.routes.mail.native_snooze.SnoozeAction" }, "wake_at": { "anyOf": [ { "type": "string", "format": "date-time" }, { "type": "null" } ] }, "items": { "type": "array", "items": { "$ref": "#/components/schemas/synckhub_server.routes.mail.native_snooze.SnoozeItemRequest" } } }, "required": [ "command_id", "action", "items" ], "additionalProperties": false }, "synckhub_server.routes.mail.native_snooze.SnoozeAction": { "title": "SnoozeAction", "type": "string", "enum": [ "SNOOZE", "RESCHEDULE", "UNSNOOZE" ] }, "synckhub_server.routes.mail.native_snooze.SnoozeItemRequest": { "title": "SnoozeItemRequest", "type": "object", "properties": { "message_id": { "type": "string", "format": "uuid" }, "repo_id": { "type": "string", "format": "uuid" }, "item_id": { "type": "string", "format": "uuid" }, "expected_snooze_version": { "type": "integer" } }, "required": [ "message_id", "repo_id", "item_id", "expected_snooze_version" ], "additionalProperties": false }, "synckhub_server.routes.mail.native_snooze.SnoozeCommandResponse": { "title": "SnoozeCommandResponse", "type": "object", "properties": { "command_id": { "type": "string", "format": "uuid" }, "account_id": { "type": "string", "format": "uuid" }, "action": { "$ref": "#/components/schemas/synckhub_server.routes.mail.native_snooze.SnoozeAction" }, "wake_at": { "anyOf": [ { "type": "string", "format": "date-time" }, { "type": "null" } ] }, "completed_at": { "type": "string", "format": "date-time" }, "items": { "type": "array", "items": { "$ref": "#/components/schemas/synckhub_server.routes.mail.native_snooze.SnoozeItemResponse" } } }, "required": [ "command_id", "account_id", "action", "completed_at", "items" ] }, "synckhub_server.routes.mail.native_snooze.SnoozeItemResponse": { "title": "SnoozeItemResponse", "type": "object", "properties": { "message_id": { "type": "string", "format": "uuid" }, "repo_id": { "type": "string", "format": "uuid" }, "item_id": { "type": "string", "format": "uuid" }, "snooze_version": { "type": "integer" }, "state": { "$ref": "#/components/schemas/synckhub_server.routes.mail.native_snooze.SnoozeState" } }, "required": [ "message_id", "repo_id", "item_id", "snooze_version", "state" ] }, "synckhub_server.routes.mail.native_snooze.SnoozeState": { "title": "SnoozeState", "type": "string", "enum": [ "ACTIVE", "RETURNED" ] }, "synckhub_server.routes.mail.native_templates.TemplateReceipt": { "title": "TemplateReceipt", "type": "object", "properties": { "command_id": { "type": "string", "format": "uuid" }, "operation": { "$ref": "#/components/schemas/synckhub_server.routes.mail.native_templates.TemplateOperation" }, "template_id": { "type": "string", "format": "uuid" }, "revision": { "type": "integer" }, "changed": { "type": "boolean" }, "deleted": { "type": "boolean" }, "completed_at": { "type": "string", "format": "date-time" } }, "required": [ "command_id", "operation", "template_id", "revision", "changed", "deleted", "completed_at" ] }, "synckhub_server.routes.mail.native_templates.TemplateOperation": { "title": "TemplateOperation", "type": "string", "enum": [ "CREATE", "UPDATE", "DELETE" ] }, "synckhub_server.routes.mail.native_templates.TemplateCommand": { "title": "TemplateCommand", "oneOf": [ { "type": "object", "properties": { "operation": { "const": "CREATE" }, "command_id": { "type": "string", "format": "uuid" }, "content": { "$ref": "#/components/schemas/synckhub_server.routes.mail.native_templates.TemplateContent" } }, "required": [ "operation", "command_id", "content" ], "additionalProperties": false }, { "type": "object", "properties": { "operation": { "const": "UPDATE" }, "command_id": { "type": "string", "format": "uuid" }, "template_id": { "type": "string", "format": "uuid" }, "expected_revision": { "type": "integer" }, "content": { "$ref": "#/components/schemas/synckhub_server.routes.mail.native_templates.TemplateContent" } }, "required": [ "operation", "command_id", "template_id", "expected_revision", "content" ], "additionalProperties": false }, { "type": "object", "properties": { "operation": { "const": "DELETE" }, "command_id": { "type": "string", "format": "uuid" }, "template_id": { "type": "string", "format": "uuid" }, "expected_revision": { "type": "integer" } }, "required": [ "operation", "command_id", "template_id", "expected_revision" ], "additionalProperties": false } ] }, "synckhub_server.routes.mail.native_templates.TemplateContent": { "title": "TemplateContent", "type": "object", "properties": { "name": { "type": "string" }, "subject": { "anyOf": [ { "type": "string" }, { "type": "null" } ] }, "body": { "$ref": "#/components/schemas/synckhub_server.routes.mail.native_templates.TemplateBody" } }, "required": [ "name", "body" ], "additionalProperties": false }, "synckhub_server.routes.mail.native_templates.TemplateBody": { "title": "TemplateBody", "type": "object", "properties": { "kind": { "$ref": "#/components/schemas/synckhub_server.routes.mail.native_templates.TemplateBodyKind" }, "content": { "type": "string" } }, "required": [ "kind", "content" ], "additionalProperties": false }, "synckhub_server.routes.mail.native_templates.TemplateBodyKind": { "title": "TemplateBodyKind", "type": "string", "enum": [ "TEXT", "HTML" ] }, "synckhub_server.routes.mail.native_templates.NativeTemplate": { "title": "NativeTemplate", "type": "object", "properties": { "template_id": { "type": "string", "format": "uuid" }, "revision": { "type": "integer" }, "name": { "type": "string" }, "subject": { "anyOf": [ { "type": "string" }, { "type": "null" } ] }, "body": { "$ref": "#/components/schemas/synckhub_server.routes.mail.native_templates.TemplateBody" }, "created_at": { "type": "string", "format": "date-time" }, "updated_at": { "type": "string", "format": "date-time" } }, "required": [ "template_id", "revision", "name", "body", "created_at", "updated_at" ] }, "synckhub_server.routes.mail.native_templates.TemplateList": { "title": "TemplateList", "type": "object", "properties": { "templates": { "type": "array", "items": { "$ref": "#/components/schemas/synckhub_server.routes.mail.native_templates.TemplateSummary" } } }, "required": [ "templates" ] }, "synckhub_server.routes.mail.native_templates.TemplateSummary": { "title": "TemplateSummary", "type": "object", "properties": { "template_id": { "type": "string", "format": "uuid" }, "revision": { "type": "integer" }, "name": { "type": "string" }, "subject": { "anyOf": [ { "type": "string" }, { "type": "null" } ] }, "body_kind": { "$ref": "#/components/schemas/synckhub_server.routes.mail.native_templates.TemplateBodyKind" }, "created_at": { "type": "string", "format": "date-time" }, "updated_at": { "type": "string", "format": "date-time" } }, "required": [ "template_id", "revision", "name", "body_kind", "created_at", "updated_at" ] }, "synckhub_server.native_mail.unsubscribe.UnsubscribeReceipt": { "title": "UnsubscribeReceipt", "type": "object", "properties": { "command_id": { "type": "string", "format": "uuid" }, "account_id": { "type": "string", "format": "uuid" }, "message_id": { "type": "string", "format": "uuid" }, "hostname": { "type": "string" }, "status": { "type": "string" }, "attempts": { "type": "integer" }, "last_error": { "anyOf": [ { "type": "string" }, { "type": "null" } ] }, "created_at": { "type": "string", "format": "date-time" }, "updated_at": { "type": "string", "format": "date-time" }, "completed_at": { "anyOf": [ { "type": "string", "format": "date-time" }, { "type": "null" } ] } }, "required": [ "command_id", "account_id", "message_id", "hostname", "status", "attempts", "created_at", "updated_at" ] }, "synckhub_server.routes.mail.native_unsubscribe.UnsubscribeCommandRequest": { "title": "UnsubscribeCommandRequest", "type": "object", "properties": { "command_id": { "type": "string", "format": "uuid" } }, "required": [ "command_id" ], "additionalProperties": false }, "synckhub_server.native_mail.unsubscribe.UnsubscribeCapability": { "title": "UnsubscribeCapability", "type": "object", "properties": { "available": { "type": "boolean" }, "hostname": { "type": "string" } }, "required": [ "available", "hostname" ] }, "synckhub_server.routes.mail.routing.RepoMailRuleFoldersResponse": { "title": "RepoMailRuleFoldersResponse", "type": "object", "properties": { "repo_id": { "type": "string" }, "folders": { "type": "array", "items": { "$ref": "#/components/schemas/synckhub_server.routes.mail.routing.RepoMailRuleFolder" } } }, "required": [ "repo_id", "folders" ], "additionalProperties": false }, "synckhub_server.routes.mail.routing.RepoMailRuleFolder": { "title": "RepoMailRuleFolder", "type": "object", "properties": { "parent_folder_id": { "anyOf": [ { "type": "string" }, { "type": "null" } ] }, "explicit_rule_count": { "type": "integer" } }, "required": [ "explicit_rule_count" ], "additionalProperties": false }, "synckhub_server.routes.mail.routing.DeleteFolderRoutingRuleRequest": { "title": "DeleteFolderRoutingRuleRequest", "type": "object", "properties": { "save_kind": { "type": "string" }, "effect": { "type": "string" }, "rule_kind": { "type": "string" }, "signal_value": { "type": "string" } }, "required": [ "save_kind", "effect", "rule_kind", "signal_value" ], "additionalProperties": false }, "synckhub_server.routes.mail.routing.FolderMailRulesResponse": { "title": "FolderMailRulesResponse", "type": "object", "properties": { "repo_id": { "type": "string" }, "parent_folder_id": { "anyOf": [ { "type": "string" }, { "type": "null" } ] }, "explicit_rules": { "type": "array", "items": { "$ref": "#/components/schemas/synckhub_server.routes.mail.routing.FolderMailRule" } }, "automatic_signals": { "type": "array", "items": { "$ref": "#/components/schemas/synckhub_server.routes.mail.routing.FolderMailSignal" } } }, "required": [ "repo_id", "explicit_rules", "automatic_signals" ], "additionalProperties": false }, "synckhub_server.routes.mail.routing.FolderMailRule": { "title": "FolderMailRule", "type": "object", "properties": { "save_kind": { "type": "string" }, "effect": { "type": "string" }, "rule_kind": { "type": "string" }, "signal_value": { "type": "string" }, "updated_at": { "type": "string" } }, "required": [ "save_kind", "effect", "rule_kind", "signal_value", "updated_at" ], "additionalProperties": false }, "synckhub_server.routes.mail.routing.FolderMailSignal": { "title": "FolderMailSignal", "type": "object", "properties": { "save_kind": { "type": "string" }, "signal_kind": { "type": "string" }, "signal_value": { "type": "string" }, "score": { "type": "number" }, "last_updated_at": { "type": "string" } }, "required": [ "save_kind", "signal_kind", "signal_value", "score", "last_updated_at" ], "additionalProperties": false }, "synckhub_server.routes.mail.routing.DeleteRoutingRuleRequest": { "title": "DeleteRoutingRuleRequest", "type": "object", "properties": { "repo_id": { "type": "string" }, "parent_folder_id": { "anyOf": [ { "type": "string" }, { "type": "null" } ] }, "save_kind": { "type": "string" }, "effect": { "type": "string" }, "rule_kind": { "type": "string" } }, "required": [ "repo_id", "save_kind", "effect", "rule_kind" ], "additionalProperties": false }, "synckhub_server.routes.mail.routing.UpsertRoutingRuleRequest": { "title": "UpsertRoutingRuleRequest", "type": "object", "properties": { "repo_id": { "type": "string" }, "parent_folder_id": { "anyOf": [ { "type": "string" }, { "type": "null" } ] }, "save_kind": { "type": "string" }, "effect": { "type": "string" }, "rule_kind": { "type": "string" } }, "required": [ "repo_id", "save_kind", "effect", "rule_kind" ], "additionalProperties": false }, "synckhub_server.routes.mail.routing.AttachmentBatchSaveSuggestionsRequest": { "title": "AttachmentBatchSaveSuggestionsRequest", "type": "object", "properties": { "repo_id": { "type": "string" }, "limit": { "anyOf": [ { "type": "integer", "minimum": 0 }, { "type": "null" } ] }, "thread_id": { "anyOf": [ { "type": "string" }, { "type": "null" } ] }, "subject": { "anyOf": [ { "type": "string" }, { "type": "null" } ] }, "from": { "anyOf": [ { "$ref": "#/components/schemas/synckhub_mailcal.types.EmailAddress" }, { "type": "null" } ] }, "to": { "type": "array", "items": { "$ref": "#/components/schemas/synckhub_mailcal.types.EmailAddress" } }, "cc": { "type": "array", "items": { "$ref": "#/components/schemas/synckhub_mailcal.types.EmailAddress" } }, "attachments": { "type": "array", "items": { "$ref": "#/components/schemas/synckhub_mailcal.types.AttachmentSummary" } } }, "required": [ "repo_id" ], "additionalProperties": false }, "synckhub_server.routes.mail.routing.AttachmentBatchSaveSuggestionsResponse": { "title": "AttachmentBatchSaveSuggestionsResponse", "type": "object", "properties": { "repo_id": { "type": "string" }, "account_id": { "type": "string" }, "message_id": { "type": "string" }, "generated_at": { "type": "string" }, "attachments": { "type": "array", "items": { "$ref": "#/components/schemas/synckhub_server.routes.mail.routing.AttachmentSaveSuggestionsEntry" } } }, "required": [ "repo_id", "account_id", "message_id", "generated_at", "attachments" ], "additionalProperties": false }, "synckhub_server.routes.mail.routing.AttachmentSaveSuggestionsEntry": { "title": "AttachmentSaveSuggestionsEntry", "type": "object", "properties": { "attachment_id": { "type": "string" }, "content_hash_known": { "type": "boolean" }, "content_matches": { "type": "array", "items": { "$ref": "#/components/schemas/synckhub_server.routes.mail.routing.attachment_content.ContentMatch" } }, "existing_attachments": { "type": "array", "items": { "$ref": "#/components/schemas/synckhub_server.routes.mail.routing.ExistingSavedAttachment" } }, "existing_attachment_file_updates": { "type": "array", "items": { "$ref": "#/components/schemas/synckhub_server.routes.mail.routing.ExistingAttachmentFileUpdate" } }, "attachments_only": { "type": "array", "items": { "$ref": "#/components/schemas/synckhub_server.routes.mail.routing.SaveSuggestion" } } }, "required": [ "attachment_id", "content_hash_known", "attachments_only" ], "additionalProperties": false }, "synckhub_server.routes.mail.routing.attachment_content.ContentMatch": { "title": "ContentMatch", "type": "object", "properties": { "item_id": { "type": "string" }, "item_type": { "type": "string" }, "attachment_item_seq": { "anyOf": [ { "type": "integer" }, { "type": "null" } ] }, "name": { "type": "string" }, "parent_folder_id": { "anyOf": [ { "type": "string" }, { "type": "null" } ] }, "folder_name": { "type": "string" }, "folder_path": { "type": "string" } }, "required": [ "item_id", "item_type", "name", "folder_name", "folder_path" ] }, "synckhub_server.routes.mail.routing.ExistingSavedAttachment": { "title": "ExistingSavedAttachment", "type": "object", "properties": { "attachment_id": { "type": "string" }, "file_item_id": { "type": "string" }, "file_name": { "type": "string" }, "parent_folder_id": { "anyOf": [ { "type": "string" }, { "type": "null" } ] }, "folder_name": { "type": "string" }, "folder_path": { "type": "string" } }, "required": [ "attachment_id", "file_item_id", "file_name", "folder_name", "folder_path" ], "additionalProperties": false }, "synckhub_server.routes.mail.routing.ExistingAttachmentFileUpdate": { "title": "ExistingAttachmentFileUpdate", "type": "object", "properties": { "attachment_id": { "type": "string" }, "target_file_item_id": { "type": "string" }, "target_file_name": { "type": "string" }, "content_item_seq": { "type": "integer" }, "named_version_item_seq": { "anyOf": [ { "type": "integer" }, { "type": "null" } ] }, "parent_folder_id": { "anyOf": [ { "type": "string" }, { "type": "null" } ] }, "folder_name": { "type": "string" }, "folder_path": { "type": "string" } }, "required": [ "attachment_id", "target_file_item_id", "target_file_name", "content_item_seq", "folder_name", "folder_path" ], "additionalProperties": false }, "synckhub_server.routes.mail.routing.SaveSuggestion": { "title": "SaveSuggestion", "type": "object", "properties": { "parent_folder_id": { "anyOf": [ { "type": "string" }, { "type": "null" } ] }, "folder_name": { "type": "string" }, "folder_path": { "type": "string" }, "confidence": { "anyOf": [ { "type": "number" }, { "type": "null" } ] }, "reasons": { "type": "array", "items": { "$ref": "#/components/schemas/synckhub_server.routes.mail.routing.SaveSuggestionReason" } }, "attachment_file_resolution": { "anyOf": [ { "$ref": "#/components/schemas/synckhub_server.routes.mail.routing.AttachmentFileResolution" }, { "type": "null" } ] } }, "required": [ "folder_name", "folder_path" ], "additionalProperties": false }, "synckhub_server.routes.mail.routing.SaveSuggestionReason": { "title": "SaveSuggestionReason", "type": "object", "properties": { "code": { "type": "string" }, "detail": { "type": "string" } }, "required": [ "code", "detail" ], "additionalProperties": false }, "synckhub_server.routes.mail.routing.AttachmentFileResolution": { "title": "AttachmentFileResolution", "type": "object", "properties": { "kind": { "type": "string" }, "target_file_item_id": { "type": "string" }, "target_file_name": { "type": "string" } }, "required": [ "kind", "target_file_item_id", "target_file_name" ], "additionalProperties": false }, "synckhub_server.routes.mail.routing.DraftSaveSuggestionsRequestBody": { "title": "DraftSaveSuggestionsRequestBody", "type": "object", "properties": { "to": { "type": "array", "items": { "$ref": "#/components/schemas/synckhub_mailcal.types.EmailAddress" } }, "cc": { "type": "array", "items": { "$ref": "#/components/schemas/synckhub_mailcal.types.EmailAddress" } }, "subject": { "anyOf": [ { "type": "string" }, { "type": "null" } ] } } }, "synckhub_server.routes.mail.routing.SaveSuggestionsResponse": { "title": "SaveSuggestionsResponse", "type": "object", "properties": { "repo_id": { "type": "string" }, "account_id": { "type": "string" }, "message_id": { "type": "string" }, "generated_at": { "type": "string" }, "existing_full_email": { "anyOf": [ { "$ref": "#/components/schemas/synckhub_server.routes.mail.routing.ExistingArchivedEmail" }, { "type": "null" } ] }, "existing_full_emails": { "type": "array", "items": { "$ref": "#/components/schemas/synckhub_server.routes.mail.routing.ExistingArchivedEmail" } }, "existing_attachments": { "type": "array", "items": { "$ref": "#/components/schemas/synckhub_server.routes.mail.routing.ExistingSavedAttachment" } }, "existing_attachment_file_updates": { "type": "array", "items": { "$ref": "#/components/schemas/synckhub_server.routes.mail.routing.ExistingAttachmentFileUpdate" } }, "full_email": { "type": "array", "items": { "$ref": "#/components/schemas/synckhub_server.routes.mail.routing.SaveSuggestion" } }, "attachments_only": { "type": "array", "items": { "$ref": "#/components/schemas/synckhub_server.routes.mail.routing.SaveSuggestion" } } }, "required": [ "repo_id", "account_id", "message_id", "generated_at", "full_email", "attachments_only" ], "additionalProperties": false }, "synckhub_server.routes.mail.sync.SyncUnifiedMailRequest": { "title": "SyncUnifiedMailRequest", "type": "object", "properties": { "account_id": { "type": "array", "items": { "type": "string" } }, "mailbox_id": { "anyOf": [ { "type": "string" }, { "type": "null" } ] }, "page_size": { "anyOf": [ { "type": "integer", "minimum": 0 }, { "type": "null" } ] } }, "additionalProperties": false }, "synckhub_server.routes.mail.sync.SyncUnifiedMailResponse": { "title": "SyncUnifiedMailResponse", "type": "object", "properties": { "message_count": { "type": "integer", "minimum": 0 }, "job_count": { "type": "integer", "minimum": 0 }, "synced_account_count": { "type": "integer", "minimum": 0 }, "failed_account_count": { "type": "integer", "minimum": 0 }, "busy_account_count": { "type": "integer", "minimum": 0 }, "has_more": { "type": "boolean" }, "synced_at": { "type": "string" }, "accounts": { "type": "array", "items": { "$ref": "#/components/schemas/synckhub_server.routes.mail.sync.ManualSyncAccountResult" } }, "read_status": { "$ref": "#/components/schemas/synckhub_server.routes.connected_accounts.read_status.MailcalReadStatus" } }, "required": [ "message_count", "job_count", "synced_account_count", "failed_account_count", "busy_account_count", "has_more", "synced_at", "accounts", "read_status" ], "additionalProperties": false }, "synckhub_server.routes.mail.sync.ManualSyncAccountResult": { "title": "ManualSyncAccountResult", "type": "object", "properties": { "account_id": { "type": "string" }, "job_id": { "anyOf": [ { "type": "string" }, { "type": "null" } ] }, "status": { "type": "string" }, "provider": { "anyOf": [ { "type": "string" }, { "type": "null" } ] }, "email_address": { "anyOf": [ { "type": "string" }, { "type": "null" } ] }, "mailbox_id": { "anyOf": [ { "type": "string" }, { "type": "null" } ] }, "message_count": { "type": "integer", "minimum": 0 }, "has_more": { "type": "boolean" }, "error_code": { "anyOf": [ { "type": "string" }, { "type": "null" } ] }, "error_message": { "anyOf": [ { "type": "string" }, { "type": "null" } ] } }, "required": [ "account_id", "status", "message_count", "has_more" ], "additionalProperties": false }, "synckhub_server.routes.mail.sync.SyncMailboxRequest": { "title": "SyncMailboxRequest", "type": "object", "properties": { "mailbox_id": { "anyOf": [ { "type": "string" }, { "type": "null" } ] }, "page_size": { "anyOf": [ { "type": "integer", "minimum": 0 }, { "type": "null" } ] }, "mode": { "anyOf": [ { "type": "string" }, { "type": "null" } ], "description": "\"repair\" forces the next catch-up to run a full generation sweep by\ndropping the incremental delta cursor. Default catch-up is delta-first." } }, "additionalProperties": false }, "synckhub_server.routes.mail.sync.SyncMailboxResponse": { "title": "SyncMailboxResponse", "type": "object", "properties": { "account_id": { "type": "string" }, "mailbox_id": { "type": "string" }, "job_id": { "anyOf": [ { "type": "string" }, { "type": "null" } ] }, "status": { "type": "string" }, "message_count": { "type": "integer", "minimum": 0 }, "has_more": { "type": "boolean" }, "synced_at": { "type": "string" }, "read_status": { "$ref": "#/components/schemas/synckhub_server.routes.connected_accounts.read_status.MailcalReadStatus" } }, "required": [ "account_id", "mailbox_id", "status", "message_count", "has_more", "synced_at", "read_status" ], "additionalProperties": false }, "synckhub_server.routes.user_runtime.PresenceStatusResponse": { "title": "PresenceStatusResponse", "type": "object", "properties": { "backend": { "type": "string" }, "user_id": { "type": "string" }, "active_focused_foreground": { "type": "boolean" }, "session_count": { "type": "integer", "minimum": 0 }, "sessions": { "type": "array", "items": { "$ref": "#/components/schemas/synckhub_server.routes.user_runtime.PresenceStatusSessionResponse" } } }, "required": [ "backend", "user_id", "active_focused_foreground", "session_count", "sessions" ] }, "synckhub_server.routes.user_runtime.PresenceStatusSessionResponse": { "title": "PresenceStatusSessionResponse", "type": "object", "properties": { "session_id": { "type": "string" }, "device_id": { "type": "string" }, "platform": { "type": "string" }, "app_state": { "type": "string" }, "focused": { "type": "boolean" }, "updated_at_epoch_secs": { "anyOf": [ { "type": "integer" }, { "type": "null" } ] }, "suppress_until_epoch_secs": { "type": "integer" } }, "required": [ "session_id", "device_id", "platform", "app_state", "focused", "suppress_until_epoch_secs" ] }, "synckhub_server.routes.maintenance.BackgroundJobsStatusResponse": { "title": "BackgroundJobsStatusResponse", "type": "object", "properties": { "now": { "type": "string" }, "jobs": { "type": "array", "items": { "$ref": "#/components/schemas/synckhub_server.routes.maintenance.BackgroundJobStatusRow" } }, "summary": { "type": "array", "items": { "$ref": "#/components/schemas/synckhub_server.routes.maintenance.BackgroundJobSummaryRow" } }, "returned": { "type": "integer", "minimum": 0 }, "requested_limit": { "type": "integer" }, "requested_offset": { "type": "integer" }, "total": { "type": "integer", "minimum": 0 }, "has_more": { "type": "boolean" }, "truncated": { "type": "boolean" }, "sources": { "type": "array", "items": { "$ref": "#/components/schemas/synckhub_server.routes.maintenance.BackgroundJobSourceSummary" } }, "worker_config": { "anyOf": [ { "$ref": "#/components/schemas/synckhub_server.routes.maintenance.BackgroundJobsWorkerConfig" }, { "type": "null" } ] } }, "required": [ "now", "jobs", "summary", "returned", "requested_limit", "requested_offset", "total", "has_more", "truncated", "sources" ] }, "synckhub_server.routes.maintenance.BackgroundJobStatusRow": { "title": "BackgroundJobStatusRow", "type": "object", "properties": { "job_id": { "type": "string" }, "kind": { "type": "string" }, "scope": { "type": "string" }, "state": { "type": "string" }, "phase": { "anyOf": [ { "type": "string" }, { "type": "null" } ] }, "progress_current": { "anyOf": [ { "type": "integer" }, { "type": "null" } ] }, "progress_total": { "anyOf": [ { "type": "integer" }, { "type": "null" } ] }, "repo_id": { "anyOf": [ { "type": "string" }, { "type": "null" } ] }, "account_id": { "anyOf": [ { "type": "string" }, { "type": "null" } ] }, "mailbox_id": { "anyOf": [ { "type": "string" }, { "type": "null" } ] }, "principal_id": { "anyOf": [ { "type": "string" }, { "type": "null" } ] }, "requested_by": { "anyOf": [ { "type": "string" }, { "type": "null" } ] }, "requested_at": { "anyOf": [ { "type": "string" }, { "type": "null" } ] }, "started_at": { "anyOf": [ { "type": "string" }, { "type": "null" } ] }, "updated_at": { "anyOf": [ { "type": "string" }, { "type": "null" } ] }, "completed_at": { "anyOf": [ { "type": "string" }, { "type": "null" } ] }, "heartbeat_at": { "anyOf": [ { "type": "string" }, { "type": "null" } ] }, "next_retry_at": { "anyOf": [ { "type": "string" }, { "type": "null" } ] }, "last_error": { "anyOf": [ { "type": "string" }, { "type": "null" } ] }, "details": {} }, "required": [ "job_id", "kind", "scope", "state", "details" ] }, "synckhub_server.routes.maintenance.BackgroundJobSummaryRow": { "title": "BackgroundJobSummaryRow", "type": "object", "properties": { "state": { "type": "string" }, "count": { "type": "integer", "minimum": 0 } }, "required": [ "state", "count" ] }, "synckhub_server.routes.maintenance.BackgroundJobSourceSummary": { "title": "BackgroundJobSourceSummary", "type": "object", "properties": { "source": { "type": "string" }, "returned": { "type": "integer", "minimum": 0 }, "total": { "type": "integer", "minimum": 0 }, "source_limit": { "type": "integer" }, "truncated": { "type": "boolean" } }, "required": [ "source", "returned", "total", "source_limit", "truncated" ] }, "synckhub_server.routes.maintenance.BackgroundJobsWorkerConfig": { "title": "BackgroundJobsWorkerConfig", "type": "object", "properties": { "mailcal_enabled": { "type": "boolean" }, "mailcal": { "$ref": "#/components/schemas/synckhub_server.mailcal_job.MailcalWorkerConfig" } }, "required": [ "mailcal_enabled", "mailcal" ] }, "synckhub_server.mailcal_job.MailcalWorkerConfig": { "title": "MailcalWorkerConfig", "type": "object", "properties": { "projection_workers": { "type": "integer", "minimum": 0 }, "webhook_workers": { "type": "integer", "minimum": 0 }, "body_ingest_workers": { "type": "integer", "minimum": 0 }, "sent_save_workers": { "type": "integer", "minimum": 0 }, "bulk_action_workers": { "type": "integer", "minimum": 0 }, "max_workers_per_pool": { "type": "integer", "minimum": 0 }, "claim_concurrency": { "type": "integer", "minimum": 0 } }, "required": [ "projection_workers", "webhook_workers", "body_ingest_workers", "sent_save_workers", "bulk_action_workers", "max_workers_per_pool", "claim_concurrency" ] }, "synckhub_server.routes.maintenance.RederiveDocumentContentMarkdownRequest": { "title": "RederiveDocumentContentMarkdownRequest", "type": "object", "properties": { "repo_id": { "type": "string" }, "gen_id": { "type": "string" }, "mode": { "$ref": "#/components/schemas/synckhub_server.document_content_rederive_job.DocumentContentRederiveMode" } }, "required": [ "repo_id", "gen_id", "mode" ], "additionalProperties": false }, "synckhub_server.document_content_rederive_job.DocumentContentRederiveMode": { "title": "DocumentContentRederiveMode", "type": "string", "enum": [ "CANARY", "ALL" ] }, "synckhub_server.document_content_rederive_job.DocumentContentRederiveRun": { "title": "DocumentContentRederiveRun", "type": "object", "properties": { "run_id": { "type": "string" }, "repo_id": { "type": "string" }, "gen_id": { "type": "string" }, "state": { "type": "string" }, "mode": { "type": "string" }, "candidate_limit": { "anyOf": [ { "type": "integer" }, { "type": "null" } ] }, "requeued": { "type": "integer" }, "pending": { "type": "integer" }, "in_progress": { "type": "integer" }, "failed": { "type": "integer" }, "quarantined": { "type": "integer" }, "completed": { "type": "integer" }, "requested_by": { "type": "string" }, "last_error": { "anyOf": [ { "type": "string" }, { "type": "null" } ] }, "created_at": { "type": "string" }, "started_at": { "anyOf": [ { "type": "string" }, { "type": "null" } ] }, "completed_at": { "anyOf": [ { "type": "string" }, { "type": "null" } ] } }, "required": [ "run_id", "repo_id", "gen_id", "state", "mode", "requeued", "pending", "in_progress", "failed", "quarantined", "completed", "requested_by", "created_at" ] }, "synckhub_server.routes.maintenance.IndexingDocumentContentStatus": { "title": "IndexingDocumentContentStatus", "type": "object", "properties": { "now": { "type": "string" }, "fulltext": { "$ref": "#/components/schemas/synckhub_server.routes.maintenance.IndexingOutputCoverage" }, "markdown": { "$ref": "#/components/schemas/synckhub_server.routes.maintenance.IndexingMarkdownCoverage" }, "repositories_with_candidates": { "type": "integer" }, "repositories": { "type": "array", "items": { "$ref": "#/components/schemas/synckhub_server.routes.maintenance.IndexingMarkdownRepositoryStatus" } }, "rederivation": { "anyOf": [ { "$ref": "#/components/schemas/synckhub_server.document_content_rederive_job.DocumentContentRederiveRun" }, { "type": "null" } ] } }, "required": [ "now", "fulltext", "markdown", "repositories_with_candidates", "repositories" ] }, "synckhub_server.routes.maintenance.IndexingOutputCoverage": { "title": "IndexingOutputCoverage", "type": "object", "properties": { "total": { "type": "integer" }, "ready": { "type": "integer" }, "pending": { "type": "integer" }, "in_progress_live": { "type": "integer" }, "in_progress_expired": { "type": "integer" }, "failed": { "type": "integer" }, "quarantined": { "type": "integer" }, "skipped": { "type": "integer" } }, "required": [ "total", "ready", "pending", "in_progress_live", "in_progress_expired", "failed", "quarantined", "skipped" ] }, "synckhub_server.routes.maintenance.IndexingMarkdownCoverage": { "title": "IndexingOutputCoverage", "type": "object", "properties": { "missing": { "type": "integer" }, "total": { "type": "integer" }, "ready": { "type": "integer" }, "pending": { "type": "integer" }, "in_progress_live": { "type": "integer" }, "in_progress_expired": { "type": "integer" }, "failed": { "type": "integer" }, "quarantined": { "type": "integer" }, "skipped": { "type": "integer" } }, "required": [ "missing", "total", "ready", "pending", "in_progress_live", "in_progress_expired", "failed", "quarantined", "skipped" ] }, "synckhub_server.routes.maintenance.IndexingMarkdownRepositoryStatus": { "title": "IndexingMarkdownRepositoryStatus", "type": "object", "properties": { "repo_id": { "type": "string" }, "gen_id": { "type": "string" }, "generation_state": { "type": "string" }, "candidates": { "type": "integer" }, "pending": { "type": "integer" }, "in_progress": { "type": "integer" }, "failed": { "type": "integer" }, "quarantined": { "type": "integer" } }, "required": [ "repo_id", "gen_id", "generation_state", "candidates", "pending", "in_progress", "failed", "quarantined" ] }, "synckhub_server.routes.maintenance.UpdateIndexingRuntimeControlsRequest": { "title": "UpdateIndexingRuntimeControlsRequest", "type": "object", "properties": { "reason": { "anyOf": [ { "type": "string" }, { "type": "null" } ] }, "markdown_output_enabled": { "anyOf": [ { "type": "boolean" }, { "type": "null" } ] }, "pipelines": { "type": "array", "items": { "$ref": "#/components/schemas/synckhub_server.routes.maintenance.IndexingRuntimePipelinePatch" } } }, "additionalProperties": false }, "synckhub_server.routes.maintenance.IndexingRuntimePipelinePatch": { "title": "IndexingRuntimePipelinePatch", "type": "object", "properties": { "pipeline": { "type": "string" }, "enabled": { "anyOf": [ { "type": "boolean" }, { "type": "null" } ] }, "claim_limit": { "anyOf": [ { "anyOf": [ { "type": "integer" }, { "type": "null" } ] }, { "type": "null" } ] }, "lease_seconds": { "anyOf": [ { "anyOf": [ { "type": "integer" }, { "type": "null" } ] }, { "type": "null" } ] }, "idle_sleep_ms": { "anyOf": [ { "anyOf": [ { "type": "integer" }, { "type": "null" } ] }, { "type": "null" } ] }, "max_extraction_concurrency": { "anyOf": [ { "anyOf": [ { "type": "integer" }, { "type": "null" } ] }, { "type": "null" } ] }, "max_meili_batch_docs": { "anyOf": [ { "anyOf": [ { "type": "integer" }, { "type": "null" } ] }, { "type": "null" } ] }, "max_meili_batch_bytes": { "anyOf": [ { "anyOf": [ { "type": "integer" }, { "type": "null" } ] }, { "type": "null" } ] }, "max_meili_inflight_tasks": { "anyOf": [ { "anyOf": [ { "type": "integer" }, { "type": "null" } ] }, { "type": "null" } ] } }, "required": [ "pipeline" ], "additionalProperties": false }, "synckhub_server.routes.maintenance.IndexingRuntimeControlsStatus": { "title": "IndexingRuntimeControlsStatus", "type": "object", "properties": { "now": { "type": "string" }, "global_pause": { "$ref": "#/components/schemas/synckhub_server.routes.maintenance.IndexingPauseStatus" }, "warnings": { "type": "array", "items": { "$ref": "#/components/schemas/synckhub_server.routes.maintenance.IndexingRuntimeWarning" } }, "pipelines": { "type": "array", "items": { "$ref": "#/components/schemas/synckhub_server.routes.maintenance.IndexingRuntimePipelineStatus" } }, "markdown_output": { "$ref": "#/components/schemas/synckhub_server.routes.maintenance.IndexingMarkdownOutputStatus" }, "quarantined_watermark_blockers": { "type": "array", "items": { "$ref": "#/components/schemas/synckhub_server.routes.maintenance.IndexingQuarantinedWatermarkBlocker" } } }, "required": [ "now", "global_pause", "warnings", "pipelines", "markdown_output", "quarantined_watermark_blockers" ] }, "synckhub_server.routes.maintenance.IndexingPauseStatus": { "title": "IndexingPauseStatus", "type": "object", "properties": { "paused": { "type": "boolean" }, "paused_until": { "anyOf": [ { "type": "string" }, { "type": "null" } ] }, "remaining_seconds": { "anyOf": [ { "type": "integer", "minimum": 0 }, { "type": "null" } ] }, "reason": { "anyOf": [ { "type": "string" }, { "type": "null" } ] } }, "required": [ "paused" ] }, "synckhub_server.routes.maintenance.IndexingRuntimeWarning": { "title": "IndexingRuntimeWarning", "type": "object", "properties": { "code": { "type": "string" }, "severity": { "type": "string" }, "message": { "type": "string" } }, "required": [ "code", "severity", "message" ] }, "synckhub_server.routes.maintenance.IndexingRuntimePipelineStatus": { "title": "IndexingRuntimePipelineStatus", "type": "object", "properties": { "pipeline": { "type": "string" }, "enabled": { "type": "boolean" }, "claim_limit": { "anyOf": [ { "type": "integer" }, { "type": "null" } ] }, "lease_seconds": { "anyOf": [ { "type": "integer" }, { "type": "null" } ] }, "idle_sleep_ms": { "anyOf": [ { "type": "integer" }, { "type": "null" } ] }, "max_extraction_concurrency": { "anyOf": [ { "type": "integer" }, { "type": "null" } ] }, "max_meili_batch_docs": { "anyOf": [ { "type": "integer" }, { "type": "null" } ] }, "max_meili_batch_bytes": { "anyOf": [ { "type": "integer" }, { "type": "null" } ] }, "max_meili_inflight_tasks": { "anyOf": [ { "type": "integer" }, { "type": "null" } ] }, "queue": { "$ref": "#/components/schemas/synckhub_server.routes.maintenance.IndexingRuntimeQueueCounts" }, "warnings": { "type": "array", "items": { "$ref": "#/components/schemas/synckhub_server.routes.maintenance.IndexingRuntimeWarning" } }, "updated_at": { "type": "string" }, "updated_by": { "type": "string" }, "update_reason": { "anyOf": [ { "type": "string" }, { "type": "null" } ] } }, "required": [ "pipeline", "enabled", "queue", "warnings", "updated_at", "updated_by" ] }, "synckhub_server.routes.maintenance.IndexingRuntimeQueueCounts": { "title": "IndexingRuntimeQueueCounts", "type": "object", "properties": { "pending": { "type": "integer" }, "in_progress": { "type": "integer" }, "in_progress_live": { "type": "integer" }, "in_progress_expired": { "type": "integer" }, "ok": { "type": "integer" }, "skipped": { "type": "integer" }, "failed": { "type": "integer" }, "quarantined": { "type": "integer" } }, "required": [ "pending", "in_progress", "in_progress_live", "in_progress_expired", "ok", "skipped", "failed", "quarantined" ] }, "synckhub_server.routes.maintenance.IndexingMarkdownOutputStatus": { "title": "IndexingMarkdownOutputStatus", "type": "object", "properties": { "enabled": { "type": "boolean" }, "updated_at": { "type": "string" }, "updated_by": { "type": "string" }, "update_reason": { "anyOf": [ { "type": "string" }, { "type": "null" } ] } }, "required": [ "enabled", "updated_at", "updated_by" ] }, "synckhub_server.routes.maintenance.IndexingQuarantinedWatermarkBlocker": { "title": "IndexingQuarantinedWatermarkBlocker", "type": "object", "properties": { "pipeline": { "type": "string" }, "repo_id": { "type": "string" }, "gen_id": { "anyOf": [ { "type": "string" }, { "type": "null" } ] }, "applied_repo_seq": { "type": "integer" }, "first_quarantined_repo_seq": { "type": "integer" }, "quarantined_count": { "type": "integer" }, "oldest_quarantined_at": { "type": "string" } }, "required": [ "pipeline", "repo_id", "applied_repo_seq", "first_quarantined_repo_seq", "quarantined_count", "oldest_quarantined_at" ] }, "synckhub_server.routes.maintenance.PauseIndexingRequest": { "title": "PauseIndexingRequest", "type": "object", "properties": { "seconds": { "type": "integer", "minimum": 0 }, "reason": { "anyOf": [ { "type": "string" }, { "type": "null" } ] } }, "required": [ "seconds" ] }, "synckhub_server.routes.maintenance.GcTombstonedByAgeRequest": { "title": "GcTombstonedByAgeRequest", "type": "object", "properties": { "tombstoned_before": { "type": "string" } }, "required": [ "tombstoned_before" ], "description": "Body for GC of tombstoned items by age." }, "synckhub_core.types.GcSummary": { "title": "GcSummary", "type": "object", "properties": { "repo_id": { "type": "string", "description": "Repository where GC was executed." }, "items_deleted": { "type": "integer", "minimum": 0, "description": "Number of items deleted from `platform_items`." }, "subitems_deleted": { "type": "integer", "minimum": 0, "description": "Number of subitem rows deleted from all subitem projection tables." } }, "required": [ "repo_id", "items_deleted", "subitems_deleted" ], "description": "Summary of a GC operation over projection tables." }, "synckhub_server.routes.maintenance.TombstoneTrashedByAgeRequest": { "title": "TombstoneTrashedByAgeRequest", "type": "object", "properties": { "trashed_before": { "type": "string" } }, "required": [ "trashed_before" ], "additionalProperties": false }, "synckhub_server.routes.naming.ItemNamingSuggestionsRequest": { "title": "ItemNamingSuggestionsRequest", "type": "object", "properties": { "action_kind": { "type": "string" }, "item_ids": { "type": "array", "items": { "type": "string" } }, "source": { "$ref": "#/components/schemas/synckhub_server.routes.naming.ItemNamingSuggestionSource" } }, "required": [ "action_kind", "item_ids", "source" ], "additionalProperties": false }, "synckhub_server.routes.naming.ItemNamingSuggestionSource": { "title": "ItemNamingSuggestionSource", "oneOf": [ { "type": "object", "properties": { "kind": { "const": "PRESET" }, "preset_key": { "type": "string" } }, "required": [ "kind", "preset_key" ], "additionalProperties": false }, { "type": "object", "properties": { "kind": { "const": "PERSONAL_LAYOUT" }, "item_subtype": { "type": "string" }, "segments": { "type": "array", "items": { "$ref": "#/components/schemas/synckhub_server.naming_presets.AttachmentNamingSegment" } } }, "required": [ "kind", "item_subtype", "segments" ], "additionalProperties": false } ] }, "synckhub_server.naming_presets.AttachmentNamingSegment": { "title": "AttachmentNamingSegment", "oneOf": [ { "type": "object", "properties": { "kind": { "const": "builtin" }, "token": { "type": "string" } }, "required": [ "kind", "token" ], "additionalProperties": false }, { "type": "object", "properties": { "kind": { "const": "metadata" }, "field_key": { "type": "string" } }, "required": [ "kind", "field_key" ], "additionalProperties": false }, { "type": "object", "properties": { "kind": { "const": "literal" }, "value": { "type": "string" } }, "required": [ "kind", "value" ], "additionalProperties": false } ] }, "synckhub_server.routes.naming.ItemNamingSuggestionsResponse": { "title": "ItemNamingSuggestionsResponse", "type": "object", "properties": { "repo_id": { "type": "string" }, "action_kind": { "type": "string" }, "entries": { "type": "array", "items": { "$ref": "#/components/schemas/synckhub_server.routes.naming.ItemNamingSuggestionEntry" } } }, "required": [ "repo_id", "action_kind", "entries" ], "additionalProperties": false }, "synckhub_server.routes.naming.ItemNamingSuggestionEntry": { "title": "ItemNamingSuggestionEntry", "type": "object", "properties": { "item_id": { "type": "string" }, "item_subtype": { "anyOf": [ { "type": "string" }, { "type": "null" } ] }, "status": { "type": "string" }, "name": { "anyOf": [ { "type": "string" }, { "type": "null" } ] }, "reason": { "anyOf": [ { "type": "string" }, { "type": "null" } ] }, "missing_parameters": { "type": "array", "items": { "type": "string" } } }, "required": [ "item_id", "status" ], "additionalProperties": false }, "synckhub_server.routes.naming.NamingSuggestionsRequest": { "title": "NamingSuggestionsRequest", "type": "object", "properties": { "action_kind": { "type": "string" }, "target_item_type": { "anyOf": [ { "type": "string" }, { "type": "null" } ] }, "item_subtype": { "anyOf": [ { "type": "string" }, { "type": "null" } ] }, "parent_folder_id": { "anyOf": [ { "type": "string" }, { "type": "null" } ] }, "original_name": { "anyOf": [ { "type": "string" }, { "type": "null" } ] }, "extension": { "anyOf": [ { "type": "string" }, { "type": "null" } ] }, "context": { "type": "object", "additionalProperties": { "type": "string" } }, "limit": { "anyOf": [ { "type": "integer", "minimum": 0 }, { "type": "null" } ] } }, "required": [ "action_kind" ], "additionalProperties": false }, "synckhub_server.routes.naming.NamingSuggestionsResponse": { "title": "NamingSuggestionsResponse", "type": "object", "properties": { "repo_id": { "type": "string" }, "action_kind": { "type": "string" }, "suggestions": { "type": "array", "items": { "$ref": "#/components/schemas/synckhub_server.routes.naming.NamingSuggestionEntry" } } }, "required": [ "repo_id", "action_kind", "suggestions" ], "additionalProperties": false }, "synckhub_server.routes.naming.NamingSuggestionEntry": { "title": "NamingSuggestionEntry", "type": "object", "properties": { "preset_key": { "type": "string" }, "display_name": { "type": "string" }, "template": { "type": "string" }, "status": { "type": "string" }, "name": { "anyOf": [ { "type": "string" }, { "type": "null" } ] }, "available": { "type": "boolean" }, "first_available_name": { "anyOf": [ { "type": "string" }, { "type": "null" } ] }, "reason": { "anyOf": [ { "type": "string" }, { "type": "null" } ] }, "missing_parameters": { "type": "array", "items": { "type": "string" } } }, "required": [ "preset_key", "display_name", "template", "status", "available" ], "additionalProperties": false }, "synckhub_server.routes.naming.PutNamingPresetRequest": { "title": "PutNamingPresetRequest", "type": "object", "properties": { "display_name": { "type": "string" }, "template": { "type": "string" }, "enabled": { "type": "boolean" }, "sort_order": { "type": "integer" }, "actions": { "type": "array", "items": { "$ref": "#/components/schemas/synckhub_server.naming_presets.NamingPresetAction" } } }, "required": [ "display_name", "template", "actions" ], "additionalProperties": false }, "synckhub_server.naming_presets.NamingPresetAction": { "title": "NamingPresetAction", "type": "object", "properties": { "action_kind": { "type": "string" }, "target_item_type": { "type": "string" }, "item_subtype": { "type": "string" } }, "required": [ "action_kind" ], "additionalProperties": false }, "synckhub_server.naming_presets.NamingPreset": { "title": "NamingPreset", "type": "object", "properties": { "preset_id": { "type": "string" }, "repo_id": { "type": "string" }, "preset_key": { "type": "string" }, "display_name": { "type": "string" }, "template": { "type": "string" }, "enabled": { "type": "boolean" }, "sort_order": { "type": "integer" }, "actions": { "type": "array", "items": { "$ref": "#/components/schemas/synckhub_server.naming_presets.NamingPresetAction" } }, "created_at": { "type": "string" }, "created_by": { "type": "string" }, "updated_at": { "type": "string" }, "updated_by": { "type": "string" } }, "required": [ "preset_id", "repo_id", "preset_key", "display_name", "template", "enabled", "sort_order", "actions", "created_at", "created_by", "updated_at", "updated_by" ], "additionalProperties": false }, "synckhub_server.routes.naming.NamingPresetsResponse": { "title": "NamingPresetsResponse", "type": "object", "properties": { "repo_id": { "type": "string" }, "presets": { "type": "array", "items": { "$ref": "#/components/schemas/synckhub_server.naming_presets.NamingPreset" } } }, "required": [ "repo_id", "presets" ], "additionalProperties": false }, "synckhub_core.native_calendars.commands.Respond": { "title": "Respond", "type": "object", "properties": { "occurrence_start": { "anyOf": [ { "type": "string", "format": "date-time" }, { "type": "null" } ] }, "command_id": { "type": "string", "format": "uuid" }, "invitation_generation": { "type": "integer", "minimum": 0 }, "expected_response_revision": { "type": "integer", "minimum": 0 }, "response": { "$ref": "#/components/schemas/synckhub_core.native_calendars.Response" } }, "required": [ "command_id", "invitation_generation", "expected_response_revision", "response" ], "additionalProperties": false }, "synckhub_core_postgres.service.native_calendars.commands.CommandReceipt": { "title": "CommandReceipt", "type": "object", "properties": { "item_id": { "type": "string" }, "version": { "type": "integer" }, "linked_item_id": { "anyOf": [ { "type": "string" }, { "type": "null" } ] }, "linked_version": { "anyOf": [ { "type": "integer" }, { "type": "null" } ] }, "commit_id": { "type": "string" }, "accepted_at": { "type": "string", "format": "date-time" } }, "required": [ "item_id", "version", "commit_id", "accepted_at" ] }, "synckhub_core.external_scheduling.state.ReviewExternal": { "title": "ReviewExternal", "type": "object", "properties": { "command_id": { "type": "string", "format": "uuid" }, "expected_version": { "type": "integer" }, "mailbox_id": { "type": "string", "format": "uuid" }, "invitation_id": { "type": "string", "format": "uuid" }, "time_zone": { "type": "string" }, "decision": { "$ref": "#/components/schemas/synckhub_core.external_scheduling.state.ExternalReviewDecision" } }, "required": [ "command_id", "expected_version", "mailbox_id", "invitation_id", "time_zone", "decision" ], "additionalProperties": false }, "synckhub_core.external_scheduling.state.ExternalReviewDecision": { "title": "ExternalReviewDecision", "type": "string", "enum": [ "APPLY", "ACCEPT", "REJECT" ] }, "synckhub_core.external_scheduling.state.RespondExternal": { "title": "RespondExternal", "type": "object", "properties": { "command_id": { "type": "string", "format": "uuid" }, "expected_version": { "type": "integer" }, "response": { "$ref": "#/components/schemas/synckhub_core.native_calendars.Response" } }, "required": [ "command_id", "expected_version", "response" ], "additionalProperties": false }, "synckhub_core.external_scheduling.state.ConfigureExternal": { "title": "ConfigureExternal", "type": "object", "properties": { "command_id": { "type": "string", "format": "uuid" }, "expected_version": { "type": "integer" }, "mailbox_id": { "type": "string", "format": "uuid" }, "attendees": { "type": "array", "items": { "type": "string" } } }, "required": [ "command_id", "expected_version", "mailbox_id", "attendees" ], "additionalProperties": false }, "synckhub_core.native_calendars.commands.CancelEvent": { "title": "CancelEvent", "type": "object", "properties": { "following_start": { "anyOf": [ { "type": "string", "format": "date-time" }, { "type": "null" } ] }, "command_id": { "type": "string", "format": "uuid" }, "expected_version": { "type": "integer" }, "occurrence_start": { "anyOf": [ { "type": "string", "format": "date-time" }, { "type": "null" } ] } }, "required": [ "command_id", "expected_version" ], "additionalProperties": false }, "synckhub_core.native_calendars.commands.EditEvent": { "title": "EditEvent", "type": "object", "properties": { "event_type_id": { "anyOf": [ { "anyOf": [ { "type": "string", "format": "uuid" }, { "type": "null" } ] }, { "type": "null" } ] }, "following_start": { "anyOf": [ { "type": "string", "format": "date-time" }, { "type": "null" } ] }, "occurrence_start": { "anyOf": [ { "type": "string", "format": "date-time" }, { "type": "null" } ] }, "recurrence": { "anyOf": [ { "anyOf": [ { "$ref": "#/components/schemas/synckhub_core.native_calendars.recurrence.Recurrence" }, { "type": "null" } ] }, { "type": "null" } ] }, "command_id": { "type": "string", "format": "uuid" }, "expected_version": { "type": "integer" }, "title": { "anyOf": [ { "type": "string" }, { "type": "null" } ] }, "time": { "anyOf": [ { "$ref": "#/components/schemas/synckhub_core.native_calendars.EventTimeInput" }, { "type": "null" } ] }, "description": { "anyOf": [ { "type": "string" }, { "type": "null" } ] }, "case_item_id": { "anyOf": [ { "anyOf": [ { "type": "string" }, { "type": "null" } ] }, { "type": "null" } ] }, "attachment_item_ids": { "anyOf": [ { "type": "array", "items": { "type": "string" } }, { "type": "null" } ] }, "location": { "anyOf": [ { "anyOf": [ { "type": "string" }, { "type": "null" } ] }, { "type": "null" } ] }, "meeting_url": { "anyOf": [ { "anyOf": [ { "type": "string" }, { "type": "null" } ] }, { "type": "null" } ] }, "attendees": { "anyOf": [ { "type": "array", "items": { "$ref": "#/components/schemas/synckhub_core.native_calendars.AttendeeInput" } }, { "type": "null" } ] }, "reminder_offsets_minutes_before_start": { "anyOf": [ { "type": "array", "items": { "type": "integer", "minimum": 0 } }, { "type": "null" } ] } }, "required": [ "command_id", "expected_version" ], "additionalProperties": false }, "synckhub_core.native_calendars.recurrence.Recurrence": { "title": "Recurrence", "type": "object", "properties": { "rule": { "type": "string" }, "rdates": { "type": "array", "items": { "type": "string", "format": "date-time" } }, "exdates": { "type": "array", "items": { "type": "string", "format": "date-time" } }, "timezone": { "anyOf": [ { "$ref": "#/components/schemas/synckhub_core.native_calendars.recurrence.TimezoneDefinition" }, { "type": "null" } ] } }, "required": [ "rule" ], "additionalProperties": false }, "synckhub_core.native_calendars.recurrence.TimezoneDefinition": { "title": "TimezoneDefinition", "type": "object", "properties": { "name": { "type": "string" }, "observances": { "type": "array", "items": { "$ref": "#/components/schemas/synckhub_core.native_calendars.recurrence.Observance" } } }, "required": [ "name", "observances" ], "additionalProperties": false, "description": "Preserved VTIMEZONE observances. The scheduling codec owns ICS syntax;\nthis model owns the transition semantics used to resolve occurrences." }, "synckhub_core.native_calendars.recurrence.Observance": { "title": "Observance", "type": "object", "properties": { "start": { "type": "string", "format": "date-time" }, "offset_from": { "type": "integer" }, "offset_to": { "type": "integer" }, "rule": { "anyOf": [ { "type": "string" }, { "type": "null" } ] }, "rdates": { "type": "array", "items": { "type": "string", "format": "date-time" } } }, "required": [ "start", "offset_from", "offset_to" ], "additionalProperties": false }, "synckhub_core.native_calendars.EventTimeInput": { "title": "EventTimeInput", "oneOf": [ { "type": "object", "properties": { "kind": { "const": "TIMED" }, "start": { "type": "string", "format": "date-time" }, "end": { "type": "string", "format": "date-time" }, "time_zone": { "type": "string" } }, "required": [ "kind", "start", "end", "time_zone" ], "additionalProperties": false }, { "type": "object", "properties": { "kind": { "const": "ALL_DAY" }, "start_date": { "type": "string", "format": "date" }, "end_date": { "type": "string", "format": "date" }, "time_zone": { "type": "string" } }, "required": [ "kind", "start_date", "end_date", "time_zone" ], "additionalProperties": false } ], "description": "The write shape retains offsets until their consistency with the zone is\nchecked. Canonical state and responses use UTC instants." }, "synckhub_core.native_calendars.AttendeeInput": { "title": "AttendeeInput", "type": "object", "properties": { "user_id": { "type": "string" }, "role": { "$ref": "#/components/schemas/synckhub_core.native_calendars.AttendeeRole" } }, "required": [ "user_id", "role" ], "additionalProperties": false }, "synckhub_core.native_calendars.AttendeeRole": { "title": "AttendeeRole", "type": "string", "enum": [ "REQUIRED", "OPTIONAL" ] }, "synckhub_core.native_calendars.commands.CreateEvent": { "title": "CreateEvent", "type": "object", "properties": { "event_type_id": { "anyOf": [ { "type": "string", "format": "uuid" }, { "type": "null" } ] }, "recurrence": { "anyOf": [ { "$ref": "#/components/schemas/synckhub_core.native_calendars.recurrence.Recurrence" }, { "type": "null" } ] }, "command_id": { "type": "string", "format": "uuid" }, "title": { "type": "string" }, "time": { "$ref": "#/components/schemas/synckhub_core.native_calendars.EventTimeInput" }, "description": { "type": "string" }, "case_item_id": { "anyOf": [ { "type": "string" }, { "type": "null" } ] }, "attachment_item_ids": { "type": "array", "items": { "type": "string" } }, "location": { "anyOf": [ { "type": "string" }, { "type": "null" } ] }, "meeting_url": { "anyOf": [ { "type": "string" }, { "type": "null" } ] }, "attendees": { "type": "array", "items": { "$ref": "#/components/schemas/synckhub_core.native_calendars.AttendeeInput" } }, "reminder_offsets_minutes_before_start": { "type": "array", "items": { "type": "integer", "minimum": 0 } }, "private": { "type": "boolean" }, "invitation_mailbox_id": { "anyOf": [ { "type": "string", "format": "uuid" }, { "type": "null" } ], "description": "Explicit organizer-owned native mailbox used for ordinary internal\ninvitation email. Omission keeps internal delivery in-app only." }, "external_invitations": { "anyOf": [ { "$ref": "#/components/schemas/synckhub_core.external_scheduling.state.CreateExternalInvitations" }, { "type": "null" } ] } }, "required": [ "command_id", "title", "time" ], "additionalProperties": false }, "synckhub_core.external_scheduling.state.CreateExternalInvitations": { "title": "CreateExternalInvitations", "type": "object", "properties": { "mailbox_id": { "type": "string", "format": "uuid" }, "attendees": { "type": "array", "items": { "type": "string" } } }, "required": [ "mailbox_id", "attendees" ], "additionalProperties": false, "description": "External recipients selected while creating a native event. The enclosing\ncreate command owns idempotency; this value only identifies the sender and\nexact initial recipient set." }, "synckhub_core.native_calendars.commands.VersionedCommand": { "title": "VersionedCommand", "type": "object", "properties": { "command_id": { "type": "string", "format": "uuid" }, "expected_version": { "type": "integer" } }, "required": [ "command_id", "expected_version" ], "additionalProperties": false }, "synckhub_core.native_calendars.commands.EditCalendar": { "title": "EditCalendar", "type": "object", "properties": { "command_id": { "type": "string", "format": "uuid" }, "expected_version": { "type": "integer" }, "title": { "anyOf": [ { "type": "string" }, { "type": "null" } ] }, "color": { "anyOf": [ { "type": "string" }, { "type": "null" } ] }, "description": { "anyOf": [ { "anyOf": [ { "type": "string" }, { "type": "null" } ] }, { "type": "null" } ] } }, "required": [ "command_id", "expected_version" ], "additionalProperties": false }, "synckhub_core.native_calendars.commands.CreateCalendar": { "title": "CreateCalendar", "type": "object", "properties": { "command_id": { "type": "string", "format": "uuid" }, "title": { "type": "string" }, "color": { "type": "string" }, "description": { "anyOf": [ { "type": "string" }, { "type": "null" } ] }, "private": { "type": "boolean" } }, "required": [ "command_id", "title", "color" ], "additionalProperties": false }, "synckhub_server.routes.native_calendars.agenda.Page": { "title": "Page", "type": "object", "properties": { "items": { "type": "array", "items": { "$ref": "#/components/schemas/synckhub_server.routes.native_calendars.agenda.Entry" } }, "next_cursor": { "anyOf": [ { "type": "string" }, { "type": "null" } ] } }, "required": [ "items" ] }, "synckhub_server.routes.native_calendars.agenda.Entry": { "title": "Entry", "type": "object", "properties": { "repo_id": { "type": "string" }, "item_id": { "type": "string" }, "occurrence_start": { "anyOf": [ { "type": "string", "format": "date-time" }, { "type": "null" } ] }, "version": { "type": "integer" }, "title": { "type": "string" }, "time": { "$ref": "#/components/schemas/synckhub_core.native_calendars.EventTime" }, "response": { "anyOf": [ { "$ref": "#/components/schemas/synckhub_core.native_calendars.Response" }, { "type": "null" } ] }, "busy_status": { "type": "string" } }, "required": [ "repo_id", "item_id", "version", "title", "time", "busy_status" ] }, "synckhub_core.native_calendars.EventTime": { "title": "EventTime", "oneOf": [ { "type": "object", "properties": { "kind": { "const": "TIMED" }, "start": { "type": "string", "format": "date-time" }, "end": { "type": "string", "format": "date-time" }, "time_zone": { "type": "string" } }, "required": [ "kind", "start", "end", "time_zone" ], "additionalProperties": false }, { "type": "object", "properties": { "kind": { "const": "ALL_DAY" }, "start_date": { "type": "string", "format": "date" }, "end_date": { "type": "string", "format": "date" }, "time_zone": { "type": "string" } }, "required": [ "kind", "start_date", "end_date", "time_zone" ], "additionalProperties": false } ] }, "synckhub_server.routes.native_calendars.attention.SeenInput": { "title": "SeenInput", "type": "object", "properties": { "seen_item_version": { "type": "integer" } }, "required": [ "seen_item_version" ], "additionalProperties": false }, "synckhub_server.routes.native_calendars.attention.SeenResponse": { "title": "SeenResponse", "type": "object", "properties": { "seen_item_version": { "type": "integer" } }, "required": [ "seen_item_version" ] }, "synckhub_server.routes.native_calendars.attention.AttentionPage": { "title": "AttentionPage", "type": "object", "properties": { "items": { "type": "array", "items": { "$ref": "#/components/schemas/synckhub_server.routes.native_calendars.attention.AttentionEvent" } }, "next_cursor": { "anyOf": [ { "type": "string" }, { "type": "null" } ] } }, "required": [ "items" ] }, "synckhub_server.routes.native_calendars.attention.AttentionEvent": { "title": "EventSummary", "type": "object", "properties": { "pending_invitation": { "type": "boolean" }, "unreviewed": { "type": "boolean" }, "activity_item_version": { "type": "integer" }, "seen_item_version": { "type": "integer" }, "response": { "anyOf": [ { "type": "string" }, { "type": "null" } ] }, "invitation_generation": { "anyOf": [ { "type": "integer" }, { "type": "null" } ] }, "response_revision": { "anyOf": [ { "type": "integer" }, { "type": "null" } ] }, "event_type_id": { "anyOf": [ { "type": "string", "format": "uuid" }, { "type": "null" } ] }, "event_type": { "anyOf": [ { "$ref": "#/components/schemas/synckhub_core_postgres.service.native_calendars.event_types.EventType" }, { "type": "null" } ] }, "item_id": { "type": "string" }, "occurrence_start": { "anyOf": [ { "type": "string", "format": "date-time" }, { "type": "null" } ] }, "version": { "type": "integer" }, "title": { "type": "string" }, "organizer_user_id": { "type": "string" }, "organizer_address": { "anyOf": [ { "type": "string" }, { "type": "null" } ] }, "time": { "$ref": "#/components/schemas/synckhub_core.native_calendars.EventTime" }, "state": { "$ref": "#/components/schemas/synckhub_core.native_calendars.EventState" }, "calendar_item_id": { "type": "string" }, "calendar": { "anyOf": [ { "$ref": "#/components/schemas/synckhub_server.routes.native_calendars.read.CalendarLabel" }, { "type": "null" } ] }, "case": { "anyOf": [ { "$ref": "#/components/schemas/synckhub_server.routes.native_calendars.read.RelatedCase" }, { "type": "null" } ] }, "private": { "type": "boolean" }, "allowed_actions": { "type": "array", "items": { "type": "string" } } }, "required": [ "pending_invitation", "unreviewed", "activity_item_version", "seen_item_version", "item_id", "version", "title", "organizer_user_id", "time", "state", "calendar_item_id", "private", "allowed_actions" ] }, "synckhub_server.routes.native_calendars.lists.EventSummary": { "title": "EventSummary", "type": "object", "properties": { "event_type_id": { "anyOf": [ { "type": "string", "format": "uuid" }, { "type": "null" } ] }, "event_type": { "anyOf": [ { "$ref": "#/components/schemas/synckhub_core_postgres.service.native_calendars.event_types.EventType" }, { "type": "null" } ] }, "item_id": { "type": "string" }, "occurrence_start": { "anyOf": [ { "type": "string", "format": "date-time" }, { "type": "null" } ] }, "version": { "type": "integer" }, "title": { "type": "string" }, "organizer_user_id": { "type": "string" }, "organizer_address": { "anyOf": [ { "type": "string" }, { "type": "null" } ] }, "time": { "$ref": "#/components/schemas/synckhub_core.native_calendars.EventTime" }, "state": { "$ref": "#/components/schemas/synckhub_core.native_calendars.EventState" }, "calendar_item_id": { "type": "string" }, "calendar": { "anyOf": [ { "$ref": "#/components/schemas/synckhub_server.routes.native_calendars.read.CalendarLabel" }, { "type": "null" } ] }, "case": { "anyOf": [ { "$ref": "#/components/schemas/synckhub_server.routes.native_calendars.read.RelatedCase" }, { "type": "null" } ] }, "private": { "type": "boolean" }, "allowed_actions": { "type": "array", "items": { "type": "string" } } }, "required": [ "item_id", "version", "title", "organizer_user_id", "time", "state", "calendar_item_id", "private", "allowed_actions" ] }, "synckhub_core_postgres.service.native_calendars.event_types.EventType": { "title": "EventType", "type": "object", "properties": { "id": { "type": "string", "format": "uuid" }, "name": { "type": "string" }, "active": { "type": "boolean" }, "version": { "type": "integer" } }, "required": [ "id", "name", "active", "version" ] }, "synckhub_core.native_calendars.EventState": { "title": "EventState", "type": "string", "enum": [ "SCHEDULED", "CANCELED" ] }, "synckhub_server.routes.native_calendars.read.CalendarLabel": { "title": "CalendarLabel", "type": "object", "properties": { "item_id": { "type": "string" }, "title": { "type": "string" }, "color": { "type": "string" }, "archived": { "type": "boolean" } }, "required": [ "item_id", "title", "color", "archived" ] }, "synckhub_server.routes.native_calendars.read.RelatedCase": { "title": "RelatedCase", "type": "object", "properties": { "item_id": { "type": "string" }, "title": { "type": "string" } }, "required": [ "item_id", "title" ] }, "synckhub_server.routes.native_calendars.availability.RequestRange": { "title": "RequestRange", "type": "object", "properties": { "start": { "type": "string", "format": "date-time" }, "end": { "type": "string", "format": "date-time" }, "user_ids": { "type": "array", "items": { "type": "string" } }, "duration_minutes": { "type": "integer", "minimum": 0 } }, "required": [ "start", "end", "user_ids", "duration_minutes" ], "additionalProperties": false }, "synckhub_server.routes.native_calendars.availability.Availability": { "title": "Availability", "type": "object", "properties": { "people": { "type": "array", "items": { "$ref": "#/components/schemas/synckhub_server.routes.native_calendars.availability.Person" } }, "suggestions": { "type": "array", "items": { "$ref": "#/components/schemas/synckhub_server.routes.native_calendars.availability.Slot" } } }, "required": [ "people", "suggestions" ] }, "synckhub_server.routes.native_calendars.availability.Person": { "title": "Person", "type": "object", "properties": { "user_id": { "type": "string" }, "source": { "type": "string" }, "complete": { "type": "boolean" }, "intervals": { "type": "array", "items": { "$ref": "#/components/schemas/synckhub_server.routes.native_calendars.availability.Interval" } }, "time_zone": { "anyOf": [ { "type": "string" }, { "type": "null" } ] }, "working_days": { "anyOf": [ { "type": "array", "items": { "type": "integer" } }, { "type": "null" } ] }, "start_minute": { "anyOf": [ { "type": "integer" }, { "type": "null" } ] }, "end_minute": { "anyOf": [ { "type": "integer" }, { "type": "null" } ] } }, "required": [ "user_id", "source", "complete", "intervals" ] }, "synckhub_server.routes.native_calendars.availability.Interval": { "title": "Interval", "type": "object", "properties": { "start": { "type": "string", "format": "date-time" }, "end": { "type": "string", "format": "date-time" }, "status": { "type": "string" } }, "required": [ "start", "end", "status" ] }, "synckhub_server.routes.native_calendars.availability.Slot": { "title": "Slot", "type": "object", "properties": { "start": { "type": "string", "format": "date-time" }, "end": { "type": "string", "format": "date-time" }, "outside_working_hours": { "type": "integer", "minimum": 0 } }, "required": [ "start", "end", "outside_working_hours" ] }, "synckhub_server.routes.native_calendars.availability.Settings": { "title": "Settings", "type": "object", "properties": { "version": { "type": "integer" }, "time_zone": { "type": "string" }, "working_days": { "type": "array", "items": { "type": "integer" } }, "start_minute": { "type": "integer" }, "end_minute": { "type": "integer" }, "readers": { "type": "array", "items": { "type": "string" } } }, "required": [ "version", "time_zone", "working_days", "start_minute", "end_minute", "readers" ], "additionalProperties": false }, "synckhub_server.routes.native_calendars.delegation.Detail": { "title": "Detail", "type": "object", "properties": { "repo_id": { "type": "string" }, "item_id": { "type": "string" }, "version": { "type": "integer" }, "data": {}, "description": { "type": "string" }, "attachments": { "type": "array", "items": { "$ref": "#/components/schemas/synckhub_server.routes.native_calendars.read.RelatedAttachment" } }, "represented_user_id": { "type": "string" }, "grant_version": { "type": "integer" } }, "required": [ "repo_id", "item_id", "version", "data", "description", "attachments", "represented_user_id", "grant_version" ] }, "synckhub_server.routes.native_calendars.read.RelatedAttachment": { "title": "RelatedAttachment", "type": "object", "properties": { "item_id": { "type": "string" }, "name": { "type": "string" } }, "required": [ "item_id", "name" ] }, "synckhub_server.routes.native_calendars.delegation.ResolveRequest": { "title": "ResolveRequest", "type": "object", "properties": { "expected_grant_version": { "type": "integer" }, "emails": { "type": "array", "items": { "type": "string" } } }, "required": [ "expected_grant_version", "emails" ], "additionalProperties": false }, "synckhub_server.routes.native_calendars.invitees.Output": { "title": "Output", "type": "object", "properties": { "items": { "type": "array", "items": { "$ref": "#/components/schemas/synckhub_server.routes.native_calendars.invitees.Invitee" } } }, "required": [ "items" ] }, "synckhub_server.routes.native_calendars.invitees.Invitee": { "title": "Invitee", "type": "object", "properties": { "email": { "type": "string" }, "user_id": { "anyOf": [ { "type": "string" }, { "type": "null" } ] } }, "required": [ "email" ] }, "synckhub_server.routes.native_calendars.delegation.Request": { "title": "Request", "oneOf": [ { "type": "object", "properties": { "expected_grant_version": { "type": "integer" }, "action": { "const": "CREATE" }, "input": { "$ref": "#/components/schemas/synckhub_core.native_calendars.commands.CreateEvent" } }, "required": [ "expected_grant_version", "action", "input" ], "additionalProperties": false }, { "type": "object", "properties": { "expected_grant_version": { "type": "integer" }, "action": { "const": "EDIT" }, "item_id": { "type": "string" }, "input": { "$ref": "#/components/schemas/synckhub_core.native_calendars.commands.EditEvent" } }, "required": [ "expected_grant_version", "action", "item_id", "input" ], "additionalProperties": false }, { "type": "object", "properties": { "expected_grant_version": { "type": "integer" }, "action": { "const": "CANCEL" }, "item_id": { "type": "string" }, "input": { "$ref": "#/components/schemas/synckhub_core.native_calendars.commands.CancelEvent" } }, "required": [ "expected_grant_version", "action", "item_id", "input" ], "additionalProperties": false }, { "type": "object", "properties": { "expected_grant_version": { "type": "integer" }, "action": { "const": "RESPOND" }, "item_id": { "type": "string" }, "input": { "$ref": "#/components/schemas/synckhub_core.native_calendars.commands.Respond" } }, "required": [ "expected_grant_version", "action", "item_id", "input" ], "additionalProperties": false } ] }, "synckhub_server.routes.native_calendars.delegation.EventList": { "title": "EventList", "type": "object", "properties": { "items": { "type": "array", "items": { "$ref": "#/components/schemas/synckhub_server.routes.native_calendars.delegation.RepresentedEventSummary" } }, "next_cursor": { "anyOf": [ { "type": "string" }, { "type": "null" } ] }, "represented_user_id": { "type": "string" }, "grant_version": { "type": "integer" } }, "required": [ "items", "represented_user_id", "grant_version" ] }, "synckhub_server.routes.native_calendars.delegation.RepresentedEventSummary": { "title": "RepresentedEventSummary", "type": "object", "properties": { "item_id": { "type": "string" }, "version": { "type": "integer" }, "title": { "type": "string" }, "time": { "$ref": "#/components/schemas/synckhub_core.native_calendars.EventTime" }, "recurrence": { "anyOf": [ { "$ref": "#/components/schemas/synckhub_core.native_calendars.recurrence.Recurrence" }, { "type": "null" } ] }, "role": { "type": "string" } }, "required": [ "item_id", "version", "title", "time", "role" ] }, "synckhub_server.routes.native_calendars.delegation.ReceivedGrant": { "title": "Grant", "type": "object", "properties": { "calendar_item_id": { "type": "string", "format": "uuid" }, "represented_user_id": { "type": "string" }, "sender_mailboxes": { "type": "array", "items": { "$ref": "#/components/schemas/synckhub_server.routes.native_calendars.delegation.SenderMailbox" } }, "delegate_user_id": { "type": "string" }, "version": { "type": "integer" }, "enabled": { "type": "boolean" }, "create_send": { "type": "boolean" }, "respond": { "type": "boolean" }, "private_details": { "type": "boolean" } }, "required": [ "calendar_item_id", "represented_user_id", "sender_mailboxes", "delegate_user_id", "version", "enabled", "create_send", "respond", "private_details" ], "additionalProperties": false }, "synckhub_server.routes.native_calendars.delegation.SenderMailbox": { "title": "SenderMailbox", "type": "object", "properties": { "mailbox_id": { "type": "string", "format": "uuid" }, "primary_address": { "type": "string" } }, "required": [ "mailbox_id", "primary_address" ] }, "synckhub_server.routes.native_calendars.delegation.Grant": { "title": "Grant", "type": "object", "properties": { "delegate_user_id": { "type": "string" }, "version": { "type": "integer" }, "enabled": { "type": "boolean" }, "create_send": { "type": "boolean" }, "respond": { "type": "boolean" }, "private_details": { "type": "boolean" } }, "required": [ "delegate_user_id", "version", "enabled", "create_send", "respond", "private_details" ], "additionalProperties": false }, "synckhub_server.routes.native_calendars.event_types.Input": { "title": "Input", "type": "object", "properties": { "expected_version": { "type": "integer" }, "name": { "type": "string" }, "active": { "type": "boolean" } }, "required": [ "expected_version", "name", "active" ], "additionalProperties": false }, "synckhub_server.routes.native_calendars.event_types.Catalog": { "title": "Catalog", "type": "object", "properties": { "items": { "type": "array", "items": { "$ref": "#/components/schemas/synckhub_core_postgres.service.native_calendars.event_types.EventType" } }, "can_manage": { "type": "boolean" } }, "required": [ "items", "can_manage" ] }, "synckhub_core_postgres.service.native_calendar_ics_import.Report": { "title": "Report", "type": "object", "properties": { "job_id": { "type": "string", "format": "uuid" }, "source_key": { "type": "string" }, "status": { "type": "string" }, "candidate_count": { "type": "integer", "minimum": 0 }, "rejected_count": { "type": "integer", "minimum": 0 }, "next_ordinal": { "type": "integer", "minimum": 0 }, "items": { "type": "array", "items": { "$ref": "#/components/schemas/synckhub_core_postgres.service.native_calendar_ics_import.ItemReport" } } }, "required": [ "job_id", "source_key", "status", "candidate_count", "rejected_count", "next_ordinal", "items" ] }, "synckhub_core_postgres.service.native_calendar_ics_import.ItemReport": { "title": "ItemReport", "type": "object", "properties": { "ordinal": { "type": "integer", "minimum": 0 }, "uid": { "anyOf": [ { "type": "string" }, { "type": "null" } ] }, "organizer": { "anyOf": [ { "type": "string" }, { "type": "null" } ] }, "status": { "type": "string" }, "rejection": { "anyOf": [ { "type": "string" }, { "type": "null" } ] } }, "required": [ "ordinal", "status" ] }, "synckhub_server.routes.native_calendars.invitations.Page": { "title": "Page", "type": "object", "properties": { "items": { "type": "array", "items": { "$ref": "#/components/schemas/synckhub_server.routes.native_calendars.invitations.Invitation" } }, "next_cursor": { "anyOf": [ { "type": "string" }, { "type": "null" } ] } }, "required": [ "items" ] }, "synckhub_server.routes.native_calendars.invitations.Invitation": { "title": "Invitation", "type": "object", "properties": { "occurrence_start": { "anyOf": [ { "type": "string", "format": "date-time" }, { "type": "null" } ] }, "repo_id": { "type": "string" }, "item_id": { "type": "string" }, "version": { "type": "integer" }, "title": { "type": "string" }, "time": { "$ref": "#/components/schemas/synckhub_core.native_calendars.EventTime" }, "invitation_generation": { "type": "integer", "minimum": 0 }, "response_revision": { "type": "integer", "minimum": 0 } }, "required": [ "repo_id", "item_id", "version", "title", "time", "invitation_generation", "response_revision" ] }, "synckhub_server.routes.native_calendars.invitees.Senders": { "title": "Senders", "type": "object", "properties": { "items": { "type": "array", "items": { "$ref": "#/components/schemas/synckhub_server.routes.native_calendars.invitees.Sender" } } }, "required": [ "items" ] }, "synckhub_server.routes.native_calendars.invitees.Sender": { "title": "Sender", "type": "object", "properties": { "mailbox_id": { "type": "string", "format": "uuid" }, "primary_address": { "type": "string" } }, "required": [ "mailbox_id", "primary_address" ] }, "synckhub_server.routes.native_calendars.invitees.Input": { "title": "Input", "type": "object", "properties": { "resource_item_id": { "type": "string" }, "emails": { "type": "array", "items": { "type": "string" } } }, "required": [ "resource_item_id", "emails" ], "additionalProperties": false }, "synckhub_server.routes.native_calendars.lists.CalendarPeopleResolve": { "title": "CalendarPeopleResolve", "type": "object", "properties": { "user_ids": { "type": "array", "items": { "type": "string" } } }, "required": [ "user_ids" ], "additionalProperties": false }, "synckhub_server.routes.native_calendars.lists.CalendarPeopleDirectoryResult": { "title": "CalendarPeopleDirectoryResult", "type": "object", "properties": { "items": { "type": "array", "items": { "$ref": "#/components/schemas/synckhub_server.routes.native_calendars.lists.CalendarPerson" } } }, "required": [ "items" ] }, "synckhub_server.routes.native_calendars.lists.CalendarPerson": { "title": "CalendarPerson", "type": "object", "properties": { "user_id": { "type": "string" }, "email": { "type": "string" }, "first_name": { "anyOf": [ { "type": "string" }, { "type": "null" } ] }, "last_name": { "anyOf": [ { "type": "string" }, { "type": "null" } ] } }, "required": [ "user_id", "email" ] }, "synckhub_server.routes.native_calendars.lists.CalendarPeopleSearch": { "title": "CalendarPeopleSearch", "type": "object", "properties": { "q": { "type": "string" }, "limit": { "anyOf": [ { "type": "integer", "minimum": 0 }, { "type": "null" } ] }, "exclude_user_ids": { "type": "array", "items": { "type": "string" } } }, "required": [ "q" ], "additionalProperties": false }, "synckhub_server.routes.native_calendars.lists.PeopleEventRequest": { "title": "PeopleEventRequest", "type": "object", "properties": { "start_date": { "type": "string", "format": "date" }, "end_date": { "type": "string", "format": "date" }, "time_zone": { "type": "string" }, "selections": { "type": "array", "items": { "$ref": "#/components/schemas/synckhub_server.routes.native_calendars.lists.PeopleSelection" } } }, "required": [ "start_date", "end_date", "time_zone", "selections" ], "additionalProperties": false }, "synckhub_server.routes.native_calendars.lists.PeopleSelection": { "title": "PeopleSelection", "type": "object", "properties": { "calendar_item_id": { "type": "string" }, "user_ids": { "type": "array", "items": { "type": "string" } } }, "required": [ "calendar_item_id", "user_ids" ], "additionalProperties": false }, "synckhub_server.routes.native_calendars.lists.PeopleEventResult": { "title": "PeopleEventResult", "type": "object", "properties": { "items": { "type": "array", "items": { "$ref": "#/components/schemas/synckhub_server.routes.native_calendars.lists.PeopleEvent" } }, "unavailable_user_ids": { "type": "array", "items": { "type": "string" } } }, "required": [ "items", "unavailable_user_ids" ] }, "synckhub_server.routes.native_calendars.lists.PeopleEvent": { "title": "PeopleEvent", "oneOf": [ { "type": "object", "properties": { "kind": { "const": "EVENT" }, "participant_user_ids": { "type": "array", "items": { "type": "string" } }, "event_type_id": { "anyOf": [ { "type": "string", "format": "uuid" }, { "type": "null" } ] }, "event_type": { "anyOf": [ { "$ref": "#/components/schemas/synckhub_core_postgres.service.native_calendars.event_types.EventType" }, { "type": "null" } ] }, "item_id": { "type": "string" }, "occurrence_start": { "anyOf": [ { "type": "string", "format": "date-time" }, { "type": "null" } ] }, "version": { "type": "integer" }, "title": { "type": "string" }, "organizer_user_id": { "type": "string" }, "organizer_address": { "anyOf": [ { "type": "string" }, { "type": "null" } ] }, "time": { "$ref": "#/components/schemas/synckhub_core.native_calendars.EventTime" }, "state": { "$ref": "#/components/schemas/synckhub_core.native_calendars.EventState" }, "calendar_item_id": { "type": "string" }, "calendar": { "anyOf": [ { "$ref": "#/components/schemas/synckhub_server.routes.native_calendars.read.CalendarLabel" }, { "type": "null" } ] }, "case": { "anyOf": [ { "$ref": "#/components/schemas/synckhub_server.routes.native_calendars.read.RelatedCase" }, { "type": "null" } ] }, "private": { "type": "boolean" }, "allowed_actions": { "type": "array", "items": { "type": "string" } } }, "required": [ "kind", "participant_user_ids", "item_id", "version", "title", "organizer_user_id", "time", "state", "calendar_item_id", "private", "allowed_actions" ], "title": "EventSummary" }, { "type": "object", "properties": { "kind": { "const": "BUSY" }, "calendar_item_id": { "type": "string" }, "user_id": { "type": "string" }, "time": { "$ref": "#/components/schemas/synckhub_core.native_calendars.EventTime" }, "busy_status": { "type": "string" } }, "required": [ "kind", "calendar_item_id", "user_id", "time", "busy_status" ] } ] }, "synckhub_server.routes.native_calendars.lists.EventPage": { "title": "EventPage", "type": "object", "properties": { "items": { "type": "array", "items": { "$ref": "#/components/schemas/synckhub_server.routes.native_calendars.lists.EventSummary" } }, "next_cursor": { "anyOf": [ { "type": "string" }, { "type": "null" } ] } }, "required": [ "items" ] }, "synckhub_server.routes.native_calendars.lists.notices.Kind": { "title": "Kind", "type": "string", "enum": [ "all", "events", "reminders" ] }, "synckhub_server.routes.native_calendars.lists.notices.Direction": { "title": "Direction", "type": "string", "enum": [ "asc", "desc" ] }, "synckhub_server.routes.native_calendars.lists.notices.Page": { "title": "Page", "type": "object", "properties": { "items": { "type": "array", "items": { "$ref": "#/components/schemas/synckhub_server.routes.native_calendars.lists.notices.Row" } }, "next_cursor": { "anyOf": [ { "type": "string" }, { "type": "null" } ] } }, "required": [ "items" ] }, "synckhub_server.routes.native_calendars.lists.notices.Row": { "title": "Row", "type": "object", "properties": { "row_id": { "type": "string" }, "kind": { "type": "string" }, "scheduled_at": { "type": "string", "format": "date-time" }, "reminder_id": { "anyOf": [ { "type": "integer", "minimum": 0 }, { "type": "null" } ] }, "minutes_before_start": { "anyOf": [ { "type": "integer", "minimum": 0 }, { "type": "null" } ] }, "reminder_source": { "anyOf": [ { "type": "string" }, { "type": "null" } ] }, "event": { "$ref": "#/components/schemas/synckhub_server.routes.native_calendars.lists.EventSummary" } }, "required": [ "row_id", "kind", "scheduled_at", "event" ] }, "synckhub_server.routes.native_calendars.lists.CalendarPage": { "title": "CalendarPage", "type": "object", "properties": { "items": { "type": "array", "items": { "$ref": "#/components/schemas/synckhub_server.routes.native_calendars.lists.CalendarSummary" } }, "next_cursor": { "anyOf": [ { "type": "string" }, { "type": "null" } ] }, "allowed_actions": { "type": "array", "items": { "type": "string" } } }, "required": [ "items", "allowed_actions" ] }, "synckhub_server.routes.native_calendars.lists.CalendarSummary": { "title": "CalendarLabel", "type": "object", "properties": { "version": { "type": "integer" }, "private": { "type": "boolean" }, "allowed_actions": { "type": "array", "items": { "type": "string" } }, "item_id": { "type": "string" }, "title": { "type": "string" }, "color": { "type": "string" }, "archived": { "type": "boolean" } }, "required": [ "version", "private", "allowed_actions", "item_id", "title", "color", "archived" ] }, "synckhub_server.routes.native_calendars.peer.PeerInvitationPage": { "title": "PeerInvitationPage", "type": "object", "properties": { "items": { "type": "array", "items": { "$ref": "#/components/schemas/synckhub_server.routes.native_calendars.peer.PeerInvitation" } }, "next_cursor": { "anyOf": [ { "type": "string" }, { "type": "null" } ] } }, "required": [ "items" ] }, "synckhub_server.routes.native_calendars.peer.PeerInvitation": { "title": "PeerInvitation", "type": "object", "properties": { "source_infra_id": { "type": "string", "format": "uuid" }, "repo_id": { "type": "string", "format": "uuid" }, "item_id": { "type": "string", "format": "uuid" }, "version": { "type": "integer" }, "title": { "type": "string" }, "time": { "$ref": "#/components/schemas/synckhub_core.native_calendars.EventTime" }, "occurrence_start": { "anyOf": [ { "type": "string", "format": "date-time" }, { "type": "null" } ] }, "invitation_generation": { "type": "integer", "minimum": 0 }, "response_revision": { "type": "integer", "minimum": 0 }, "fresh_until": { "type": "string", "format": "date-time" } }, "required": [ "source_infra_id", "repo_id", "item_id", "version", "title", "time", "invitation_generation", "response_revision", "fresh_until" ] }, "synckhub_server.routes.native_calendars.peer.PeerAgendaPage": { "title": "PeerAgendaPage", "type": "object", "properties": { "items": { "type": "array", "items": { "$ref": "#/components/schemas/synckhub_server.routes.native_calendars.peer.PeerAgendaEntry" } }, "next_cursor": { "anyOf": [ { "type": "string" }, { "type": "null" } ] } }, "required": [ "items" ] }, "synckhub_server.routes.native_calendars.peer.PeerAgendaEntry": { "title": "PeerAgendaEntry", "type": "object", "properties": { "source_infra_id": { "type": "string", "format": "uuid" }, "repo_id": { "type": "string", "format": "uuid" }, "item_id": { "type": "string", "format": "uuid" }, "occurrence_start": { "anyOf": [ { "type": "string", "format": "date-time" }, { "type": "null" } ] }, "version": { "type": "integer" }, "delivery_version": { "type": "integer" }, "title": { "type": "string" }, "time": { "$ref": "#/components/schemas/synckhub_core.native_calendars.EventTime" }, "response": { "$ref": "#/components/schemas/synckhub_core.native_calendars.Response" }, "busy_status": { "type": "string" }, "fresh_until": { "type": "string", "format": "date-time" }, "invitation_generation": { "type": "integer", "minimum": 0 }, "response_revision": { "type": "integer", "minimum": 0 } }, "required": [ "source_infra_id", "repo_id", "item_id", "version", "delivery_version", "title", "time", "response", "busy_status", "fresh_until", "invitation_generation", "response_revision" ] }, "synckhub_server.native_calendar_peer.Receipt": { "title": "Receipt", "type": "object", "properties": { "delivery_id": { "type": "string", "format": "uuid" }, "accepted_at": { "type": "string", "format": "date-time" } }, "required": [ "delivery_id", "accepted_at" ] }, "synckhub_server.native_calendar_peer.Delivery": { "title": "Delivery", "type": "object", "properties": { "delivery_id": { "type": "string", "format": "uuid" }, "source_version": { "type": "integer" }, "snapshot": { "anyOf": [ { "$ref": "#/components/schemas/synckhub_server.native_calendar_peer.Snapshot" }, { "type": "null" } ] } }, "required": [ "delivery_id", "source_version" ], "additionalProperties": false }, "synckhub_server.native_calendar_peer.Snapshot": { "title": "Snapshot", "type": "object", "properties": { "event": { "$ref": "#/components/schemas/synckhub_core.native_calendars.CalendarEvent" }, "event_version": { "type": "integer" }, "description": { "type": "string" }, "occurrence_descriptions": { "type": "object", "additionalProperties": { "type": "string" } } }, "required": [ "event", "event_version", "description", "occurrence_descriptions" ], "additionalProperties": false }, "synckhub_core.native_calendars.CalendarEvent": { "title": "CalendarEvent", "type": "object", "properties": { "event_type_id": { "anyOf": [ { "type": "string", "format": "uuid" }, { "type": "null" } ] }, "calendar_item_id": { "type": "string" }, "case_item_id": { "anyOf": [ { "type": "string" }, { "type": "null" } ] }, "attachment_item_ids": { "type": "array", "items": { "type": "string" } }, "title": { "type": "string" }, "time": { "$ref": "#/components/schemas/synckhub_core.native_calendars.EventTime" }, "location": { "anyOf": [ { "type": "string" }, { "type": "null" } ] }, "meeting_url": { "anyOf": [ { "type": "string" }, { "type": "null" } ] }, "organizer_user_id": { "type": "string" }, "state": { "$ref": "#/components/schemas/synckhub_core.native_calendars.EventState" }, "attendees": { "type": "array", "items": { "$ref": "#/components/schemas/synckhub_core.native_calendars.Attendee" } }, "invitation_counter": { "type": "integer", "minimum": 0 }, "reminders": { "$ref": "#/components/schemas/synckhub_core.native_calendars.Reminders" }, "reminder_schedule_generation": { "type": "integer", "minimum": 0 }, "recurrence": { "anyOf": [ { "$ref": "#/components/schemas/synckhub_core.native_calendars.recurrence.Recurrence" }, { "type": "null" } ] }, "exceptions": { "type": "array", "items": { "$ref": "#/components/schemas/synckhub_core.native_calendars.recurrence.OccurrenceException" } }, "occurrence_responses": { "type": "array", "items": { "$ref": "#/components/schemas/synckhub_core.native_calendars.OccurrenceResponse" } }, "occurrence_attendees": { "type": "array", "items": { "$ref": "#/components/schemas/synckhub_core.native_calendars.OccurrenceAttendees" } }, "occurrence_details": { "type": "array", "items": { "$ref": "#/components/schemas/synckhub_core.native_calendars.occurrence_details.Override" } }, "occurrence_descriptions": { "type": "array", "items": { "$ref": "#/components/schemas/synckhub_core.native_calendars.occurrence_details.DescriptionSource" } }, "canceled_from": { "anyOf": [ { "type": "string", "format": "date-time" }, { "type": "null" } ] }, "split_from": { "anyOf": [ { "$ref": "#/components/schemas/synckhub_core.native_calendars.SeriesLink" }, { "type": "null" } ] }, "split_to": { "anyOf": [ { "$ref": "#/components/schemas/synckhub_core.native_calendars.SeriesLink" }, { "type": "null" } ] }, "external": { "anyOf": [ { "$ref": "#/components/schemas/synckhub_core.external_scheduling.state.ExternalScheduling" }, { "type": "null" } ] } }, "required": [ "calendar_item_id", "title", "time", "organizer_user_id", "state", "attendees", "invitation_counter", "reminders", "reminder_schedule_generation" ], "additionalProperties": false }, "synckhub_core.native_calendars.Attendee": { "title": "Attendee", "type": "object", "properties": { "series_response_epoch": { "anyOf": [ { "type": "integer", "minimum": 0 }, { "type": "null" } ] }, "user_id": { "type": "string" }, "admission": { "$ref": "#/components/schemas/synckhub_core.native_calendars.InvitationAdmission" }, "role": { "$ref": "#/components/schemas/synckhub_core.native_calendars.AttendeeRole" }, "response": { "$ref": "#/components/schemas/synckhub_core.native_calendars.Response" }, "invitation_generation": { "type": "integer", "minimum": 0 }, "response_revision": { "type": "integer", "minimum": 0 } }, "required": [ "user_id", "role", "response", "invitation_generation", "response_revision" ], "additionalProperties": false }, "synckhub_core.native_calendars.InvitationAdmission": { "title": "InvitationAdmission", "type": "string", "enum": [ "REPOSITORY_MEMBERSHIP", "EVENT_PARTICIPATION", "REMOTE_PARTICIPATION" ], "description": "The authority lifetime established when an invitation is created. Repository\nremoval must not silently convert a membership-bound invitation into a share." }, "synckhub_core.native_calendars.Reminders": { "title": "Reminders", "type": "object", "properties": { "counter": { "type": "integer", "minimum": 0 }, "entries": { "type": "array", "items": { "$ref": "#/components/schemas/synckhub_core.native_calendars.Reminder" } } }, "required": [ "counter", "entries" ], "additionalProperties": false }, "synckhub_core.native_calendars.Reminder": { "title": "Reminder", "type": "object", "properties": { "reminder_id": { "type": "integer", "minimum": 0 }, "minutes_before_start": { "type": "integer", "minimum": 0 } }, "required": [ "reminder_id", "minutes_before_start" ], "additionalProperties": false }, "synckhub_core.native_calendars.recurrence.OccurrenceException": { "title": "OccurrenceException", "type": "object", "properties": { "revision": { "anyOf": [ { "type": "integer", "minimum": 0 }, { "type": "null" } ] }, "canceled": { "type": "boolean" }, "original_start": { "type": "string", "format": "date-time" }, "time": { "anyOf": [ { "$ref": "#/components/schemas/synckhub_core.native_calendars.EventTime" }, { "type": "null" } ] } }, "required": [ "original_start" ], "additionalProperties": false, "description": "Cancellation retains the original identity and, for a move, its last time.\nA move changes only the displayed time, never the recurrence identity." }, "synckhub_core.native_calendars.OccurrenceResponse": { "title": "OccurrenceResponse", "type": "object", "properties": { "original_start": { "type": "string", "format": "date-time" }, "user_id": { "type": "string" }, "response": { "$ref": "#/components/schemas/synckhub_core.native_calendars.Response" } }, "required": [ "original_start", "user_id", "response" ], "additionalProperties": false, "description": "An RSVP override belongs to the current invitation and original occurrence.\nIts revision is the attendee's existing response revision, shared by scopes." }, "synckhub_core.native_calendars.OccurrenceAttendees": { "title": "OccurrenceAttendees", "type": "object", "properties": { "original_start": { "type": "string", "format": "date-time" }, "attendees": { "type": "array", "items": { "$ref": "#/components/schemas/synckhub_core.native_calendars.Attendee" } } }, "required": [ "original_start", "attendees" ], "additionalProperties": false }, "synckhub_core.native_calendars.occurrence_details.Override": { "title": "Override", "type": "object", "properties": { "original_start": { "type": "string", "format": "date-time" }, "revision": { "type": "integer", "minimum": 0 }, "details": { "$ref": "#/components/schemas/synckhub_core.native_calendars.occurrence_details.Details" } }, "required": [ "original_start", "revision", "details" ], "additionalProperties": false }, "synckhub_core.native_calendars.occurrence_details.Details": { "title": "Details", "type": "object", "properties": { "title": { "anyOf": [ { "type": "string" }, { "type": "null" } ] }, "location": { "anyOf": [ { "anyOf": [ { "type": "string" }, { "type": "null" } ] }, { "type": "null" } ] }, "meeting_url": { "anyOf": [ { "anyOf": [ { "type": "string" }, { "type": "null" } ] }, { "type": "null" } ] } }, "additionalProperties": false }, "synckhub_core.native_calendars.occurrence_details.DescriptionSource": { "title": "DescriptionSource", "type": "object", "properties": { "original_start": { "type": "string", "format": "date-time" }, "base_version": { "type": "integer" }, "source_item_id": { "anyOf": [ { "type": "string" }, { "type": "null" } ] } }, "required": [ "original_start", "base_version" ], "additionalProperties": false, "description": "Body source is an accepted event after this guarded version, not inline text." }, "synckhub_core.native_calendars.SeriesLink": { "title": "SeriesLink", "type": "object", "properties": { "event_item_id": { "type": "string" }, "original_start": { "type": "string", "format": "date-time" } }, "required": [ "event_item_id", "original_start" ], "additionalProperties": false }, "synckhub_core.external_scheduling.state.ExternalScheduling": { "title": "ExternalScheduling", "oneOf": [ { "type": "object", "properties": { "kind": { "const": "LOCAL_ORGANIZER" }, "uid": { "type": "string" }, "organizer": { "type": "string" }, "attendees": { "type": "array", "items": { "$ref": "#/components/schemas/synckhub_core.external_scheduling.state.ExternalAttendee" } }, "occurrence_responses": { "type": "array", "items": { "$ref": "#/components/schemas/synckhub_core.external_scheduling.state.ExternalOccurrenceResponse" } }, "delivery": { "anyOf": [ { "$ref": "#/components/schemas/synckhub_core.external_scheduling.state.ExternalDelivery" }, { "type": "null" } ] } }, "required": [ "kind", "uid", "organizer", "attendees" ], "additionalProperties": false }, { "type": "object", "properties": { "kind": { "const": "ATTENDEE_COPY" }, "mailbox_id": { "type": "string", "format": "uuid" }, "invitation_id": { "type": "string", "format": "uuid" }, "source_digest": { "type": "string" }, "response": { "$ref": "#/components/schemas/synckhub_core.native_calendars.Response" }, "uid": { "type": "string" }, "organizer": { "type": "string" }, "recipient": { "type": "string" }, "sequence": { "type": "integer", "minimum": 0 }, "dtstamp": { "type": "string", "format": "date-time" }, "recurrence_id": { "anyOf": [ { "$ref": "#/components/schemas/synckhub_core.external_scheduling.Property" }, { "type": "null" } ] }, "last_action": { "anyOf": [ { "type": "string", "format": "uuid" }, { "type": "null" } ] } }, "required": [ "kind", "mailbox_id", "invitation_id", "source_digest", "response", "uid", "organizer", "recipient", "sequence", "dtstamp" ], "additionalProperties": false }, { "type": "object", "properties": { "kind": { "const": "EXTERNAL_ORGANIZER" }, "uid": { "type": "string" }, "organizer": { "type": "string" }, "sequence": { "type": "integer", "minimum": 0 }, "dtstamp": { "type": "string", "format": "date-time" }, "participants": { "type": "array", "items": { "$ref": "#/components/schemas/synckhub_core.external_scheduling.state.ExternalParticipantSource" } } }, "required": [ "kind", "uid", "organizer", "sequence", "dtstamp", "participants" ], "additionalProperties": false }, { "type": "object", "properties": { "kind": { "const": "IMPORTED" }, "uid": { "type": "string" }, "organizer": { "type": "string" }, "attendees": { "type": "array", "items": { "$ref": "#/components/schemas/synckhub_core.external_scheduling.state.ExternalAttendee" } }, "occurrence_responses": { "type": "array", "items": { "$ref": "#/components/schemas/synckhub_core.external_scheduling.state.ExternalOccurrenceResponse" } }, "canceled": { "type": "boolean" } }, "required": [ "kind", "uid", "organizer", "attendees", "canceled" ], "additionalProperties": false } ] }, "synckhub_core.external_scheduling.state.ExternalAttendee": { "title": "ExternalAttendee", "type": "object", "properties": { "address": { "type": "string" }, "response": { "$ref": "#/components/schemas/synckhub_core.native_calendars.Response" } }, "required": [ "address", "response" ], "additionalProperties": false }, "synckhub_core.external_scheduling.state.ExternalOccurrenceResponse": { "title": "ExternalOccurrenceResponse", "type": "object", "properties": { "original_start": { "type": "string", "format": "date-time" }, "address": { "type": "string" }, "response": { "$ref": "#/components/schemas/synckhub_core.native_calendars.Response" } }, "required": [ "original_start", "address", "response" ], "additionalProperties": false }, "synckhub_core.external_scheduling.state.ExternalDelivery": { "title": "ExternalDelivery", "type": "object", "properties": { "command_id": { "type": "string", "format": "uuid" }, "recipient": { "type": "string" }, "method": { "$ref": "#/components/schemas/synckhub_core.external_scheduling.Method" }, "original_start": { "anyOf": [ { "type": "string", "format": "date-time" }, { "type": "null" } ] } }, "required": [ "command_id", "recipient", "method" ], "additionalProperties": false }, "synckhub_core.external_scheduling.Method": { "title": "Method", "type": "string", "enum": [ "REQUEST", "REPLY", "CANCEL", "REFRESH", "COUNTER", "DECLINECOUNTER" ] }, "synckhub_core.external_scheduling.Property": { "title": "Property", "type": "object", "properties": { "name": { "type": "string" }, "params": { "type": "object", "additionalProperties": { "type": "string" } }, "value": { "type": "string" } }, "required": [ "name", "value" ], "additionalProperties": false }, "synckhub_core.external_scheduling.state.ExternalParticipantSource": { "title": "ExternalParticipantSource", "type": "object", "properties": { "user_id": { "type": "string" }, "mailbox_id": { "type": "string", "format": "uuid" }, "recipient": { "type": "string" }, "invitation_id": { "type": "string", "format": "uuid" }, "source_digest": { "type": "string" }, "sequence": { "type": "integer", "minimum": 0 }, "dtstamp": { "type": "string", "format": "date-time" }, "last_action": { "anyOf": [ { "type": "string", "format": "uuid" }, { "type": "null" } ] }, "last_action_occurrence": { "anyOf": [ { "type": "string", "format": "date-time" }, { "type": "null" } ] }, "occurrence_orders": { "type": "array", "items": { "$ref": "#/components/schemas/synckhub_core.external_scheduling.state.ExternalOccurrenceOrder" } } }, "required": [ "user_id", "mailbox_id", "recipient", "invitation_id", "source_digest", "sequence", "dtstamp" ], "additionalProperties": false }, "synckhub_core.external_scheduling.state.ExternalOccurrenceOrder": { "title": "ExternalOccurrenceOrder", "type": "object", "properties": { "original_start": { "type": "string", "format": "date-time" }, "invitation_id": { "type": "string", "format": "uuid" }, "source_digest": { "type": "string" }, "sequence": { "type": "integer", "minimum": 0 }, "dtstamp": { "type": "string", "format": "date-time" } }, "required": [ "original_start", "invitation_id", "source_digest", "sequence", "dtstamp" ], "additionalProperties": false }, "synckhub_core.native_calendars.commands.InviteRemote": { "title": "InviteRemote", "type": "object", "properties": { "command_id": { "type": "string", "format": "uuid" }, "expected_version": { "type": "integer" }, "user_id": { "type": "string", "format": "uuid" }, "role": { "$ref": "#/components/schemas/synckhub_core.native_calendars.AttendeeRole" } }, "required": [ "command_id", "expected_version", "user_id", "role" ], "additionalProperties": false, "description": "Route selection is performed by the source infrastructure through Common." }, "synckhub_server.routes.native_calendars.preferences.Input": { "title": "Input", "type": "object", "properties": { "expected_version": { "type": "integer" }, "invitation_generation": { "type": "integer", "minimum": 0 }, "busy_status": { "anyOf": [ { "$ref": "#/components/schemas/synckhub_server.routes.native_calendars.preferences.BusyStatus" }, { "type": "null" } ] }, "reminder_offsets": { "anyOf": [ { "type": "array", "items": { "type": "integer", "minimum": 0 } }, { "type": "null" } ] } }, "required": [ "expected_version", "invitation_generation" ], "additionalProperties": false }, "synckhub_server.routes.native_calendars.preferences.BusyStatus": { "title": "BusyStatus", "type": "string", "enum": [ "FREE", "TENTATIVE", "BUSY", "OUT_OF_OFFICE" ] }, "synckhub_server.routes.native_calendars.preferences.Preferences": { "title": "Preferences", "type": "object", "properties": { "version": { "type": "integer" }, "invitation_generation": { "type": "integer", "minimum": 0 }, "busy_status": { "anyOf": [ { "type": "string" }, { "type": "null" } ] }, "reminder_offsets": { "anyOf": [ { "type": "array", "items": { "type": "integer" } }, { "type": "null" } ] } }, "required": [ "version", "invitation_generation" ] }, "synckhub_server.routes.native_calendars.read.EventDetail": { "title": "EventDetail", "type": "object", "properties": { "read_scope": { "type": "string" }, "event_type": { "anyOf": [ { "$ref": "#/components/schemas/synckhub_core_postgres.service.native_calendars.event_types.EventType" }, { "type": "null" } ] }, "occurrence": { "anyOf": [ { "$ref": "#/components/schemas/synckhub_server.routes.native_calendars.read.OccurrenceDetail" }, { "type": "null" } ] }, "repo_id": { "type": "string" }, "item_id": { "type": "string" }, "version": { "type": "integer" }, "data": {}, "description": { "type": "string" }, "calendar": { "anyOf": [ { "$ref": "#/components/schemas/synckhub_server.routes.native_calendars.read.CalendarLabel" }, { "type": "null" } ] }, "case": { "anyOf": [ { "$ref": "#/components/schemas/synckhub_server.routes.native_calendars.read.RelatedCase" }, { "type": "null" } ] }, "attachments": { "type": "array", "items": { "$ref": "#/components/schemas/synckhub_server.routes.native_calendars.read.RelatedAttachment" } }, "private": { "type": "boolean" }, "allowed_actions": { "type": "array", "items": { "type": "string" } }, "created_at": { "type": "string", "format": "date-time" }, "created_by": { "type": "string" } }, "required": [ "read_scope", "repo_id", "item_id", "version", "data", "description", "attachments", "private", "allowed_actions", "created_at", "created_by" ] }, "synckhub_server.routes.native_calendars.read.OccurrenceDetail": { "title": "OccurrenceDetail", "type": "object", "properties": { "description": { "type": "string" }, "details": { "$ref": "#/components/schemas/synckhub_core.native_calendars.occurrence_details.ResolvedDetails" }, "attendees": { "type": "array", "items": { "$ref": "#/components/schemas/synckhub_core.native_calendars.Attendee" } }, "original_start": { "type": "string", "format": "date-time" }, "time": { "$ref": "#/components/schemas/synckhub_core.native_calendars.EventTime" }, "state": { "$ref": "#/components/schemas/synckhub_core.native_calendars.EventState" } }, "required": [ "description", "details", "attendees", "original_start", "time", "state" ] }, "synckhub_core.native_calendars.occurrence_details.ResolvedDetails": { "title": "ResolvedDetails", "type": "object", "properties": { "title": { "type": "string" }, "location": { "anyOf": [ { "type": "string" }, { "type": "null" } ] }, "meeting_url": { "anyOf": [ { "type": "string" }, { "type": "null" } ] } }, "required": [ "title" ] }, "synckhub_server.routes.native_calendars.read.CalendarDetail": { "title": "CalendarDetail", "type": "object", "properties": { "repo_id": { "type": "string" }, "item_id": { "type": "string" }, "version": { "type": "integer" }, "data": { "$ref": "#/components/schemas/synckhub_core.native_calendars.Calendar" }, "private": { "type": "boolean" }, "allowed_actions": { "type": "array", "items": { "type": "string" } }, "created_at": { "type": "string", "format": "date-time" }, "created_by": { "type": "string" } }, "required": [ "repo_id", "item_id", "version", "data", "private", "allowed_actions", "created_at", "created_by" ] }, "synckhub_core.native_calendars.Calendar": { "title": "Calendar", "type": "object", "properties": { "title": { "type": "string" }, "description": { "anyOf": [ { "type": "string" }, { "type": "null" } ] }, "color": { "type": "string" }, "archived": { "type": "boolean" } }, "required": [ "title", "color", "archived" ], "additionalProperties": false }, "synckhub_server.routes.native_calendars.resources.PendingPage": { "title": "PendingPage", "type": "object", "properties": { "items": { "type": "array", "items": { "$ref": "#/components/schemas/synckhub_server.routes.native_calendars.resources.PendingRequest" } }, "next_cursor": { "anyOf": [ { "type": "string", "format": "uuid" }, { "type": "null" } ] } }, "required": [ "items" ] }, "synckhub_server.routes.native_calendars.resources.PendingRequest": { "title": "PendingRequest", "type": "object", "properties": { "event_item_id": { "type": "string", "format": "uuid" }, "event_version": { "type": "integer" }, "requested_by": { "type": "string" }, "state": { "type": "string" }, "intervals": {} }, "required": [ "event_item_id", "event_version", "requested_by", "state", "intervals" ] }, "synckhub_server.routes.native_calendars.resources.Decision": { "title": "Decision", "type": "object", "properties": { "expected_event_version": { "type": "integer" }, "accept": { "type": "boolean" }, "reason": { "anyOf": [ { "type": "string" }, { "type": "null" } ] } }, "required": [ "expected_event_version", "accept" ], "additionalProperties": false }, "synckhub_core_postgres.service.native_calendars.resources.Booking": { "title": "Booking", "type": "object", "properties": { "resource_id": { "type": "string", "format": "uuid" }, "event_version": { "type": "integer" }, "state": { "type": "string" }, "reason": { "anyOf": [ { "type": "string" }, { "type": "null" } ] } }, "required": [ "resource_id", "event_version", "state" ] }, "synckhub_server.routes.native_calendars.resources.RequestResources": { "title": "RequestResources", "type": "object", "properties": { "expected_version": { "type": "integer" }, "resource_ids": { "type": "array", "items": { "type": "string", "format": "uuid" } } }, "required": [ "expected_version", "resource_ids" ], "additionalProperties": false }, "synckhub_core_postgres.service.native_calendars.resources.ResourceConfig": { "title": "ResourceConfig", "type": "object", "properties": { "version": { "type": "integer" }, "kind": { "type": "string" }, "active": { "type": "boolean" }, "time_zone": { "type": "string" }, "capacity": { "type": "integer" }, "horizon_days": { "type": "integer" }, "max_minutes": { "type": "integer" }, "approval_required": { "type": "boolean" }, "allowed_bookers": { "type": "array", "items": { "type": "string" } } }, "required": [ "version", "kind", "active", "time_zone", "capacity", "horizon_days", "max_minutes", "approval_required", "allowed_bookers" ], "additionalProperties": false }, "synckhub_server.routes.native_calendars.resources.ResourceEntry": { "title": "ResourceConfig", "type": "object", "properties": { "calendar_item_id": { "type": "string" }, "title": { "type": "string" }, "version": { "type": "integer" }, "kind": { "type": "string" }, "active": { "type": "boolean" }, "time_zone": { "type": "string" }, "capacity": { "type": "integer" }, "horizon_days": { "type": "integer" }, "max_minutes": { "type": "integer" }, "approval_required": { "type": "boolean" }, "allowed_bookers": { "type": "array", "items": { "type": "string" } } }, "required": [ "calendar_item_id", "title", "version", "kind", "active", "time_zone", "capacity", "horizon_days", "max_minutes", "approval_required", "allowed_bookers" ], "additionalProperties": false }, "synckhub_server.routes.public_space.PublicSpacePostsResponse": { "title": "PublicSpacePostsResponse", "type": "object", "properties": { "posts": { "type": "array", "items": { "$ref": "#/components/schemas/synckhub_server.routes.public_space.PublicSpacePostSummary" } } }, "required": [ "posts" ] }, "synckhub_server.routes.public_space.PublicSpacePostSummary": { "title": "PublicSpacePostSummary", "type": "object", "properties": { "repo_id": { "type": "string" }, "post_item_id": { "type": "string" }, "title": { "type": "string" }, "summary": { "anyOf": [ { "type": "string" }, { "type": "null" } ] }, "published_at": { "type": "string" }, "updated_at": { "type": "string" } }, "required": [ "repo_id", "post_item_id", "title", "published_at", "updated_at" ] }, "synckhub_server.routes.recents.VisitRequest": { "title": "VisitRequest", "type": "object", "properties": { "item_id": { "type": "string" } }, "required": [ "item_id" ], "additionalProperties": false }, "synckhub_server.routes.recents.VisitResponse": { "title": "VisitResponse", "type": "object", "properties": { "case": { "type": "boolean" }, "company": { "type": "boolean" } }, "required": [ "case", "company" ] }, "synckhub_server.routes.repo_posts.CreateCommentRequest": { "title": "CreateCommentRequest", "type": "object", "properties": { "body_markdown": { "type": "string" } }, "required": [ "body_markdown" ], "additionalProperties": false }, "synckhub_core.types.RepoPostCommentSummary": { "title": "RepoPostCommentSummary", "type": "object", "properties": { "repo_id": { "type": "string" }, "post_item_id": { "type": "string" }, "comment_id": { "type": "string" }, "item_seq": { "type": "integer" }, "body_markdown": { "type": "string" }, "author_id": { "type": "string" }, "lifecycle_state": { "type": "string" }, "created_at": { "type": "string" }, "updated_at": { "type": "string" }, "updated_by": { "type": "string" } }, "required": [ "repo_id", "post_item_id", "comment_id", "item_seq", "body_markdown", "author_id", "lifecycle_state", "created_at", "updated_at", "updated_by" ] }, "synckhub_core.types.RepoPostSummary": { "title": "RepoPostSummary", "type": "object", "properties": { "repo_id": { "type": "string" }, "post_item_id": { "type": "string" }, "channel_id": { "type": "string" }, "title": { "type": "string" }, "summary": { "anyOf": [ { "type": "string" }, { "type": "null" } ] }, "body_markdown_blob_id": { "anyOf": [ { "type": "string" }, { "type": "null" } ] }, "audience_class": { "type": "string" }, "comments_allowed": { "type": "boolean" }, "lifecycle_state": { "type": "string" }, "author_id": { "type": "string" }, "published_at": { "anyOf": [ { "type": "string" }, { "type": "null" } ] }, "published_by": { "anyOf": [ { "type": "string" }, { "type": "null" } ] }, "published_repo_seq": { "anyOf": [ { "type": "integer" }, { "type": "null" } ] }, "updated_at": { "type": "string" }, "updated_by": { "type": "string" }, "unread": { "type": "boolean" }, "comment_count": { "type": "integer" } }, "required": [ "repo_id", "post_item_id", "channel_id", "title", "audience_class", "comments_allowed", "lifecycle_state", "author_id", "updated_at", "updated_by" ] }, "synckhub_server.routes.repo_posts.MarkReadResponse": { "title": "MarkReadResponse", "type": "object", "properties": { "ok": { "type": "boolean" } }, "required": [ "ok" ] }, "synckhub_server.routes.repo_posts.ReconcilePostAssetsRequest": { "title": "ReconcilePostAssetsRequest", "type": "object", "properties": { "referenced_asset_ids": { "type": "array", "items": { "type": "string" } } }, "required": [ "referenced_asset_ids" ], "additionalProperties": false }, "synckhub_server.routes.repo_posts.CreatePostAssetRequest": { "title": "CreatePostAssetRequest", "type": "object", "properties": { "filename": { "anyOf": [ { "type": "string" }, { "type": "null" } ] }, "media_type": { "anyOf": [ { "type": "string" }, { "type": "null" } ] }, "content_base64": { "type": "string" } }, "required": [ "content_base64" ], "additionalProperties": false }, "synckhub_server.routes.repo_posts.CreatePostAssetResponse": { "title": "CreatePostAssetResponse", "type": "object", "properties": { "asset": { "$ref": "#/components/schemas/synckhub_core.types.RepoPostAssetSummary" }, "markdown_url": { "type": "string" } }, "required": [ "asset", "markdown_url" ] }, "synckhub_core.types.RepoPostAssetSummary": { "title": "RepoPostAssetSummary", "type": "object", "properties": { "repo_id": { "type": "string" }, "post_item_id": { "type": "string" }, "asset_id": { "type": "string" }, "blob_id": { "type": "string" }, "media_type": { "anyOf": [ { "type": "string" }, { "type": "null" } ] }, "filename": { "anyOf": [ { "type": "string" }, { "type": "null" } ] }, "size": { "anyOf": [ { "type": "integer" }, { "type": "null" } ] }, "lifecycle_state": { "type": "string" }, "created_at": { "type": "string" }, "created_by": { "type": "string" } }, "required": [ "repo_id", "post_item_id", "asset_id", "blob_id", "lifecycle_state", "created_at", "created_by" ] }, "synckhub_server.routes.repo_posts.UpdatePostRequest": { "title": "UpdatePostRequest", "type": "object", "properties": { "title": { "anyOf": [ { "type": "string" }, { "type": "null" } ] }, "summary": { "anyOf": [ { "type": "string" }, { "type": "null" } ] }, "body_markdown_blob_id": { "anyOf": [ { "type": "string" }, { "type": "null" } ] }, "audience_class": { "anyOf": [ { "type": "string" }, { "type": "null" } ] }, "comments_allowed": { "anyOf": [ { "type": "boolean" }, { "type": "null" } ] } }, "additionalProperties": false }, "synckhub_core.types.RepoPostDetail": { "title": "RepoPostDetail", "type": "object", "properties": { "post": { "$ref": "#/components/schemas/synckhub_core.types.RepoPostSummary" }, "comments": { "type": "array", "items": { "$ref": "#/components/schemas/synckhub_core.types.RepoPostCommentSummary" } } }, "required": [ "post", "comments" ] }, "synckhub_server.routes.repo_posts.CreatePostBodyBlobRequest": { "title": "CreatePostBodyBlobRequest", "type": "object", "properties": { "body_markdown": { "type": "string" } }, "required": [ "body_markdown" ], "additionalProperties": false }, "synckhub_server.routes.repo_posts.CreatePostBodyBlobResponse": { "title": "CreatePostBodyBlobResponse", "type": "object", "properties": { "blob_id": { "type": "string" }, "size": { "type": "integer", "minimum": 0 } }, "required": [ "blob_id", "size" ] }, "synckhub_server.routes.repo_posts.MarkReadRequest": { "title": "MarkReadRequest", "type": "object", "properties": { "channel_id": { "anyOf": [ { "type": "string" }, { "type": "null" } ] }, "read_through_published_repo_seq": { "anyOf": [ { "type": "integer" }, { "type": "null" } ] } }, "additionalProperties": false }, "synckhub_server.routes.repo_posts.CreatePostRequest": { "title": "CreatePostRequest", "type": "object", "properties": { "channel_id": { "anyOf": [ { "type": "string" }, { "type": "null" } ] }, "title": { "type": "string" }, "summary": { "anyOf": [ { "type": "string" }, { "type": "null" } ] }, "body_markdown_blob_id": { "type": "string" }, "audience_class": { "type": "string" }, "comments_allowed": { "type": "boolean" } }, "required": [ "title", "body_markdown_blob_id" ], "additionalProperties": false }, "synckhub_core.types.RepoPostFeedPage": { "title": "RepoPostFeedPage", "type": "object", "properties": { "posts": { "type": "array", "items": { "$ref": "#/components/schemas/synckhub_core.types.RepoPostSummary" } }, "unread_count": { "type": "integer" }, "max_visible_published_repo_seq": { "type": "integer" } }, "required": [ "posts", "unread_count", "max_visible_published_repo_seq" ] }, "synckhub_server.routes.repo_posts.SetPublishRuleRequest": { "title": "SetPublishRuleRequest", "type": "object", "properties": { "subject_kind": { "type": "string" }, "subject_id": { "type": "string" }, "allow": { "type": "boolean" }, "event_uuid": { "anyOf": [ { "type": "string" }, { "type": "null" } ] } }, "required": [ "subject_kind", "subject_id" ], "additionalProperties": false }, "synckhub_core.types.RepoPostPublishRuleSummary": { "title": "RepoPostPublishRuleSummary", "type": "object", "properties": { "repo_id": { "type": "string" }, "channel_id": { "type": "string" }, "subject_kind": { "type": "string" }, "subject_id": { "type": "string" } }, "required": [ "repo_id", "channel_id", "subject_kind", "subject_id" ] }, "synckhub_core.types.RepoPostChannelSummary": { "title": "RepoPostChannelSummary", "type": "object", "properties": { "repo_id": { "type": "string" }, "channel_id": { "type": "string" }, "display_name": { "type": "string" }, "name_key": { "type": "string" }, "lifecycle_state": { "type": "string" } }, "required": [ "repo_id", "channel_id", "display_name", "name_key", "lifecycle_state" ] }, "synckhub_server.routes.repo_posts.CreateChannelRequest": { "title": "CreateChannelRequest", "type": "object", "properties": { "display_name": { "type": "string" } }, "required": [ "display_name" ], "additionalProperties": false }, "synckhub_server.routes.repo_settings.PatchRepoSettingsRequest": { "title": "PatchRepoSettingsRequest", "type": "object", "properties": { "case_terminology_key": { "anyOf": [ { "type": "string" }, { "type": "null" } ] }, "allow_case_custom_folders": { "anyOf": [ { "type": "boolean" }, { "type": "null" } ] }, "case_default_lifecycle_mode": { "anyOf": [ { "type": "string" }, { "type": "null" } ] }, "company_default_columns": { "anyOf": [ { "type": "array", "items": { "type": "string" } }, { "type": "null" } ] }, "case_default_columns": { "anyOf": [ { "type": "array", "items": { "type": "string" } }, { "type": "null" } ] }, "time_zone": { "anyOf": [ { "type": "string" }, { "type": "null" } ] }, "regional_default_language": { "anyOf": [ { "type": "string" }, { "type": "null" } ] }, "regional_default_number_format": { "anyOf": [ { "type": "string" }, { "type": "null" } ] }, "regional_default_date_format": { "anyOf": [ { "type": "string" }, { "type": "null" } ] }, "regional_default_time_format": { "anyOf": [ { "type": "string" }, { "type": "null" } ] }, "regional_default_time_zone": { "anyOf": [ { "type": "string" }, { "type": "null" } ] }, "regional_default_first_day": { "anyOf": [ { "type": "string" }, { "type": "null" } ] }, "required_spellcheck_dictionaries": { "anyOf": [ { "type": "array", "items": { "type": "string" } }, { "type": "null" } ] }, "mail_compose_font_family": { "anyOf": [ { "anyOf": [ { "type": "string" }, { "type": "null" } ] }, { "type": "null" } ] }, "mail_compose_font_size_pt": { "anyOf": [ { "anyOf": [ { "type": "integer" }, { "type": "null" } ] }, { "type": "null" } ] } }, "additionalProperties": false }, "synckhub_server.routes.repo_settings.RepoSettingsResponse": { "title": "RepoSettingsResponse", "type": "object", "properties": { "repo_id": { "type": "string" }, "case_terminology_key": { "type": "string" }, "allow_case_custom_folders": { "type": "boolean" }, "case_default_lifecycle_mode": { "type": "string" }, "company_default_columns": { "type": "array", "items": { "type": "string" } }, "case_default_columns": { "type": "array", "items": { "type": "string" } }, "time_zone": { "type": "string" }, "regional_default_language": { "type": "string" }, "regional_default_number_format": { "type": "string" }, "regional_default_date_format": { "type": "string" }, "regional_default_time_format": { "type": "string" }, "regional_default_time_zone": { "type": "string" }, "regional_default_first_day": { "type": "string" }, "required_spellcheck_dictionaries": { "type": "array", "items": { "type": "string" } }, "mail_compose_font_family": { "anyOf": [ { "type": "string" }, { "type": "null" } ] }, "mail_compose_font_size_pt": { "anyOf": [ { "type": "integer" }, { "type": "null" } ] }, "tenant_default_mail_compose_font_family": { "type": "string" }, "tenant_default_mail_compose_font_size_pt": { "type": "integer" }, "effective_mail_compose_font_family": { "type": "string" }, "effective_mail_compose_font_size_pt": { "type": "integer" }, "tenant_default_sent_email_synckhub_action": { "type": "string" }, "tenant_default_compose_language": { "type": "string" }, "tenant_default_max_total_attachment_bytes": { "type": "integer" } }, "required": [ "repo_id", "case_terminology_key", "allow_case_custom_folders", "case_default_lifecycle_mode", "company_default_columns", "case_default_columns", "time_zone", "regional_default_language", "regional_default_number_format", "regional_default_date_format", "regional_default_time_format", "regional_default_time_zone", "regional_default_first_day", "required_spellcheck_dictionaries", "tenant_default_mail_compose_font_family", "tenant_default_mail_compose_font_size_pt", "effective_mail_compose_font_family", "effective_mail_compose_font_size_pt", "tenant_default_sent_email_synckhub_action", "tenant_default_compose_language", "tenant_default_max_total_attachment_bytes" ] }, "synckhub_server.routes.repository_storage.Request": { "title": "Request", "type": "object", "properties": { "operation": { "$ref": "#/components/schemas/synckhub_server.routes.repository_storage.Operation" } }, "required": [ "operation" ], "additionalProperties": false }, "synckhub_server.routes.repository_storage.Operation": { "title": "Operation", "type": "string", "enum": [ "start", "advance" ] }, "synckhub_server.routes.retrieval.AgentPeekHitRequest": { "title": "AgentPeekHitRequest", "type": "object", "properties": { "repo_id": { "type": "string" }, "evidence_ref": { "$ref": "#/components/schemas/synckhub_server.routes.retrieval.AgentEvidenceRefInput" }, "before_chunks": { "type": "integer", "minimum": 0 }, "after_chunks": { "type": "integer", "minimum": 0 }, "max_chars": { "anyOf": [ { "type": "integer", "minimum": 0 }, { "type": "null" } ] } }, "required": [ "repo_id", "evidence_ref" ], "additionalProperties": false }, "synckhub_server.routes.retrieval.AgentEvidenceRefInput": { "title": "AgentEvidenceRefInput", "type": "object", "properties": { "repo_id": { "type": "string" }, "index_generation_id": { "type": "string" }, "doc_id": { "type": "string" }, "item_id": { "type": "string" }, "content_source": { "type": "string" }, "content_repo_seq": { "type": "integer" }, "source_subitem": { "anyOf": [ {}, { "type": "null" } ] }, "mount_id": { "anyOf": [ { "type": "string" }, { "type": "null" } ] }, "backend_index_uid": { "anyOf": [ { "type": "string" }, { "type": "null" } ] }, "indexed_at": { "anyOf": [ { "type": "string" }, { "type": "null" } ] } }, "required": [ "repo_id", "index_generation_id", "doc_id", "item_id", "content_source", "content_repo_seq" ], "additionalProperties": false }, "synckhub_server.routes.retrieval.AgentReadHitsResponse": { "title": "AgentReadHitsResponse", "type": "object", "properties": { "repo_id": { "type": "string" }, "hits": { "type": "array", "items": { "$ref": "#/components/schemas/synckhub_server.routes.retrieval.AgentReadHitResult" } }, "truncated": { "type": "boolean" } }, "required": [ "repo_id", "hits", "truncated" ], "additionalProperties": false }, "synckhub_server.routes.retrieval.AgentReadHitResult": { "title": "AgentReadHitResult", "type": "object", "properties": { "request_index": { "type": "integer", "minimum": 0 }, "evidence_ref": { "$ref": "#/components/schemas/synckhub_server.routes.retrieval.AgentEvidenceRef" }, "status": { "type": "string" }, "content": { "anyOf": [ { "type": "string" }, { "type": "null" } ] }, "title": { "anyOf": [ { "type": "string" }, { "type": "null" } ] }, "section_path": { "anyOf": [ { "type": "array", "items": { "type": "string" } }, { "type": "null" } ] }, "location": { "anyOf": [ { "$ref": "#/components/schemas/synckhub_server.routes.retrieval.AgentPassageLocation" }, { "type": "null" } ] } }, "required": [ "request_index", "evidence_ref", "status" ], "additionalProperties": false }, "synckhub_server.routes.retrieval.AgentEvidenceRef": { "title": "AgentEvidenceRef", "type": "object", "properties": { "repo_id": { "type": "string" }, "index_generation_id": { "type": "string" }, "doc_id": { "type": "string" }, "item_id": { "type": "string" }, "content_source": { "type": "string" }, "content_repo_seq": { "type": "integer" }, "source_subitem": { "anyOf": [ {}, { "type": "null" } ] }, "mount_id": { "anyOf": [ { "type": "string" }, { "type": "null" } ] }, "backend_index_uid": { "anyOf": [ { "type": "string" }, { "type": "null" } ] }, "indexed_at": { "anyOf": [ { "type": "string" }, { "type": "null" } ] } }, "required": [ "repo_id", "index_generation_id", "doc_id", "item_id", "content_source", "content_repo_seq" ], "additionalProperties": false }, "synckhub_server.routes.retrieval.AgentPassageLocation": { "title": "AgentPassageLocation", "type": "object", "properties": { "title": { "anyOf": [ { "type": "string" }, { "type": "null" } ] }, "section_path": { "anyOf": [ { "type": "array", "items": { "type": "string" } }, { "type": "null" } ] }, "extraction_method": { "anyOf": [ { "type": "string" }, { "type": "null" } ] }, "pdf_page_start": { "anyOf": [ { "type": "integer" }, { "type": "null" } ] }, "pdf_page_end": { "anyOf": [ { "type": "integer" }, { "type": "null" } ] }, "ppt_slide": { "anyOf": [ { "type": "integer" }, { "type": "null" } ] }, "xlsx_sheet": { "anyOf": [ { "type": "string" }, { "type": "null" } ] }, "xlsx_range_a1": { "anyOf": [ { "type": "string" }, { "type": "null" } ] }, "docx_paragraph_start": { "anyOf": [ { "type": "integer" }, { "type": "null" } ] }, "docx_paragraph_end": { "anyOf": [ { "type": "integer" }, { "type": "null" } ] }, "docx_table_index": { "anyOf": [ { "type": "integer" }, { "type": "null" } ] } }, "additionalProperties": false }, "synckhub_server.routes.retrieval.AgentReadHitsRequest": { "title": "AgentReadHitsRequest", "type": "object", "properties": { "repo_id": { "type": "string" }, "hits": { "type": "array", "items": { "$ref": "#/components/schemas/synckhub_server.routes.retrieval.AgentEvidenceRefInput" } }, "max_chars": { "anyOf": [ { "type": "integer", "minimum": 0 }, { "type": "null" } ] } }, "required": [ "repo_id", "hits" ], "additionalProperties": false }, "synckhub_server.routes.retrieval.AgentTextSearchMultiRequest": { "title": "AgentTextSearchMultiRequest", "type": "object", "properties": { "repo_id": { "type": "string" }, "scope": { "$ref": "#/components/schemas/synckhub_server.routes.retrieval.AgentScope" }, "queries": { "type": "array", "items": { "$ref": "#/components/schemas/synckhub_server.routes.retrieval.AgentTextSearchQuery" } }, "include_items": { "anyOf": [ { "type": "boolean" }, { "type": "null" } ] }, "include_breadcrumbs": { "anyOf": [ { "type": "boolean" }, { "type": "null" } ] } }, "required": [ "repo_id", "scope", "queries" ], "additionalProperties": false }, "synckhub_server.routes.retrieval.AgentScope": { "title": "AgentScope", "oneOf": [ { "type": "object", "properties": { "kind": { "const": "root" }, "recursive": { "type": "boolean" } }, "required": [ "kind" ], "additionalProperties": false }, { "type": "object", "properties": { "kind": { "const": "item_id" }, "id": { "type": "string" } }, "required": [ "kind", "id" ], "additionalProperties": false }, { "type": "object", "properties": { "kind": { "const": "folder_path" }, "path": { "type": "string" }, "recursive": { "type": "boolean" } }, "required": [ "kind", "path" ], "additionalProperties": false }, { "type": "object", "properties": { "kind": { "const": "folder_id" }, "id": { "type": "string" }, "recursive": { "type": "boolean" } }, "required": [ "kind", "id" ], "additionalProperties": false } ] }, "synckhub_server.routes.retrieval.AgentTextSearchQuery": { "title": "AgentTextSearchQuery", "type": "object", "properties": { "q": { "type": "string" }, "item_type": { "anyOf": [ { "type": "string" }, { "type": "null" } ] }, "in_trash": { "anyOf": [ { "type": "boolean" }, { "type": "null" } ] }, "tombstoned": { "anyOf": [ { "type": "boolean" }, { "type": "null" } ] }, "top_k": { "anyOf": [ { "type": "integer", "minimum": 0 }, { "type": "null" } ] }, "path_or_name_includes_any": { "type": "array", "items": { "type": "string" } }, "path_or_name_excludes_any": { "type": "array", "items": { "type": "string" } } }, "required": [ "q" ], "additionalProperties": false }, "synckhub_server.routes.retrieval.AgentTextSearchMultiResponse": { "title": "AgentTextSearchMultiResponse", "type": "object", "properties": { "repo_id": { "type": "string" }, "resolved_scope": { "$ref": "#/components/schemas/synckhub_server.routes.retrieval.AgentResolvedScope" }, "results": { "type": "array", "items": { "$ref": "#/components/schemas/synckhub_server.routes.retrieval.AgentTextSearchResult" } }, "items": { "anyOf": [ { "type": "array", "items": { "$ref": "#/components/schemas/synckhub_core.types.ItemSummary" } }, { "type": "null" } ] } }, "required": [ "repo_id", "resolved_scope", "results" ], "additionalProperties": false }, "synckhub_server.routes.retrieval.AgentResolvedScope": { "title": "AgentResolvedScope", "type": "object", "properties": { "kind": { "type": "string" }, "item_id": { "anyOf": [ { "type": "string" }, { "type": "null" } ] }, "folder_id": { "anyOf": [ { "type": "string" }, { "type": "null" } ] }, "folder_path": { "anyOf": [ { "type": "string" }, { "type": "null" } ] }, "recursive": { "type": "boolean" }, "breadcrumbs": { "anyOf": [ { "type": "array", "items": { "$ref": "#/components/schemas/synckhub_core.types.BreadcrumbEntry" } }, { "type": "null" } ] } }, "required": [ "kind", "recursive" ], "additionalProperties": false }, "synckhub_server.routes.retrieval.AgentTextSearchResult": { "title": "AgentTextSearchResult", "type": "object", "properties": { "q": { "type": "string" }, "hits": { "type": "array", "items": { "$ref": "#/components/schemas/synckhub_server.routes.retrieval.AgentPassageHit" } }, "returned": { "type": "integer", "minimum": 0 }, "diagnostic": { "type": "string" } }, "required": [ "q", "hits", "returned", "diagnostic" ], "additionalProperties": false }, "synckhub_server.routes.retrieval.AgentPassageHit": { "title": "AgentPassageHit", "type": "object", "properties": { "evidence_ref": { "$ref": "#/components/schemas/synckhub_server.routes.retrieval.AgentEvidenceRef" }, "matched_query": { "type": "string" }, "item_id": { "type": "string" }, "doc_id": { "type": "string" }, "content_source": { "type": "string" }, "snippet": { "type": "string" }, "item": { "$ref": "#/components/schemas/synckhub_core.types.ItemSummary" }, "score": { "anyOf": [ { "type": "number" }, { "type": "null" } ] }, "location": { "anyOf": [ { "$ref": "#/components/schemas/synckhub_server.routes.retrieval.AgentPassageLocation" }, { "type": "null" } ] }, "structured_location_available": { "type": "boolean" }, "section_location_available": { "type": "boolean" }, "attachment_filename": { "anyOf": [ { "type": "string" }, { "type": "null" } ] }, "attachment_item_seq": { "anyOf": [ { "type": "integer" }, { "type": "null" } ] } }, "required": [ "evidence_ref", "matched_query", "item_id", "doc_id", "content_source", "snippet", "item", "structured_location_available", "section_location_available" ], "additionalProperties": false }, "synckhub_server.routes.rtc.CommandRequest": { "title": "CommandRequest", "type": "object", "properties": { "command_id": { "type": "string", "format": "uuid" }, "native_answer_device_id": { "anyOf": [ { "type": "string" }, { "type": "null" } ] } }, "required": [ "command_id" ], "additionalProperties": false }, "synckhub_server.routes.rtc.CallDetail": { "title": "CallDetail", "type": "object", "properties": { "repo_id": { "type": "string" }, "call_id": { "type": "string" }, "transport": { "$ref": "#/components/schemas/synckhub_core.calls.Transport" }, "media": { "$ref": "#/components/schemas/synckhub_core.calls.Media" }, "chat_item_id": { "anyOf": [ { "type": "string" }, { "type": "null" } ] }, "chat_item_seq": { "anyOf": [ { "type": "integer" }, { "type": "null" } ] }, "version": { "type": "integer" }, "state": { "type": "string" }, "my_participant_state": { "anyOf": [ { "type": "string" }, { "type": "null" } ] }, "created_by": { "type": "string" }, "created_at": { "type": "string" }, "expires_at": { "type": "string" }, "accepted_at": { "anyOf": [ { "type": "string" }, { "type": "null" } ] }, "ended_at": { "anyOf": [ { "type": "string" }, { "type": "null" } ] }, "can_join": { "type": "boolean" }, "can_publish": { "type": "boolean" }, "can_end": { "type": "boolean" } }, "required": [ "repo_id", "call_id", "transport", "media", "version", "state", "created_by", "created_at", "expires_at", "can_join", "can_publish", "can_end" ] }, "synckhub_core.calls.Transport": { "title": "Transport", "type": "string", "enum": [ "DIRECT_P2P", "GROUP_LIVEKIT" ] }, "synckhub_core.calls.Media": { "title": "Media", "type": "string", "enum": [ "AUDIO", "VIDEO" ] }, "synckhub_server.routes.rtc.JoinSession": { "title": "JoinSession", "oneOf": [ { "type": "object", "properties": { "transport": { "const": "GROUP_LIVEKIT" }, "url": { "type": "string" }, "room_name": { "type": "string" }, "identity": { "type": "string" }, "token": { "type": "string" }, "expires_at": { "type": "string" }, "can_publish": { "type": "boolean" }, "can_subscribe": { "type": "boolean" } }, "required": [ "transport", "url", "room_name", "identity", "token", "expires_at", "can_publish", "can_subscribe" ] }, { "type": "object", "properties": { "transport": { "const": "DIRECT_P2P" }, "signaling_path": { "type": "string" }, "ice_servers": { "type": "array", "items": { "$ref": "#/components/schemas/synckhub_server.routes.rtc.IceServer" } }, "role": { "type": "string" }, "local_principal_id": { "type": "string" }, "remote_principal_id": { "type": "string" }, "expires_at": { "type": "string" } }, "required": [ "transport", "signaling_path", "ice_servers", "role", "local_principal_id", "remote_principal_id", "expires_at" ] } ] }, "synckhub_server.routes.rtc.IceServer": { "title": "IceServer", "type": "object", "properties": { "urls": { "type": "array", "items": { "type": "string" } } }, "required": [ "urls" ] }, "synckhub_server.routes.rtc.CreateRequest": { "title": "CreateRequest", "type": "object", "properties": { "command_id": { "type": "string", "format": "uuid" }, "origin": { "$ref": "#/components/schemas/synckhub_core.calls.Origin" }, "media": { "$ref": "#/components/schemas/synckhub_core.calls.Media" }, "transport": { "$ref": "#/components/schemas/synckhub_core.calls.Transport" } }, "required": [ "command_id", "origin", "media", "transport" ], "additionalProperties": false }, "synckhub_core.calls.Origin": { "title": "Origin", "oneOf": [ { "type": "object", "properties": { "kind": { "const": "STANDALONE" }, "recipient_id": { "type": "string" } }, "required": [ "kind", "recipient_id" ], "additionalProperties": false }, { "type": "object", "properties": { "kind": { "const": "DIRECT" }, "chat_item_id": { "type": "string" }, "recipient_id": { "type": "string" } }, "required": [ "kind", "chat_item_id", "recipient_id" ], "additionalProperties": false }, { "type": "object", "properties": { "kind": { "const": "ROOM" }, "chat_item_id": { "type": "string" } }, "required": [ "kind", "chat_item_id" ], "additionalProperties": false } ] }, "synckhub_server.routes.rtc_history.Filter": { "title": "Filter", "type": "string", "enum": [ "all", "missed" ] }, "synckhub_server.routes.rtc_history.Response": { "title": "Response", "type": "object", "properties": { "items": { "type": "array", "items": { "$ref": "#/components/schemas/synckhub_server.routes.rtc_history.Item" } }, "next_cursor": { "anyOf": [ { "type": "string" }, { "type": "null" } ] }, "as_of": { "type": "string", "format": "date-time" } }, "required": [ "items", "as_of" ] }, "synckhub_server.routes.rtc_history.Item": { "title": "Item", "type": "object", "properties": { "repo_id": { "type": "string", "format": "uuid" }, "chat_item_id": { "anyOf": [ { "type": "string", "format": "uuid" }, { "type": "null" } ] }, "metadata_item_seq": { "anyOf": [ { "type": "integer" }, { "type": "null" } ] }, "call_id": { "type": "string", "format": "uuid" }, "chat_kind": { "type": "string" }, "call_created_at": { "type": "string", "format": "date-time" }, "direction": { "type": "string" }, "outcome": { "type": "string" }, "transport": { "$ref": "#/components/schemas/synckhub_core.calls.Transport" }, "callback_recipient_id": { "anyOf": [ { "type": "string" }, { "type": "null" } ] }, "display": { "$ref": "#/components/schemas/synckhub_server.routes.chat.rooms.ChatDisplaySummary" }, "can_start_call": { "type": "boolean" } }, "required": [ "repo_id", "call_id", "chat_kind", "call_created_at", "direction", "outcome", "transport", "display", "can_start_call" ] }, "synckhub_server.routes.rtc.Capabilities": { "title": "Capabilities", "type": "object", "properties": { "call_protocol": { "type": "string" }, "direct_p2p": { "type": "boolean" }, "group_livekit": { "type": "boolean" } }, "required": [ "call_protocol", "direct_p2p", "group_livekit" ] }, "synckhub_server.security_alerts.PatchRepoSecurityAlertPolicyBody": { "title": "PatchRepoSecurityAlertPolicyBody", "type": "object", "properties": { "enabled": { "anyOf": [ { "anyOf": [ { "type": "boolean" }, { "type": "null" } ] }, { "type": "null" } ] }, "email_delivery_enabled": { "anyOf": [ { "anyOf": [ { "type": "boolean" }, { "type": "null" } ] }, { "type": "null" } ] }, "in_app_delivery_enabled": { "anyOf": [ { "anyOf": [ { "type": "boolean" }, { "type": "null" } ] }, { "type": "null" } ] }, "user_file_download_count_threshold": { "anyOf": [ { "anyOf": [ { "type": "integer" }, { "type": "null" } ] }, { "type": "null" } ] }, "user_package_download_count_threshold": { "anyOf": [ { "anyOf": [ { "type": "integer" }, { "type": "null" } ] }, { "type": "null" } ] }, "user_package_download_size_bytes_threshold": { "anyOf": [ { "anyOf": [ { "type": "integer" }, { "type": "null" } ] }, { "type": "null" } ] }, "daily_volume_alerts_enabled": { "anyOf": [ { "anyOf": [ { "type": "boolean" }, { "type": "null" } ] }, { "type": "null" } ] }, "user_file_download_daily_count_threshold": { "anyOf": [ { "anyOf": [ { "type": "integer" }, { "type": "null" } ] }, { "type": "null" } ] }, "user_package_download_daily_count_threshold": { "anyOf": [ { "anyOf": [ { "type": "integer" }, { "type": "null" } ] }, { "type": "null" } ] }, "recipient_selectors": { "anyOf": [ { "anyOf": [ { "type": "array", "items": { "type": "string" } }, { "type": "null" } ] }, { "type": "null" } ] }, "explicit_recipient_user_ids": { "anyOf": [ { "anyOf": [ { "type": "array", "items": { "type": "string" } }, { "type": "null" } ] }, { "type": "null" } ] }, "explicit_recipient_emails": { "anyOf": [ { "anyOf": [ { "type": "array", "items": { "type": "string" } }, { "type": "null" } ] }, { "type": "null" } ] } } }, "synckhub_server.security_alerts.RepoSecurityAlertPolicyResponse": { "title": "RepoSecurityAlertPolicyResponse", "type": "object", "properties": { "repo_id": { "type": "string" }, "repo_display_name": { "type": "string" }, "owner_tenant_id": { "anyOf": [ { "type": "string" }, { "type": "null" } ] }, "effective": {}, "repo_override": {} }, "required": [ "repo_id", "repo_display_name", "effective", "repo_override" ] }, "synckhub_server.security_alerts.PatchSecurityAlertStatusBody": { "title": "PatchSecurityAlertStatusBody", "type": "object", "properties": { "status": { "type": "string" } }, "required": [ "status" ] }, "synckhub_server.security_alerts.SecurityAlertResponse": { "title": "SecurityAlertResponse", "type": "object", "properties": { "alert_id": { "type": "string" }, "repo_id": { "type": "string" }, "rule_key": { "type": "string" }, "severity": { "type": "string" }, "status": { "type": "string" }, "window_start": { "type": "string" }, "window_end": { "type": "string" }, "actor_id": { "anyOf": [ { "type": "string" }, { "type": "null" } ] }, "subject": {}, "evidence": {}, "policy_snapshot": {}, "created_at": { "type": "string" }, "updated_at": { "type": "string" }, "deliveries": { "type": "array", "items": { "$ref": "#/components/schemas/synckhub_server.security_alerts.SecurityAlertDeliveryResponse" } } }, "required": [ "alert_id", "repo_id", "rule_key", "severity", "status", "window_start", "window_end", "subject", "evidence", "policy_snapshot", "created_at", "updated_at", "deliveries" ] }, "synckhub_server.security_alerts.SecurityAlertDeliveryResponse": { "title": "SecurityAlertDeliveryResponse", "type": "object", "properties": { "delivery_id": { "type": "string" }, "channel": { "type": "string" }, "recipient_key": { "type": "string" }, "recipient_user_id": { "anyOf": [ { "type": "string" }, { "type": "null" } ] }, "recipient_email": { "type": "string" }, "recipient_name": { "anyOf": [ { "type": "string" }, { "type": "null" } ] }, "status": { "type": "string" }, "attempt_count": { "type": "integer" }, "last_error": { "anyOf": [ { "type": "string" }, { "type": "null" } ] }, "sent_at": { "anyOf": [ { "type": "string" }, { "type": "null" } ] } }, "required": [ "delivery_id", "channel", "recipient_key", "recipient_email", "status", "attempt_count" ] }, "synckhub_server.shared_folder_links.PublicSharedFolderStatsResponse": { "title": "PublicSharedFolderStatsResponse", "type": "object", "properties": { "folder_id": { "type": "string" }, "contains": { "$ref": "#/components/schemas/synckhub_server.folder_stats.FolderStatsSummary" }, "including_subfolders": { "$ref": "#/components/schemas/synckhub_server.folder_stats.FolderStatsSummary" } }, "required": [ "folder_id", "contains", "including_subfolders" ], "additionalProperties": false }, "synckhub_server.shared_folder_links.PublicSharedFolderAncestorResponse": { "title": "PublicSharedFolderAncestorResponse", "type": "object", "properties": { "folder_id": { "type": "string" }, "name": { "type": "string" } }, "required": [ "folder_id", "name" ], "additionalProperties": false }, "synckhub_server.shared_folder_links.PublicCreateDownloadUrlRequest": { "title": "PublicCreateDownloadUrlRequest", "type": "object", "properties": { "item_ids": { "type": "array", "items": { "type": "string" } } }, "additionalProperties": false }, "synckhub_server.shared_folder_links.UnlockSharedFolderLinkRequest": { "title": "UnlockSharedFolderLinkRequest", "type": "object", "properties": { "password": { "type": "string" } }, "required": [ "password" ], "additionalProperties": false }, "synckhub_server.shared_folder_links.UnlockSharedFolderLinkResponse": { "title": "UnlockSharedFolderLinkResponse", "type": "object", "properties": { "access_token": { "type": "string" }, "expires_at": { "type": "string" } }, "required": [ "access_token", "expires_at" ], "additionalProperties": false }, "synckhub_server.shared_folder_links.PublicSharedFolderLinkMetaResponse": { "title": "PublicSharedFolderLinkMetaResponse", "type": "object", "properties": { "tenant_id": { "type": "string" }, "tenant_slug": { "anyOf": [ { "type": "string" }, { "type": "null" } ] }, "reporting_year": { "type": "integer" }, "shared_folder_link_id": { "type": "string" }, "repo_id": { "type": "string" }, "root_folder_id": { "type": "string" }, "root_folder_name": { "anyOf": [ { "type": "string" }, { "type": "null" } ] }, "expires_at": { "anyOf": [ { "type": "string" }, { "type": "null" } ] }, "message": { "anyOf": [ { "type": "string" }, { "type": "null" } ] }, "password_required": { "type": "boolean" } }, "required": [ "tenant_id", "reporting_year", "shared_folder_link_id", "repo_id", "root_folder_id", "password_required" ], "additionalProperties": false }, "synckhub_server.folder_auto_join_links.VerifyFolderAutoJoinLinkClaimRequest": { "title": "VerifyFolderAutoJoinLinkClaimRequest", "type": "object", "properties": { "challenge_id": { "type": "string" }, "code": { "type": "string" } }, "required": [ "challenge_id", "code" ], "additionalProperties": false }, "synckhub_server.folder_auto_join_links.VerifyFolderAutoJoinLinkClaimResponse": { "title": "VerifyFolderAutoJoinLinkClaimResponse", "type": "object", "properties": { "outcome": { "type": "string" }, "login_redirect": { "anyOf": [ { "type": "string" }, { "type": "null" } ] }, "access_token": { "anyOf": [ { "type": "string" }, { "type": "null" } ] }, "access_token_expires_at": { "anyOf": [ { "type": "integer" }, { "type": "null" } ] }, "user_id": { "anyOf": [ { "type": "string" }, { "type": "null" } ] }, "invited_tenant_slug": { "anyOf": [ { "type": "string" }, { "type": "null" } ] }, "invited_repo_slug": { "anyOf": [ { "type": "string" }, { "type": "null" } ] }, "invited_repo_id": { "anyOf": [ { "type": "string" }, { "type": "null" } ] }, "joined_folder_id": { "anyOf": [ { "type": "string" }, { "type": "null" } ] }, "joined_folder_name": { "anyOf": [ { "type": "string" }, { "type": "null" } ] } }, "required": [ "outcome" ], "additionalProperties": false }, "synckhub_server.folder_auto_join_links.ResendFolderAutoJoinLinkClaimRequest": { "title": "ResendFolderAutoJoinLinkClaimRequest", "type": "object", "properties": { "challenge_id": { "type": "string" } }, "required": [ "challenge_id" ], "additionalProperties": false }, "synckhub_server.folder_auto_join_links.FolderAutoJoinLinkClaimChallengeResponse": { "title": "FolderAutoJoinLinkClaimChallengeResponse", "type": "object", "properties": { "challenge_id": { "type": "string" }, "challenge_expires_at": { "type": "string" }, "requires_login": { "type": "boolean" } }, "required": [ "challenge_id", "challenge_expires_at", "requires_login" ], "additionalProperties": false }, "synckhub_server.folder_auto_join_links.StartFolderAutoJoinLinkClaimRequest": { "title": "StartFolderAutoJoinLinkClaimRequest", "type": "object", "properties": { "email": { "type": "string" } }, "required": [ "email" ], "additionalProperties": false }, "synckhub_server.folder_auto_join_links.PublicFolderAutoJoinLinkMetaResponse": { "title": "PublicFolderAutoJoinLinkMetaResponse", "type": "object", "properties": { "folder_auto_join_link_id": { "type": "string" }, "repo_id": { "type": "string" }, "root_folder_id": { "type": "string" }, "root_folder_name": { "anyOf": [ { "type": "string" }, { "type": "null" } ] }, "created_by_name": { "anyOf": [ { "type": "string" }, { "type": "null" } ] }, "created_by_email": { "anyOf": [ { "type": "string" }, { "type": "null" } ] }, "expires_at": { "anyOf": [ { "type": "string" }, { "type": "null" } ] }, "message": { "anyOf": [ { "type": "string" }, { "type": "null" } ] }, "cascade": { "type": "boolean" }, "rules": { "type": "array", "items": { "$ref": "#/components/schemas/synckhub_server.folder_auto_join_links.FolderAutoJoinRule" } } }, "required": [ "folder_auto_join_link_id", "repo_id", "root_folder_id", "cascade", "rules" ], "additionalProperties": false }, "synckhub_server.folder_auto_join_links.FolderAutoJoinRule": { "title": "FolderAutoJoinRule", "type": "object", "properties": { "effect": { "type": "string" }, "scope": { "type": "string" }, "target_kind": { "anyOf": [ { "type": "string" }, { "type": "null" } ] }, "actions": { "type": "array", "items": { "type": "string" } } }, "required": [ "effect", "scope", "actions" ], "additionalProperties": false }, "synckhub_server.folder_auto_join_links.OkResponse": { "title": "OkResponse", "type": "object", "properties": { "ok": { "type": "boolean" } }, "required": [ "ok" ], "additionalProperties": false }, "synckhub_server.shared_folder_links.SharedFolderLinkPublicUrlResponse": { "title": "SharedFolderLinkPublicUrlResponse", "type": "object", "properties": { "public_url": { "type": "string" } }, "required": [ "public_url" ], "additionalProperties": false }, "synckhub_server.shared_folder_links.OkResponse": { "title": "OkResponse", "type": "object", "properties": { "ok": { "type": "boolean" } }, "required": [ "ok" ], "additionalProperties": false }, "synckhub_server.permission_approval_threads.PermissionApprovalDetail": { "title": "PermissionApprovalSummary", "type": "object", "properties": { "payload": {}, "entries": { "type": "array", "items": { "$ref": "#/components/schemas/synckhub_server.permission_approval_threads.PermissionApprovalEntry" } }, "request_id": { "type": "string" }, "request_uuid": { "anyOf": [ { "type": "string" }, { "type": "null" } ] }, "thread_kind": { "type": "string" }, "request_kind": { "type": "string" }, "direction": { "type": "string" }, "status": { "type": "string" }, "target_kind": { "type": "string" }, "target_id": { "anyOf": [ { "type": "string" }, { "type": "null" } ] }, "target_label": { "anyOf": [ { "type": "string" }, { "type": "null" } ] }, "requester_user_id": { "type": "string" }, "requester_label": { "anyOf": [ { "type": "string" }, { "type": "null" } ] }, "created_at": { "type": "string" }, "updated_at": { "type": "string" }, "closed_at": { "anyOf": [ { "type": "string" }, { "type": "null" } ] }, "message_count": { "type": "integer" }, "preview_text": { "anyOf": [ { "type": "string" }, { "type": "null" } ] }, "terminal_event": { "anyOf": [ { "type": "string" }, { "type": "null" } ] }, "payload_preview": {}, "applied_result": { "anyOf": [ {}, { "type": "null" } ] } }, "required": [ "payload", "entries", "request_id", "thread_kind", "request_kind", "direction", "status", "target_kind", "requester_user_id", "created_at", "updated_at", "message_count", "payload_preview" ], "additionalProperties": false }, "synckhub_server.permission_approval_threads.PermissionApprovalSummary": { "title": "PermissionApprovalSummary", "type": "object", "properties": { "request_id": { "type": "string" }, "request_uuid": { "anyOf": [ { "type": "string" }, { "type": "null" } ] }, "thread_kind": { "type": "string" }, "request_kind": { "type": "string" }, "direction": { "type": "string" }, "status": { "type": "string" }, "target_kind": { "type": "string" }, "target_id": { "anyOf": [ { "type": "string" }, { "type": "null" } ] }, "target_label": { "anyOf": [ { "type": "string" }, { "type": "null" } ] }, "requester_user_id": { "type": "string" }, "requester_label": { "anyOf": [ { "type": "string" }, { "type": "null" } ] }, "created_at": { "type": "string" }, "updated_at": { "type": "string" }, "closed_at": { "anyOf": [ { "type": "string" }, { "type": "null" } ] }, "message_count": { "type": "integer" }, "preview_text": { "anyOf": [ { "type": "string" }, { "type": "null" } ] }, "terminal_event": { "anyOf": [ { "type": "string" }, { "type": "null" } ] }, "payload_preview": {}, "applied_result": { "anyOf": [ {}, { "type": "null" } ] } }, "required": [ "request_id", "thread_kind", "request_kind", "direction", "status", "target_kind", "requester_user_id", "created_at", "updated_at", "message_count", "payload_preview" ], "additionalProperties": false }, "synckhub_server.permission_approval_threads.PermissionApprovalEntry": { "title": "PermissionApprovalEntry", "type": "object", "properties": { "entry_kind": { "type": "string" }, "event_type": { "anyOf": [ { "type": "string" }, { "type": "null" } ] }, "actor_user_id": { "anyOf": [ { "type": "string" }, { "type": "null" } ] }, "author_user_id": { "anyOf": [ { "type": "string" }, { "type": "null" } ] }, "body": { "anyOf": [ { "type": "string" }, { "type": "null" } ] }, "message_seq": { "anyOf": [ { "type": "integer" }, { "type": "null" } ] }, "event": { "anyOf": [ {}, { "type": "null" } ] }, "created_at": { "type": "string" } }, "required": [ "entry_kind", "created_at" ], "additionalProperties": false }, "synckhub_server.permission_approval_threads.DecidePermissionApprovalRequest": { "title": "DecidePermissionApprovalRequest", "type": "object", "properties": { "decision": { "type": "string" }, "note": { "anyOf": [ { "type": "string" }, { "type": "null" } ] } }, "required": [ "decision" ], "additionalProperties": false }, "synckhub_server.permission_approval_threads.PostPermissionApprovalMessageRequest": { "title": "PostPermissionApprovalMessageRequest", "type": "object", "properties": { "body": { "type": "string" } }, "required": [ "body" ], "additionalProperties": false }, "synckhub_server.permission_approval_threads.CreatePermissionApprovalRequest": { "title": "CreatePermissionApprovalRequest", "type": "object", "properties": { "request_kind": { "type": "string" }, "target_kind": { "type": "string" }, "target_id": { "anyOf": [ { "type": "string" }, { "type": "null" } ] }, "payload": {}, "message": { "anyOf": [ { "type": "string" }, { "type": "null" } ] }, "request_uuid": { "anyOf": [ { "type": "string" }, { "type": "null" } ] }, "request_expires_at": { "anyOf": [ { "type": "string" }, { "type": "null" } ] } }, "required": [ "request_kind", "target_kind", "payload" ], "additionalProperties": false }, "synckhub_server.permission_approval_threads.PermissionApprovalListResponse": { "title": "PermissionApprovalListResponse", "type": "object", "properties": { "requests": { "type": "array", "items": { "$ref": "#/components/schemas/synckhub_server.permission_approval_threads.PermissionApprovalSummary" } }, "next_cursor": { "anyOf": [ { "type": "string" }, { "type": "null" } ] } }, "required": [ "requests" ], "additionalProperties": false }, "synckhub_server.folder_auto_join_links.CreateFolderAutoJoinLinkRequest": { "title": "CreateFolderAutoJoinLinkRequest", "type": "object", "properties": { "root_folder_id": { "type": "string" }, "expires_at": { "anyOf": [ { "type": "string" }, { "type": "null" } ] }, "message": { "anyOf": [ { "type": "string" }, { "type": "null" } ] }, "cascade": { "type": "boolean" }, "rules": { "type": "array", "items": { "$ref": "#/components/schemas/synckhub_server.folder_auto_join_links.FolderAutoJoinRule" } } }, "required": [ "root_folder_id", "cascade" ], "additionalProperties": false }, "synckhub_server.folder_auto_join_links.FolderAutoJoinLinkCreatedResponse": { "title": "FolderAutoJoinLinkSummaryResponse", "type": "object", "properties": { "folder_auto_join_link_token": { "type": "string" }, "folder_auto_join_link_id": { "type": "string" }, "repo_id": { "type": "string" }, "root_folder_id": { "type": "string" }, "root_folder_name": { "anyOf": [ { "type": "string" }, { "type": "null" } ] }, "created_at": { "type": "string" }, "created_by": { "type": "string" }, "created_by_name": { "anyOf": [ { "type": "string" }, { "type": "null" } ] }, "created_by_email": { "anyOf": [ { "type": "string" }, { "type": "null" } ] }, "expires_at": { "anyOf": [ { "type": "string" }, { "type": "null" } ] }, "revoked_at": { "anyOf": [ { "type": "string" }, { "type": "null" } ] }, "message": { "anyOf": [ { "type": "string" }, { "type": "null" } ] }, "cascade": { "type": "boolean" }, "rules": { "type": "array", "items": { "$ref": "#/components/schemas/synckhub_server.folder_auto_join_links.FolderAutoJoinRule" } }, "active_claims": { "anyOf": [ { "type": "integer" }, { "type": "null" } ] }, "total_claims": { "anyOf": [ { "type": "integer" }, { "type": "null" } ] } }, "required": [ "folder_auto_join_link_token", "folder_auto_join_link_id", "repo_id", "root_folder_id", "created_at", "created_by", "cascade", "rules" ], "additionalProperties": false }, "synckhub_server.folder_auto_join_links.FolderAutoJoinLinkSummaryResponse": { "title": "FolderAutoJoinLinkSummaryResponse", "type": "object", "properties": { "folder_auto_join_link_id": { "type": "string" }, "repo_id": { "type": "string" }, "root_folder_id": { "type": "string" }, "root_folder_name": { "anyOf": [ { "type": "string" }, { "type": "null" } ] }, "created_at": { "type": "string" }, "created_by": { "type": "string" }, "created_by_name": { "anyOf": [ { "type": "string" }, { "type": "null" } ] }, "created_by_email": { "anyOf": [ { "type": "string" }, { "type": "null" } ] }, "expires_at": { "anyOf": [ { "type": "string" }, { "type": "null" } ] }, "revoked_at": { "anyOf": [ { "type": "string" }, { "type": "null" } ] }, "message": { "anyOf": [ { "type": "string" }, { "type": "null" } ] }, "cascade": { "type": "boolean" }, "rules": { "type": "array", "items": { "$ref": "#/components/schemas/synckhub_server.folder_auto_join_links.FolderAutoJoinRule" } }, "active_claims": { "anyOf": [ { "type": "integer" }, { "type": "null" } ] }, "total_claims": { "anyOf": [ { "type": "integer" }, { "type": "null" } ] } }, "required": [ "folder_auto_join_link_id", "repo_id", "root_folder_id", "created_at", "created_by", "cascade", "rules" ], "additionalProperties": false }, "synckhub_server.shared_folder_links.CreateSharedFolderLinkRequest": { "title": "CreateSharedFolderLinkRequest", "type": "object", "properties": { "root_folder_id": { "type": "string" }, "expires_at": { "anyOf": [ { "type": "string" }, { "type": "null" } ] }, "password": { "anyOf": [ { "type": "string" }, { "type": "null" } ] }, "message": { "anyOf": [ { "type": "string" }, { "type": "null" } ] }, "tenant_slug": { "anyOf": [ { "type": "string" }, { "type": "null" } ] }, "repo_slug": { "anyOf": [ { "type": "string" }, { "type": "null" } ] } }, "required": [ "root_folder_id" ], "additionalProperties": false }, "synckhub_server.shared_folder_links.SharedFolderLinkCreatedResponse": { "title": "SharedFolderLinkSummaryResponse", "type": "object", "properties": { "shared_folder_link_token": { "type": "string" }, "public_url": { "type": "string" }, "shared_folder_link_id": { "type": "string" }, "repo_id": { "type": "string" }, "root_folder_id": { "type": "string" }, "root_folder_name": { "anyOf": [ { "type": "string" }, { "type": "null" } ] }, "created_at": { "type": "string" }, "created_by": { "type": "string" }, "expires_at": { "anyOf": [ { "type": "string" }, { "type": "null" } ] }, "revoked_at": { "anyOf": [ { "type": "string" }, { "type": "null" } ] }, "message": { "anyOf": [ { "type": "string" }, { "type": "null" } ] }, "password_required": { "type": "boolean" } }, "required": [ "shared_folder_link_token", "public_url", "shared_folder_link_id", "repo_id", "root_folder_id", "created_at", "created_by", "password_required" ], "additionalProperties": false }, "synckhub_server.shared_folder_links.SharedFolderLinkSummaryResponse": { "title": "SharedFolderLinkSummaryResponse", "type": "object", "properties": { "shared_folder_link_id": { "type": "string" }, "repo_id": { "type": "string" }, "root_folder_id": { "type": "string" }, "root_folder_name": { "anyOf": [ { "type": "string" }, { "type": "null" } ] }, "created_at": { "type": "string" }, "created_by": { "type": "string" }, "expires_at": { "anyOf": [ { "type": "string" }, { "type": "null" } ] }, "revoked_at": { "anyOf": [ { "type": "string" }, { "type": "null" } ] }, "message": { "anyOf": [ { "type": "string" }, { "type": "null" } ] }, "password_required": { "type": "boolean" } }, "required": [ "shared_folder_link_id", "repo_id", "root_folder_id", "created_at", "created_by", "password_required" ], "additionalProperties": false }, "synckhub_server.shared_folder_links.VisitRequest": { "title": "VisitRequest", "type": "object", "properties": { "visit_id": { "type": "string", "format": "uuid" } }, "required": [ "visit_id" ], "additionalProperties": false }, "synckhub_server.shared_file_links.UnlockSharedFileLinkRequest": { "title": "UnlockSharedFileLinkRequest", "type": "object", "properties": { "password": { "type": "string" } }, "required": [ "password" ], "additionalProperties": false }, "synckhub_server.shared_file_links.UnlockSharedFileLinkResponse": { "title": "UnlockSharedFileLinkResponse", "type": "object", "properties": { "access_token": { "type": "string" }, "expires_at": { "type": "string" }, "content_url": { "anyOf": [ { "type": "string" }, { "type": "null" } ] }, "content_url_expires_at": { "anyOf": [ { "type": "string" }, { "type": "null" } ] } }, "required": [ "access_token", "expires_at" ], "additionalProperties": false }, "synckhub_server.shared_file_links.PublicFileContentUrlRequest": { "title": "PublicFileContentUrlRequest", "type": "object", "properties": { "content_token": { "anyOf": [ { "type": "string" }, { "type": "null" } ] } }, "additionalProperties": false }, "synckhub_server.shared_file_links.PublicFileContentUrlResponse": { "title": "PublicFileContentUrlResponse", "type": "object", "properties": { "url": { "type": "string" }, "expires_at": { "type": "string" } }, "required": [ "url", "expires_at" ], "additionalProperties": false }, "synckhub_server.shared_file_links.OkResponse": { "title": "OkResponse", "type": "object", "properties": { "ok": { "type": "boolean" } }, "required": [ "ok" ], "additionalProperties": false }, "synckhub_server.shared_file_links.SharedFileLinkListItem": { "title": "SharedFileLinkListItem", "type": "object", "properties": { "shared_file_link_id": { "type": "string" }, "repo_id": { "type": "string" }, "file_id": { "type": "string" }, "file_name": { "anyOf": [ { "type": "string" }, { "type": "null" } ] }, "created_at": { "type": "string" }, "created_by": { "type": "string" }, "revoked_at": { "anyOf": [ { "type": "string" }, { "type": "null" } ] }, "public_url": { "type": "string" }, "password_required": { "type": "boolean" } }, "required": [ "shared_file_link_id", "repo_id", "file_id", "created_at", "created_by", "public_url", "password_required" ], "additionalProperties": false }, "synckhub_server.shared_file_links.PutSharedFileLinkRequest": { "title": "PutSharedFileLinkRequest", "type": "object", "properties": { "tenant_slug": { "anyOf": [ { "type": "string" }, { "type": "null" } ] }, "repo_slug": { "anyOf": [ { "type": "string" }, { "type": "null" } ] }, "password": { "anyOf": [ { "type": "string" }, { "type": "null" } ] } }, "additionalProperties": false }, "synckhub_server.shared_file_links.SharedFileLinkResponse": { "title": "SharedFileLinkResponse", "type": "object", "properties": { "shared_file_link_id": { "type": "string" }, "repo_id": { "type": "string" }, "file_id": { "type": "string" }, "file_name": { "anyOf": [ { "type": "string" }, { "type": "null" } ] }, "created_at": { "type": "string" }, "created_by": { "type": "string" }, "revoked_at": { "anyOf": [ { "type": "string" }, { "type": "null" } ] }, "public_url": { "type": "string" }, "password_required": { "type": "boolean" } }, "required": [ "shared_file_link_id", "repo_id", "file_id", "created_at", "created_by", "public_url", "password_required" ], "additionalProperties": false }, "synckhub_server.shared_file_collections.UnlockRequest": { "title": "UnlockRequest", "type": "object", "properties": { "password": { "type": "string" } }, "required": [ "password" ], "additionalProperties": false }, "synckhub_server.shared_file_collections.OkResponse": { "title": "OkResponse", "type": "object", "properties": { "ok": { "type": "boolean" } }, "required": [ "ok" ] }, "synckhub_server.shared_file_collections.CreateRequest": { "title": "CreateRequest", "type": "object", "properties": { "file_ids": { "type": "array", "items": { "type": "string" } }, "tenant_slug": { "anyOf": [ { "type": "string" }, { "type": "null" } ] }, "repo_slug": { "anyOf": [ { "type": "string" }, { "type": "null" } ] }, "password": { "anyOf": [ { "type": "string" }, { "type": "null" } ] } }, "required": [ "file_ids" ], "additionalProperties": false }, "synckhub_server.shared_file_collections.CollectionSummary": { "title": "CollectionSummary", "type": "object", "properties": { "collection_id": { "type": "string" }, "repo_id": { "type": "string" }, "file_ids": { "type": "array", "items": { "type": "string" } }, "file_names": { "type": "array", "items": { "type": "string" } }, "created_at": { "type": "string" }, "created_by": { "type": "string" }, "revoked_at": { "anyOf": [ { "type": "string" }, { "type": "null" } ] }, "public_url": { "type": "string" }, "password_required": { "type": "boolean" } }, "required": [ "collection_id", "repo_id", "file_ids", "file_names", "created_at", "created_by", "public_url", "password_required" ] }, "synckhub_server.routes.structured_data.PutStructuredDataItemLinkRequest": { "title": "PutStructuredDataItemLinkRequest", "type": "object", "properties": { "database_key": { "type": "string" }, "table_key": { "type": "string" }, "record_id": { "type": "string" } }, "required": [ "database_key", "table_key", "record_id" ], "additionalProperties": false }, "synckhub_server.routes.structured_data.StructuredDataItemLinkResponse": { "title": "StructuredDataItemLinkResponse", "type": "object", "properties": { "link_key": { "type": "string" }, "database_key": { "type": "string" }, "table_key": { "type": "string" }, "record_id": { "type": "string" }, "display_value": { "type": "string" } }, "required": [ "link_key", "database_key", "table_key", "record_id", "display_value" ], "additionalProperties": false }, "synckhub_server.routes.structured_data.ListStructuredDataItemLinksResponse": { "title": "ListStructuredDataItemLinksResponse", "type": "object", "properties": { "links": { "type": "array", "items": { "$ref": "#/components/schemas/synckhub_server.routes.structured_data.StructuredDataItemLinkResponse" } } }, "required": [ "links" ], "additionalProperties": false }, "synckhub_server.routes.structured_data.BatchUpsertStructuredDataRecordsRequest": { "title": "BatchUpsertStructuredDataRecordsRequest", "type": "object", "properties": { "operation_id": { "anyOf": [ { "type": "string" }, { "type": "null" } ] }, "entries": { "type": "array", "items": { "$ref": "#/components/schemas/synckhub_server.routes.structured_data.BatchUpsertStructuredDataRecordEntry" } } }, "required": [ "entries" ], "additionalProperties": false }, "synckhub_server.routes.structured_data.BatchUpsertStructuredDataRecordEntry": { "title": "BatchUpsertStructuredDataRecordEntry", "type": "object", "properties": { "external_key": { "anyOf": [ { "$ref": "#/components/schemas/synckhub_server.routes.structured_data.BatchUpsertStructuredDataExternalKey" }, { "type": "null" } ] }, "record_id": { "anyOf": [ { "type": "string" }, { "type": "null" } ] }, "expected_version": { "anyOf": [ { "type": "integer" }, { "type": "null" } ] }, "data": {}, "lifecycle_state": { "anyOf": [ { "$ref": "#/components/schemas/synckhub_server.routes.structured_data.StructuredDataRecordLifecycleState" }, { "type": "null" } ] } }, "required": [ "data" ], "additionalProperties": false }, "synckhub_server.routes.structured_data.BatchUpsertStructuredDataExternalKey": { "title": "BatchUpsertStructuredDataExternalKey", "type": "object", "properties": { "connector_key": { "type": "string" }, "external_id": { "type": "string" } }, "required": [ "connector_key", "external_id" ], "additionalProperties": false }, "synckhub_server.routes.structured_data.StructuredDataRecordLifecycleState": { "title": "StructuredDataRecordLifecycleState", "type": "string", "enum": [ "DRAFT", "LIVE", "ARCHIVED" ] }, "synckhub_server.routes.structured_data.BatchUpsertStructuredDataRecordsResponse": { "title": "BatchUpsertStructuredDataRecordsResponse", "type": "object", "properties": { "records": { "type": "array", "items": { "$ref": "#/components/schemas/synckhub_server.routes.structured_data.StructuredDataRecordResponse" } } }, "required": [ "records" ], "additionalProperties": false }, "synckhub_server.routes.structured_data.StructuredDataRecordResponse": { "title": "StructuredDataRecordResponse", "type": "object", "properties": { "repo_id": { "type": "string" }, "database_key": { "type": "string" }, "table_key": { "type": "string" }, "record_id": { "type": "string" }, "data": {}, "display_value": { "type": "string" }, "lifecycle_state": { "$ref": "#/components/schemas/synckhub_server.routes.structured_data.StructuredDataRecordLifecycleState" }, "version": { "type": "integer" }, "external_keys": { "type": "array", "items": { "$ref": "#/components/schemas/synckhub_server.routes.structured_data.StructuredDataExternalKey" } }, "created_at": { "type": "string" }, "created_by": { "type": "string" }, "updated_at": { "type": "string" }, "updated_by": { "type": "string" } }, "required": [ "repo_id", "database_key", "table_key", "record_id", "data", "display_value", "lifecycle_state", "version", "external_keys", "created_at", "created_by", "updated_at", "updated_by" ], "additionalProperties": false }, "synckhub_server.routes.structured_data.StructuredDataExternalKey": { "title": "StructuredDataExternalKey", "type": "object", "properties": { "connector_key": { "type": "string" }, "external_id": { "type": "string" } }, "required": [ "connector_key", "external_id" ], "additionalProperties": false }, "synckhub_server.routes.structured_data.CreateStructuredDataRecordCommentRequest": { "title": "CreateStructuredDataRecordCommentRequest", "type": "object", "properties": { "body": { "type": "string" } }, "required": [ "body" ], "additionalProperties": false }, "synckhub_server.routes.structured_data.StructuredDataRecordCommentResponse": { "title": "StructuredDataRecordCommentResponse", "type": "object", "properties": { "comment_id": { "type": "string" }, "repo_id": { "type": "string" }, "database_key": { "type": "string" }, "table_key": { "type": "string" }, "record_id": { "type": "string" }, "body": { "type": "string" }, "created_at": { "type": "string" }, "created_by": { "type": "string" } }, "required": [ "comment_id", "repo_id", "database_key", "table_key", "record_id", "body", "created_at", "created_by" ], "additionalProperties": false }, "synckhub_server.routes.structured_data.ListStructuredDataRecordCommentsResponse": { "title": "ListStructuredDataRecordCommentsResponse", "type": "object", "properties": { "comments": { "type": "array", "items": { "$ref": "#/components/schemas/synckhub_server.routes.structured_data.StructuredDataRecordCommentResponse" } } }, "required": [ "comments" ], "additionalProperties": false }, "synckhub_server.routes.structured_data.ListStructuredDataHistoryResponse": { "title": "ListStructuredDataHistoryResponse", "type": "object", "properties": { "events": { "type": "array", "items": { "$ref": "#/components/schemas/synckhub_server.routes.structured_data.StructuredDataHistoryEntryResponse" } } }, "required": [ "events" ], "additionalProperties": false }, "synckhub_server.routes.structured_data.StructuredDataHistoryEntryResponse": { "title": "StructuredDataHistoryEntryResponse", "type": "object", "properties": { "event_id": { "type": "string" }, "repo_id": { "type": "string" }, "repo_data_seq": { "type": "integer" }, "database_key": { "anyOf": [ { "type": "string" }, { "type": "null" } ] }, "table_key": { "anyOf": [ { "type": "string" }, { "type": "null" } ] }, "record_id": { "anyOf": [ { "type": "string" }, { "type": "null" } ] }, "event_kind": { "type": "string" }, "payload": {}, "created_at": { "type": "string" }, "actor_id": { "type": "string" } }, "required": [ "event_id", "repo_id", "repo_data_seq", "event_kind", "payload", "created_at", "actor_id" ], "additionalProperties": false }, "synckhub_server.routes.structured_data.PutStructuredDataRecordRequest": { "title": "PutStructuredDataRecordRequest", "type": "object", "properties": { "operation_id": { "anyOf": [ { "type": "string" }, { "type": "null" } ] }, "data": {}, "lifecycle_state": { "$ref": "#/components/schemas/synckhub_server.routes.structured_data.StructuredDataRecordLifecycleState" }, "expected_version": { "anyOf": [ { "type": "integer" }, { "type": "null" } ] }, "external_keys": { "anyOf": [ { "type": "array", "items": { "$ref": "#/components/schemas/synckhub_server.routes.structured_data.StructuredDataExternalKey" } }, { "type": "null" } ] } }, "required": [ "data", "lifecycle_state" ], "additionalProperties": false }, "synckhub_server.routes.structured_data.CreateStructuredDataRecordRequest": { "title": "CreateStructuredDataRecordRequest", "type": "object", "properties": { "record_id": { "anyOf": [ { "type": "string" }, { "type": "null" } ] }, "operation_id": { "anyOf": [ { "type": "string" }, { "type": "null" } ] }, "data": {}, "lifecycle_state": { "anyOf": [ { "$ref": "#/components/schemas/synckhub_server.routes.structured_data.StructuredDataRecordLifecycleState" }, { "type": "null" } ] }, "external_keys": { "type": "array", "items": { "$ref": "#/components/schemas/synckhub_server.routes.structured_data.StructuredDataExternalKey" } } }, "required": [ "data" ], "additionalProperties": false }, "synckhub_server.routes.structured_data.QueryStructuredDataRecordsRequest": { "title": "QueryStructuredDataRecordsRequest", "type": "object", "properties": { "filters": { "type": "array", "items": { "$ref": "#/components/schemas/synckhub_server.routes.structured_data.StructuredDataQueryFilter" } }, "sort": { "type": "array", "items": { "$ref": "#/components/schemas/synckhub_server.routes.structured_data.StructuredDataQuerySort" } }, "q": { "anyOf": [ { "type": "string" }, { "type": "null" } ] }, "limit": { "anyOf": [ { "type": "integer" }, { "type": "null" } ] }, "cursor": { "anyOf": [ { "type": "string" }, { "type": "null" } ] }, "include_archived": { "type": "boolean" } }, "additionalProperties": false }, "synckhub_server.routes.structured_data.StructuredDataQueryFilter": { "title": "StructuredDataQueryFilter", "type": "object", "properties": { "field_key": { "type": "string" }, "op": { "$ref": "#/components/schemas/synckhub_server.routes.structured_data.StructuredDataFilterOp" }, "value": { "anyOf": [ {}, { "type": "null" } ] }, "values": { "anyOf": [ { "type": "array", "items": {} }, { "type": "null" } ] } }, "required": [ "field_key", "op" ], "additionalProperties": false }, "synckhub_server.routes.structured_data.StructuredDataFilterOp": { "title": "StructuredDataFilterOp", "type": "string", "enum": [ "EQ", "IN", "PREFIX", "CONTAINS", "GT", "GTE", "LT", "LTE", "IS_NULL" ] }, "synckhub_server.routes.structured_data.StructuredDataQuerySort": { "title": "StructuredDataQuerySort", "type": "object", "properties": { "field_key": { "type": "string" }, "dir": { "$ref": "#/components/schemas/synckhub_server.routes.structured_data.StructuredDataSortDirection" } }, "required": [ "field_key" ], "additionalProperties": false }, "synckhub_server.routes.structured_data.StructuredDataSortDirection": { "title": "StructuredDataSortDirection", "type": "string", "enum": [ "ASC", "DESC" ] }, "synckhub_server.routes.structured_data.QueryStructuredDataRecordsResponse": { "title": "QueryStructuredDataRecordsResponse", "type": "object", "properties": { "records": { "type": "array", "items": { "$ref": "#/components/schemas/synckhub_server.routes.structured_data.StructuredDataRecordResponse" } }, "next_cursor": { "anyOf": [ { "type": "string" }, { "type": "null" } ] } }, "required": [ "records" ], "additionalProperties": false }, "synckhub_server.routes.structured_data.PutStructuredDataTableRequest": { "title": "PutStructuredDataTableRequest", "type": "object", "properties": { "display_name": { "type": "string" }, "description": { "anyOf": [ { "type": "string" }, { "type": "null" } ] }, "primary_field_key": { "type": "string" }, "fields": { "type": "array", "items": { "$ref": "#/components/schemas/synckhub_server.routes.structured_data.StructuredDataFieldDefinition" } }, "unique_constraints": { "type": "array", "items": { "$ref": "#/components/schemas/synckhub_server.routes.structured_data.StructuredDataUniqueConstraintDefinition" } }, "source_policy": { "$ref": "#/components/schemas/synckhub_server.routes.structured_data.StructuredDataSourcePolicy" }, "lifecycle_state": { "anyOf": [ { "$ref": "#/components/schemas/synckhub_server.routes.structured_data.StructuredDataTableLifecycleState" }, { "type": "null" } ] } }, "required": [ "display_name", "primary_field_key", "fields", "source_policy" ], "additionalProperties": false }, "synckhub_server.routes.structured_data.StructuredDataFieldDefinition": { "title": "StructuredDataFieldDefinition", "type": "object", "properties": { "field_key": { "type": "string" }, "display_name": { "type": "string" }, "kind": { "$ref": "#/components/schemas/synckhub_server.routes.structured_data.StructuredDataFieldKind" }, "required": { "type": "boolean" }, "indexed": { "type": "boolean" }, "options": { "type": "array", "items": { "type": "string" } }, "target_table_key": { "anyOf": [ { "type": "string" }, { "type": "null" } ] } }, "required": [ "field_key", "display_name", "kind" ], "additionalProperties": false }, "synckhub_server.routes.structured_data.StructuredDataFieldKind": { "title": "StructuredDataFieldKind", "type": "string", "enum": [ "TEXT", "LONG_TEXT", "INTEGER", "AUTONUMBER", "DECIMAL", "BOOLEAN", "DATE", "TIMESTAMP", "ENUM", "REFERENCE", "REFERENCE_LIST" ] }, "synckhub_server.routes.structured_data.StructuredDataUniqueConstraintDefinition": { "title": "StructuredDataUniqueConstraintDefinition", "type": "object", "properties": { "constraint_key": { "type": "string" }, "field_keys": { "type": "array", "items": { "type": "string" } } }, "required": [ "constraint_key", "field_keys" ], "additionalProperties": false }, "synckhub_server.routes.structured_data.StructuredDataSourcePolicy": { "title": "StructuredDataSourcePolicy", "type": "string", "enum": [ "LOCAL_ONLY", "CONNECTOR_UPSERT", "CONNECTOR_READONLY", "SYSTEM_ONLY" ] }, "synckhub_server.routes.structured_data.StructuredDataTableLifecycleState": { "title": "StructuredDataTableLifecycleState", "type": "string", "enum": [ "ACTIVE", "ARCHIVED" ] }, "synckhub_server.routes.structured_data.StructuredDataTableResponse": { "title": "StructuredDataTableResponse", "type": "object", "properties": { "repo_id": { "type": "string" }, "database_key": { "type": "string" }, "table_key": { "type": "string" }, "display_name": { "type": "string" }, "description": { "anyOf": [ { "type": "string" }, { "type": "null" } ] }, "primary_field_key": { "type": "string" }, "fields": { "type": "array", "items": { "$ref": "#/components/schemas/synckhub_server.routes.structured_data.StructuredDataFieldDefinition" } }, "unique_constraints": { "type": "array", "items": { "$ref": "#/components/schemas/synckhub_server.routes.structured_data.StructuredDataUniqueConstraintDefinition" } }, "source_policy": { "$ref": "#/components/schemas/synckhub_server.routes.structured_data.StructuredDataSourcePolicy" }, "lifecycle_state": { "$ref": "#/components/schemas/synckhub_server.routes.structured_data.StructuredDataTableLifecycleState" }, "created_at": { "type": "string" }, "created_by": { "type": "string" }, "updated_at": { "type": "string" }, "updated_by": { "type": "string" } }, "required": [ "repo_id", "database_key", "table_key", "display_name", "primary_field_key", "fields", "unique_constraints", "source_policy", "lifecycle_state", "created_at", "created_by", "updated_at", "updated_by" ], "additionalProperties": false }, "synckhub_server.routes.structured_data.ListStructuredDataTablesResponse": { "title": "ListStructuredDataTablesResponse", "type": "object", "properties": { "tables": { "type": "array", "items": { "$ref": "#/components/schemas/synckhub_server.routes.structured_data.StructuredDataTableResponse" } } }, "required": [ "tables" ], "additionalProperties": false }, "synckhub_server.routes.structured_data.PutStructuredDataDatabaseRequest": { "title": "PutStructuredDataDatabaseRequest", "type": "object", "properties": { "display_name": { "type": "string" }, "description": { "anyOf": [ { "type": "string" }, { "type": "null" } ] }, "lifecycle_state": { "anyOf": [ { "$ref": "#/components/schemas/synckhub_server.routes.structured_data.StructuredDataDatabaseLifecycleState" }, { "type": "null" } ] } }, "required": [ "display_name" ], "additionalProperties": false }, "synckhub_server.routes.structured_data.StructuredDataDatabaseLifecycleState": { "title": "StructuredDataDatabaseLifecycleState", "type": "string", "enum": [ "ACTIVE", "ARCHIVED" ] }, "synckhub_server.routes.structured_data.StructuredDataDatabaseResponse": { "title": "StructuredDataDatabaseResponse", "type": "object", "properties": { "repo_id": { "type": "string" }, "database_key": { "type": "string" }, "display_name": { "type": "string" }, "description": { "anyOf": [ { "type": "string" }, { "type": "null" } ] }, "lifecycle_state": { "$ref": "#/components/schemas/synckhub_server.routes.structured_data.StructuredDataDatabaseLifecycleState" }, "created_at": { "type": "string" }, "created_by": { "type": "string" }, "updated_at": { "type": "string" }, "updated_by": { "type": "string" } }, "required": [ "repo_id", "database_key", "display_name", "lifecycle_state", "created_at", "created_by", "updated_at", "updated_by" ], "additionalProperties": false }, "synckhub_server.routes.structured_data.ListStructuredDataDatabasesResponse": { "title": "ListStructuredDataDatabasesResponse", "type": "object", "properties": { "databases": { "type": "array", "items": { "$ref": "#/components/schemas/synckhub_server.routes.structured_data.StructuredDataDatabaseResponse" } } }, "required": [ "databases" ], "additionalProperties": false }, "synckhub_server.routes.tasks.updates.TaskUpdatesResponse": { "title": "TaskUpdatesResponse", "type": "object", "properties": { "items": { "type": "array", "items": { "$ref": "#/components/schemas/synckhub_server.routes.tasks.updates.TaskUpdate" } }, "next_cursor": { "anyOf": [ { "type": "string" }, { "type": "null" } ] } }, "required": [ "items" ] }, "synckhub_server.routes.tasks.updates.TaskUpdate": { "title": "TaskUpdate", "type": "object", "properties": { "repo_id": { "type": "string", "format": "uuid" }, "task_list_item_id": { "type": "string", "format": "uuid" }, "task_list_name": { "type": "string" }, "task_item_seq": { "type": "integer" }, "subject": { "type": "string" }, "assigned_users": { "type": "array", "items": { "type": "string" } }, "assigned_groups": { "type": "array", "items": { "type": "string" } }, "last_repo_seq": { "type": "integer" }, "seen_repo_seq": { "anyOf": [ { "type": "integer" }, { "type": "null" } ] }, "activity": { "$ref": "#/components/schemas/synckhub_server.routes.tasks.updates.LatestTaskActivity" } }, "required": [ "repo_id", "task_list_item_id", "task_list_name", "task_item_seq", "subject", "assigned_users", "assigned_groups", "last_repo_seq", "activity" ] }, "synckhub_server.routes.tasks.updates.LatestTaskActivity": { "title": "LatestTaskActivity", "type": "object", "properties": { "kind": { "type": "string" }, "actor_id": { "type": "string" }, "created_at": { "type": "string" }, "fields": { "type": "array", "items": { "type": "string" } } }, "required": [ "kind", "actor_id", "created_at", "fields" ] }, "synckhub_server.routes.tasks.attention.DueTasksResponse": { "title": "DueTasksResponse", "type": "object", "properties": { "items": { "type": "array", "items": { "$ref": "#/components/schemas/synckhub_server.routes.tasks.attention.DueTaskRow" } }, "counts": { "$ref": "#/components/schemas/synckhub_server.routes.tasks.attention.DueTaskCounts" }, "timezone": { "type": "string" }, "page": { "$ref": "#/components/schemas/synckhub_server.routes.OffsetPaginationMeta" } }, "required": [ "items", "counts", "timezone", "page" ], "additionalProperties": false }, "synckhub_server.routes.tasks.attention.DueTaskRow": { "title": "Activity", "type": "object", "properties": { "due_bucket": { "type": "string" }, "repo_id": { "type": "string" }, "task_id": { "type": "string" }, "version": { "type": "integer" }, "lifecycle_state": { "type": "string" }, "task_list_id": { "anyOf": [ { "type": "string" }, { "type": "null" } ] }, "task_list_name": { "anyOf": [ { "type": "string" }, { "type": "null" } ] }, "task_list_context": { "type": "string" }, "can_change_task_list": { "type": "boolean" }, "parent_task_id": { "anyOf": [ { "type": "string" }, { "type": "null" } ] }, "can_create_child": { "type": "boolean" }, "has_children": { "type": "boolean" }, "subject": { "type": "string" }, "description": { "type": "string" }, "assigned_users": { "type": "array", "items": { "type": "string" } }, "assigned_groups": { "type": "array", "items": { "type": "string" } }, "assigned_to_current_user": { "type": "boolean" }, "followers": { "type": "array", "items": { "$ref": "#/components/schemas/synckhub_core.types.TaskFollower" } }, "comment_count": { "type": "integer" }, "priority": { "type": "string" }, "status": { "type": "string" }, "due": { "anyOf": [ { "$ref": "#/components/schemas/synckhub_core.types.TaskDue" }, { "type": "null" } ] }, "column_values": {}, "index": { "type": "integer" }, "created_by": { "type": "string" }, "created_at": { "type": "string" }, "email_source_state": { "anyOf": [ { "type": "string" }, { "type": "null" } ] }, "email_summary": { "anyOf": [ { "$ref": "#/components/schemas/synckhub_server.routes.tasks.records.EmailSummary" }, { "type": "null" } ] }, "allowed_actions": { "type": "array", "items": { "type": "string" } }, "activity_kind": { "type": "string" }, "updated_by": { "type": "string" }, "updated_at": { "type": "string", "format": "date-time" }, "activity_repo_seq": { "anyOf": [ { "type": "integer" }, { "type": "null" } ] }, "seen_repo_seq": { "anyOf": [ { "type": "integer" }, { "type": "null" } ] }, "unreviewed": { "type": "boolean" } }, "required": [ "due_bucket", "repo_id", "task_id", "version", "lifecycle_state", "task_list_context", "can_change_task_list", "can_create_child", "has_children", "subject", "description", "assigned_users", "assigned_groups", "assigned_to_current_user", "followers", "comment_count", "priority", "status", "column_values", "index", "created_by", "created_at", "allowed_actions", "activity_kind", "updated_by", "updated_at", "unreviewed" ], "additionalProperties": false }, "synckhub_core.types.TaskFollower": { "title": "TaskFollower", "type": "object", "properties": { "kind": { "$ref": "#/components/schemas/synckhub_core.types.TaskFollowerKind" }, "id": { "type": "string", "description": "User or group identifier in the owning repository." } }, "required": [ "kind", "id" ], "additionalProperties": false, "description": "A user or group explicitly following one task row." }, "synckhub_core.types.TaskFollowerKind": { "title": "TaskFollowerKind", "type": "string", "enum": [ "USER", "GROUP" ], "description": "Kind of subject that explicitly follows one task row." }, "synckhub_server.routes.tasks.records.EmailSummary": { "title": "EmailSummary", "type": "object", "properties": { "subject": { "anyOf": [ { "type": "string" }, { "type": "null" } ] }, "from": { "anyOf": [ { "$ref": "#/components/schemas/synckhub_core.tasks.email.Address" }, { "type": "null" } ] }, "received_at": { "anyOf": [ { "type": "string" }, { "type": "null" } ] }, "sent_at": { "anyOf": [ { "type": "string" }, { "type": "null" } ] }, "has_attachments": { "type": "boolean" }, "snippet": { "anyOf": [ { "type": "string" }, { "type": "null" } ] }, "preferred_body_part": { "anyOf": [ { "type": "string" }, { "type": "null" } ] }, "provider_action": { "anyOf": [ { "$ref": "#/components/schemas/synckhub_server.routes.tasks.records.EmailProviderAction" }, { "type": "null" } ] } }, "required": [ "has_attachments" ], "description": "Saved headers are task-owned content. Provider coordinates appear only in\nthe independently authorized action target." }, "synckhub_core.tasks.email.Address": { "title": "Address", "type": "object", "properties": { "name": { "anyOf": [ { "type": "string" }, { "type": "null" } ] }, "email": { "anyOf": [ { "type": "string" }, { "type": "null" } ] } }, "additionalProperties": false }, "synckhub_server.routes.tasks.records.EmailProviderAction": { "title": "EmailProviderAction", "type": "object", "properties": { "account_id": { "type": "string", "format": "uuid" }, "message_id": { "type": "string" }, "is_read": { "anyOf": [ { "type": "boolean" }, { "type": "null" } ] } }, "required": [ "account_id", "message_id" ] }, "synckhub_server.routes.tasks.attention.DueTaskCounts": { "title": "DueTaskCounts", "type": "object", "properties": { "overdue": { "type": "integer", "minimum": 0 }, "today": { "type": "integer", "minimum": 0 }, "next_7d": { "type": "integer", "minimum": 0 } }, "required": [ "overdue", "today", "next_7d" ], "additionalProperties": false }, "synckhub_server.routes.tasks.attention.TaskAttentionSummaryResponse": { "title": "TaskAttentionSummaryResponse", "type": "object", "properties": { "personal_open_count": { "type": "integer" }, "assigned_open_count": { "type": "integer" }, "assigned_unreviewed_count": { "type": "integer" }, "unreviewed_count": { "type": "integer" }, "has_unreviewed": { "type": "boolean" }, "task_lists": { "type": "array", "items": { "$ref": "#/components/schemas/synckhub_server.routes.tasks.attention.TaskAttentionTaskListSummary" } } }, "required": [ "personal_open_count", "assigned_open_count", "assigned_unreviewed_count", "unreviewed_count", "has_unreviewed", "task_lists" ], "additionalProperties": false }, "synckhub_server.routes.tasks.attention.TaskAttentionTaskListSummary": { "title": "TaskAttentionTaskListSummary", "type": "object", "properties": { "task_list_item_id": { "type": "string" }, "task_list_name": { "type": "string" }, "open_count": { "type": "integer" }, "assigned_open_count": { "type": "integer" }, "unreviewed_count": { "type": "integer" } }, "required": [ "task_list_item_id", "task_list_name", "open_count", "assigned_open_count", "unreviewed_count" ], "additionalProperties": false }, "synckhub_server.routes.tasks.collections.Scope": { "title": "Scope", "type": "string", "enum": [ "personal", "assignments_to_me", "assignments_by_me", "mine", "assigned_by_me", "list", "subtree", "assigned_to_me", "assigned_to_others", "updates", "personal_email" ] }, "synckhub_server.routes.tasks.collections.Sort": { "title": "Sort", "type": "string", "enum": [ "position", "email_received_at", "created_at", "updated_at" ] }, "synckhub_server.routes.tasks.collections.SortOrder": { "title": "SortOrder", "type": "string", "enum": [ "asc", "desc" ] }, "synckhub_server.routes.tasks.email_status.Request": { "title": "Request", "type": "object", "properties": { "sources": { "type": "array", "items": { "$ref": "#/components/schemas/synckhub_core.tasks.email.Identity" } } }, "required": [ "sources" ], "additionalProperties": false }, "synckhub_core.tasks.email.Identity": { "title": "Identity", "oneOf": [ { "type": "object", "properties": { "kind": { "const": "personal" }, "owner_id": { "type": "string" }, "account_id": { "type": "string", "format": "uuid" }, "message_id": { "type": "string" } }, "required": [ "kind", "owner_id", "account_id", "message_id" ], "additionalProperties": false }, { "type": "object", "properties": { "kind": { "const": "team" }, "task_list_id": { "type": "string" }, "account_id": { "type": "string", "format": "uuid" }, "message_id": { "type": "string" } }, "required": [ "kind", "task_list_id", "account_id", "message_id" ], "additionalProperties": false } ] }, "synckhub_server.routes.tasks.mail_team_work.AssigneesResponse": { "title": "AssigneesResponse", "type": "object", "properties": { "repo_id": { "type": "string" }, "task_list_item_id": { "type": "string" }, "items": { "type": "array", "items": { "$ref": "#/components/schemas/synckhub_server.routes.tasks.mail_team_work.AssigneeEntry" } } }, "required": [ "repo_id", "task_list_item_id", "items" ] }, "synckhub_server.routes.tasks.mail_team_work.AssigneeEntry": { "title": "AssigneeEntry", "type": "object", "properties": { "user_id": { "type": "string" } }, "required": [ "user_id" ] }, "synckhub_server.routes.tasks.mail_team_work.SetTeamInboxEnabledRequest": { "title": "SetTeamInboxEnabledRequest", "type": "object", "properties": { "enabled": { "type": "boolean" } }, "required": [ "enabled" ], "additionalProperties": false }, "synckhub_server.routes.tasks.mail_team_work.TeamInboxAdminView": { "title": "TeamInboxAdminView", "type": "object", "properties": { "task_list_item_id": { "type": "string" }, "email_address": { "type": "string" }, "enabled": { "type": "boolean" }, "state": { "type": "string" }, "can_delete": { "type": "boolean" } }, "required": [ "task_list_item_id", "email_address", "enabled", "state", "can_delete" ] }, "synckhub_server.routes.tasks.mail_team_work.CreateTeamInboxRequest": { "title": "CreateTeamInboxRequest", "type": "object", "properties": { "email_address": { "type": "string" } }, "required": [ "email_address" ], "additionalProperties": false }, "synckhub_server.routes.tasks.mail_team_work.TeamInboxesResponse": { "title": "TeamInboxesResponse", "type": "object", "properties": { "repo_id": { "type": "string" }, "items": { "type": "array", "items": { "$ref": "#/components/schemas/synckhub_server.routes.tasks.mail_team_work.TeamInboxView" } } }, "required": [ "repo_id", "items" ] }, "synckhub_server.routes.tasks.mail_team_work.TeamInboxView": { "title": "TeamInboxView", "anyOf": [ { "$ref": "#/components/schemas/synckhub_server.routes.tasks.mail_team_work.TeamInboxAdminView" }, { "$ref": "#/components/schemas/synckhub_server.routes.tasks.mail_team_work.TeamInboxMemberView" } ] }, "synckhub_server.routes.tasks.mail_team_work.TeamInboxMemberView": { "title": "TeamInboxMemberView", "type": "object", "properties": { "task_list_item_id": { "type": "string" }, "email_address": { "type": "string" }, "enabled": { "type": "boolean" }, "account_ids": { "type": "array", "items": { "type": "string" } }, "assignment_account_id": { "anyOf": [ { "type": "string" }, { "type": "null" } ] }, "assignment_available": { "type": "boolean" } }, "required": [ "task_list_item_id", "email_address", "enabled", "account_ids", "assignment_available" ] }, "synckhub_server.routes.tasks.records.activity.Filter": { "title": "Filter", "type": "string", "enum": [ "ALL", "COMMENTS", "CHANGES" ] }, "synckhub_server.routes.tasks.seen.Request": { "title": "Request", "type": "object", "properties": { "seen_repo_seq": { "type": "integer" } }, "required": [ "seen_repo_seq" ], "additionalProperties": false }, "synckhub_core.tasks.commands.Follow": { "title": "Follow", "type": "object", "properties": { "command_id": { "type": "string", "format": "uuid" }, "add": { "type": "array", "items": { "$ref": "#/components/schemas/synckhub_core.types.TaskFollower" } }, "remove": { "type": "array", "items": { "$ref": "#/components/schemas/synckhub_core.types.TaskFollower" } } }, "required": [ "command_id" ], "additionalProperties": false }, "synckhub_core.tasks.commands.Command": { "title": "Command", "oneOf": [ { "type": "object", "properties": { "operation": { "const": "CREATE" }, "input": { "$ref": "#/components/schemas/synckhub_core.tasks.commands.Create" } }, "required": [ "operation", "input" ], "additionalProperties": false }, { "type": "object", "properties": { "operation": { "const": "CREATE_EMAIL" }, "input": { "$ref": "#/components/schemas/synckhub_core.tasks.commands.Create" }, "source": { "$ref": "#/components/schemas/synckhub_core.tasks.email.Identity" }, "expected_source": { "anyOf": [ { "$ref": "#/components/schemas/synckhub_core.tasks.commands.SourceVersion" }, { "type": "null" } ] } }, "required": [ "operation", "input", "source" ], "additionalProperties": false }, { "type": "object", "properties": { "operation": { "const": "EDIT" }, "task_id": { "type": "string" }, "input": { "$ref": "#/components/schemas/synckhub_core.tasks.commands.Edit" } }, "required": [ "operation", "task_id", "input" ], "additionalProperties": false }, { "type": "object", "properties": { "operation": { "const": "ASSIGN" }, "task_id": { "type": "string" }, "input": { "$ref": "#/components/schemas/synckhub_core.tasks.commands.Edit" } }, "required": [ "operation", "task_id", "input" ], "additionalProperties": false }, { "type": "object", "properties": { "operation": { "const": "TRASH" }, "task_id": { "type": "string" }, "input": { "$ref": "#/components/schemas/synckhub_core.tasks.commands.Versioned" } }, "required": [ "operation", "task_id", "input" ], "additionalProperties": false }, { "type": "object", "properties": { "operation": { "const": "RESTORE" }, "task_id": { "type": "string" }, "input": { "$ref": "#/components/schemas/synckhub_core.tasks.commands.Versioned" } }, "required": [ "operation", "task_id", "input" ], "additionalProperties": false }, { "type": "object", "properties": { "operation": { "const": "TOMBSTONE" }, "task_id": { "type": "string" }, "input": { "$ref": "#/components/schemas/synckhub_core.tasks.commands.Versioned" } }, "required": [ "operation", "task_id", "input" ], "additionalProperties": false }, { "type": "object", "properties": { "operation": { "const": "COMMENT" }, "task_id": { "type": "string" }, "input": { "$ref": "#/components/schemas/synckhub_core.tasks.commands.Comment" } }, "required": [ "operation", "task_id", "input" ], "additionalProperties": false }, { "type": "object", "properties": { "operation": { "const": "REMOVE_ACCESS" }, "task_id": { "type": "string" }, "input": { "$ref": "#/components/schemas/synckhub_core.tasks.commands.RemoveAccess" } }, "required": [ "operation", "task_id", "input" ], "additionalProperties": false }, { "type": "object", "properties": { "operation": { "const": "MOVE" }, "task_id": { "type": "string" }, "input": { "$ref": "#/components/schemas/synckhub_core.tasks.commands.Move" } }, "required": [ "operation", "task_id", "input" ], "additionalProperties": false }, { "type": "object", "properties": { "operation": { "const": "SET_LIST" }, "task_id": { "type": "string" }, "input": { "$ref": "#/components/schemas/synckhub_core.tasks.commands.SetList" } }, "required": [ "operation", "task_id", "input" ], "additionalProperties": false } ], "description": "Complete immutable intent, including the route target, binds receipt replay.\nList moves and ordering require their own multi-task commands, not field edits." }, "synckhub_core.tasks.commands.Create": { "title": "Create", "type": "object", "properties": { "command_id": { "type": "string", "format": "uuid" }, "task_list_id": { "anyOf": [ { "type": "string" }, { "type": "null" } ] }, "parent_task_id": { "anyOf": [ { "type": "string" }, { "type": "null" } ] }, "fields": { "$ref": "#/components/schemas/synckhub_core.tasks.commands.Fields" } }, "required": [ "command_id", "fields" ], "additionalProperties": false }, "synckhub_core.tasks.commands.Fields": { "title": "Fields", "type": "object", "properties": { "subject": { "anyOf": [ { "type": "string" }, { "type": "null" } ] }, "description": { "anyOf": [ { "type": "string" }, { "type": "null" } ] }, "assigned_users": { "anyOf": [ { "type": "array", "items": { "type": "string" } }, { "type": "null" } ] }, "assigned_groups": { "anyOf": [ { "type": "array", "items": { "type": "string" } }, { "type": "null" } ] }, "priority": { "anyOf": [ { "type": "string" }, { "type": "null" } ] }, "status": { "anyOf": [ { "type": "string" }, { "type": "null" } ] }, "due": { "anyOf": [ { "anyOf": [ { "$ref": "#/components/schemas/synckhub_core.types.TaskDue" }, { "type": "null" } ] }, { "type": "null" } ] }, "column_values": { "anyOf": [ { "type": "object", "additionalProperties": {} }, { "type": "null" } ] } }, "additionalProperties": false, "description": "Missing fields preserve accepted values. Only `due` accepts explicit null.\nCustom values are patched by key so unknown retained columns survive edits." }, "synckhub_core.tasks.commands.SourceVersion": { "title": "SourceVersion", "type": "object", "properties": { "task_id": { "type": "string" }, "version": { "type": "integer" } }, "required": [ "task_id", "version" ], "additionalProperties": false }, "synckhub_core.tasks.commands.Edit": { "title": "Edit", "type": "object", "properties": { "command_id": { "type": "string", "format": "uuid" }, "expected_version": { "type": "integer" }, "fields": { "$ref": "#/components/schemas/synckhub_core.tasks.commands.Fields" } }, "required": [ "command_id", "expected_version", "fields" ], "additionalProperties": false }, "synckhub_core.tasks.commands.Versioned": { "title": "Versioned", "type": "object", "properties": { "command_id": { "type": "string", "format": "uuid" }, "expected_version": { "type": "integer" } }, "required": [ "command_id", "expected_version" ], "additionalProperties": false }, "synckhub_core.tasks.commands.Comment": { "title": "Comment", "type": "object", "properties": { "command_id": { "type": "string", "format": "uuid" }, "comment_id": { "type": "string", "format": "uuid" }, "body": { "type": "string" } }, "required": [ "command_id", "comment_id", "body" ], "additionalProperties": false }, "synckhub_core.tasks.commands.RemoveAccess": { "title": "RemoveAccess", "type": "object", "properties": { "command_id": { "type": "string", "format": "uuid" }, "expected_version": { "type": "integer" }, "subject_kind": { "$ref": "#/components/schemas/synckhub_core.types.TaskFollowerKind" }, "subject_id": { "type": "string" } }, "required": [ "command_id", "expected_version", "subject_kind", "subject_id" ], "additionalProperties": false }, "synckhub_core.tasks.commands.Move": { "title": "Move", "type": "object", "properties": { "command_id": { "type": "string", "format": "uuid" }, "expected_version": { "type": "integer" }, "parent_task_id": { "anyOf": [ { "type": "string" }, { "type": "null" } ] }, "before_task_id": { "anyOf": [ { "type": "string" }, { "type": "null" } ] } }, "required": [ "command_id", "expected_version", "parent_task_id" ], "additionalProperties": false, "description": "Move within the current list (including the standalone context). The anchor\nmust be a live sibling in the destination; null appends after its siblings." }, "synckhub_core.tasks.commands.SetList": { "title": "SetList", "type": "object", "properties": { "command_id": { "type": "string", "format": "uuid" }, "expected_version": { "type": "integer" }, "task_list_id": { "anyOf": [ { "type": "string" }, { "type": "null" } ] } }, "required": [ "command_id", "expected_version", "task_list_id" ], "additionalProperties": false, "description": "Explicit root/subtree placement. Null detaches; omission is not a request." }, "synckhub_server.routes.time_tracking.PublicEntry": { "title": "PublicEntry", "type": "object", "properties": { "item_id": { "type": "string" }, "version": { "type": "integer" }, "data": {}, "capabilities": { "$ref": "#/components/schemas/synckhub_core_postgres.service.time_tracking.Capabilities" } }, "required": [ "item_id", "version", "data", "capabilities" ] }, "synckhub_core_postgres.service.time_tracking.Capabilities": { "title": "Capabilities", "type": "object", "properties": { "view_time": { "type": "boolean" }, "view_rates": { "type": "boolean" }, "review": { "type": "boolean" } }, "required": [ "view_time", "view_rates", "review" ] }, "synckhub_core.time_tracking.Command": { "title": "Command", "type": "object", "properties": { "command_id": { "type": "string", "format": "uuid" }, "action": { "$ref": "#/components/schemas/synckhub_core.time_tracking.CommandAction" } }, "required": [ "command_id", "action" ], "additionalProperties": false }, "synckhub_core.time_tracking.CommandAction": { "title": "CommandAction", "oneOf": [ { "type": "object", "properties": { "kind": { "const": "RATE" }, "entry_id": { "type": "string" }, "expected_version": { "type": "integer" }, "hourly_rate_minor": { "anyOf": [ { "type": "integer" }, { "type": "null" } ] }, "reason": { "type": "string" } }, "required": [ "kind", "entry_id", "expected_version", "reason" ], "additionalProperties": false }, { "type": "object", "properties": { "kind": { "const": "CREATE" }, "input": { "$ref": "#/components/schemas/synckhub_core.time_tracking.Draft" }, "timer": { "type": "boolean" }, "correction_of": { "anyOf": [ { "type": "string" }, { "type": "null" } ] } }, "required": [ "kind", "input", "timer" ], "additionalProperties": false }, { "type": "object", "properties": { "kind": { "const": "EDIT" }, "entry_id": { "type": "string" }, "expected_version": { "type": "integer" }, "input": { "$ref": "#/components/schemas/synckhub_core.time_tracking.Draft" } }, "required": [ "kind", "entry_id", "expected_version", "input" ], "additionalProperties": false }, { "type": "object", "properties": { "kind": { "const": "TRANSITION" }, "entry_id": { "type": "string" }, "expected_version": { "type": "integer" }, "operation": { "$ref": "#/components/schemas/synckhub_core.time_tracking.Operation" }, "reason": { "anyOf": [ { "type": "string" }, { "type": "null" } ] } }, "required": [ "kind", "entry_id", "expected_version", "operation" ], "additionalProperties": false }, { "type": "object", "properties": { "kind": { "const": "SETTINGS" }, "expected_version": { "type": "integer" }, "input": { "$ref": "#/components/schemas/synckhub_core.time_tracking.Settings" } }, "required": [ "kind", "expected_version", "input" ], "additionalProperties": false }, { "type": "object", "properties": { "kind": { "const": "BOOK" }, "user_id": { "type": "string" }, "expected_version": { "type": "integer" }, "hourly_rate_minor": { "anyOf": [ { "type": "integer" }, { "type": "null" } ] }, "office_id": { "anyOf": [ { "type": "string", "format": "uuid" }, { "type": "null" } ] }, "practice_id": { "anyOf": [ { "type": "string", "format": "uuid" }, { "type": "null" } ] } }, "required": [ "kind", "user_id", "expected_version" ], "additionalProperties": false }, { "type": "object", "properties": { "kind": { "const": "GRANT" }, "rule_id": { "type": "string", "format": "uuid" }, "resource_kind": { "type": "string" }, "resource_id": { "type": "string", "format": "uuid" }, "subject_kind": { "type": "string" }, "subject_id": { "type": "string" }, "deny": { "type": "boolean" }, "view_time": { "type": "boolean" }, "view_rates": { "type": "boolean" }, "review": { "type": "boolean" } }, "required": [ "kind", "rule_id", "resource_kind", "resource_id", "subject_kind", "subject_id", "deny", "view_time", "view_rates", "review" ], "additionalProperties": false }, { "type": "object", "properties": { "kind": { "const": "REVOKE_GRANT" }, "rule_id": { "type": "string", "format": "uuid" } }, "required": [ "kind", "rule_id" ], "additionalProperties": false } ] }, "synckhub_core.time_tracking.Draft": { "title": "Draft", "type": "object", "properties": { "work_date": { "type": "string", "format": "date" }, "time_zone": { "type": "string" }, "seconds": { "type": "integer" }, "description": { "type": "string" }, "assignment": { "$ref": "#/components/schemas/synckhub_core.time_tracking.Assignment" }, "classification": { "$ref": "#/components/schemas/synckhub_core.time_tracking.Classification" }, "office_id": { "anyOf": [ { "type": "string", "format": "uuid" }, { "type": "null" } ] }, "practice_id": { "anyOf": [ { "type": "string", "format": "uuid" }, { "type": "null" } ] }, "hourly_rate_minor": { "anyOf": [ { "type": "integer" }, { "type": "null" } ] }, "rate_override": { "type": "boolean" } }, "required": [ "work_date", "time_zone", "seconds", "description", "assignment", "classification", "rate_override" ], "additionalProperties": false }, "synckhub_core.time_tracking.Assignment": { "title": "Assignment", "oneOf": [ { "type": "object", "properties": { "kind": { "const": "INTERNAL" } }, "required": [ "kind" ], "additionalProperties": false }, { "type": "object", "properties": { "kind": { "const": "CASE" }, "id": { "type": "string" } }, "required": [ "kind", "id" ], "additionalProperties": false }, { "type": "object", "properties": { "kind": { "const": "COMPANY" }, "id": { "type": "string" } }, "required": [ "kind", "id" ], "additionalProperties": false } ] }, "synckhub_core.time_tracking.Classification": { "title": "Classification", "type": "string", "enum": [ "BILLABLE", "NONBILLABLE", "NO_CHARGE" ] }, "synckhub_core.time_tracking.Operation": { "title": "Operation", "type": "string", "enum": [ "PAUSE", "RESUME", "STOP", "SUBMIT", "WITHDRAW", "RETURN", "APPROVE", "VOID" ] }, "synckhub_core.time_tracking.Settings": { "title": "Settings", "type": "object", "properties": { "currency": { "type": "string" }, "offices": { "type": "array", "items": { "$ref": "#/components/schemas/synckhub_core.time_tracking.Label" } }, "practices": { "type": "array", "items": { "$ref": "#/components/schemas/synckhub_core.time_tracking.Label" } } }, "required": [ "currency", "offices", "practices" ], "additionalProperties": false }, "synckhub_core.time_tracking.Label": { "title": "Label", "type": "object", "properties": { "id": { "type": "string", "format": "uuid" }, "name": { "type": "string" }, "retired": { "type": "boolean" } }, "required": [ "id", "name", "retired" ], "additionalProperties": false }, "synckhub_core_postgres.service.time_tracking.Receipt": { "title": "Receipt", "type": "object", "properties": { "item_id": { "type": "string" }, "version": { "type": "integer" }, "commit_id": { "type": "string" }, "accepted_at": { "type": "string", "format": "date-time" } }, "required": [ "item_id", "version", "commit_id", "accepted_at" ] }, "synckhub_server.routes.uploads.UploadsGcRequest": { "title": "UploadsGcRequest", "type": "object", "properties": { "max_pending_age_secs": { "anyOf": [ { "type": "integer", "minimum": 0 }, { "type": "null" } ] }, "max_processing_age_secs": { "anyOf": [ { "type": "integer", "minimum": 0 }, { "type": "null" } ] }, "max_incomplete_tus_age_secs": { "anyOf": [ { "type": "integer", "minimum": 0 }, { "type": "null" } ] }, "max_orphan_tus_age_secs": { "anyOf": [ { "type": "integer", "minimum": 0 }, { "type": "null" } ] }, "max_completed_tus_age_secs": { "anyOf": [ { "type": "integer", "minimum": 0 }, { "type": "null" } ] }, "max_failed_tus_age_secs": { "anyOf": [ { "type": "integer", "minimum": 0 }, { "type": "null" } ] } }, "additionalProperties": false }, "synckhub_server.routes.uploads.UploadsGcResponse": { "title": "UploadsGcResponse", "type": "object", "properties": { "expired_pending_intents": { "type": "integer", "minimum": 0 }, "expired_processing_intents": { "type": "integer", "minimum": 0 }, "deleted_expired_reservations": { "type": "integer", "minimum": 0 }, "deleted_terminal_intent_reservations": { "type": "integer", "minimum": 0 }, "deleted_tus_staging_files": { "type": "integer", "minimum": 0 }, "deleted_tus_orphan_staging_files": { "type": "integer", "minimum": 0 } }, "required": [ "expired_pending_intents", "expired_processing_intents", "deleted_expired_reservations", "deleted_terminal_intent_reservations", "deleted_tus_staging_files", "deleted_tus_orphan_staging_files" ] }, "synckhub_server.routes.uploads.StoreChatAttachmentUploadIntentsRequest": { "title": "StoreChatAttachmentUploadIntentsRequest", "type": "object", "properties": { "repo_id": { "type": "string" }, "chat_item_id": { "type": "string" }, "items": { "type": "array", "items": { "$ref": "#/components/schemas/synckhub_server.routes.uploads.StoreChatAttachmentUploadIntentItemRequest" } } }, "required": [ "repo_id", "chat_item_id", "items" ], "additionalProperties": false }, "synckhub_server.routes.uploads.StoreChatAttachmentUploadIntentItemRequest": { "title": "StoreChatAttachmentUploadIntentItemRequest", "type": "object", "properties": { "upload_intent_id": { "type": "string" } }, "required": [ "upload_intent_id" ], "additionalProperties": false }, "synckhub_server.routes.uploads.StoreChatAttachmentUploadIntentsResponse": { "title": "StoreChatAttachmentUploadIntentsResponse", "type": "object", "properties": { "repo_id": { "type": "string" }, "chat_item_id": { "type": "string" }, "all_succeeded": { "type": "boolean" }, "items": { "type": "array", "items": { "$ref": "#/components/schemas/synckhub_server.routes.uploads.StoreChatAttachmentUploadIntentItemResponse" } } }, "required": [ "repo_id", "chat_item_id", "all_succeeded", "items" ] }, "synckhub_server.routes.uploads.StoreChatAttachmentUploadIntentItemResponse": { "title": "StoreChatAttachmentUploadIntentItemResponse", "type": "object", "properties": { "upload_intent_id": { "type": "string" }, "blob_id": { "type": "string" }, "size": { "anyOf": [ { "type": "integer" }, { "type": "null" } ] }, "status": { "$ref": "#/components/schemas/synckhub_uploads.intents.UploadIntentStatus" } }, "required": [ "upload_intent_id", "blob_id", "status" ] }, "synckhub_uploads.intents.UploadIntentStatus": { "title": "UploadIntentStatus", "type": "string", "enum": [ "PENDING", "UPLOADING", "UPLOADED", "PROCESSING", "STORED", "COMPLETED", "FAILED" ], "description": "Status for an upload intent lifecycle." }, "synckhub_server.routes.uploads.FinishChatAttachmentUploadsRequest": { "title": "FinishChatAttachmentUploadsRequest", "type": "object", "properties": { "repo_id": { "type": "string" }, "chat_item_id": { "type": "string" }, "message": { "$ref": "#/components/schemas/synckhub_server.routes.uploads.FinishChatAttachmentUploadsMessage" }, "attachments": { "type": "array", "items": { "$ref": "#/components/schemas/synckhub_server.routes.uploads.FinishChatAttachmentUploadsAttachment" } } }, "required": [ "repo_id", "chat_item_id", "message", "attachments" ], "additionalProperties": false }, "synckhub_server.routes.uploads.FinishChatAttachmentUploadsMessage": { "title": "FinishChatAttachmentUploadsMessage", "type": "object", "properties": { "body": { "type": "string" }, "reply_to_item_seq": { "anyOf": [ { "type": "integer" }, { "type": "null" } ] }, "mentions": { "type": "array", "items": { "$ref": "#/components/schemas/synckhub_server.routes.uploads.ChatAttachmentMessageMention" } } }, "additionalProperties": false }, "synckhub_server.routes.uploads.ChatAttachmentMessageMention": { "title": "ChatAttachmentMessageMention", "type": "object", "properties": { "user_id": { "type": "string" }, "label": { "type": "string" }, "start": { "type": "integer" }, "end": { "type": "integer" } }, "required": [ "user_id", "label", "start", "end" ], "additionalProperties": false }, "synckhub_server.routes.uploads.FinishChatAttachmentUploadsAttachment": { "title": "FinishChatAttachmentUploadsAttachment", "type": "object", "properties": { "upload_intent_id": { "type": "string" }, "width": { "anyOf": [ { "type": "integer" }, { "type": "null" } ] }, "height": { "anyOf": [ { "type": "integer" }, { "type": "null" } ] } }, "required": [ "upload_intent_id" ], "additionalProperties": false }, "synckhub_server.routes.uploads.FinishChatAttachmentUploadsResponse": { "title": "FinishChatAttachmentUploadsResponse", "type": "object", "properties": { "repo_id": { "type": "string" }, "chat_item_id": { "type": "string" }, "commit_id": { "anyOf": [ { "type": "string" }, { "type": "null" } ] }, "message_item_seq": { "type": "integer" }, "attachments": { "type": "array", "items": { "$ref": "#/components/schemas/synckhub_server.routes.uploads.FinishChatAttachmentUploadsAttachmentResponse" } } }, "required": [ "repo_id", "chat_item_id", "message_item_seq", "attachments" ] }, "synckhub_server.routes.uploads.FinishChatAttachmentUploadsAttachmentResponse": { "title": "FinishChatAttachmentUploadsAttachmentResponse", "type": "object", "properties": { "upload_intent_id": { "type": "string" }, "attachment_item_seq": { "type": "integer" }, "blob_id": { "type": "string" } }, "required": [ "upload_intent_id", "attachment_item_seq", "blob_id" ] }, "synckhub_server.routes.uploads.FinishConvertedOfficeUploadIntentRequest": { "title": "FinishConvertedOfficeUploadIntentRequest", "type": "object", "properties": { "expected_head_item_seq": { "anyOf": [ { "type": "integer" }, { "type": "null" } ] }, "expected_name": { "anyOf": [ { "type": "string" }, { "type": "null" } ] }, "source_extension": { "type": "string" }, "target_extension": { "type": "string" } }, "required": [ "source_extension", "target_extension" ], "additionalProperties": false }, "synckhub_server.routes.uploads.FinishConvertedOfficeUploadIntentResponse": { "title": "FinishConvertedOfficeUploadIntentResponse", "type": "object", "properties": { "upload_intent_id": { "type": "string" }, "repo_id": { "type": "string" }, "item_id": { "type": "string" }, "blob_id": { "type": "string" }, "commit_id": { "anyOf": [ { "type": "string" }, { "type": "null" } ] }, "item_seq": { "type": "integer" }, "name": { "type": "string" }, "file_extension": { "type": "string" } }, "required": [ "upload_intent_id", "repo_id", "item_id", "blob_id", "item_seq", "name", "file_extension" ] }, "synckhub_server.routes.uploads.FinishImportFileContentUploadIntentRequest": { "title": "FinishImportFileContentUploadIntentRequest", "type": "object", "properties": { "expected_head_upload_intent_id": { "type": "string" } }, "required": [ "expected_head_upload_intent_id" ], "additionalProperties": false }, "synckhub_server.routes.uploads.FinishFileContentUploadIntentResponse": { "title": "FinishFileContentUploadIntentResponse", "type": "object", "properties": { "upload_intent_id": { "type": "string" }, "repo_id": { "type": "string" }, "item_id": { "type": "string" }, "blob_id": { "type": "string" }, "commit_id": { "anyOf": [ { "type": "string" }, { "type": "null" } ] }, "item_seq": { "type": "integer" } }, "required": [ "upload_intent_id", "repo_id", "item_id", "blob_id", "item_seq" ] }, "synckhub_server.routes.uploads.FinishFileUploadIntentResponse": { "title": "FinishFileUploadIntentResponse", "type": "object", "properties": { "upload_intent_id": { "type": "string" }, "repo_id": { "type": "string" }, "item_id": { "type": "string" }, "target_item_type": { "type": "string" }, "blob_id": { "type": "string" }, "commit_id": { "anyOf": [ { "type": "string" }, { "type": "null" } ] } }, "required": [ "upload_intent_id", "repo_id", "item_id", "target_item_type", "blob_id" ] }, "synckhub_server.routes.uploads.BatchFinishFileUploadIntentRequest": { "title": "BatchFinishFileUploadIntentRequest", "type": "object", "properties": { "items": { "type": "array", "items": { "$ref": "#/components/schemas/synckhub_server.routes.uploads.BatchFinishFileUploadIntentItemRequest" } } }, "required": [ "items" ], "additionalProperties": false }, "synckhub_server.routes.uploads.BatchFinishFileUploadIntentItemRequest": { "title": "BatchFinishFileUploadIntentItemRequest", "type": "object", "properties": { "upload_intent_id": { "type": "string" } }, "required": [ "upload_intent_id" ], "additionalProperties": false }, "synckhub_server.routes.uploads.BatchFinishFileUploadIntentResponse": { "title": "BatchFinishFileUploadIntentResponse", "type": "object", "properties": { "items": { "type": "array", "items": { "$ref": "#/components/schemas/synckhub_server.routes.uploads.BatchFinishFileUploadIntentItemResponse" } }, "all_succeeded": { "type": "boolean" } }, "required": [ "items", "all_succeeded" ] }, "synckhub_server.routes.uploads.BatchFinishFileUploadIntentItemResponse": { "title": "BatchFinishFileUploadIntentItemResponse", "type": "object", "properties": { "upload_intent_id": { "type": "string" }, "status": { "$ref": "#/components/schemas/synckhub_uploads.intents.UploadIntentStatus" }, "blob_id": { "anyOf": [ { "type": "string" }, { "type": "null" } ] }, "commit_id": { "anyOf": [ { "type": "string" }, { "type": "null" } ] }, "error": { "anyOf": [ { "type": "string" }, { "type": "null" } ] } }, "required": [ "upload_intent_id", "status" ] }, "synckhub_server.routes.uploads.BatchUploadIntentProgressRequest": { "title": "BatchUploadIntentProgressRequest", "type": "object", "properties": { "items": { "type": "array", "items": { "$ref": "#/components/schemas/synckhub_server.routes.uploads.BatchFinishFileUploadIntentItemRequest" } } }, "required": [ "items" ], "additionalProperties": false }, "synckhub_server.routes.uploads.BatchUploadIntentProgressResponse": { "title": "BatchUploadIntentProgressResponse", "type": "object", "properties": { "items": { "type": "array", "items": { "$ref": "#/components/schemas/synckhub_server.routes.uploads.BatchUploadIntentProgressItemResponse" } } }, "required": [ "items" ] }, "synckhub_server.routes.uploads.BatchUploadIntentProgressItemResponse": { "title": "BatchUploadIntentProgressItemResponse", "type": "object", "properties": { "upload_intent_id": { "type": "string" }, "status": { "$ref": "#/components/schemas/synckhub_uploads.intents.UploadIntentStatus" }, "finish_phase": { "anyOf": [ { "$ref": "#/components/schemas/synckhub_server.upload_progress.UploadFinishPhase" }, { "type": "null" } ] }, "error": { "anyOf": [ { "type": "string" }, { "type": "null" } ] } }, "required": [ "upload_intent_id", "status" ] }, "synckhub_server.upload_progress.UploadFinishPhase": { "title": "UploadFinishPhase", "type": "string", "enum": [ "HASHING", "BLOBSTORE_PUT", "COMMIT", "PROJECTION" ] }, "synckhub_server.routes.uploads.CreateFolderTreeRequest": { "title": "CreateFolderTreeRequest", "type": "object", "properties": { "repo_id": { "type": "string" }, "root_parent_folder_id": { "anyOf": [ { "type": "string" }, { "type": "null" } ] }, "nodes": { "type": "array", "items": { "$ref": "#/components/schemas/synckhub_server.routes.uploads.FolderTreeNode" } } }, "required": [ "repo_id", "nodes" ], "additionalProperties": false }, "synckhub_server.routes.uploads.FolderTreeNode": { "title": "FolderTreeNode", "type": "object", "properties": { "client_id": { "type": "string" }, "kind": { "type": "string" }, "name": { "type": "string" }, "parent_folder_id": { "anyOf": [ { "type": "string" }, { "type": "null" } ] }, "parent_client_id": { "anyOf": [ { "type": "string" }, { "type": "null" } ] } }, "required": [ "client_id", "kind", "name" ], "additionalProperties": false }, "synckhub_server.routes.uploads.CreateFolderTreeResponse": { "title": "CreateFolderTreeResponse", "type": "object", "properties": { "repo_id": { "type": "string" }, "folders": { "type": "array", "items": { "$ref": "#/components/schemas/synckhub_server.routes.uploads.CreateUploadTreeFolderResponse" } } }, "required": [ "repo_id", "folders" ] }, "synckhub_server.routes.uploads.CreateUploadTreeFolderResponse": { "title": "CreateUploadTreeFolderResponse", "type": "object", "properties": { "client_id": { "type": "string" }, "item_id": { "type": "string" } }, "required": [ "client_id", "item_id" ] }, "synckhub_server.routes.uploads.RecoverableUploadCommitSessionAbortRequest": { "title": "RecoverableUploadCommitSessionAbortRequest", "type": "object", "properties": { "repo_id": { "type": "string" } }, "required": [ "repo_id" ] }, "synckhub_server.routes.uploads.RecoverableUploadCommitSessionAbortResponse": { "title": "RecoverableUploadCommitSessionAbortResponse", "type": "object", "properties": { "fenced": { "type": "boolean" }, "accepted_commit_id": { "anyOf": [ { "type": "string" }, { "type": "null" } ] } }, "required": [ "fenced" ] }, "synckhub_server.routes.uploads.FinishUploadCommitSessionRequest": { "title": "FinishUploadCommitSessionRequest", "type": "object", "properties": { "items": { "type": "array", "items": { "$ref": "#/components/schemas/synckhub_server.routes.uploads.FinishUploadTreeSessionItemRequest" } } }, "required": [ "items" ], "additionalProperties": false }, "synckhub_server.routes.uploads.FinishUploadTreeSessionItemRequest": { "title": "FinishUploadTreeSessionItemRequest", "type": "object", "properties": { "upload_intent_id": { "type": "string" } }, "required": [ "upload_intent_id" ], "additionalProperties": false }, "synckhub_server.routes.uploads.FinishUploadCommitSessionResponse": { "title": "FinishUploadCommitSessionResponse", "type": "object", "properties": { "repo_id": { "type": "string" }, "commit_id": { "type": "string" } }, "required": [ "repo_id", "commit_id" ] }, "synckhub_server.routes.uploads.StartUploadCommitSessionRequest": { "title": "StartUploadCommitSessionRequest", "type": "object", "properties": { "recoverable": { "type": "boolean" }, "upload_commit_session_id": { "type": "string" }, "repo_id": { "type": "string" }, "parent_folder_id": { "anyOf": [ { "type": "string" }, { "type": "null" } ] }, "message": { "anyOf": [ { "type": "string" }, { "type": "null" } ] }, "creates": { "type": "array", "items": { "$ref": "#/components/schemas/synckhub_uploads.commit_sessions.UploadCommitSessionCreate" } }, "deletes": { "type": "array", "items": { "$ref": "#/components/schemas/synckhub_uploads.commit_sessions.UploadCommitSessionDelete" } }, "edits": { "type": "array", "items": { "$ref": "#/components/schemas/synckhub_uploads.commit_sessions.UploadCommitSessionEdit" } }, "relocations": { "type": "array", "items": { "$ref": "#/components/schemas/synckhub_uploads.commit_sessions.UploadCommitSessionRelocation" } } }, "required": [ "upload_commit_session_id", "repo_id" ], "additionalProperties": false }, "synckhub_uploads.commit_sessions.UploadCommitSessionCreate": { "title": "UploadCommitSessionCreate", "type": "object", "properties": { "client_id": { "type": "string" }, "item_type": { "type": "string" }, "name": { "type": "string" }, "parent_folder_id": { "anyOf": [ { "type": "string" }, { "type": "null" } ] }, "parent_client_id": { "anyOf": [ { "type": "string" }, { "type": "null" } ] }, "upload_intent_id": { "anyOf": [ { "type": "string" }, { "type": "null" } ] }, "upload_token": { "anyOf": [ { "type": "string" }, { "type": "null" } ] } }, "required": [ "client_id", "item_type", "name" ] }, "synckhub_uploads.commit_sessions.UploadCommitSessionDelete": { "title": "UploadCommitSessionDelete", "type": "object", "properties": { "item_id": { "type": "string" }, "expected_item_seq": { "type": "integer" } }, "required": [ "item_id", "expected_item_seq" ] }, "synckhub_uploads.commit_sessions.UploadCommitSessionEdit": { "title": "UploadCommitSessionEdit", "type": "object", "properties": { "item_id": { "type": "string" }, "expected_content_item_seq": { "type": "integer" }, "upload_intent_id": { "type": "string" }, "upload_token": { "type": "string" } }, "required": [ "item_id", "expected_content_item_seq", "upload_intent_id", "upload_token" ] }, "synckhub_uploads.commit_sessions.UploadCommitSessionRelocation": { "title": "UploadCommitSessionRelocation", "type": "object", "properties": { "item_id": { "type": "string" }, "expected_item_seq": { "type": "integer" }, "parent_folder_id": { "anyOf": [ { "type": "string" }, { "type": "null" } ] }, "parent_client_id": { "anyOf": [ { "type": "string" }, { "type": "null" } ] }, "name": { "type": "string" } }, "required": [ "item_id", "expected_item_seq", "name" ] }, "synckhub_server.routes.uploads.StartUploadCommitSessionResponse": { "title": "StartUploadCommitSessionResponse", "type": "object", "properties": { "upload_commit_session_id": { "type": "string" }, "repo_id": { "type": "string" }, "parent_folder_id": { "anyOf": [ { "type": "string" }, { "type": "null" } ] }, "status": { "type": "string" }, "recovery_operation_id": { "anyOf": [ { "type": "string" }, { "type": "null" } ] }, "created": { "type": "array", "items": { "$ref": "#/components/schemas/synckhub_uploads.commit_sessions.UploadCommitSessionCreatedIntent" } }, "edited": { "type": "array", "items": { "$ref": "#/components/schemas/synckhub_uploads.commit_sessions.UploadCommitSessionEditedIntent" } } }, "required": [ "upload_commit_session_id", "repo_id", "status", "created", "edited" ] }, "synckhub_uploads.commit_sessions.UploadCommitSessionCreatedIntent": { "title": "UploadCommitSessionCreatedIntent", "type": "object", "properties": { "client_id": { "type": "string" }, "item_id": { "type": "string" }, "item_type": { "type": "string" }, "upload_intent_id": { "anyOf": [ { "type": "string" }, { "type": "null" } ] }, "status": { "anyOf": [ { "$ref": "#/components/schemas/synckhub_uploads.intents.UploadIntentStatus" }, { "type": "null" } ] }, "upload_token": { "anyOf": [ { "type": "string" }, { "type": "null" } ] }, "name": { "type": "string" } }, "required": [ "client_id", "item_id", "item_type", "name" ] }, "synckhub_uploads.commit_sessions.UploadCommitSessionEditedIntent": { "title": "UploadCommitSessionEditedIntent", "type": "object", "properties": { "item_id": { "type": "string" }, "upload_intent_id": { "type": "string" }, "status": { "$ref": "#/components/schemas/synckhub_uploads.intents.UploadIntentStatus" }, "upload_token": { "type": "string" } }, "required": [ "item_id", "upload_intent_id", "status", "upload_token" ] }, "synckhub_server.routes.uploads.AbortUploadCommitSessionResponse": { "title": "AbortUploadCommitSessionResponse", "type": "object", "properties": { "ok": { "type": "boolean" } }, "required": [ "ok" ] }, "synckhub_server.routes.uploads.StoreUploadCommitSessionFilesResponse": { "title": "StoreUploadCommitSessionFilesResponse", "type": "object", "properties": { "repo_id": { "type": "string" }, "items": { "type": "array", "items": { "$ref": "#/components/schemas/synckhub_server.routes.uploads.StoreUploadCommitSessionFilesItemResponse" } }, "all_succeeded": { "type": "boolean" } }, "required": [ "repo_id", "items", "all_succeeded" ] }, "synckhub_server.routes.uploads.StoreUploadCommitSessionFilesItemResponse": { "title": "StoreUploadCommitSessionFilesItemResponse", "type": "object", "properties": { "upload_intent_id": { "type": "string" }, "item_id": { "type": "string" }, "blob_id": { "type": "string" }, "status": { "$ref": "#/components/schemas/synckhub_uploads.intents.UploadIntentStatus" }, "error": { "anyOf": [ { "type": "string" }, { "type": "null" } ] } }, "required": [ "upload_intent_id", "item_id", "blob_id", "status" ] }, "synckhub_server.routes.uploads.FinishUploadTreeSessionRequest": { "title": "FinishUploadTreeSessionRequest", "type": "object", "properties": { "items": { "type": "array", "items": { "$ref": "#/components/schemas/synckhub_server.routes.uploads.FinishUploadTreeSessionItemRequest" } } }, "required": [ "items" ], "additionalProperties": false }, "synckhub_server.routes.uploads.StoreUploadTreeSessionFilesResponse": { "title": "StoreUploadTreeSessionFilesResponse", "type": "object", "properties": { "repo_id": { "type": "string" }, "items": { "type": "array", "items": { "$ref": "#/components/schemas/synckhub_server.routes.uploads.StoreUploadTreeSessionFilesItemResponse" } }, "all_succeeded": { "type": "boolean" } }, "required": [ "repo_id", "items", "all_succeeded" ] }, "synckhub_server.routes.uploads.StoreUploadTreeSessionFilesItemResponse": { "title": "StoreUploadTreeSessionFilesItemResponse", "type": "object", "properties": { "upload_intent_id": { "type": "string" }, "item_id": { "type": "string" }, "blob_id": { "type": "string" }, "status": { "$ref": "#/components/schemas/synckhub_uploads.intents.UploadIntentStatus" }, "error": { "anyOf": [ { "type": "string" }, { "type": "null" } ] } }, "required": [ "upload_intent_id", "item_id", "blob_id", "status" ] }, "synckhub_server.routes.uploads.FinishUploadTreeSessionResponse": { "title": "FinishUploadTreeSessionResponse", "type": "object", "properties": { "repo_id": { "type": "string" }, "commit_id": { "anyOf": [ { "type": "string" }, { "type": "null" } ] }, "root_folder_item_id": { "anyOf": [ { "type": "string" }, { "type": "null" } ] }, "files": { "type": "array", "items": { "$ref": "#/components/schemas/synckhub_server.routes.uploads.FinishUploadTreeSessionFileResponse" } } }, "required": [ "repo_id", "files" ] }, "synckhub_server.routes.uploads.FinishUploadTreeSessionFileResponse": { "title": "FinishUploadTreeSessionFileResponse", "type": "object", "properties": { "upload_intent_id": { "type": "string" }, "item_id": { "type": "string" }, "blob_id": { "type": "string" } }, "required": [ "upload_intent_id", "item_id", "blob_id" ] }, "synckhub_server.routes.uploads.StartUploadTreeSessionRequest": { "title": "StartUploadTreeSessionRequest", "type": "object", "properties": { "repo_id": { "type": "string" }, "root_parent_folder_id": { "anyOf": [ { "type": "string" }, { "type": "null" } ] }, "entries": { "type": "array", "items": { "$ref": "#/components/schemas/synckhub_uploads.tree_sessions.UploadTreeSessionEntry" } }, "name_conflict_policy": { "$ref": "#/components/schemas/synckhub_uploads.intents.UploadNameConflictPolicy" } }, "required": [ "repo_id", "entries" ], "additionalProperties": false }, "synckhub_uploads.tree_sessions.UploadTreeSessionEntry": { "title": "UploadTreeSessionEntry", "type": "object", "properties": { "relative_path": { "type": "array", "items": { "type": "string" } }, "kind": { "type": "string" } }, "required": [ "relative_path", "kind" ] }, "synckhub_uploads.tree_sessions.UploadTreeSessionStartResult": { "title": "UploadTreeSessionStartResult", "type": "object", "properties": { "upload_tree_session_id": { "type": "string" }, "repo_id": { "type": "string" }, "author_id": { "type": "string" }, "root_parent_folder_id": { "anyOf": [ { "type": "string" }, { "type": "null" } ] }, "items": { "type": "array", "items": { "$ref": "#/components/schemas/synckhub_uploads.tree_sessions.UploadTreeSessionItemMapping" } }, "file_intents": { "type": "array", "items": { "$ref": "#/components/schemas/synckhub_uploads.tree_sessions.UploadTreeSessionFileIntent" } } }, "required": [ "upload_tree_session_id", "repo_id", "author_id", "items", "file_intents" ] }, "synckhub_uploads.tree_sessions.UploadTreeSessionItemMapping": { "title": "UploadTreeSessionItemMapping", "type": "object", "properties": { "relative_path": { "type": "array", "items": { "type": "string" } }, "kind": { "type": "string" }, "item_id": { "type": "string" } }, "required": [ "relative_path", "kind", "item_id" ] }, "synckhub_uploads.tree_sessions.UploadTreeSessionFileIntent": { "title": "UploadTreeSessionFileIntent", "type": "object", "properties": { "relative_path": { "type": "array", "items": { "type": "string" } }, "upload_intent_id": { "type": "string" }, "status": { "$ref": "#/components/schemas/synckhub_uploads.intents.UploadIntentStatus" }, "upload_token": { "type": "string" }, "item_id": { "type": "string" } }, "required": [ "relative_path", "upload_intent_id", "status", "upload_token", "item_id" ] }, "synckhub_server.routes.uploads.AdoptExistingBulkFileBatchRequest": { "title": "AdoptExistingBulkFileBatchRequest", "type": "object", "properties": { "repo_id": { "type": "string" }, "batch_id": { "type": "string" }, "message": { "anyOf": [ { "type": "string" }, { "type": "null" } ] }, "files": { "type": "array", "items": { "$ref": "#/components/schemas/synckhub_server.routes.uploads.AdoptExistingBulkFileBatchFile" } } }, "required": [ "repo_id", "batch_id", "files" ], "additionalProperties": false }, "synckhub_server.routes.uploads.AdoptExistingBulkFileBatchFile": { "title": "AdoptExistingBulkFileBatchFile", "type": "object", "properties": { "client_file_id": { "type": "string" }, "item_id": { "type": "string" }, "parent_folder_id": { "anyOf": [ { "type": "string" }, { "type": "null" } ] }, "name": { "type": "string" }, "size": { "type": "integer", "minimum": 0 }, "sha256": { "type": "string" }, "relative_path": { "anyOf": [ { "type": "string" }, { "type": "null" } ] } }, "required": [ "client_file_id", "item_id", "name", "size", "sha256" ], "additionalProperties": false }, "synckhub_server.routes.uploads.BulkFileBatchResponse": { "title": "BulkFileBatchResponse", "type": "object", "properties": { "repo_id": { "type": "string" }, "batch_id": { "type": "string" }, "commit_id": { "anyOf": [ { "type": "string" }, { "type": "null" } ] }, "items": { "type": "array", "items": { "$ref": "#/components/schemas/synckhub_server.routes.uploads.BulkFileBatchItemResponse" } }, "all_succeeded": { "type": "boolean" } }, "required": [ "repo_id", "batch_id", "items", "all_succeeded" ] }, "synckhub_server.routes.uploads.BulkFileBatchItemResponse": { "title": "BulkFileBatchItemResponse", "type": "object", "properties": { "client_file_id": { "type": "string" }, "item_id": { "type": "string" }, "status": { "$ref": "#/components/schemas/synckhub_uploads.intents.UploadIntentStatus" }, "blob_id": { "anyOf": [ { "type": "string" }, { "type": "null" } ] }, "commit_id": { "anyOf": [ { "type": "string" }, { "type": "null" } ] }, "error": { "anyOf": [ { "type": "string" }, { "type": "null" } ] } }, "required": [ "client_file_id", "item_id", "status" ] }, "synckhub_server.routes.uploads.BulkFileBatchManifest": { "title": "BulkFileBatchManifest", "type": "object", "properties": { "repo_id": { "type": "string" }, "batch_id": { "type": "string" }, "message": { "anyOf": [ { "type": "string" }, { "type": "null" } ] }, "name_conflict_policy": { "$ref": "#/components/schemas/synckhub_uploads.intents.UploadNameConflictPolicy" }, "files": { "type": "array", "items": { "$ref": "#/components/schemas/synckhub_server.routes.uploads.BulkFileBatchManifestFile" } } }, "required": [ "repo_id", "batch_id", "files" ], "additionalProperties": false }, "synckhub_server.routes.uploads.BulkFileBatchManifestFile": { "title": "BulkFileBatchManifestFile", "type": "object", "properties": { "client_file_id": { "type": "string" }, "item_id": { "type": "string" }, "parent_folder_id": { "anyOf": [ { "type": "string" }, { "type": "null" } ] }, "name": { "type": "string" }, "size": { "type": "integer", "minimum": 0 }, "sha256": { "anyOf": [ { "type": "string" }, { "type": "null" } ] }, "relative_path": { "anyOf": [ { "type": "string" }, { "type": "null" } ] } }, "required": [ "client_file_id", "item_id", "name", "size" ], "additionalProperties": false }, "synckhub_server.routes.uploads.AbandonFileUploadIntentsRequest": { "title": "AbandonFileUploadIntentsRequest", "type": "object", "properties": { "repo_id": { "type": "string" }, "items": { "type": "array", "items": { "$ref": "#/components/schemas/synckhub_server.routes.uploads.AbandonFileUploadIntentItemRequest" } } }, "required": [ "repo_id", "items" ], "additionalProperties": false }, "synckhub_server.routes.uploads.AbandonFileUploadIntentItemRequest": { "title": "AbandonFileUploadIntentItemRequest", "type": "object", "properties": { "upload_intent_id": { "type": "string" } }, "required": [ "upload_intent_id" ], "additionalProperties": false }, "synckhub_server.routes.uploads.AbandonFileUploadIntentsResponse": { "title": "AbandonFileUploadIntentsResponse", "type": "object", "properties": { "repo_id": { "type": "string" }, "abandoned_count": { "type": "integer", "minimum": 0 } }, "required": [ "repo_id", "abandoned_count" ] }, "synckhub_server.routes.uploads.BatchCreateFileUploadIntentRequest": { "title": "BatchCreateFileUploadIntentRequest", "type": "object", "properties": { "repo_id": { "type": "string" }, "name_conflict_policy": { "anyOf": [ { "$ref": "#/components/schemas/synckhub_uploads.intents.UploadNameConflictPolicy" }, { "type": "null" } ] }, "items": { "type": "array", "items": { "$ref": "#/components/schemas/synckhub_server.routes.uploads.BatchCreateFileUploadIntentItem" } } }, "required": [ "repo_id", "items" ], "additionalProperties": false }, "synckhub_server.routes.uploads.BatchCreateFileUploadIntentItem": { "title": "BatchCreateFileUploadIntentItem", "type": "object", "properties": { "name": { "type": "string" }, "parent_folder_id": { "anyOf": [ { "type": "string" }, { "type": "null" } ] }, "item_subtype": { "anyOf": [ { "type": "string" }, { "type": "null" } ] }, "fields": { "anyOf": [ {}, { "type": "null" } ] }, "name_conflict_policy": { "anyOf": [ { "$ref": "#/components/schemas/synckhub_uploads.intents.UploadNameConflictPolicy" }, { "type": "null" } ] } }, "required": [ "name" ], "additionalProperties": false }, "synckhub_server.routes.uploads.BatchCreateFileUploadIntentResponse": { "title": "BatchCreateFileUploadIntentResponse", "type": "object", "properties": { "repo_id": { "type": "string" }, "items": { "type": "array", "items": { "$ref": "#/components/schemas/synckhub_server.routes.uploads.BatchCreateFileUploadIntentItemResponse" } } }, "required": [ "repo_id", "items" ] }, "synckhub_server.routes.uploads.BatchCreateFileUploadIntentItemResponse": { "title": "BatchCreateFileUploadIntentItemResponse", "type": "object", "properties": { "upload_intent_id": { "type": "string" }, "status": { "$ref": "#/components/schemas/synckhub_uploads.intents.UploadIntentStatus" }, "upload_token": { "type": "string" }, "target_item_type": { "type": "string" }, "name": { "type": "string" } }, "required": [ "upload_intent_id", "status", "upload_token", "target_item_type", "name" ] }, "synckhub_server.routes.uploads.CreateChatAttachmentUploadIntentRequest": { "title": "CreateChatAttachmentUploadIntentRequest", "type": "object", "properties": { "repo_id": { "type": "string" }, "chat_item_id": { "type": "string" }, "snapshot_name": { "anyOf": [ { "type": "string" }, { "type": "null" } ] } }, "required": [ "repo_id", "chat_item_id" ], "additionalProperties": false }, "synckhub_server.routes.uploads.CreateChatAttachmentUploadIntentResponse": { "title": "CreateChatAttachmentUploadIntentResponse", "type": "object", "properties": { "upload_intent_id": { "type": "string" }, "repo_id": { "type": "string" }, "chat_item_id": { "type": "string" }, "status": { "$ref": "#/components/schemas/synckhub_uploads.intents.UploadIntentStatus" }, "upload_token": { "type": "string" } }, "required": [ "upload_intent_id", "repo_id", "chat_item_id", "status", "upload_token" ] }, "synckhub_server.routes.uploads.CreateFileContentUploadIntentRequest": { "title": "CreateFileContentUploadIntentRequest", "type": "object", "properties": { "repo_id": { "type": "string" }, "item_id": { "type": "string" }, "chat_item_id": { "anyOf": [ { "type": "string" }, { "type": "null" } ] }, "upload_intent_id": { "anyOf": [ { "type": "string" }, { "type": "null" } ] }, "upload_token": { "anyOf": [ { "type": "string" }, { "type": "null" } ] }, "write": { "anyOf": [ { "$ref": "#/components/schemas/synckhub_server.routes.uploads.UploadWrite" }, { "type": "null" } ] } }, "required": [ "repo_id", "item_id" ], "additionalProperties": false }, "synckhub_server.routes.uploads.UploadWrite": { "title": "UploadWrite", "type": "object", "properties": { "sha256": { "type": "string" }, "size": { "type": "integer", "minimum": 0 }, "expected_head_blob_id": { "anyOf": [ { "type": "string" }, { "type": "null" } ] }, "expected_head_item_seq": { "anyOf": [ { "type": "integer" }, { "type": "null" } ] } }, "required": [ "sha256", "size" ], "additionalProperties": false }, "synckhub_server.routes.uploads.CreateFileContentUploadIntentResponse": { "title": "CreateFileContentUploadIntentResponse", "type": "object", "properties": { "upload_intent_id": { "type": "string" }, "repo_id": { "type": "string" }, "item_id": { "type": "string" }, "status": { "$ref": "#/components/schemas/synckhub_uploads.intents.UploadIntentStatus" }, "upload_token": { "type": "string" } }, "required": [ "upload_intent_id", "repo_id", "item_id", "status", "upload_token" ] }, "synckhub_server.routes.uploads.CreateFileUploadIntentRequest": { "title": "CreateFileUploadIntentRequest", "type": "object", "properties": { "repo_id": { "type": "string" }, "name": { "type": "string" }, "parent_folder_id": { "anyOf": [ { "type": "string" }, { "type": "null" } ] }, "item_subtype": { "anyOf": [ { "type": "string" }, { "type": "null" } ] }, "fields": { "anyOf": [ {}, { "type": "null" } ] }, "name_conflict_policy": { "$ref": "#/components/schemas/synckhub_uploads.intents.UploadNameConflictPolicy" }, "upload_intent_id": { "anyOf": [ { "type": "string" }, { "type": "null" } ] }, "upload_token": { "anyOf": [ { "type": "string" }, { "type": "null" } ] }, "write": { "anyOf": [ { "$ref": "#/components/schemas/synckhub_server.routes.uploads.UploadWrite" }, { "type": "null" } ] } }, "required": [ "repo_id", "name" ], "additionalProperties": false }, "synckhub_server.routes.uploads.CreateFileUploadIntentResponse": { "title": "CreateFileUploadIntentResponse", "type": "object", "properties": { "upload_intent_id": { "type": "string" }, "repo_id": { "type": "string" }, "status": { "$ref": "#/components/schemas/synckhub_uploads.intents.UploadIntentStatus" }, "upload_token": { "type": "string" }, "target_item_type": { "type": "string" }, "name": { "type": "string" } }, "required": [ "upload_intent_id", "repo_id", "status", "upload_token", "target_item_type", "name" ] }, "synckhub_server.routes.user_runtime.PushDeliveryAckRequest": { "title": "PushDeliveryAckRequest", "type": "object", "properties": { "notification_id": { "type": "string" }, "device_id": { "type": "string" } }, "required": [ "notification_id", "device_id" ], "additionalProperties": false }, "synckhub_server.routes.user_runtime.UnregisterPushDeviceRequest": { "title": "UnregisterPushDeviceRequest", "type": "object", "properties": { "device_id": { "type": "string" } }, "required": [ "device_id" ], "additionalProperties": false }, "synckhub_server.push_notifications.PushPreferenceMutation": { "title": "PushPreferenceMutation", "type": "object", "properties": { "upserts": { "type": "array", "items": { "$ref": "#/components/schemas/synckhub_server.push_notifications.PushPreferenceUpsert" } }, "resets": { "type": "array", "items": { "type": "string" } } }, "additionalProperties": false }, "synckhub_server.push_notifications.PushPreferenceUpsert": { "title": "PushPreferenceUpsert", "type": "object", "properties": { "kind": { "type": "string" }, "enabled": { "type": "boolean" } }, "required": [ "kind", "enabled" ], "additionalProperties": false }, "synckhub_server.push_notifications.PushDevicePreferenceView": { "title": "PushDevicePreferenceView", "type": "object", "properties": { "device_id": { "type": "string" }, "display_name": { "anyOf": [ { "type": "string" }, { "type": "null" } ] }, "platform": { "type": "string" }, "last_seen_at": { "type": "string", "format": "date-time" }, "preferences": { "type": "array", "items": { "$ref": "#/components/schemas/synckhub_server.push_notifications.PushDeviceKindPreferenceView" } } }, "required": [ "device_id", "platform", "last_seen_at", "preferences" ] }, "synckhub_server.push_notifications.PushDeviceKindPreferenceView": { "title": "PushDeviceKindPreferenceView", "type": "object", "properties": { "kind": { "type": "string" }, "device_override": { "anyOf": [ { "type": "boolean" }, { "type": "null" } ] }, "effective_enabled": { "type": "boolean" } }, "required": [ "kind", "effective_enabled" ] }, "synckhub_server.push_notifications.UserPushPreferenceMutation": { "title": "UserPushPreferenceMutation", "type": "object", "properties": { "upserts": { "type": "array", "items": { "$ref": "#/components/schemas/synckhub_server.push_notifications.PushPreferenceUpsert" } }, "resets": { "type": "array", "items": { "type": "string" } }, "mail_account_upserts": { "type": "array", "items": { "$ref": "#/components/schemas/synckhub_server.push_notifications.MailAccountPushPreferenceUpsert" } } }, "additionalProperties": false }, "synckhub_server.push_notifications.MailAccountPushPreferenceUpsert": { "title": "MailAccountPushPreferenceUpsert", "type": "object", "properties": { "account_id": { "type": "string" }, "enabled": { "type": "boolean" } }, "required": [ "account_id", "enabled" ], "additionalProperties": false }, "synckhub_server.push_notifications.PushPreferencesView": { "title": "PushPreferencesView", "type": "object", "properties": { "version": { "type": "integer", "minimum": 0 }, "kinds": { "type": "array", "items": { "$ref": "#/components/schemas/synckhub_server.push_notifications.PushKindPreferenceView" } }, "devices": { "type": "array", "items": { "$ref": "#/components/schemas/synckhub_server.push_notifications.PushDevicePreferenceView" } }, "mail_accounts": { "type": "array", "items": { "$ref": "#/components/schemas/synckhub_server.push_notifications.MailAccountPushPreferenceView" } } }, "required": [ "version", "kinds", "devices", "mail_accounts" ] }, "synckhub_server.push_notifications.PushKindPreferenceView": { "title": "PushKindPreferenceView", "type": "object", "properties": { "kind": { "type": "string" }, "user_override": { "anyOf": [ { "type": "boolean" }, { "type": "null" } ] }, "effective_enabled": { "type": "boolean" } }, "required": [ "kind", "effective_enabled" ] }, "synckhub_server.push_notifications.MailAccountPushPreferenceView": { "title": "MailAccountPushPreferenceView", "type": "object", "properties": { "account_id": { "type": "string" }, "email_address": { "type": "string" }, "display_name": { "anyOf": [ { "type": "string" }, { "type": "null" } ] }, "enabled": { "type": "boolean" } }, "required": [ "account_id", "email_address", "enabled" ] }, "synckhub_server.routes.user_runtime.RegisterPushDeviceRequest": { "title": "RegisterPushDeviceRequest", "type": "object", "properties": { "device_id": { "type": "string" }, "platform": { "type": "string" }, "token": { "type": "string" }, "display_name": { "anyOf": [ { "type": "string" }, { "type": "null" } ] }, "notification_preferences": { "anyOf": [ { "$ref": "#/components/schemas/synckhub_server.push_notifications.PushPreferenceMutation" }, { "type": "null" } ] }, "presentation_time_zone": { "anyOf": [ { "type": "string" }, { "type": "null" } ] }, "presentation_time_format": { "anyOf": [ { "type": "string" }, { "type": "null" } ] }, "native_call_capability_version": { "anyOf": [ { "type": "integer" }, { "type": "null" } ] }, "task_contract_version": { "anyOf": [ { "type": "integer" }, { "type": "null" } ] }, "voip_token": { "anyOf": [ { "type": "string" }, { "type": "null" } ] }, "voip_apns_environment": { "anyOf": [ { "type": "string" }, { "type": "null" } ] } }, "required": [ "device_id", "platform", "token" ], "additionalProperties": false }, "synckhub_server.routes.user_runtime.PresenceHeartbeatRequest": { "title": "PresenceHeartbeatRequest", "type": "object", "properties": { "session_id": { "type": "string" }, "device_id": { "type": "string" }, "platform": { "type": "string" }, "app_state": { "type": "string" }, "focused": { "type": "boolean" } }, "required": [ "session_id", "device_id", "platform", "app_state", "focused" ], "additionalProperties": false }, "synckhub_server.routes.maintenance.DismissUserBackgroundJobRequest": { "title": "DismissUserBackgroundJobRequest", "type": "object", "properties": { "job_id": { "type": "string" } }, "required": [ "job_id" ], "additionalProperties": false }, "synckhub_server.routes.user_runtime.CalendarSnoozeRequest": { "title": "CalendarSnoozeRequest", "type": "object", "properties": { "action_id": { "type": "string" }, "notification_id": { "type": "string" }, "selection": { "$ref": "#/components/schemas/synckhub_notifications.CalendarSnoozeSelection" } }, "required": [ "action_id", "notification_id", "selection" ], "additionalProperties": false }, "synckhub_notifications.CalendarSnoozeSelection": { "title": "CalendarSnoozeSelection", "oneOf": [ { "type": "object", "properties": { "kind": { "const": "default" } }, "required": [ "kind" ] }, { "type": "object", "properties": { "kind": { "const": "before_start" }, "minutes": { "type": "integer", "minimum": 0 } }, "required": [ "kind", "minutes" ] } ] }, "synckhub_server.reminder_delivery_job.CalendarSnoozeResponse": { "title": "CalendarSnoozeResponse", "type": "object", "properties": { "action_id": { "type": "string", "format": "uuid" }, "notification_id": { "type": "string" }, "selection": { "$ref": "#/components/schemas/synckhub_notifications.CalendarSnoozeSelection" }, "scheduled_for_epoch_secs": { "type": "integer" } }, "required": [ "action_id", "notification_id", "selection", "scheduled_for_epoch_secs" ] }, "synckhub_server.routes.wopi.MintOfficeActionUrlRequest": { "title": "MintOfficeActionUrlRequest", "type": "object", "properties": { "mode": { "type": "string" } }, "required": [ "mode" ], "additionalProperties": false }, "synckhub_server.routes.wopi.MintOfficeActionUrlResponse": { "title": "MintOfficeActionUrlResponse", "type": "object", "properties": { "action_url": { "type": "string" }, "access_token": { "type": "string" }, "access_token_ttl": { "type": "integer", "description": "Token expiry timestamp in ms since Unix epoch." }, "expires_at": { "type": "string" }, "file_id": { "type": "string" }, "wopi_src": { "type": "string" } }, "required": [ "action_url", "access_token", "access_token_ttl", "expires_at", "file_id", "wopi_src" ], "additionalProperties": false }, "synckhub_server.routes.wopi.CheckFileInfoResponse": { "title": "CheckFileInfoResponse", "type": "object", "properties": { "BaseFileName": { "type": "string" }, "OwnerId": { "type": "string" }, "Size": { "type": "integer", "minimum": 0 }, "Version": { "type": "string" }, "UserId": { "type": "string" }, "UserFriendlyName": { "type": "string" }, "UserCanWrite": { "type": "boolean" }, "ReadOnly": { "type": "boolean" }, "SupportsLocks": { "type": "boolean" }, "SupportsGetLock": { "type": "boolean" }, "SupportsExtendedLockLength": { "type": "boolean" }, "SupportsUpdate": { "type": "boolean" }, "UserCanNotWriteRelative": { "type": "boolean" }, "SupportsRename": { "type": "boolean" }, "SupportsDelete": { "type": "boolean" } }, "required": [ "BaseFileName", "OwnerId", "Size", "Version", "UserId", "UserFriendlyName", "UserCanWrite", "ReadOnly", "SupportsLocks", "SupportsGetLock", "SupportsExtendedLockLength", "SupportsUpdate", "UserCanNotWriteRelative", "SupportsRename", "SupportsDelete" ], "additionalProperties": false }, "synckhub_server.routes.yjs_wopi.CallbackCloseRequest": { "title": "CallbackCloseRequest", "type": "object", "properties": { "lease_id": { "type": "string" } }, "required": [ "lease_id" ], "additionalProperties": false }, "synckhub_server.routes.yjs_wopi.CallbackCloseResponse": { "title": "CallbackCloseResponse", "type": "object", "properties": { "ok": { "type": "boolean" } }, "required": [ "ok" ], "additionalProperties": false }, "synckhub_server.routes.yjs_wopi.CallbackPublishRequest": { "title": "CallbackPublishRequest", "type": "object", "properties": { "lease_id": { "type": "string" }, "markdown": { "type": "string" }, "stats": { "anyOf": [ {}, { "type": "null" } ] } }, "required": [ "lease_id", "markdown" ], "additionalProperties": false }, "synckhub_server.routes.yjs_wopi.CallbackPublishResponse": { "title": "CallbackPublishResponse", "type": "object", "properties": { "ok": { "type": "boolean" }, "new_version": { "anyOf": [ { "type": "string" }, { "type": "null" } ] } }, "required": [ "ok" ], "additionalProperties": false }, "synckhub_server.routes.yjs_wopi.CallbackSaveRequest": { "title": "CallbackSaveRequest", "type": "object", "properties": { "lease_id": { "type": "string" }, "markdown": { "type": "string" }, "stats": { "anyOf": [ {}, { "type": "null" } ] } }, "required": [ "lease_id", "markdown" ], "additionalProperties": false }, "synckhub_server.routes.yjs_wopi.CallbackSaveResponse": { "title": "CallbackSaveResponse", "type": "object", "properties": { "ok": { "type": "boolean" }, "new_version": { "anyOf": [ { "type": "string" }, { "type": "null" } ] } }, "required": [ "ok" ], "additionalProperties": false }, "synckhub_server.routes.yjs_wopi.CallbackRenewRequest": { "title": "CallbackRenewRequest", "type": "object", "properties": { "lease_id": { "type": "string" } }, "required": [ "lease_id" ], "additionalProperties": false }, "synckhub_server.routes.yjs_wopi.CallbackRenewResponse": { "title": "CallbackRenewResponse", "type": "object", "properties": { "ok": { "type": "boolean" }, "lease_ttl_ms": { "type": "integer", "minimum": 0 }, "lease_id": { "type": "string" } }, "required": [ "ok", "lease_ttl_ms", "lease_id" ], "additionalProperties": false }, "synckhub_server.routes.yjs_wopi.CallbackOpenRequest": { "title": "CallbackOpenRequest", "type": "object", "properties": { "doc_id": { "type": "string" }, "open_token": { "type": "string" }, "client_meta": {} }, "required": [ "doc_id", "open_token", "client_meta" ], "additionalProperties": false }, "synckhub_server.routes.yjs_wopi.CallbackOpenResponse": { "title": "CallbackOpenResponse", "type": "object", "properties": { "repo_id": { "type": "string" }, "mode": { "type": "string" }, "lease_id": { "type": "string" }, "lease_ttl_ms": { "type": "integer", "minimum": 0 }, "markdown": { "type": "string" }, "dialect_version": { "type": "string" }, "base_blob_id": { "type": "string" } }, "required": [ "repo_id", "mode", "lease_id", "lease_ttl_ms", "markdown", "dialect_version", "base_blob_id" ], "additionalProperties": false }, "synckhub_server.routes.yjs_wopi.StartSessionRequest": { "title": "StartSessionRequest", "type": "object", "properties": { "mode": { "type": "string", "description": "\"edit\" or \"view\"" }, "dialect_version": { "anyOf": [ { "type": "string" }, { "type": "null" } ], "description": "Optional transformer dialect contract. Defaults to `synckhub-md-ytext-v1`." } }, "required": [ "mode" ], "additionalProperties": false }, "synckhub_server.routes.yjs_wopi.StartSessionResponse": { "title": "StartSessionResponse", "type": "object", "properties": { "doc_id": { "type": "string" }, "open_token": { "type": "string" }, "ws_url": { "type": "string" }, "expires_at_ms": { "type": "integer", "minimum": 0 }, "mode": { "type": "string" } }, "required": [ "doc_id", "open_token", "ws_url", "expires_at_ms", "mode" ], "additionalProperties": false }, "synckhub_server.self_hosted_auth.InviteVerificationFinishBody": { "title": "InviteVerificationFinishBody", "type": "object", "properties": { "capability": { "type": "string" }, "challenge_id": { "type": "string", "format": "uuid" }, "code": { "type": "string" }, "password": { "type": "string" } }, "required": [ "capability", "challenge_id", "code", "password" ], "additionalProperties": false }, "synckhub_server.self_hosted_auth.InviteVerificationBody": { "title": "InviteVerificationBody", "type": "object", "properties": { "capability": { "type": "string" } }, "required": [ "capability" ], "additionalProperties": false }, "synckhub_server.self_hosted_auth.CapabilityPasswordBody": { "title": "CapabilityPasswordBody", "type": "object", "properties": { "capability": { "type": "string" }, "password": { "type": "string" } }, "required": [ "capability", "password" ], "additionalProperties": false }, "synckhub_server.self_hosted_auth.LoginBody": { "title": "LoginBody", "type": "object", "properties": { "email": { "type": "string" }, "password": { "type": "string" } }, "required": [ "email", "password" ], "additionalProperties": false }, "synckhub_server.self_hosted_auth.NativeRevokeRequest": { "title": "NativeRevokeRequest", "type": "object", "properties": { "client_id": { "type": "string" }, "refresh_token": { "type": "string" } }, "required": [ "client_id", "refresh_token" ] }, "synckhub_server.self_hosted_auth.NativeTokenRequest": { "title": "NativeTokenRequest", "type": "object", "properties": { "grant_type": { "type": "string" }, "client_id": { "type": "string" }, "code": { "anyOf": [ { "type": "string" }, { "type": "null" } ] }, "redirect_uri": { "anyOf": [ { "type": "string" }, { "type": "null" } ] }, "code_verifier": { "anyOf": [ { "type": "string" }, { "type": "null" } ] }, "refresh_token": { "anyOf": [ { "type": "string" }, { "type": "null" } ] } }, "required": [ "grant_type", "client_id" ] }, "synckhub_server.self_hosted_auth.NativeAuthorizeRequest": { "title": "NativeAuthorizeRequest", "type": "object", "properties": { "response_type": { "type": "string" }, "client_id": { "type": "string" }, "redirect_uri": { "type": "string" }, "code_challenge": { "type": "string" }, "code_challenge_method": { "type": "string" }, "state": { "type": "string" } }, "required": [ "response_type", "client_id", "redirect_uri", "code_challenge", "code_challenge_method", "state" ] }, "synckhub_server.self_hosted_auth.ChangePasswordBody": { "title": "ChangePasswordBody", "type": "object", "properties": { "current_password": { "type": "string" }, "new_password": { "type": "string" } }, "required": [ "current_password", "new_password" ], "additionalProperties": false }, "synckhub_server.self_hosted_auth.MemberStateBody": { "title": "MemberStateBody", "type": "object", "properties": { "state": { "type": "string" } }, "required": [ "state" ], "additionalProperties": false }, "synckhub_server.self_hosted_auth.CreateInvitationBody": { "title": "CreateInvitationBody", "type": "object", "properties": { "email": { "type": "string" }, "role": { "type": "string" } }, "required": [ "email" ], "additionalProperties": false }, "synckhub_server.self_hosted_auth.FreeBaselineBody": { "title": "FreeBaselineBody", "type": "object", "properties": { "user_ids": { "type": "array", "items": { "type": "string", "format": "uuid" } } }, "required": [ "user_ids" ], "additionalProperties": false }, "Error": { "type": "object", "required": [ "code", "message" ], "properties": { "code": { "type": "string" }, "message": { "type": "string" } }, "description": "Branch on HTTP status and code; message is human-readable context. A 403 is not an empty result. A 404 may hide an item’s existence." }, "Item": { "type": "object", "required": [ "repo_id", "item_id", "item_type", "name", "parent_folder_id", "path", "lifecycle_state" ], "properties": { "repo_id": { "type": "string" }, "item_id": { "type": "string" }, "item_type": { "type": "string", "description": "Platform item type, for example FILE, FOLDER, DATABASE, or TABLE." }, "item_subtype": { "type": "string" }, "name": { "type": "string" }, "file_extension": { "type": [ "string", "null" ] }, "parent_folder_id": { "type": [ "string", "null" ] }, "path": { "type": "string", "description": "Raw platform ltree path: ancestor folder identifiers followed by this item’s identifier." }, "lifecycle_state": { "type": "string", "enum": [ "LIVE", "TRASH", "TOMBSTONED" ] }, "size": { "type": [ "integer", "null" ], "format": "int64" }, "head_revision_item_seq": { "type": [ "integer", "null" ], "format": "int64" }, "metadata_json": true, "last_updated_at": { "type": [ "string", "null" ], "format": "date-time" }, "last_updated_by": { "type": [ "string", "null" ] } }, "additionalProperties": true, "description": "Visible item metadata. path is a dot-separated chain of literal item identifiers, preserving hyphens, not a human-readable filesystem path. Additional response fields may be returned; clients must ignore unknown fields.", "example": { "repo_id": "11111111-1111-4111-8111-111111111111", "item_id": "22222222-2222-4222-8222-222222222222", "item_type": "FILE", "item_subtype": "STANDARD", "name": "report.pdf", "file_extension": "pdf", "parent_folder_id": "33333333-3333-4333-8333-333333333333", "path": "33333333-3333-4333-8333-333333333333.22222222-2222-4222-8222-222222222222", "lifecycle_state": "LIVE", "size": 2048, "head_revision_item_seq": 7, "last_updated_at": "2026-10-08T10:00:00Z", "last_updated_by": "service:api-token:44444444-4444-4444-8444-444444444444", "locks": [] } }, "ItemList": { "type": "object", "required": [ "items" ], "properties": { "items": { "type": "array", "items": { "$ref": "#/components/schemas/Item" } }, "next_cursor": { "oneOf": [ { "$ref": "#/components/schemas/ListCursor" }, { "type": "null" } ], "description": "Cursor for the next name-ascending list page; absent on the final page and on offset-paged search results." }, "page": { "oneOf": [ { "$ref": "#/components/schemas/OffsetPage" }, { "type": "null" } ], "description": "Offset paging metadata. Advance offset by returned when has_next is true." } }, "additionalProperties": true }, "ListCursor": { "type": "object", "required": [ "after_name", "after_item_id" ], "properties": { "after_name": { "type": "string" }, "after_item_id": { "type": "string" } } }, "DownloadUrl": { "type": "object", "required": [ "url", "path", "expires_at", "download_name", "blob_id", "size_bytes" ], "properties": { "url": { "type": "string", "format": "uri" }, "path": { "type": "string" }, "expires_at": { "type": "string", "format": "date-time" }, "download_name": { "type": "string" }, "blob_id": { "type": [ "string", "null" ] }, "size_bytes": { "type": [ "integer", "null" ] } } }, "ContentRevision": { "type": "object", "required": [ "repo_id", "item_id", "item_seq", "commit_id", "event_type", "file_name", "revision_origin", "updated_at", "updated_by", "suppression_state" ], "properties": { "repo_id": { "type": "string" }, "item_id": { "type": "string" }, "item_seq": { "type": "integer", "format": "int64" }, "commit_id": { "type": "string" }, "event_type": { "type": "string" }, "file_name": { "type": "string" }, "revision_origin": { "type": "string", "enum": [ "LOCAL", "FEDERATED" ] }, "updated_at": { "type": "string", "format": "date-time" }, "updated_by": { "type": "string" }, "suppression_state": { "type": "string", "enum": [ "AVAILABLE", "SUPPRESSED" ] }, "commit_event_idx": { "type": "integer" } }, "additionalProperties": true, "description": "Immutable content history, separate from named business labels. SUPPRESSED content is subject to the server’s access policy." }, "ContentRevisionDetail": { "type": "object", "required": [ "repo_id", "item_id", "item_seq", "blob_id", "commit_id", "commit_event_idx", "updated_at", "updated_by", "suppression_state" ], "properties": { "repo_id": { "type": "string" }, "item_id": { "type": "string" }, "item_seq": { "type": "integer", "format": "int64" }, "blob_id": { "type": "string" }, "size": { "type": [ "integer", "null" ], "format": "int64" }, "commit_id": { "type": "string" }, "commit_event_idx": { "type": "integer" }, "updated_at": { "type": "string", "format": "date-time" }, "updated_by": { "type": "string" }, "suppression_state": { "type": "string", "enum": [ "AVAILABLE", "SUPPRESSED" ] } }, "additionalProperties": true }, "NamedFileVersion": { "type": "object", "required": [ "repo_id", "item_id", "version_id", "lifecycle_state", "kind", "label_source", "blob_id" ], "properties": { "repo_id": { "type": "string" }, "item_id": { "type": "string" }, "version_id": { "type": "string" }, "lifecycle_state": { "type": "string" }, "kind": { "type": "string" }, "label_source": { "type": "string", "enum": [ "INTERNAL", "EXTERNAL" ] }, "description": { "type": [ "string", "null" ] }, "comment": { "type": [ "string", "null" ] }, "blob_id": { "type": "string" }, "size": { "type": [ "integer", "null" ], "format": "int64" }, "source_item_seq": { "type": [ "integer", "null" ], "format": "int64" }, "order_key": { "type": "integer", "format": "int64" }, "version_major": { "type": [ "integer", "null" ] }, "version_minor": { "type": [ "integer", "null" ] }, "last_commit_id": { "type": "string" }, "last_commit_event_idx": { "type": "integer" } }, "additionalProperties": true, "description": "Named business label. version_id is its stable identity; source_item_seq refers to the FILE content revision. Named label identity is separate from content history." }, "EffectivePermissions": { "type": "object", "required": [ "principal_id", "resource_kind", "resource_id", "allowed_actions" ], "properties": { "principal_id": { "type": "string" }, "resource_kind": { "type": "string", "enum": [ "REPO", "FOLDER", "ITEM" ] }, "resource_id": { "type": "string" }, "allowed_actions": { "type": "array", "items": { "type": "string" } } } }, "OffsetPage": { "type": "object", "required": [ "limit", "offset", "returned", "has_prev", "has_next" ], "properties": { "limit": { "type": "integer", "minimum": 0 }, "offset": { "type": "integer", "minimum": 0 }, "returned": { "type": "integer", "minimum": 0 }, "has_prev": { "type": "boolean" }, "has_next": { "type": "boolean" }, "total_items": { "type": "integer", "minimum": 0 }, "estimated_total_items": { "type": "integer", "minimum": 0 } }, "additionalProperties": true }, "AiOpenAiModels": { "type": "object", "additionalProperties": false, "required": [ "default_model", "allowed_models", "default_reasoning_effort", "allowed_reasoning_efforts" ], "properties": { "default_model": { "type": "string", "minLength": 1, "maxLength": 128 }, "allowed_models": { "type": "array", "minItems": 1, "maxItems": 32, "uniqueItems": true, "items": { "type": "string", "minLength": 1, "maxLength": 128 } }, "default_reasoning_effort": { "type": "string", "enum": [ "low", "medium", "high" ] }, "allowed_reasoning_efforts": { "type": "array", "minItems": 1, "maxItems": 3, "uniqueItems": true, "items": { "type": "string", "enum": [ "low", "medium", "high" ] } } } }, "AiOpenAiCatalog": { "type": "object", "additionalProperties": false, "required": [ "catalog_available", "models", "reasoning_efforts", "configuration" ], "properties": { "catalog_available": { "type": "boolean" }, "configuration": { "anyOf": [ { "$ref": "#/components/schemas/AiOpenAiModels" }, { "type": "null" } ] }, "models": { "type": "array", "items": { "type": "object", "additionalProperties": false, "required": [ "id", "owned_by" ], "properties": { "id": { "type": "string", "minLength": 1, "maxLength": 128 }, "owned_by": { "type": "string", "maxLength": 128 } } } }, "reasoning_efforts": { "type": "array", "items": { "type": "string", "enum": [ "low", "medium", "high" ] } } } }, "AiOpenRouterModels": { "type": "object", "additionalProperties": false, "required": [ "default_model", "allowed_models" ], "properties": { "default_model": { "type": "string" }, "allowed_models": { "type": "array", "minItems": 1, "maxItems": 32, "uniqueItems": true, "items": { "type": "string", "minLength": 1, "maxLength": 128 } } } }, "AiOpenRouterCatalog": { "type": "object", "required": [ "catalog_available", "models", "configuration" ], "properties": { "catalog_available": { "type": "boolean" }, "configuration": { "anyOf": [ { "$ref": "#/components/schemas/AiOpenRouterModels" }, { "type": "null" } ] }, "models": { "type": "array", "items": { "type": "object", "required": [ "id", "name", "context_length", "pricing", "architecture", "supported_parameters" ], "properties": { "id": { "type": "string" }, "name": { "type": "string" }, "context_length": { "type": "integer" }, "pricing": { "type": "object", "required": [ "prompt", "completion", "request" ], "properties": { "prompt": { "type": "string" }, "completion": { "type": "string" }, "request": { "type": "string" } } }, "architecture": { "type": "object", "properties": { "input_modalities": { "type": "array", "items": { "type": "string" } }, "output_modalities": { "type": "array", "items": { "type": "string" } } } }, "supported_parameters": { "type": "array", "items": { "type": "string" } } } } } } }, "AiInputMessage": { "type": "object", "additionalProperties": false, "required": [ "body" ], "description": "Direct-agent input saved with the run; MESSAGE and FILE_REF are published only after FIFO claim.", "properties": { "body": { "type": "string" }, "reply_to_item_seq": { "type": "integer", "minimum": 1, "nullable": true }, "mentions": { "type": "array", "items": { "type": "object", "required": [ "user_id", "label", "start", "end" ], "properties": { "user_id": { "type": "string" }, "label": { "type": "string" }, "start": { "type": "integer" }, "end": { "type": "integer" } } } }, "files": { "type": "array", "maxItems": 10, "items": { "type": "object", "additionalProperties": false, "required": [ "file_id", "name" ], "properties": { "file_id": { "type": "string", "format": "uuid" }, "name": { "type": "string" } } } } } }, "AiEmailSessionResolveRequest": { "type": "object", "additionalProperties": false, "required": [ "account_id", "draft_id", "assistant_id" ], "properties": { "account_id": { "type": "string", "minLength": 1, "maxLength": 512 }, "draft_id": { "type": "string", "minLength": 1, "maxLength": 512 }, "assistant_id": { "type": "string", "minLength": 1, "maxLength": 128 } } }, "AiEmailPaneTurnResponse": { "type": "object", "additionalProperties": false, "required": [ "run_id", "status", "instruction", "created_at" ], "properties": { "run_id": { "type": "string", "format": "uuid" }, "status": { "type": "string" }, "instruction": { "type": "string" }, "output_text": { "type": "string" }, "error_code": { "type": "string" }, "error_message": { "type": "string" }, "created_at": { "type": "string", "format": "date-time" } } }, "AiEmailSessionResponse": { "type": "object", "additionalProperties": false, "required": [ "session_id", "status", "assistant_id", "expires_at", "turns" ], "properties": { "session_id": { "type": "string", "format": "uuid" }, "status": { "type": "string", "enum": [ "ACTIVE", "CLOSED", "EXPIRED" ] }, "assistant_id": { "type": "string" }, "expires_at": { "type": "string", "format": "date-time" }, "turns": { "type": "array", "maxItems": 64, "items": { "$ref": "#/components/schemas/AiEmailPaneTurnResponse" } } } }, "AiEmailRunStartRequest": { "type": "object", "additionalProperties": false, "required": [ "request_id", "assistant_id", "interaction_kind", "operation" ], "description": "PANE supports ASK and DRAFT_REPLY. INLINE_EDIT supports DRAFT_EMAIL, CUSTOM_REWRITE, REWRITE, PROOFREAD, SHORTEN, LENGTHEN, CHANGE_TONE, and TRANSLATE. DRAFT_EMAIL requires instruction and rejects selection_text. Rewrites and translation require selection_text; ASK and CUSTOM_REWRITE require instruction; CHANGE_TONE requires tone; TRANSLATE requires target_language.", "properties": { "request_id": { "type": "string", "minLength": 1, "maxLength": 128 }, "assistant_id": { "type": "string", "minLength": 1, "maxLength": 128 }, "provider": { "type": "string", "enum": [ "openai", "openrouter" ] }, "model": { "type": "string" }, "reasoning": { "type": "object", "additionalProperties": false, "properties": { "effort": { "type": "string", "enum": [ "low", "medium", "high" ] } } }, "interaction_kind": { "type": "string", "enum": [ "PANE", "INLINE_EDIT" ] }, "operation": { "type": "string", "enum": [ "ASK", "DRAFT_REPLY", "DRAFT_EMAIL", "CUSTOM_REWRITE", "REWRITE", "PROOFREAD", "SHORTEN", "LENGTHEN", "CHANGE_TONE", "TRANSLATE" ] }, "instruction": { "type": "string", "maxLength": 6000 }, "tone": { "type": "string", "enum": [ "PROFESSIONAL", "FRIENDLY", "DIRECT", "DIPLOMATIC" ] }, "context_text": { "type": "string", "maxLength": 6000 }, "selection_text": { "type": "string", "maxLength": 60000 }, "target_language": { "type": "string", "minLength": 1, "maxLength": 80, "description": "User-supplied target-language label. Translation runs are server-routed to OpenAI gpt-5.6-luna." } } }, "AiEmailRunStateResponse": { "allOf": [ { "$ref": "#/components/schemas/AiRunSummaryResponse" }, { "type": "object", "additionalProperties": false, "required": [ "repo_id", "email_session_id", "interaction_kind", "last_seq", "prompt_tokens", "completion_tokens", "cached_tokens", "reasoning_tokens", "total_tokens", "created_at", "updated_at" ], "properties": { "repo_id": { "type": "string", "format": "uuid" }, "email_session_id": { "type": "string", "format": "uuid" }, "interaction_kind": { "type": "string", "enum": [ "PANE", "INLINE_EDIT" ] }, "started_at": { "type": "string", "format": "date-time" }, "completed_at": { "type": "string", "format": "date-time" }, "last_seq": { "type": "integer" }, "error_code": { "type": "string" }, "error_message": { "type": "string" }, "prompt_tokens": { "type": "integer" }, "completion_tokens": { "type": "integer" }, "cached_tokens": { "type": "integer" }, "reasoning_tokens": { "type": "integer" }, "total_tokens": { "type": "integer" }, "created_at": { "type": "string", "format": "date-time" }, "updated_at": { "type": "string", "format": "date-time" } } } ] }, "AiRunStartRequest": { "type": "object", "additionalProperties": false, "oneOf": [ { "required": [ "source_message_item_seq" ], "not": { "required": [ "input_message" ] } }, { "required": [ "input_message", "request_id", "assistant_id" ], "not": { "anyOf": [ { "required": [ "source_message_item_seq" ] }, { "required": [ "source_message_body" ] } ] } } ], "properties": { "input_message": { "$ref": "#/components/schemas/AiInputMessage" }, "request_id": { "type": "string", "minLength": 1, "maxLength": 128, "description": "Stable retry identity. Omission derives a caller-scoped initial-turn ID from source and explicit assistant." }, "context_text": { "type": "string" }, "assistant_id": { "type": "string" }, "credential_source": { "type": "string", "enum": [ "tenant_byok", "synckhub_managed" ], "default": "tenant_byok", "description": "Explicit provider credential owner. SynckHub-managed V1 is limited to the General assistant and an admitted OpenRouter free model." }, "provider": { "type": "string", "enum": [ "openai", "openrouter" ] }, "model": { "type": "string" }, "reasoning": { "type": "object", "additionalProperties": false, "properties": { "effort": { "type": "string", "enum": [ "low", "medium", "high" ] } } }, "source_message_item_seq": { "type": "integer", "minimum": 1 }, "source_message_body": { "type": "string" }, "tool_profile": { "description": "Defaults to the assistant profile. Overrides may narrow its tool allowlist; widening returns BAD_REQUEST.", "type": "string", "enum": [ "default", "retrieval", "command_runner" ] } } }, "AiRunSummaryResponse": { "type": "object", "additionalProperties": false, "required": [ "run_id", "status", "assistant_id", "credential_source", "provider", "model" ], "properties": { "request_id": { "type": "string", "nullable": true }, "queue_sequence": { "type": "string", "pattern": "^[0-9]+$" }, "predecessor_run_id": { "type": "string", "format": "uuid", "nullable": true }, "cancel_requested_at": { "type": "string", "format": "date-time", "nullable": true }, "response_publication_state": { "type": "string", "enum": [ "NOT_REQUIRED", "PENDING", "PUBLISHED", "FAILED" ] }, "run_id": { "type": "string", "format": "uuid" }, "status": { "type": "string" }, "assistant_id": { "type": "string" }, "credential_source": { "type": "string", "enum": [ "tenant_byok", "synckhub_managed" ] }, "provider": { "type": "string" }, "model": { "type": "string" }, "reasoning_effort": { "type": "string" }, "retry_of_run_id": { "type": "string", "format": "uuid", "nullable": true } } }, "AiRunStateResponse": { "allOf": [ { "$ref": "#/components/schemas/AiRunSummaryResponse" }, { "type": "object", "additionalProperties": false, "required": [ "repo_id", "chat_item_id", "last_seq", "prompt_tokens", "completion_tokens", "cached_tokens", "reasoning_tokens", "total_tokens", "created_at", "updated_at" ], "properties": { "input_message": { "$ref": "#/components/schemas/AiInputMessage" }, "repo_id": { "type": "string", "format": "uuid" }, "chat_item_id": { "type": "string", "format": "uuid" }, "started_at": { "type": "string", "format": "date-time" }, "completed_at": { "type": "string", "format": "date-time" }, "last_seq": { "type": "integer" }, "error_code": { "type": "string" }, "error_message": { "type": "string" }, "prompt_tokens": { "type": "integer" }, "completion_tokens": { "type": "integer" }, "cached_tokens": { "type": "integer" }, "reasoning_tokens": { "type": "integer" }, "total_tokens": { "type": "integer" }, "request_message_item_seq": { "type": "integer" }, "response_message_item_seq": { "type": "integer" }, "created_at": { "type": "string", "format": "date-time" }, "updated_at": { "type": "string", "format": "date-time" } } } ] }, "AiRunsListResponse": { "type": "object", "additionalProperties": false, "required": [ "runs" ], "properties": { "runs": { "type": "array", "items": { "$ref": "#/components/schemas/AiRunStateResponse" } } } }, "AiUsageTotals": { "type": "object", "additionalProperties": false, "required": [ "run_count", "prompt_tokens", "completion_tokens", "cached_tokens", "reasoning_tokens", "total_tokens", "reported_usage_run_count", "missing_usage_run_count", "unknown_usage_run_count", "usage_complete" ], "properties": { "run_count": { "type": "integer", "minimum": 0 }, "prompt_tokens": { "type": "integer", "minimum": 0 }, "completion_tokens": { "type": "integer", "minimum": 0 }, "cached_tokens": { "type": "integer", "minimum": 0 }, "reasoning_tokens": { "type": "integer", "minimum": 0 }, "total_tokens": { "type": "integer", "minimum": 0 }, "reported_usage_run_count": { "type": "integer", "minimum": 0, "description": "Runs for which every completed provider request reported usage." }, "missing_usage_run_count": { "type": "integer", "minimum": 0, "description": "Runs with at least one normally completed provider request that omitted usage." }, "unknown_usage_run_count": { "type": "integer", "minimum": 0, "description": "Runs whose usage completeness could not be determined." }, "usage_complete": { "type": "boolean", "description": "True only when no run in this aggregate has missing or unknown usage." } } }, "AiUsageBucket": { "type": "object", "additionalProperties": false, "required": [ "bucket_start", "totals" ], "properties": { "bucket_start": { "type": "string", "format": "date-time" }, "totals": { "$ref": "#/components/schemas/AiUsageTotals" } } }, "AiUsageProviderModel": { "type": "object", "additionalProperties": false, "required": [ "provider", "model", "totals" ], "properties": { "provider": { "type": "string" }, "model": { "type": "string" }, "totals": { "$ref": "#/components/schemas/AiUsageTotals" } } }, "AiUsageResponse": { "type": "object", "additionalProperties": false, "required": [ "scope", "tenant_id", "from", "to", "generated_at", "totals", "buckets", "provider_models" ], "properties": { "scope": { "type": "string", "enum": [ "user", "tenant" ] }, "tenant_id": { "type": "string" }, "user_id": { "type": "string" }, "from": { "type": "string", "format": "date-time" }, "to": { "type": "string", "format": "date-time" }, "generated_at": { "type": "string", "format": "date-time" }, "totals": { "$ref": "#/components/schemas/AiUsageTotals" }, "buckets": { "type": "array", "items": { "$ref": "#/components/schemas/AiUsageBucket" } }, "provider_models": { "type": "array", "items": { "$ref": "#/components/schemas/AiUsageProviderModel" } } } }, "AiUsageUser": { "type": "object", "additionalProperties": false, "required": [ "user_id", "totals" ], "properties": { "user_id": { "type": "string" }, "totals": { "$ref": "#/components/schemas/AiUsageTotals" } } }, "AiUsageUsersResponse": { "type": "object", "additionalProperties": false, "required": [ "tenant_id", "from", "to", "generated_at", "total", "limit", "offset", "users" ], "properties": { "tenant_id": { "type": "string" }, "from": { "type": "string", "format": "date-time" }, "to": { "type": "string", "format": "date-time" }, "generated_at": { "type": "string", "format": "date-time" }, "total": { "type": "integer", "minimum": 0 }, "limit": { "type": "integer", "minimum": 1, "maximum": 100 }, "offset": { "type": "integer", "minimum": 0 }, "users": { "type": "array", "items": { "$ref": "#/components/schemas/AiUsageUser" } } } }, "AiRunEventResponse": { "type": "object", "additionalProperties": false, "required": [ "seq", "event_type", "payload", "created_at" ], "properties": { "seq": { "type": "integer" }, "event_type": { "type": "string" }, "payload": {}, "created_at": { "type": "string", "format": "date-time" } } }, "AiRunEventsListResponse": { "type": "object", "additionalProperties": false, "required": [ "run_id", "events" ], "properties": { "run_id": { "type": "string", "format": "uuid" }, "events": { "type": "array", "items": { "$ref": "#/components/schemas/AiRunEventResponse" } } } }, "AiAssistantSummary": { "type": "object", "additionalProperties": false, "required": [ "assistant_id", "display_name", "provider", "default_provider", "default_model", "allowed_models", "provider_options", "reasoning_policy", "tool_profile" ], "properties": { "assistant_id": { "type": "string" }, "display_name": { "type": "string" }, "description": { "type": "string" }, "provider": { "type": "string", "enum": [ "openai", "openrouter" ], "description": "Legacy response alias of default_provider for installed clients." }, "default_provider": { "type": "string", "enum": [ "openai", "openrouter" ] }, "default_model": { "type": "string" }, "allowed_models": { "type": "array", "items": { "type": "string" }, "description": "Legacy response alias of the default provider option's allowed_models; empty if no matching option exists. Never combines models from different providers." }, "provider_options": { "type": "array", "minItems": 1, "maxItems": 2, "items": { "$ref": "#/components/schemas/AiAssistantProviderOption" } }, "managed_option": { "$ref": "#/components/schemas/AiManagedOption" }, "reasoning_policy": { "type": "object" }, "tool_profile": { "type": "string" } } }, "AiAssistantProviderOption": { "type": "object", "additionalProperties": false, "required": [ "provider", "default_model", "allowed_models", "supports_reasoning_effort", "available", "unavailable_reason", "unavailable_models" ], "properties": { "provider": { "type": "string", "enum": [ "openai", "openrouter" ] }, "default_model": { "type": "string" }, "allowed_models": { "type": "array", "minItems": 0, "items": { "type": "string" } }, "supports_reasoning_effort": { "type": "boolean" }, "available": { "type": "boolean" }, "unavailable_reason": { "type": [ "string", "null" ], "enum": [ null, "key_missing", "key_disabled", "models_not_configured", "catalog_unavailable", "models_unavailable", "default_model_unavailable" ] }, "unavailable_models": { "type": "array", "items": { "type": "string" } } } }, "AiManagedOption": { "type": "object", "additionalProperties": false, "required": [ "credential_source", "provider", "default_model", "allowed_models", "supports_reasoning_effort", "available", "unavailable_reason", "unavailable_models" ], "properties": { "credential_source": { "type": "string", "const": "synckhub_managed" }, "provider": { "type": "string", "const": "openrouter" }, "default_model": { "type": "string" }, "allowed_models": { "type": "array", "items": { "type": "string" } }, "supports_reasoning_effort": { "type": "boolean", "const": false }, "available": { "type": "boolean" }, "unavailable_reason": { "type": [ "string", "null" ], "enum": [ null, "catalog_unavailable", "models_unavailable", "default_model_unavailable" ] }, "unavailable_models": { "type": "array", "items": { "type": "string" } } } }, "AiAssistantProviderOptionConfig": { "type": "object", "additionalProperties": false, "required": [ "provider", "default_model", "allowed_models" ], "properties": { "provider": { "type": "string", "enum": [ "openai", "openrouter" ] }, "default_model": { "type": "string", "minLength": 1 }, "allowed_models": { "type": "array", "minItems": 1, "maxItems": 32, "items": { "type": "string", "minLength": 1 } } } }, "AiAssistantUpsertRequest": { "type": "object", "additionalProperties": false, "required": [ "display_name", "system_prompt" ], "properties": { "assistant_id": { "type": "string" }, "display_name": { "type": "string", "minLength": 1 }, "description": { "type": [ "string", "null" ] }, "system_prompt": { "type": "string", "minLength": 1 }, "default_provider": { "type": "string", "enum": [ "openai", "openrouter" ] }, "default_model": { "type": "string", "minLength": 1 }, "provider_options": { "type": "array", "minItems": 1, "maxItems": 2, "items": { "$ref": "#/components/schemas/AiAssistantProviderOptionConfig" } }, "reasoning_policy": { "type": "object" }, "tool_profile": { "type": "string" } } }, "AiAssistantsListResponse": { "type": "object", "additionalProperties": false, "required": [ "assistants" ], "properties": { "assistants": { "type": "array", "items": { "$ref": "#/components/schemas/AiAssistantSummary" } } } }, "AiTranscriptionResponse": { "type": "object", "additionalProperties": false, "required": [ "text" ], "properties": { "text": { "type": "string", "minLength": 1 } } }, "AiProviderCredentialPutRequest": { "type": "object", "additionalProperties": false, "required": [ "api_key" ], "properties": { "api_key": { "type": "string", "minLength": 1, "maxLength": 4096 } } }, "AiProviderCredentialPatchRequest": { "type": "object", "additionalProperties": false, "required": [ "enabled" ], "properties": { "enabled": { "type": "boolean" } } }, "AiProviderCredentialSummary": { "type": "object", "additionalProperties": false, "required": [ "credential_id", "tenant_id", "provider", "status", "enabled", "credential_fingerprint", "api_key_suffix", "created_at", "updated_at" ], "properties": { "credential_id": { "type": "string", "format": "uuid" }, "tenant_id": { "type": "string" }, "provider": { "type": "string", "enum": [ "openai", "openrouter" ] }, "status": { "type": "string", "enum": [ "ACTIVE", "REVOKED" ] }, "enabled": { "type": "boolean" }, "credential_fingerprint": { "type": "string" }, "api_key_suffix": { "type": "string" }, "last_validated_at": { "type": "string", "format": "date-time" }, "last_used_at": { "type": "string", "format": "date-time" }, "last_error_code": { "type": "string" }, "last_error_message": { "type": "string" }, "created_at": { "type": "string", "format": "date-time" }, "updated_at": { "type": "string", "format": "date-time" } } }, "AiProviderCredentialsListResponse": { "type": "object", "additionalProperties": false, "required": [ "credentials" ], "properties": { "credentials": { "type": "array", "items": { "$ref": "#/components/schemas/AiProviderCredentialSummary" } } } }, "AiToolLimitsResponse": { "type": "object", "additionalProperties": false, "required": [ "max_input_bytes", "max_output_bytes", "default_timeout_ms" ], "properties": { "max_input_bytes": { "type": "integer" }, "max_output_bytes": { "type": "integer" }, "default_timeout_ms": { "type": "integer" } } }, "AiToolSummaryResponse": { "type": "object", "additionalProperties": false, "required": [ "tool_name", "version", "safety_class", "requires_approval", "description", "input_schema", "limits" ], "properties": { "tool_name": { "type": "string" }, "version": { "type": "string" }, "safety_class": { "type": "string" }, "requires_approval": { "type": "boolean" }, "description": { "type": "string" }, "input_schema": { "type": "object" }, "limits": { "$ref": "#/components/schemas/AiToolLimitsResponse" } } }, "AiToolsListResponse": { "type": "object", "additionalProperties": false, "required": [ "assistant_id", "tool_profile", "tools" ], "properties": { "assistant_id": { "type": "string" }, "tool_profile": { "type": "string" }, "tools": { "type": "array", "items": { "$ref": "#/components/schemas/AiToolSummaryResponse" } } } }, "ChatPostMessageRequest": { "type": "object", "additionalProperties": false, "required": [ "body" ], "properties": { "body": { "type": "string" }, "reply_to_item_seq": { "type": "integer", "minimum": 1 }, "attachments": { "type": "array", "items": {} } } }, "ChatPostMessageResponse": { "type": "object", "additionalProperties": false, "required": [ "user_message_item_seq" ], "properties": { "user_message_item_seq": { "type": "integer" } } }, "AiToolApprovalDecisionRequest": { "type": "object", "additionalProperties": false, "required": [ "tool_call_id", "decision" ], "properties": { "tool_call_id": { "type": "string" }, "decision": { "type": "string", "enum": [ "approve", "deny" ] }, "expires_in_seconds": { "type": "integer", "minimum": 1 } } }, "AiToolApprovalDecisionResponse": { "type": "object", "additionalProperties": false, "required": [ "approval_id", "status" ], "properties": { "approval_id": { "type": "string", "format": "uuid" }, "status": { "type": "string" }, "expires_at": { "type": "string", "format": "date-time" } } }, "AiRuntimeCallbackEvent": { "type": "object", "additionalProperties": false, "required": [ "seq", "event_type" ], "properties": { "seq": { "type": "integer" }, "event_type": { "type": "string" }, "payload": {} } }, "AiRuntimeCallbackRequest": { "type": "object", "additionalProperties": false, "required": [ "repo_id", "events" ], "oneOf": [ { "required": [ "chat_item_id" ], "not": { "required": [ "email_session_id" ] } }, { "required": [ "email_session_id" ], "not": { "required": [ "chat_item_id" ] } } ], "properties": { "repo_id": { "type": "string", "format": "uuid" }, "chat_item_id": { "type": "string", "format": "uuid" }, "email_session_id": { "type": "string", "format": "uuid" }, "events": { "type": "array", "items": { "$ref": "#/components/schemas/AiRuntimeCallbackEvent" } } } }, "AiRuntimeCallbackResponse": { "type": "object", "additionalProperties": false, "required": [ "accepted_up_to_seq", "run_status" ], "properties": { "accepted_up_to_seq": { "type": "integer" }, "run_status": { "type": "string" } } }, "AiRuntimeAttachmentInputs": { "type": "object", "additionalProperties": false, "required": [ "messages", "attachments" ], "properties": { "source_message_item_seq": { "type": "integer", "minimum": 1, "nullable": true }, "messages": { "type": "array", "maxItems": 64, "items": { "type": "object", "required": [ "item_seq", "role", "content" ], "properties": { "item_seq": { "type": "integer", "minimum": 1 }, "role": { "type": "string", "enum": [ "user", "assistant" ] }, "content": { "type": "string" } } } }, "attachments": { "type": "array", "maxItems": 10, "items": { "type": "object", "additionalProperties": false, "required": [ "message_item_seq", "content" ], "properties": { "message_item_seq": { "type": "integer", "minimum": 1 }, "content": { "oneOf": [ { "type": "object", "additionalProperties": false, "required": [ "type", "text" ], "properties": { "type": { "const": "text" }, "text": { "type": "string" } } }, { "type": "object", "additionalProperties": false, "required": [ "type", "image_url" ], "properties": { "type": { "const": "image_url" }, "image_url": { "type": "object", "additionalProperties": false, "required": [ "url", "detail" ], "properties": { "url": { "type": "string", "pattern": "^data:image/.*;base64," }, "detail": { "const": "auto" } } } } }, { "type": "object", "additionalProperties": false, "required": [ "type", "file" ], "properties": { "type": { "const": "file" }, "file": { "type": "object", "additionalProperties": false, "required": [ "filename", "file_data" ], "properties": { "filename": { "type": "string" }, "file_data": { "type": "string", "pattern": "^data:.*;base64," } } } } } ] } } } } } }, "AiRuntimeProviderCredentialResponse": { "type": "object", "additionalProperties": false, "required": [ "credential_id", "provider", "credential_fingerprint", "api_key" ], "properties": { "credential_id": { "type": "string", "format": "uuid" }, "provider": { "type": "string", "enum": [ "openai", "openrouter" ] }, "credential_fingerprint": { "type": "string" }, "api_key": { "type": "string" } } }, "AiRuntimeToolExecuteRequest": { "type": "object", "additionalProperties": false, "required": [ "repo_id", "chat_item_id", "tool_call_id", "tool_name" ], "properties": { "repo_id": { "type": "string", "format": "uuid" }, "chat_item_id": { "type": "string", "format": "uuid" }, "tool_call_id": { "type": "string" }, "tool_name": { "type": "string" }, "arguments": {} } }, "AiRuntimeToolExecuteResponse": { "type": "object", "additionalProperties": false, "required": [ "result", "duration_ms" ], "properties": { "result": {}, "duration_ms": { "type": "integer" } } }, "AiRuntimeToolApprovalStatusRequest": { "type": "object", "additionalProperties": false, "required": [ "repo_id", "chat_item_id" ], "properties": { "repo_id": { "type": "string", "format": "uuid" }, "chat_item_id": { "type": "string", "format": "uuid" } } }, "AiRuntimeToolApprovalStatusResponse": { "type": "object", "additionalProperties": false, "required": [ "approval_id", "tool_call_id", "tool_name", "status" ], "properties": { "approval_id": { "type": "string", "format": "uuid" }, "tool_call_id": { "type": "string" }, "tool_name": { "type": "string" }, "status": { "type": "string" }, "expires_at": { "type": "string", "format": "date-time" } } } }, "responses": { "Error": { "description": "Request failed", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } } } }, "parameters": { "RepoId": { "name": "repo_id", "in": "path", "required": true, "schema": { "type": "string", "format": "uuid" }, "example": "11111111-1111-4111-8111-111111111111" }, "ItemId": { "name": "item_id", "in": "path", "required": true, "schema": { "type": "string", "format": "uuid" }, "example": "22222222-2222-4222-8222-222222222222" }, "ItemSeq": { "name": "item_seq", "in": "path", "required": true, "schema": { "type": "integer", "format": "int64", "minimum": 1 }, "example": 7 }, "Limit": { "name": "limit", "in": "query", "schema": { "type": "integer", "minimum": 1, "default": 100 }, "description": "Page size for history lists. Defaults to 100. Use offset to continue." }, "Offset": { "name": "offset", "in": "query", "schema": { "type": "integer", "minimum": 0, "default": 0 } } } }, "tags": [ { "name": "activity" }, { "name": "admin_onboarding" }, { "name": "ai · assistants" }, { "name": "ai · email_sessions" }, { "name": "ai · indexing" }, { "name": "ai · runs" }, { "name": "ai · runtime" }, { "name": "ai · tools" }, { "name": "ai · transcriptions" }, { "name": "ai · workflows" }, { "name": "authz" }, { "name": "calendar · collections" }, { "name": "calendar · commands" }, { "name": "calendar · events" }, { "name": "calendar · scheduling" }, { "name": "calendar · sync" }, { "name": "carddav" }, { "name": "cases · mod" }, { "name": "cases · recents" }, { "name": "chat · connections" }, { "name": "chat · files" }, { "name": "chat · messages" }, { "name": "chat · participants" }, { "name": "chat · rooms" }, { "name": "coauthoring" }, { "name": "command_runner" }, { "name": "connected_accounts · accounts" }, { "name": "connected_accounts · oauth" }, { "name": "connected_accounts · provider_people" }, { "name": "connected_accounts · webhooks" }, { "name": "desktop_sync" }, { "name": "directory · companies" }, { "name": "directory · contacts" }, { "name": "directory · party_links" }, { "name": "docs" }, { "name": "federated_folders" }, { "name": "federation · items" }, { "name": "federation · recipient_keys" }, { "name": "federation · status" }, { "name": "files · archive" }, { "name": "files · content" }, { "name": "files · drafts" }, { "name": "files · exports" }, { "name": "files · file_ocr" }, { "name": "files · versions" }, { "name": "integration_openapi" }, { "name": "integrations" }, { "name": "items · copy" }, { "name": "items · lifecycle" }, { "name": "items · metadata" }, { "name": "items · read" }, { "name": "items · search" }, { "name": "items · subitems" }, { "name": "items · write" }, { "name": "livekit" }, { "name": "mail · archive" }, { "name": "mail · attachments" }, { "name": "mail · drafts" }, { "name": "mail · mailboxes" }, { "name": "mail · messages" }, { "name": "mail · native_calendar_invitations" }, { "name": "mail · native_clear_spam" }, { "name": "mail · native_compose" }, { "name": "mail · native_dns" }, { "name": "mail · native_filing" }, { "name": "mail · native_mark_all_read" }, { "name": "mail · native_pin" }, { "name": "mail · native_quarantine" }, { "name": "mail · native_sender_policy" }, { "name": "mail · native_shared" }, { "name": "mail · native_snooze" }, { "name": "mail · native_status" }, { "name": "mail · native_templates" }, { "name": "mail · native_unsubscribe" }, { "name": "mail · routing" }, { "name": "mail · sync" }, { "name": "maintenance" }, { "name": "mcp" }, { "name": "mod" }, { "name": "naming" }, { "name": "native_calendars" }, { "name": "native_calendars · agenda" }, { "name": "native_calendars · attention" }, { "name": "native_calendars · availability" }, { "name": "native_calendars · delegation" }, { "name": "native_calendars · event_types" }, { "name": "native_calendars · ics_import" }, { "name": "native_calendars · invitations" }, { "name": "native_calendars · invitees" }, { "name": "native_calendars · lists" }, { "name": "native_calendars · peer" }, { "name": "native_calendars · preferences" }, { "name": "native_calendars · read" }, { "name": "native_calendars · resources" }, { "name": "public_space" }, { "name": "recents" }, { "name": "repo_posts" }, { "name": "repo_settings" }, { "name": "repository_storage" }, { "name": "retrieval" }, { "name": "rtc" }, { "name": "security" }, { "name": "self_hosted_auth" }, { "name": "sharing" }, { "name": "structured_data" }, { "name": "tasks · attention" }, { "name": "tasks · calendar" }, { "name": "tasks · collections" }, { "name": "tasks · email_source" }, { "name": "tasks · email_status" }, { "name": "tasks · lists" }, { "name": "tasks · mail_team_work" }, { "name": "tasks · records" }, { "name": "tasks · seen" }, { "name": "tasks · write" }, { "name": "time_tracking" }, { "name": "uploads" }, { "name": "user_runtime" }, { "name": "vcs_replica" }, { "name": "wopi" }, { "name": "yjs_wopi" } ] }