> ## Documentation Index
> Fetch the complete documentation index at: https://docs.letsflow.ai/llms.txt
> Use this file to discover all available pages before exploring further.

# Update a ticket

> Update mutable fields on a Flow-native ticket (ticket type, state, priority, assignee, assignment team, description). The source channel is fixed at creation and cannot be updated. Rejected for tickets mirrored from external IT service management (ITSM) systems. Returns the updated ticket detail bundle.



## OpenAPI

````yaml /openapi/control-plane.json patch /v1/tickets/{key}
openapi: 3.1.0
info:
  title: Flow Customer API
  version: 1.0.0
  summary: The supported Flow API for customer integrations
  description: >-
    The definitive customer-facing Flow API v1 contract. Operations omitted from
    this document are not part of the supported customer API.
servers:
  - url: https://app.letsflow.ai
security: []
tags:
  - name: Ticketing
  - name: Workflow
  - name: Approvals
  - name: Access
  - name: Discovery
  - name: Guidance
  - name: Catalog
  - name: Events
  - name: Knowledge
  - name: Instructions
  - name: Tickets
  - name: Access Requests
paths:
  /v1/tickets/{key}:
    patch:
      tags:
        - Ticketing
      summary: Update a ticket
      description: >-
        Update mutable fields on a Flow-native ticket (ticket type, state,
        priority, assignee, assignment team, description). The source channel is
        fixed at creation and cannot be updated. Rejected for tickets mirrored
        from external IT service management (ITSM) systems. Returns the updated
        ticket detail bundle.
      operationId: updateTicket
      parameters:
        - name: key
          in: path
          required: true
          schema:
            type: string
          description: >-
            Org-scoped human ticket key (for example `PLAT-1`). Internal ticket
            UUIDs are not valid path values.
        - $ref: '#/components/parameters/IdempotencyKeyHeader'
      requestBody:
        $ref: '#/components/requestBodies/TicketUpdateBody'
      responses:
        '200':
          $ref: '#/components/responses/TicketDetailResponse'
        default:
          $ref: '#/components/responses/ProblemResponse'
      security:
        - bearerAuth:
            - runtime.write
