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

# Resolve or preview resource selections before creating an instruction

> Requires builder.write and verified authoring authority for the proposed owningTeamId: guidance.write and enabled guidance capability for a team, or organization administrator authority when null. Both resource ID arrays are required, may be empty and accept at most 20 UUIDs each, unique after case normalization. Results preserve each selection's order with zero-based positions. Omitted mode is strict: unavailable knowledge or automation selections return 422 instruction_knowledge_unavailable or instruction_automation_unavailable. Explicit preview reauthorizes each resource and returns inaccessible, missing or foreign resources only as ID, position and availability: unavailable. Nonempty selections require runtime.read even in preview; lacking scope returns 403 insufficient_scope. Neither mode saves an instruction, grants access or executes automations; create, save and publish remain strict. Invalid JSON or a non-object body returns 400 invalid_json or invalid_request_body; a body over 2 MiB returns 413 request_body_too_large; invalid request fields return 422 instruction_request_invalid. Missing owner authority returns 403, including instruction_authoring_required for organization ownership. Disabled team guidance capability returns 409 capability_disabled; automation resolution on an unsupported catalog surface returns 409 catalog_surface_unsupported.



## OpenAPI

````yaml /openapi/control-plane.json post /v1/instructions/resources/resolve
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/instructions/resources/resolve:
    post:
      tags:
        - Instructions
      summary: Resolve or preview resource selections before creating an instruction
      description: >-
        Requires builder.write and verified authoring authority for the proposed
        owningTeamId: guidance.write and enabled guidance capability for a team,
        or organization administrator authority when null. Both resource ID
        arrays are required, may be empty and accept at most 20 UUIDs each,
        unique after case normalization. Results preserve each selection's order
        with zero-based positions. Omitted mode is strict: unavailable knowledge
        or automation selections return 422 instruction_knowledge_unavailable or
        instruction_automation_unavailable. Explicit preview reauthorizes each
        resource and returns inaccessible, missing or foreign resources only as
        ID, position and availability: unavailable. Nonempty selections require
        runtime.read even in preview; lacking scope returns 403
        insufficient_scope. Neither mode saves an instruction, grants access or
        executes automations; create, save and publish remain strict. Invalid
        JSON or a non-object body returns 400 invalid_json or
        invalid_request_body; a body over 2 MiB returns 413
        request_body_too_large; invalid request fields return 422
        instruction_request_invalid. Missing owner authority returns 403,
        including instruction_authoring_required for organization ownership.
        Disabled team guidance capability returns 409 capability_disabled;
        automation resolution on an unsupported catalog surface returns 409
        catalog_surface_unsupported.
      operationId: resolve_instruction_draft_resources
      parameters: []
      requestBody:
        required: true
        content:
          application/json:
            schema:
              $ref: '#/components/schemas/InstructionDraftResourceResolutionBody'
      responses:
        '200':
          description: >-
            Resolve or preview resource selections before creating an
            instruction
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/InstructionResolvedResourcesResponse'
        default:
          $ref: '#/components/responses/ProblemResponse'
      security:
        - bearerAuth:
            - builder.write
            - runtime.read
components:
  schemas:
    InstructionDraftResourceResolutionBody:
      type: object
      properties:
        owningTeamId:
          type:
            - string
            - 'null'
          format: uuid
        knowledgeDocumentIds:
          type: array
          items:
            type: string
            format: uuid
          maxItems: 20
          uniqueItems: true
        automationPublicationIds:
          type: array
          items:
            type: string
            format: uuid
          maxItems: 20
          uniqueItems: true
        mode:
          type: string
          enum:
            - strict
            - preview
          default: strict
          description: >-
            Strict rejects unavailable selections. Preview returns authorized
            resources and opaque unavailable identities without changing
            authoring authority. Create, save and publish still validate
            selections strictly.
      required:
        - owningTeamId
        - knowledgeDocumentIds
        - automationPublicationIds
      additionalProperties: false
    InstructionResolvedResourcesResponse:
      type: object
      properties:
        data:
          type: object
          properties:
            knowledge:
              type: array
              items:
                oneOf:
                  - type: object
                    properties:
                      knowledgeDocumentId:
                        type: string
                        format: uuid
                      position:
                        type: integer
                      availability:
                        type: string
                        const: unavailable
                    required:
                      - knowledgeDocumentId
                      - position
                      - availability
                    additionalProperties: false
                  - type: object
                    properties:
                      knowledgeDocumentId:
                        type: string
                        format: uuid
                      position:
                        type: integer
                      availability:
                        type: string
                        const: available
                      title:
                        type:
                          - string
                          - 'null'
                      sourceUrl:
                        type:
                          - string
                          - 'null'
                      knowledgeDocumentVersionId:
                        type:
                          - string
                          - 'null'
                        format: uuid
                      contentText:
                        type:
                          - string
                          - 'null'
                    required:
                      - knowledgeDocumentId
                      - position
                      - availability
                      - title
                      - sourceUrl
                      - knowledgeDocumentVersionId
                      - contentText
                    additionalProperties: false
            automations:
              type: array
              items:
                oneOf:
                  - type: object
                    properties:
                      automationPublicationId:
                        type: string
                        format: uuid
                      position:
                        type: integer
                      availability:
                        type: string
                        const: unavailable
                    required:
                      - automationPublicationId
                      - position
                      - availability
                    additionalProperties: false
                  - type: object
                    properties:
                      automationPublicationId:
                        type: string
                        format: uuid
                      position:
                        type: integer
                      availability:
                        type: string
                        const: available
                      workflowDefinitionId:
                        type: string
                        format: uuid
                      workflowRevisionId:
                        type: string
                        format: uuid
                      workflowRevisionBuildId:
                        type: string
                        format: uuid
                      publicationNumber:
                        type: integer
                      displayName:
                        type: string
                      summary:
                        type: string
                      inputSchema:
                        type: object
                        additionalProperties: true
                      approvalRequired:
                        type: boolean
                      formRef:
                        type: string
                      targetScopeKind:
                        type: string
                        enum:
                          - organization
                          - team
                      targetTeamId:
                        type:
                          - string
                          - 'null'
                        format: uuid
                    required:
                      - automationPublicationId
                      - position
                      - availability
                      - workflowDefinitionId
                      - workflowRevisionId
                      - workflowRevisionBuildId
                      - publicationNumber
                      - displayName
                      - summary
                      - inputSchema
                      - approvalRequired
                      - formRef
                      - targetScopeKind
                      - targetTeamId
                    additionalProperties: false
          required:
            - knowledge
            - automations
          additionalProperties: false
        meta:
          $ref: '#/components/schemas/MetaDocument'
      required:
        - data
        - meta
      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
            - 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
    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.