Request + response examples

methods:
  - name: user.create
    summary: Create a new user
    params:
      - name: userData
        schema:
          $ref: '#/components/schemas/CreateUserRequest'
        required: true
    x-fern-examples:
      - name: StandardUser
        description: Create a regular user account
        params:
          userData:
            email: "john@example.com"
            name: "John Doe"
            role: "user"
        result:
          id: "user_123"
          email: "john@example.com"
          name: "John Doe"
          role: "user"
          createdAt: "2024-01-15T10:30:00Z"
      - name: AdminUser
        description: Create an admin user account
        params:
          userData:
            email: "admin@example.com"
            name: "Admin User"
            role: "admin"
            permissions: ["read", "write", "delete"]
        result:
          id: "user_456"
          email: "admin@example.com"
          name: "Admin User"
          role: "admin"
          createdAt: "2024-01-15T10:30:00Z"
    result:
      name: user
      schema:
        $ref: '#/components/schemas/User'