> ## 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.

# Save and activate or disable basic instructions

> Available regardless of AI Behavior rollout. Requires builder.write, excludes requesters and requires exact owner authoring authority; team writes also require enabled guidance capability. Save creates an immutable basic revision, publishes that exact revision and enables it atomically. Existing titles and fixed ownership are retained; a new document is titled Instructions. Creation requires null instructionDefinitionId and preconditions and returns 409 instruction_write_conflict if compatible instructions already exist for that owner, including a disabled basic publication above an advanced draft. Existing writes require all current metadata, revision and publication freshness tokens. Disable retains text, publication and history while preventing application. A basic publication above an advanced draft can be disabled and returns the published revision selected as historic. Save, reactivation and replacement remain blocked for that document, even after disabling, to preserve the advanced draft. Advanced publications and archived records cannot be changed here. Incompatible and stale records return 409 instruction_write_conflict; unauthorized or owner-mismatched IDs return 404 instruction_not_found. No legacy storage is written.



## OpenAPI

````yaml /openapi/control-plane.json post /v1/instructions/basic-settings
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: Catalog
  - name: Events
  - name: Knowledge
  - name: Instructions
  - name: Tickets
  - name: Access Requests
paths:
  /v1/instructions/basic-settings:
    post:
      tags:
        - Instructions
      summary: Save and activate or disable basic instructions
      description: >-
        Available regardless of AI Behavior rollout. Requires builder.write,
        excludes requesters and requires exact owner authoring authority; team
        writes also require enabled guidance capability. Save creates an
        immutable basic revision, publishes that exact revision and enables it
        atomically. Existing titles and fixed ownership are retained; a new
        document is titled Instructions. Creation requires null
        instructionDefinitionId and preconditions and returns 409
        instruction_write_conflict if compatible instructions already exist for
        that owner, including a disabled basic publication above an advanced
        draft. Existing writes require all current metadata, revision and
        publication freshness tokens. Disable retains text, publication and
        history while preventing application. A basic publication above an
        advanced draft can be disabled and returns the published revision
        selected as historic. Save, reactivation and replacement remain blocked
        for that document, even after disabling, to preserve the advanced draft.
        Advanced publications and archived records cannot be changed here.
        Incompatible and stale records return 409 instruction_write_conflict;
        unauthorized or owner-mismatched IDs return 404 instruction_not_found.
        No legacy storage is written.
      operationId: write_basic_instruction_settings
      parameters: []
      requestBody:
        required: true
        content:
          application/json:
            schema:
              $ref: '#/components/schemas/BasicInstructionSettingsWriteRequest'
      responses:
        '200':
          description: Save and activate or disable basic instructions
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/InstructionDocumentResponse'
        default:
          $ref: '#/components/responses/ProblemResponse'
      security:
        - bearerAuth:
            - builder.write
