> For clean Markdown content of this page, append .md to this URL. For the complete documentation index, see https://buildwithfern.com/learn/llms.txt.

# Request + response examples

> Add message examples to AsyncAPI specs with `x-fern-examples`. Improve SDK documentation with real-world payload examples.

Provide additional examples for better SDK documentation:

```yaml title="asyncapi.yml" {8-20}
components:
  messages:
    UserEvent:
      contentType: application/json
      payload:
        $ref: '#/components/schemas/User'
      x-fern-examples:
        - name: NewUserSignup
          summary: Example of a new user signup event
          payload:
            id: "user_123"
            email: "john@example.com"
            name: "John Doe"
            status: "active"
        - name: UserDeactivation
          summary: Example of user deactivation event
          payload:
            id: "user_456"
            email: "jane@example.com"
            name: "Jane Smith"
            status: "inactive"
```