components:
  parameters:
    IdempotencyKeyHeader:
      name: Idempotency-Key
      in: header
      required: false
      schema:
        type: string
        maxLength: 255
      description: >-
        Optional idempotency key for retry-safe write operations. For
        implemented representative writes, the same key plus the same request
        fingerprint replays the accepted result with meta.replayed=true in the
        response body. Stored HTTP responses for create requests in the customer
        API retain their original success status, including 201 Created and 202
        Accepted. An in-progress key returns 409 idempotency_key_in_progress. A
        reused key with a different request fingerprint returns 409
        idempotency_key_reused. Replay state is not signaled through an
        X-Idempotent-Replayed header.
  requestBodies:
    TicketUpdateBody:
      required: true
      content:
        application/json:
          schema:
            $ref: '#/components/schemas/TicketUpdateRequest'
  responses:
    TicketDetailResponse:
      description: >-
        Ticket detail response with messages, activities, and linked domain
        observations.
      content:
        application/json:
          schema:
            $ref: '#/components/schemas/TicketDetailEnvelope'
    ProblemResponse:
      description: Structured problem response using application/problem+json.
      headers:
        X-Request-Id:
          $ref: '#/components/headers/RequestIdHeader'
        X-Correlation-Id:
          $ref: '#/components/headers/CorrelationIdHeader'
        X-RateLimit-Limit:
          $ref: '#/components/headers/RateLimitLimitHeader'
        X-RateLimit-Remaining:
          $ref: '#/components/headers/RateLimitRemainingHeader'
        X-RateLimit-Reset:
          $ref: '#/components/headers/RateLimitResetHeader'
        Retry-After:
          $ref: '#/components/headers/RetryAfterHeader'
        X-Encore-Reauth:
          $ref: '#/components/headers/ReauthHeader'
      content:
        application/problem+json:
          schema:
            $ref: '#/components/schemas/ProblemDocument'
  schemas:
    TicketUpdateRequest:
      type: object
      properties:
        data:
          type: object
          description: Partial update payload; must include at least one mutable field.
          properties:
            assignee_principal_id:
              type:
                - string
                - 'null'
              format: uuid
            assignment_team_id:
              type:
                - string
                - 'null'
              format: uuid
            status:
              type: string
              enum:
                - open
                - pending
                - on_hold
                - closed
                - canceled
            ticket_type:
              type: string
              enum:
                - request
                - incident
            priority_kind:
              type: string
              enum:
                - low
                - normal
                - high
                - urgent
            description:
              type: string
              minLength: 1
              maxLength: 30000
            source_surface_kind:
              type:
                - string
                - 'null'
              enum:
                - api
                - cli
                - browser
                - email
                - null
          additionalProperties: false
      required:
        - data
      additionalProperties: false
    TicketDetailEnvelope:
      type: object
      properties:
        data:
          $ref: '#/components/schemas/TicketRuntimeDetailResource'
        meta:
          $ref: '#/components/schemas/Phase0Meta'
      required:
        - data
        - meta
      additionalProperties: false
    ProblemDocument:
      type: object
      properties:
        type:
          type: string
          format: uri
          description: >-
            Stable problem type uniform resource identifier (URI). Registered
            Flow problems use the canonical Flow-owned problem namespace;
            about:blank is used when no registered public problem type is
            available.
          examples:
            - https://app.letsflow.ai/problems/access-grant-not-found
            - about:blank
        title:
          type: string
        status:
          type: integer
        code:
          type: string
          enum:
            - access_grant_admin_extension_required
            - automation_grant_already_exists
            - automation_grant_not_found
            - automation_grant_required
            - automation_not_available
            - automation_action_not_available
            - automation_setup_required
            - access_grant_assignment_missing
            - access_grant_expire_race
            - access_grant_extension_disabled
            - access_grant_extension_duration_exceeds_policy
            - access_grant_extension_race
            - access_grant_extension_request_pending
            - access_grant_manager_required
            - access_grant_not_expirable
            - access_grant_not_extendable
            - access_grant_not_found
            - access_grant_not_replaceable
            - access_grant_not_revocable
            - access_grant_replace_race
            - access_grant_replacement_not_found
            - access_grant_revoke_in_progress
            - access_grant_revoke_race
            - access_grant_superseded
            - access_policy_fulfillment_snapshot_missing
            - access_request_not_found
            - access_request_duration_exceeds_policy
            - access_request_publication_audience_denied
            - access_request_publication_not_startable
            - access_request_publication_scope_invalid
            - access_request_target_not_ready
            - access_request_ticket_already_admitted
            - access_request_ticket_beneficiary_mismatch
            - access_request_ticket_scope_mismatch
            - access_request_not_ready_for_fulfillment
            - access_request_not_waiting_for_approval
            - access_request_path_not_found
            - access_request_source_surface_unsupported
            - software_license_capacity_exhausted
            - software_license_allocation_exists
            - access_review_campaign_not_active
            - access_review_item_already_decided
            - access_review_item_not_found
            - access_review_reviewer_mismatch
            - acted_for_principal_not_found
            - acted_for_requires_machine_principal
            - actor_identity_required
            - agent_disabled
            - agent_inputs_missing
            - agent_implementation_unavailable
            - agent_not_found
            - assignee_not_found
            - assignee_not_reachable
            - assignee_not_assignment_team_member
            - audit_event_not_found
            - assignee_role_not_assignable
            - assignment_team_not_found
            - assignment_team_required
            - agent_session_editing_workflow_conflict
            - agent_session_delete_conflict
            - agent_session_end_conflict
            - agent_session_inactive
            - agent_session_not_found
            - agent_session_open_race
            - agent_session_surface_mismatch
            - agent_session_team_mismatch
            - editing_workflow_conflict
            - admin_action_source_not_supported
            - atlassian_admin_association_conflict
            - atlassian_admin_connection_conflict
            - admin_audit_permission_denied
            - admin_connection_not_found
            - connected_account_deletion_cross_org_alias_conflict
            - connected_account_deletion_confirmation_invalid
            - connected_account_deletion_cleanup_unavailable
            - connected_account_deletion_in_progress
            - connected_account_deletion_not_found
            - connected_account_deletion_preview_expired
            - connected_account_deletion_preview_invalid
            - connected_account_deletion_preview_unavailable
            - connected_account_deletion_preview_stale
            - connected_account_deletion_retry_unavailable
            - connected_account_credential_generation_stale
            - connected_account_local_recovery_preview_stale
            - connected_account_local_recovery_unavailable
            - connected_account_recovery_absence_verification_failed
            - connected_account_recovery_confirmation_invalid
            - connected_account_recovery_evidence_expired
            - connected_account_recovery_evidence_mismatch
            - connected_account_recovery_manual_remediation_unavailable
            - connected_account_recovery_remediation_only
            - connected_account_recovery_remediation_owner_invalid
            - connected_account_recovery_revalidation_unavailable
            - connected_account_recovery_target_quarantined
            - step_up_invalid
            - invalid_connected_account_deletion_source_context
            - admin_connection_lifecycle_unsupported
            - admin_connection_lifecycle_target_stale
            - admin_handoff_refs_not_found
            - admin_permission_denied
            - member_access_policy_conflict
            - default_team_policy_conflict
            - default_team_policy_invalid
            - default_team_unavailable
            - admin_role_required
            - override_requires_session
            - override_already_active
            - admin_team_not_found
            - invalid_teams_channel_binding
            - invalid_teams_tenant_binding_confirmation
            - primary_chat_provider_conflict
            - teams_channel_already_bound
            - teams_channel_binding_configuration_invalid
            - teams_channel_binding_not_configured
            - teams_channel_binding_stale
            - teams_channel_credentials_rejected
            - teams_channel_provider_unavailable
            - teams_channel_app_permissions_unapproved
            - teams_channel_file_consent_required
            - teams_channel_files_access_denied
            - teams_onboarding_not_configured
            - teams_onboarding_provider_unavailable
            - teams_onboarding_session_invalid
            - teams_onboarding_verification_denied
            - teams_rsc_preflight_aborted
            - teams_rsc_preflight_failed
            - teams_rsc_preflight_timed_out
            - teams_tenant_binding_confirmation_mismatch
            - teams_tenant_binding_required
            - invitation_already_accepted
            - invitation_already_accepted_access_revoked
            - invitation_already_pending
            - invitation_activation_resend_unavailable
            - invitation_auth_continuation_invalid
            - invitation_awaiting_directory_membership
            - invitation_awaiting_workos_membership
            - browser_login_enrollment_forbidden
            - browser_login_enrollment_invalid
            - browser_login_enrollment_directory_required
            - browser_login_enrollment_not_directory_user
            - browser_login_enrollment_ambiguous_principal
            - browser_login_enrollment_mapping_invalid
            - browser_freshness_authorization_unavailable
            - browser_freshness_topic_forbidden
            - invitation_finish_joining_required
            - invitation_expired
            - invitation_fake_delivery_disabled
            - invitation_identity_conflict
            - invitation_delivery_failed
            - invitation_delivery_in_progress
            - invitation_resend_config_missing
            - invitation_resend_delivery_failed
            - invitation_resend_delivery_unavailable
            - invitation_teams_unavailable
            - invitation_teams_binding_missing
            - invitation_teams_target_mismatch
            - invitation_teams_directory_unavailable
            - invitation_teams_delivery_rejected
            - invitation_teams_delivery_unconfirmed
            - invitation_slack_binding_missing
            - invitation_slack_config_missing
            - invitation_slack_connection_unauthorized
            - invitation_slack_delivery_failed
            - invitation_slack_delivery_unavailable
            - invitation_slack_directory_unavailable
            - invitation_slack_target_mismatch
            - invitation_slack_target_missing
            - invitation_slack_workspace_mismatch
            - invitation_not_acceptable
            - invitation_not_found
            - invitation_not_retriable
            - invitation_not_revokeable
            - invitation_not_resendable
            - invitation_not_provisionable
            - invitation_force_resend_confirmation_required
            - invalid_invitation_reconcile
            - invitation_revoked
            - invitation_target_auth_required
            - invitation_target_org_mapping_invalid
            - invitation_target_org_mismatch
            - invitation_team_not_found
            - invitation_token_invalid
            - invitation_workos_invite_failed
            - invitation_workos_artifact_persist_failed
            - setup_share_link_invalid
            - setup_share_link_expired
            - setup_share_link_in_progress
            - setup_share_link_not_started
            - setup_share_link_completed
            - setup_share_link_revoked
            - setup_share_link_creator_forbidden
            - setup_share_completion_not_supported
            - setup_share_workos_success_invalid
            - setup_share_workos_success_stale
            - link_invitation_email_verification_required
            - ambiguous_auth_credentials
            - api_key_already_expired
            - api_key_already_revoked
            - api_key_expired
            - api_key_lifecycle_requires_user_session
            - api_key_not_found
            - api_key_pepper_missing
            - api_key_principal_must_be_service_account
            - api_key_revoked
            - application_target_missing
            - approval_custom_evaluator_audience_empty
            - approval_custom_evaluator_audience_too_large
            - approval_custom_evaluator_context_invalid
            - approval_custom_evaluator_start_conflict
            - approval_custom_evaluator_subject_invalid
            - approval_custom_evaluator_unavailable
            - approval_decider_not_eligible_for_stage
            - approval_decision_not_found
            - approval_principal_already_decided
            - approval_procedure_default_immutable
            - approval_procedure_definition_not_found
            - approval_procedure_document_invalid
            - approval_procedure_graph_invalid
            - approval_procedure_graph_unavailable
            - approval_procedure_hash_unavailable
            - approval_procedure_not_found
            - approval_procedure_revision_conflict
            - approval_procedure_source_not_supported
            - approval_procedure_version_not_found
            - approval_request_principal_unavailable
            - approval_self_approval_forbidden
            - approval_stage_advance_incomplete
            - approval_stage_deadline_passed
            - approval_stage_changed
            - approval_stage_not_found
            - approval_stage_not_pending
            - approval_link_missing
            - approval_input_invalid
            - approval_input_not_declared
            - approval_input_schema_invalid
            - approval_route_unavailable
            - runtime_namespace_conflict
            - runtime_namespace_connection_unavailable
            - approval_request_not_approved
            - approval_request_not_found
            - approval_request_not_pending
            - approval_source_not_supported
            - approved_sender_domain_last_entry
            - approved_sender_domain_limit_reached
            - approved_sender_domain_not_found
            - archive_requires_authoritative_missing_source
            - archive_target_missing
            - asset_archived_mutation_forbidden
            - asset_comment_forbidden
            - asset_create_forbidden
            - asset_lifecycle_forbidden
            - asset_restore_unavailable
            - asset_rename_not_supported
            - asset_field_clear_not_supported
            - asset_identity_field_not_editable
            - required_asset_field_not_clearable
            - asset_type_create_forbidden
            - asset_type_key_conflict
            - asset_update_forbidden
            - asset_duplicate_key
            - asset_field_key_inherited_collision
            - asset_fixture_mapping_reference_invalid
            - asset_fixture_mapping_value_invalid
            - asset_fixture_match_collision
            - asset_fixture_match_missing
            - asset_fixture_observed_at_invalid
            - asset_fixture_records_invalid
            - asset_mapping_match_field_not_identifier
            - asset_mapping_match_field_outside_type
            - asset_mapping_match_field_unsupported
            - asset_mapping_multiple_types_unsupported
            - asset_mapping_precedence_collision
            - asset_mapping_rule_field_outside_type
            - asset_mapping_rules_missing
            - asset_mapping_source_path_invalid
            - asset_not_found
            - asset_reassign_forbidden
            - reserved_asset_assignment_field
            - asset_sync_provider_admin_consent_required
            - asset_sync_provider_identity_probe_failed
            - asset_sync_provider_unsupported
            - servicenow_cmdb_query_invalid
            - servicenow_cmdb_query_required
            - servicenow_active_workos_projection_required
            - servicenow_commercial_owner_conflict
            - servicenow_gaic_config_cross_org_current_head_ownership
            - servicenow_gaic_config_primary_instance_name_conflict
            - servicenow_primary_instance_name_invalid
            - asset_sync_source_connect_config_mismatch
            - asset_sync_source_manual_sync_unsupported
            - asset_sync_source_not_configured
            - asset_sync_source_not_found
            - asset_sync_source_required_scopes_missing
            - asset_sync_source_revision_conflict
            - asset_sync_source_settings_unsupported
            - asset_sync_source_sync_enqueue_failed
            - asset_sync_source_unsupported_connection
            - asset_source_mapping_not_configured
            - asset_type_not_found
            - asset_unique_match_collision
            - attachment_blob_already_claimed
            - attachment_blob_not_ready
            - attachment_scan_pending
            - audit_metadata_too_large
            - auth_org_scope_mismatch
            - auth_team_scope_mismatch
            - authenticated_principal_mismatch
            - authentication_required
            - bearer_token_required
            - blob_bytes_not_found
            - blob_ref_not_downloadable
            - blob_ref_not_found
            - browser_request_verification_failed
            - browser_principal_required
            - broker_reconciliation_target_not_found
            - connected_account_hierarchy_mismatch
            - connected_account_not_found
            - connected_account_team_availability_missing
            - connected_account_unhealthy
            - connected_account_team_scope_mismatch
            - connection_authorization_revoked
            - connection_share_already_active
            - connection_share_capability_exceeds_owner
            - connection_share_capability_invalid
            - connection_share_not_found
            - connection_share_role_required
            - connection_share_subject_unsupported
            - connection_share_target_not_found
            - connection_share_target_too_broad
            - connector_selection_not_visible
            - credential_rotation_active_credential_missing
            - credential_rotation_active_credential_stale
            - credential_rotation_rollback_target_missing
            - credential_rotation_rollback_unavailable
            - nango_webhook_ingress_disabled
            - nango_webhook_signing_key_missing
            - invalid_nango_webhook_payload
            - invalid_nango_webhook_signature
            - nango_webhook_body_too_large
            - paddle_webhook_ingress_disabled
            - paddle_webhook_secret_missing
            - paddle_webhook_runtime_not_ready
            - invalid_paddle_webhook_payload
            - invalid_paddle_webhook_signature
            - paddle_webhook_body_too_large
            - paddle_webhook_receipt_missing
            - billing_meter_not_configured
            - billing_meter_credit_invalid
            - billing_credit_amount_invalid
            - billing_credit_top_up_invalid
            - billing_credit_top_up_subscription_missing
            - billing_credit_top_up_trial_active
            - billing_credit_top_up_unavailable
            - billing_credit_top_up_rejected
            - billing_credit_alert_floor_invalid
            - billing_credit_alert_unavailable
            - billing_credit_balance_exhausted
            - billing_usage_quantity_invalid
            - billing_charge_quantity_invalid
            - billing_charge_not_found
            - billing_charge_reconciliation_ambiguous
            - billing_charge_submission_state_invalid
            - billing_usage_period_subscription_missing
            - billing_payment_details_session_invalid
            - billing_payment_details_unavailable
            - billing_owner_role_required
            - commercial_owner_not_configured
            - commercial_owner_incompatible
            - paddle_charge_submission_not_configured
            - paddle_payment_details_not_configured
            - paddle_payment_details_unavailable
            - paddle_customer_mismatch
            - paddle_customer_not_linked
            - paddle_customer_portal_not_configured
            - paddle_customer_portal_response_invalid
            - paddle_customer_portal_unavailable
            - paddle_subscription_ineligible
            - paddle_subscription_not_found
            - billing_entitlement_frozen
            - billing_entitlement_expired
            - billing_entitlement_not_found
            - billing_invoice_not_found
            - billing_invoice_ownership_mismatch
            - billing_invoice_history_unavailable
            - billing_invoice_pdf_not_supported
            - billing_invoice_pdf_unavailable
            - paddle_invoice_history_not_configured
            - http_integration_ai_unavailable
            - http_integration_authentication_not_required
            - http_integration_authentication_required
            - http_integration_connector_disabled
            - http_integration_connector_not_found
            - http_integration_connector_key_conflict
            - http_integration_connection_mismatch
            - http_integration_connection_reset_failed
            - http_integration_credential_configuration_invalid
            - http_integration_credential_scheme_unsupported
            - http_integration_ingestion_draft_not_found
            - http_integration_provisioning_conflict
            - http_integration_provisioning_failed
            - http_integration_source_fetch_failed
            - http_integration_source_invalid
            - nango_connect_session_unavailable
            - nango_connect_session_not_found
            - nango_connect_session_mismatch
            - nango_connect_session_mode_mismatch
            - nango_connect_session_expired
            - nango_connect_session_replayed
            - nango_connect_session_unverified
            - nango_google_workspace_proxy_unavailable
            - nango_microsoft_entra_proxy_unavailable
            - nango_microsoft_intune_proxy_unavailable
            - nango_duo_proxy_unavailable
            - nango_servicenow_cmdb_proxy_unavailable
            - nango_tanium_proxy_unavailable
            - nango_connection_ownership_mismatch
            - nango_connection_pending_visibility
            - nango_connection_unhealthy
            - nango_connection_verification_failed
            - nango_connection_temporarily_unhealthy
            - nango_connection_external_identity_mismatch
            - nango_connection_reauth_state_conflict
            - nango_connection_disconnect_failed
            - nango_connection_disconnect_unavailable
            - nango_connection_lifecycle_unsupported
            - microsoft_entra_nango_config_missing
            - microsoft_entra_admin_consent_required
            - microsoft_entra_identity_probe_failed
            - microsoft_entra_required_scopes_missing
            - microsoft_intune_admin_consent_required
            - mintlify_docs_auth_not_configured
            - microsoft_intune_identity_probe_failed
            - microsoft_intune_operation_conflict
            - microsoft_intune_operation_connection_not_configured
            - microsoft_intune_operation_invalid
            - microsoft_intune_operation_missing_scopes
            - microsoft_intune_operation_not_pending_approval
            - microsoft_intune_operation_not_found
            - microsoft_outlook_admin_consent_required
            - microsoft_outlook_app_only_probe_failed
            - microsoft_outlook_calendar_probe_failed
            - okta_admin_scopes_required
            - okta_identity_probe_failed
            - google_workspace_admin_consent_required
            - google_workspace_identity_probe_failed
            - jira_required_scopes_missing
            - jira_admin_attach_connection_ineligible
            - jira_admin_attach_site_ambiguous
            - jira_admin_attach_site_unresolvable
            - jira_connection_already_configured
            - jira_multiple_accessible_sites
            - jira_no_accessible_sites
            - jira_service_management_access_denied
            - jira_service_desk_metadata_unavailable
            - jira_service_desk_not_found
            - jira_request_type_not_found
            - jira_site_identity_unverified
            - resend_webhook_ingress_disabled
            - resend_webhook_secret_missing
            - resend_api_key_missing
            - invalid_resend_webhook_payload
            - invalid_resend_webhook_signature
            - resend_webhook_body_too_large
            - resend_received_email_unavailable
            - resend_received_email_attachments_unavailable
            - invalid_email_approval_reply
            - email_approval_reply_ambiguous
            - email_approval_reply_expired
            - email_approval_reply_sender_unverified
            - email_approval_reply_sender_domain_not_approved
            - email_continuation_ambiguous_reply_target
            - email_continuation_header_match_ambiguous
            - email_continuation_sender_unresolved
            - email_continuation_ticket_not_found
            - email_intake_address_ambiguous
            - email_intake_domain_not_configured
            - email_intake_sender_unresolved
            - email_root_intake_address_immutable
            - email_root_intake_address_not_permitted
            - email_thread_sender_not_participant
            - email_thread_attachment_conflict
            - email_thread_ticket_mismatch
            - invalid_email_continuation_reply_address
            - invalid_email_continuation_reply_target
            - blob_ref_not_ready
            - capability_disabled
            - catalog_actor_relationship_forbidden
            - catalog_actor_relationship_unsupported
            - catalog_applicability_policy_too_complex
            - catalog_automation_unavailable
            - catalog_beneficiary_not_found
            - catalog_discovery_policy_context_invalid
            - catalog_entry_identity_required
            - catalog_entry_inapplicable
            - catalog_entry_not_found
            - catalog_form_ref_invalid
            - catalog_form_ref_stale
            - instruction_not_executable
            - instruction_requester_mismatch
            - catalog_input_context_invalid
            - catalog_input_context_missing
            - catalog_input_mapping_unmatched
            - catalog_inputs_invalid
            - catalog_requester_not_found
            - catalog_fulfiller_assistance_forbidden
            - catalog_request_context_invalid
            - workflow_catalog_exposure_ineligible
            - catalog_submission_kind_mismatch
            - catalog_surface_unavailable
            - catalog_surface_unsupported
            - catalog_target_team_required
            - catalog_user_input_not_allowed
            - catalog_workflow_gate_misconfigured
            - catalog_workflow_gate_unresolvable
            - catalog_workflow_input_bindings_invalid
            - catalog_workflow_source_not_found
            - workflow_approval_manifest_invalid
            - workflow_approval_procedure_not_found
            - workflow_dispatch_gate_misconfigured
            - workflow_dispatch_gate_unresolvable
            - audience_rule_grants_nothing
            - audience_rule_invalid_role
            - audience_rule_missing_subject
            - audience_rule_extra_subject
            - audience_rule_unknown_group
            - not_authorized
            - invalid_body
            - invalid_boolean
            - invalid_string
            - invalid_subject_kind
            - invalid_uuid
            - checksum_mismatch
            - confirmation_required
            - created_access_request_not_found
            - created_workflow_run_not_found
            - decided_by_principal_not_found
            - directory_group_not_active
            - directory_group_not_found
            - delegated_request_not_allowed
            - dev_auth_headers_disabled
            - discovered_application_missing
            - discovered_application_not_found
            - discovered_entitlement_missing
            - discovered_entitlement_not_found
            - access_policy_target_not_found
            - access_profile_target_not_found
            - request_workflow_definition_target_not_found
            - canonical_application_target_not_active
            - canonical_application_target_not_found
            - canonical_entitlement_access_binding_target_not_active
            - canonical_entitlement_access_binding_target_not_found
            - canonical_entitlement_application_mismatch
            - canonical_entitlement_target_not_active
            - canonical_entitlement_target_not_found
            - canonical_team_application_binding_target_not_active
            - canonical_team_application_binding_target_not_found
            - discovery_decision_not_created
            - discovery_run_apply_in_progress
            - discovery_run_apply_unavailable
            - discovery_run_id_required
            - discovery_run_not_found
            - invalid_apply_payload
            - requestable_entitlement_binding_incomplete
            - download_session_consumed
            - download_session_expired
            - download_session_not_found
            - download_session_not_open
            - dual_control_no_pending
            - dual_control_pending_expired
            - dual_control_same_principal
            - elevation_requires_org_admin
            - elevation_session_end_denied
            - elevation_session_not_active
            - elevation_session_not_found
            - elevation_session_scope_mismatch
            - entitlement_not_found
            - entitlement_not_requestable
            - extension_request_context_missing
            - external_revision_changed_before_outbound
            - github_team_access_workflow_not_found
            - google_drive_knowledge_nango_integration_invalid
            - google_drive_knowledge_nango_integration_unavailable
            - google_drive_knowledge_identity_probe_failed
            - google_drive_knowledge_identity_unavailable
            - google_drive_knowledge_connection_not_found
            - google_drive_knowledge_reconnect_identity_mismatch
            - google_drive_knowledge_connect_session_target_mismatch
            - helper_session_unavailable
            - idempotency_key_conflict
            - idempotency_key_in_progress
            - invalid_idempotency_key
            - idempotency_key_reused
            - idempotency_key_unreplayable
            - insufficient_scope
            - invalid_api_key
            - invalid_api_key_display_name
            - invalid_api_key_expiration
            - invalid_api_key_principal
            - invalid_webhook_display_name
            - invalid_webhook_event_types
            - invalid_webhook_status
            - invalid_webhook_url
            - unsafe_webhook_url
            - unsupported_webhook_event_type
            - webhook_endpoint_disabled
            - webhook_endpoint_not_found
            - webhook_event_not_found
            - webhook_replay_conflict
            - webhook_contract_retired
            - webhook_body_integrity_failed
            - webhook_secret_encryption_not_configured
            - invalid_asset_comment
            - invalid_asset_field_kind
            - invalid_asset_field_value
            - invalid_asset_key
            - invalid_asset_reference_targets
            - invalid_auth_header
            - invalid_auth_principal
            - invalid_auth_source_surface
            - invalid_authorization_header
            - invalid_bearer_token
            - invalid_blob_ref
            - invalid_blob_object_key
            - invalid_blob_scan_verdict
            - invalid_capability_update
            - invalid_checksum
            - attachment_extension_dangerous
            - attachment_extension_missing
            - attachment_extension_unsupported
            - attachment_mime_mismatch
            - invalid_confirmation_text
            - invalid_content_type
            - invalid_correlation_id
            - invalid_deferred_until
            - invalid_disposition_kind
            - invalid_directory_group_projection_id
            - invalid_email_recipient
            - invalid_invitation_channel
            - invalid_invitation_email
            - invalid_invitation_payload
            - invalid_invitation_target
            - invalid_invitation_targets
            - invalid_profile_preference
            - invalid_invitation_role
            - invalid_invitation_token
            - invalid_extension_duration
            - invalid_external_document_push
            - invalid_failure_demo_attempts
            - invalid_filename
            - invalid_json
            - invalid_knowledge_document
            - invalid_knowledge_query
            - invalid_max_size
            - invalid_mcp_arguments
            - invalid_mcp_cursor
            - invalid_mcp_meta
            - invalid_mcp_params
            - invalid_mcp_resource_uri
            - invalid_metadata
            - invalid_notification_preferences
            - invalid_mime_type
            - invalid_path_parameter
            - invalid_principal_id
            - invalid_idp_role_rule_status
            - invalid_idp_rule_status
            - invalid_query_parameter
            - invalid_reason_code
            - invalid_return_to
            - invalid_request_body
            - request_validation_failed
            - invalid_sender_domain
            - internal_admin_dev_bypass_not_allowed
            - internal_admin_token_missing
            - internal_admin_required
            - invalid_prompt_preview
            - invalid_prompt_release
            - invalid_prompt_release_scope
            - invalid_prompt_tenant_override
            - invalid_local_trial_extension
            - local_trial_extension_invalid
            - local_trial_extension_not_applicable
            - platform_admin_org_not_configured
            - platform_admin_role_required
            - platform_admin_workos_required
            - platform_admin_fresh_auth_required
            - organization_deletion_not_eligible
            - organization_deletion_confirmation_invalid
            - organization_deletion_preview_invalid
            - organization_deletion_preview_stale
            - organization_deletion_restricted
            - organization_administrator_required
            - organization_not_found
            - tenant_not_matched
            - tenant_model_registry_not_found
            - invalid_organization_slug
            - prompt_release_key_conflict
            - prompt_release_not_found
            - publication_projection_stale
            - publication_version_conflict
            - prompt_tenant_override_not_found
            - invalid_scope_families
            - ungrantable_scope_families
            - invalid_search_cursor
            - research_proposal_not_found
            - research_run_not_found
            - opportunity_not_found
            - research_opportunities_unavailable
            - crawl_progress_run_not_found
            - invalid_search_query
            - invalid_search_provider_installation
            - federated_search_disabled
            - federated_search_authentication_required
            - federated_concurrency_exceeded
            - federated_provider_unavailable
            - invalid_slack_action_dispatch
            - invalid_slack_channel_discovery_cursor
            - invalid_slack_ingress_payload
            - channel_artifact_coordinate_mismatch
            - channel_artifact_not_found
            - channel_artifact_action_not_found
            - channel_artifact_ambiguous
            - slack_ingress_body_too_large
            - invalid_source_surface
            - invalid_setup_section
            - invalid_step_key
            - invalid_storage_class
            - invalid_team_role
            - invalid_team_capabilities
            - invalid_team_display_name
            - invalid_team_service_description
            - invalid_team_slug
            - invalid_team_stable_prefix
            - invalid_traceparent
            - invalid_workos_bearer
            - invalid_ttl_seconds
            - justification_required
            - guidance_active_version_conflict
            - guidance_draft_version_conflict
            - guidance_instruction_not_archivable
            - guidance_instruction_content_required
            - guidance_instruction_content_too_large
            - guidance_rule_conflict
            - guidance_rule_not_editable
            - guidance_rule_not_found
            - guidance_version_not_publishable
            - instruction_archived
            - instruction_authoring_required
            - instruction_authoring_session_not_found
            - instruction_authoring_target_conflict
            - instruction_automation_unavailable
            - instruction_bulk_selection_conflict
            - instruction_document_required
            - instruction_input_schema_invalid
            - instruction_knowledge_unavailable
            - instruction_not_found
            - instruction_publication_not_found
            - instruction_publication_unavailable
            - instruction_request_invalid
            - instruction_resource_unavailable
            - instruction_revision_not_found
            - instruction_scope_target_invalid
            - instruction_write_conflict
            - model_registry_version_conflict
            - knowledge_document_not_found
            - knowledge_document_update_temporarily_busy
            - kill_switch_expiration_invalid
            - kill_switch_not_found
            - kill_switch_override_not_found
            - kill_switch_target_invalid
            - knowledge_source_binding_archived
            - crawl_progress_operation_already_terminal
            - crawl_progress_operation_not_found
            - crawl_progress_operation_temporarily_busy
            - knowledge_source_binding_concurrently_deleted
            - knowledge_source_binding_purge_in_progress
            - knowledge_source_binding_scope_conflict
            - knowledge_source_binding_revision_required
            - knowledge_source_binding_selection_overlap
            - knowledge_source_binding_stale_configuration
            - knowledge_source_crawl_config_incompatible
            - knowledge_source_identity_changed
            - knowledge_source_publication_transition_in_progress
            - knowledge_source_read_policy_enforced
            - knowledge_source_read_policy_version_conflict
            - knowledge_source_shared_selection_edit_conflict
            - link_target_missing
            - link_target_not_found
            - local_setup_baseline_missing
            - local_setup_disabled
            - local_setup_org_mismatch
            - group_role_grant_conflict
            - idp_role_rule_not_found
            - manual_group_role_grant_exists
            - machine_credentials_not_supported_in_mcp
            - mcp_resource_family_not_found
            - mcp_body_too_large
            - mcp_tool_concurrency_limit_exceeded
            - mcp_tool_not_found
            - not_found
            - route_not_found
            - mcp_tool_timeout
            - mime_mismatch
            - missing_query_parameter
            - missing_admin_handoff_refs
            - missing_required_asset_fields
            - missing_upload_body
            - org_membership_required
            - parent_scope_not_found
            - permission_not_found
            - principal_not_found
            - principal_id_mismatch
            - principal_id_required
            - product_provisioning_action_unsupported
            - product_provisioning_connection_unhealthy
            - github_team_provisioning_action_unsupported
            - github_team_provisioning_config_missing
            - github_team_provisioning_missing_scopes
            - github_team_provisioning_subject_missing
            - github_team_provisioning_target_missing
            - guardduty_object_key_missing
            - guardduty_scan_status_unsupported
            - google_workspace_group_provisioning_action_unsupported
            - google_workspace_group_provisioning_config_missing
            - google_workspace_group_provisioning_missing_scopes
            - google_workspace_group_provisioning_subject_missing
            - google_workspace_group_provisioning_target_missing
            - microsoft_entra_group_provisioning_action_unsupported
            - microsoft_entra_group_provisioning_config_missing
            - microsoft_entra_group_provisioning_missing_scopes
            - microsoft_entra_group_provisioning_subject_missing
            - microsoft_entra_group_provisioning_target_missing
            - okta_provisioning_action_unsupported
            - okta_provisioning_config_missing
            - okta_provisioning_missing_scopes
            - okta_provisioning_subject_missing
            - okta_provisioning_target_missing
            - google_workspace_license_provisioning_action_unsupported
            - google_workspace_license_provisioning_config_missing
            - google_workspace_license_provisioning_missing_scopes
            - google_workspace_license_provisioning_subject_missing
            - google_workspace_license_provisioning_target_missing
            - google_workspace_nango_config_missing
            - google_drive_knowledge_nango_config_missing
            - google_drive_knowledge_required_scopes_missing
            - google_drive_knowledge_connection_not_connected
            - confluence_cloud_knowledge_nango_config_missing
            - confluence_cloud_knowledge_required_scopes_missing
            - confluence_cloud_knowledge_connection_not_connected
            - confluence_cloud_knowledge_no_accessible_sites
            - confluence_site_not_authorized
            - confluence_knowledge_setup_expired
            - confluence_access_mode_transition_required_acknowledgment
            - confluence_access_mode_transition_in_progress
            - confluence_cloud_knowledge_identity_probe_failed
            - confluence_cloud_knowledge_accessible_resources_probe_failed
            - confluence_cloud_knowledge_connection_not_found
            - atlassian_admin_connection_not_found
            - confluence_cloud_knowledge_source_required
            - knowledge_source_manual_sync_unsupported
            - knowledge_source_place_unavailable
            - dropbox_knowledge_team_id_unavailable
            - notion_knowledge_workspace_id_unavailable
            - google_directory_knowledge_nango_config_missing
            - google_directory_knowledge_required_scopes_missing
            - google_directory_knowledge_connection_not_connected
            - google_directory_knowledge_identity_probe_failed
            - google_directory_knowledge_customer_unavailable
            - confluence_cloud_knowledge_sync_failed
            - confluence_cloud_knowledge_sync_disabled
            - nango_confluence_proxy_unavailable
            - jira_sync_run_already_active
            - servicenow_sync_run_already_active
            - jira_provider_rate_limited
            - servicenow_provider_rate_limited
            - ticket_sync_concurrent_mapping_update
            - ticket_sync_mapping_not_found
            - ticket_sync_status_mapping_default_conflict
            - ticket_sync_status_mapping_duplicate_source
            - ticket_sync_priority_mapping_default_conflict
            - ticket_sync_priority_mapping_duplicate_source
            - ticket_sync_link_not_found
            - ticket_sync_link_sync_failed
            - ticket_sync_selective_sync_unsupported
            - ticket_sync_compensation_unavailable
            - ticket_sync_compensation_stale
            - ticket_sync_compensation_unconfirmed
            - ticket_sync_missing_mapping
            - ticket_sync_required_scope_missing
            - ticket_sync_scope_not_configured
            - ticket_sync_multiple_active_systems
            - ticket_sync_setup_draft_not_found
            - ticket_sync_setup_draft_incomplete
            - ticket_sync_setup_scope_changed
            - ticket_sync_concurrent_setup_draft_update
            - ticket_sync_auth_expired
            - ticket_sync_deleted_provider_ticket
            - ticket_sync_provider_not_supported
            - ticket_sync_unsupported_status
            - sharepoint_online_knowledge_nango_config_missing
            - sharepoint_online_knowledge_credentials_invalid
            - sharepoint_online_knowledge_admin_consent_required
            - sharepoint_online_knowledge_tenant_not_found
            - microsoft_tenant_not_found
            - microsoft_tenant_lookup_unavailable
            - microsoft_tenant_mismatch
            - sharepoint_online_knowledge_connection_not_connected
            - sharepoint_online_knowledge_identity_probe_failed
            - sharepoint_online_knowledge_sync_failed
            - sharepoint_online_knowledge_sync_disabled
            - nango_sharepoint_proxy_unavailable
            - sharepoint_online_scoped_knowledge_nango_config_missing
            - sharepoint_online_scoped_knowledge_credentials_invalid
            - sharepoint_online_scoped_knowledge_admin_consent_required
            - sharepoint_online_scoped_knowledge_connection_not_connected
            - sharepoint_online_scoped_knowledge_identity_probe_failed
            - sharepoint_online_scoped_knowledge_sync_disabled
            - sharepoint_online_scoped_site_not_granted
            - sharepoint_online_scoped_resolve_failed
            - nango_sharepoint_scoped_proxy_unavailable
            - dropbox_knowledge_nango_config_missing
            - dropbox_knowledge_admin_consent_required
            - dropbox_knowledge_identity_probe_failed
            - dropbox_knowledge_connection_not_found
            - dropbox_knowledge_connection_not_connected
            - dropbox_knowledge_sync_failed
            - dropbox_knowledge_sync_disabled
            - dropbox_discovery_failed
            - dropbox_namespace_access_denied
            - nango_dropbox_proxy_unavailable
            - box_knowledge_nango_config_missing
            - box_knowledge_admin_consent_required
            - box_knowledge_identity_probe_failed
            - box_knowledge_connection_not_found
            - box_knowledge_connection_not_connected
            - box_knowledge_sync_failed
            - box_knowledge_sync_disabled
            - nango_box_proxy_unavailable
            - notion_knowledge_nango_config_missing
            - notion_knowledge_capability_required
            - notion_knowledge_identity_probe_failed
            - notion_knowledge_connection_not_found
            - notion_knowledge_connection_not_connected
            - notion_knowledge_connection_unhealthy
            - notion_knowledge_binding_unhealthy
            - servicenow_knowledge_connection_not_connected
            - servicenow_unscoped_table_api_not_allowed
            - servicenow_table_api_scope_missing
            - servicenow_ticket_table_read_denied
            - servicenow_knowledge_table_read_denied
            - notion_knowledge_sync_failed
            - notion_knowledge_sync_disabled
            - notion_selection_update_requires_patch
            - nango_notion_proxy_unavailable
            - google_workspace_required_scopes_missing
            - google_workspace_connection_not_connected
            - fulfillment_step_kind_not_supported
            - fulfillment_step_missing
            - http_rate_limit_unavailable
            - rate_limited
            - tenant_circuit_open
            - tenant_resource_limit_exceeded
            - reason_required
            - rebuild_scope_required
            - requested_actor_not_eligible
            - requested_by_principal_mismatch
            - requested_by_principal_not_found
            - requested_for_principal_not_found
            - search_query_not_searchable
            - search_query_too_short
            - search_retrieval_incomplete
            - search_provider_installation_incomplete
            - search_provider_not_installed
            - search_provider_installation_not_found
            - selected_resource_mismatch
            - self_request_not_allowed
            - service_account_not_found
            - service_account_not_active
            - service_account_email_in_use
            - slack_dm_agent_session_conflict
            - slack_dm_ticket_session_conflict
            - slack_ingress_principal_conflict
            - slack_ingress_principal_unavailable
            - slack_ingress_not_configured
            - slack_invitation_target_connection_ambiguous
            - slack_invitation_target_connection_not_found
            - slack_operator_binding_required
            - slack_operator_channel_already_bound
            - slack_operator_channel_discovery_failed
            - slack_operator_channel_discovery_rate_limited
            - slack_operator_channel_discovery_stale
            - slack_operator_channel_mismatch
            - slack_operator_nango_config_missing
            - slack_operator_required_role_missing
            - slack_operator_install_unhealthy
            - slack_operator_scope_extraction_failed
            - slack_operator_email_evidence_mismatch
            - slack_operator_user_discovery_failed
            - slack_operator_user_not_eligible
            - slack_operator_user_verification_failed
            - slack_operator_validation_failed
            - slack_operator_workspace_access_required
            - slack_operator_workspace_mismatch
            - slack_operator_workspace_selection_required
            - slack_signature_invalid
            - slack_thread_attachment_conflict
            - slack_thread_ticket_mismatch
            - slack_ticket_reference_required
            - slack_verified_actor_required
            - source_access_request_not_found
            - source_surface_disabled
            - source_surface_mismatch
            - source_workflow_run_not_found
            - workflow_composition_cycle
            - workflow_composition_depth_exceeded
            - workflow_composition_descendant_limit_exceeded
            - workflow_composition_lineage_invalid
            - workflow_composition_parent_not_found
            - workflow_composition_parent_required
            - workflow_source_requires_catalog_provenance
            - stale_asset_revision
            - stale_canonical_target
            - servicenow_fake_mode_forbidden_on_live
            - servicenow_instance_identity_unavailable
            - support_session_end_denied
            - support_session_not_active
            - support_session_not_found
            - support_session_scope_mismatch
            - self_service_clear_forbidden
            - team_already_active
            - team_already_deleted
            - team_application_binding_not_found
            - team_delete_blocked
            - team_delete_confirmation_required
            - team_id_required
            - team_inactive
            - team_membership_already_exists
            - team_membership_required
            - team_permission_required
            - team_required
            - team_scope_mismatch
            - turn_busy
            - team_membership_not_found
            - team_not_found
            - team_policy_not_found
            - team_scope_required
            - team_settings_permission_denied
            - team_last_manager_required
            - team_slug_conflict
            - team_slug_taken_on_restore
            - team_stable_prefix_conflict
            - temporary_privilege_overlay_conflict
            - terms_agreement_mismatch
            - ticket_not_found
            - ticket_attachment_not_found
            - ticket_on_behalf_of_permission_denied
            - ticket_action_approval_conflict
            - ticket_action_approval_pending
            - ticket_action_not_supported
            - ticket_action_target_not_pending
            - ticket_assignment_locked
            - ticket_reply_target_not_found
            - ticket_reply_target_thread_mismatch
            - ticket_reply_target_unavailable
            - ticket_resolution_blocked_by_pending_approval
            - ticket_resolve_sync_field_conflict
            - ticket_resolver_required
            - ticket_delete_manager_required
            - ticket_updater_required
            - ticket_source_channel_not_editable
            - empty_update_payload
            - generic_ticket_not_open
            - too_many_attachments
            - unknown_asset_field
            - unknown_capability
            - unknown_rule_code
            - unsupported_api_key_hash
            - unsupported_record_table
            - unsupported_admin_handoff_kind
            - unsupported_admin_handoff_source
            - unsupported_blast_radius_change_kind
            - unsupported_entitlement_provider
            - unsupported_parent_scope
            - unsupported_search_depth
            - unsupported_search_family
            - unsupported_slack_action
            - unsupported_view
            - updated_approval_request_not_found
            - updated_workflow_run_not_found
            - upload_bytes_missing
            - upload_session_expired
            - upload_session_not_found
            - unknown_search_provider
            - upload_session_not_open
            - upload_session_not_uploaded
            - upload_size_exceeded
            - upload_size_limit_exceeded
            - user_directory_access_denied
            - workflow_delegation_denied
            - workflow_definition_not_found
            - workflow_definition_run_not_ready
            - workflow_execution_principal_invalid
            - workflow_integration_connection_ambiguous
            - workflow_integration_not_installed
            - workflow_integration_selected_connection_automation_not_enabled
            - workflow_integration_selected_connection_inactive
            - workflow_integration_selected_connection_missing_scopes
            - workflow_integration_selected_connection_not_found
            - workflow_integration_selected_connection_unhealthy
            - workflow_integration_selected_connection_configuration_mismatch
            - workflow_integration_selected_connection_wrong_application
            - workflow_integration_selected_connection_wrong_team
            - workflow_revision_not_found
            - workflow_not_published
            - workflow_metadata_invalid
            - workflow_origin_not_supported
            - workflow_publish_requires_head_revision
            - workflow_run_already_completed
            - workflow_run_kind_not_supported
            - workflow_run_already_terminal
            - workflow_run_cancel_not_requested
            - workflow_run_forbidden
            - workflow_write_role_required
            - workflow_run_not_found
            - workflow_run_not_running
            - workflow_run_not_waiting_for_approval
            - workflow_run_dispatch_context_unavailable
            - workflow_run_start_input_unavailable
            - workflow_input_invalid
            - workflow_input_too_large
            - workflow_activity_output_too_large
            - workflow_output_too_large
            - validate_source_contract_invalid
            - build_compile_failed
            - build_dependency_missing
            - build_test_adapter_missing
            - publish_version_conflict
            - publish_artifact_registration_failed
            - install_missing_application_binding
            - install_auth_binding_invalid
            - install_capability_disabled
            - run_waiting_for_input
            - run_step_failed
            - run_canceled
            - run_blocked_side_effect_rejected
            - approval_pending
            - approval_denied
            - approval_configuration_invalid
            - integration_configuration_invalid
            - integration_provider_unavailable
            - integration_reauth_required
            - integration_scope_mismatch
            - integration_provider_permission_denied
            - integration_provider_rejected
            - platform_rate_limited
            - platform_timeout
            - platform_internal_error
            - workflow_runtime_unavailable
            - workflow_runtime_start_rejected
            - workflow_activity_timeout
            - workflow_execution_timeout
            - workflow_activity_retryable_failure
            - workflow_activity_non_retryable_failure
            - workflow_application_error
            - workflow_unhandled_error
            - workflow_action_configuration_invalid
            - workflow_action_capability_disabled
            - workflow_action_forbidden
            - workflow_action_policy_denied
            - workflow_action_resource_not_found
            - workflow_action_unavailable
            - workflow_action_result_contract_invalid
            - workflow_action_result_contract_upgrade_required
            - workflow_action_spec_upgrade_required
            - workflow_authoring_context_unavailable
            - workflow_revision_test_side_effect_blocked
            - workflow_state_conflict
            - workflow_run_operator_canceled
            - workflow_run_system_canceled
            - system_automation_disabled
            - system_automation_not_found
            - callback_endpoint_not_granted
            - automation_grant_cancel_required
            - automation_grant_decide_required
            - decision_target_must_be_user
            - wait_concurrency_exceeded
            - workflow_side_effects_policy_not_supported
            - workflow_source_files_invalid
            - workflow_team_scope_missing
            - invalid_workspace_member_payload
            - workspace_member_last_admin
            - workspace_member_managed_by_idp
            - workspace_member_org_role_managed_by_group
            - workspace_member_not_found
            - workspace_member_self_update_forbidden
            - workspace_member_source_unsupported
            - workspace_member_team_not_found
            - workspace_member_update_conflict
            - workos_auth_not_configured
            - workos_auth_unavailable
            - auth_service_unavailable
            - invalid_workos_admin_portal_payload
            - workos_admin_portal_forbidden
            - workos_admin_portal_not_configured
            - workos_admin_portal_org_not_linked
            - workos_admin_portal_unavailable
            - workos_organization_link_owned_by_other_org
            - workos_organization_link_persist_failed
            - workos_organization_link_domain_unverified
            - workos_organization_link_generic_domain_forbidden
            - workos_directory_groups_resume_invalidated
            - workos_directory_user_reconcile_forbidden
            - workos_directory_user_reconcile_in_progress
            - workos_directory_user_reconcile_org_not_linked
            - workos_directory_user_import_policy_directory_not_found
            - workos_directory_user_import_policy_forbidden
            - workos_directory_user_import_policy_invalid
            - workos_directory_user_import_policy_persist_failed
            - workos_directory_user_sync_forbidden
            - workos_directory_user_sync_group_evidence_required
            - workos_directory_user_sync_live_lookup_timeout
            - workos_directory_user_sync_not_configured
            - workos_directory_user_sync_payload_invalid
            - workos_directory_user_sync_run_not_found
            - workos_enterprise_setup_refresh_in_progress
            - workos_enterprise_setup_refresh_unavailable
            - workos_webhook_invalid_event
            - workos_webhook_invalid_signature
            - workos_webhook_not_configured
            - workos_event_replay_payload_mismatch
            - workos_webhook_stale_timestamp
            - workos_webhook_unsupported_event
            - workos_organization_invite_only
            - workos_principal_identity_ambiguous
            - workos_principal_identity_not_found
            - workos_selected_organization_not_linked
            - wrong_audience
            - email_approval_recipient_not_found
            - email_approval_reason_too_long
            - email_approval_signing_not_configured
            - email_approval_token_expired
            - email_approval_token_stale
            - invalid_email_approval_token
            - source_too_large
            - missing_content_length
            - invalid_content_length
            - request_body_too_large
            - request_submission_unavailable
            - workflow_source_has_blocking_diagnostics
            - workflow_publication_connections_not_ready
            - workflow_publication_audience_incompatible
            - workflow_ownership_connections_not_ready
            - workflow_publication_requirements_not_ready
            - workflow_input_schema_invalid
            - workflow_revision_already_published
            - workflow_approval_procedure_not_ready
            - workflow_revision_source_invalid
            - workflow_revision_stale_head
            - workflow_execute_as_not_allowed
            - workflow_execute_as_principal_invalid
            - workflow_execute_as_team_coverage_missing
            - workflow_publication_state_conflict
            - workflow_publication_not_runnable
            - workflow_publication_trigger_bindings_invalid
            - workflow_publication_already_unpublished
            - workflow_publication_not_found
            - workflow_dependency_confirmation_required
            - workflow_publication_rollback_not_ready
            - workflow_bundle_failed
            - invalid_source_files
            - invalid_display_name
            - invalid_slug
            - workflow_definition_slug_conflict
            - workflow_export_name_not_found
            - workflow_action_policy_decision_invalid
            - workflow_action_policy_stable_action_id_invalid
            - workflow_connector_action_access_blocked_by_publications
            - outbound_mcp_action_access_stale
            - outbound_mcp_authentication_invalid
            - outbound_mcp_catalog_invalid
            - outbound_mcp_catalog_limit_exceeded
            - outbound_mcp_connection_mismatch
            - outbound_mcp_connection_not_found
            - outbound_mcp_connection_reset_failed
            - outbound_mcp_connection_stale
            - outbound_mcp_connector_immutable
            - outbound_mcp_connector_invalid
            - outbound_mcp_connector_key_conflict
            - outbound_mcp_connector_key_invalid
            - outbound_mcp_connector_not_found
            - outbound_mcp_discovery_authorization_rejected
            - outbound_mcp_discovery_failed
            - outbound_mcp_discovery_stale
            - outbound_mcp_endpoint_invalid
            - outbound_mcp_provisioning_failed
            - outbound_mcp_provisioning_conflict
            - outbound_mcp_refresh_blocked_by_publications
            - outbound_mcp_scope_mismatch
            - outbound_mcp_scopes_invalid
            - outbound_mcp_settings_blocked_by_publications
            - outbound_mcp_settings_multiple_connections
            - outbound_mcp_settings_stale
            - outbound_mcp_settings_unchanged
            - outbound_mcp_tool_catalog_empty
            - outbound_mcp_tool_catalog_invalid
            - outbound_mcp_tool_selection_invalid
            - workflow_connector_action_blocked
            - workflow_connector_selection_invalid
            - workflow_connector_connection_id_invalid
            - workflow_connector_field_invalid
            - workflow_connector_setup_unavailable
            - workflow_connector_target_forbidden
            - access_lifecycle_retry_access_request_missing
            - access_lifecycle_retry_target_grant_missing
            - access_system_workflow_not_registered
            - access_system_workflow_simulated_mode_retired
            - access_workflow_approval_not_supported
            - access_workflow_compound_plan_not_supported
            - access_workflow_connection_binding_changed
            - access_workflow_connection_binding_missing
            - access_workflow_contract_mismatch
            - access_workflow_operation_not_supported
            - access_workflow_publication_not_ready
            - access_workflow_publication_scope_mismatch
            - access_workflow_source_invalid
            - access_workflow_subject_identity_ambiguous
            - access_workflow_target_grant_missing
            - approval_bound_ticket_mismatch
            - browser_surface_required
            - catalog_idempotency_replay_corrupt
            - channel_artifact_transition_invalid
            - confluence_cloud_id_missing
            - confluence_discovery_failed
            - credential_surface_not_allowed
            - drive_discovery_failed
            - event_not_found
            - integration_availability_override_not_found
            - integration_credential_not_found
            - integration_sync_run_not_found
            - integrations_v2_application_not_found
            - integrations_v2_automation_all_teams_share_required
            - integrations_v2_automation_disable_blocked_by_publications
            - integrations_v2_automation_not_supported
            - integrations_v2_automation_share_capability_not_allowed
            - integrations_v2_connect_unsupported
            - integrations_v2_connect_session_invalid
            - integrations_v2_connect_config_mismatch
            - integrations_v2_connect_fanout_failed
            - integrations_v2_connection_not_found
            - integrations_v2_asset_source_unsupported
            - integrations_v2_asset_requires_org_wide_connection
            - integrations_v2_connection_unhealthy
            - integrations_v2_asset_source_conflict
            - invalid_cursor
            - invalid_email_continuation_reference
            - invalid_navigation_token
            - invalid_slash_command
            - knowledge_source_binding_not_found
            - missing_auth_header
            - model_context_capacity
            - model_provider_unavailable
            - nango_confluence_discovery_unavailable
            - nango_connect_session_generation_missing
            - nango_connect_session_generation_stale
            - nango_connection_required
            - nango_drive_sync_unavailable
            - nango_drive_discovery_unavailable
            - nango_servicenow_proxy_unavailable
            - notification_not_found
            - principal_delivery_email_ambiguous
            - servicenow_integration_binding_not_found
            - slack_egress_context_required
            - slack_egress_outcome_persistence_failed
            - slack_egress_rate_limited
            - slack_operator_actor_mapping_ambiguous
            - slack_operator_actor_mapping_conflict
            - slack_operator_binding_mismatch
            - slack_operator_email_confirmation_required
            - slack_operator_email_lookup_unavailable
            - slack_operator_email_mismatch
            - slack_operator_principal_identity_workspace_conflict
            - slack_operator_user_identity_mismatch
            - stale_ticket_revision
            - step_up_unavailable
            - tenant_domain_already_associated
            - tenant_onboarding_conflict
            - ticket_access_denied
            - ticket_sync_link_already_linked_elsewhere
            - ticket_sync_setup_draft_invalid
            - ticket_sync_source_required
            - webhook_delivery_not_found
            - workflow_action_policy_not_found
            - workflow_example_input_too_large
            - workflow_id_required
            - workflow_input_request_not_found
            - workflow_input_responder_not_allowed
            - workflow_latest_revision_missing
            - workflow_ownership_changed
            - workflow_publication_not_startable
            - workflow_publication_org_scope_invalid
            - workflow_publication_surface_not_allowed
            - workflow_publication_team_scope_required
            - workflow_review_force_forbidden
            - workflow_review_force_reason_invalid
            - workflow_review_not_ready
            - validation_scenario_contract_unavailable
            - invalid_validation_scenarios
            - workflow_validation_scenario_capacity_exceeded
            - workflow_validation_scenario_definition_changed
            - workflow_validation_scenario_force_required
            - workflow_validation_scenario_not_found
            - workflow_validation_scenario_run_binding_invalid
            - workflow_validation_scenario_run_changed
            - workflow_validation_scenario_run_not_started
            - workflow_validation_scenario_runs_active
            - workflow_validation_scenario_system_error
            - workflow_source_shape_unsupported
            - agent_session_scope_mismatch
            - approval_break_glass_reason_required
            - assignee_not_available
            - attachment_download_failed
            - attachment_download_temporarily_unavailable
            - atlassian_admin_required_access_missing
            - conflict
            - confluence_connect_session_prerequisite_missing
            - confluence_connect_session_target_mismatch
            - confluence_knowledge_pending_shell_conflict
            - confluence_knowledge_pending_shell_invalid
            - confluence_knowledge_pending_shell_not_found
            - confluence_knowledge_pending_shell_stale
            - connection_binding_share_capability_exceeded
            - connection_reconnect_identity_mismatch
            - connection_reconnect_target_unavailable
            - http_integration_connection_configuration_missing
            - http_integration_connector_name_conflict
            - forbidden
            - google_directory_knowledge_identity_required
            - google_drive_knowledge_reconnect_target_unavailable
            - idempotency_key_required
            - identity_read_policy_owner_required
            - invalid_after_reference
            - invalid_notion_selection
            - invalid_request
            - invalid_teams_tenant_binding
            - managed_connector_immutable
            - notion_workspace_identity_required
            - requested_for_not_found
            - slack_channel_binding_setup_unavailable
            - slack_installed_connection_changed
            - slack_response_budget_deferred
            - slack_workspace_required
            - team_manager_required
            - team_scope_not_authorized
            - teams_tenant_binding_conflict
            - workflow_action_policy_blocked
            - workflow_composition_ticket_conflict
            - workflow_connection_action_policy_not_found
            - workflow_connection_binding_account_mismatch
            - workflow_connector_action_selection_invalid
            - workflow_connector_alias_invalid
            - workflow_connector_connection_name_invalid
            - workflow_connector_delegation_unavailable
            - workflow_connector_required_scopes_missing
            - workflow_connector_setup_stale
            - workflow_draft_conflict
            - workflow_prompt_artifact_invalid
            - workflow_revision_changed
            - workflow_revision_creation_locked
            - workflow_revision_lock_changed
            - workflow_revision_test_request_conflict
            - ad_hoc_review_stale
            - ad_hoc_connection_unavailable
            - builder_session_unavailable
            - invalid_one_off_source
            - one_off_action_count_invalid
            - one_off_action_unsupported
            - one_off_approval_mismatch
            - one_off_approval_required
            - one_off_execution_identity_conflict
            - one_off_input_not_empty
            - one_off_step_count_invalid
            - one_off_trigger_unsupported
            - workflow_execution_only
        detail:
          type: string
        instance:
          type: string
        request_id:
          type: string
        correlation_id:
          type: string
        retryable:
          type: boolean
        auth_failure_reason:
          type: string
        availability_reason:
          type: string
          enum:
            - capability_disabled
            - misconfigured
        re_auth_required:
          type: boolean
        violations:
          type: array
          items:
            type: object
            properties:
              field:
                type: string
              message:
                type: string
              capability:
                type: string
              details:
                type: object
                additionalProperties: true
            required:
              - field
              - message
            additionalProperties: false
        diagnostics:
          type: array
          items:
            $ref: '#/components/schemas/WorkflowSourceDiagnostic'
      required:
        - type
        - title
        - status
        - code
        - detail
        - instance
        - request_id
        - correlation_id
      additionalProperties: false
    TicketRuntimeDetailResource:
      type: object
      description: >-
        Key-addressed ticket detail returned by runtime mutation and
        slash-command routes. It retains the runtime workflow observation status
        vocabulary rather than the customer read-model enum.
      properties:
        resource:
          type: string
          enum:
            - ticket
        org_id:
          type: string
        team_id:
          type: string
        key:
          type: string
        type:
          type: string
        title:
          type: string
        description:
          type:
            - string
            - 'null'
        status:
          type: string
        priority_kind:
          type: string
        pending_prompt_summary:
          type:
            - object
            - 'null'
          additionalProperties: true
        source_channel_kind:
          type: string
        requester:
          $ref: '#/components/schemas/ActorObservation'
        opened_by:
          $ref: '#/components/schemas/ActorObservation'
        assignee:
          oneOf:
            - $ref: '#/components/schemas/ActorObservation'
            - type: 'null'
        assignment_team_id:
          type:
            - string
            - 'null'
        ownership:
          $ref: '#/components/schemas/TicketOwnershipObservation'
        requester_automation:
          $ref: '#/components/schemas/RequesterAutomationObservation'
        linked:
          type: object
          properties:
            access_request:
              type:
                - object
                - 'null'
              additionalProperties: true
            approval_request:
              type:
                - object
                - 'null'
              additionalProperties: true
            workflow_run:
              oneOf:
                - type: object
                  properties:
                    id:
                      type: string
                    status:
                      type: string
                    wait_reason_kind:
                      type:
                        - string
                        - 'null'
                    details_access:
                      type: string
                      enum:
                        - allowed
                        - denied
                      description: >-
                        Current caller's access to linked run details. A denied
                        run still exists.
                    error_summary:
                      type:
                        - object
                        - 'null'
                      additionalProperties: true
                    workflow_id:
                      type: string
                    workflow_publication_id:
                      type:
                        - string
                        - 'null'
                    workflow_revision_id:
                      type:
                        - string
                        - 'null'
                    workflow_revision_build_id:
                      type:
                        - string
                        - 'null'
                    request_id:
                      type:
                        - string
                        - 'null'
                    correlation_id:
                      type:
                        - string
                        - 'null'
                  required:
                    - id
                    - status
                    - wait_reason_kind
                    - error_summary
                    - workflow_id
                    - workflow_publication_id
                    - workflow_revision_id
                    - workflow_revision_build_id
                    - request_id
                    - correlation_id
                  additionalProperties: true
                - type: 'null'
          required:
            - access_request
            - approval_request
            - workflow_run
          additionalProperties: true
        created_at:
          type: string
        updated_at:
          type: string
        resolved_at:
          type:
            - string
            - 'null'
        closed_at:
          type:
            - string
            - 'null'
        canceled_at:
          type:
            - string
            - 'null'
          description: >-
            Instant the ticket entered canceled status; cleared when it leaves
            canceled. Stops the derived duration clock the same way resolved_at
            and closed_at do.
        duration_ms:
          type: number
          description: >-
            Elapsed milliseconds the ticket has been open: the resolution clock
            from created_at to duration_ended_at, or to read time while the
            ticket is still being worked. Reporting uses it for mean time to
            resolution.
        duration_ended_at:
          type:
            - string
            - 'null'
          description: >-
            Terminal instant that stopped duration_ms (resolution, close, or
            cancellation). Null while the clock runs; reopening a resolved
            ticket clears it and the clock continues from created_at.
        externally_synced:
          type: boolean
        channel_thread_captured:
          type: boolean
        sync_provider_system_kind:
          description: >-
            Oldest active ticket sync link provider when included by the
            selected ticket projection.
          oneOf:
            - type: string
              enum:
                - jira_service_management
                - servicenow
            - type: 'null'
        links:
          $ref: '#/components/schemas/Phase0Links'
        intake_payload:
          type: object
          additionalProperties: true
        inline_edit:
          type: object
          properties:
            can_resolve:
              type: boolean
            resolve_blocked_reason:
              type:
                - string
                - 'null'
              enum:
                - pending_approval
                - ticket_sync_link
                - null
            can_reopen:
              type: boolean
            can_assign:
              type: boolean
            can_change_status:
              type: boolean
            status_edit_blocked_reason:
              type:
                - string
                - 'null'
              enum:
                - ticket_sync_link
                - null
            can_change_type:
              type: boolean
            can_change_priority:
              type: boolean
            priority_edit_blocked_reason:
              type:
                - string
                - 'null'
              enum:
                - ticket_sync_link
                - null
            priority_options:
              type: array
              items:
                type: string
                enum:
                  - low
                  - normal
                  - high
                  - urgent
            can_edit_description:
              type: boolean
            source_channel_options:
              type: array
              items:
                type: object
                properties:
                  value:
                    type: string
                    enum:
                      - browser
                      - slack
                      - email
                      - api
                      - cli
                      - mcp
                  label:
                    type: string
                required:
                  - value
                  - label
                additionalProperties: false
          required:
            - can_resolve
            - resolve_blocked_reason
            - can_reopen
            - can_assign
            - can_change_status
            - status_edit_blocked_reason
            - can_change_type
            - can_change_priority
            - priority_edit_blocked_reason
            - priority_options
            - can_edit_description
            - source_channel_options
          additionalProperties: false
        messages:
          type: array
          items:
            $ref: '#/components/schemas/TicketMessageResource'
        reply_targets:
          type: array
          items:
            $ref: '#/components/schemas/TicketReplyTargetResource'
        attachments:
          type: array
          items:
            $ref: '#/components/schemas/TicketAttachmentResource'
        activities:
          type: array
          items:
            $ref: '#/components/schemas/TicketActivityResource'
        ticket_sync_links:
          type: array
          items:
            $ref: '#/components/schemas/TicketSyncLinkObservationResource'
      required:
        - resource
        - org_id
        - team_id
        - key
        - type
        - title
        - description
        - status
        - priority_kind
        - pending_prompt_summary
        - source_channel_kind
        - requester
        - opened_by
        - assignee
        - assignment_team_id
        - ownership
        - linked
        - created_at
        - updated_at
        - resolved_at
        - closed_at
        - canceled_at
        - duration_ms
        - duration_ended_at
        - externally_synced
        - channel_thread_captured
        - links
        - intake_payload
        - inline_edit
        - messages
        - reply_targets
        - attachments
        - activities
        - ticket_sync_links
      additionalProperties: false
    Phase0Meta:
      type: object
      properties:
        request_id:
          type: string
        correlation_id:
          type: string
        operation:
          type: string
        resource:
          type: string
      required:
        - request_id
        - correlation_id
        - operation
        - resource
      additionalProperties: true
    WorkflowSourceDiagnostic:
      type: object
      properties:
        code:
          type: string
        severity:
          type: string
          enum:
            - info
            - warning
            - error
        message:
          type: string
        fixHint:
          type: string
        location:
          type: object
          properties:
            file:
              type: string
            line:
              type: integer
              minimum: 1
            column:
              type: integer
              minimum: 1
            stepId:
              type: string
          required:
            - file
            - line
            - column
          additionalProperties: false
      required:
        - code
        - severity
        - message
        - fixHint
        - location
      additionalProperties: false
    ActorObservation:
      type: object
      properties:
        id:
          type: string
        actor_type:
          type: string
        principal_id:
          type:
            - string
            - 'null'
        internal_key:
          type:
            - string
            - 'null'
          description: >-
            Stable key for an organization-owned internal actor, 'flow' for the
            canonical Flow actor and null otherwise. Identify Flow by this key
            rather than by actor_type, a missing principal_id, or display_name.
        display_name:
          type:
            - string
            - 'null'
        email:
          type:
            - string
            - 'null'
        avatar_url:
          type:
            - string
            - 'null'
      required:
        - id
        - actor_type
        - principal_id
        - internal_key
        - display_name
        - email
        - avatar_url
      additionalProperties: false
    TicketOwnershipObservation:
      type: object
      properties:
        assignee:
          oneOf:
            - type: object
              properties:
                kind:
                  type: string
                  enum:
                    - flow
                    - human
                display_name:
                  type:
                    - string
                    - 'null'
                avatar_url:
                  type:
                    - string
                    - 'null'
              required:
                - kind
                - display_name
                - avatar_url
              additionalProperties: false
            - type: 'null'
        assignment_team:
          oneOf:
            - type: object
              properties:
                display_name:
                  type: string
              required:
                - display_name
              additionalProperties: false
            - type: 'null'
      required:
        - assignee
        - assignment_team
      additionalProperties: false
    RequesterAutomationObservation:
      type: object
      additionalProperties: false
      properties:
        fulfillment:
          type: string
          enum:
            - unconfirmed
        label:
          type: string
        reason:
          type: string
        acceptedAt:
          type: string
          format: date-time
        nextAction:
          type: object
          additionalProperties: false
          properties:
            actor:
              type: string
              enum:
                - none
                - requester
                - approver
                - service_desk
            requiredByViewer:
              type: boolean
            message:
              type: string
          required:
            - actor
            - requiredByViewer
            - message
      required:
        - fulfillment
        - label
        - reason
        - nextAction
        - acceptedAt
    Phase0Links:
      type: object
      additionalProperties:
        type:
          - string
          - 'null'
    TicketMessageResource:
      type: object
      properties:
        id:
          type: string
        author:
          oneOf:
            - $ref: '#/components/schemas/ActorObservation'
            - type: 'null'
        direction:
          type: string
        message_kind:
          type: string
        visibility:
          type: string
        body_text:
          type:
            - string
            - 'null'
        delivery_state:
          type:
            - string
            - 'null'
          enum:
            - pending
            - sent
            - failed
            - null
        delivery_channel_kind:
          type:
            - string
            - 'null'
          enum:
            - slack
            - teams
            - email
            - null
        delivery_target_kind:
          type:
            - string
            - 'null'
          enum:
            - slack_thread
            - slack_dm
            - teams_thread
            - teams_personal
            - email
            - null
        external_message_ref:
          type:
            - string
            - 'null'
        attachment_rejection_notice:
          oneOf:
            - type: object
              properties:
                body_text:
                  type: string
                created_at:
                  type: string
                  format: date-time
              required:
                - body_text
                - created_at
              additionalProperties: false
            - type: 'null'
        metadata:
          type: object
          additionalProperties: true
        created_at:
          type: string
      required:
        - id
        - author
        - direction
        - message_kind
        - visibility
        - body_text
        - delivery_state
        - delivery_channel_kind
        - delivery_target_kind
        - external_message_ref
        - attachment_rejection_notice
        - metadata
        - created_at
      additionalProperties: false
    TicketReplyTargetResource:
      type: object
      properties:
        id:
          type: string
        channel_kind:
          type: string
          enum:
            - slack
            - teams
            - email
        target_kind:
          type: string
          enum:
            - slack_thread
            - slack_dm
            - teams_thread
            - teams_personal
            - email
        label:
          type: string
        available:
          type: boolean
        unavailable_reason_code:
          type:
            - string
            - 'null'
        ticket_channel_thread_id:
          type:
            - string
            - 'null'
        provider_target:
          type: object
          additionalProperties: true
        recommended:
          type: boolean
      required:
        - id
        - channel_kind
        - target_kind
        - label
        - available
        - unavailable_reason_code
        - ticket_channel_thread_id
        - provider_target
        - recommended
      additionalProperties: false
    TicketAttachmentResource:
      type: object
      properties:
        id:
          type: string
        blob_ref_id:
          type: string
        ticket_message_id:
          type:
            - string
            - 'null'
        filename:
          type:
            - string
            - 'null'
        mime_type:
          type:
            - string
            - 'null'
        size_bytes:
          type:
            - number
            - 'null'
        sha256_hex:
          type:
            - string
            - 'null'
        scan_verdict:
          type: string
        state:
          type: string
        conversation_placement:
          type: string
          enum:
            - message
            - requester_thread
            - ticket
          description: >-
            Where the file sits in the ticket conversation. `message` is shown
            with the message named by `ticket_message_id`, which this response
            also returns. `requester_thread` was shared with the requester
            outside any single message. `ticket` sits outside the requester
            conversation, which covers a team-only file and a readable file
            whose message the caller cannot read. A `requester_thread` file also
            belongs to any ticket-level list.
        attached_by:
          oneOf:
            - $ref: '#/components/schemas/ActorObservation'
            - type: 'null'
          description: >-
            Actor that attached the file, or null when the actor no longer
            resolves. A requester-scoped response reduces this to a display name
            and avatar.
        created_at:
          type: string
      required:
        - id
        - blob_ref_id
        - ticket_message_id
        - filename
        - mime_type
        - size_bytes
        - sha256_hex
        - scan_verdict
        - state
        - conversation_placement
        - attached_by
        - created_at
      additionalProperties: false
    TicketActivityResource:
      type: object
      properties:
        id:
          type: string
        actor:
          oneOf:
            - $ref: '#/components/schemas/ActorObservation'
            - type: 'null'
        event_type:
          type: string
        summary:
          type: string
        payload:
          type: object
          additionalProperties: true
        causation_kind:
          type:
            - string
            - 'null'
        causation_id:
          type:
            - string
            - 'null'
        created_at:
          type: string
        message:
          oneOf:
            - type: object
              properties:
                id:
                  type: string
                body_text:
                  type:
                    - string
                    - 'null'
                visibility:
                  type: string
                message_kind:
                  type: string
              required:
                - id
                - body_text
                - visibility
                - message_kind
              additionalProperties: false
            - type: 'null'
      required:
        - id
        - actor
        - event_type
        - summary
        - payload
        - causation_kind
        - causation_id
        - created_at
        - message
      additionalProperties: false
    TicketSyncLinkObservationResource:
      type: object
      properties:
        local_status_alignment_allowed:
          type: boolean
        id:
          type: string
        resource:
          type: string
          enum:
            - ticket_sync_link
        org_id:
          type: string
        team_id:
          type: string
        ticket_key:
          type: string
        team_application_binding_id:
          type: string
        connected_account_id:
          type: string
        system_kind:
          type: string
          enum:
            - jira_service_management
            - servicenow
        external_object_type:
          type: string
        external_id:
          type:
            - string
            - 'null'
        external_key:
          type:
            - string
            - 'null'
        external_url:
          type:
            - string
            - 'null'
        sync_direction:
          type: string
          enum:
            - inbound
            - outbound
            - bidirectional
        ownership_mode:
          type: string
          enum:
            - encore_master
            - external_master
        conflict_policy:
          type: string
          enum:
            - owner_wins
            - manual_review
        operating_mode:
          type: string
          enum:
            - migration_seed
            - steady_state
        field_mapping_version:
          type: string
        sync_state:
          type: string
          enum:
            - pending
            - synced
            - conflict
            - error
            - stale_ignored
        remote_revision:
          type: number
        local_source_version:
          type: number
        last_successful_sync_direction:
          type:
            - string
            - 'null'
          enum:
            - inbound
            - outbound
            - null
        last_synced_at:
          type:
            - string
            - 'null'
        health:
          type: object
          properties:
            sync_state:
              type: string
              enum:
                - pending
                - synced
                - conflict
                - error
                - stale_ignored
            last_error_summary:
              type:
                - object
                - 'null'
              additionalProperties: true
            conflict_summary:
              type:
                - object
                - 'null'
              additionalProperties: true
          required:
            - sync_state
            - last_error_summary
            - conflict_summary
          additionalProperties: false
        metadata:
          type: object
          additionalProperties: true
        unpushed_flow_fields:
          type: array
          items:
            type: string
            enum:
              - status_kind
              - title
              - description
        provider_context:
          oneOf:
            - type: object
              properties:
                provider:
                  type: string
                primary_record:
                  type: object
                  properties:
                    system_kind:
                      type: string
                    external_object_type:
                      type: string
                    external_id:
                      type:
                        - string
                        - 'null'
                    external_key:
                      type:
                        - string
                        - 'null'
                    external_url:
                      type:
                        - string
                        - 'null'
                  required:
                    - system_kind
                    - external_object_type
                    - external_id
                    - external_key
                    - external_url
                  additionalProperties: false
              required:
                - provider
                - primary_record
              additionalProperties: true
            - type: 'null'
        created_at:
          type: string
        updated_at:
          type: string
      required:
        - id
        - resource
        - org_id
        - team_id
        - ticket_key
        - team_application_binding_id
        - connected_account_id
        - system_kind
        - external_object_type
        - external_id
        - external_key
        - external_url
        - sync_direction
        - ownership_mode
        - conflict_policy
        - operating_mode
        - field_mapping_version
        - sync_state
        - remote_revision
        - local_source_version
        - last_successful_sync_direction
        - last_synced_at
        - health
        - metadata
        - provider_context
        - unpushed_flow_fields
        - created_at
        - updated_at
      additionalProperties: false
  headers:
    RequestIdHeader:
      description: Server-generated request identifier for this HTTP attempt.
      schema:
        type: string
    CorrelationIdHeader:
      description: >-
        Effective correlation identifier for the request, either accepted from
        X-Correlation-Id or generated by the server.
      schema:
        type: string
    RateLimitLimitHeader:
      description: Maximum requests allowed in the active pre-release fixed window.
      schema:
        type: integer
        minimum: 1
    RateLimitRemainingHeader:
      description: >-
        Requests remaining for the effective caller and route bucket in this
        window.
      schema:
        type: integer
        minimum: 0
    RateLimitResetHeader:
      description: Seconds until the effective fixed-window quota resets.
      schema:
        type: integer
        minimum: 1
    RetryAfterHeader:
      description: Seconds the caller should wait before retrying after a 429 response.
      schema:
        type: integer
        minimum: 1
    ReauthHeader:
      description: >-
        Login route for browser clients to use when the problem document has
        re_auth_required=true. The value points to the control-plane login
        endpoint and preserves the original return_to target.
      schema:
        type: string
        format: uri-reference
  securitySchemes:
    bearerAuth:
      type: http
      scheme: bearer
      bearerFormat: JWT or Flow API key
      description: >-
        OAuth Bearer access tokens or Flow API keys with the required Flow scope
        families for the route.

````

This documentation is built and hosted on [Mintlify](https://mintlify.com), a developer documentation platform.