components:
  schemas:
    BasicInstructionSettingsWriteRequest:
      oneOf:
        - type: object
          properties:
            action:
              type: string
              const: save
            owningTeamId:
              type:
                - string
                - 'null'
              format: uuid
            instructionDefinitionId:
              type: 'null'
            preconditions:
              type: 'null'
            content:
              type: string
              minLength: 1
              maxLength: 7968
          required:
            - action
            - owningTeamId
            - instructionDefinitionId
            - preconditions
            - content
          additionalProperties: false
        - type: object
          properties:
            action:
              type: string
              const: save
            owningTeamId:
              type:
                - string
                - 'null'
              format: uuid
            instructionDefinitionId:
              type: string
              format: uuid
            preconditions:
              $ref: '#/components/schemas/InstructionWritePreconditions'
            content:
              type: string
              minLength: 1
              maxLength: 7968
          required:
            - action
            - owningTeamId
            - instructionDefinitionId
            - preconditions
            - content
          additionalProperties: false
        - type: object
          properties:
            action:
              type: string
              const: disable
            owningTeamId:
              type:
                - string
                - 'null'
              format: uuid
            instructionDefinitionId:
              type: string
              format: uuid
            preconditions:
              $ref: '#/components/schemas/InstructionWritePreconditions'
          required:
            - action
            - owningTeamId
            - instructionDefinitionId
            - preconditions
          additionalProperties: false
    InstructionDocumentResponse:
      type: object
      properties:
        data:
          type: object
          properties:
            definition:
              $ref: '#/components/schemas/InstructionDefinition'
            latestRevision:
              anyOf:
                - $ref: '#/components/schemas/InstructionRevision'
                - type: 'null'
            publicationHead:
              anyOf:
                - $ref: '#/components/schemas/InstructionPublication'
                - type: 'null'
            publishedRevision:
              anyOf:
                - $ref: '#/components/schemas/InstructionRevision'
                - type: 'null'
            selectedRevision:
              anyOf:
                - $ref: '#/components/schemas/InstructionRevision'
                - type: 'null'
            selection:
              type: string
              enum:
                - latest_saved
                - historic
            preconditions:
              $ref: '#/components/schemas/InstructionWritePreconditions'
          required:
            - definition
            - latestRevision
            - publicationHead
            - publishedRevision
            - selectedRevision
            - selection
            - preconditions
          additionalProperties: false
        meta:
          $ref: '#/components/schemas/MetaDocument'
      required:
        - data
        - meta
      additionalProperties: false
    InstructionWritePreconditions:
      type: object
      properties:
        expectedMetadataVersion:
          type: integer
          minimum: 0
        expectedLatestRevisionId:
          type:
            - string
            - 'null'
          format: uuid
        expectedPublicationHeadId:
          type:
            - string
            - 'null'
          format: uuid
      required:
        - expectedMetadataVersion
        - expectedLatestRevisionId
        - expectedPublicationHeadId
      additionalProperties: false
    InstructionDefinition:
      type: object
      properties:
        id:
          type: string
          format: uuid
        orgId:
          type: string
          format: uuid
        owningTeamId:
          type:
            - string
            - 'null'
          format: uuid
        enabled:
          type: boolean
        metadataVersion:
          type: integer
        archivedAt:
          type:
            - string
            - 'null'
          format: date-time
        createdByPrincipalId:
          type: string
          format: uuid
        createdAt:
          type: string
          format: date-time
        updatedAt:
          type: string
          format: date-time
      required:
        - id
        - orgId
        - owningTeamId
        - enabled
        - metadataVersion
        - archivedAt
        - createdByPrincipalId
        - createdAt
        - updatedAt
      additionalProperties: false
    InstructionRevision:
      type: object
      properties:
        id:
          type: string
          format: uuid
        orgId:
          type: string
          format: uuid
        instructionDefinitionId:
          type: string
          format: uuid
        versionNumber:
          type: integer
        document:
          $ref: '#/components/schemas/InstructionRevisionDocument'
        tokenEstimate:
          type: integer
        createdByPrincipalId:
          type: string
          format: uuid
        createdAt:
          type: string
          format: date-time
      required:
        - id
        - orgId
        - instructionDefinitionId
        - versionNumber
        - document
        - tokenEstimate
        - createdByPrincipalId
        - createdAt
      additionalProperties: false
    InstructionPublication:
      oneOf:
        - type: object
          properties:
            id:
              type: string
              format: uuid
            orgId:
              type: string
              format: uuid
            instructionDefinitionId:
              type: string
              format: uuid
            publicationNumber:
              type: integer
            changedByPrincipalId:
              type: string
              format: uuid
            changedAt:
              type: string
              format: date-time
            state:
              type: string
              const: published
            instructionRevisionId:
              type: string
              format: uuid
          required:
            - id
            - orgId
            - instructionDefinitionId
            - publicationNumber
            - changedByPrincipalId
            - changedAt
            - state
            - instructionRevisionId
          additionalProperties: false
        - type: object
          properties:
            id:
              type: string
              format: uuid
            orgId:
              type: string
              format: uuid
            instructionDefinitionId:
              type: string
              format: uuid
            publicationNumber:
              type: integer
            changedByPrincipalId:
              type: string
              format: uuid
            changedAt:
              type: string
              format: date-time
            state:
              type: string
              const: unpublished
            instructionRevisionId:
              type: 'null'
          required:
            - id
            - orgId
            - instructionDefinitionId
            - publicationNumber
            - changedByPrincipalId
            - changedAt
            - state
            - instructionRevisionId
          additionalProperties: false
    MetaDocument:
      type: object
      additionalProperties: true
    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
            - ai_behavior_unavailable
            - 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
    InstructionRevisionDocument:
      type: object
      properties:
        title:
          type: string
          minLength: 1
          maxLength: 7968
        instructionText:
          type: string
          minLength: 1
          maxLength: 7968
        applicationContext:
          type: string
          enum:
            - employee_conversations
            - ticket_assistance
            - automation_authoring
        scope:
          oneOf:
            - type: object
              properties:
                kind:
                  type: string
                  const: organization
              required:
                - kind
              additionalProperties: false
            - type: object
              properties:
                kind:
                  type: string
                  const: team
                teamId:
                  type: string
                  format: uuid
              required:
                - kind
                - teamId
              additionalProperties: false
            - type: object
              properties:
                kind:
                  type: string
                  const: user
                principalId:
                  type: string
                  format: uuid
              required:
                - kind
                - principalId
              additionalProperties: false
        triggerCondition:
          anyOf:
            - type: string
              minLength: 1
              maxLength: 7968
            - type: 'null'
        inputSchema:
          type: object
          additionalProperties: true
          description: >-
            Compilable object JSON Schema. Omission creates an explicit no-input
            schema.
      required:
        - title
        - instructionText
        - applicationContext
        - scope
        - triggerCondition
        - inputSchema
      additionalProperties: false
    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
  responses:
    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'
  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.