<!--
{
  "availability" : [
    "iOS: 27.0.0 -",
    "iPadOS: 27.0.0 -",
    "macCatalyst: 27.0.0 -",
    "macOS: 27.0.0 -",
    "visionOS: 27.0.0 -",
    "watchOS: 27.0.0 -"
  ],
  "documentType" : "symbol",
  "framework" : "FoundationModels",
  "identifier" : "/documentation/FoundationModels/LanguageModelError/Refusal",
  "metadataVersion" : "0.1.0",
  "role" : "Structure",
  "symbol" : {
    "kind" : "Structure",
    "modules" : [
      "Foundation Models",
      "FoundationModels"
    ],
    "preciseIdentifier" : "s:16FoundationModels18LanguageModelErrorO7RefusalV"
  },
  "title" : "LanguageModelError.Refusal"
}
-->

# LanguageModelError.Refusal

Information about a model refusal.

```
struct Refusal
```

## Overview

Refusal failures indicate that the model chose not to respond to a prompt.

## Topics

### Creating an error instance

[`init(explanation: String, debugDescription: String, metadata: [String : any Sendable])`](/documentation/FoundationModels/LanguageModelError/Refusal/init(explanation:debugDescription:metadata:))

Creates information describing a model refusal.

### Inspecting refusal errors

[`var metadata: [String : any Sendable]`](/documentation/FoundationModels/LanguageModelError/Refusal/metadata)

Additional information about the failure, keyed by name.

[`var debugDescription: String`](/documentation/FoundationModels/LanguageModelError/Refusal/debugDescription)

A debug description to help developers diagnose issues during development.

### Getting a refusal explanation

[`var explanation: LanguageModelSession.Response<String>`](/documentation/FoundationModels/LanguageModelError/Refusal/explanation)

The model’s explanation for why it refused to generate a response.

[`var explanationStream: LanguageModelSession.ResponseStream<String>`](/documentation/FoundationModels/LanguageModelError/Refusal/explanationStream)

The model’s explanation for why it refused to generate a response, delivered as it streams.

## Relationships

### Conforms To

[`SendableMetatype`](/documentation/Swift/SendableMetatype)

[`Sendable`](/documentation/Swift/Sendable)

---

Copyright &copy; 2026 Apple Inc. All rights reserved. | [Terms of Use](https://www.apple.com/legal/internet-services/terms/site.html) | [Privacy Policy](https://www.apple.com/privacy/privacy-policy)